@willcgage/module-schematic 0.51.0 → 0.53.0

package/dist/index.d.cts

@@ -1034,12 +1034,177 @@ interface ModuleFeatures {
  */
 /** N-scale track gauge, inches (9 mm). */
 declare const RAIL_GAUGE_INCHES = 0.354;
-/** Points → FROG for a #1 frog, inches — a turnout's LEAD, scaled by frog
- * number. Calibrated COMMERCIALLY rather than on the prototype, since owners lay
- * real product: an Atlas code 55 #7 measures 3⅜″ points→frog (Steve Branton,
- * #173) ⇒ 3.375 / 7. (The prototype #7 lead is 62′-1″ ≈ 4.66″ in N; commercial
- * turnouts are compressed against that.) */
+/**
+ * ⚠️ **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.
+ *
+ * It is NOT proportional. Measured lead ÷ N: **#7 = 0.482, #10 = 0.419.** The
+ * rule predicted 4.82″ for the #10; it measures 4³⁄₁₆″ — **13% over**. Atlas
+ * compress the lead on long turnouts, just as they compress overall length.
+ *
+ * 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.
+ * A fallback at N ≥ 10 will read LONG.
+ *
+ * BETTER MODEL (hypothesis, not yet enough data): a roughly CONSTANT SWITCH
+ * ANGLE α — the angle the point rails leave the stock rail at — which is real
+ * prototype practice, points being planed to a standard angle. Inverting
+ * {@link turnoutClosure} gives `lead = 2g / (1/N + α)`, and the two measured
+ * leads agree to 3%: #7 ⇒ α = 0.0669, #10 ⇒ α = 0.0691. If it holds, lead is
+ * whatever falls out of a fixed point angle meeting the frog, not a multiple
+ * of N. DISCRIMINATING TEST: at α ≈ 0.068 the #5's lead is **2.64″**, where
+ * this constant says 2.41″ — measure a physical 2050 to settle it.
+ */
 declare const TURNOUT_LEAD_INCHES_PER_FROG = 0.482;
+/** Where a dimension came from. `derived` = we computed it from another part or
+ * a rule of thumb; `unverified` = plausible but unconfirmed — treat with care. */
+type DimensionSource = "manufacturer" | "measured" | "derived" | "unverified";
+interface PartDimension {
+    inches: number;
+    source: DimensionSource;
+    /** Who measured it / which spec, so it can be re-checked. */
+    note?: string;
+}
+/** Same provenance discipline as {@link PartDimension}, for angles. */
+interface PartAngle {
+    deg: number;
+    source: DimensionSource;
+    note?: string;
+}
+interface TrackPart {
+    /** Stable slug, e.g. "atlas-c55-n-7". */
+    id: string;
+    manufacturer: string;
+    /** Product line — "Code 55", "Code 80". */
+    line: string;
+    scale: "N";
+    name: string;
+    kind: "turnout" | "wye" | "curved-turnout" | "crossing";
+    /** Manufacturer part numbers by hand, where the part has a hand. */
+    partNumbers?: {
+        left?: string;
+        right?: string;
+        single?: string;
+    };
+    /** Frog number N (the 1:N ratio). Definitional, so no provenance needed. */
+    frogNumber?: number;
+    /** The angle the part ACTUALLY diverges at, where that's known to differ from
+     * the theoretical `atan(1/N)`. Atlas appear to build to SECTIONAL angles
+     * (multiples of 11.25° = 1/32 turn) rather than true frog ratios, so a "#5" is
+     * 11.25° not 11.31°. ⚠️ Currently below our drawing resolution — 0.06° over a
+     * 6″ turnout is 0.006″ — so nothing uses this yet. Recorded because it's a
+     * real property of the product and will matter if we ever check whether a part
+     * mates with sectional track. */
+    actualAngle?: PartAngle;
+    /** Points → frog. The number that decides where a turnout's throat lands. */
+    lead?: PartDimension;
+    /** End of the tie strip → the point tips. Where the working turnout starts
+     * inside its moulding; the rest of that end is plain approach track. Needed to
+     * fit a part into a space, and by any renderer drawing the real outline. */
+    pointsOffset?: PartDimension;
+    /** End-to-end length of the part. */
+    overallLength?: PartDimension;
+    /** Diverging route radius (straight turnouts). */
+    divergingRadius?: PartDimension;
+    /** Curved turnouts: the two concentric radii. */
+    outerRadius?: PartDimension;
+    innerRadius?: PartDimension;
+    /** Crossing angle, degrees. */
+    crossingAngleDeg?: number;
+}
+/** N-scale code 55 rail height, inches — Atlas publish .055″. */
+declare const CODE55_RAIL_HEIGHT_INCHES = 0.055;
+/**
+ * Atlas N-scale Code 55 — the Free-moN mainstay.
+ *
+ * ⚠️ Atlas do not publish leads or overall lengths for the straight turnouts.
+ * Everything here traces to physical measurements: Steve Branton's #7 lead
+ * (3⅜″ points→frog, #173) and Will Gage's #5/#7/#10 overall lengths plus the
+ * #10's lead and points offset. The #5's lead and the wye's are still derived.
+ *
+ * NEITHER DIMENSION IS PROPORTIONAL TO FROG NUMBER. Both rules that assumed so
+ * have now been tested and failed:
+ * - **Lead does NOT scale with N.** Measured lead ÷ N: #7 = 0.482, #10 = 0.419.
+ *   {@link TURNOUT_LEAD_INCHES_PER_FROG} predicted 4.82″ for the #10 against a
+ *   measured 4³⁄₁₆″ — 13% over. See that constant for the constant-switch-angle
+ *   model that fits both measurements, and the test that would confirm it.
+ * - ⭐ **Overall length is NOT A FUNCTION OF N AT ALL.** Measured: #5 = 6.00″,
+ *   **#7 = 6.00″**, #10 = 8.00″. The #5 and #7 are the SAME LENGTH — Atlas mould
+ *   them on a shared 6″ tie strip and vary only the frog angle and where the frog
+ *   sits. NEVER derive a length from a frog number; look the part up.
+ *
+ * This is what the frog-number definition actually says, and it's easy to forget:
+ * #N fixes the DIVERGENCE RATE AT THE FROG (1 across per N along). It says
+ * nothing about how much tie strip the manufacturer wraps around it. Angle is
+ * geometry; length is packaging. Hence the lead — where the frog falls inside
+ * that strip — is the only dimension worth chasing.
+ *
+ * (Lengths are whole inches and the #5 diverges at exactly 1/32 of a circle, so
+ * Atlas do seem to work to round numbers — but a prediction that the #7 would
+ * therefore be 7.00″ was tested and FAILED. Round, but not one inch per frog.)
+ */
+declare const ATLAS_CODE55_N: TrackPart[];
+/** Every built-in part, across manufacturers. */
+declare const BUILT_IN_TRACK_PARTS: TrackPart[];
+/** Look a part up by its slug. */
+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. */
+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 = {
+    kind: "straight";
+    x0: number;
+    y0: number;
+    x1: number;
+    y1: number;
+} | {
+    kind: "curve";
+    radius: number;
+    cx: number;
+    cy: number;
+    startDeg: number;
+    extentDeg: number;
+};
+/** A connection point on an imported part: position plus the tangent it faces. */
+interface PartEnd {
+    x: number;
+    y: number;
+    angleDeg: number;
+}
+interface ImportedPart {
+    /** Raw title, tab-separated in the file: manufacturer, name, part number. */
+    title: string;
+    manufacturer?: string;
+    name?: string;
+    partNumber?: string;
+    scale?: string;
+    ends: PartEnd[];
+    segments: PartSegment[];
+}
+/**
+ * Parse an XTrkCAD `.xtp` parameter file into parts.
+ *
+ * The format is plain text, record-per-line inside `TURNOUT … END` blocks:
+ *   `E x y angle`                         an endpoint
+ *   `S layer width x0 y0 x1 y1`           a straight segment
+ *   `C layer width radius cx cy a0 ext`   a curved segment (radius signed by hand)
+ *
+ * We parse an owner's OWN file — nothing from XTrkCAD is redistributed. Their
+ * geometry is taken as authoritative for part OUTLINES; ⚠️ don't infer frog
+ * positions from it, the shipped Atlas file is internally inconsistent (it puts
+ * the #5's frog further out than the #7's, which is physically impossible).
+ */
+declare function parseXtpLibrary(text: string): ImportedPart[];
+/** Sample an imported part's segments into polylines, in the part's own frame —
+ * 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[][];
 /** 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.
  *
@@ -1233,4 +1398,4 @@ declare function poseOverridesFromDoc(doc: ModuleSchematicDoc): Record<string, {
     heading: number;
 }>;
 
-export { type BenchworkPoint, type BranchConnector, 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 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, 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 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, moduleCenterline, moduleFeatures, moduleFootprint, moduleLengthFromSections, moduleSections, nextId, poseNeedsManual, poseOverridesFromDoc, remapPos, returnLoop, sampleBenchworkOutline, samplePath, scaleFeetToInches, sectionAdjacency, sectionBand, sectionBreaksFromSections, sectionComponents, sectionFootprints, sectionNeighbours, sectionSpans, sectionSpansOrWhole, sectionedCenterline, sectionedEndPose, sliceCenterline, stateToDoc, toSectionRelative, trackMeetsEndplateIssues, trackPath, turnoutClosure };
+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 };

package/dist/index.d.ts

@@ -1034,12 +1034,177 @@ interface ModuleFeatures {
  */
 /** N-scale track gauge, inches (9 mm). */
 declare const RAIL_GAUGE_INCHES = 0.354;
-/** Points → FROG for a #1 frog, inches — a turnout's LEAD, scaled by frog
- * number. Calibrated COMMERCIALLY rather than on the prototype, since owners lay
- * real product: an Atlas code 55 #7 measures 3⅜″ points→frog (Steve Branton,
- * #173) ⇒ 3.375 / 7. (The prototype #7 lead is 62′-1″ ≈ 4.66″ in N; commercial
- * turnouts are compressed against that.) */
+/**
+ * ⚠️ **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.
+ *
+ * It is NOT proportional. Measured lead ÷ N: **#7 = 0.482, #10 = 0.419.** The
+ * rule predicted 4.82″ for the #10; it measures 4³⁄₁₆″ — **13% over**. Atlas
+ * compress the lead on long turnouts, just as they compress overall length.
+ *
+ * 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.
+ * A fallback at N ≥ 10 will read LONG.
+ *
+ * BETTER MODEL (hypothesis, not yet enough data): a roughly CONSTANT SWITCH
+ * ANGLE α — the angle the point rails leave the stock rail at — which is real
+ * prototype practice, points being planed to a standard angle. Inverting
+ * {@link turnoutClosure} gives `lead = 2g / (1/N + α)`, and the two measured
+ * leads agree to 3%: #7 ⇒ α = 0.0669, #10 ⇒ α = 0.0691. If it holds, lead is
+ * whatever falls out of a fixed point angle meeting the frog, not a multiple
+ * of N. DISCRIMINATING TEST: at α ≈ 0.068 the #5's lead is **2.64″**, where
+ * this constant says 2.41″ — measure a physical 2050 to settle it.
+ */
 declare const TURNOUT_LEAD_INCHES_PER_FROG = 0.482;
+/** Where a dimension came from. `derived` = we computed it from another part or
+ * a rule of thumb; `unverified` = plausible but unconfirmed — treat with care. */
+type DimensionSource = "manufacturer" | "measured" | "derived" | "unverified";
+interface PartDimension {
+    inches: number;
+    source: DimensionSource;
+    /** Who measured it / which spec, so it can be re-checked. */
+    note?: string;
+}
+/** Same provenance discipline as {@link PartDimension}, for angles. */
+interface PartAngle {
+    deg: number;
+    source: DimensionSource;
+    note?: string;
+}
+interface TrackPart {
+    /** Stable slug, e.g. "atlas-c55-n-7". */
+    id: string;
+    manufacturer: string;
+    /** Product line — "Code 55", "Code 80". */
+    line: string;
+    scale: "N";
+    name: string;
+    kind: "turnout" | "wye" | "curved-turnout" | "crossing";
+    /** Manufacturer part numbers by hand, where the part has a hand. */
+    partNumbers?: {
+        left?: string;
+        right?: string;
+        single?: string;
+    };
+    /** Frog number N (the 1:N ratio). Definitional, so no provenance needed. */
+    frogNumber?: number;
+    /** The angle the part ACTUALLY diverges at, where that's known to differ from
+     * the theoretical `atan(1/N)`. Atlas appear to build to SECTIONAL angles
+     * (multiples of 11.25° = 1/32 turn) rather than true frog ratios, so a "#5" is
+     * 11.25° not 11.31°. ⚠️ Currently below our drawing resolution — 0.06° over a
+     * 6″ turnout is 0.006″ — so nothing uses this yet. Recorded because it's a
+     * real property of the product and will matter if we ever check whether a part
+     * mates with sectional track. */
+    actualAngle?: PartAngle;
+    /** Points → frog. The number that decides where a turnout's throat lands. */
+    lead?: PartDimension;
+    /** End of the tie strip → the point tips. Where the working turnout starts
+     * inside its moulding; the rest of that end is plain approach track. Needed to
+     * fit a part into a space, and by any renderer drawing the real outline. */
+    pointsOffset?: PartDimension;
+    /** End-to-end length of the part. */
+    overallLength?: PartDimension;
+    /** Diverging route radius (straight turnouts). */
+    divergingRadius?: PartDimension;
+    /** Curved turnouts: the two concentric radii. */
+    outerRadius?: PartDimension;
+    innerRadius?: PartDimension;
+    /** Crossing angle, degrees. */
+    crossingAngleDeg?: number;
+}
+/** N-scale code 55 rail height, inches — Atlas publish .055″. */
+declare const CODE55_RAIL_HEIGHT_INCHES = 0.055;
+/**
+ * Atlas N-scale Code 55 — the Free-moN mainstay.
+ *
+ * ⚠️ Atlas do not publish leads or overall lengths for the straight turnouts.
+ * Everything here traces to physical measurements: Steve Branton's #7 lead
+ * (3⅜″ points→frog, #173) and Will Gage's #5/#7/#10 overall lengths plus the
+ * #10's lead and points offset. The #5's lead and the wye's are still derived.
+ *
+ * NEITHER DIMENSION IS PROPORTIONAL TO FROG NUMBER. Both rules that assumed so
+ * have now been tested and failed:
+ * - **Lead does NOT scale with N.** Measured lead ÷ N: #7 = 0.482, #10 = 0.419.
+ *   {@link TURNOUT_LEAD_INCHES_PER_FROG} predicted 4.82″ for the #10 against a
+ *   measured 4³⁄₁₆″ — 13% over. See that constant for the constant-switch-angle
+ *   model that fits both measurements, and the test that would confirm it.
+ * - ⭐ **Overall length is NOT A FUNCTION OF N AT ALL.** Measured: #5 = 6.00″,
+ *   **#7 = 6.00″**, #10 = 8.00″. The #5 and #7 are the SAME LENGTH — Atlas mould
+ *   them on a shared 6″ tie strip and vary only the frog angle and where the frog
+ *   sits. NEVER derive a length from a frog number; look the part up.
+ *
+ * This is what the frog-number definition actually says, and it's easy to forget:
+ * #N fixes the DIVERGENCE RATE AT THE FROG (1 across per N along). It says
+ * nothing about how much tie strip the manufacturer wraps around it. Angle is
+ * geometry; length is packaging. Hence the lead — where the frog falls inside
+ * that strip — is the only dimension worth chasing.
+ *
+ * (Lengths are whole inches and the #5 diverges at exactly 1/32 of a circle, so
+ * Atlas do seem to work to round numbers — but a prediction that the #7 would
+ * therefore be 7.00″ was tested and FAILED. Round, but not one inch per frog.)
+ */
+declare const ATLAS_CODE55_N: TrackPart[];
+/** Every built-in part, across manufacturers. */
+declare const BUILT_IN_TRACK_PARTS: TrackPart[];
+/** Look a part up by its slug. */
+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. */
+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 = {
+    kind: "straight";
+    x0: number;
+    y0: number;
+    x1: number;
+    y1: number;
+} | {
+    kind: "curve";
+    radius: number;
+    cx: number;
+    cy: number;
+    startDeg: number;
+    extentDeg: number;
+};
+/** A connection point on an imported part: position plus the tangent it faces. */
+interface PartEnd {
+    x: number;
+    y: number;
+    angleDeg: number;
+}
+interface ImportedPart {
+    /** Raw title, tab-separated in the file: manufacturer, name, part number. */
+    title: string;
+    manufacturer?: string;
+    name?: string;
+    partNumber?: string;
+    scale?: string;
+    ends: PartEnd[];
+    segments: PartSegment[];
+}
+/**
+ * Parse an XTrkCAD `.xtp` parameter file into parts.
+ *
+ * The format is plain text, record-per-line inside `TURNOUT … END` blocks:
+ *   `E x y angle`                         an endpoint
+ *   `S layer width x0 y0 x1 y1`           a straight segment
+ *   `C layer width radius cx cy a0 ext`   a curved segment (radius signed by hand)
+ *
+ * We parse an owner's OWN file — nothing from XTrkCAD is redistributed. Their
+ * geometry is taken as authoritative for part OUTLINES; ⚠️ don't infer frog
+ * positions from it, the shipped Atlas file is internally inconsistent (it puts
+ * the #5's frog further out than the #7's, which is physically impossible).
+ */
+declare function parseXtpLibrary(text: string): ImportedPart[];
+/** Sample an imported part's segments into polylines, in the part's own frame —
+ * 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[][];
 /** 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.
  *
@@ -1233,4 +1398,4 @@ declare function poseOverridesFromDoc(doc: ModuleSchematicDoc): Record<string, {
     heading: number;
 }>;
 
-export { type BenchworkPoint, type BranchConnector, 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 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, 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 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, moduleCenterline, moduleFeatures, moduleFootprint, moduleLengthFromSections, moduleSections, nextId, poseNeedsManual, poseOverridesFromDoc, remapPos, returnLoop, sampleBenchworkOutline, samplePath, scaleFeetToInches, sectionAdjacency, sectionBand, sectionBreaksFromSections, sectionComponents, sectionFootprints, sectionNeighbours, sectionSpans, sectionSpansOrWhole, sectionedCenterline, sectionedEndPose, sliceCenterline, stateToDoc, toSectionRelative, trackMeetsEndplateIssues, trackPath, turnoutClosure };
+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 };

package/dist/index.js

@@ -1090,6 +1090,195 @@ function buildCrossover(state) {
 }
 var RAIL_GAUGE_INCHES = 0.354;
 var TURNOUT_LEAD_INCHES_PER_FROG = 0.482;
+var CODE55_RAIL_HEIGHT_INCHES = 0.055;
+var ATLAS_CODE55_N = [
+  {
+    id: "atlas-c55-n-5",
+    manufacturer: "Atlas",
+    line: "Code 55",
+    scale: "N",
+    name: "#5 Turnout",
+    kind: "turnout",
+    partNumbers: { left: "2050", right: "2051" },
+    frogNumber: 5,
+    lead: {
+      inches: 5 * TURNOUT_LEAD_INCHES_PER_FROG,
+      source: "derived",
+      note: "scaled from the measured #7 by frog number \u2014 not measured, BUT now corroborated: a photo read of Will's physical 2050 puts points\u2192frog at ~2.4\u2033, i.e. 0.48/frog against the #7's 0.482. Replace with a real measurement when someone puts a rule on it."
+    },
+    overallLength: {
+      inches: 6,
+      source: "measured",
+      note: "Will Gage, physical Atlas 2050 (#5 LH), end tie to end tie"
+    },
+    actualAngle: {
+      deg: 11.25,
+      source: "unverified",
+      note: "CORROBORATED: XTrkCAD N-atlasn55.xtp gives 11.250152\xB0, and AnyRail-forum trial-and-error (glakedylan, 2012) gives 11.25\xB0. Theory atan(1/5) = 11.310\xB0. 11.25\xB0 is exactly 1/32 turn \u2014 Atlas appear to build to sectional angles."
+    }
+  },
+  {
+    id: "atlas-c55-n-7",
+    manufacturer: "Atlas",
+    line: "Code 55",
+    scale: "N",
+    name: "#7 Turnout",
+    kind: "turnout",
+    partNumbers: { left: "2052", right: "2053" },
+    frogNumber: 7,
+    lead: {
+      inches: 3.375,
+      source: "measured",
+      note: "Steve Branton, physical Atlas code 55 #7, 3\u215C\u2033 points\u2192frog (#173)"
+    },
+    overallLength: {
+      inches: 6,
+      source: "measured",
+      note: "Will Gage, physical Atlas 2052 (#7), end tie to end tie \u2014 the SAME 6\u2033 as the #5, which is what proves length is not a function of frog number"
+    },
+    actualAngle: {
+      deg: 8.13,
+      source: "unverified",
+      note: "DISPUTED: XTrkCAD .xtp says 8.1818\xB0, AnyRail forum says 8.125\xB0, theory atan(1/7) = 8.130\xB0. The sources disagree, so theory is used here."
+    }
+  },
+  {
+    id: "atlas-c55-n-10",
+    manufacturer: "Atlas",
+    line: "Code 55",
+    scale: "N",
+    name: "#10 Turnout",
+    kind: "turnout",
+    partNumbers: { left: "2054", right: "2055" },
+    frogNumber: 10,
+    lead: {
+      inches: 4.1875,
+      source: "measured",
+      note: "Will Gage, physical Atlas 2054 (#10): points at 9/16\u2033 from the end, frog at 4.75\u2033 \u21D2 4\xB3\u2044\u2081\u2086\u2033. THIS IS THE MEASUREMENT THAT REFUTED the lead-per-frog rule \u2014 it predicted 4.82\u2033, 13% over."
+    },
+    pointsOffset: {
+      inches: 0.5625,
+      source: "measured",
+      note: "Will Gage, physical Atlas 2054 (#10) \u2014 end of tie strip to point tips"
+    },
+    overallLength: {
+      inches: 8,
+      source: "measured",
+      note: "Will Gage, physical Atlas 2054 (#10), end tie to end tie"
+    },
+    actualAngle: {
+      deg: 5.74,
+      source: "unverified",
+      note: "CORROBORATED: XTrkCAD .xtp gives 5.739\xB0, AnyRail forum 5.75\xB0 \u2014 they agree with each other and not with theory atan(1/10) = 5.711\xB0."
+    }
+  },
+  {
+    id: "atlas-c55-n-wye",
+    manufacturer: "Atlas",
+    line: "Code 55",
+    scale: "N",
+    name: "#2.5 Wye",
+    kind: "wye",
+    partNumbers: { single: "2056" },
+    frogNumber: 2.5,
+    lead: {
+      inches: 2.5 * TURNOUT_LEAD_INCHES_PER_FROG,
+      source: "derived",
+      note: "scaled from the measured #7 by frog number \u2014 not measured"
+    }
+  },
+  {
+    id: "atlas-c55-n-curved-21-15",
+    manufacturer: "Atlas",
+    line: "Code 55",
+    scale: "N",
+    name: 'Curved Turnout 21\xBC" / 15"',
+    kind: "curved-turnout",
+    partNumbers: { left: "2058", right: "2059" },
+    outerRadius: { inches: 21.25, source: "manufacturer", note: "Atlas product listing" },
+    innerRadius: { inches: 15, source: "manufacturer", note: "Atlas product listing" }
+  }
+];
+var BUILT_IN_TRACK_PARTS = [...ATLAS_CODE55_N];
+function trackPart(id, library = BUILT_IN_TRACK_PARTS) {
+  return library.find((p) => p.id === id) ?? null;
+}
+function turnoutPartForSize(size, library = BUILT_IN_TRACK_PARTS) {
+  const turnouts = library.filter((p) => p.kind === "turnout" && p.frogNumber != null);
+  if (!turnouts.length) return null;
+  return turnouts.reduce(
+    (best, p) => Math.abs(p.frogNumber - size) < Math.abs(best.frogNumber - size) ? p : best
+  );
+}
+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;
+}
+function parseXtpLibrary(text) {
+  const parts = [];
+  let cur = null;
+  for (const raw of text.split(/\r?\n/)) {
+    const line = raw.trim();
+    if (!line || line.startsWith("#")) continue;
+    if (line.startsWith("TURNOUT")) {
+      const quoted = line.match(/"([^"]*)"/);
+      const scale = line.split(/\s+/)[1];
+      const title = quoted?.[1] ?? "";
+      const bits = title.split("	").map((s) => s.trim()).filter(Boolean);
+      cur = {
+        title,
+        scale,
+        manufacturer: bits[0],
+        name: bits[1],
+        partNumber: bits[2],
+        ends: [],
+        segments: []
+      };
+      continue;
+    }
+    if (!cur) continue;
+    if (line === "END") {
+      if (cur.ends.length || cur.segments.length) parts.push(cur);
+      cur = null;
+      continue;
+    }
+    const n = line.split(/\s+/);
+    const num = (i) => Number(n[i]);
+    if (n[0] === "E" && n.length >= 4) {
+      cur.ends.push({ x: num(1), y: num(2), angleDeg: num(3) });
+    } else if (n[0] === "S" && n.length >= 7) {
+      cur.segments.push({ kind: "straight", x0: num(3), y0: num(4), x1: num(5), y1: num(6) });
+    } else if (n[0] === "C" && n.length >= 8) {
+      cur.segments.push({
+        kind: "curve",
+        radius: num(3),
+        cx: num(4),
+        cy: num(5),
+        startDeg: num(6),
+        extentDeg: num(7)
+      });
+    }
+  }
+  return parts;
+}
+function samplePartSegments(segments, stepsPerCurve = 16) {
+  return segments.map((s) => {
+    if (s.kind === "straight") {
+      return [
+        { x: s.x0, y: s.y0 },
+        { x: s.x1, y: s.y1 }
+      ];
+    }
+    const r = Math.abs(s.radius);
+    const out = [];
+    for (let i = 0; i <= stepsPerCurve; i++) {
+      const a = (s.startDeg + s.extentDeg * i / stepsPerCurve) * Math.PI / 180;
+      out.push({ x: s.cx + r * Math.sin(a), y: s.cy + r * Math.cos(a) });
+    }
+    return out;
+  });
+}
 function turnoutClosure(size, opts = {}) {
   const N = size > 0 ? size : 6;
   const g = opts.gaugeInches ?? RAIL_GAUGE_INCHES;
@@ -1619,6 +1808,6 @@ function poseOverridesFromDoc(doc) {
   return out;
 }
 
-export { 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, moduleCenterline, moduleFeatures, moduleFootprint, moduleLengthFromSections, moduleSections, nextId, poseNeedsManual, poseOverridesFromDoc, remapPos, returnLoop, sampleBenchworkOutline, samplePath, scaleFeetToInches, sectionAdjacency, sectionBand, sectionBreaksFromSections, sectionComponents, sectionFootprints, sectionNeighbours, sectionSpans, sectionSpansOrWhole, sectionedCenterline, sectionedEndPose, sliceCenterline, stateToDoc, toSectionRelative, trackMeetsEndplateIssues, trackPath, turnoutClosure };
+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 };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map