@willcgage/module-schematic 0.26.0 → 0.28.0

package/dist/index.cjs

@@ -3,6 +3,8 @@
 // src/index.ts
 var FREEMO_ENDPLATE_WIDTH_MIN_INCHES = 12;
 var FREEMO_ENDPLATE_WIDTH_RECOMMENDED_INCHES = 24;
+var FREEMO_TRACK_SPACING_INCHES = 1.125;
+var FREEMO_ENDPLATE_TRACK_FASCIA_CLEARANCE_INCHES = 4;
 function endplateWidthInches(ep) {
   const w = ep?.widthInches;
   return typeof w === "number" && w > 0 ? w : FREEMO_ENDPLATE_WIDTH_RECOMMENDED_INCHES;
@@ -144,37 +146,79 @@ function centerlineFractions(center) {
   const total = cum[cum.length - 1] || 1;
   return cum.map((d) => d / total);
 }
-function benchworkBand(center, widthA = FREEMO_ENDPLATE_WIDTH_RECOMMENDED_INCHES, widthB = FREEMO_ENDPLATE_WIDTH_RECOMMENDED_INCHES) {
+function benchworkBand(center, widthA = FREEMO_ENDPLATE_WIDTH_RECOMMENDED_INCHES, widthB = FREEMO_ENDPLATE_WIDTH_RECOMMENDED_INCHES, offsetA = 0, offsetB = 0) {
   if (center.length < 2) return [];
   const n = centerlineNormals(center);
   const f = centerlineFractions(center);
   const half = (i) => (widthA * (1 - f[i]) + widthB * f[i]) / 2;
-  const left = center.map((p, i) => ({ x: p.x + n[i].x * half(i), y: p.y + n[i].y * half(i) }));
-  const right = center.map((p, i) => ({ x: p.x - n[i].x * half(i), y: p.y - n[i].y * half(i) }));
+  const off = (i) => offsetA * (1 - f[i]) + offsetB * f[i];
+  const left = center.map((p, i) => ({
+    x: p.x + n[i].x * (off(i) + half(i)),
+    y: p.y + n[i].y * (off(i) + half(i))
+  }));
+  const right = center.map((p, i) => ({
+    x: p.x + n[i].x * (off(i) - half(i)),
+    y: p.y + n[i].y * (off(i) - half(i))
+  }));
   return [...left, ...right.reverse()];
 }
-function endplateFaceSegments(center, widthA = FREEMO_ENDPLATE_WIDTH_RECOMMENDED_INCHES, widthB = FREEMO_ENDPLATE_WIDTH_RECOMMENDED_INCHES) {
+function endplateFaceSegments(center, widthA = FREEMO_ENDPLATE_WIDTH_RECOMMENDED_INCHES, widthB = FREEMO_ENDPLATE_WIDTH_RECOMMENDED_INCHES, offsetA = 0, offsetB = 0) {
   if (center.length < 2) return [];
   const n = centerlineNormals(center);
-  const face = (i, w) => ({
-    p1: { x: center[i].x + n[i].x * (w / 2), y: center[i].y + n[i].y * (w / 2) },
-    p2: { x: center[i].x - n[i].x * (w / 2), y: center[i].y - n[i].y * (w / 2) },
+  const face = (i, w, o) => ({
+    p1: { x: center[i].x + n[i].x * (o + w / 2), y: center[i].y + n[i].y * (o + w / 2) },
+    p2: { x: center[i].x + n[i].x * (o - w / 2), y: center[i].y + n[i].y * (o - w / 2) },
     mid: { x: center[i].x, y: center[i].y }
   });
-  return [face(0, widthA), face(center.length - 1, widthB)];
+  return [face(0, widthA, offsetA), face(center.length - 1, widthB, offsetB)];
 }
 function moduleFootprint(input) {
   const centerline = moduleCenterline(input);
   const widthA = endplateWidthFor(input.endplateWidths, "A");
   const widthB = endplateWidthFor(input.endplateWidths, "B");
   const authored = benchworkOutline(input);
+  const offA = input.endplateTrackOffsets?.["A"] ?? 0;
+  const offB = input.endplateTrackOffsets?.["B"] ?? 0;
   return {
     centerline,
-    band: benchworkBand(centerline, widthA, widthB),
-    endplateFaces: endplateFaceSegments(centerline, widthA, widthB),
+    band: benchworkBand(centerline, widthA, widthB, offA, offB),
+    endplateFaces: endplateFaceSegments(centerline, widthA, widthB, offA, offB),
     outline: authored ? sampleBenchworkOutline(authored) : null
   };
 }
+function endplateTrackOffsetFor(config, authoredTrackOffset) {
+  const v = -endplateTrackOffsetInches(authoredTrackOffset, config);
+  return v === 0 ? 0 : v;
+}
+function endplateTrackOffsetInches(authored, config) {
+  if (typeof authored === "number" && Number.isFinite(authored)) return authored;
+  return config === "double" ? -FREEMO_TRACK_SPACING_INCHES / 2 : 0;
+}
+function checkEndplateWidth(input) {
+  const width = endplateWidthInches(input);
+  const issues = [];
+  if (width < FREEMO_ENDPLATE_WIDTH_MIN_INCHES) {
+    issues.push({
+      code: "narrow",
+      message: `Endplate is ${round2(width)}\u2033 wide \u2014 the standard requires at least ${FREEMO_ENDPLATE_WIDTH_MIN_INCHES}\u2033.`,
+      requiredInches: FREEMO_ENDPLATE_WIDTH_MIN_INCHES
+    });
+  }
+  const off = input.trackOffsetInches ?? 0;
+  const centres = input.config === "double" ? [off - FREEMO_TRACK_SPACING_INCHES / 2, off + FREEMO_TRACK_SPACING_INCHES / 2] : [off];
+  const worst = Math.max(...centres.map((c) => Math.abs(c)));
+  const clearance = width / 2 - worst;
+  if (clearance < FREEMO_ENDPLATE_TRACK_FASCIA_CLEARANCE_INCHES) {
+    const required = 2 * (worst + FREEMO_ENDPLATE_TRACK_FASCIA_CLEARANCE_INCHES);
+    issues.push({
+      code: "clearance",
+      message: `Track sits ${round2(clearance)}\u2033 from the fascia \u2014 the standard requires at least ${FREEMO_ENDPLATE_TRACK_FASCIA_CLEARANCE_INCHES}\u2033. Widen this end to ${round2(required)}\u2033` + (off !== 0 ? " or move the track back toward the centre." : "."),
+      requiredInches: required
+    });
+  }
+  return issues;
+}
+var round2 = (n) => Math.round(n * 100) / 100;
 function endplateWidthFor(widths, id) {
   const w = widths?.[id];
   return typeof w === "number" && w > 0 ? w : FREEMO_ENDPLATE_WIDTH_RECOMMENDED_INCHES;
@@ -217,6 +261,7 @@ function emptyEditorState(lengthInches) {
     branches: [],
     poseOverrides: {},
     endplateWidths: {},
+    endplateTrackOffsets: {},
     outline: [],
     sectionBreaks: [],
     controlPoints: [],
@@ -299,10 +344,14 @@ function withPoses(endplates, overrides) {
     (e) => overrides[e.id] ? { ...e, pose: overrides[e.id] } : e
   );
 }
-function withWidths(endplates, widths) {
+function withWidths(endplates, widths, offsets = {}) {
   return endplates.map((e) => {
     const w = widths[e.id];
-    return typeof w === "number" && w > 0 ? { ...e, widthInches: w } : e;
+    const o = offsets[e.id];
+    let out = e;
+    if (typeof w === "number" && w > 0) out = { ...out, widthInches: w };
+    if (typeof o === "number" && Number.isFinite(o)) out = { ...out, trackOffsetInches: o };
+    return out;
   });
 }
 function stateToDoc(state, recordNumber) {
@@ -351,7 +400,8 @@ function stateToDoc(state, recordNumber) {
         ],
         state.poseOverrides
       ),
-      state.endplateWidths
+      state.endplateWidths,
+      state.endplateTrackOffsets
     ),
     tracks: [
       state.loop ? (
@@ -510,9 +560,12 @@ function docToState(doc, fallbackLength, moduleTracks = []) {
   );
   const poseOverrides = poseOverridesFromDoc(d);
   const endplateWidths = {};
+  const endplateTrackOffsets = {};
   for (const e of d.endplates ?? []) {
     if (typeof e.widthInches === "number" && e.widthInches > 0)
       endplateWidths[e.id] = e.widthInches;
+    if (typeof e.trackOffsetInches === "number" && Number.isFinite(e.trackOffsetInches))
+      endplateTrackOffsets[e.id] = e.trackOffsetInches;
   }
   const outline = (d.outline ?? []).filter((p) => p && Number.isFinite(p.x) && Number.isFinite(p.y)).map((p) => ({
     x: p.x,
@@ -536,6 +589,7 @@ function docToState(doc, fallbackLength, moduleTracks = []) {
     })),
     poseOverrides,
     endplateWidths,
+    endplateTrackOffsets,
     outline,
     sectionBreaks: (d.sectionBreaks ?? []).filter((n) => Number.isFinite(n)).map((n) => sc(n)),
     mainPath,
@@ -1039,8 +1093,10 @@ function poseOverridesFromDoc(doc) {
   return out;
 }
 
+exports.FREEMO_ENDPLATE_TRACK_FASCIA_CLEARANCE_INCHES = FREEMO_ENDPLATE_TRACK_FASCIA_CLEARANCE_INCHES;
 exports.FREEMO_ENDPLATE_WIDTH_MIN_INCHES = FREEMO_ENDPLATE_WIDTH_MIN_INCHES;
 exports.FREEMO_ENDPLATE_WIDTH_RECOMMENDED_INCHES = FREEMO_ENDPLATE_WIDTH_RECOMMENDED_INCHES;
+exports.FREEMO_TRACK_SPACING_INCHES = FREEMO_TRACK_SPACING_INCHES;
 exports.MAIN2_TRACK_ID = MAIN2_TRACK_ID;
 exports.MAIN_TRACK_ID = MAIN_TRACK_ID;
 exports.N_CAR_LENGTH_INCHES = N_CAR_LENGTH_INCHES;
@@ -1052,11 +1108,14 @@ exports.buildCrossover = buildCrossover;
 exports.buildPassingSiding = buildPassingSiding;
 exports.buildTransition = buildTransition;
 exports.carCapacity = carCapacity;
+exports.checkEndplateWidth = checkEndplateWidth;
 exports.deriveEndplatePoses = deriveEndplatePoses;
 exports.divergeSideForHand = divergeSideForHand;
 exports.docToState = docToState;
 exports.emptyEditorState = emptyEditorState;
 exports.endplateFaceSegments = endplateFaceSegments;
+exports.endplateTrackOffsetFor = endplateTrackOffsetFor;
+exports.endplateTrackOffsetInches = endplateTrackOffsetInches;
 exports.endplateWidthInches = endplateWidthInches;
 exports.geometryTurnDegrees = geometryTurnDegrees;
 exports.inchesToScaleFeet = inchesToScaleFeet;