@willcgage/module-schematic 0.66.0 → 0.67.0

package/dist/index.d.cts

@@ -789,9 +789,11 @@ interface EditorBranch {
      * draws track to it; the plate is placed first, connected later). */
     trackId?: string | null;
 }
-/** Endplate B on a loop module: a standard endplate makes the balloon an
- * INTERCHANGE (a second route connects at the loop, e.g. Seaford); "none"
- * makes it a pure turnback. Non-loop modules always have a real B. */
+/** Endplate B's configuration — or `"none"`, meaning **the module has no far
+ * endplate**: an end of the line, a pocket, or a loop's pure turnback. On a
+ * loop, a standard endplate B instead makes the balloon an INTERCHANGE (a second
+ * route connects there, e.g. Seaford). A module presents one conforming face,
+ * or two, or more; the standard governs the faces it offers, not how many (#184). */
 type EndplateBConfig = TrackConfig | "none";
 interface EditorState {
     lengthInches: number;
@@ -1667,8 +1669,10 @@ interface ModuleGeometryInput {
     geometryType?: string | null;
     geometryDegrees?: number | null;
     geometryOffsetInches?: number | null;
-    /** Axial endplate configs (A first, then B). Missing → single. */
-    endplateConfigs?: ("single" | "double" | null | undefined)[];
+    /** Axial endplate configs (A first, then B). Missing → single. `"none"` at B
+     * means the module has no far endplate at all — an end of the line, a pocket,
+     * or a turnback (#184). */
+    endplateConfigs?: ("single" | "double" | "none" | null | undefined)[];
     /** Branch endplates (from the schematic doc, #170), positioned along the
      * mainline axis. */
     branches?: {

package/dist/index.d.ts

@@ -789,9 +789,11 @@ interface EditorBranch {
      * draws track to it; the plate is placed first, connected later). */
     trackId?: string | null;
 }
-/** Endplate B on a loop module: a standard endplate makes the balloon an
- * INTERCHANGE (a second route connects at the loop, e.g. Seaford); "none"
- * makes it a pure turnback. Non-loop modules always have a real B. */
+/** Endplate B's configuration — or `"none"`, meaning **the module has no far
+ * endplate**: an end of the line, a pocket, or a loop's pure turnback. On a
+ * loop, a standard endplate B instead makes the balloon an INTERCHANGE (a second
+ * route connects there, e.g. Seaford). A module presents one conforming face,
+ * or two, or more; the standard governs the faces it offers, not how many (#184). */
 type EndplateBConfig = TrackConfig | "none";
 interface EditorState {
     lengthInches: number;
@@ -1667,8 +1669,10 @@ interface ModuleGeometryInput {
     geometryType?: string | null;
     geometryDegrees?: number | null;
     geometryOffsetInches?: number | null;
-    /** Axial endplate configs (A first, then B). Missing → single. */
-    endplateConfigs?: ("single" | "double" | null | undefined)[];
+    /** Axial endplate configs (A first, then B). Missing → single. `"none"` at B
+     * means the module has no far endplate at all — an end of the line, a pocket,
+     * or a turnback (#184). */
+    endplateConfigs?: ("single" | "double" | "none" | null | undefined)[];
     /** Branch endplates (from the schematic doc, #170), positioned along the
      * mainline axis. */
     branches?: {

package/dist/index.js

@@ -701,18 +701,20 @@ function stateToDoc(state, recordNumber) {
             ]
           ) : [
             { id: "A", label: "West", tracks: [{ trackId: MAIN_TRACK_ID, lane: 0, config: state.configA }] },
-            // Non-loop modules always have a real B ("none" never applies).
-            {
-              id: "B",
-              label: "East",
-              tracks: [
-                {
-                  trackId: MAIN_TRACK_ID,
-                  lane: 0,
-                  config: state.configB === "none" ? "single" : state.configB
-                }
-              ]
-            }
+            // ⚠️ `configB: "none"` means the module HAS NO FAR ENDPLATE, and
+            // that is not loop-only (#184). An *end of the line* or a *pocket*
+            // presents one conforming face and the track simply stops. The
+            // standard governs the ends a module offers for joining; it never
+            // required a module to offer two. This used to coerce "none" to
+            // "single" and emit a B regardless, so a single-ended module was
+            // impossible to author.
+            ...state.configB !== "none" ? [
+              {
+                id: "B",
+                label: "East",
+                tracks: [{ trackId: MAIN_TRACK_ID, lane: 0, config: state.configB }]
+              }
+            ] : []
           ],
           // Branch endplates C, D, … — junction connections at pos, off one side
           // (#170). A set can carry several (e.g. a second railroad through).
@@ -1982,7 +1984,7 @@ function deriveEndplatePoses(geo) {
       trackOffsets: offsetsFor(cfg(0), half)
     })
   );
-  const noB = geo.geometryType === "dead_end" || geo.loop === true;
+  const noB = geo.geometryType === "dead_end" || geo.loop === true || geo.endplateConfigs?.[1] === "none";
   const end = sectionedEndPose({ sections: geo.sections });
   if (!noB && end) {
     poses.push(