@willcgage/module-schematic 0.111.0 → 0.113.0

package/dist/index.d.cts

@@ -93,9 +93,24 @@ declare const FREEMO_ENDPLATE_WIDTH_MIN_INCHES = 12;
  * ("Endplates shall be 6 inches high and a minimum 12 inches wide"). 24″ is
  * simply a common real-world width. Don't present it as required. */
 declare const FREEMO_ENDPLATE_WIDTH_RECOMMENDED_INCHES = 24;
-/** Free-moN §2.0 **standard**: "Double track endplates must have a track spacing
+/**
+ * Free-moN §2.0 **standard**: "Double track endplates must have a track spacing
  * of 1.125 inches (1 1/8 inches). Track spacing shall be measured along the
- * track center line." The one definition both apps read. */
+ * track center line." The one definition both apps read.
+ *
+ * ⚠️⚠️ **READ THE SCOPE, NOT JUST THE NUMBER.** This governs a **double-track
+ * ENDPLATE**, and reaches **4″ inboard** of it — §2.0's other standard is that
+ * track crossing an endplate be "perpendicular, straight, and level for at least
+ * 4 inches from the outside face". **Beyond those 4 inches the standard says
+ * nothing about how far apart the mains run**, and every real crossover draws
+ * them closer than this (the Fast Tracks N fixtures are 1.09″).
+ *
+ * ⛔ So this is a value to BUILD TO at an endplate, and **never a test to
+ * measure mid-module track against**. Used as one it amber-flagged ordinary,
+ * correctly built trackwork as departing from the standard (Will, 2026-07-28).
+ * It is also the default LANE PITCH for drawing parallel track, which is a
+ * separate job — a drawing convention, not a rule anything conforms to.
+ */
 declare const FREEMO_TRACK_SPACING_INCHES = 1.125;
 /** Free-moN §2.0 **standard**: track crossing an endplate must be "not less than
  * 4 inches from either fascia" (and perpendicular, straight and level for 4″). */
@@ -155,12 +170,17 @@ declare const PINCH_EASE_INCHES = 3;
  */
 declare function laneOffsetAt(lane: number, pos: number, pinches?: LanePinch[] | null, spacingInches?: number): number;
 /**
- * The pinches a document's crossovers impose — one per crossover connector that
- * names a part whose {@link TrackPart.trackSpacing} differs from the standard.
+ * The pinches a document's crossovers impose — one per crossover connector whose
+ * part is built to a different spacing from the mains either side of it.
+ *
+ * ⚠️ A PINCH IS GEOMETRY, NOT A FAULT. §2.0 fixes the 1.125″ spacing AT THE
+ * ENDPLATE; what the mains do in between is the builder's business, and every
+ * real crossover draws them closer. This says where the drawing must narrow, and
+ * nothing about conformance.
  *
- * A crossover with no part named, or one built to the standard spacing, imposes
- * nothing: an owner who hasn't said what they built gets the straight pair they
- * had before, which is the only honest default.
+ * A crossover with no part named, or one built to the same spacing as the mains,
+ * imposes nothing: an owner who hasn't said what they built gets the straight
+ * pair they had before, which is the only honest default.
  */
 declare function crossoverPinches(tracks: Array<{
     role?: string;
@@ -1773,14 +1793,19 @@ interface TrackPart {
     crossingAngleDeg?: number;
     /** Centre-to-centre distance of the two parallel tracks a {@link kind}
      * `crossover` joins. A crossover fixture is BUILT for one spacing — it is not
-     * adjustable — so this decides whether the part suits a given standard at all.
+     * adjustable — so this is what the mains must pinch to where it sits.
      *
-     * ⚠️ READ {@link FREEMO_TRACK_SPACING_INCHES} ALONGSIDE THIS. Free-moN §2.0
-     * fixes double-track spacing at exactly 1.125″; the Fast Tracks N crossovers
-     * are built to 1.09″. That 0.035″ is small but it is REAL and it is not a
-     * tolerance — the fixture cannot be built to another spacing. Recorded rather
-     * 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. */
+     * ⚠️ **NOT A CONFORMANCE TEST.** {@link FREEMO_TRACK_SPACING_INCHES} is fixed
+     * by §2.0 **at the endplate** — "double track endplates must have a track
+     * spacing of 1.125 inches", perpendicular, straight and level for 4″ from the
+     * outside face. What the two mains do in between is the module builder's
+     * business, and EVERY real crossover pinches them closer: the Fast Tracks N
+     * fixtures are 1.09″. Earlier wording here said this "decides whether the part
+     * suits a given standard at all", which is wrong and put an amber
+     * non-conformance note on ordinary, correctly built trackwork.
+     *
+     * Recorded because it is a fact about the product an owner needs when buying,
+     * and because the drawing has to pinch the mains to it. */
     trackSpacing?: PartDimension;
     /** 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.
@@ -2576,13 +2601,23 @@ interface PartGeometry {
  * builder's business, and every real double crossover pinches them closer.
  *
  * The derivation:
- * - **Length** is `overallLength × piecesPerAssembly`. Fast Tracks' figure is
- *   ONE HALF — the fixture builds a symmetrical half you make twice and butt
- *   together after turning the second 180°.
+ * - **Length IS `overallLength`.** ⚠️ `piecesPerAssembly` counts BUILDS, not
+ *   length: you make the fixture's half twice and turn the second 180°, and the
+ *   two diagonals then SUPERIMPOSE into the scissors — they occupy the same
+ *   stretch of track, they do not sit end to end. Multiplying by it gave a #6 a
+ *   20.14″ body with **6.8″ of plain approach track moulded on each end**.
+ *   `minimumLength` settles it independently: the shortest #6 build is 9.31″,
+ *   which reads as "trim the approach to 1.38″" — and only reads that way if the
+ *   assembly is L. Under 2L a "minimum" would still carry a 6″ approach.
  * - **The crossing run** `W = spacing / tan θ` is how far along the track a route
  *   takes to cross to the other one. The two point-sets on the SAME track are
  *   therefore `W` apart — 6.54″ for a #6 at 1.09″, not the 2.5″ my own FMN-0078
  *   fixture claimed.
+ * - **The approach**, `(length − W) / 2`, is what is left over at each end: the
+ *   straight tie strip from the start of the moulding to the start of the points.
+ *   ⭐ Will named this as the measurement that has to be right (2026-07-28), and
+ *   it is where the through routes take their rail joints. 1.76″ on a #6, 2.45″
+ *   on a #8 — it grows with the frog, as it must.
  * - Both crossing routes are centred on the assembly, so they meet in the middle
  *   at `2θ` — which is exactly the {@link TrackPart.secondaryFrogAngle} Fast
  *   Tracks publish, an independent check that this reading is right.
@@ -2593,6 +2628,14 @@ declare function crossoverAssembly(part: TrackPart): {
     spacingInches: number;
     /** Along-track distance a crossing route takes to reach the other track. */
     crossingRunInches: number;
+    /**
+     * Start of the moulding → start of the points, at each end.
+     *
+     * ⭐ The measurement that has to be right for the drawing to read as track:
+     * it is the plain tie strip a crossover begins and ends with, and therefore
+     * where the through routes are jointed.
+     */
+    approachInches: number;
     /** Where the four point-sets sit along the assembly. */
     pointsAtInches: [number, number];
     /** The X where the two crossing routes meet — a real diamond in the middle. */

package/dist/index.d.ts

@@ -93,9 +93,24 @@ declare const FREEMO_ENDPLATE_WIDTH_MIN_INCHES = 12;
  * ("Endplates shall be 6 inches high and a minimum 12 inches wide"). 24″ is
  * simply a common real-world width. Don't present it as required. */
 declare const FREEMO_ENDPLATE_WIDTH_RECOMMENDED_INCHES = 24;
-/** Free-moN §2.0 **standard**: "Double track endplates must have a track spacing
+/**
+ * Free-moN §2.0 **standard**: "Double track endplates must have a track spacing
  * of 1.125 inches (1 1/8 inches). Track spacing shall be measured along the
- * track center line." The one definition both apps read. */
+ * track center line." The one definition both apps read.
+ *
+ * ⚠️⚠️ **READ THE SCOPE, NOT JUST THE NUMBER.** This governs a **double-track
+ * ENDPLATE**, and reaches **4″ inboard** of it — §2.0's other standard is that
+ * track crossing an endplate be "perpendicular, straight, and level for at least
+ * 4 inches from the outside face". **Beyond those 4 inches the standard says
+ * nothing about how far apart the mains run**, and every real crossover draws
+ * them closer than this (the Fast Tracks N fixtures are 1.09″).
+ *
+ * ⛔ So this is a value to BUILD TO at an endplate, and **never a test to
+ * measure mid-module track against**. Used as one it amber-flagged ordinary,
+ * correctly built trackwork as departing from the standard (Will, 2026-07-28).
+ * It is also the default LANE PITCH for drawing parallel track, which is a
+ * separate job — a drawing convention, not a rule anything conforms to.
+ */
 declare const FREEMO_TRACK_SPACING_INCHES = 1.125;
 /** Free-moN §2.0 **standard**: track crossing an endplate must be "not less than
  * 4 inches from either fascia" (and perpendicular, straight and level for 4″). */
@@ -155,12 +170,17 @@ declare const PINCH_EASE_INCHES = 3;
  */
 declare function laneOffsetAt(lane: number, pos: number, pinches?: LanePinch[] | null, spacingInches?: number): number;
 /**
- * The pinches a document's crossovers impose — one per crossover connector that
- * names a part whose {@link TrackPart.trackSpacing} differs from the standard.
+ * The pinches a document's crossovers impose — one per crossover connector whose
+ * part is built to a different spacing from the mains either side of it.
+ *
+ * ⚠️ A PINCH IS GEOMETRY, NOT A FAULT. §2.0 fixes the 1.125″ spacing AT THE
+ * ENDPLATE; what the mains do in between is the builder's business, and every
+ * real crossover draws them closer. This says where the drawing must narrow, and
+ * nothing about conformance.
  *
- * A crossover with no part named, or one built to the standard spacing, imposes
- * nothing: an owner who hasn't said what they built gets the straight pair they
- * had before, which is the only honest default.
+ * A crossover with no part named, or one built to the same spacing as the mains,
+ * imposes nothing: an owner who hasn't said what they built gets the straight
+ * pair they had before, which is the only honest default.
  */
 declare function crossoverPinches(tracks: Array<{
     role?: string;
@@ -1773,14 +1793,19 @@ interface TrackPart {
     crossingAngleDeg?: number;
     /** Centre-to-centre distance of the two parallel tracks a {@link kind}
      * `crossover` joins. A crossover fixture is BUILT for one spacing — it is not
-     * adjustable — so this decides whether the part suits a given standard at all.
+     * adjustable — so this is what the mains must pinch to where it sits.
      *
-     * ⚠️ READ {@link FREEMO_TRACK_SPACING_INCHES} ALONGSIDE THIS. Free-moN §2.0
-     * fixes double-track spacing at exactly 1.125″; the Fast Tracks N crossovers
-     * are built to 1.09″. That 0.035″ is small but it is REAL and it is not a
-     * tolerance — the fixture cannot be built to another spacing. Recorded rather
-     * 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. */
+     * ⚠️ **NOT A CONFORMANCE TEST.** {@link FREEMO_TRACK_SPACING_INCHES} is fixed
+     * by §2.0 **at the endplate** — "double track endplates must have a track
+     * spacing of 1.125 inches", perpendicular, straight and level for 4″ from the
+     * outside face. What the two mains do in between is the module builder's
+     * business, and EVERY real crossover pinches them closer: the Fast Tracks N
+     * fixtures are 1.09″. Earlier wording here said this "decides whether the part
+     * suits a given standard at all", which is wrong and put an amber
+     * non-conformance note on ordinary, correctly built trackwork.
+     *
+     * Recorded because it is a fact about the product an owner needs when buying,
+     * and because the drawing has to pinch the mains to it. */
     trackSpacing?: PartDimension;
     /** 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.
@@ -2576,13 +2601,23 @@ interface PartGeometry {
  * builder's business, and every real double crossover pinches them closer.
  *
  * The derivation:
- * - **Length** is `overallLength × piecesPerAssembly`. Fast Tracks' figure is
- *   ONE HALF — the fixture builds a symmetrical half you make twice and butt
- *   together after turning the second 180°.
+ * - **Length IS `overallLength`.** ⚠️ `piecesPerAssembly` counts BUILDS, not
+ *   length: you make the fixture's half twice and turn the second 180°, and the
+ *   two diagonals then SUPERIMPOSE into the scissors — they occupy the same
+ *   stretch of track, they do not sit end to end. Multiplying by it gave a #6 a
+ *   20.14″ body with **6.8″ of plain approach track moulded on each end**.
+ *   `minimumLength` settles it independently: the shortest #6 build is 9.31″,
+ *   which reads as "trim the approach to 1.38″" — and only reads that way if the
+ *   assembly is L. Under 2L a "minimum" would still carry a 6″ approach.
  * - **The crossing run** `W = spacing / tan θ` is how far along the track a route
  *   takes to cross to the other one. The two point-sets on the SAME track are
  *   therefore `W` apart — 6.54″ for a #6 at 1.09″, not the 2.5″ my own FMN-0078
  *   fixture claimed.
+ * - **The approach**, `(length − W) / 2`, is what is left over at each end: the
+ *   straight tie strip from the start of the moulding to the start of the points.
+ *   ⭐ Will named this as the measurement that has to be right (2026-07-28), and
+ *   it is where the through routes take their rail joints. 1.76″ on a #6, 2.45″
+ *   on a #8 — it grows with the frog, as it must.
  * - Both crossing routes are centred on the assembly, so they meet in the middle
  *   at `2θ` — which is exactly the {@link TrackPart.secondaryFrogAngle} Fast
  *   Tracks publish, an independent check that this reading is right.
@@ -2593,6 +2628,14 @@ declare function crossoverAssembly(part: TrackPart): {
     spacingInches: number;
     /** Along-track distance a crossing route takes to reach the other track. */
     crossingRunInches: number;
+    /**
+     * Start of the moulding → start of the points, at each end.
+     *
+     * ⭐ The measurement that has to be right for the drawing to read as track:
+     * it is the plain tie strip a crossover begins and ends with, and therefore
+     * where the through routes are jointed.
+     */
+    approachInches: number;
     /** Where the four point-sets sit along the assembly. */
     pointsAtInches: [number, number];
     /** The X where the two crossing routes meet — a real diamond in the middle. */

package/dist/index.js

@@ -2212,7 +2212,7 @@ function crossoverAssembly(part) {
   const spacing = part.trackSpacing?.inches;
   const n = part.frogNumber;
   if (!overall || !spacing || !n) return null;
-  const lengthInches = overall * (part.piecesPerAssembly ?? 1);
+  const lengthInches = overall;
   const tan = part.actualAngle ? Math.tan(part.actualAngle.deg * Math.PI / 180) : 1 / n;
   if (!(tan > 0)) return null;
   const crossingRunInches = spacing / tan;
@@ -2222,6 +2222,7 @@ function crossoverAssembly(part) {
     lengthInches,
     spacingInches: spacing,
     crossingRunInches,
+    approachInches: mid - half,
     pointsAtInches: [mid - half, mid + half],
     scissorsAtInches: mid
   };