@willcgage/module-schematic 0.62.0 → 0.64.0

package/dist/index.d.cts

@@ -1262,6 +1262,42 @@ declare const ATLAS_CODE55_N: TrackPart[];
 declare const BUILT_IN_TRACK_PARTS: TrackPart[];
 /** Look a part up by its slug. */
 declare function trackPart(id: string, library?: TrackPart[]): TrackPart | null;
+/** Half an N-scale tie, inches — a 8′6″ tie is 102″ prototype, /160 ≈ 0.638″.
+ * The half-width a tie strip extends either side of the rail it carries, which
+ * is what gives a drawn turnout body its width. */
+declare const TIE_HALF_LENGTH_INCHES = 0.319;
+/** Where a turnout part physically starts and stops, relative to its POINTS.
+ * All inches; `aheadOfPoints` is the end of the tie strip, which is essentially
+ * where the diverging rail stops and the owner's flex track begins. */
+interface PartExtent {
+    /** Points → the near end of the tie strip. Positive = the strip starts this
+     * far BEHIND the points (it always does — that end is plain approach track). */
+    behindPoints: number;
+    /** Points → the far end of the tie strip. */
+    aheadOfPoints: number;
+    /** Frog → the far end. How much turnout there still is past the frog. */
+    pastFrog: number;
+}
+/**
+ * A part's real extent, or **null when it hasn't been measured**.
+ *
+ * ⚠️ This deliberately does NOT fall back to a frog-number rule, unlike
+ * {@link leadInchesForSize}. Overall length is not a function of N — the #5 and
+ * the #7 are BOTH 6.00″, same tie strip, different frog. Angle is geometry;
+ * length is packaging, and packaging can only be looked up. A renderer that
+ * gets null should draw no part boundary rather than invent one: the absence is
+ * a truthful signal that the library has a gap, and inventing a length here is
+ * how hand-built geometry once reached owners as if it were part data.
+ *
+ * Requires `pointsOffset` and `overallLength`; `pastFrog` additionally needs
+ * `frogOffset`. Every dimension must be `measured` — a derived one would launder
+ * a guess into a drawing that says "this is where your turnout ends".
+ */
+declare function partExtent(part: TrackPart | null | undefined): PartExtent | null;
+/** The extent of the part a turnout of this frog number IS, or null when no
+ * measured part matches EXACTLY. A #6 is not a #5 or a #7 — the nearest part's
+ * length says nothing about it (see {@link partExtent}). */
+declare function partExtentForSize(size: number, library?: TrackPart[]): PartExtent | 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;
@@ -1347,6 +1383,63 @@ declare function frogNumberFromName(name: string | undefined): number | undefine
  * land as `unverified`, because a community CAD file is not a measurement.
  */
 declare function importedPartToTrackPart(part: ImportedPart, sourceName?: string): TrackPart;
+/**
+ * A part as an application stores it — one flat row, so the package needs to
+ * know nothing about any particular database. Dimensions are plain numbers with
+ * a `source` beside each, mirroring {@link PartDimension}.
+ */
+interface StoredTrackPart {
+    slug: string;
+    manufacturer: string;
+    line: string;
+    scale?: string | null;
+    name: string;
+    kind?: string | null;
+    partNumberLeft?: string | null;
+    partNumberRight?: string | null;
+    partNumberSingle?: string | null;
+    frogNumber?: number | null;
+    pointsOffsetInches?: number | null;
+    pointsOffsetSource?: string | null;
+    frogOffsetInches?: number | null;
+    frogOffsetSource?: string | null;
+    overallLengthInches?: number | null;
+    overallLengthSource?: string | null;
+    leadInches?: number | null;
+    leadSource?: string | null;
+    outerRadiusInches?: number | null;
+    innerRadiusInches?: number | null;
+    radiusSource?: string | null;
+    actualAngleDeg?: number | null;
+    actualAngleSource?: string | null;
+    measurementNote?: string | null;
+}
+/**
+ * Convert a stored row into a {@link TrackPart}.
+ *
+ * The LEAD is derived from the two offsets whenever both are present, rather
+ * than read from its own column: they're measured from the same tie end, so
+ * their difference is the lead by construction, and a separately-entered lead
+ * could silently disagree with the positions it's supposed to summarise. A
+ * stored `leadInches` is used only for a part whose offsets aren't known.
+ */
+declare function storedPartToTrackPart(row: StoredTrackPart): TrackPart;
+/**
+ * Fold an application's STORED library over the built-in one, by slug.
+ *
+ * ⚠️ Unlike {@link mergeImportedParts}, a stored part **replaces** a built-in
+ * outright. That difference is deliberate, and the reason is who is speaking: an
+ * import is a third-party file that may have been fitted in someone else's CAD
+ * program, so it may only fill gaps. The stored library is seeded FROM these
+ * built-ins and edited by an admin with the part in their hand — it is the same
+ * library, later. Refusing their correction would mean a wrong dimension could
+ * only be fixed by shipping a release, which is exactly the limitation the
+ * stored library exists to remove.
+ *
+ * The built-ins remain the floor: a part nobody has stored still resolves, so
+ * geometry keeps working with no database at all.
+ */
+declare function mergeStoredParts(stored: StoredTrackPart[], library?: TrackPart[]): TrackPart[];
 /**
  * Fold imported parts into a library.
  *
@@ -1637,4 +1730,4 @@ declare function poseOverridesFromDoc(doc: ModuleSchematicDoc): Record<string, {
     heading: number;
 }>;
 
-export { ATLAS_CODE55_N, BUILT_IN_TRACK_PARTS, type BenchworkPoint, type BranchConnector, CODE55_RAIL_HEIGHT_INCHES, type DimensionSource, type DrawCrossing, type DrawCrossover, type DrawIndustry, type DrawSignal, type DrawTrack, type DrawTurnout, ENDPLATE_FASCIA_CLEAR_INCHES, ENDPLATE_LEAD_INCHES, type EditorBranch, type EditorControlPoint, type EditorCpSignal, type EditorCrossing, type EditorIndustry, type EditorState, type EditorTrack, type EditorTurnout, type EndplateBConfig, type EndplatePose, type EndplateTrackIssue, type EndplateWidthIssue, FREEMO_ENDPLATE_TRACK_FASCIA_CLEARANCE_INCHES, FREEMO_ENDPLATE_WIDTH_MIN_INCHES, FREEMO_ENDPLATE_WIDTH_RECOMMENDED_INCHES, FREEMO_TRACK_SPACING_INCHES, type FrogCasting, type GeometryType, type ImportedPart, type IndustryLabelMode, type IndustrySpot, MAIN2_TRACK_ID, MAIN_TRACK_ID, type ModuleFeatures, type ModuleFootprint, type ModuleFootprintInput, type ModuleGeometryInput, type ModuleSchematicDoc, type ModuleTrackRow, N_CAR_LENGTH_INCHES, N_SCALE_RATIO, type OutlineFace, type PartAngle, type PartDimension, type PartEnd, type PartSegment, RAIL_GAUGE_INCHES, type ReturnLoopGeometry, type ReturnLoopShape, type SchematicBlock, type SchematicControlPoint, type SchematicCrossing, type SchematicEndplate, type SchematicEndplateTrack, type SchematicIndustry, type SchematicSection, type SchematicSignal, type SchematicTrack, type SchematicTurnout, type SectionAdjacency, type SectionFootprint, type SectionRelativePos, type SignalFacing, type SignalSide, TURNOUT_LEAD_INCHES_PER_FROG, type TrackConfig, type TrackPart, type TrackRole, type TurnoutClosure, type TurnoutKind, WHOLE_MODULE_SECTION_ID, asModuleSchematic, benchworkBand, benchworkOutline, buildCrossover, buildPassingSiding, buildTransition, carCapacity, checkEndplateWidth, deriveEndplatePoses, divergeSideForHand, docToState, emptyEditorState, endplateFaceSegments, endplateLead, endplateTrackOffsetFor, endplateTrackOffsetInches, endplateWidthInches, frogCasting, frogNumberFromName, fromSectionRelative, geometryTurnDegrees, importedPartToTrackPart, inchesToScaleFeet, isLoopDoc, isTransitionTurnout, leadInchesForSize, mergeImportedParts, moduleCenterline, moduleFeatures, moduleFootprint, moduleLengthFromSections, moduleSections, nextId, parseXtpLibrary, partOutlineAtFrog, pathLengthInches, poseNeedsManual, poseOverridesFromDoc, remapPos, returnLoop, sampleBenchworkOutline, samplePartSegments, samplePath, scaleFeetToInches, sectionAdjacency, sectionBand, sectionBreaksFromSections, sectionComponents, sectionFootprints, sectionNeighbours, sectionSpans, sectionSpansOrWhole, sectionedCenterline, sectionedEndPose, sliceCenterline, stateToDoc, toSectionRelative, trackMeetsEndplateIssues, trackPart, trackPath, turnoutClosure, turnoutPartForSize };
+export { ATLAS_CODE55_N, BUILT_IN_TRACK_PARTS, type BenchworkPoint, type BranchConnector, CODE55_RAIL_HEIGHT_INCHES, type DimensionSource, type DrawCrossing, type DrawCrossover, type DrawIndustry, type DrawSignal, type DrawTrack, type DrawTurnout, ENDPLATE_FASCIA_CLEAR_INCHES, ENDPLATE_LEAD_INCHES, type EditorBranch, type EditorControlPoint, type EditorCpSignal, type EditorCrossing, type EditorIndustry, type EditorState, type EditorTrack, type EditorTurnout, type EndplateBConfig, type EndplatePose, type EndplateTrackIssue, type EndplateWidthIssue, FREEMO_ENDPLATE_TRACK_FASCIA_CLEARANCE_INCHES, FREEMO_ENDPLATE_WIDTH_MIN_INCHES, FREEMO_ENDPLATE_WIDTH_RECOMMENDED_INCHES, FREEMO_TRACK_SPACING_INCHES, type FrogCasting, type GeometryType, type ImportedPart, type IndustryLabelMode, type IndustrySpot, MAIN2_TRACK_ID, MAIN_TRACK_ID, type ModuleFeatures, type ModuleFootprint, type ModuleFootprintInput, type ModuleGeometryInput, type ModuleSchematicDoc, type ModuleTrackRow, N_CAR_LENGTH_INCHES, N_SCALE_RATIO, type OutlineFace, type PartAngle, type PartDimension, type PartEnd, type PartExtent, 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, type StoredTrackPart, TIE_HALF_LENGTH_INCHES, TURNOUT_LEAD_INCHES_PER_FROG, type TrackConfig, type TrackPart, type TrackRole, type TurnoutClosure, type TurnoutKind, WHOLE_MODULE_SECTION_ID, asModuleSchematic, benchworkBand, benchworkOutline, buildCrossover, buildPassingSiding, buildTransition, carCapacity, checkEndplateWidth, deriveEndplatePoses, divergeSideForHand, docToState, emptyEditorState, endplateFaceSegments, endplateLead, endplateTrackOffsetFor, endplateTrackOffsetInches, endplateWidthInches, frogCasting, frogNumberFromName, fromSectionRelative, geometryTurnDegrees, importedPartToTrackPart, inchesToScaleFeet, isLoopDoc, isTransitionTurnout, leadInchesForSize, mergeImportedParts, mergeStoredParts, moduleCenterline, moduleFeatures, moduleFootprint, moduleLengthFromSections, moduleSections, nextId, parseXtpLibrary, partExtent, partExtentForSize, partOutlineAtFrog, pathLengthInches, poseNeedsManual, poseOverridesFromDoc, remapPos, returnLoop, sampleBenchworkOutline, samplePartSegments, samplePath, scaleFeetToInches, sectionAdjacency, sectionBand, sectionBreaksFromSections, sectionComponents, sectionFootprints, sectionNeighbours, sectionSpans, sectionSpansOrWhole, sectionedCenterline, sectionedEndPose, sliceCenterline, stateToDoc, storedPartToTrackPart, toSectionRelative, trackMeetsEndplateIssues, trackPart, trackPath, turnoutClosure, turnoutPartForSize };

package/dist/index.d.ts

@@ -1262,6 +1262,42 @@ declare const ATLAS_CODE55_N: TrackPart[];
 declare const BUILT_IN_TRACK_PARTS: TrackPart[];
 /** Look a part up by its slug. */
 declare function trackPart(id: string, library?: TrackPart[]): TrackPart | null;
+/** Half an N-scale tie, inches — a 8′6″ tie is 102″ prototype, /160 ≈ 0.638″.
+ * The half-width a tie strip extends either side of the rail it carries, which
+ * is what gives a drawn turnout body its width. */
+declare const TIE_HALF_LENGTH_INCHES = 0.319;
+/** Where a turnout part physically starts and stops, relative to its POINTS.
+ * All inches; `aheadOfPoints` is the end of the tie strip, which is essentially
+ * where the diverging rail stops and the owner's flex track begins. */
+interface PartExtent {
+    /** Points → the near end of the tie strip. Positive = the strip starts this
+     * far BEHIND the points (it always does — that end is plain approach track). */
+    behindPoints: number;
+    /** Points → the far end of the tie strip. */
+    aheadOfPoints: number;
+    /** Frog → the far end. How much turnout there still is past the frog. */
+    pastFrog: number;
+}
+/**
+ * A part's real extent, or **null when it hasn't been measured**.
+ *
+ * ⚠️ This deliberately does NOT fall back to a frog-number rule, unlike
+ * {@link leadInchesForSize}. Overall length is not a function of N — the #5 and
+ * the #7 are BOTH 6.00″, same tie strip, different frog. Angle is geometry;
+ * length is packaging, and packaging can only be looked up. A renderer that
+ * gets null should draw no part boundary rather than invent one: the absence is
+ * a truthful signal that the library has a gap, and inventing a length here is
+ * how hand-built geometry once reached owners as if it were part data.
+ *
+ * Requires `pointsOffset` and `overallLength`; `pastFrog` additionally needs
+ * `frogOffset`. Every dimension must be `measured` — a derived one would launder
+ * a guess into a drawing that says "this is where your turnout ends".
+ */
+declare function partExtent(part: TrackPart | null | undefined): PartExtent | null;
+/** The extent of the part a turnout of this frog number IS, or null when no
+ * measured part matches EXACTLY. A #6 is not a #5 or a #7 — the nearest part's
+ * length says nothing about it (see {@link partExtent}). */
+declare function partExtentForSize(size: number, library?: TrackPart[]): PartExtent | 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;
@@ -1347,6 +1383,63 @@ declare function frogNumberFromName(name: string | undefined): number | undefine
  * land as `unverified`, because a community CAD file is not a measurement.
  */
 declare function importedPartToTrackPart(part: ImportedPart, sourceName?: string): TrackPart;
+/**
+ * A part as an application stores it — one flat row, so the package needs to
+ * know nothing about any particular database. Dimensions are plain numbers with
+ * a `source` beside each, mirroring {@link PartDimension}.
+ */
+interface StoredTrackPart {
+    slug: string;
+    manufacturer: string;
+    line: string;
+    scale?: string | null;
+    name: string;
+    kind?: string | null;
+    partNumberLeft?: string | null;
+    partNumberRight?: string | null;
+    partNumberSingle?: string | null;
+    frogNumber?: number | null;
+    pointsOffsetInches?: number | null;
+    pointsOffsetSource?: string | null;
+    frogOffsetInches?: number | null;
+    frogOffsetSource?: string | null;
+    overallLengthInches?: number | null;
+    overallLengthSource?: string | null;
+    leadInches?: number | null;
+    leadSource?: string | null;
+    outerRadiusInches?: number | null;
+    innerRadiusInches?: number | null;
+    radiusSource?: string | null;
+    actualAngleDeg?: number | null;
+    actualAngleSource?: string | null;
+    measurementNote?: string | null;
+}
+/**
+ * Convert a stored row into a {@link TrackPart}.
+ *
+ * The LEAD is derived from the two offsets whenever both are present, rather
+ * than read from its own column: they're measured from the same tie end, so
+ * their difference is the lead by construction, and a separately-entered lead
+ * could silently disagree with the positions it's supposed to summarise. A
+ * stored `leadInches` is used only for a part whose offsets aren't known.
+ */
+declare function storedPartToTrackPart(row: StoredTrackPart): TrackPart;
+/**
+ * Fold an application's STORED library over the built-in one, by slug.
+ *
+ * ⚠️ Unlike {@link mergeImportedParts}, a stored part **replaces** a built-in
+ * outright. That difference is deliberate, and the reason is who is speaking: an
+ * import is a third-party file that may have been fitted in someone else's CAD
+ * program, so it may only fill gaps. The stored library is seeded FROM these
+ * built-ins and edited by an admin with the part in their hand — it is the same
+ * library, later. Refusing their correction would mean a wrong dimension could
+ * only be fixed by shipping a release, which is exactly the limitation the
+ * stored library exists to remove.
+ *
+ * The built-ins remain the floor: a part nobody has stored still resolves, so
+ * geometry keeps working with no database at all.
+ */
+declare function mergeStoredParts(stored: StoredTrackPart[], library?: TrackPart[]): TrackPart[];
 /**
  * Fold imported parts into a library.
  *
@@ -1637,4 +1730,4 @@ declare function poseOverridesFromDoc(doc: ModuleSchematicDoc): Record<string, {
     heading: number;
 }>;
 
-export { ATLAS_CODE55_N, BUILT_IN_TRACK_PARTS, type BenchworkPoint, type BranchConnector, CODE55_RAIL_HEIGHT_INCHES, type DimensionSource, type DrawCrossing, type DrawCrossover, type DrawIndustry, type DrawSignal, type DrawTrack, type DrawTurnout, ENDPLATE_FASCIA_CLEAR_INCHES, ENDPLATE_LEAD_INCHES, type EditorBranch, type EditorControlPoint, type EditorCpSignal, type EditorCrossing, type EditorIndustry, type EditorState, type EditorTrack, type EditorTurnout, type EndplateBConfig, type EndplatePose, type EndplateTrackIssue, type EndplateWidthIssue, FREEMO_ENDPLATE_TRACK_FASCIA_CLEARANCE_INCHES, FREEMO_ENDPLATE_WIDTH_MIN_INCHES, FREEMO_ENDPLATE_WIDTH_RECOMMENDED_INCHES, FREEMO_TRACK_SPACING_INCHES, type FrogCasting, type GeometryType, type ImportedPart, type IndustryLabelMode, type IndustrySpot, MAIN2_TRACK_ID, MAIN_TRACK_ID, type ModuleFeatures, type ModuleFootprint, type ModuleFootprintInput, type ModuleGeometryInput, type ModuleSchematicDoc, type ModuleTrackRow, N_CAR_LENGTH_INCHES, N_SCALE_RATIO, type OutlineFace, type PartAngle, type PartDimension, type PartEnd, type PartSegment, RAIL_GAUGE_INCHES, type ReturnLoopGeometry, type ReturnLoopShape, type SchematicBlock, type SchematicControlPoint, type SchematicCrossing, type SchematicEndplate, type SchematicEndplateTrack, type SchematicIndustry, type SchematicSection, type SchematicSignal, type SchematicTrack, type SchematicTurnout, type SectionAdjacency, type SectionFootprint, type SectionRelativePos, type SignalFacing, type SignalSide, TURNOUT_LEAD_INCHES_PER_FROG, type TrackConfig, type TrackPart, type TrackRole, type TurnoutClosure, type TurnoutKind, WHOLE_MODULE_SECTION_ID, asModuleSchematic, benchworkBand, benchworkOutline, buildCrossover, buildPassingSiding, buildTransition, carCapacity, checkEndplateWidth, deriveEndplatePoses, divergeSideForHand, docToState, emptyEditorState, endplateFaceSegments, endplateLead, endplateTrackOffsetFor, endplateTrackOffsetInches, endplateWidthInches, frogCasting, frogNumberFromName, fromSectionRelative, geometryTurnDegrees, importedPartToTrackPart, inchesToScaleFeet, isLoopDoc, isTransitionTurnout, leadInchesForSize, mergeImportedParts, moduleCenterline, moduleFeatures, moduleFootprint, moduleLengthFromSections, moduleSections, nextId, parseXtpLibrary, partOutlineAtFrog, pathLengthInches, poseNeedsManual, poseOverridesFromDoc, remapPos, returnLoop, sampleBenchworkOutline, samplePartSegments, samplePath, scaleFeetToInches, sectionAdjacency, sectionBand, sectionBreaksFromSections, sectionComponents, sectionFootprints, sectionNeighbours, sectionSpans, sectionSpansOrWhole, sectionedCenterline, sectionedEndPose, sliceCenterline, stateToDoc, toSectionRelative, trackMeetsEndplateIssues, trackPart, trackPath, turnoutClosure, turnoutPartForSize };
+export { ATLAS_CODE55_N, BUILT_IN_TRACK_PARTS, type BenchworkPoint, type BranchConnector, CODE55_RAIL_HEIGHT_INCHES, type DimensionSource, type DrawCrossing, type DrawCrossover, type DrawIndustry, type DrawSignal, type DrawTrack, type DrawTurnout, ENDPLATE_FASCIA_CLEAR_INCHES, ENDPLATE_LEAD_INCHES, type EditorBranch, type EditorControlPoint, type EditorCpSignal, type EditorCrossing, type EditorIndustry, type EditorState, type EditorTrack, type EditorTurnout, type EndplateBConfig, type EndplatePose, type EndplateTrackIssue, type EndplateWidthIssue, FREEMO_ENDPLATE_TRACK_FASCIA_CLEARANCE_INCHES, FREEMO_ENDPLATE_WIDTH_MIN_INCHES, FREEMO_ENDPLATE_WIDTH_RECOMMENDED_INCHES, FREEMO_TRACK_SPACING_INCHES, type FrogCasting, type GeometryType, type ImportedPart, type IndustryLabelMode, type IndustrySpot, MAIN2_TRACK_ID, MAIN_TRACK_ID, type ModuleFeatures, type ModuleFootprint, type ModuleFootprintInput, type ModuleGeometryInput, type ModuleSchematicDoc, type ModuleTrackRow, N_CAR_LENGTH_INCHES, N_SCALE_RATIO, type OutlineFace, type PartAngle, type PartDimension, type PartEnd, type PartExtent, 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, type StoredTrackPart, TIE_HALF_LENGTH_INCHES, TURNOUT_LEAD_INCHES_PER_FROG, type TrackConfig, type TrackPart, type TrackRole, type TurnoutClosure, type TurnoutKind, WHOLE_MODULE_SECTION_ID, asModuleSchematic, benchworkBand, benchworkOutline, buildCrossover, buildPassingSiding, buildTransition, carCapacity, checkEndplateWidth, deriveEndplatePoses, divergeSideForHand, docToState, emptyEditorState, endplateFaceSegments, endplateLead, endplateTrackOffsetFor, endplateTrackOffsetInches, endplateWidthInches, frogCasting, frogNumberFromName, fromSectionRelative, geometryTurnDegrees, importedPartToTrackPart, inchesToScaleFeet, isLoopDoc, isTransitionTurnout, leadInchesForSize, mergeImportedParts, mergeStoredParts, moduleCenterline, moduleFeatures, moduleFootprint, moduleLengthFromSections, moduleSections, nextId, parseXtpLibrary, partExtent, partExtentForSize, partOutlineAtFrog, pathLengthInches, poseNeedsManual, poseOverridesFromDoc, remapPos, returnLoop, sampleBenchworkOutline, samplePartSegments, samplePath, scaleFeetToInches, sectionAdjacency, sectionBand, sectionBreaksFromSections, sectionComponents, sectionFootprints, sectionNeighbours, sectionSpans, sectionSpansOrWhole, sectionedCenterline, sectionedEndPose, sliceCenterline, stateToDoc, storedPartToTrackPart, toSectionRelative, trackMeetsEndplateIssues, trackPart, trackPath, turnoutClosure, turnoutPartForSize };

package/dist/index.js

@@ -1239,6 +1239,24 @@ var BUILT_IN_TRACK_PARTS = [...ATLAS_CODE55_N];
 function trackPart(id, library = BUILT_IN_TRACK_PARTS) {
   return library.find((p) => p.id === id) ?? null;
 }
+var TIE_HALF_LENGTH_INCHES = 0.319;
+function partExtent(part) {
+  const pts = part?.pointsOffset;
+  const overall = part?.overallLength;
+  if (!pts || !overall) return null;
+  if (pts.source !== "measured" || overall.source !== "measured") return null;
+  const frog = part?.frogOffset;
+  const aheadOfPoints = overall.inches - pts.inches;
+  return {
+    behindPoints: pts.inches,
+    aheadOfPoints,
+    pastFrog: frog && frog.source === "measured" ? overall.inches - frog.inches : aheadOfPoints
+  };
+}
+function partExtentForSize(size, library = BUILT_IN_TRACK_PARTS) {
+  const part = turnoutPartForSize(size, library);
+  return part && part.frogNumber === size ? partExtent(part) : 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;
@@ -1385,6 +1403,55 @@ function importedPartToTrackPart(part, sourceName = "imported .xtp") {
   }
   return out;
 }
+var asSource = (s) => s === "manufacturer" || s === "measured" || s === "derived" ? s : "unverified";
+function storedPartToTrackPart(row) {
+  const note = row.measurementNote ?? void 0;
+  const dim = (inches, source) => typeof inches === "number" && Number.isFinite(inches) ? { inches, source: asSource(source), ...note ? { note } : {} } : void 0;
+  const points = dim(row.pointsOffsetInches, row.pointsOffsetSource);
+  const frog = dim(row.frogOffsetInches, row.frogOffsetSource);
+  const lead = points && frog ? {
+    inches: frog.inches - points.inches,
+    source: points.source === "measured" && frog.source === "measured" ? "measured" : "derived",
+    ...note ? { note } : {}
+  } : dim(row.leadInches, row.leadSource);
+  const kind = row.kind;
+  const part = {
+    id: row.slug,
+    manufacturer: row.manufacturer,
+    line: row.line,
+    scale: "N",
+    name: row.name,
+    kind: kind === "wye" || kind === "curved-turnout" || kind === "crossing" ? kind : "turnout"
+  };
+  const numbers = {
+    ...row.partNumberLeft ? { left: row.partNumberLeft } : {},
+    ...row.partNumberRight ? { right: row.partNumberRight } : {},
+    ...row.partNumberSingle ? { single: row.partNumberSingle } : {}
+  };
+  if (Object.keys(numbers).length) part.partNumbers = numbers;
+  if (typeof row.frogNumber === "number") part.frogNumber = row.frogNumber;
+  if (points) part.pointsOffset = points;
+  if (frog) part.frogOffset = frog;
+  const overall = dim(row.overallLengthInches, row.overallLengthSource);
+  if (overall) part.overallLength = overall;
+  if (lead) part.lead = lead;
+  const outer = dim(row.outerRadiusInches, row.radiusSource);
+  const inner = dim(row.innerRadiusInches, row.radiusSource);
+  if (outer) part.outerRadius = outer;
+  if (inner) part.innerRadius = inner;
+  if (typeof row.actualAngleDeg === "number")
+    part.actualAngle = {
+      deg: row.actualAngleDeg,
+      source: asSource(row.actualAngleSource),
+      ...note ? { note } : {}
+    };
+  return part;
+}
+function mergeStoredParts(stored, library = BUILT_IN_TRACK_PARTS) {
+  const bySlug = new Map(library.map((p) => [p.id, p]));
+  for (const row of stored) bySlug.set(row.slug, storedPartToTrackPart(row));
+  return [...bySlug.values()];
+}
 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());
@@ -2057,6 +2124,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, frogCasting, frogNumberFromName, fromSectionRelative, geometryTurnDegrees, importedPartToTrackPart, inchesToScaleFeet, isLoopDoc, isTransitionTurnout, leadInchesForSize, mergeImportedParts, moduleCenterline, moduleFeatures, moduleFootprint, moduleLengthFromSections, moduleSections, nextId, parseXtpLibrary, partOutlineAtFrog, pathLengthInches, poseNeedsManual, poseOverridesFromDoc, remapPos, returnLoop, sampleBenchworkOutline, samplePartSegments, samplePath, scaleFeetToInches, sectionAdjacency, sectionBand, sectionBreaksFromSections, sectionComponents, sectionFootprints, sectionNeighbours, sectionSpans, sectionSpansOrWhole, sectionedCenterline, sectionedEndPose, sliceCenterline, stateToDoc, toSectionRelative, trackMeetsEndplateIssues, trackPart, trackPath, turnoutClosure, turnoutPartForSize };
+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, TIE_HALF_LENGTH_INCHES, TURNOUT_LEAD_INCHES_PER_FROG, WHOLE_MODULE_SECTION_ID, asModuleSchematic, benchworkBand, benchworkOutline, buildCrossover, buildPassingSiding, buildTransition, carCapacity, checkEndplateWidth, deriveEndplatePoses, divergeSideForHand, docToState, emptyEditorState, endplateFaceSegments, endplateLead, endplateTrackOffsetFor, endplateTrackOffsetInches, endplateWidthInches, frogCasting, frogNumberFromName, fromSectionRelative, geometryTurnDegrees, importedPartToTrackPart, inchesToScaleFeet, isLoopDoc, isTransitionTurnout, leadInchesForSize, mergeImportedParts, mergeStoredParts, moduleCenterline, moduleFeatures, moduleFootprint, moduleLengthFromSections, moduleSections, nextId, parseXtpLibrary, partExtent, partExtentForSize, partOutlineAtFrog, pathLengthInches, poseNeedsManual, poseOverridesFromDoc, remapPos, returnLoop, sampleBenchworkOutline, samplePartSegments, samplePath, scaleFeetToInches, sectionAdjacency, sectionBand, sectionBreaksFromSections, sectionComponents, sectionFootprints, sectionNeighbours, sectionSpans, sectionSpansOrWhole, sectionedCenterline, sectionedEndPose, sliceCenterline, stateToDoc, storedPartToTrackPart, toSectionRelative, trackMeetsEndplateIssues, trackPart, trackPath, turnoutClosure, turnoutPartForSize };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map