@willcgage/module-schematic 0.16.0 → 0.17.0

package/dist/index.d.ts

@@ -191,6 +191,45 @@ declare function sampleBenchworkOutline(pts: BenchworkPoint[], segsPerArc?: numb
     x: number;
     y: number;
 }[];
+interface ModuleFootprintInput {
+    /** Mainline length (falls back to footprint length), inches. */
+    lengthInches: number;
+    geometryType?: string | null;
+    geometryDegrees?: number | null;
+    geometryOffsetInches?: number | null;
+    /** Authored endplate face widths by id ("A"/"B"…), inches; default recommended. */
+    endplateWidths?: Record<string, number>;
+    /** Authored benchwork outline (module-local inches), or absent for the band. */
+    outline?: BenchworkPoint[] | null;
+}
+interface OutlineFace {
+    /** The endplate face's two corners + midpoint (the track point). */
+    p1: BenchworkPoint;
+    p2: BenchworkPoint;
+    mid: BenchworkPoint;
+}
+interface ModuleFootprint {
+    /** Main track centre-line A→B (arcs sampled). */
+    centerline: BenchworkPoint[];
+    /** Derived benchwork band (endplate-width ribbon); the outline fallback. */
+    band: BenchworkPoint[];
+    /** Endplate faces: [A end, B end]. */
+    endplateFaces: OutlineFace[];
+    /** Authored outline (arc-sampled closed ring) or null → render the band. */
+    outline: BenchworkPoint[] | null;
+}
+/** Module-local main track centre-line (A→B), sampling arcs for curves/corners. */
+declare function moduleCenterline(input: ModuleFootprintInput): BenchworkPoint[];
+/** Benchwork band: the centre-line offset ±half-width, tapering widthA→widthB. */
+declare function benchworkBand(center: BenchworkPoint[], widthA?: number, widthB?: number): BenchworkPoint[];
+/** The two endplate faces (the band's flat ends): [A end at widthA, B end at widthB]. */
+declare function endplateFaceSegments(center: BenchworkPoint[], widthA?: number, widthB?: number): OutlineFace[];
+/**
+ * The full single-module physical footprint: centre-line + derived band +
+ * endplate faces + the authored outline (arc-sampled), all in module-local
+ * inches. Renderers draw `outline ?? band`.
+ */
+declare function moduleFootprint(input: ModuleFootprintInput): ModuleFootprint;
 /** Whether a doc is a single-endplate turnback (explicit flag or one endplate). */
 declare function isLoopDoc(doc: ModuleSchematicDoc): boolean;
 declare const MAIN_TRACK_ID = "main";
@@ -559,4 +598,4 @@ declare function poseOverridesFromDoc(doc: ModuleSchematicDoc): Record<string, {
     heading: number;
 }>;
 
-export { type BenchworkPoint, type BranchConnector, type DrawCrossing, type DrawCrossover, type DrawSignal, type DrawTrack, type DrawTurnout, type EditorBranch, type EditorControlPoint, type EditorCpSignal, type EditorCrossing, type EditorState, type EditorTrack, type EditorTurnout, type EndplateBConfig, type EndplatePose, FREEMO_ENDPLATE_WIDTH_MIN_INCHES, FREEMO_ENDPLATE_WIDTH_RECOMMENDED_INCHES, type GeometryType, MAIN2_TRACK_ID, MAIN_TRACK_ID, type ModuleFeatures, type ModuleGeometryInput, type ModuleSchematicDoc, type ModuleTrackRow, N_SCALE_RATIO, type SchematicBlock, type SchematicControlPoint, type SchematicCrossing, type SchematicEndplate, type SchematicEndplateTrack, type SchematicSignal, type SchematicTrack, type SchematicTurnout, type SignalFacing, type SignalSide, type TrackConfig, type TrackRole, type TurnoutKind, asModuleSchematic, benchworkOutline, buildCrossover, buildPassingSiding, buildTransition, deriveEndplatePoses, divergeSideForHand, docToState, emptyEditorState, endplateWidthInches, geometryTurnDegrees, inchesToScaleFeet, isLoopDoc, isTransitionTurnout, moduleFeatures, nextId, poseNeedsManual, poseOverridesFromDoc, sampleBenchworkOutline, scaleFeetToInches, stateToDoc };
+export { type BenchworkPoint, type BranchConnector, type DrawCrossing, type DrawCrossover, type DrawSignal, type DrawTrack, type DrawTurnout, type EditorBranch, type EditorControlPoint, type EditorCpSignal, type EditorCrossing, type EditorState, type EditorTrack, type EditorTurnout, type EndplateBConfig, type EndplatePose, FREEMO_ENDPLATE_WIDTH_MIN_INCHES, FREEMO_ENDPLATE_WIDTH_RECOMMENDED_INCHES, type GeometryType, MAIN2_TRACK_ID, MAIN_TRACK_ID, type ModuleFeatures, type ModuleFootprint, type ModuleFootprintInput, type ModuleGeometryInput, type ModuleSchematicDoc, type ModuleTrackRow, N_SCALE_RATIO, type OutlineFace, type SchematicBlock, type SchematicControlPoint, type SchematicCrossing, type SchematicEndplate, type SchematicEndplateTrack, type SchematicSignal, type SchematicTrack, type SchematicTurnout, type SignalFacing, type SignalSide, type TrackConfig, type TrackRole, type TurnoutKind, asModuleSchematic, benchworkBand, benchworkOutline, buildCrossover, buildPassingSiding, buildTransition, deriveEndplatePoses, divergeSideForHand, docToState, emptyEditorState, endplateFaceSegments, endplateWidthInches, geometryTurnDegrees, inchesToScaleFeet, isLoopDoc, isTransitionTurnout, moduleCenterline, moduleFeatures, moduleFootprint, nextId, poseNeedsManual, poseOverridesFromDoc, sampleBenchworkOutline, scaleFeetToInches, stateToDoc };

package/dist/index.js

@@ -63,6 +63,78 @@ function arcSweep(a0, a1, am) {
   const one = norm(a1);
   return m <= one ? one : one - 2 * Math.PI;
 }
+var DEG_FP = Math.PI / 180;
+function moduleCenterline(input) {
+  const L = input.lengthInches > 0 ? input.lengthInches : 24;
+  const gt = input.geometryType;
+  if (gt === "dead_end") return [{ x: 0, y: 0 }];
+  if (gt === "offset") return [{ x: 0, y: 0 }, { x: L, y: input.geometryOffsetInches ?? 0 }];
+  const turn = gt === "corner_45" ? 45 : gt === "corner_90" ? 90 : gt === "curve" ? input.geometryDegrees ?? 0 : 0;
+  if (turn === 0) return [{ x: 0, y: 0 }, { x: L, y: 0 }];
+  const t = turn * DEG_FP;
+  const r = L / t;
+  const steps = 12;
+  const pts = [];
+  for (let i = 0; i <= steps; i++) {
+    const a = t * i / steps;
+    pts.push({ x: r * Math.sin(a), y: r * (1 - Math.cos(a)) });
+  }
+  return pts;
+}
+function centerlineNormals(center) {
+  return center.map((_, i) => {
+    const a = center[Math.max(0, i - 1)];
+    const b = center[Math.min(center.length - 1, i + 1)];
+    let dx = b.x - a.x;
+    let dy = b.y - a.y;
+    const len = Math.hypot(dx, dy) || 1;
+    dx /= len;
+    dy /= len;
+    return { x: -dy, y: dx };
+  });
+}
+function centerlineFractions(center) {
+  const cum = [0];
+  for (let i = 1; i < center.length; i++)
+    cum.push(cum[i - 1] + Math.hypot(center[i].x - center[i - 1].x, center[i].y - center[i - 1].y));
+  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) {
+  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) }));
+  return [...left, ...right.reverse()];
+}
+function endplateFaceSegments(center, widthA = FREEMO_ENDPLATE_WIDTH_RECOMMENDED_INCHES, widthB = FREEMO_ENDPLATE_WIDTH_RECOMMENDED_INCHES) {
+  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) },
+    mid: { x: center[i].x, y: center[i].y }
+  });
+  return [face(0, widthA), face(center.length - 1, widthB)];
+}
+function moduleFootprint(input) {
+  const centerline = moduleCenterline(input);
+  const widthA = endplateWidthFor(input.endplateWidths, "A");
+  const widthB = endplateWidthFor(input.endplateWidths, "B");
+  const authored = benchworkOutline(input);
+  return {
+    centerline,
+    band: benchworkBand(centerline, widthA, widthB),
+    endplateFaces: endplateFaceSegments(centerline, widthA, widthB),
+    outline: authored ? sampleBenchworkOutline(authored) : null
+  };
+}
+function endplateWidthFor(widths, id) {
+  const w = widths?.[id];
+  return typeof w === "number" && w > 0 ? w : FREEMO_ENDPLATE_WIDTH_RECOMMENDED_INCHES;
+}
 function isLoopDoc(doc) {
   return doc.loop === true || doc.endplates.length === 1;
 }
@@ -820,6 +892,6 @@ function poseOverridesFromDoc(doc) {
   return out;
 }
 
-export { FREEMO_ENDPLATE_WIDTH_MIN_INCHES, FREEMO_ENDPLATE_WIDTH_RECOMMENDED_INCHES, MAIN2_TRACK_ID, MAIN_TRACK_ID, N_SCALE_RATIO, asModuleSchematic, benchworkOutline, buildCrossover, buildPassingSiding, buildTransition, deriveEndplatePoses, divergeSideForHand, docToState, emptyEditorState, endplateWidthInches, geometryTurnDegrees, inchesToScaleFeet, isLoopDoc, isTransitionTurnout, moduleFeatures, nextId, poseNeedsManual, poseOverridesFromDoc, sampleBenchworkOutline, scaleFeetToInches, stateToDoc };
+export { FREEMO_ENDPLATE_WIDTH_MIN_INCHES, FREEMO_ENDPLATE_WIDTH_RECOMMENDED_INCHES, MAIN2_TRACK_ID, MAIN_TRACK_ID, N_SCALE_RATIO, asModuleSchematic, benchworkBand, benchworkOutline, buildCrossover, buildPassingSiding, buildTransition, deriveEndplatePoses, divergeSideForHand, docToState, emptyEditorState, endplateFaceSegments, endplateWidthInches, geometryTurnDegrees, inchesToScaleFeet, isLoopDoc, isTransitionTurnout, moduleCenterline, moduleFeatures, moduleFootprint, nextId, poseNeedsManual, poseOverridesFromDoc, sampleBenchworkOutline, scaleFeetToInches, stateToDoc };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map