@willcgage/module-schematic 0.55.0 → 0.57.0

package/dist/index.d.cts

@@ -1035,18 +1035,24 @@ interface ModuleFeatures {
 /** N-scale track gauge, inches (9 mm). */
 declare const RAIL_GAUGE_INCHES = 0.354;
 /**
- * ⚠️ **REFUTED AS A GENERAL RULE — LAST RESORT ONLY.** Points→frog for a #1
- * frog, i.e. a turnout's LEAD if lead were proportional to frog number. From an
- * Atlas code 55 #7 measuring 3⅜″ (Steve Branton, #173) ⇒ 3.375 / 7.
+ * ⚠️⚠️ **DEAD — REFUTED *AND* BASELESS. NOTHING SHOULD REACH THIS.** Kept only
+ * so a library with no measured leads at all still returns a number, and as a
+ * record of how the mistake was made.
  *
- * It is NOT proportional. Measured lead ÷ N: **#5 = 0.600, #7 = 0.482,
- * #10 = 0.494.** This rule reads ~20% SHORT at N=5 (2.41″ vs a measured 3.00″).
+ * It was points→frog for a #1 frog: a turnout's LEAD if lead were proportional
+ * to frog number, from an Atlas #7 measuring 3⅜″ (Steve Branton, #173) ⇒
+ * 3.375 / 7.
  *
- * Prefer {@link leadInchesForSize}, which returns a real part's measurement when
- * one exists and only falls back here for sizes nothing in the library covers.
- * ⚠️ The remaining fallback user is the #2.5 wye at 1.21″; since per-frog is
- * HIGHEST at the low end (0.600 at N=5), that is very likely SHORT. It is a
- * placeholder, not a value.
+ * TWO independent things are wrong with it:
+ * 1. **Lead is not proportional to N.** Measured lead ÷ N: #5 = 0.600,
+ *    #7 = 0.513, #10 = 0.494. It reads ~20% SHORT at N=5.
+ * 2. **Its founding measurement was superseded.** Will Gage re-measured the same
+ *    part at 3¹⁹⁄₃₂″, ⁷⁄₃₂″ longer, confirmed against his own points and frog
+ *    positions. So 0.482 is not even the right constant for the wrong model.
+ *
+ * {@link leadInchesForSize} now INTERPOLATES across the measured parts instead.
+ * A single measurement can only ever be scaled — which is this rule — so the
+ * lesson is that one data point cannot support a shape, only a value.
  *
  * A constant-switch-angle model was also proposed here and is likewise REFUTED:
  * inverting {@link turnoutClosure} gives α = 0.036 (#5), 0.067 (#7), 0.043
@@ -1122,6 +1128,16 @@ interface TrackPart {
     innerRadius?: PartDimension;
     /** Crossing angle, degrees. */
     crossingAngleDeg?: number;
+    /** The part's drawn geometry in its own frame, when it came from a library
+     * file. This is the payload worth importing — real outlines we can draw
+     * instead of deriving a turnout's shape from a frog number. */
+    segments?: PartSegment[];
+    /** Connection points, each carrying position AND tangent. The seam a piece
+     * graph would snap on (#179 stage 1-2). */
+    ends?: PartEnd[];
+    /** Set when the part came from an imported library file rather than our own
+     * data — names the source so a user can tell where a dimension came from. */
+    importedFrom?: string;
 }
 /** N-scale code 55 rail height, inches — Atlas publish .055″. */
 declare const CODE55_RAIL_HEIGHT_INCHES = 0.055;
@@ -1135,18 +1151,23 @@ declare const CODE55_RAIL_HEIGHT_INCHES = 0.055;
  *
  * MEASURED GEOMETRY (all Will Gage's, off physical parts, frog taken at the V):
  *
- *     part   points   frog V    overall   lead      past frog   ÷N
- *     #5     1¾″      4.75″     6.00″     3.0000″   1.25″       0.2500
- *     #7     —        4³⁄₁₆″    6.00″     3.3750″*  1.8125″     0.2589
- *     #10    ⁹⁄₁₆″    5.50″     8.00″     4.9375″   2.50″       0.2500
+ *     part   points   frog V    overall   lead       past frog   ÷N
+ *     #5     1¾″      4.75″     6.00″     3.00000″   1.25″       0.2500
+ *     #7     ⁵⁄₈″     4⁷⁄₃₂″    6.00″     3.59375″   1.78125″    0.2545
+ *     #10    ⁹⁄₁₆″    5.50″     8.00″     4.93750″   2.50″       0.2500
  *
- *     * the #7's lead is Steve Branton's (#173), a DIFFERENT person and possibly
- *       a different convention. Its points offset has never been measured, so
- *       4³⁄₁₆ − 3⅜ = ¹³⁄₁₆″ is implied, not observed. Measure a 2052 to close it.
+ * Every one of these is Will Gage's, off a physical part, frog taken at the V.
+ * ⚠️ The #7 lead SUPERSEDES Steve Branton's 3⅜″ (#173) — the library's founding
+ * measurement, ⁷⁄₃₂″ short. Will's single-span reading and his two positions
+ * agree exactly, which is why it wins. Steve's number was also the sole basis of
+ * {@link TURNOUT_LEAD_INCHES_PER_FROG}; that constant is now baseless as well as
+ * refuted, and {@link leadInchesForSize} interpolates across this table instead.
  *
  * ⭐ **THE PART RUNS PAST THE FROG FAR ENOUGH TO GAIN 0.25″ OF SEPARATION.**
- * Past-frog run ÷ N is 0.2500 / 0.2589 / 0.2500 — the #5 and #10 EXACT, the #7
- * within ¹⁄₁₆″ of the tie end (a 4¼″ frog would make it exact too). At the frog
+ * Past-frog run ÷ N is 0.2500 / 0.2545 / 0.2500 — the #5 and #10 EXACT, the #7
+ * within ¹⁄₃₂″ of the tie end (a 4¼″ frog would make it exact too, one tape
+ * division away). Provenance note: the measurer was told that prediction BEFORE
+ * re-reading and did not return 4¼″, so this is not a confirmation artefact. At the frog
  * the routes are one gauge apart; at the end of the moulding they are
  * 0.354 + 0.25 ≈ 0.6″ apart. So Atlas size the moulding for a constant
  * CLEARANCE, not a constant length — which is what a manufacturer would
@@ -1158,10 +1179,11 @@ declare const CODE55_RAIL_HEIGHT_INCHES = 0.055;
  *
  * NOTHING HERE IS PROPORTIONAL TO FROG NUMBER. Three rules assumed otherwise;
  * all three were tested against a physical part and FAILED:
- * - ❌ **Lead ∝ N.** Measured lead ÷ N: #5 = 0.600, #7 = 0.482, #10 = 0.494.
- *   {@link TURNOUT_LEAD_INCHES_PER_FROG} reads ~20% SHORT at N=5.
+ * - ❌ **Lead ∝ N.** Measured lead ÷ N: #5 = 0.600, #7 = 0.513, #10 = 0.494.
+ *   {@link TURNOUT_LEAD_INCHES_PER_FROG} reads ~20% SHORT at N=5 — and its
+ *   founding measurement has since been superseded, so it is baseless too.
  * - ❌ **Constant switch angle.** Inverting {@link turnoutClosure} gives α =
- *   0.036 (#5), 0.067 (#7), 0.043 (#10). Not constant.
+ *   0.036 (#5), 0.055 (#7), 0.043 (#10). Not constant.
  * - ❌ **Overall length ∝ N.** #5 = 6.00″ and #7 = 6.00″ — same moulding, two
  *   frog numbers.
  * - ❌ **Frog fixed at 4.75″** (shipped in 0.54.0, retracted in 0.55.0). It
@@ -1182,9 +1204,19 @@ declare function trackPart(id: string, library?: TrackPart[]): TrackPart | null;
 /** The closest built-in turnout for a frog number — what a bare `size` maps to
  * when a turnout names no part. Exact match wins; otherwise the nearest frog. */
 declare function turnoutPartForSize(size: number, library?: TrackPart[]): TrackPart | null;
-/** The lead to draw a turnout of this size with — a real part's measurement when
- * we have one, else the per-frog rule. Keeps `frogLegOf` honest without it
- * needing to know the library exists. */
+/**
+ * The lead to draw a turnout of this size with. Keeps `frogLegOf` honest without
+ * it needing to know the library exists.
+ *
+ * 1. An exact part match wins — a #7's measurement says nothing about a #4.
+ * 2. Otherwise INTERPOLATE piecewise-linearly across the measured parts. This
+ *    replaced `size × TURNOUT_LEAD_INCHES_PER_FROG`, which was refuted (its
+ *    error changes sign across the measured range) and is now baseless besides,
+ *    its founding #7 measurement having been superseded.
+ * 3. ⚠️ Outside the measured range the end segments EXTRAPOLATE. Measured leads
+ *    span N = 5…10, so a #4 or #12 is a projection, not a reading, and the #2.5
+ *    wye is a long way out. Treat those as placeholders until a part is measured.
+ */
 declare function leadInchesForSize(size: number, library?: TrackPart[]): number;
 /** One drawn piece of a part's geometry, in the part's own local frame. */
 type PartSegment = {
@@ -1235,6 +1267,38 @@ declare function parseXtpLibrary(text: string): ImportedPart[];
  * XTrkCAD angles run CLOCKWISE FROM NORTH, so a point on a curve is
  * `(cx + r·sin a, cy + r·cos a)`, not the usual cos/sin. */
 declare function samplePartSegments(segments: PartSegment[], stepsPerCurve?: number): BenchworkPoint[][];
+/** Pull a frog number out of a part name — "#5", "No. 5", "Number 7 Left".
+ * Identification, not measurement: it reads the label the maker printed. */
+declare function frogNumberFromName(name: string | undefined): number | undefined;
+/**
+ * Convert a parsed `.xtp` part into a library {@link TrackPart}.
+ *
+ * ⚠️⚠️ **DELIBERATELY DERIVES NO `lead` AND NO `frogOffset`.** The shipped Atlas
+ * file's frog positions are internally inconsistent — it puts the #5's frog
+ * FURTHER OUT than the #7's, which cannot be true of physical parts. Every lead
+ * in this library is a physical measurement and must stay that way; an imported
+ * lead would silently outrank {@link leadInchesForSize}'s interpolation across
+ * those measurements, which is exactly the wrong trade.
+ *
+ * What IS taken: identity (manufacturer, name, part number, frog number), the
+ * drawn `segments` and `ends`, and two dimensions the geometry states directly —
+ * overall length along the through axis, and the actual divergence angle. Both
+ * land as `unverified`, because a community CAD file is not a measurement.
+ */
+declare function importedPartToTrackPart(part: ImportedPart, sourceName?: string): TrackPart;
+/**
+ * Fold imported parts into a library.
+ *
+ * **Imports never overwrite. Ever.** They may only fill a gap — attach geometry
+ * a built-in lacks, or add a part we have no entry for. A dimension already
+ * present wins regardless of its source, because our worst built-in value is at
+ * least one we can trace, and this library has already been burned once by a
+ * plausible number from a CAD file (the constant-switch-angle model was fitted
+ * to an `.xtp` figure that turned out to be measured to the wrong landmark).
+ *
+ * Matching is by manufacturer part number first, then manufacturer + frog number.
+ */
+declare function mergeImportedParts(imported: ImportedPart[], library?: TrackPart[], sourceName?: string): TrackPart[];
 /** 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.
  *
@@ -1428,4 +1492,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, fromSectionRelative, geometryTurnDegrees, inchesToScaleFeet, isLoopDoc, isTransitionTurnout, leadInchesForSize, 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, 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

@@ -1035,18 +1035,24 @@ interface ModuleFeatures {
 /** N-scale track gauge, inches (9 mm). */
 declare const RAIL_GAUGE_INCHES = 0.354;
 /**
- * ⚠️ **REFUTED AS A GENERAL RULE — LAST RESORT ONLY.** Points→frog for a #1
- * frog, i.e. a turnout's LEAD if lead were proportional to frog number. From an
- * Atlas code 55 #7 measuring 3⅜″ (Steve Branton, #173) ⇒ 3.375 / 7.
+ * ⚠️⚠️ **DEAD — REFUTED *AND* BASELESS. NOTHING SHOULD REACH THIS.** Kept only
+ * so a library with no measured leads at all still returns a number, and as a
+ * record of how the mistake was made.
  *
- * It is NOT proportional. Measured lead ÷ N: **#5 = 0.600, #7 = 0.482,
- * #10 = 0.494.** This rule reads ~20% SHORT at N=5 (2.41″ vs a measured 3.00″).
+ * It was points→frog for a #1 frog: a turnout's LEAD if lead were proportional
+ * to frog number, from an Atlas #7 measuring 3⅜″ (Steve Branton, #173) ⇒
+ * 3.375 / 7.
  *
- * Prefer {@link leadInchesForSize}, which returns a real part's measurement when
- * one exists and only falls back here for sizes nothing in the library covers.
- * ⚠️ The remaining fallback user is the #2.5 wye at 1.21″; since per-frog is
- * HIGHEST at the low end (0.600 at N=5), that is very likely SHORT. It is a
- * placeholder, not a value.
+ * TWO independent things are wrong with it:
+ * 1. **Lead is not proportional to N.** Measured lead ÷ N: #5 = 0.600,
+ *    #7 = 0.513, #10 = 0.494. It reads ~20% SHORT at N=5.
+ * 2. **Its founding measurement was superseded.** Will Gage re-measured the same
+ *    part at 3¹⁹⁄₃₂″, ⁷⁄₃₂″ longer, confirmed against his own points and frog
+ *    positions. So 0.482 is not even the right constant for the wrong model.
+ *
+ * {@link leadInchesForSize} now INTERPOLATES across the measured parts instead.
+ * A single measurement can only ever be scaled — which is this rule — so the
+ * lesson is that one data point cannot support a shape, only a value.
  *
  * A constant-switch-angle model was also proposed here and is likewise REFUTED:
  * inverting {@link turnoutClosure} gives α = 0.036 (#5), 0.067 (#7), 0.043
@@ -1122,6 +1128,16 @@ interface TrackPart {
     innerRadius?: PartDimension;
     /** Crossing angle, degrees. */
     crossingAngleDeg?: number;
+    /** The part's drawn geometry in its own frame, when it came from a library
+     * file. This is the payload worth importing — real outlines we can draw
+     * instead of deriving a turnout's shape from a frog number. */
+    segments?: PartSegment[];
+    /** Connection points, each carrying position AND tangent. The seam a piece
+     * graph would snap on (#179 stage 1-2). */
+    ends?: PartEnd[];
+    /** Set when the part came from an imported library file rather than our own
+     * data — names the source so a user can tell where a dimension came from. */
+    importedFrom?: string;
 }
 /** N-scale code 55 rail height, inches — Atlas publish .055″. */
 declare const CODE55_RAIL_HEIGHT_INCHES = 0.055;
@@ -1135,18 +1151,23 @@ declare const CODE55_RAIL_HEIGHT_INCHES = 0.055;
  *
  * MEASURED GEOMETRY (all Will Gage's, off physical parts, frog taken at the V):
  *
- *     part   points   frog V    overall   lead      past frog   ÷N
- *     #5     1¾″      4.75″     6.00″     3.0000″   1.25″       0.2500
- *     #7     —        4³⁄₁₆″    6.00″     3.3750″*  1.8125″     0.2589
- *     #10    ⁹⁄₁₆″    5.50″     8.00″     4.9375″   2.50″       0.2500
+ *     part   points   frog V    overall   lead       past frog   ÷N
+ *     #5     1¾″      4.75″     6.00″     3.00000″   1.25″       0.2500
+ *     #7     ⁵⁄₈″     4⁷⁄₃₂″    6.00″     3.59375″   1.78125″    0.2545
+ *     #10    ⁹⁄₁₆″    5.50″     8.00″     4.93750″   2.50″       0.2500
  *
- *     * the #7's lead is Steve Branton's (#173), a DIFFERENT person and possibly
- *       a different convention. Its points offset has never been measured, so
- *       4³⁄₁₆ − 3⅜ = ¹³⁄₁₆″ is implied, not observed. Measure a 2052 to close it.
+ * Every one of these is Will Gage's, off a physical part, frog taken at the V.
+ * ⚠️ The #7 lead SUPERSEDES Steve Branton's 3⅜″ (#173) — the library's founding
+ * measurement, ⁷⁄₃₂″ short. Will's single-span reading and his two positions
+ * agree exactly, which is why it wins. Steve's number was also the sole basis of
+ * {@link TURNOUT_LEAD_INCHES_PER_FROG}; that constant is now baseless as well as
+ * refuted, and {@link leadInchesForSize} interpolates across this table instead.
  *
  * ⭐ **THE PART RUNS PAST THE FROG FAR ENOUGH TO GAIN 0.25″ OF SEPARATION.**
- * Past-frog run ÷ N is 0.2500 / 0.2589 / 0.2500 — the #5 and #10 EXACT, the #7
- * within ¹⁄₁₆″ of the tie end (a 4¼″ frog would make it exact too). At the frog
+ * Past-frog run ÷ N is 0.2500 / 0.2545 / 0.2500 — the #5 and #10 EXACT, the #7
+ * within ¹⁄₃₂″ of the tie end (a 4¼″ frog would make it exact too, one tape
+ * division away). Provenance note: the measurer was told that prediction BEFORE
+ * re-reading and did not return 4¼″, so this is not a confirmation artefact. At the frog
  * the routes are one gauge apart; at the end of the moulding they are
  * 0.354 + 0.25 ≈ 0.6″ apart. So Atlas size the moulding for a constant
  * CLEARANCE, not a constant length — which is what a manufacturer would
@@ -1158,10 +1179,11 @@ declare const CODE55_RAIL_HEIGHT_INCHES = 0.055;
  *
  * NOTHING HERE IS PROPORTIONAL TO FROG NUMBER. Three rules assumed otherwise;
  * all three were tested against a physical part and FAILED:
- * - ❌ **Lead ∝ N.** Measured lead ÷ N: #5 = 0.600, #7 = 0.482, #10 = 0.494.
- *   {@link TURNOUT_LEAD_INCHES_PER_FROG} reads ~20% SHORT at N=5.
+ * - ❌ **Lead ∝ N.** Measured lead ÷ N: #5 = 0.600, #7 = 0.513, #10 = 0.494.
+ *   {@link TURNOUT_LEAD_INCHES_PER_FROG} reads ~20% SHORT at N=5 — and its
+ *   founding measurement has since been superseded, so it is baseless too.
  * - ❌ **Constant switch angle.** Inverting {@link turnoutClosure} gives α =
- *   0.036 (#5), 0.067 (#7), 0.043 (#10). Not constant.
+ *   0.036 (#5), 0.055 (#7), 0.043 (#10). Not constant.
  * - ❌ **Overall length ∝ N.** #5 = 6.00″ and #7 = 6.00″ — same moulding, two
  *   frog numbers.
  * - ❌ **Frog fixed at 4.75″** (shipped in 0.54.0, retracted in 0.55.0). It
@@ -1182,9 +1204,19 @@ declare function trackPart(id: string, library?: TrackPart[]): TrackPart | null;
 /** The closest built-in turnout for a frog number — what a bare `size` maps to
  * when a turnout names no part. Exact match wins; otherwise the nearest frog. */
 declare function turnoutPartForSize(size: number, library?: TrackPart[]): TrackPart | null;
-/** The lead to draw a turnout of this size with — a real part's measurement when
- * we have one, else the per-frog rule. Keeps `frogLegOf` honest without it
- * needing to know the library exists. */
+/**
+ * The lead to draw a turnout of this size with. Keeps `frogLegOf` honest without
+ * it needing to know the library exists.
+ *
+ * 1. An exact part match wins — a #7's measurement says nothing about a #4.
+ * 2. Otherwise INTERPOLATE piecewise-linearly across the measured parts. This
+ *    replaced `size × TURNOUT_LEAD_INCHES_PER_FROG`, which was refuted (its
+ *    error changes sign across the measured range) and is now baseless besides,
+ *    its founding #7 measurement having been superseded.
+ * 3. ⚠️ Outside the measured range the end segments EXTRAPOLATE. Measured leads
+ *    span N = 5…10, so a #4 or #12 is a projection, not a reading, and the #2.5
+ *    wye is a long way out. Treat those as placeholders until a part is measured.
+ */
 declare function leadInchesForSize(size: number, library?: TrackPart[]): number;
 /** One drawn piece of a part's geometry, in the part's own local frame. */
 type PartSegment = {
@@ -1235,6 +1267,38 @@ declare function parseXtpLibrary(text: string): ImportedPart[];
  * XTrkCAD angles run CLOCKWISE FROM NORTH, so a point on a curve is
  * `(cx + r·sin a, cy + r·cos a)`, not the usual cos/sin. */
 declare function samplePartSegments(segments: PartSegment[], stepsPerCurve?: number): BenchworkPoint[][];
+/** Pull a frog number out of a part name — "#5", "No. 5", "Number 7 Left".
+ * Identification, not measurement: it reads the label the maker printed. */
+declare function frogNumberFromName(name: string | undefined): number | undefined;
+/**
+ * Convert a parsed `.xtp` part into a library {@link TrackPart}.
+ *
+ * ⚠️⚠️ **DELIBERATELY DERIVES NO `lead` AND NO `frogOffset`.** The shipped Atlas
+ * file's frog positions are internally inconsistent — it puts the #5's frog
+ * FURTHER OUT than the #7's, which cannot be true of physical parts. Every lead
+ * in this library is a physical measurement and must stay that way; an imported
+ * lead would silently outrank {@link leadInchesForSize}'s interpolation across
+ * those measurements, which is exactly the wrong trade.
+ *
+ * What IS taken: identity (manufacturer, name, part number, frog number), the
+ * drawn `segments` and `ends`, and two dimensions the geometry states directly —
+ * overall length along the through axis, and the actual divergence angle. Both
+ * land as `unverified`, because a community CAD file is not a measurement.
+ */
+declare function importedPartToTrackPart(part: ImportedPart, sourceName?: string): TrackPart;
+/**
+ * Fold imported parts into a library.
+ *
+ * **Imports never overwrite. Ever.** They may only fill a gap — attach geometry
+ * a built-in lacks, or add a part we have no entry for. A dimension already
+ * present wins regardless of its source, because our worst built-in value is at
+ * least one we can trace, and this library has already been burned once by a
+ * plausible number from a CAD file (the constant-switch-angle model was fitted
+ * to an `.xtp` figure that turned out to be measured to the wrong landmark).
+ *
+ * Matching is by manufacturer part number first, then manufacturer + frog number.
+ */
+declare function mergeImportedParts(imported: ImportedPart[], library?: TrackPart[], sourceName?: string): TrackPart[];
 /** 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.
  *
@@ -1428,4 +1492,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, fromSectionRelative, geometryTurnDegrees, inchesToScaleFeet, isLoopDoc, isTransitionTurnout, leadInchesForSize, 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, 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

@@ -1137,14 +1137,19 @@ var ATLAS_CODE55_N = [
     partNumbers: { left: "2052", right: "2053" },
     frogNumber: 7,
     lead: {
-      inches: 3.375,
+      inches: 3.59375,
       source: "measured",
-      note: "Steve Branton, physical Atlas code 55 #7, 3\u215C\u2033 points\u2192frog (#173)"
+      note: "Will Gage, physical Atlas 2052 (#7), 3\xB9\u2079\u2044\u2083\u2082\u2033 points\u2192frog as a single span \u2014 and it matches his two positions exactly (4\u2077\u2044\u2083\u2082 \u2212 \u2075\u2044\u2088), so the reading is internally consistent. SUPERSEDES Steve Branton's 3\u215C\u2033 (#173), which was \u2077\u2044\u2083\u2082\u2033 short and was the library's founding measurement. \u26A0\uFE0F Steve's number was also the SOLE basis of TURNOUT_LEAD_INCHES_PER_FROG (3.375/7 = 0.482) \u2014 that constant is now baseless as well as refuted."
+    },
+    pointsOffset: {
+      inches: 0.625,
+      source: "measured",
+      note: "Will Gage, physical Atlas 2052 (#7) \u2014 \xB9\u2070\u2044\u2081\u2086\u2033 tie end to point tips"
     },
     frogOffset: {
-      inches: 4.1875,
+      inches: 4.21875,
       source: "measured",
-      note: "Will Gage, physical Atlas 2052 (#7) \u2014 tie end to the apex of the V"
+      note: "Will Gage, physical Atlas 2052 (#7) \u2014 4\u2077\u2044\u2083\u2082\u2033, tie end to the apex of the V. Supersedes an initial 4\xB3\u2044\u2081\u2086\u2033. Worth noting for provenance: he was told beforehand that the clearance hypothesis predicted 4\xBC\u2033 and did NOT read 4\xBC\u2033 \u2014 so this number is not a confirmation artefact, and it sits \xB9\u2044\u2083\u2082\u2033 (one tape division) from the predicted value."
     },
     overallLength: {
       inches: 6,
@@ -1230,10 +1235,24 @@ function turnoutPartForSize(size, library = BUILT_IN_TRACK_PARTS) {
     (best, p) => Math.abs(p.frogNumber - size) < Math.abs(best.frogNumber - size) ? p : best
   );
 }
+function measuredLeadPoints(library) {
+  return library.filter(
+    (p) => p.kind === "turnout" && p.frogNumber != null && p.lead?.source === "measured"
+  ).map((p) => ({ n: p.frogNumber, lead: p.lead.inches })).sort((a, b) => a.n - b.n);
+}
 function leadInchesForSize(size, library = BUILT_IN_TRACK_PARTS) {
   const part = turnoutPartForSize(size, library);
   if (part?.lead && part.frogNumber === size) return part.lead.inches;
-  return size * TURNOUT_LEAD_INCHES_PER_FROG;
+  const pts = measuredLeadPoints(library);
+  if (!pts.length) return size * TURNOUT_LEAD_INCHES_PER_FROG;
+  if (pts.length === 1) return size / pts[0].n * pts[0].lead;
+  let i;
+  if (size >= pts[pts.length - 1].n) i = pts.length - 2;
+  else i = Math.max(0, pts.findIndex((p) => p.n >= size) - 1);
+  const lo = pts[i];
+  const hi = pts[i + 1];
+  const t = (size - lo.n) / (hi.n - lo.n);
+  return lo.lead + t * (hi.lead - lo.lead);
 }
 function parseXtpLibrary(text) {
   const parts = [];
@@ -1299,6 +1318,85 @@ function samplePartSegments(segments, stepsPerCurve = 16) {
     return out;
   });
 }
+function angleDeltaDeg(a, b) {
+  let d = ((a - b) % 360 + 540) % 360 - 180;
+  if (d === -180) d = 180;
+  return d;
+}
+function frogNumberFromName(name) {
+  if (!name) return void 0;
+  const m = name.match(/(?:#|no\.?\s*|number\s+)(\d+(?:\.\d+)?)/i);
+  if (!m) return void 0;
+  const n = Number(m[1]);
+  return Number.isFinite(n) && n > 0 ? n : void 0;
+}
+function importedKind(name) {
+  const s = (name ?? "").toLowerCase();
+  if (s.includes("wye")) return "wye";
+  if (s.includes("crossing")) return "crossing";
+  if (s.includes("curved")) return "curved-turnout";
+  return "turnout";
+}
+var slug = (s) => s.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-|-$/g, "");
+function importedPartToTrackPart(part, sourceName = "imported .xtp") {
+  const name = part.name ?? part.title ?? "Imported part";
+  const manufacturer = part.manufacturer ?? "Unknown";
+  const note = `from ${sourceName} \u2014 community CAD data, not a measurement`;
+  const out = {
+    id: `xtp-${slug(manufacturer)}-${slug(part.partNumber || name)}`,
+    manufacturer,
+    name,
+    line: "",
+    scale: "N",
+    kind: importedKind(name),
+    frogNumber: frogNumberFromName(name),
+    segments: part.segments,
+    ends: part.ends,
+    importedFrom: sourceName
+  };
+  if (part.partNumber) out.partNumbers = { single: part.partNumber };
+  const ends = part.ends;
+  if (ends.length >= 2) {
+    const a = ends[0].angleDeg * Math.PI / 180;
+    const ux = Math.sin(a);
+    const uy = Math.cos(a);
+    const proj = ends.map((e) => (e.x - ends[0].x) * ux + (e.y - ends[0].y) * uy);
+    const span = Math.max(...proj) - Math.min(...proj);
+    if (span > 0) out.overallLength = { inches: span, source: "unverified", note };
+  }
+  if (ends.length >= 3) {
+    const rest = ends.slice(1);
+    const opposite = rest.map((e) => ({ e, off: Math.abs(angleDeltaDeg(e.angleDeg, ends[0].angleDeg + 180)) })).sort((p, q) => p.off - q.off);
+    const through = opposite[0].e;
+    const diverging = opposite[opposite.length - 1].e;
+    const deg = Math.abs(angleDeltaDeg(diverging.angleDeg, through.angleDeg));
+    if (deg > 0.01) out.actualAngle = { deg, source: "unverified", note };
+  }
+  return out;
+}
+function mergeImportedParts(imported, library = BUILT_IN_TRACK_PARTS, sourceName = "imported .xtp") {
+  const out = library.map((p) => ({ ...p }));
+  const numbersOf = (p) => [p.partNumbers?.left, p.partNumbers?.right, p.partNumbers?.single].filter(Boolean).map((s) => s.trim().toLowerCase());
+  for (const raw of imported) {
+    const conv = importedPartToTrackPart(raw, sourceName);
+    const pn = raw.partNumber?.trim().toLowerCase();
+    const match = (pn ? out.find((p) => numbersOf(p).includes(pn)) : void 0) ?? (conv.frogNumber != null ? out.find(
+      (p) => p.frogNumber === conv.frogNumber && p.kind === conv.kind && p.manufacturer.toLowerCase() === conv.manufacturer.toLowerCase()
+    ) : void 0);
+    if (!match) {
+      out.push(conv);
+      continue;
+    }
+    if (!match.segments?.length && conv.segments?.length) match.segments = conv.segments;
+    if (!match.ends?.length && conv.ends?.length) match.ends = conv.ends;
+    if (!match.importedFrom && (conv.segments?.length || conv.ends?.length)) {
+      match.importedFrom = sourceName;
+    }
+    if (!match.overallLength && conv.overallLength) match.overallLength = conv.overallLength;
+    if (!match.actualAngle && conv.actualAngle) match.actualAngle = conv.actualAngle;
+  }
+  return out;
+}
 function turnoutClosure(size, opts = {}) {
   const N = size > 0 ? size : 6;
   const g = opts.gaugeInches ?? RAIL_GAUGE_INCHES;
@@ -1828,6 +1926,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, fromSectionRelative, geometryTurnDegrees, inchesToScaleFeet, isLoopDoc, isTransitionTurnout, leadInchesForSize, 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, 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