@willcgage/module-schematic 0.17.0 → 0.19.0

package/dist/index.d.cts

@@ -78,6 +78,11 @@ interface SchematicTrack {
      * endplate A (past the throat = in the loop), lane is the ladder/arc index —
      * one record drives both the unrolled fan and a geometric render. */
     inLoop?: boolean;
+    /** Authored 2-D path for this track (module-local inches, open path with
+     * arcs) — the PHYSICAL shape a bent/rotated spur draws. Absent = derive from
+     * the main centre-line + lane, as before. Physical view only; the operations
+     * view stays positional (#2d-track). */
+    path?: BenchworkPoint[] | null;
 }
 interface SchematicTurnout {
     id: string;
@@ -132,6 +137,35 @@ interface SchematicControlPoint {
     crossings?: string[];
     signals?: SchematicSignal[];
 }
+/** What a rendered industry shows beside its name: a car count, a length in
+ * inches, or nothing (name only). Authored per industry. */
+type IndustryLabelMode = "none" | "cars" | "inches";
+/**
+ * An industry — a rail-served customer that spots cars, authored as a SPAN on a
+ * track (a spur/siding, or the main). Positional like everything else: it lives
+ * in the same module-local inch frame and is rendered into the shared 2-D view,
+ * offset to `side`. The span length gives its car capacity; the dispatcher and
+ * crews read where cars set out. Mirrors a `freemon_industries` row.
+ */
+interface SchematicIndustry {
+    id: string;
+    name: string;
+    /** Industry type value from the lookup (e.g. "team_track", "grain"). */
+    type?: string | null;
+    /** The track this industry spots cars on (a spur/siding id, or the main). */
+    track: string;
+    /** The car-spot span along that track, inches from endplate A. */
+    fromPos: number;
+    toPos: number;
+    /** Which side of the track the building + label sit on. */
+    side?: SignalSide;
+    /** Secondary readout at the label — a car count, a length, or none. */
+    labelMode?: IndustryLabelMode;
+    /** Car types this industry receives (car-type value strings). */
+    carTypes?: string[];
+    /** The `freemon_industries` row this is (single source of truth); null = new. */
+    moduleIndustryId?: number | null;
+}
 interface ModuleSchematicDoc {
     version: number;
     module?: string;
@@ -156,6 +190,8 @@ interface ModuleSchematicDoc {
     /** Grade crossings / diamonds (#170). */
     crossings?: SchematicCrossing[];
     controlPoints?: SchematicControlPoint[];
+    /** Rail-served industries — car-spot spans on a track (#industries). */
+    industries?: SchematicIndustry[];
     /** Benchwork FOOTPRINT outline — the module's physical board shape as a
      * polygon in module-local inches, in the same frame as the endplate poses
      * (endplate A's track point at the origin, the mainline along +x, perpendicular
@@ -164,6 +200,10 @@ interface ModuleSchematicDoc {
     outline?: BenchworkPoint[];
     /** @deprecated pre-grouping flat signals; read for back-compat. */
     signals?: SchematicSignal[];
+    /** Authored mainline centre-line (module-local inches, open path with arcs).
+     * Present = the owner drew the real shape; absent = derive from geometry.
+     * Physical view only — the operations view stays derived (#2d-track). */
+    mainPath?: BenchworkPoint[] | null;
 }
 /** A benchwork-outline vertex, module-local inches. The edge from this vertex
  * to the NEXT one is a straight line, unless `bulge` is set — then it's a
@@ -191,6 +231,19 @@ declare function sampleBenchworkOutline(pts: BenchworkPoint[], segsPerArc?: numb
     x: number;
     y: number;
 }[];
+/**
+ * Expand an OPEN track path (whose edges may be arcs) into a dense polyline —
+ * the open-ended sibling of sampleBenchworkOutline (which closes the ring).
+ * Used for authored track centre-lines (a drawn mainline or spur). The final
+ * vertex is always emitted so the path reaches its end.
+ */
+declare function samplePath(pts: BenchworkPoint[], segsPerArc?: number): {
+    x: number;
+    y: number;
+}[];
+/** Normalise an authored track path from a doc, or null if it isn't a real path
+ * (needs ≥ 2 valid points). Keeps per-vertex bulge. */
+declare function trackPath(path: BenchworkPoint[] | null | undefined): BenchworkPoint[] | null;
 interface ModuleFootprintInput {
     /** Mainline length (falls back to footprint length), inches. */
     lengthInches: number;
@@ -201,6 +254,10 @@ interface ModuleFootprintInput {
     endplateWidths?: Record<string, number>;
     /** Authored benchwork outline (module-local inches), or absent for the band. */
     outline?: BenchworkPoint[] | 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). */
+    mainPath?: BenchworkPoint[] | null;
 }
 interface OutlineFace {
     /** The endplate face's two corners + midpoint (the track point). */
@@ -218,7 +275,9 @@ interface ModuleFootprint {
     /** 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. */
+/** 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[];
 /** Benchwork band: the centre-line offset ±half-width, tapering widthA→widthB. */
 declare function benchworkBand(center: BenchworkPoint[], widthA?: number, widthB?: number): BenchworkPoint[];
@@ -243,6 +302,13 @@ declare const N_SCALE_RATIO = 160;
 declare function inchesToScaleFeet(inches: number, ratio?: number): number;
 /** Scale feet of prototype track → real inches on the module. */
 declare function scaleFeetToInches(feet: number, ratio?: number): number;
+/** Length a spotted car occupies on N-scale track, inches. A 40-ft car body is
+ * ~3.0″; ~3.3″ over the couplers — the real spacing a cut of cars takes. The
+ * single constant every repo reads so a track's car count matches everywhere. */
+declare const N_CAR_LENGTH_INCHES = 3.3;
+/** How many cars fit in a span, from its drawn length — the derived capacity a
+ * siding or an industry spot holds (never typed). */
+declare function carCapacity(fromPos: number, toPos: number, carLengthInches?: number): number;
 /** Parse a jsonb value into a schematic doc, or null if it isn't one. */
 declare function asModuleSchematic(x: unknown): ModuleSchematicDoc | null;
 interface EditorTrack {
@@ -257,6 +323,9 @@ interface EditorTrack {
     trackName: string;
     /** Inside the balloon of a loop module (#165). */
     inLoop?: boolean;
+    /** Authored 2-D path (module-local inches) — a bent/rotated spur's real
+     * shape. Absent = derive from the main + lane (#2d-track). */
+    path?: BenchworkPoint[];
 }
 /** A module_tracks row as loaded for the editor. */
 interface ModuleTrackRow {
@@ -294,6 +363,20 @@ interface EditorCrossing {
     trackA: string;
     trackB: string;
 }
+/** An industry as the authoring form binds it — a car-spot span on a track. */
+interface EditorIndustry {
+    id: string;
+    name: string;
+    type: string;
+    track: string;
+    fromPos: number;
+    toPos: number;
+    side: SignalSide;
+    labelMode: IndustryLabelMode;
+    carTypes: string[];
+    /** freemon_industries row (single source of truth), or null for a new one. */
+    moduleIndustryId: number | null;
+}
 /** A 3rd+ endplate — a branch/junction connection off the module (#170).
  * A module may have several (e.g. a set carrying a second railroad through:
  * MoPac enters at one branch endplate and leaves at another). */
@@ -339,6 +422,11 @@ interface EditorState {
      * Empty = no authored outline (fall back to the endplate-width band). */
     outline: BenchworkPoint[];
     controlPoints: EditorControlPoint[];
+    /** Rail-served industries — car-spot spans on a track (#industries). */
+    industries: EditorIndustry[];
+    /** Authored mainline centre-line (module-local inches) — empty = derive from
+     * geometry. The owner-drawn real shape (#2d-track, physical view only). */
+    mainPath: BenchworkPoint[];
 }
 /** Build the empty editor state for a module of the given length. */
 declare function emptyEditorState(lengthInches: number): EditorState;
@@ -469,6 +557,23 @@ interface BranchConnector {
     posFrac: number;
     side: "up" | "down";
 }
+/** An industry — draw a car-spot span beside its track's lane, on `side`, with
+ * a name label + an optional car/length readout (#industries). */
+interface DrawIndustry {
+    id: string;
+    name: string;
+    type: string | null;
+    /** Span as fractions of module length (sorted West→East). */
+    fromFrac: number;
+    toFrac: number;
+    /** Lane of the track it spots on, so it draws beside the right track. */
+    lane: number;
+    side: SignalSide;
+    labelMode: IndustryLabelMode;
+    /** Cars that spot here, derived from the drawn span length. */
+    cars: number;
+    carTypes: string[];
+}
 interface ModuleFeatures {
     /** Whether either endplate declares a double-track main. */
     doubleMain: boolean;
@@ -493,6 +598,8 @@ interface ModuleFeatures {
     crossovers: DrawCrossover[];
     /** Branch endplates — junction connectors off the module (#170). */
     branchConnectors: BranchConnector[];
+    /** Rail-served industries — car-spot spans beside their track (#industries). */
+    industries: DrawIndustry[];
     /** Main 2's extent when it doesn't run the full module — a single↔double
      * transition (Main 2 starts/ends at the mainline turnout). Null = full
      * length (or no Main 2). Renderers draw the partial line + its diverge. */
@@ -598,4 +705,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 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 };
+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, FREEMO_ENDPLATE_WIDTH_MIN_INCHES, FREEMO_ENDPLATE_WIDTH_RECOMMENDED_INCHES, type GeometryType, type IndustryLabelMode, 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, deriveEndplatePoses, divergeSideForHand, docToState, emptyEditorState, endplateFaceSegments, endplateWidthInches, geometryTurnDegrees, inchesToScaleFeet, isLoopDoc, isTransitionTurnout, moduleCenterline, moduleFeatures, moduleFootprint, nextId, poseNeedsManual, poseOverridesFromDoc, sampleBenchworkOutline, samplePath, scaleFeetToInches, stateToDoc, trackPath };

package/dist/index.d.ts

@@ -78,6 +78,11 @@ interface SchematicTrack {
      * endplate A (past the throat = in the loop), lane is the ladder/arc index —
      * one record drives both the unrolled fan and a geometric render. */
     inLoop?: boolean;
+    /** Authored 2-D path for this track (module-local inches, open path with
+     * arcs) — the PHYSICAL shape a bent/rotated spur draws. Absent = derive from
+     * the main centre-line + lane, as before. Physical view only; the operations
+     * view stays positional (#2d-track). */
+    path?: BenchworkPoint[] | null;
 }
 interface SchematicTurnout {
     id: string;
@@ -132,6 +137,35 @@ interface SchematicControlPoint {
     crossings?: string[];
     signals?: SchematicSignal[];
 }
+/** What a rendered industry shows beside its name: a car count, a length in
+ * inches, or nothing (name only). Authored per industry. */
+type IndustryLabelMode = "none" | "cars" | "inches";
+/**
+ * An industry — a rail-served customer that spots cars, authored as a SPAN on a
+ * track (a spur/siding, or the main). Positional like everything else: it lives
+ * in the same module-local inch frame and is rendered into the shared 2-D view,
+ * offset to `side`. The span length gives its car capacity; the dispatcher and
+ * crews read where cars set out. Mirrors a `freemon_industries` row.
+ */
+interface SchematicIndustry {
+    id: string;
+    name: string;
+    /** Industry type value from the lookup (e.g. "team_track", "grain"). */
+    type?: string | null;
+    /** The track this industry spots cars on (a spur/siding id, or the main). */
+    track: string;
+    /** The car-spot span along that track, inches from endplate A. */
+    fromPos: number;
+    toPos: number;
+    /** Which side of the track the building + label sit on. */
+    side?: SignalSide;
+    /** Secondary readout at the label — a car count, a length, or none. */
+    labelMode?: IndustryLabelMode;
+    /** Car types this industry receives (car-type value strings). */
+    carTypes?: string[];
+    /** The `freemon_industries` row this is (single source of truth); null = new. */
+    moduleIndustryId?: number | null;
+}
 interface ModuleSchematicDoc {
     version: number;
     module?: string;
@@ -156,6 +190,8 @@ interface ModuleSchematicDoc {
     /** Grade crossings / diamonds (#170). */
     crossings?: SchematicCrossing[];
     controlPoints?: SchematicControlPoint[];
+    /** Rail-served industries — car-spot spans on a track (#industries). */
+    industries?: SchematicIndustry[];
     /** Benchwork FOOTPRINT outline — the module's physical board shape as a
      * polygon in module-local inches, in the same frame as the endplate poses
      * (endplate A's track point at the origin, the mainline along +x, perpendicular
@@ -164,6 +200,10 @@ interface ModuleSchematicDoc {
     outline?: BenchworkPoint[];
     /** @deprecated pre-grouping flat signals; read for back-compat. */
     signals?: SchematicSignal[];
+    /** Authored mainline centre-line (module-local inches, open path with arcs).
+     * Present = the owner drew the real shape; absent = derive from geometry.
+     * Physical view only — the operations view stays derived (#2d-track). */
+    mainPath?: BenchworkPoint[] | null;
 }
 /** A benchwork-outline vertex, module-local inches. The edge from this vertex
  * to the NEXT one is a straight line, unless `bulge` is set — then it's a
@@ -191,6 +231,19 @@ declare function sampleBenchworkOutline(pts: BenchworkPoint[], segsPerArc?: numb
     x: number;
     y: number;
 }[];
+/**
+ * Expand an OPEN track path (whose edges may be arcs) into a dense polyline —
+ * the open-ended sibling of sampleBenchworkOutline (which closes the ring).
+ * Used for authored track centre-lines (a drawn mainline or spur). The final
+ * vertex is always emitted so the path reaches its end.
+ */
+declare function samplePath(pts: BenchworkPoint[], segsPerArc?: number): {
+    x: number;
+    y: number;
+}[];
+/** Normalise an authored track path from a doc, or null if it isn't a real path
+ * (needs ≥ 2 valid points). Keeps per-vertex bulge. */
+declare function trackPath(path: BenchworkPoint[] | null | undefined): BenchworkPoint[] | null;
 interface ModuleFootprintInput {
     /** Mainline length (falls back to footprint length), inches. */
     lengthInches: number;
@@ -201,6 +254,10 @@ interface ModuleFootprintInput {
     endplateWidths?: Record<string, number>;
     /** Authored benchwork outline (module-local inches), or absent for the band. */
     outline?: BenchworkPoint[] | 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). */
+    mainPath?: BenchworkPoint[] | null;
 }
 interface OutlineFace {
     /** The endplate face's two corners + midpoint (the track point). */
@@ -218,7 +275,9 @@ interface ModuleFootprint {
     /** 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. */
+/** 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[];
 /** Benchwork band: the centre-line offset ±half-width, tapering widthA→widthB. */
 declare function benchworkBand(center: BenchworkPoint[], widthA?: number, widthB?: number): BenchworkPoint[];
@@ -243,6 +302,13 @@ declare const N_SCALE_RATIO = 160;
 declare function inchesToScaleFeet(inches: number, ratio?: number): number;
 /** Scale feet of prototype track → real inches on the module. */
 declare function scaleFeetToInches(feet: number, ratio?: number): number;
+/** Length a spotted car occupies on N-scale track, inches. A 40-ft car body is
+ * ~3.0″; ~3.3″ over the couplers — the real spacing a cut of cars takes. The
+ * single constant every repo reads so a track's car count matches everywhere. */
+declare const N_CAR_LENGTH_INCHES = 3.3;
+/** How many cars fit in a span, from its drawn length — the derived capacity a
+ * siding or an industry spot holds (never typed). */
+declare function carCapacity(fromPos: number, toPos: number, carLengthInches?: number): number;
 /** Parse a jsonb value into a schematic doc, or null if it isn't one. */
 declare function asModuleSchematic(x: unknown): ModuleSchematicDoc | null;
 interface EditorTrack {
@@ -257,6 +323,9 @@ interface EditorTrack {
     trackName: string;
     /** Inside the balloon of a loop module (#165). */
     inLoop?: boolean;
+    /** Authored 2-D path (module-local inches) — a bent/rotated spur's real
+     * shape. Absent = derive from the main + lane (#2d-track). */
+    path?: BenchworkPoint[];
 }
 /** A module_tracks row as loaded for the editor. */
 interface ModuleTrackRow {
@@ -294,6 +363,20 @@ interface EditorCrossing {
     trackA: string;
     trackB: string;
 }
+/** An industry as the authoring form binds it — a car-spot span on a track. */
+interface EditorIndustry {
+    id: string;
+    name: string;
+    type: string;
+    track: string;
+    fromPos: number;
+    toPos: number;
+    side: SignalSide;
+    labelMode: IndustryLabelMode;
+    carTypes: string[];
+    /** freemon_industries row (single source of truth), or null for a new one. */
+    moduleIndustryId: number | null;
+}
 /** A 3rd+ endplate — a branch/junction connection off the module (#170).
  * A module may have several (e.g. a set carrying a second railroad through:
  * MoPac enters at one branch endplate and leaves at another). */
@@ -339,6 +422,11 @@ interface EditorState {
      * Empty = no authored outline (fall back to the endplate-width band). */
     outline: BenchworkPoint[];
     controlPoints: EditorControlPoint[];
+    /** Rail-served industries — car-spot spans on a track (#industries). */
+    industries: EditorIndustry[];
+    /** Authored mainline centre-line (module-local inches) — empty = derive from
+     * geometry. The owner-drawn real shape (#2d-track, physical view only). */
+    mainPath: BenchworkPoint[];
 }
 /** Build the empty editor state for a module of the given length. */
 declare function emptyEditorState(lengthInches: number): EditorState;
@@ -469,6 +557,23 @@ interface BranchConnector {
     posFrac: number;
     side: "up" | "down";
 }
+/** An industry — draw a car-spot span beside its track's lane, on `side`, with
+ * a name label + an optional car/length readout (#industries). */
+interface DrawIndustry {
+    id: string;
+    name: string;
+    type: string | null;
+    /** Span as fractions of module length (sorted West→East). */
+    fromFrac: number;
+    toFrac: number;
+    /** Lane of the track it spots on, so it draws beside the right track. */
+    lane: number;
+    side: SignalSide;
+    labelMode: IndustryLabelMode;
+    /** Cars that spot here, derived from the drawn span length. */
+    cars: number;
+    carTypes: string[];
+}
 interface ModuleFeatures {
     /** Whether either endplate declares a double-track main. */
     doubleMain: boolean;
@@ -493,6 +598,8 @@ interface ModuleFeatures {
     crossovers: DrawCrossover[];
     /** Branch endplates — junction connectors off the module (#170). */
     branchConnectors: BranchConnector[];
+    /** Rail-served industries — car-spot spans beside their track (#industries). */
+    industries: DrawIndustry[];
     /** Main 2's extent when it doesn't run the full module — a single↔double
      * transition (Main 2 starts/ends at the mainline turnout). Null = full
      * length (or no Main 2). Renderers draw the partial line + its diverge. */
@@ -598,4 +705,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 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 };
+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, FREEMO_ENDPLATE_WIDTH_MIN_INCHES, FREEMO_ENDPLATE_WIDTH_RECOMMENDED_INCHES, type GeometryType, type IndustryLabelMode, 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, deriveEndplatePoses, divergeSideForHand, docToState, emptyEditorState, endplateFaceSegments, endplateWidthInches, geometryTurnDegrees, inchesToScaleFeet, isLoopDoc, isTransitionTurnout, moduleCenterline, moduleFeatures, moduleFootprint, nextId, poseNeedsManual, poseOverridesFromDoc, sampleBenchworkOutline, samplePath, scaleFeetToInches, stateToDoc, trackPath };

package/dist/index.js

@@ -43,6 +43,45 @@ function sampleBenchworkOutline(pts, segsPerArc = 20) {
   }
   return out;
 }
+function samplePath(pts, segsPerArc = 20) {
+  const n = pts.length;
+  if (n < 2) return pts.map((p) => ({ x: p.x, y: p.y }));
+  const out = [];
+  for (let i = 0; i < n - 1; i++) {
+    const p0 = pts[i];
+    const p1 = pts[i + 1];
+    out.push({ x: p0.x, y: p0.y });
+    const bulge = p0.bulge ?? 0;
+    if (!bulge) continue;
+    const dx = p1.x - p0.x;
+    const dy = p1.y - p0.y;
+    const c = Math.hypot(dx, dy);
+    if (c < 1e-6) continue;
+    const nx = -dy / c;
+    const ny = dx / c;
+    const mid = { x: (p0.x + p1.x) / 2 + nx * bulge, y: (p0.y + p1.y) / 2 + ny * bulge };
+    const circ = circleThrough(p0, mid, p1);
+    if (!circ) continue;
+    const a0 = Math.atan2(p0.y - circ.cy, p0.x - circ.cx);
+    const am = Math.atan2(mid.y - circ.cy, mid.x - circ.cx);
+    const a1 = Math.atan2(p1.y - circ.cy, p1.x - circ.cx);
+    const sweep = arcSweep(a0, a1, am);
+    for (let s = 1; s < segsPerArc; s++) {
+      const a = a0 + sweep * s / segsPerArc;
+      out.push({ x: circ.cx + circ.r * Math.cos(a), y: circ.cy + circ.r * Math.sin(a) });
+    }
+  }
+  out.push({ x: pts[n - 1].x, y: pts[n - 1].y });
+  return out;
+}
+function trackPath(path) {
+  const pts = (path ?? []).filter((p) => p && Number.isFinite(p.x) && Number.isFinite(p.y)).map((p) => ({
+    x: p.x,
+    y: p.y,
+    ...Number.isFinite(p.bulge) && p.bulge ? { bulge: p.bulge } : {}
+  }));
+  return pts.length >= 2 ? pts : null;
+}
 function circleThrough(a, b, c) {
   const d = 2 * (a.x * (b.y - c.y) + b.x * (c.y - a.y) + c.x * (a.y - b.y));
   if (Math.abs(d) < 1e-9) return null;
@@ -65,6 +104,8 @@ function arcSweep(a0, a1, am) {
 }
 var DEG_FP = Math.PI / 180;
 function moduleCenterline(input) {
+  const drawn = trackPath(input.mainPath);
+  if (drawn) return samplePath(drawn);
   const L = input.lengthInches > 0 ? input.lengthInches : 24;
   const gt = input.geometryType;
   if (gt === "dead_end") return [{ x: 0, y: 0 }];
@@ -147,6 +188,11 @@ function inchesToScaleFeet(inches, ratio = N_SCALE_RATIO) {
 function scaleFeetToInches(feet, ratio = N_SCALE_RATIO) {
   return feet * 12 / ratio;
 }
+var N_CAR_LENGTH_INCHES = 3.3;
+function carCapacity(fromPos, toPos, carLengthInches = N_CAR_LENGTH_INCHES) {
+  if (!(carLengthInches > 0)) return 0;
+  return Math.max(0, Math.floor(Math.abs(toPos - fromPos) / carLengthInches));
+}
 function asModuleSchematic(x) {
   if (!x || typeof x !== "object") return null;
   const d = x;
@@ -168,7 +214,9 @@ function emptyEditorState(lengthInches) {
     poseOverrides: {},
     endplateWidths: {},
     outline: [],
-    controlPoints: []
+    controlPoints: [],
+    industries: [],
+    mainPath: []
   };
 }
 function isTransitionTurnout(t) {
@@ -305,7 +353,8 @@ function stateToDoc(state, recordNumber) {
         moduleTrackId: t.moduleTrackId,
         trackName: t.trackName || void 0,
         capacityFeet: Math.round(inchesToScaleFeet(Math.abs(t.toPos - t.fromPos))),
-        ...state.loop && t.inLoop ? { inLoop: true } : {}
+        ...state.loop && t.inLoop ? { inLoop: true } : {},
+        ...t.path && t.path.length >= 2 ? { path: t.path } : {}
       }))
     ],
     turnouts: state.turnouts.map((t) => ({
@@ -338,9 +387,26 @@ function stateToDoc(state, recordNumber) {
         side: s.side
       }))
     })),
+    // Industries — car-spot spans on a track; only when any are authored.
+    ...state.industries.length > 0 ? {
+      industries: state.industries.map((ind) => ({
+        id: ind.id,
+        name: ind.name,
+        ...ind.type ? { type: ind.type } : {},
+        track: ind.track,
+        fromPos: ind.fromPos,
+        toPos: ind.toPos,
+        side: ind.side,
+        ...ind.labelMode && ind.labelMode !== "none" ? { labelMode: ind.labelMode } : {},
+        ...ind.carTypes.length ? { carTypes: ind.carTypes } : {},
+        moduleIndustryId: ind.moduleIndustryId
+      }))
+    } : {},
     // Benchwork footprint outline (module-local inches); only when it's a real
     // ring (≥ 3 vertices).
-    ...state.outline.length >= 3 ? { outline: state.outline } : {}
+    ...state.outline.length >= 3 ? { outline: state.outline } : {},
+    // Authored mainline path (module-local inches); only when it's a real path.
+    ...state.mainPath.length >= 2 ? { mainPath: state.mainPath } : {}
   };
 }
 function docToState(doc, fallbackLength, moduleTracks = []) {
@@ -370,7 +436,9 @@ function docToState(doc, fallbackLength, moduleTracks = []) {
         toPos: t.toPos != null ? sc(t.toPos) : len,
         moduleTrackId,
         trackName: t.trackName ?? nameOf(moduleTrackId),
-        ...t.inLoop ? { inLoop: true } : {}
+        ...t.inLoop ? { inLoop: true } : {},
+        // Authored path kept as-drawn (a physical shape, not rescaled with length).
+        ...trackPath(t.path) ? { path: trackPath(t.path) } : {}
       });
     }
   }
@@ -419,6 +487,7 @@ function docToState(doc, fallbackLength, moduleTracks = []) {
     y: p.y,
     ...Number.isFinite(p.bulge) && p.bulge ? { bulge: p.bulge } : {}
   }));
+  const mainPath = trackPath(d.mainPath) ?? [];
   return {
     lengthInches: len,
     loop,
@@ -435,6 +504,7 @@ function docToState(doc, fallbackLength, moduleTracks = []) {
     poseOverrides,
     endplateWidths,
     outline,
+    mainPath,
     crossings: (d.crossings ?? []).map((x) => ({
       id: x.id,
       name: x.name ?? "",
@@ -451,7 +521,19 @@ function docToState(doc, fallbackLength, moduleTracks = []) {
       divergeTrack: t.divergeTrack,
       kind: t.kind ?? "right"
     })),
-    controlPoints: readControlPoints(d, sc)
+    controlPoints: readControlPoints(d, sc),
+    industries: (d.industries ?? []).map((ind) => ({
+      id: ind.id,
+      name: ind.name ?? "",
+      type: ind.type ?? "",
+      track: ind.track,
+      fromPos: sc(ind.fromPos ?? 0),
+      toPos: ind.toPos != null ? sc(ind.toPos) : len,
+      side: ind.side ?? "above",
+      labelMode: ind.labelMode ?? "none",
+      carTypes: Array.isArray(ind.carTypes) ? ind.carTypes : [],
+      moduleIndustryId: ind.moduleIndustryId ?? null
+    }))
   };
 }
 function readControlPoints(d, sc = (p) => p) {
@@ -750,6 +832,22 @@ function moduleFeatures(doc) {
     posFrac: clampFrac(e.at.pos),
     side: e.at.side === "down" ? "down" : "up"
   }));
+  const industries = (doc.industries ?? []).map((ind) => {
+    const from = ind.fromPos ?? 0;
+    const to = ind.toPos ?? len;
+    return {
+      id: ind.id,
+      name: ind.name ?? "",
+      type: ind.type ?? null,
+      fromFrac: clampFrac(Math.min(from, to)),
+      toFrac: clampFrac(Math.max(from, to)),
+      lane: trackLane.get(ind.track) ?? 0,
+      side: ind.side ?? "above",
+      labelMode: ind.labelMode ?? "none",
+      cars: carCapacity(from, to),
+      carTypes: Array.isArray(ind.carTypes) ? ind.carTypes : []
+    };
+  });
   const allLanes = [
     0,
     doubleMain ? 1 : 0,
@@ -790,6 +888,7 @@ function moduleFeatures(doc) {
     crossings,
     crossovers,
     branchConnectors,
+    industries,
     laneMin: Math.min(...allLanes),
     laneMax: Math.max(...allLanes)
   };
@@ -892,6 +991,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, benchworkBand, benchworkOutline, buildCrossover, buildPassingSiding, buildTransition, deriveEndplatePoses, divergeSideForHand, docToState, emptyEditorState, endplateFaceSegments, endplateWidthInches, geometryTurnDegrees, inchesToScaleFeet, isLoopDoc, isTransitionTurnout, moduleCenterline, moduleFeatures, moduleFootprint, nextId, poseNeedsManual, poseOverridesFromDoc, sampleBenchworkOutline, scaleFeetToInches, stateToDoc };
+export { FREEMO_ENDPLATE_WIDTH_MIN_INCHES, FREEMO_ENDPLATE_WIDTH_RECOMMENDED_INCHES, MAIN2_TRACK_ID, MAIN_TRACK_ID, N_CAR_LENGTH_INCHES, N_SCALE_RATIO, asModuleSchematic, benchworkBand, benchworkOutline, buildCrossover, buildPassingSiding, buildTransition, carCapacity, deriveEndplatePoses, divergeSideForHand, docToState, emptyEditorState, endplateFaceSegments, endplateWidthInches, geometryTurnDegrees, inchesToScaleFeet, isLoopDoc, isTransitionTurnout, moduleCenterline, moduleFeatures, moduleFootprint, nextId, poseNeedsManual, poseOverridesFromDoc, sampleBenchworkOutline, samplePath, scaleFeetToInches, stateToDoc, trackPath };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map