@willcgage/module-schematic 0.95.0 → 0.95.1

package/dist/index.d.cts

@@ -223,6 +223,24 @@ interface SchematicTrack {
      * fouling the track. Absent = derive it from the clearance points (#19). */
     measuredUsableInches?: number | null;
 }
+/**
+ * A turnout.
+ *
+ * ⭐ **THE WORD IS "TURNOUT", NOT "SWITCH".** They were used interchangeably
+ * across both apps; this is the one name. The Free-moN standard says turnout
+ * ("main-line turnouts at least #6") and so does the NMRA, every user-facing
+ * string already said it, and "switch" is ambiguous three ways for us — the
+ * points assembly, an electrical switch, and *switching*, the operation of
+ * moving cars, which we need as its own word.
+ *
+ * ⚠️ TWO DELIBERATE EXCEPTIONS, both still correct usage:
+ * 1. **A manufacturer's own product name, quoted as they sell it.** Atlas sells
+ *    a "#7 LH Switch" (2052). Renaming their product makes it un-findable in a
+ *    catalogue, which is the opposite of what a parts library is for.
+ * 2. **The points assembly and its geometry** — "switch points", and the
+ *    "switch angle" that {@link TurnoutClosure.switchSlope} carries. That is a
+ *    part OF a turnout, not another word FOR one.
+ */
 interface SchematicTurnout {
     id: string;
     pos: number;
@@ -1340,7 +1358,7 @@ declare function docToState(doc: unknown, fallbackLength: number, moduleTracks?:
 /** Find an unused `${prefix}${n}` id given the ones already present. */
 declare function nextId(prefix: string, existing: string[]): string;
 /**
- * Build a passing siding as one unit: the siding track, a switch at each end,
+ * Build a passing siding as one unit: the siding track, a turnout at each end,
  * and control-point signals for both directions at each end (prototype Station
  * Entering Signal). Returns the new items to merge into the editor state.
  */

package/dist/index.d.ts

@@ -223,6 +223,24 @@ interface SchematicTrack {
      * fouling the track. Absent = derive it from the clearance points (#19). */
     measuredUsableInches?: number | null;
 }
+/**
+ * A turnout.
+ *
+ * ⭐ **THE WORD IS "TURNOUT", NOT "SWITCH".** They were used interchangeably
+ * across both apps; this is the one name. The Free-moN standard says turnout
+ * ("main-line turnouts at least #6") and so does the NMRA, every user-facing
+ * string already said it, and "switch" is ambiguous three ways for us — the
+ * points assembly, an electrical switch, and *switching*, the operation of
+ * moving cars, which we need as its own word.
+ *
+ * ⚠️ TWO DELIBERATE EXCEPTIONS, both still correct usage:
+ * 1. **A manufacturer's own product name, quoted as they sell it.** Atlas sells
+ *    a "#7 LH Switch" (2052). Renaming their product makes it un-findable in a
+ *    catalogue, which is the opposite of what a parts library is for.
+ * 2. **The points assembly and its geometry** — "switch points", and the
+ *    "switch angle" that {@link TurnoutClosure.switchSlope} carries. That is a
+ *    part OF a turnout, not another word FOR one.
+ */
 interface SchematicTurnout {
     id: string;
     pos: number;
@@ -1340,7 +1358,7 @@ declare function docToState(doc: unknown, fallbackLength: number, moduleTracks?:
 /** Find an unused `${prefix}${n}` id given the ones already present. */
 declare function nextId(prefix: string, existing: string[]): string;
 /**
- * Build a passing siding as one unit: the siding track, a switch at each end,
+ * Build a passing siding as one unit: the siding track, a turnout at each end,
  * and control-point signals for both directions at each end (prototype Station
  * Entering Signal). Returns the new items to merge into the editor state.
  */