@willcgage/module-schematic 0.83.1 → 0.84.0

package/dist/index.d.cts

@@ -1528,9 +1528,11 @@ interface TrackPart {
      * (#193). */
     /** ⚠️ `crossover` is an ASSEMBLY, not a single turnout. A Fast Tracks
      * crossover fixture builds ONE SYMMETRICAL HALF; you build a second, rotate it
-     * 180° and butt the two together at the through routes and the diamond to get
-     * a complete DOUBLE (scissors) crossover — four turnouts, two diagonals and
-     * the X where they cross. So it carries {@link trackSpacing} and
+     * 180° and butt the two together at the through routes and the scissors to get
+     * a complete DOUBLE CROSSOVER — four turnouts, two diagonals, and the SCISSORS
+     * where they cross.  ⚠️ Will Gage, 2026-07-26: *"A double crossover contains
+     * the scissors."* The scissors is that X, not the whole assembly — do not use
+     * it as another name for the part. So it carries {@link trackSpacing} and
      * {@link secondaryFrogAngle}, which no single turnout has, and
      * {@link piecesPerAssembly} — because its lengths describe the HALF, not the
      * finished crossover. */
@@ -1620,8 +1622,9 @@ interface TrackPart {
      * than reconciled: it is a fact about the product, and an owner deciding what
      * to buy is better served by the true number than by a convenient one. */
     trackSpacing?: PartDimension;
-    /** The SECOND frog angle on a part that has two — the diamond where the
-     * diagonals of a scissors crossover cross. Published in degrees. */
+    /** The SECOND frog angle on a part that has two — the SCISSORS of a double
+     * crossover, the X where its two opposite diverging routes meet and cross.
+     * Published in degrees. */
     secondaryFrogAngle?: PartAngle;
     /** 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
@@ -1783,17 +1786,24 @@ declare const FAST_TRACKS_N_ME55: TrackPart[];
  * read as the assembly's.
  *
  * ⚠️ THE FINISHED LENGTH IS NOT PUBLISHED, and is deliberately not stored. The
- * two halves are related by a 180° rotation about the diamond, so they cover the
+ * two halves are related by a 180° rotation about the scissors, so they cover the
  * same longitudinal span and the finished crossover is plausibly also ~10.07″ —
  * but that is an inference from the symmetry, not a reading, and this library
  * has been burned four times by exactly that kind of plausible reconstruction.
  * If it matters, measure a built one.
  *
- * ⚠️ THESE MAKE A DOUBLE (SCISSORS) CROSSOVER — four turnouts, two diagonals,
- * and the X where the diagonals cross. A half carries one full 9.46° frog and
- * HALF of the 19° diamond, which is why the diamond only exists once the second
- * piece is butted up. Not a single crossover: half a diamond is not usable on
- * its own.
+ * ⚠️ THESE MAKE A DOUBLE CROSSOVER — four turnouts, two diagonals, and the
+ * SCISSORS where the two opposite diverging routes meet and cross in an X.
+ * A half carries one full 9.46° frog and HALF of the 19° scissors, which is why
+ * the scissors only exists once the second piece is butted up. Not a single
+ * crossover: half a scissors is not usable on its own.
+ *
+ * ⚠️ TERMINOLOGY, from Will Gage 2026-07-26: *"A double crossover contains the
+ * scissors. The location where both opposite diverging routes meet and cross
+ * like an 'X'."* The scissors is that crossing, NOT another name for the whole
+ * part — the assembly is a double crossover. Nor is it this library's
+ * `crossing`/diamond kind, which is two tracks crossing with no route choice
+ * (#170); the scissors is internal to the crossover.
  *
  * ⚠️⚠️ **THE TRACK SPACING IS 1.09″, AND FREE-moN §2.0 REQUIRES 1.125″.**
  * A crossover fixture is machined for ONE spacing; it is not adjustable. So a
@@ -2292,6 +2302,62 @@ declare function turnoutClosure(size: number, opts?: {
      * around 25″ on a #7 — clear of the Free-moN 22″ minimum. */
     easeInches?: number;
 }): TurnoutClosure;
+/** Which end of a part this is. A graph connects joints; a walk uses `routes`. */
+type PartJointRole = "throat" | "through" | "diverge" | "divergeB";
+/** One end of a part, in part-local inches: `x` along the through route from
+ * the tie end, `y` lateral toward the diverging side, `angleDeg` the OUTWARD
+ * tangent (0 = +x). Named, unlike {@link PartEnd}, because a graph has to know
+ * a throat from a frog. */
+interface PartJoint extends PartEnd {
+    id: string;
+    role: PartJointRole;
+}
+interface PartGeometry {
+    joints: PartJoint[];
+    /** Joint id pairs a train can run between. A turnout has two routes sharing
+     * its throat; flex has one; a double crossover has four. */
+    routes: [string, string][];
+    /** The weakest provenance among the dimensions used — so a caller can tell a
+     * placed-from-measurement part from a placed-from-a-catalogue-figure one. */
+    source: DimensionSource;
+    /** True when the diverging end came from a measured {@link
+     * TrackPart.divergingLength} rather than from assuming the diverging rail
+     * leaves the moulding at the same place the through route does. */
+    divergingEndMeasured: boolean;
+}
+/**
+ * Why a part has no derivable geometry — null when it has.
+ *
+ * Worth its own function because "we cannot place this yet" is a fact an owner
+ * should see in the picker, not a silent absence. It is also the parts-library
+ * backlog in machine-readable form: every string this returns is a measurement
+ * someone could take.
+ */
+declare function partGeometryGap(part: TrackPart): string | null;
+/**
+ * A part's joints and routes, in its own frame.
+ *
+ * The through route runs along +x from the tie end; the diverging side is +y.
+ * A placed piece is this, transformed — which is the whole point: the geometry
+ * belongs to the PART, and placement is a rotation and a translation.
+ *
+ * ⚠️ THE DIVERGING END IS MEASURED WHERE WE HAVE A MEASUREMENT. `divergingLength`
+ * (frog → end of the diverging rail, along the rail) says exactly where that end
+ * is. Without it we fall back to assuming the diverging rail leaves the moulding
+ * at the same x as the through route — which is what `partExtent` has always
+ * assumed, and is an assumption, not a reading. `divergingEndMeasured` says
+ * which you got.
+ */
+declare function partGeometry(part: TrackPart, library?: TrackPart[]): PartGeometry | null;
+/** Every part that can be PLACED on a board today, and every one that can only
+ * be named — with the reason. The gap list is the parts backlog. */
+declare function partsPlaceable(library?: TrackPart[]): {
+    placeable: TrackPart[];
+    blocked: {
+        part: TrackPart;
+        why: string;
+    }[];
+};
 /** A frog casting's parts, in TURNOUT-LOCAL inches: `x` = distance past the
  * points, `y` = lateral offset from the through route. */
 interface FrogCasting {
@@ -2498,4 +2564,4 @@ declare function poseOverridesFromDoc(doc: ModuleSchematicDoc): Record<string, {
     heading: number;
 }>;
 
-export { ATLAS_CODE55_N, BUILT_IN_TRACK_PARTS, type BenchworkPoint, type BranchConnector, CLEARANCE_SPACING_INCHES, CODE55_RAIL_HEIGHT_INCHES, DEFAULT_FLEX_PART_ID, 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, FAST_TRACKS_N_ME55, FAST_TRACKS_N_ME55_CROSSOVERS, FLEX_TRACK_PARTS, FREEMO_ENDPLATE_TRACK_FASCIA_CLEARANCE_INCHES, FREEMO_ENDPLATE_WIDTH_MIN_INCHES, FREEMO_ENDPLATE_WIDTH_RECOMMENDED_INCHES, FREEMO_TRACK_SPACING_INCHES, type FlexPiece, type FlexPieceEnd, type FrogCasting, type GeometryType, type ImportedPart, type IndustryLabelMode, type IndustrySpot, type LanePinch, 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 OccupiedSpan, type OutlineFace, PINCH_EASE_INCHES, 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 SectionEnd, type SectionEndAssessment, type SectionFootprint, type SectionJointAssessment, type SectionRelativePos, type SignalFacing, type SignalSide, type SpanOverhang, type StoredTrackPart, TIE_HALF_LENGTH_INCHES, TURNOUT_LEAD_INCHES_PER_FROG, type TrackConfig, type TrackPart, type TrackRole, type TurnoutClosure, type TurnoutKind, type UsableCapacity, WHOLE_MODULE_SECTION_ID, asModuleSchematic, assessSectionEnd, assessSectionJoint, benchworkBand, benchworkOutline, buildCrossover, buildPassingSiding, buildTransition, carCapacity, checkEndplateWidth, clearancePointPastFrogInches, crossoverPinches, deriveEndplatePoses, divergeSideForHand, docToState, emptyEditorState, endplateCentreOffsetInches, endplateFaceSegments, endplateLead, endplateTrackOffsetInches, endplateWidthInches, flexPartFor, flexParts, flexPieces, flexUsage, frogCasting, frogNumberFromName, fromSectionRelative, geometryTurnDegrees, hasNoFarEndplate, importedPartToTrackPart, inchesToScaleFeet, isLoopDoc, isTransitionTurnout, laneOffsetAt, leadInchesForSize, maxFlexPieceInches, mergeImportedParts, mergeStoredParts, moduleCenterline, moduleFeatures, moduleFootprint, moduleLengthFromSections, moduleSections, nextId, parseXtpLibrary, partExtent, partExtentForSize, partOutlineAtFrog, pastFrogInchesForSize, pathLengthInches, poseNeedsManual, poseOverridesFromDoc, remapPos, resizeFlexPiece, returnLoop, sampleBenchworkOutline, samplePartSegments, samplePath, scaleFeetToInches, sectionAdjacency, sectionBand, sectionBreaksFromSections, sectionComponents, sectionFootprints, sectionNeighbours, sectionSpans, sectionSpansOrWhole, sectionedCenterline, sectionedEndPose, sliceCenterline, spanOverhang, stateToDoc, storedPartToTrackPart, toSectionRelative, trackMeetsEndplateIssues, trackPart, trackPath, turnoutClosure, turnoutFacing, turnoutOccupiedSpan, turnoutPartForSize, usableCapacity };
+export { ATLAS_CODE55_N, BUILT_IN_TRACK_PARTS, type BenchworkPoint, type BranchConnector, CLEARANCE_SPACING_INCHES, CODE55_RAIL_HEIGHT_INCHES, DEFAULT_FLEX_PART_ID, 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, FAST_TRACKS_N_ME55, FAST_TRACKS_N_ME55_CROSSOVERS, FLEX_TRACK_PARTS, FREEMO_ENDPLATE_TRACK_FASCIA_CLEARANCE_INCHES, FREEMO_ENDPLATE_WIDTH_MIN_INCHES, FREEMO_ENDPLATE_WIDTH_RECOMMENDED_INCHES, FREEMO_TRACK_SPACING_INCHES, type FlexPiece, type FlexPieceEnd, type FrogCasting, type GeometryType, type ImportedPart, type IndustryLabelMode, type IndustrySpot, type LanePinch, 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 OccupiedSpan, type OutlineFace, PINCH_EASE_INCHES, type PartAngle, type PartDimension, type PartEnd, type PartExtent, type PartGeometry, type PartJoint, type PartJointRole, 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 SectionEnd, type SectionEndAssessment, type SectionFootprint, type SectionJointAssessment, type SectionRelativePos, type SignalFacing, type SignalSide, type SpanOverhang, type StoredTrackPart, TIE_HALF_LENGTH_INCHES, TURNOUT_LEAD_INCHES_PER_FROG, type TrackConfig, type TrackPart, type TrackRole, type TurnoutClosure, type TurnoutKind, type UsableCapacity, WHOLE_MODULE_SECTION_ID, asModuleSchematic, assessSectionEnd, assessSectionJoint, benchworkBand, benchworkOutline, buildCrossover, buildPassingSiding, buildTransition, carCapacity, checkEndplateWidth, clearancePointPastFrogInches, crossoverPinches, deriveEndplatePoses, divergeSideForHand, docToState, emptyEditorState, endplateCentreOffsetInches, endplateFaceSegments, endplateLead, endplateTrackOffsetInches, endplateWidthInches, flexPartFor, flexParts, flexPieces, flexUsage, frogCasting, frogNumberFromName, fromSectionRelative, geometryTurnDegrees, hasNoFarEndplate, importedPartToTrackPart, inchesToScaleFeet, isLoopDoc, isTransitionTurnout, laneOffsetAt, leadInchesForSize, maxFlexPieceInches, mergeImportedParts, mergeStoredParts, moduleCenterline, moduleFeatures, moduleFootprint, moduleLengthFromSections, moduleSections, nextId, parseXtpLibrary, partExtent, partExtentForSize, partGeometry, partGeometryGap, partOutlineAtFrog, partsPlaceable, pastFrogInchesForSize, pathLengthInches, poseNeedsManual, poseOverridesFromDoc, remapPos, resizeFlexPiece, returnLoop, sampleBenchworkOutline, samplePartSegments, samplePath, scaleFeetToInches, sectionAdjacency, sectionBand, sectionBreaksFromSections, sectionComponents, sectionFootprints, sectionNeighbours, sectionSpans, sectionSpansOrWhole, sectionedCenterline, sectionedEndPose, sliceCenterline, spanOverhang, stateToDoc, storedPartToTrackPart, toSectionRelative, trackMeetsEndplateIssues, trackPart, trackPath, turnoutClosure, turnoutFacing, turnoutOccupiedSpan, turnoutPartForSize, usableCapacity };

package/dist/index.d.ts

@@ -1528,9 +1528,11 @@ interface TrackPart {
      * (#193). */
     /** ⚠️ `crossover` is an ASSEMBLY, not a single turnout. A Fast Tracks
      * crossover fixture builds ONE SYMMETRICAL HALF; you build a second, rotate it
-     * 180° and butt the two together at the through routes and the diamond to get
-     * a complete DOUBLE (scissors) crossover — four turnouts, two diagonals and
-     * the X where they cross. So it carries {@link trackSpacing} and
+     * 180° and butt the two together at the through routes and the scissors to get
+     * a complete DOUBLE CROSSOVER — four turnouts, two diagonals, and the SCISSORS
+     * where they cross.  ⚠️ Will Gage, 2026-07-26: *"A double crossover contains
+     * the scissors."* The scissors is that X, not the whole assembly — do not use
+     * it as another name for the part. So it carries {@link trackSpacing} and
      * {@link secondaryFrogAngle}, which no single turnout has, and
      * {@link piecesPerAssembly} — because its lengths describe the HALF, not the
      * finished crossover. */
@@ -1620,8 +1622,9 @@ interface TrackPart {
      * than reconciled: it is a fact about the product, and an owner deciding what
      * to buy is better served by the true number than by a convenient one. */
     trackSpacing?: PartDimension;
-    /** The SECOND frog angle on a part that has two — the diamond where the
-     * diagonals of a scissors crossover cross. Published in degrees. */
+    /** The SECOND frog angle on a part that has two — the SCISSORS of a double
+     * crossover, the X where its two opposite diverging routes meet and cross.
+     * Published in degrees. */
     secondaryFrogAngle?: PartAngle;
     /** 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
@@ -1783,17 +1786,24 @@ declare const FAST_TRACKS_N_ME55: TrackPart[];
  * read as the assembly's.
  *
  * ⚠️ THE FINISHED LENGTH IS NOT PUBLISHED, and is deliberately not stored. The
- * two halves are related by a 180° rotation about the diamond, so they cover the
+ * two halves are related by a 180° rotation about the scissors, so they cover the
  * same longitudinal span and the finished crossover is plausibly also ~10.07″ —
  * but that is an inference from the symmetry, not a reading, and this library
  * has been burned four times by exactly that kind of plausible reconstruction.
  * If it matters, measure a built one.
  *
- * ⚠️ THESE MAKE A DOUBLE (SCISSORS) CROSSOVER — four turnouts, two diagonals,
- * and the X where the diagonals cross. A half carries one full 9.46° frog and
- * HALF of the 19° diamond, which is why the diamond only exists once the second
- * piece is butted up. Not a single crossover: half a diamond is not usable on
- * its own.
+ * ⚠️ THESE MAKE A DOUBLE CROSSOVER — four turnouts, two diagonals, and the
+ * SCISSORS where the two opposite diverging routes meet and cross in an X.
+ * A half carries one full 9.46° frog and HALF of the 19° scissors, which is why
+ * the scissors only exists once the second piece is butted up. Not a single
+ * crossover: half a scissors is not usable on its own.
+ *
+ * ⚠️ TERMINOLOGY, from Will Gage 2026-07-26: *"A double crossover contains the
+ * scissors. The location where both opposite diverging routes meet and cross
+ * like an 'X'."* The scissors is that crossing, NOT another name for the whole
+ * part — the assembly is a double crossover. Nor is it this library's
+ * `crossing`/diamond kind, which is two tracks crossing with no route choice
+ * (#170); the scissors is internal to the crossover.
  *
  * ⚠️⚠️ **THE TRACK SPACING IS 1.09″, AND FREE-moN §2.0 REQUIRES 1.125″.**
  * A crossover fixture is machined for ONE spacing; it is not adjustable. So a
@@ -2292,6 +2302,62 @@ declare function turnoutClosure(size: number, opts?: {
      * around 25″ on a #7 — clear of the Free-moN 22″ minimum. */
     easeInches?: number;
 }): TurnoutClosure;
+/** Which end of a part this is. A graph connects joints; a walk uses `routes`. */
+type PartJointRole = "throat" | "through" | "diverge" | "divergeB";
+/** One end of a part, in part-local inches: `x` along the through route from
+ * the tie end, `y` lateral toward the diverging side, `angleDeg` the OUTWARD
+ * tangent (0 = +x). Named, unlike {@link PartEnd}, because a graph has to know
+ * a throat from a frog. */
+interface PartJoint extends PartEnd {
+    id: string;
+    role: PartJointRole;
+}
+interface PartGeometry {
+    joints: PartJoint[];
+    /** Joint id pairs a train can run between. A turnout has two routes sharing
+     * its throat; flex has one; a double crossover has four. */
+    routes: [string, string][];
+    /** The weakest provenance among the dimensions used — so a caller can tell a
+     * placed-from-measurement part from a placed-from-a-catalogue-figure one. */
+    source: DimensionSource;
+    /** True when the diverging end came from a measured {@link
+     * TrackPart.divergingLength} rather than from assuming the diverging rail
+     * leaves the moulding at the same place the through route does. */
+    divergingEndMeasured: boolean;
+}
+/**
+ * Why a part has no derivable geometry — null when it has.
+ *
+ * Worth its own function because "we cannot place this yet" is a fact an owner
+ * should see in the picker, not a silent absence. It is also the parts-library
+ * backlog in machine-readable form: every string this returns is a measurement
+ * someone could take.
+ */
+declare function partGeometryGap(part: TrackPart): string | null;
+/**
+ * A part's joints and routes, in its own frame.
+ *
+ * The through route runs along +x from the tie end; the diverging side is +y.
+ * A placed piece is this, transformed — which is the whole point: the geometry
+ * belongs to the PART, and placement is a rotation and a translation.
+ *
+ * ⚠️ THE DIVERGING END IS MEASURED WHERE WE HAVE A MEASUREMENT. `divergingLength`
+ * (frog → end of the diverging rail, along the rail) says exactly where that end
+ * is. Without it we fall back to assuming the diverging rail leaves the moulding
+ * at the same x as the through route — which is what `partExtent` has always
+ * assumed, and is an assumption, not a reading. `divergingEndMeasured` says
+ * which you got.
+ */
+declare function partGeometry(part: TrackPart, library?: TrackPart[]): PartGeometry | null;
+/** Every part that can be PLACED on a board today, and every one that can only
+ * be named — with the reason. The gap list is the parts backlog. */
+declare function partsPlaceable(library?: TrackPart[]): {
+    placeable: TrackPart[];
+    blocked: {
+        part: TrackPart;
+        why: string;
+    }[];
+};
 /** A frog casting's parts, in TURNOUT-LOCAL inches: `x` = distance past the
  * points, `y` = lateral offset from the through route. */
 interface FrogCasting {
@@ -2498,4 +2564,4 @@ declare function poseOverridesFromDoc(doc: ModuleSchematicDoc): Record<string, {
     heading: number;
 }>;
 
-export { ATLAS_CODE55_N, BUILT_IN_TRACK_PARTS, type BenchworkPoint, type BranchConnector, CLEARANCE_SPACING_INCHES, CODE55_RAIL_HEIGHT_INCHES, DEFAULT_FLEX_PART_ID, 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, FAST_TRACKS_N_ME55, FAST_TRACKS_N_ME55_CROSSOVERS, FLEX_TRACK_PARTS, FREEMO_ENDPLATE_TRACK_FASCIA_CLEARANCE_INCHES, FREEMO_ENDPLATE_WIDTH_MIN_INCHES, FREEMO_ENDPLATE_WIDTH_RECOMMENDED_INCHES, FREEMO_TRACK_SPACING_INCHES, type FlexPiece, type FlexPieceEnd, type FrogCasting, type GeometryType, type ImportedPart, type IndustryLabelMode, type IndustrySpot, type LanePinch, 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 OccupiedSpan, type OutlineFace, PINCH_EASE_INCHES, 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 SectionEnd, type SectionEndAssessment, type SectionFootprint, type SectionJointAssessment, type SectionRelativePos, type SignalFacing, type SignalSide, type SpanOverhang, type StoredTrackPart, TIE_HALF_LENGTH_INCHES, TURNOUT_LEAD_INCHES_PER_FROG, type TrackConfig, type TrackPart, type TrackRole, type TurnoutClosure, type TurnoutKind, type UsableCapacity, WHOLE_MODULE_SECTION_ID, asModuleSchematic, assessSectionEnd, assessSectionJoint, benchworkBand, benchworkOutline, buildCrossover, buildPassingSiding, buildTransition, carCapacity, checkEndplateWidth, clearancePointPastFrogInches, crossoverPinches, deriveEndplatePoses, divergeSideForHand, docToState, emptyEditorState, endplateCentreOffsetInches, endplateFaceSegments, endplateLead, endplateTrackOffsetInches, endplateWidthInches, flexPartFor, flexParts, flexPieces, flexUsage, frogCasting, frogNumberFromName, fromSectionRelative, geometryTurnDegrees, hasNoFarEndplate, importedPartToTrackPart, inchesToScaleFeet, isLoopDoc, isTransitionTurnout, laneOffsetAt, leadInchesForSize, maxFlexPieceInches, mergeImportedParts, mergeStoredParts, moduleCenterline, moduleFeatures, moduleFootprint, moduleLengthFromSections, moduleSections, nextId, parseXtpLibrary, partExtent, partExtentForSize, partOutlineAtFrog, pastFrogInchesForSize, pathLengthInches, poseNeedsManual, poseOverridesFromDoc, remapPos, resizeFlexPiece, returnLoop, sampleBenchworkOutline, samplePartSegments, samplePath, scaleFeetToInches, sectionAdjacency, sectionBand, sectionBreaksFromSections, sectionComponents, sectionFootprints, sectionNeighbours, sectionSpans, sectionSpansOrWhole, sectionedCenterline, sectionedEndPose, sliceCenterline, spanOverhang, stateToDoc, storedPartToTrackPart, toSectionRelative, trackMeetsEndplateIssues, trackPart, trackPath, turnoutClosure, turnoutFacing, turnoutOccupiedSpan, turnoutPartForSize, usableCapacity };
+export { ATLAS_CODE55_N, BUILT_IN_TRACK_PARTS, type BenchworkPoint, type BranchConnector, CLEARANCE_SPACING_INCHES, CODE55_RAIL_HEIGHT_INCHES, DEFAULT_FLEX_PART_ID, 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, FAST_TRACKS_N_ME55, FAST_TRACKS_N_ME55_CROSSOVERS, FLEX_TRACK_PARTS, FREEMO_ENDPLATE_TRACK_FASCIA_CLEARANCE_INCHES, FREEMO_ENDPLATE_WIDTH_MIN_INCHES, FREEMO_ENDPLATE_WIDTH_RECOMMENDED_INCHES, FREEMO_TRACK_SPACING_INCHES, type FlexPiece, type FlexPieceEnd, type FrogCasting, type GeometryType, type ImportedPart, type IndustryLabelMode, type IndustrySpot, type LanePinch, 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 OccupiedSpan, type OutlineFace, PINCH_EASE_INCHES, type PartAngle, type PartDimension, type PartEnd, type PartExtent, type PartGeometry, type PartJoint, type PartJointRole, 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 SectionEnd, type SectionEndAssessment, type SectionFootprint, type SectionJointAssessment, type SectionRelativePos, type SignalFacing, type SignalSide, type SpanOverhang, type StoredTrackPart, TIE_HALF_LENGTH_INCHES, TURNOUT_LEAD_INCHES_PER_FROG, type TrackConfig, type TrackPart, type TrackRole, type TurnoutClosure, type TurnoutKind, type UsableCapacity, WHOLE_MODULE_SECTION_ID, asModuleSchematic, assessSectionEnd, assessSectionJoint, benchworkBand, benchworkOutline, buildCrossover, buildPassingSiding, buildTransition, carCapacity, checkEndplateWidth, clearancePointPastFrogInches, crossoverPinches, deriveEndplatePoses, divergeSideForHand, docToState, emptyEditorState, endplateCentreOffsetInches, endplateFaceSegments, endplateLead, endplateTrackOffsetInches, endplateWidthInches, flexPartFor, flexParts, flexPieces, flexUsage, frogCasting, frogNumberFromName, fromSectionRelative, geometryTurnDegrees, hasNoFarEndplate, importedPartToTrackPart, inchesToScaleFeet, isLoopDoc, isTransitionTurnout, laneOffsetAt, leadInchesForSize, maxFlexPieceInches, mergeImportedParts, mergeStoredParts, moduleCenterline, moduleFeatures, moduleFootprint, moduleLengthFromSections, moduleSections, nextId, parseXtpLibrary, partExtent, partExtentForSize, partGeometry, partGeometryGap, partOutlineAtFrog, partsPlaceable, pastFrogInchesForSize, pathLengthInches, poseNeedsManual, poseOverridesFromDoc, remapPos, resizeFlexPiece, returnLoop, sampleBenchworkOutline, samplePartSegments, samplePath, scaleFeetToInches, sectionAdjacency, sectionBand, sectionBreaksFromSections, sectionComponents, sectionFootprints, sectionNeighbours, sectionSpans, sectionSpansOrWhole, sectionedCenterline, sectionedEndPose, sliceCenterline, spanOverhang, stateToDoc, storedPartToTrackPart, toSectionRelative, trackMeetsEndplateIssues, trackPart, trackPath, turnoutClosure, turnoutFacing, turnoutOccupiedSpan, turnoutPartForSize, usableCapacity };

package/dist/index.js

@@ -1649,7 +1649,7 @@ var FAST_TRACKS_N_ME55_CROSSOVERS = [
     secondaryFrogAngle: {
       deg: second,
       source: manufacturer,
-      note: `${spec}. The diamond of a scissors crossover \u2014 2 \xD7 ${deg}\xB0 within the published rounding.`
+      note: `${spec}. The SCISSORS of a double crossover \u2014 the X where its two opposite diverging routes cross \u2014 at 2 \xD7 ${deg}\xB0 within the published rounding.`
     },
     overallLength: {
       inches: dflt,
@@ -2126,6 +2126,107 @@ function turnoutClosure(size, opts = {}) {
     }
   };
 }
+function partGeometryGap(part) {
+  if (part.kind === "flex") return null;
+  if (part.kind === "crossover")
+    return "a crossover fixture builds one HALF of the assembly (piecesPerAssembly), so its published lengths describe a piece, not the finished part \u2014 the geometry of the whole crossover is not yet derivable from them";
+  if (part.kind === "crossing") return "crossing geometry is not modelled yet";
+  if (part.kind === "curved-turnout")
+    return "a curved turnout needs both radii AND its points/frog landmarks; only the radii are published";
+  if (!part.pointsOffset)
+    return "no points offset \u2014 without it there is nowhere for the diverging route to begin";
+  if (!part.overallLength) return "no overall length \u2014 the part has no end to put a joint on";
+  if (part.frogNumber == null) return "no frog number \u2014 the diverging angle is unknown";
+  return null;
+}
+function partGeometry(part, library = BUILT_IN_TRACK_PARTS) {
+  if (partGeometryGap(part)) return null;
+  if (part.kind === "flex") {
+    return {
+      joints: [
+        { id: "a", role: "throat", x: 0, y: 0, angleDeg: 180 },
+        { id: "b", role: "through", x: 0, y: 0, angleDeg: 0 }
+      ],
+      routes: [["a", "b"]],
+      source: "derived",
+      divergingEndMeasured: false
+    };
+  }
+  const N = part.frogNumber;
+  const points = part.pointsOffset;
+  const overall = part.overallLength;
+  const frog = part.frogOffset;
+  const lead = part.lead?.inches ?? (frog ? frog.inches - points.inches : void 0);
+  if (lead == null || !(lead > 0)) return null;
+  const isWye = part.kind === "wye";
+  const effN = isWye ? N * 2 : N;
+  const closure = turnoutClosure(effN, { leadInches: lead });
+  const divergingEnd = () => {
+    const frogX = frog ? frog.inches : points.inches + lead;
+    const slope = closure.frogSlope;
+    const dir = 1 / Math.hypot(1, slope);
+    if (part.divergingLength) {
+      const L = part.divergingLength.inches;
+      return {
+        x: frogX + L * dir,
+        y: closure.offsetAt(frogX - points.inches) + L * slope * dir,
+        measured: true
+      };
+    }
+    return {
+      x: overall.inches,
+      y: closure.offsetAt(overall.inches - points.inches),
+      measured: false
+    };
+  };
+  const weakest = (...ds) => {
+    const rank = ["measured", "manufacturer", "derived", "unverified"];
+    let worst = 0;
+    for (const d of ds) if (d) worst = Math.max(worst, rank.indexOf(d.source));
+    return rank[worst];
+  };
+  const de = divergingEnd();
+  const legAngle = Math.atan(closure.frogSlope) * 180 / Math.PI;
+  if (isWye) {
+    return {
+      joints: [
+        { id: "throat", role: "throat", x: 0, y: 0, angleDeg: 180 },
+        { id: "legA", role: "diverge", x: de.x, y: de.y, angleDeg: legAngle },
+        { id: "legB", role: "divergeB", x: de.x, y: -de.y, angleDeg: -legAngle }
+      ],
+      routes: [
+        ["throat", "legA"],
+        ["throat", "legB"]
+      ],
+      source: weakest(points, overall, frog, part.divergingLength),
+      divergingEndMeasured: de.measured
+    };
+  }
+  return {
+    joints: [
+      { id: "throat", role: "throat", x: 0, y: 0, angleDeg: 180 },
+      { id: "through", role: "through", x: overall.inches, y: 0, angleDeg: 0 },
+      { id: "diverge", role: "diverge", x: de.x, y: de.y, angleDeg: legAngle }
+    ],
+    routes: [
+      ["throat", "through"],
+      ["throat", "diverge"]
+    ],
+    source: weakest(points, overall, frog, part.divergingLength),
+    divergingEndMeasured: de.measured
+  };
+}
+function partsPlaceable(library = BUILT_IN_TRACK_PARTS) {
+  const placeable = [];
+  const blocked = [];
+  for (const p of library) {
+    const why = partGeometryGap(p);
+    if (why) blocked.push({ part: p, why });
+    else if (partGeometry(p, library)) placeable.push(p);
+    else blocked.push({ part: p, why: "dimensions present but inconsistent" });
+  }
+  return { placeable, blocked };
+}
 function frogCasting(cl, opts = {}) {
   const g = opts.gaugeInches ?? RAIL_GAUGE_INCHES;
   const w = opts.reachInches ?? g * 1.5;
@@ -2705,6 +2806,6 @@ function poseOverridesFromDoc(doc) {
   return out;
 }
 
-export { ATLAS_CODE55_N, BUILT_IN_TRACK_PARTS, CLEARANCE_SPACING_INCHES, CODE55_RAIL_HEIGHT_INCHES, DEFAULT_FLEX_PART_ID, ENDPLATE_FASCIA_CLEAR_INCHES, ENDPLATE_LEAD_INCHES, FAST_TRACKS_N_ME55, FAST_TRACKS_N_ME55_CROSSOVERS, FLEX_TRACK_PARTS, 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, PINCH_EASE_INCHES, RAIL_GAUGE_INCHES, TIE_HALF_LENGTH_INCHES, TURNOUT_LEAD_INCHES_PER_FROG, WHOLE_MODULE_SECTION_ID, asModuleSchematic, assessSectionEnd, assessSectionJoint, benchworkBand, benchworkOutline, buildCrossover, buildPassingSiding, buildTransition, carCapacity, checkEndplateWidth, clearancePointPastFrogInches, crossoverPinches, deriveEndplatePoses, divergeSideForHand, docToState, emptyEditorState, endplateCentreOffsetInches, endplateFaceSegments, endplateLead, endplateTrackOffsetInches, endplateWidthInches, flexPartFor, flexParts, flexPieces, flexUsage, frogCasting, frogNumberFromName, fromSectionRelative, geometryTurnDegrees, hasNoFarEndplate, importedPartToTrackPart, inchesToScaleFeet, isLoopDoc, isTransitionTurnout, laneOffsetAt, leadInchesForSize, maxFlexPieceInches, mergeImportedParts, mergeStoredParts, moduleCenterline, moduleFeatures, moduleFootprint, moduleLengthFromSections, moduleSections, nextId, parseXtpLibrary, partExtent, partExtentForSize, partOutlineAtFrog, pastFrogInchesForSize, pathLengthInches, poseNeedsManual, poseOverridesFromDoc, remapPos, resizeFlexPiece, returnLoop, sampleBenchworkOutline, samplePartSegments, samplePath, scaleFeetToInches, sectionAdjacency, sectionBand, sectionBreaksFromSections, sectionComponents, sectionFootprints, sectionNeighbours, sectionSpans, sectionSpansOrWhole, sectionedCenterline, sectionedEndPose, sliceCenterline, spanOverhang, stateToDoc, storedPartToTrackPart, toSectionRelative, trackMeetsEndplateIssues, trackPart, trackPath, turnoutClosure, turnoutFacing, turnoutOccupiedSpan, turnoutPartForSize, usableCapacity };
+export { ATLAS_CODE55_N, BUILT_IN_TRACK_PARTS, CLEARANCE_SPACING_INCHES, CODE55_RAIL_HEIGHT_INCHES, DEFAULT_FLEX_PART_ID, ENDPLATE_FASCIA_CLEAR_INCHES, ENDPLATE_LEAD_INCHES, FAST_TRACKS_N_ME55, FAST_TRACKS_N_ME55_CROSSOVERS, FLEX_TRACK_PARTS, 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, PINCH_EASE_INCHES, RAIL_GAUGE_INCHES, TIE_HALF_LENGTH_INCHES, TURNOUT_LEAD_INCHES_PER_FROG, WHOLE_MODULE_SECTION_ID, asModuleSchematic, assessSectionEnd, assessSectionJoint, benchworkBand, benchworkOutline, buildCrossover, buildPassingSiding, buildTransition, carCapacity, checkEndplateWidth, clearancePointPastFrogInches, crossoverPinches, deriveEndplatePoses, divergeSideForHand, docToState, emptyEditorState, endplateCentreOffsetInches, endplateFaceSegments, endplateLead, endplateTrackOffsetInches, endplateWidthInches, flexPartFor, flexParts, flexPieces, flexUsage, frogCasting, frogNumberFromName, fromSectionRelative, geometryTurnDegrees, hasNoFarEndplate, importedPartToTrackPart, inchesToScaleFeet, isLoopDoc, isTransitionTurnout, laneOffsetAt, leadInchesForSize, maxFlexPieceInches, mergeImportedParts, mergeStoredParts, moduleCenterline, moduleFeatures, moduleFootprint, moduleLengthFromSections, moduleSections, nextId, parseXtpLibrary, partExtent, partExtentForSize, partGeometry, partGeometryGap, partOutlineAtFrog, partsPlaceable, pastFrogInchesForSize, pathLengthInches, poseNeedsManual, poseOverridesFromDoc, remapPos, resizeFlexPiece, returnLoop, sampleBenchworkOutline, samplePartSegments, samplePath, scaleFeetToInches, sectionAdjacency, sectionBand, sectionBreaksFromSections, sectionComponents, sectionFootprints, sectionNeighbours, sectionSpans, sectionSpansOrWhole, sectionedCenterline, sectionedEndPose, sliceCenterline, spanOverhang, stateToDoc, storedPartToTrackPart, toSectionRelative, trackMeetsEndplateIssues, trackPart, trackPath, turnoutClosure, turnoutFacing, turnoutOccupiedSpan, turnoutPartForSize, usableCapacity };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map