@willcgage/module-schematic 0.28.1 → 0.30.0

package/dist/index.d.cts

@@ -240,8 +240,22 @@ interface ModuleSchematicDoc {
     outline?: BenchworkPoint[];
     /** Internal section joints — inches from endplate A where the module's boards
      * split into sections. Operationally one unit; these mark construction/transport
-     * seams (exempt from the end-interface standards). Empty/absent = one section. */
+     * seams (exempt from the end-interface standards). Empty/absent = one section.
+     * Describes only sections that are full-depth SLICES; a section with a shape
+     * of its own lives in `sections` below. */
     sectionBreaks?: number[];
+    /** The module's sections as real objects — named, each with a bench-work
+     * outline of its own (#96 phase 2). A module is a kit: the same sections can
+     * be set up in different combinations, so its footprint is the UNION of the
+     * sections present rather than an independently authored shape.
+     *
+     * Needed because sections are not slices. Real modules hang a deep section
+     * off the BACK of a shallow main band — a peninsula carrying an industry —
+     * which no single position along the main can describe.
+     *
+     * Absent = the module keeps using its own `outline` exactly as before; this
+     * is purely additive and nothing migrates on read. */
+    sections?: SchematicSection[];
     /** @deprecated pre-grouping flat signals; read for back-compat. */
     signals?: SchematicSignal[];
     /** Authored mainline centre-line (module-local inches, open path with arcs).
@@ -258,12 +272,56 @@ interface BenchworkPoint {
     y: number;
     bulge?: number;
 }
+/** One bench-work section of a module (#96 phase 2). */
+interface SchematicSection {
+    id: string;
+    /** What the owner calls this board — "west transition", "double #3". */
+    name?: string | null;
+    /** This section's own footprint polygon, module-local inches, same frame as
+     * the module outline. Absent = the section has no shape of its own yet (it's
+     * described only by the joints in `sectionBreaks`). */
+    outline?: BenchworkPoint[] | null;
+    /** How far this board runs along the main, inches. The module's length is the
+     * SUM of these — it isn't authored separately (#108). */
+    lengthInches?: number | null;
+    /** This board's own shape: straight | curve | corner_45 | corner_90 | offset |
+     * dead_end. Geometry belongs to the SECTION, not the module — a module like
+     * One Mile is 384″ of mostly-straight boards with two 24″ CURVED sections in
+     * the middle, which no single module-level geometry can describe (#108).
+     * Absent = straight. */
+    geometryType?: string | null;
+    /** Degrees turned, for curve/corner sections. */
+    geometryDegrees?: number | null;
+    /** Lateral jog, for offset sections. */
+    geometryOffsetInches?: number | null;
+}
 /** The authored benchwork outline, or null when a module hasn't drawn one
  * (renderers then fall back to a band derived from the endplate widths). A
  * valid outline needs at least 3 points. Normalises each vertex to {x, y, bulge?}. */
 declare function benchworkOutline(doc: {
     outline?: BenchworkPoint[] | null;
 } | null | undefined): BenchworkPoint[] | null;
+/** The module's sections, normalised — id required, name trimmed away when
+ * blank, outline kept only when it's a usable polygon (#96 phase 2). */
+declare function moduleSections(doc: {
+    sections?: SchematicSection[] | null;
+} | null | undefined): SchematicSection[];
+/** Every section outline that's actually a shape, arc-sampled for drawing.
+ * Drawing all of them IS the module's footprint — the union of its sections.
+ * No polygon boolean is computed: a renderer painting each ring gives the same
+ * picture, and an approximate union would be worse than none. If something
+ * ever needs a single ring (an export, a collision test), that's the point to
+ * bring in real clipping. */
+declare function sectionFootprints(doc: {
+    sections?: SchematicSection[] | null;
+} | null | undefined): {
+    id: string;
+    name?: string;
+    outline: {
+        x: number;
+        y: number;
+    }[];
+}[];
 /**
  * Expand a benchwork outline (whose edges may be arcs) into a dense closed
  * polyline for rendering — the SAME sampling both the Repository preview and
@@ -305,6 +363,9 @@ interface ModuleFootprintInput {
     endplateTrackOffsets?: Record<string, number>;
     /** Authored benchwork outline (module-local inches), or absent for the band. */
     outline?: BenchworkPoint[] | null;
+    /** The module's sections (#96 phase 2). When any carries an outline, the
+     * module's footprint is the union of those — `outline` is then ignored. */
+    sections?: SchematicSection[] | null;
     /** Authored mainline centre-line (module-local inches, open path with arcs).
      * When present it wins over the geometry-derived centre-line — the owner drew
      * the real shape (#2d-track, physical view only). */
@@ -323,13 +384,54 @@ interface ModuleFootprint {
     band: BenchworkPoint[];
     /** Endplate faces: [A end, B end]. */
     endplateFaces: OutlineFace[];
-    /** Authored outline (arc-sampled closed ring) or null → render the band. */
+    /** 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
+     * 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;
+        }[];
+    }[];
 }
 /** 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
  * centre-line is derived from the geometry fields (length + type/degrees/offset). */
 declare function moduleCenterline(input: ModuleFootprintInput): BenchworkPoint[];
+/** The module's length as the SUM of its sections, or null when it has none
+ * (then the authored module length still speaks). */
+declare function moduleLengthFromSections(doc: {
+    sections?: SchematicSection[] | null;
+} | null | undefined): number | null;
+/** Where each section starts and ends along the main, inches from endplate A.
+ * This is what `sectionBreaks` used to author by hand — now derived, so a
+ * length is just a number you type and nothing steals from its neighbour. */
+declare function sectionSpans(doc: {
+    sections?: SchematicSection[] | null;
+} | null | undefined): {
+    id: string;
+    name?: string;
+    fromPos: number;
+    toPos: number;
+}[];
+/** The joints implied by the sections — the interior boundaries, in inches from
+ * endplate A. Replaces the authored `sectionBreaks` for a sectioned module. */
+declare function sectionBreaksFromSections(doc: {
+    sections?: SchematicSection[] | null;
+} | null | undefined): number[];
+/** The module's centre-line built by CHAINING its sections — each board starts
+ * where the previous one ended, at the heading it ended on. This is what makes
+ * a module like One Mile expressible: straight boards with two 24″ curved ones
+ * in the middle, which no single module-level geometry can describe (#108).
+ * Returns [] when the module has no sections with lengths. */
+declare function sectionedCenterline(doc: {
+    sections?: SchematicSection[] | null;
+} | 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 two endplate faces (the band's flat ends): [A end at widthA, B end at widthB]. */
@@ -531,6 +633,9 @@ interface EditorState {
     /** Internal section joints — inches from endplate A where the boards split
      * into sections. Empty = a single section (#48). */
     sectionBreaks: number[];
+    /** The module's sections as named objects, each optionally carrying its own
+     * outline (#96 phase 2). Empty = fall back to `outline` + `sectionBreaks`. */
+    sections: SchematicSection[];
     controlPoints: EditorControlPoint[];
     /** Rail-served industries — car-spot spans on a track (#industries). */
     industries: EditorIndustry[];
@@ -815,4 +920,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 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, nextId, poseNeedsManual, poseOverridesFromDoc, sampleBenchworkOutline, samplePath, scaleFeetToInches, 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 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 };

package/dist/index.d.ts

@@ -240,8 +240,22 @@ interface ModuleSchematicDoc {
     outline?: BenchworkPoint[];
     /** Internal section joints — inches from endplate A where the module's boards
      * split into sections. Operationally one unit; these mark construction/transport
-     * seams (exempt from the end-interface standards). Empty/absent = one section. */
+     * seams (exempt from the end-interface standards). Empty/absent = one section.
+     * Describes only sections that are full-depth SLICES; a section with a shape
+     * of its own lives in `sections` below. */
     sectionBreaks?: number[];
+    /** The module's sections as real objects — named, each with a bench-work
+     * outline of its own (#96 phase 2). A module is a kit: the same sections can
+     * be set up in different combinations, so its footprint is the UNION of the
+     * sections present rather than an independently authored shape.
+     *
+     * Needed because sections are not slices. Real modules hang a deep section
+     * off the BACK of a shallow main band — a peninsula carrying an industry —
+     * which no single position along the main can describe.
+     *
+     * Absent = the module keeps using its own `outline` exactly as before; this
+     * is purely additive and nothing migrates on read. */
+    sections?: SchematicSection[];
     /** @deprecated pre-grouping flat signals; read for back-compat. */
     signals?: SchematicSignal[];
     /** Authored mainline centre-line (module-local inches, open path with arcs).
@@ -258,12 +272,56 @@ interface BenchworkPoint {
     y: number;
     bulge?: number;
 }
+/** One bench-work section of a module (#96 phase 2). */
+interface SchematicSection {
+    id: string;
+    /** What the owner calls this board — "west transition", "double #3". */
+    name?: string | null;
+    /** This section's own footprint polygon, module-local inches, same frame as
+     * the module outline. Absent = the section has no shape of its own yet (it's
+     * described only by the joints in `sectionBreaks`). */
+    outline?: BenchworkPoint[] | null;
+    /** How far this board runs along the main, inches. The module's length is the
+     * SUM of these — it isn't authored separately (#108). */
+    lengthInches?: number | null;
+    /** This board's own shape: straight | curve | corner_45 | corner_90 | offset |
+     * dead_end. Geometry belongs to the SECTION, not the module — a module like
+     * One Mile is 384″ of mostly-straight boards with two 24″ CURVED sections in
+     * the middle, which no single module-level geometry can describe (#108).
+     * Absent = straight. */
+    geometryType?: string | null;
+    /** Degrees turned, for curve/corner sections. */
+    geometryDegrees?: number | null;
+    /** Lateral jog, for offset sections. */
+    geometryOffsetInches?: number | null;
+}
 /** The authored benchwork outline, or null when a module hasn't drawn one
  * (renderers then fall back to a band derived from the endplate widths). A
  * valid outline needs at least 3 points. Normalises each vertex to {x, y, bulge?}. */
 declare function benchworkOutline(doc: {
     outline?: BenchworkPoint[] | null;
 } | null | undefined): BenchworkPoint[] | null;
+/** The module's sections, normalised — id required, name trimmed away when
+ * blank, outline kept only when it's a usable polygon (#96 phase 2). */
+declare function moduleSections(doc: {
+    sections?: SchematicSection[] | null;
+} | null | undefined): SchematicSection[];
+/** Every section outline that's actually a shape, arc-sampled for drawing.
+ * Drawing all of them IS the module's footprint — the union of its sections.
+ * No polygon boolean is computed: a renderer painting each ring gives the same
+ * picture, and an approximate union would be worse than none. If something
+ * ever needs a single ring (an export, a collision test), that's the point to
+ * bring in real clipping. */
+declare function sectionFootprints(doc: {
+    sections?: SchematicSection[] | null;
+} | null | undefined): {
+    id: string;
+    name?: string;
+    outline: {
+        x: number;
+        y: number;
+    }[];
+}[];
 /**
  * Expand a benchwork outline (whose edges may be arcs) into a dense closed
  * polyline for rendering — the SAME sampling both the Repository preview and
@@ -305,6 +363,9 @@ interface ModuleFootprintInput {
     endplateTrackOffsets?: Record<string, number>;
     /** Authored benchwork outline (module-local inches), or absent for the band. */
     outline?: BenchworkPoint[] | null;
+    /** The module's sections (#96 phase 2). When any carries an outline, the
+     * module's footprint is the union of those — `outline` is then ignored. */
+    sections?: SchematicSection[] | null;
     /** Authored mainline centre-line (module-local inches, open path with arcs).
      * When present it wins over the geometry-derived centre-line — the owner drew
      * the real shape (#2d-track, physical view only). */
@@ -323,13 +384,54 @@ interface ModuleFootprint {
     band: BenchworkPoint[];
     /** Endplate faces: [A end, B end]. */
     endplateFaces: OutlineFace[];
-    /** Authored outline (arc-sampled closed ring) or null → render the band. */
+    /** 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
+     * 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;
+        }[];
+    }[];
 }
 /** 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
  * centre-line is derived from the geometry fields (length + type/degrees/offset). */
 declare function moduleCenterline(input: ModuleFootprintInput): BenchworkPoint[];
+/** The module's length as the SUM of its sections, or null when it has none
+ * (then the authored module length still speaks). */
+declare function moduleLengthFromSections(doc: {
+    sections?: SchematicSection[] | null;
+} | null | undefined): number | null;
+/** Where each section starts and ends along the main, inches from endplate A.
+ * This is what `sectionBreaks` used to author by hand — now derived, so a
+ * length is just a number you type and nothing steals from its neighbour. */
+declare function sectionSpans(doc: {
+    sections?: SchematicSection[] | null;
+} | null | undefined): {
+    id: string;
+    name?: string;
+    fromPos: number;
+    toPos: number;
+}[];
+/** The joints implied by the sections — the interior boundaries, in inches from
+ * endplate A. Replaces the authored `sectionBreaks` for a sectioned module. */
+declare function sectionBreaksFromSections(doc: {
+    sections?: SchematicSection[] | null;
+} | null | undefined): number[];
+/** The module's centre-line built by CHAINING its sections — each board starts
+ * where the previous one ended, at the heading it ended on. This is what makes
+ * a module like One Mile expressible: straight boards with two 24″ curved ones
+ * in the middle, which no single module-level geometry can describe (#108).
+ * Returns [] when the module has no sections with lengths. */
+declare function sectionedCenterline(doc: {
+    sections?: SchematicSection[] | null;
+} | 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 two endplate faces (the band's flat ends): [A end at widthA, B end at widthB]. */
@@ -531,6 +633,9 @@ interface EditorState {
     /** Internal section joints — inches from endplate A where the boards split
      * into sections. Empty = a single section (#48). */
     sectionBreaks: number[];
+    /** The module's sections as named objects, each optionally carrying its own
+     * outline (#96 phase 2). Empty = fall back to `outline` + `sectionBreaks`. */
+    sections: SchematicSection[];
     controlPoints: EditorControlPoint[];
     /** Rail-served industries — car-spot spans on a track (#industries). */
     industries: EditorIndustry[];
@@ -815,4 +920,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 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, nextId, poseNeedsManual, poseOverridesFromDoc, sampleBenchworkOutline, samplePath, scaleFeetToInches, 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 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 };

package/dist/index.js

@@ -15,6 +15,31 @@ function benchworkOutline(doc) {
   }));
   return pts.length >= 3 ? pts : null;
 }
+function moduleSections(doc) {
+  return (doc?.sections ?? []).filter((sec) => sec && typeof sec.id === "string" && sec.id !== "").map((sec) => {
+    const outline = benchworkOutline({ outline: sec.outline });
+    const name = typeof sec.name === "string" ? sec.name.trim() : "";
+    const len = sec.lengthInches;
+    const deg = sec.geometryDegrees;
+    const off = sec.geometryOffsetInches;
+    return {
+      id: sec.id,
+      ...name ? { name } : {},
+      ...outline ? { outline } : {},
+      ...typeof len === "number" && Number.isFinite(len) && len > 0 ? { lengthInches: len } : {},
+      ...sec.geometryType ? { geometryType: sec.geometryType } : {},
+      ...typeof deg === "number" && Number.isFinite(deg) ? { geometryDegrees: deg } : {},
+      ...typeof off === "number" && Number.isFinite(off) ? { geometryOffsetInches: off } : {}
+    };
+  });
+}
+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 sampleBenchworkOutline(pts, segsPerArc = 20) {
   const n = pts.length;
   if (n < 2) return pts.map((p) => ({ x: p.x, y: p.y }));
@@ -108,6 +133,8 @@ var DEG_FP = Math.PI / 180;
 function moduleCenterline(input) {
   const drawn = trackPath(input.mainPath);
   if (drawn) return samplePath(drawn);
+  const chained = sectionedCenterline(input);
+  if (chained.length >= 2) return chained;
   if (!input.geometryType) return [];
   const L = input.lengthInches > 0 ? input.lengthInches : 24;
   const gt = input.geometryType;
@@ -125,6 +152,73 @@ function moduleCenterline(input) {
   }
   return pts;
 }
+function sectionCenterlineLocal(sec) {
+  const L = typeof sec.lengthInches === "number" && sec.lengthInches > 0 ? sec.lengthInches : 0;
+  const gt = sec.geometryType || "straight";
+  if (L <= 0) return { points: [{ x: 0, y: 0 }], endX: 0, endY: 0, endHeadingDeg: 0 };
+  if (gt === "offset") {
+    const dy = sec.geometryOffsetInches ?? 0;
+    return { points: [{ x: 0, y: 0 }, { x: L, y: dy }], endX: L, endY: dy, endHeadingDeg: 0 };
+  }
+  const turn = gt === "corner_45" ? 45 : gt === "corner_90" ? 90 : gt === "curve" ? sec.geometryDegrees ?? 0 : 0;
+  if (turn === 0) return { points: [{ x: 0, y: 0 }, { x: L, y: 0 }], endX: L, endY: 0, endHeadingDeg: 0 };
+  const t = turn * DEG_FP;
+  const r = L / t;
+  const steps = 12;
+  const points = [];
+  for (let i = 0; i <= steps; i++) {
+    const a = t * i / steps;
+    points.push({ x: r * Math.sin(a), y: r * (1 - Math.cos(a)) });
+  }
+  const last = points[points.length - 1];
+  return { points, endX: last.x, endY: last.y, endHeadingDeg: turn };
+}
+function moduleLengthFromSections(doc) {
+  const secs = moduleSections(doc).filter(
+    (sec) => typeof sec.lengthInches === "number" && sec.lengthInches > 0
+  );
+  if (!secs.length) return null;
+  return secs.reduce((a, sec) => a + sec.lengthInches, 0);
+}
+function sectionSpans(doc) {
+  let acc = 0;
+  const out = [];
+  for (const sec of moduleSections(doc)) {
+    const L = typeof sec.lengthInches === "number" && sec.lengthInches > 0 ? sec.lengthInches : 0;
+    if (L <= 0) continue;
+    out.push({ id: sec.id, ...sec.name ? { name: sec.name } : {}, fromPos: acc, toPos: acc + L });
+    acc += L;
+  }
+  return out;
+}
+function sectionBreaksFromSections(doc) {
+  const spans = sectionSpans(doc);
+  return spans.slice(0, -1).map((sp) => sp.toPos);
+}
+function sectionedCenterline(doc) {
+  const secs = moduleSections(doc).filter(
+    (sec) => typeof sec.lengthInches === "number" && sec.lengthInches > 0
+  );
+  if (!secs.length) return [];
+  const out = [];
+  let ox = 0;
+  let oy = 0;
+  let heading = 0;
+  for (const sec of secs) {
+    const local = sectionCenterlineLocal(sec);
+    const c = Math.cos(heading * DEG_FP);
+    const sn = Math.sin(heading * DEG_FP);
+    for (let i = 0; i < local.points.length; i++) {
+      if (i === 0 && out.length) continue;
+      const p = local.points[i];
+      out.push({ x: ox + p.x * c - p.y * sn, y: oy + p.x * sn + p.y * c });
+    }
+    ox += local.endX * c - local.endY * sn;
+    oy += local.endX * sn + local.endY * c;
+    heading += local.endHeadingDeg;
+  }
+  return out;
+}
 function centerlineNormals(center) {
   return center.map((_, i) => {
     const a = center[Math.max(0, i - 1)];
@@ -177,11 +271,13 @@ function moduleFootprint(input) {
   const authored = benchworkOutline(input);
   const offA = input.endplateTrackOffsets?.["A"] ?? 0;
   const offB = input.endplateTrackOffsets?.["B"] ?? 0;
+  const sectionOutlines = sectionFootprints(input);
   return {
     centerline,
     band: benchworkBand(centerline, widthA, widthB, offA, offB),
     endplateFaces: endplateFaceSegments(centerline, widthA, widthB, offA, offB),
-    outline: authored ? sampleBenchworkOutline(authored) : null
+    outline: sectionOutlines.length || !authored ? null : sampleBenchworkOutline(authored),
+    sectionOutlines
   };
 }
 function endplateTrackOffsetFor(config, authoredTrackOffset) {
@@ -262,6 +358,7 @@ function emptyEditorState(lengthInches) {
     endplateTrackOffsets: {},
     outline: [],
     sectionBreaks: [],
+    sections: [],
     controlPoints: [],
     industries: [],
     mainPath: []
@@ -485,6 +582,9 @@ function stateToDoc(state, recordNumber) {
     ...state.outline.length >= 3 ? { outline: state.outline } : {},
     // Internal section joints (inches from A), when the module has more than one.
     ...state.sectionBreaks.length ? { sectionBreaks: state.sectionBreaks } : {},
+    // Sections as objects — emitted only once the owner has some, so a module
+    // that never used them keeps exactly the doc it had before (#96 phase 2).
+    ...state.sections.length ? { sections: moduleSections({ sections: state.sections }) } : {},
     // Authored mainline path (module-local inches); only when it's a real path.
     ...state.mainPath.length >= 2 ? { mainPath: state.mainPath } : {}
   };
@@ -590,6 +690,7 @@ function docToState(doc, fallbackLength, moduleTracks = []) {
     endplateTrackOffsets,
     outline,
     sectionBreaks: (d.sectionBreaks ?? []).filter((n) => Number.isFinite(n)).map((n) => sc(n)),
+    sections: moduleSections(d),
     mainPath,
     crossings: (d.crossings ?? []).map((x) => ({
       id: x.id,
@@ -1091,6 +1192,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, nextId, poseNeedsManual, poseOverridesFromDoc, sampleBenchworkOutline, samplePath, scaleFeetToInches, 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, sectionBreaksFromSections, sectionFootprints, sectionSpans, sectionedCenterline, stateToDoc, trackPath };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map