@willcgage/module-schematic 0.30.0 → 0.32.0

package/dist/index.d.cts

@@ -273,6 +273,18 @@ interface BenchworkPoint {
     bulge?: number;
 }
 /** One bench-work section of a module (#96 phase 2). */
+interface SectionFootprint {
+    id: string;
+    name?: string;
+    outline: {
+        x: number;
+        y: number;
+    }[];
+    /** True when this shape is DERIVED from the section's span rather than
+     * authored — a derived outline follows the board when it's resized, an
+     * authored one stays exactly as drawn (#96 phase 2b). */
+    derived: boolean;
+}
 interface SchematicSection {
     id: string;
     /** What the owner calls this board — "west transition", "double #3". */
@@ -314,14 +326,18 @@ declare function moduleSections(doc: {
  * bring in real clipping. */
 declare function sectionFootprints(doc: {
     sections?: SchematicSection[] | null;
-} | null | undefined): {
-    id: string;
-    name?: string;
-    outline: {
-        x: number;
-        y: number;
-    }[];
-}[];
+} | null | undefined, 
+/** The module's spine and dimensions. Given these, a section with no
+ * authored polygon gets a band derived from its own span, so every section
+ * has a shape and a resized board reshapes with it (#96 phase 2b). Omit to
+ * get authored outlines only. */
+derive?: {
+    centerline: BenchworkPoint[];
+    widthA: number;
+    widthB: number;
+    offsetA: number;
+    offsetB: number;
+}): SectionFootprint[];
 /**
  * Expand a benchwork outline (whose edges may be arcs) into a dense closed
  * polyline for rendering — the SAME sampling both the Repository preview and
@@ -387,17 +403,10 @@ interface ModuleFootprint {
     /** Authored outline (arc-sampled closed ring) or null → render the band.
      * Null too when `sectionOutlines` is non-empty — the sections ARE the shape. */
     outline: BenchworkPoint[] | null;
-    /** Per-section footprints, arc-sampled (#96 phase 2). Draw every one: together
+    /** Per-section footprints, arc-sampled (#96 phase 2b). Draw every one: together
      * they are the module's footprint. Empty = this module doesn't use sections,
      * so fall back to `outline ?? band` exactly as before. */
-    sectionOutlines: {
-        id: string;
-        name?: string;
-        outline: {
-            x: number;
-            y: number;
-        }[];
-    }[];
+    sectionOutlines: SectionFootprint[];
 }
 /** Module-local main track centre-line (A→B), sampling arcs for curves/corners.
  * An authored `mainPath` wins — the owner drew the real shape; otherwise the
@@ -434,6 +443,48 @@ declare function sectionedCenterline(doc: {
 } | null | undefined): BenchworkPoint[];
 /** Benchwork band: the centre-line offset ±half-width, tapering widthA→widthB. */
 declare function benchworkBand(center: BenchworkPoint[], widthA?: number, widthB?: number, offsetA?: number, offsetB?: number): BenchworkPoint[];
+/** The sub-polyline of a centre-line between two arc-length positions, with
+ * the cut ends interpolated so a slice starts and finishes exactly on them. */
+declare function sliceCenterline(center: BenchworkPoint[], fromPos: number, toPos: number): BenchworkPoint[];
+/** One section's bench-work as a band over its own stretch of centre-line —
+ * the per-section equivalent of `benchworkBand` (#96 phase 2b). Width and
+ * plate offset are interpolated from the module's ends exactly as the whole
+ * band does, so a section's derived shape lines up with its neighbours.
+ *
+ * This is what makes an outline BELONG to the section: a section without an
+ * authored polygon gets one derived from its span, so resizing the board
+ * reshapes it instead of leaving a hand-drawn outline stranded. */
+declare function sectionBand(center: BenchworkPoint[], fromPos: number, toPos: number, widthA?: number, widthB?: number, offsetA?: number, offsetB?: number): BenchworkPoint[];
+/** Two sections that physically meet, and how much edge they share. */
+interface SectionAdjacency {
+    a: string;
+    b: string;
+    /** Inches of shared edge — a butt joint across a 24″ board reads ~24. */
+    lengthInches: number;
+}
+/**
+ * Which sections physically MEET, derived from shared polygon edges rather
+ * than list order (#96 phase 2c).
+ *
+ * Order is the wrong model as soon as a module stops being a row of boards: a
+ * peninsula hangs off the BACK of a shallow band over part of its length, so
+ * it neighbours a board it isn't next to in any list. Geometry is the only
+ * thing that knows.
+ */
+declare function sectionAdjacency(footprints: SectionFootprint[], opts?: {
+    gapInches?: number;
+    angleDegrees?: number;
+    minOverlapInches?: number;
+}): SectionAdjacency[];
+/** The sections each one touches. */
+declare function sectionNeighbours(id: string, adj: SectionAdjacency[]): string[];
+/**
+ * Groups of sections that hang together, as connected components. One group
+ * means the module is a single piece of bench work; more than one means some
+ * board is floating free — an authoring mistake now, and the test #96 phase 3
+ * needs before it can say whether dropping a section leaves the rest intact.
+ */
+declare function sectionComponents(ids: string[], adj: SectionAdjacency[]): string[][];
 /** 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, offsetA?: number, offsetB?: number): OutlineFace[];
 /**
@@ -920,4 +971,4 @@ declare function poseOverridesFromDoc(doc: ModuleSchematicDoc): Record<string, {
     heading: number;
 }>;
 
-export { type BenchworkPoint, type BranchConnector, type DrawCrossing, type DrawCrossover, type DrawIndustry, type DrawSignal, type DrawTrack, type DrawTurnout, type EditorBranch, type EditorControlPoint, type EditorCpSignal, type EditorCrossing, type EditorIndustry, type EditorState, type EditorTrack, type EditorTurnout, type EndplateBConfig, type EndplatePose, type EndplateWidthIssue, FREEMO_ENDPLATE_TRACK_FASCIA_CLEARANCE_INCHES, FREEMO_ENDPLATE_WIDTH_MIN_INCHES, FREEMO_ENDPLATE_WIDTH_RECOMMENDED_INCHES, FREEMO_TRACK_SPACING_INCHES, type GeometryType, type IndustryLabelMode, type IndustrySpot, MAIN2_TRACK_ID, MAIN_TRACK_ID, type ModuleFeatures, type ModuleFootprint, type ModuleFootprintInput, type ModuleGeometryInput, type ModuleSchematicDoc, type ModuleTrackRow, N_CAR_LENGTH_INCHES, N_SCALE_RATIO, type OutlineFace, type SchematicBlock, type SchematicControlPoint, type SchematicCrossing, type SchematicEndplate, type SchematicEndplateTrack, type SchematicIndustry, type SchematicSection, type SchematicSignal, type SchematicTrack, type SchematicTurnout, type SignalFacing, type SignalSide, type TrackConfig, type TrackRole, type TurnoutKind, asModuleSchematic, benchworkBand, benchworkOutline, buildCrossover, buildPassingSiding, buildTransition, carCapacity, checkEndplateWidth, deriveEndplatePoses, divergeSideForHand, docToState, emptyEditorState, endplateFaceSegments, endplateTrackOffsetFor, endplateTrackOffsetInches, endplateWidthInches, geometryTurnDegrees, inchesToScaleFeet, isLoopDoc, isTransitionTurnout, moduleCenterline, moduleFeatures, moduleFootprint, moduleLengthFromSections, moduleSections, nextId, poseNeedsManual, poseOverridesFromDoc, sampleBenchworkOutline, samplePath, scaleFeetToInches, sectionBreaksFromSections, sectionFootprints, sectionSpans, sectionedCenterline, stateToDoc, trackPath };
+export { type BenchworkPoint, type BranchConnector, type DrawCrossing, type DrawCrossover, type DrawIndustry, type DrawSignal, type DrawTrack, type DrawTurnout, type EditorBranch, type EditorControlPoint, type EditorCpSignal, type EditorCrossing, type EditorIndustry, type EditorState, type EditorTrack, type EditorTurnout, type EndplateBConfig, type EndplatePose, type EndplateWidthIssue, FREEMO_ENDPLATE_TRACK_FASCIA_CLEARANCE_INCHES, FREEMO_ENDPLATE_WIDTH_MIN_INCHES, FREEMO_ENDPLATE_WIDTH_RECOMMENDED_INCHES, FREEMO_TRACK_SPACING_INCHES, type GeometryType, type IndustryLabelMode, type IndustrySpot, MAIN2_TRACK_ID, MAIN_TRACK_ID, type ModuleFeatures, type ModuleFootprint, type ModuleFootprintInput, type ModuleGeometryInput, type ModuleSchematicDoc, type ModuleTrackRow, N_CAR_LENGTH_INCHES, N_SCALE_RATIO, type OutlineFace, type SchematicBlock, type SchematicControlPoint, type SchematicCrossing, type SchematicEndplate, type SchematicEndplateTrack, type SchematicIndustry, type SchematicSection, type SchematicSignal, type SchematicTrack, type SchematicTurnout, type SectionAdjacency, type SectionFootprint, type SignalFacing, type SignalSide, type TrackConfig, type TrackRole, type TurnoutKind, asModuleSchematic, benchworkBand, benchworkOutline, buildCrossover, buildPassingSiding, buildTransition, carCapacity, checkEndplateWidth, deriveEndplatePoses, divergeSideForHand, docToState, emptyEditorState, endplateFaceSegments, endplateTrackOffsetFor, endplateTrackOffsetInches, endplateWidthInches, geometryTurnDegrees, inchesToScaleFeet, isLoopDoc, isTransitionTurnout, moduleCenterline, moduleFeatures, moduleFootprint, moduleLengthFromSections, moduleSections, nextId, poseNeedsManual, poseOverridesFromDoc, sampleBenchworkOutline, samplePath, scaleFeetToInches, sectionAdjacency, sectionBand, sectionBreaksFromSections, sectionComponents, sectionFootprints, sectionNeighbours, sectionSpans, sectionedCenterline, sliceCenterline, stateToDoc, trackPath };

package/dist/index.d.ts

@@ -273,6 +273,18 @@ interface BenchworkPoint {
     bulge?: number;
 }
 /** One bench-work section of a module (#96 phase 2). */
+interface SectionFootprint {
+    id: string;
+    name?: string;
+    outline: {
+        x: number;
+        y: number;
+    }[];
+    /** True when this shape is DERIVED from the section's span rather than
+     * authored — a derived outline follows the board when it's resized, an
+     * authored one stays exactly as drawn (#96 phase 2b). */
+    derived: boolean;
+}
 interface SchematicSection {
     id: string;
     /** What the owner calls this board — "west transition", "double #3". */
@@ -314,14 +326,18 @@ declare function moduleSections(doc: {
  * bring in real clipping. */
 declare function sectionFootprints(doc: {
     sections?: SchematicSection[] | null;
-} | null | undefined): {
-    id: string;
-    name?: string;
-    outline: {
-        x: number;
-        y: number;
-    }[];
-}[];
+} | null | undefined, 
+/** The module's spine and dimensions. Given these, a section with no
+ * authored polygon gets a band derived from its own span, so every section
+ * has a shape and a resized board reshapes with it (#96 phase 2b). Omit to
+ * get authored outlines only. */
+derive?: {
+    centerline: BenchworkPoint[];
+    widthA: number;
+    widthB: number;
+    offsetA: number;
+    offsetB: number;
+}): SectionFootprint[];
 /**
  * Expand a benchwork outline (whose edges may be arcs) into a dense closed
  * polyline for rendering — the SAME sampling both the Repository preview and
@@ -387,17 +403,10 @@ interface ModuleFootprint {
     /** Authored outline (arc-sampled closed ring) or null → render the band.
      * Null too when `sectionOutlines` is non-empty — the sections ARE the shape. */
     outline: BenchworkPoint[] | null;
-    /** Per-section footprints, arc-sampled (#96 phase 2). Draw every one: together
+    /** Per-section footprints, arc-sampled (#96 phase 2b). Draw every one: together
      * they are the module's footprint. Empty = this module doesn't use sections,
      * so fall back to `outline ?? band` exactly as before. */
-    sectionOutlines: {
-        id: string;
-        name?: string;
-        outline: {
-            x: number;
-            y: number;
-        }[];
-    }[];
+    sectionOutlines: SectionFootprint[];
 }
 /** Module-local main track centre-line (A→B), sampling arcs for curves/corners.
  * An authored `mainPath` wins — the owner drew the real shape; otherwise the
@@ -434,6 +443,48 @@ declare function sectionedCenterline(doc: {
 } | null | undefined): BenchworkPoint[];
 /** Benchwork band: the centre-line offset ±half-width, tapering widthA→widthB. */
 declare function benchworkBand(center: BenchworkPoint[], widthA?: number, widthB?: number, offsetA?: number, offsetB?: number): BenchworkPoint[];
+/** The sub-polyline of a centre-line between two arc-length positions, with
+ * the cut ends interpolated so a slice starts and finishes exactly on them. */
+declare function sliceCenterline(center: BenchworkPoint[], fromPos: number, toPos: number): BenchworkPoint[];
+/** One section's bench-work as a band over its own stretch of centre-line —
+ * the per-section equivalent of `benchworkBand` (#96 phase 2b). Width and
+ * plate offset are interpolated from the module's ends exactly as the whole
+ * band does, so a section's derived shape lines up with its neighbours.
+ *
+ * This is what makes an outline BELONG to the section: a section without an
+ * authored polygon gets one derived from its span, so resizing the board
+ * reshapes it instead of leaving a hand-drawn outline stranded. */
+declare function sectionBand(center: BenchworkPoint[], fromPos: number, toPos: number, widthA?: number, widthB?: number, offsetA?: number, offsetB?: number): BenchworkPoint[];
+/** Two sections that physically meet, and how much edge they share. */
+interface SectionAdjacency {
+    a: string;
+    b: string;
+    /** Inches of shared edge — a butt joint across a 24″ board reads ~24. */
+    lengthInches: number;
+}
+/**
+ * Which sections physically MEET, derived from shared polygon edges rather
+ * than list order (#96 phase 2c).
+ *
+ * Order is the wrong model as soon as a module stops being a row of boards: a
+ * peninsula hangs off the BACK of a shallow band over part of its length, so
+ * it neighbours a board it isn't next to in any list. Geometry is the only
+ * thing that knows.
+ */
+declare function sectionAdjacency(footprints: SectionFootprint[], opts?: {
+    gapInches?: number;
+    angleDegrees?: number;
+    minOverlapInches?: number;
+}): SectionAdjacency[];
+/** The sections each one touches. */
+declare function sectionNeighbours(id: string, adj: SectionAdjacency[]): string[];
+/**
+ * Groups of sections that hang together, as connected components. One group
+ * means the module is a single piece of bench work; more than one means some
+ * board is floating free — an authoring mistake now, and the test #96 phase 3
+ * needs before it can say whether dropping a section leaves the rest intact.
+ */
+declare function sectionComponents(ids: string[], adj: SectionAdjacency[]): string[][];
 /** 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, offsetA?: number, offsetB?: number): OutlineFace[];
 /**
@@ -920,4 +971,4 @@ declare function poseOverridesFromDoc(doc: ModuleSchematicDoc): Record<string, {
     heading: number;
 }>;
 
-export { type BenchworkPoint, type BranchConnector, type DrawCrossing, type DrawCrossover, type DrawIndustry, type DrawSignal, type DrawTrack, type DrawTurnout, type EditorBranch, type EditorControlPoint, type EditorCpSignal, type EditorCrossing, type EditorIndustry, type EditorState, type EditorTrack, type EditorTurnout, type EndplateBConfig, type EndplatePose, type EndplateWidthIssue, FREEMO_ENDPLATE_TRACK_FASCIA_CLEARANCE_INCHES, FREEMO_ENDPLATE_WIDTH_MIN_INCHES, FREEMO_ENDPLATE_WIDTH_RECOMMENDED_INCHES, FREEMO_TRACK_SPACING_INCHES, type GeometryType, type IndustryLabelMode, type IndustrySpot, MAIN2_TRACK_ID, MAIN_TRACK_ID, type ModuleFeatures, type ModuleFootprint, type ModuleFootprintInput, type ModuleGeometryInput, type ModuleSchematicDoc, type ModuleTrackRow, N_CAR_LENGTH_INCHES, N_SCALE_RATIO, type OutlineFace, type SchematicBlock, type SchematicControlPoint, type SchematicCrossing, type SchematicEndplate, type SchematicEndplateTrack, type SchematicIndustry, type SchematicSection, type SchematicSignal, type SchematicTrack, type SchematicTurnout, type SignalFacing, type SignalSide, type TrackConfig, type TrackRole, type TurnoutKind, asModuleSchematic, benchworkBand, benchworkOutline, buildCrossover, buildPassingSiding, buildTransition, carCapacity, checkEndplateWidth, deriveEndplatePoses, divergeSideForHand, docToState, emptyEditorState, endplateFaceSegments, endplateTrackOffsetFor, endplateTrackOffsetInches, endplateWidthInches, geometryTurnDegrees, inchesToScaleFeet, isLoopDoc, isTransitionTurnout, moduleCenterline, moduleFeatures, moduleFootprint, moduleLengthFromSections, moduleSections, nextId, poseNeedsManual, poseOverridesFromDoc, sampleBenchworkOutline, samplePath, scaleFeetToInches, sectionBreaksFromSections, sectionFootprints, sectionSpans, sectionedCenterline, stateToDoc, trackPath };
+export { type BenchworkPoint, type BranchConnector, type DrawCrossing, type DrawCrossover, type DrawIndustry, type DrawSignal, type DrawTrack, type DrawTurnout, type EditorBranch, type EditorControlPoint, type EditorCpSignal, type EditorCrossing, type EditorIndustry, type EditorState, type EditorTrack, type EditorTurnout, type EndplateBConfig, type EndplatePose, type EndplateWidthIssue, FREEMO_ENDPLATE_TRACK_FASCIA_CLEARANCE_INCHES, FREEMO_ENDPLATE_WIDTH_MIN_INCHES, FREEMO_ENDPLATE_WIDTH_RECOMMENDED_INCHES, FREEMO_TRACK_SPACING_INCHES, type GeometryType, type IndustryLabelMode, type IndustrySpot, MAIN2_TRACK_ID, MAIN_TRACK_ID, type ModuleFeatures, type ModuleFootprint, type ModuleFootprintInput, type ModuleGeometryInput, type ModuleSchematicDoc, type ModuleTrackRow, N_CAR_LENGTH_INCHES, N_SCALE_RATIO, type OutlineFace, type SchematicBlock, type SchematicControlPoint, type SchematicCrossing, type SchematicEndplate, type SchematicEndplateTrack, type SchematicIndustry, type SchematicSection, type SchematicSignal, type SchematicTrack, type SchematicTurnout, type SectionAdjacency, type SectionFootprint, type SignalFacing, type SignalSide, type TrackConfig, type TrackRole, type TurnoutKind, asModuleSchematic, benchworkBand, benchworkOutline, buildCrossover, buildPassingSiding, buildTransition, carCapacity, checkEndplateWidth, deriveEndplatePoses, divergeSideForHand, docToState, emptyEditorState, endplateFaceSegments, endplateTrackOffsetFor, endplateTrackOffsetInches, endplateWidthInches, geometryTurnDegrees, inchesToScaleFeet, isLoopDoc, isTransitionTurnout, moduleCenterline, moduleFeatures, moduleFootprint, moduleLengthFromSections, moduleSections, nextId, poseNeedsManual, poseOverridesFromDoc, sampleBenchworkOutline, samplePath, scaleFeetToInches, sectionAdjacency, sectionBand, sectionBreaksFromSections, sectionComponents, sectionFootprints, sectionNeighbours, sectionSpans, sectionedCenterline, sliceCenterline, stateToDoc, trackPath };

package/dist/index.js

@@ -33,12 +33,26 @@ function moduleSections(doc) {
     };
   });
 }
-function sectionFootprints(doc) {
-  return moduleSections(doc).filter((sec) => sec.outline).map((sec) => ({
-    id: sec.id,
-    ...sec.name ? { name: sec.name } : {},
-    outline: sampleBenchworkOutline(sec.outline)
-  }));
+function sectionFootprints(doc, derive) {
+  const spans = derive ? sectionSpans(doc) : [];
+  const spanOf = new Map(spans.map((sp) => [sp.id, sp]));
+  return moduleSections(doc).map((sec) => {
+    const name = sec.name ? { name: sec.name } : {};
+    if (sec.outline)
+      return { id: sec.id, ...name, outline: sampleBenchworkOutline(sec.outline), derived: false };
+    const sp = spanOf.get(sec.id);
+    if (!sp || !derive) return null;
+    const band = sectionBand(
+      derive.centerline,
+      sp.fromPos,
+      sp.toPos,
+      derive.widthA,
+      derive.widthB,
+      derive.offsetA,
+      derive.offsetB
+    );
+    return band.length >= 3 ? { id: sec.id, ...name, outline: band, derived: true } : null;
+  }).filter((x) => x !== null);
 }
 function sampleBenchworkOutline(pts, segsPerArc = 20) {
   const n = pts.length;
@@ -254,6 +268,136 @@ function benchworkBand(center, widthA = FREEMO_ENDPLATE_WIDTH_RECOMMENDED_INCHES
   }));
   return [...left, ...right.reverse()];
 }
+function sliceCenterline(center, fromPos, toPos) {
+  if (center.length < 2) return [];
+  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];
+  const a = Math.max(0, Math.min(total, Math.min(fromPos, toPos)));
+  const b = Math.max(0, Math.min(total, Math.max(fromPos, toPos)));
+  if (b - a <= 0) return [];
+  const at = (d) => {
+    for (let i = 1; i < center.length; i++) {
+      if (d <= cum[i] || i === center.length - 1) {
+        const seg = cum[i] - cum[i - 1] || 1;
+        const t = Math.max(0, Math.min(1, (d - cum[i - 1]) / seg));
+        return {
+          x: center[i - 1].x + (center[i].x - center[i - 1].x) * t,
+          y: center[i - 1].y + (center[i].y - center[i - 1].y) * t
+        };
+      }
+    }
+    return center[center.length - 1];
+  };
+  const out = [at(a)];
+  for (let i = 0; i < center.length; i++) {
+    if (cum[i] > a && cum[i] < b) out.push({ x: center[i].x, y: center[i].y });
+  }
+  out.push(at(b));
+  return out;
+}
+function sectionBand(center, fromPos, toPos, widthA = FREEMO_ENDPLATE_WIDTH_RECOMMENDED_INCHES, widthB = FREEMO_ENDPLATE_WIDTH_RECOMMENDED_INCHES, offsetA = 0, offsetB = 0) {
+  const slice = sliceCenterline(center, fromPos, toPos);
+  if (slice.length < 2) return [];
+  let total = 0;
+  for (let i = 1; i < center.length; i++)
+    total += Math.hypot(center[i].x - center[i - 1].x, center[i].y - center[i - 1].y);
+  total = total || 1;
+  const lo = Math.min(fromPos, toPos);
+  let acc = 0;
+  const fr = [0];
+  for (let i = 1; i < slice.length; i++) {
+    acc += Math.hypot(slice[i].x - slice[i - 1].x, slice[i].y - slice[i - 1].y);
+    fr.push(acc);
+  }
+  const f = fr.map((d) => Math.max(0, Math.min(1, (lo + d) / total)));
+  const n = centerlineNormals(slice);
+  const half = (i) => (widthA * (1 - f[i]) + widthB * f[i]) / 2;
+  const off = (i) => offsetA * (1 - f[i]) + offsetB * f[i];
+  const left = slice.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 = slice.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 ringEdges(pts) {
+  const out = [];
+  for (let i = 0; i < pts.length; i++) out.push([pts[i], pts[(i + 1) % pts.length]]);
+  return out;
+}
+function sharedEdgeLength(e1, e2, gap, angleDeg) {
+  const ux = e1[1].x - e1[0].x;
+  const uy = e1[1].y - e1[0].y;
+  const ul = Math.hypot(ux, uy);
+  const vx = e2[1].x - e2[0].x;
+  const vy = e2[1].y - e2[0].y;
+  const vl = Math.hypot(vx, vy);
+  if (ul < 1e-6 || vl < 1e-6) return 0;
+  const dx = ux / ul;
+  const dy = uy / ul;
+  const cross = Math.abs((dx * vy - dy * vx) / vl);
+  if (cross > Math.sin(angleDeg * Math.PI / 180)) return 0;
+  const perp = (q) => Math.abs((q.x - e1[0].x) * -dy + (q.y - e1[0].y) * dx);
+  if (perp(e2[0]) > gap || perp(e2[1]) > gap) return 0;
+  const proj = (q) => (q.x - e1[0].x) * dx + (q.y - e1[0].y) * dy;
+  const t1 = proj(e2[0]);
+  const t2 = proj(e2[1]);
+  return Math.max(0, Math.min(ul, Math.max(t1, t2)) - Math.max(0, Math.min(t1, t2)));
+}
+function sectionAdjacency(footprints, opts) {
+  const gap = opts?.gapInches ?? 0.5;
+  const angle = opts?.angleDegrees ?? 3;
+  const min = opts?.minOverlapInches ?? 1;
+  const edges = footprints.map((f) => ringEdges(f.outline));
+  const out = [];
+  for (let i = 0; i < footprints.length; i++) {
+    for (let j = i + 1; j < footprints.length; j++) {
+      let total = 0;
+      for (const e1 of edges[i])
+        for (const e2 of edges[j]) total += sharedEdgeLength(e1, e2, gap, angle);
+      if (total >= min)
+        out.push({
+          a: footprints[i].id,
+          b: footprints[j].id,
+          lengthInches: Math.round(total * 1e3) / 1e3
+        });
+    }
+  }
+  return out;
+}
+function sectionNeighbours(id, adj) {
+  return adj.filter((x) => x.a === id || x.b === id).map((x) => x.a === id ? x.b : x.a);
+}
+function sectionComponents(ids, adj) {
+  const parent = new Map(ids.map((id) => [id, id]));
+  const find = (x) => {
+    let r = x;
+    while (parent.get(r) !== r) r = parent.get(r);
+    while (parent.get(x) !== r) {
+      const nx = parent.get(x);
+      parent.set(x, r);
+      x = nx;
+    }
+    return r;
+  };
+  for (const { a, b } of adj) {
+    if (!parent.has(a) || !parent.has(b)) continue;
+    const ra = find(a);
+    const rb = find(b);
+    if (ra !== rb) parent.set(ra, rb);
+  }
+  const groups = /* @__PURE__ */ new Map();
+  for (const id of ids) {
+    const r = find(id);
+    groups.set(r, [...groups.get(r) ?? [], id]);
+  }
+  return [...groups.values()];
+}
 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);
@@ -271,7 +415,13 @@ function moduleFootprint(input) {
   const authored = benchworkOutline(input);
   const offA = input.endplateTrackOffsets?.["A"] ?? 0;
   const offB = input.endplateTrackOffsets?.["B"] ?? 0;
-  const sectionOutlines = sectionFootprints(input);
+  const sectionOutlines = sectionFootprints(input, {
+    centerline,
+    widthA,
+    widthB,
+    offsetA: offA,
+    offsetB: offB
+  });
   return {
     centerline,
     band: benchworkBand(centerline, widthA, widthB, offA, offB),
@@ -1192,6 +1342,6 @@ function poseOverridesFromDoc(doc) {
   return out;
 }
 
-export { FREEMO_ENDPLATE_TRACK_FASCIA_CLEARANCE_INCHES, FREEMO_ENDPLATE_WIDTH_MIN_INCHES, FREEMO_ENDPLATE_WIDTH_RECOMMENDED_INCHES, FREEMO_TRACK_SPACING_INCHES, MAIN2_TRACK_ID, MAIN_TRACK_ID, N_CAR_LENGTH_INCHES, N_SCALE_RATIO, asModuleSchematic, benchworkBand, benchworkOutline, buildCrossover, buildPassingSiding, buildTransition, carCapacity, checkEndplateWidth, deriveEndplatePoses, divergeSideForHand, docToState, emptyEditorState, endplateFaceSegments, endplateTrackOffsetFor, endplateTrackOffsetInches, endplateWidthInches, geometryTurnDegrees, inchesToScaleFeet, isLoopDoc, isTransitionTurnout, moduleCenterline, moduleFeatures, moduleFootprint, moduleLengthFromSections, moduleSections, nextId, poseNeedsManual, poseOverridesFromDoc, sampleBenchworkOutline, samplePath, scaleFeetToInches, sectionBreaksFromSections, sectionFootprints, sectionSpans, sectionedCenterline, stateToDoc, trackPath };
+export { FREEMO_ENDPLATE_TRACK_FASCIA_CLEARANCE_INCHES, FREEMO_ENDPLATE_WIDTH_MIN_INCHES, FREEMO_ENDPLATE_WIDTH_RECOMMENDED_INCHES, FREEMO_TRACK_SPACING_INCHES, MAIN2_TRACK_ID, MAIN_TRACK_ID, N_CAR_LENGTH_INCHES, N_SCALE_RATIO, asModuleSchematic, benchworkBand, benchworkOutline, buildCrossover, buildPassingSiding, buildTransition, carCapacity, checkEndplateWidth, deriveEndplatePoses, divergeSideForHand, docToState, emptyEditorState, endplateFaceSegments, endplateTrackOffsetFor, endplateTrackOffsetInches, endplateWidthInches, geometryTurnDegrees, inchesToScaleFeet, isLoopDoc, isTransitionTurnout, moduleCenterline, moduleFeatures, moduleFootprint, moduleLengthFromSections, moduleSections, nextId, poseNeedsManual, poseOverridesFromDoc, sampleBenchworkOutline, samplePath, scaleFeetToInches, sectionAdjacency, sectionBand, sectionBreaksFromSections, sectionComponents, sectionFootprints, sectionNeighbours, sectionSpans, sectionedCenterline, sliceCenterline, stateToDoc, trackPath };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map