@willcgage/module-schematic 0.45.0 → 0.47.0

package/dist/index.d.cts

@@ -412,6 +412,9 @@ interface ModuleFootprintInput {
      * When present it wins over the geometry-derived centre-line — the owner drew
      * the real shape (#2d-track, physical view only). */
     mainPath?: BenchworkPoint[] | null;
+    /** A balloon / return loop — the centre-line turns back on itself, so its far
+     * end is the THROAT, not an endplate; only endplate A's face is emitted (#loop). */
+    loop?: boolean;
 }
 interface OutlineFace {
     /** The endplate face's two corners + midpoint (the track point). */
@@ -1067,6 +1070,11 @@ interface ModuleGeometryInput {
      * so endplate B lands at the end of the CHAINED boards rather than where a
      * single module-level geometry would have put it (#108). */
     sections?: SchematicSection[] | null;
+    /** A balloon / return loop: the main runs out and turns back on itself, so the
+     * module has ONE endplate (A). No far endplate B is derived — the chain closes
+     * back near the throat, and a B there would just be a spurious plate on the
+     * loop. An interchange endplate on the balloon is placed separately (#loop). */
+    loop?: boolean;
 }
 /** Signed turn a module applies to the through track (CCW/left positive). */
 declare function geometryTurnDegrees(geometryType?: string | null, geometryDegrees?: number | null): number;

package/dist/index.d.ts

@@ -412,6 +412,9 @@ interface ModuleFootprintInput {
      * When present it wins over the geometry-derived centre-line — the owner drew
      * the real shape (#2d-track, physical view only). */
     mainPath?: BenchworkPoint[] | null;
+    /** A balloon / return loop — the centre-line turns back on itself, so its far
+     * end is the THROAT, not an endplate; only endplate A's face is emitted (#loop). */
+    loop?: boolean;
 }
 interface OutlineFace {
     /** The endplate face's two corners + midpoint (the track point). */
@@ -1067,6 +1070,11 @@ interface ModuleGeometryInput {
      * so endplate B lands at the end of the CHAINED boards rather than where a
      * single module-level geometry would have put it (#108). */
     sections?: SchematicSection[] | null;
+    /** A balloon / return loop: the main runs out and turns back on itself, so the
+     * module has ONE endplate (A). No far endplate B is derived — the chain closes
+     * back near the throat, and a B there would just be a spurious plate on the
+     * loop. An interchange endplate on the balloon is placed separately (#loop). */
+    loop?: boolean;
 }
 /** Signed turn a module applies to the through track (CCW/left positive). */
 declare function geometryTurnDegrees(geometryType?: string | null, geometryDegrees?: number | null): number;

package/dist/index.js

@@ -472,7 +472,9 @@ function moduleFootprint(input) {
   return {
     centerline,
     band: benchworkBand(centerline, widthA, widthB, offA, offB),
-    endplateFaces: endplateFaceSegments(centerline, widthA, widthB, offA, offB),
+    // A loop's centre-line ends at the throat, not a far endplate — keep only
+    // endplate A's face (the far face would be a spurious plate at the throat).
+    endplateFaces: input.loop ? endplateFaceSegments(centerline, widthA, widthB, offA, offB).slice(0, 1) : endplateFaceSegments(centerline, widthA, widthB, offA, offB),
     outline: sectionOutlines.length || !authored ? null : sampleBenchworkOutline(authored),
     sectionOutlines
   };
@@ -1354,7 +1356,7 @@ function deriveEndplatePoses(geo) {
       trackOffsets: offsetsFor(cfg(0), half)
     })
   );
-  const noB = geo.geometryType === "dead_end";
+  const noB = geo.geometryType === "dead_end" || geo.loop === true;
   const end = sectionedEndPose({ sections: geo.sections });
   if (!noB && end) {
     poses.push(