@willcgage/module-schematic 0.56.0 → 0.58.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;
@@ -1128,6 +1135,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;
@@ -1257,6 +1274,56 @@ 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 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.
  *
@@ -1450,4 +1517,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, 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;
@@ -1128,6 +1135,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;
@@ -1257,6 +1274,56 @@ 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 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.
  *
@@ -1450,4 +1517,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, 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) => ({
@@ -1318,6 +1320,123 @@ 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 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;
@@ -1847,6 +1966,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, 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