@willcgage/module-schematic 0.83.2 → 0.85.0

package/dist/index.d.cts

@@ -34,6 +34,14 @@ interface SchematicEndplate {
         pos: number;
         side: "up" | "down";
     };
+    /** ⭐ THE ENDPLATE'S EDGE OF THE BENCHWORK (ADR 0001). When present it WINS
+     * over `pose` and over derivation, and position, heading and width are all
+     * read off the polygon — so they cannot drift apart from the board.
+     *
+     * `pose` remains for modules authored before this and for shapes with no
+     * benchwork polygon to bind to. Nothing is auto-converted: guessing which
+     * edge an owner's freehand pose meant would be inventing an intent. */
+    edge?: EndplateEdge | null;
     /** Manual pose override (#175 phase 1b) — the endplate's module-local track
      * point (x, y inches) + outward-normal heading (°). Hand-entered for shapes
      * the geometry fields can't derive (wye, freeform, loop); wins over
@@ -1184,6 +1192,9 @@ interface EditorState {
     /** Authored per-endplate TRACK offsets by id — the primary track's signed
      * distance from the plate centre, inches. Absent id = the §2.0 default. */
     endplateTrackOffsets: Record<string, number>;
+    /** Endplate EDGE bindings by id (ADR 0001) — an endplate that is part of the
+     * benchwork. Wins over a pose; nothing is auto-converted from one. */
+    endplateEdges?: Record<string, EndplateEdge>;
     /** Benchwork footprint outline — polygon vertices in module-local inches
      * (endplate A's track point at the origin, mainline +x, perpendicular +y up).
      * Empty = no authored outline (fall back to the endplate-width band). */
@@ -2302,6 +2313,62 @@ declare function turnoutClosure(size: number, opts?: {
      * around 25″ on a #7 — clear of the Free-moN 22″ minimum. */
     easeInches?: number;
 }): TurnoutClosure;
+/** Which end of a part this is. A graph connects joints; a walk uses `routes`. */
+type PartJointRole = "throat" | "through" | "diverge" | "divergeB";
+/** One end of a part, in part-local inches: `x` along the through route from
+ * the tie end, `y` lateral toward the diverging side, `angleDeg` the OUTWARD
+ * tangent (0 = +x). Named, unlike {@link PartEnd}, because a graph has to know
+ * a throat from a frog. */
+interface PartJoint extends PartEnd {
+    id: string;
+    role: PartJointRole;
+}
+interface PartGeometry {
+    joints: PartJoint[];
+    /** Joint id pairs a train can run between. A turnout has two routes sharing
+     * its throat; flex has one; a double crossover has four. */
+    routes: [string, string][];
+    /** The weakest provenance among the dimensions used — so a caller can tell a
+     * placed-from-measurement part from a placed-from-a-catalogue-figure one. */
+    source: DimensionSource;
+    /** True when the diverging end came from a measured {@link
+     * TrackPart.divergingLength} rather than from assuming the diverging rail
+     * leaves the moulding at the same place the through route does. */
+    divergingEndMeasured: boolean;
+}
+/**
+ * Why a part has no derivable geometry — null when it has.
+ *
+ * Worth its own function because "we cannot place this yet" is a fact an owner
+ * should see in the picker, not a silent absence. It is also the parts-library
+ * backlog in machine-readable form: every string this returns is a measurement
+ * someone could take.
+ */
+declare function partGeometryGap(part: TrackPart): string | null;
+/**
+ * A part's joints and routes, in its own frame.
+ *
+ * The through route runs along +x from the tie end; the diverging side is +y.
+ * A placed piece is this, transformed — which is the whole point: the geometry
+ * belongs to the PART, and placement is a rotation and a translation.
+ *
+ * ⚠️ THE DIVERGING END IS MEASURED WHERE WE HAVE A MEASUREMENT. `divergingLength`
+ * (frog → end of the diverging rail, along the rail) says exactly where that end
+ * is. Without it we fall back to assuming the diverging rail leaves the moulding
+ * at the same x as the through route — which is what `partExtent` has always
+ * assumed, and is an assumption, not a reading. `divergingEndMeasured` says
+ * which you got.
+ */
+declare function partGeometry(part: TrackPart, library?: TrackPart[]): PartGeometry | null;
+/** Every part that can be PLACED on a board today, and every one that can only
+ * be named — with the reason. The gap list is the parts backlog. */
+declare function partsPlaceable(library?: TrackPart[]): {
+    placeable: TrackPart[];
+    blocked: {
+        part: TrackPart;
+        why: string;
+    }[];
+};
 /** A frog casting's parts, in TURNOUT-LOCAL inches: `x` = distance past the
  * points, `y` = lateral offset from the through route. */
 interface FrogCasting {
@@ -2358,6 +2425,62 @@ flipped?: boolean | null): -1 | 0 | 1;
  */
 declare function moduleFeatures(doc: ModuleSchematicDoc): ModuleFeatures;
 type GeometryType = "straight" | "corner_45" | "corner_90" | "curve" | "offset" | "dead_end" | "wye" | "other";
+/**
+ * An endplate bound to a BENCHWORK EDGE (ADR 0001).
+ *
+ * Will Gage, 2026-07-26: *"Endplates are a part of the benchwork. We have
+ * separated them causing some challenges."* A {@link SchematicEndplate.pose} is
+ * a point floating in module space, so it can disagree with the board — and has:
+ * a junction plate landed on the module CENTRE LINE rather than the fascia, a
+ * derived pose written back silently PINNED a plate so it went stale when the
+ * length changed (which is the only reason `poseAuthored` exists), and a face
+ * drawn flat across a tapered edge is flush only at its midpoint.
+ *
+ * Bind it to an edge and none of those are expressible. Position, heading and
+ * WIDTH all come from the edge, so they cannot drift apart.
+ */
+interface EndplateEdge {
+    /** The section whose outline owns this edge; absent = the module outline. */
+    section?: string | null;
+    /** Which edge: the segment from vertex `index` to vertex `index + 1`. */
+    index: number;
+    /** Optional span along that edge, 0…1. Absent = the whole edge — which is the
+     * common case, because a board's end IS the endplate. */
+    fromT?: number | null;
+    toT?: number | null;
+}
+/** What an {@link EndplateEdge} resolves to. Everything here is READ OFF the
+ * polygon; nothing is stored, so nothing can go stale. */
+interface EndplateEdgePose {
+    x: number;
+    y: number;
+    /** The edge's OUTWARD normal, degrees. */
+    heading: number;
+    /** The span's length — the face's real width, not a separate number that
+     * might disagree with the board. */
+    widthInches: number;
+    /** The face's two ends. On a tapered board this follows the slope, which a
+     * stored pose + width could never do. */
+    face: [{
+        x: number;
+        y: number;
+    }, {
+        x: number;
+        y: number;
+    }];
+}
+/**
+ * Resolve an endplate's edge binding against a benchwork polygon.
+ *
+ * ⚠️ REFUSES A CURVED EDGE. Free-moN §2.0 requires the track crossing an
+ * endplate to be perpendicular, straight and level for 4″ — so an endplate face
+ * is flat by the standard, and a bulged edge is not somewhere one can go. That
+ * is a rule, not a missing feature.
+ *
+ * Returns null when the edge doesn't exist or isn't usable, so a caller can say
+ * why rather than drawing something wrong.
+ */
+declare function endplateEdgePose(outline: BenchworkPoint[] | null | undefined, edge: EndplateEdge): EndplateEdgePose | null;
 interface EndplatePose {
     /** Endplate id — "A"/"B" axial, "C"/"D"… branch. */
     id: string;
@@ -2370,6 +2493,19 @@ interface EndplatePose {
     trackConfig: "single" | "double";
     /** Lateral track offsets from the crossing anchor (0 = centred single). */
     trackOffsets: number[];
+    /** Set when this pose came from an {@link EndplateEdge} — read off the
+     * benchwork rather than stored. Its width and face are the board's own. */
+    boundToEdge?: boolean;
+    /** The face's real width, when bound to an edge. */
+    widthInches?: number;
+    /** The face's two ends, when bound to an edge — follows a tapered board. */
+    face?: [{
+        x: number;
+        y: number;
+    }, {
+        x: number;
+        y: number;
+    }];
     /** True when the pose was hand-entered, not derived (wye/loop/other). */
     manual?: boolean;
 }
@@ -2420,6 +2556,12 @@ interface ModuleGeometryInput {
         side: "up" | "down";
         config?: "single" | "double" | null;
     }[];
+    /** ⭐ Endplate EDGE bindings by id (ADR 0001) — an endplate that is part of
+     * the benchwork rather than a point floating beside it. Wins over
+     * `poseOverrides` and over derivation. */
+    endplateEdges?: Record<string, EndplateEdge>;
+    /** The module's benchwork polygon, needed to resolve `endplateEdges`. */
+    outline?: BenchworkPoint[] | null;
     /** Hand-entered pose overrides by endplate id — win over derivation. */
     poseOverrides?: Record<string, {
         x: number;
@@ -2508,4 +2650,4 @@ declare function poseOverridesFromDoc(doc: ModuleSchematicDoc): Record<string, {
     heading: number;
 }>;
 
-export { ATLAS_CODE55_N, BUILT_IN_TRACK_PARTS, type BenchworkPoint, type BranchConnector, CLEARANCE_SPACING_INCHES, CODE55_RAIL_HEIGHT_INCHES, DEFAULT_FLEX_PART_ID, type DimensionSource, type DrawCrossing, type DrawCrossover, type DrawIndustry, type DrawSignal, type DrawTrack, type DrawTurnout, ENDPLATE_FASCIA_CLEAR_INCHES, ENDPLATE_LEAD_INCHES, type EditorBranch, type EditorControlPoint, type EditorCpSignal, type EditorCrossing, type EditorIndustry, type EditorState, type EditorTrack, type EditorTurnout, type EndplateBConfig, type EndplatePose, type EndplateTrackIssue, type EndplateWidthIssue, FAST_TRACKS_N_ME55, FAST_TRACKS_N_ME55_CROSSOVERS, FLEX_TRACK_PARTS, FREEMO_ENDPLATE_TRACK_FASCIA_CLEARANCE_INCHES, FREEMO_ENDPLATE_WIDTH_MIN_INCHES, FREEMO_ENDPLATE_WIDTH_RECOMMENDED_INCHES, FREEMO_TRACK_SPACING_INCHES, type FlexPiece, type FlexPieceEnd, type FrogCasting, type GeometryType, type ImportedPart, type IndustryLabelMode, type IndustrySpot, type LanePinch, 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 OccupiedSpan, type OutlineFace, PINCH_EASE_INCHES, type PartAngle, type PartDimension, type PartEnd, type PartExtent, type PartSegment, RAIL_GAUGE_INCHES, type ReturnLoopGeometry, type ReturnLoopShape, type SchematicBlock, type SchematicControlPoint, type SchematicCrossing, type SchematicEndplate, type SchematicEndplateTrack, type SchematicIndustry, type SchematicSection, type SchematicSignal, type SchematicTrack, type SchematicTurnout, type SectionAdjacency, type SectionEnd, type SectionEndAssessment, type SectionFootprint, type SectionJointAssessment, type SectionRelativePos, type SignalFacing, type SignalSide, type SpanOverhang, type StoredTrackPart, TIE_HALF_LENGTH_INCHES, TURNOUT_LEAD_INCHES_PER_FROG, type TrackConfig, type TrackPart, type TrackRole, type TurnoutClosure, type TurnoutKind, type UsableCapacity, WHOLE_MODULE_SECTION_ID, asModuleSchematic, assessSectionEnd, assessSectionJoint, benchworkBand, benchworkOutline, buildCrossover, buildPassingSiding, buildTransition, carCapacity, checkEndplateWidth, clearancePointPastFrogInches, crossoverPinches, deriveEndplatePoses, divergeSideForHand, docToState, emptyEditorState, endplateCentreOffsetInches, endplateFaceSegments, endplateLead, endplateTrackOffsetInches, endplateWidthInches, flexPartFor, flexParts, flexPieces, flexUsage, frogCasting, frogNumberFromName, fromSectionRelative, geometryTurnDegrees, hasNoFarEndplate, importedPartToTrackPart, inchesToScaleFeet, isLoopDoc, isTransitionTurnout, laneOffsetAt, leadInchesForSize, maxFlexPieceInches, mergeImportedParts, mergeStoredParts, moduleCenterline, moduleFeatures, moduleFootprint, moduleLengthFromSections, moduleSections, nextId, parseXtpLibrary, partExtent, partExtentForSize, partOutlineAtFrog, pastFrogInchesForSize, pathLengthInches, poseNeedsManual, poseOverridesFromDoc, remapPos, resizeFlexPiece, returnLoop, sampleBenchworkOutline, samplePartSegments, samplePath, scaleFeetToInches, sectionAdjacency, sectionBand, sectionBreaksFromSections, sectionComponents, sectionFootprints, sectionNeighbours, sectionSpans, sectionSpansOrWhole, sectionedCenterline, sectionedEndPose, sliceCenterline, spanOverhang, stateToDoc, storedPartToTrackPart, toSectionRelative, trackMeetsEndplateIssues, trackPart, trackPath, turnoutClosure, turnoutFacing, turnoutOccupiedSpan, turnoutPartForSize, usableCapacity };
+export { ATLAS_CODE55_N, BUILT_IN_TRACK_PARTS, type BenchworkPoint, type BranchConnector, CLEARANCE_SPACING_INCHES, CODE55_RAIL_HEIGHT_INCHES, DEFAULT_FLEX_PART_ID, type DimensionSource, type DrawCrossing, type DrawCrossover, type DrawIndustry, type DrawSignal, type DrawTrack, type DrawTurnout, ENDPLATE_FASCIA_CLEAR_INCHES, ENDPLATE_LEAD_INCHES, type EditorBranch, type EditorControlPoint, type EditorCpSignal, type EditorCrossing, type EditorIndustry, type EditorState, type EditorTrack, type EditorTurnout, type EndplateBConfig, type EndplateEdge, type EndplateEdgePose, type EndplatePose, type EndplateTrackIssue, type EndplateWidthIssue, FAST_TRACKS_N_ME55, FAST_TRACKS_N_ME55_CROSSOVERS, FLEX_TRACK_PARTS, FREEMO_ENDPLATE_TRACK_FASCIA_CLEARANCE_INCHES, FREEMO_ENDPLATE_WIDTH_MIN_INCHES, FREEMO_ENDPLATE_WIDTH_RECOMMENDED_INCHES, FREEMO_TRACK_SPACING_INCHES, type FlexPiece, type FlexPieceEnd, type FrogCasting, type GeometryType, type ImportedPart, type IndustryLabelMode, type IndustrySpot, type LanePinch, 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 OccupiedSpan, type OutlineFace, PINCH_EASE_INCHES, type PartAngle, type PartDimension, type PartEnd, type PartExtent, type PartGeometry, type PartJoint, type PartJointRole, type PartSegment, RAIL_GAUGE_INCHES, type ReturnLoopGeometry, type ReturnLoopShape, type SchematicBlock, type SchematicControlPoint, type SchematicCrossing, type SchematicEndplate, type SchematicEndplateTrack, type SchematicIndustry, type SchematicSection, type SchematicSignal, type SchematicTrack, type SchematicTurnout, type SectionAdjacency, type SectionEnd, type SectionEndAssessment, type SectionFootprint, type SectionJointAssessment, type SectionRelativePos, type SignalFacing, type SignalSide, type SpanOverhang, type StoredTrackPart, TIE_HALF_LENGTH_INCHES, TURNOUT_LEAD_INCHES_PER_FROG, type TrackConfig, type TrackPart, type TrackRole, type TurnoutClosure, type TurnoutKind, type UsableCapacity, WHOLE_MODULE_SECTION_ID, asModuleSchematic, assessSectionEnd, assessSectionJoint, benchworkBand, benchworkOutline, buildCrossover, buildPassingSiding, buildTransition, carCapacity, checkEndplateWidth, clearancePointPastFrogInches, crossoverPinches, deriveEndplatePoses, divergeSideForHand, docToState, emptyEditorState, endplateCentreOffsetInches, endplateEdgePose, endplateFaceSegments, endplateLead, endplateTrackOffsetInches, endplateWidthInches, flexPartFor, flexParts, flexPieces, flexUsage, frogCasting, frogNumberFromName, fromSectionRelative, geometryTurnDegrees, hasNoFarEndplate, importedPartToTrackPart, inchesToScaleFeet, isLoopDoc, isTransitionTurnout, laneOffsetAt, leadInchesForSize, maxFlexPieceInches, mergeImportedParts, mergeStoredParts, moduleCenterline, moduleFeatures, moduleFootprint, moduleLengthFromSections, moduleSections, nextId, parseXtpLibrary, partExtent, partExtentForSize, partGeometry, partGeometryGap, partOutlineAtFrog, partsPlaceable, pastFrogInchesForSize, pathLengthInches, poseNeedsManual, poseOverridesFromDoc, remapPos, resizeFlexPiece, returnLoop, sampleBenchworkOutline, samplePartSegments, samplePath, scaleFeetToInches, sectionAdjacency, sectionBand, sectionBreaksFromSections, sectionComponents, sectionFootprints, sectionNeighbours, sectionSpans, sectionSpansOrWhole, sectionedCenterline, sectionedEndPose, sliceCenterline, spanOverhang, stateToDoc, storedPartToTrackPart, toSectionRelative, trackMeetsEndplateIssues, trackPart, trackPath, turnoutClosure, turnoutFacing, turnoutOccupiedSpan, turnoutPartForSize, usableCapacity };

package/dist/index.d.ts

@@ -34,6 +34,14 @@ interface SchematicEndplate {
         pos: number;
         side: "up" | "down";
     };
+    /** ⭐ THE ENDPLATE'S EDGE OF THE BENCHWORK (ADR 0001). When present it WINS
+     * over `pose` and over derivation, and position, heading and width are all
+     * read off the polygon — so they cannot drift apart from the board.
+     *
+     * `pose` remains for modules authored before this and for shapes with no
+     * benchwork polygon to bind to. Nothing is auto-converted: guessing which
+     * edge an owner's freehand pose meant would be inventing an intent. */
+    edge?: EndplateEdge | null;
     /** Manual pose override (#175 phase 1b) — the endplate's module-local track
      * point (x, y inches) + outward-normal heading (°). Hand-entered for shapes
      * the geometry fields can't derive (wye, freeform, loop); wins over
@@ -1184,6 +1192,9 @@ interface EditorState {
     /** Authored per-endplate TRACK offsets by id — the primary track's signed
      * distance from the plate centre, inches. Absent id = the §2.0 default. */
     endplateTrackOffsets: Record<string, number>;
+    /** Endplate EDGE bindings by id (ADR 0001) — an endplate that is part of the
+     * benchwork. Wins over a pose; nothing is auto-converted from one. */
+    endplateEdges?: Record<string, EndplateEdge>;
     /** Benchwork footprint outline — polygon vertices in module-local inches
      * (endplate A's track point at the origin, mainline +x, perpendicular +y up).
      * Empty = no authored outline (fall back to the endplate-width band). */
@@ -2302,6 +2313,62 @@ declare function turnoutClosure(size: number, opts?: {
      * around 25″ on a #7 — clear of the Free-moN 22″ minimum. */
     easeInches?: number;
 }): TurnoutClosure;
+/** Which end of a part this is. A graph connects joints; a walk uses `routes`. */
+type PartJointRole = "throat" | "through" | "diverge" | "divergeB";
+/** One end of a part, in part-local inches: `x` along the through route from
+ * the tie end, `y` lateral toward the diverging side, `angleDeg` the OUTWARD
+ * tangent (0 = +x). Named, unlike {@link PartEnd}, because a graph has to know
+ * a throat from a frog. */
+interface PartJoint extends PartEnd {
+    id: string;
+    role: PartJointRole;
+}
+interface PartGeometry {
+    joints: PartJoint[];
+    /** Joint id pairs a train can run between. A turnout has two routes sharing
+     * its throat; flex has one; a double crossover has four. */
+    routes: [string, string][];
+    /** The weakest provenance among the dimensions used — so a caller can tell a
+     * placed-from-measurement part from a placed-from-a-catalogue-figure one. */
+    source: DimensionSource;
+    /** True when the diverging end came from a measured {@link
+     * TrackPart.divergingLength} rather than from assuming the diverging rail
+     * leaves the moulding at the same place the through route does. */
+    divergingEndMeasured: boolean;
+}
+/**
+ * Why a part has no derivable geometry — null when it has.
+ *
+ * Worth its own function because "we cannot place this yet" is a fact an owner
+ * should see in the picker, not a silent absence. It is also the parts-library
+ * backlog in machine-readable form: every string this returns is a measurement
+ * someone could take.
+ */
+declare function partGeometryGap(part: TrackPart): string | null;
+/**
+ * A part's joints and routes, in its own frame.
+ *
+ * The through route runs along +x from the tie end; the diverging side is +y.
+ * A placed piece is this, transformed — which is the whole point: the geometry
+ * belongs to the PART, and placement is a rotation and a translation.
+ *
+ * ⚠️ THE DIVERGING END IS MEASURED WHERE WE HAVE A MEASUREMENT. `divergingLength`
+ * (frog → end of the diverging rail, along the rail) says exactly where that end
+ * is. Without it we fall back to assuming the diverging rail leaves the moulding
+ * at the same x as the through route — which is what `partExtent` has always
+ * assumed, and is an assumption, not a reading. `divergingEndMeasured` says
+ * which you got.
+ */
+declare function partGeometry(part: TrackPart, library?: TrackPart[]): PartGeometry | null;
+/** Every part that can be PLACED on a board today, and every one that can only
+ * be named — with the reason. The gap list is the parts backlog. */
+declare function partsPlaceable(library?: TrackPart[]): {
+    placeable: TrackPart[];
+    blocked: {
+        part: TrackPart;
+        why: string;
+    }[];
+};
 /** A frog casting's parts, in TURNOUT-LOCAL inches: `x` = distance past the
  * points, `y` = lateral offset from the through route. */
 interface FrogCasting {
@@ -2358,6 +2425,62 @@ flipped?: boolean | null): -1 | 0 | 1;
  */
 declare function moduleFeatures(doc: ModuleSchematicDoc): ModuleFeatures;
 type GeometryType = "straight" | "corner_45" | "corner_90" | "curve" | "offset" | "dead_end" | "wye" | "other";
+/**
+ * An endplate bound to a BENCHWORK EDGE (ADR 0001).
+ *
+ * Will Gage, 2026-07-26: *"Endplates are a part of the benchwork. We have
+ * separated them causing some challenges."* A {@link SchematicEndplate.pose} is
+ * a point floating in module space, so it can disagree with the board — and has:
+ * a junction plate landed on the module CENTRE LINE rather than the fascia, a
+ * derived pose written back silently PINNED a plate so it went stale when the
+ * length changed (which is the only reason `poseAuthored` exists), and a face
+ * drawn flat across a tapered edge is flush only at its midpoint.
+ *
+ * Bind it to an edge and none of those are expressible. Position, heading and
+ * WIDTH all come from the edge, so they cannot drift apart.
+ */
+interface EndplateEdge {
+    /** The section whose outline owns this edge; absent = the module outline. */
+    section?: string | null;
+    /** Which edge: the segment from vertex `index` to vertex `index + 1`. */
+    index: number;
+    /** Optional span along that edge, 0…1. Absent = the whole edge — which is the
+     * common case, because a board's end IS the endplate. */
+    fromT?: number | null;
+    toT?: number | null;
+}
+/** What an {@link EndplateEdge} resolves to. Everything here is READ OFF the
+ * polygon; nothing is stored, so nothing can go stale. */
+interface EndplateEdgePose {
+    x: number;
+    y: number;
+    /** The edge's OUTWARD normal, degrees. */
+    heading: number;
+    /** The span's length — the face's real width, not a separate number that
+     * might disagree with the board. */
+    widthInches: number;
+    /** The face's two ends. On a tapered board this follows the slope, which a
+     * stored pose + width could never do. */
+    face: [{
+        x: number;
+        y: number;
+    }, {
+        x: number;
+        y: number;
+    }];
+}
+/**
+ * Resolve an endplate's edge binding against a benchwork polygon.
+ *
+ * ⚠️ REFUSES A CURVED EDGE. Free-moN §2.0 requires the track crossing an
+ * endplate to be perpendicular, straight and level for 4″ — so an endplate face
+ * is flat by the standard, and a bulged edge is not somewhere one can go. That
+ * is a rule, not a missing feature.
+ *
+ * Returns null when the edge doesn't exist or isn't usable, so a caller can say
+ * why rather than drawing something wrong.
+ */
+declare function endplateEdgePose(outline: BenchworkPoint[] | null | undefined, edge: EndplateEdge): EndplateEdgePose | null;
 interface EndplatePose {
     /** Endplate id — "A"/"B" axial, "C"/"D"… branch. */
     id: string;
@@ -2370,6 +2493,19 @@ interface EndplatePose {
     trackConfig: "single" | "double";
     /** Lateral track offsets from the crossing anchor (0 = centred single). */
     trackOffsets: number[];
+    /** Set when this pose came from an {@link EndplateEdge} — read off the
+     * benchwork rather than stored. Its width and face are the board's own. */
+    boundToEdge?: boolean;
+    /** The face's real width, when bound to an edge. */
+    widthInches?: number;
+    /** The face's two ends, when bound to an edge — follows a tapered board. */
+    face?: [{
+        x: number;
+        y: number;
+    }, {
+        x: number;
+        y: number;
+    }];
     /** True when the pose was hand-entered, not derived (wye/loop/other). */
     manual?: boolean;
 }
@@ -2420,6 +2556,12 @@ interface ModuleGeometryInput {
         side: "up" | "down";
         config?: "single" | "double" | null;
     }[];
+    /** ⭐ Endplate EDGE bindings by id (ADR 0001) — an endplate that is part of
+     * the benchwork rather than a point floating beside it. Wins over
+     * `poseOverrides` and over derivation. */
+    endplateEdges?: Record<string, EndplateEdge>;
+    /** The module's benchwork polygon, needed to resolve `endplateEdges`. */
+    outline?: BenchworkPoint[] | null;
     /** Hand-entered pose overrides by endplate id — win over derivation. */
     poseOverrides?: Record<string, {
         x: number;
@@ -2508,4 +2650,4 @@ declare function poseOverridesFromDoc(doc: ModuleSchematicDoc): Record<string, {
     heading: number;
 }>;
 
-export { ATLAS_CODE55_N, BUILT_IN_TRACK_PARTS, type BenchworkPoint, type BranchConnector, CLEARANCE_SPACING_INCHES, CODE55_RAIL_HEIGHT_INCHES, DEFAULT_FLEX_PART_ID, type DimensionSource, type DrawCrossing, type DrawCrossover, type DrawIndustry, type DrawSignal, type DrawTrack, type DrawTurnout, ENDPLATE_FASCIA_CLEAR_INCHES, ENDPLATE_LEAD_INCHES, type EditorBranch, type EditorControlPoint, type EditorCpSignal, type EditorCrossing, type EditorIndustry, type EditorState, type EditorTrack, type EditorTurnout, type EndplateBConfig, type EndplatePose, type EndplateTrackIssue, type EndplateWidthIssue, FAST_TRACKS_N_ME55, FAST_TRACKS_N_ME55_CROSSOVERS, FLEX_TRACK_PARTS, FREEMO_ENDPLATE_TRACK_FASCIA_CLEARANCE_INCHES, FREEMO_ENDPLATE_WIDTH_MIN_INCHES, FREEMO_ENDPLATE_WIDTH_RECOMMENDED_INCHES, FREEMO_TRACK_SPACING_INCHES, type FlexPiece, type FlexPieceEnd, type FrogCasting, type GeometryType, type ImportedPart, type IndustryLabelMode, type IndustrySpot, type LanePinch, 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 OccupiedSpan, type OutlineFace, PINCH_EASE_INCHES, type PartAngle, type PartDimension, type PartEnd, type PartExtent, type PartSegment, RAIL_GAUGE_INCHES, type ReturnLoopGeometry, type ReturnLoopShape, type SchematicBlock, type SchematicControlPoint, type SchematicCrossing, type SchematicEndplate, type SchematicEndplateTrack, type SchematicIndustry, type SchematicSection, type SchematicSignal, type SchematicTrack, type SchematicTurnout, type SectionAdjacency, type SectionEnd, type SectionEndAssessment, type SectionFootprint, type SectionJointAssessment, type SectionRelativePos, type SignalFacing, type SignalSide, type SpanOverhang, type StoredTrackPart, TIE_HALF_LENGTH_INCHES, TURNOUT_LEAD_INCHES_PER_FROG, type TrackConfig, type TrackPart, type TrackRole, type TurnoutClosure, type TurnoutKind, type UsableCapacity, WHOLE_MODULE_SECTION_ID, asModuleSchematic, assessSectionEnd, assessSectionJoint, benchworkBand, benchworkOutline, buildCrossover, buildPassingSiding, buildTransition, carCapacity, checkEndplateWidth, clearancePointPastFrogInches, crossoverPinches, deriveEndplatePoses, divergeSideForHand, docToState, emptyEditorState, endplateCentreOffsetInches, endplateFaceSegments, endplateLead, endplateTrackOffsetInches, endplateWidthInches, flexPartFor, flexParts, flexPieces, flexUsage, frogCasting, frogNumberFromName, fromSectionRelative, geometryTurnDegrees, hasNoFarEndplate, importedPartToTrackPart, inchesToScaleFeet, isLoopDoc, isTransitionTurnout, laneOffsetAt, leadInchesForSize, maxFlexPieceInches, mergeImportedParts, mergeStoredParts, moduleCenterline, moduleFeatures, moduleFootprint, moduleLengthFromSections, moduleSections, nextId, parseXtpLibrary, partExtent, partExtentForSize, partOutlineAtFrog, pastFrogInchesForSize, pathLengthInches, poseNeedsManual, poseOverridesFromDoc, remapPos, resizeFlexPiece, returnLoop, sampleBenchworkOutline, samplePartSegments, samplePath, scaleFeetToInches, sectionAdjacency, sectionBand, sectionBreaksFromSections, sectionComponents, sectionFootprints, sectionNeighbours, sectionSpans, sectionSpansOrWhole, sectionedCenterline, sectionedEndPose, sliceCenterline, spanOverhang, stateToDoc, storedPartToTrackPart, toSectionRelative, trackMeetsEndplateIssues, trackPart, trackPath, turnoutClosure, turnoutFacing, turnoutOccupiedSpan, turnoutPartForSize, usableCapacity };
+export { ATLAS_CODE55_N, BUILT_IN_TRACK_PARTS, type BenchworkPoint, type BranchConnector, CLEARANCE_SPACING_INCHES, CODE55_RAIL_HEIGHT_INCHES, DEFAULT_FLEX_PART_ID, type DimensionSource, type DrawCrossing, type DrawCrossover, type DrawIndustry, type DrawSignal, type DrawTrack, type DrawTurnout, ENDPLATE_FASCIA_CLEAR_INCHES, ENDPLATE_LEAD_INCHES, type EditorBranch, type EditorControlPoint, type EditorCpSignal, type EditorCrossing, type EditorIndustry, type EditorState, type EditorTrack, type EditorTurnout, type EndplateBConfig, type EndplateEdge, type EndplateEdgePose, type EndplatePose, type EndplateTrackIssue, type EndplateWidthIssue, FAST_TRACKS_N_ME55, FAST_TRACKS_N_ME55_CROSSOVERS, FLEX_TRACK_PARTS, FREEMO_ENDPLATE_TRACK_FASCIA_CLEARANCE_INCHES, FREEMO_ENDPLATE_WIDTH_MIN_INCHES, FREEMO_ENDPLATE_WIDTH_RECOMMENDED_INCHES, FREEMO_TRACK_SPACING_INCHES, type FlexPiece, type FlexPieceEnd, type FrogCasting, type GeometryType, type ImportedPart, type IndustryLabelMode, type IndustrySpot, type LanePinch, 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 OccupiedSpan, type OutlineFace, PINCH_EASE_INCHES, type PartAngle, type PartDimension, type PartEnd, type PartExtent, type PartGeometry, type PartJoint, type PartJointRole, type PartSegment, RAIL_GAUGE_INCHES, type ReturnLoopGeometry, type ReturnLoopShape, type SchematicBlock, type SchematicControlPoint, type SchematicCrossing, type SchematicEndplate, type SchematicEndplateTrack, type SchematicIndustry, type SchematicSection, type SchematicSignal, type SchematicTrack, type SchematicTurnout, type SectionAdjacency, type SectionEnd, type SectionEndAssessment, type SectionFootprint, type SectionJointAssessment, type SectionRelativePos, type SignalFacing, type SignalSide, type SpanOverhang, type StoredTrackPart, TIE_HALF_LENGTH_INCHES, TURNOUT_LEAD_INCHES_PER_FROG, type TrackConfig, type TrackPart, type TrackRole, type TurnoutClosure, type TurnoutKind, type UsableCapacity, WHOLE_MODULE_SECTION_ID, asModuleSchematic, assessSectionEnd, assessSectionJoint, benchworkBand, benchworkOutline, buildCrossover, buildPassingSiding, buildTransition, carCapacity, checkEndplateWidth, clearancePointPastFrogInches, crossoverPinches, deriveEndplatePoses, divergeSideForHand, docToState, emptyEditorState, endplateCentreOffsetInches, endplateEdgePose, endplateFaceSegments, endplateLead, endplateTrackOffsetInches, endplateWidthInches, flexPartFor, flexParts, flexPieces, flexUsage, frogCasting, frogNumberFromName, fromSectionRelative, geometryTurnDegrees, hasNoFarEndplate, importedPartToTrackPart, inchesToScaleFeet, isLoopDoc, isTransitionTurnout, laneOffsetAt, leadInchesForSize, maxFlexPieceInches, mergeImportedParts, mergeStoredParts, moduleCenterline, moduleFeatures, moduleFootprint, moduleLengthFromSections, moduleSections, nextId, parseXtpLibrary, partExtent, partExtentForSize, partGeometry, partGeometryGap, partOutlineAtFrog, partsPlaceable, pastFrogInchesForSize, pathLengthInches, poseNeedsManual, poseOverridesFromDoc, remapPos, resizeFlexPiece, returnLoop, sampleBenchworkOutline, samplePartSegments, samplePath, scaleFeetToInches, sectionAdjacency, sectionBand, sectionBreaksFromSections, sectionComponents, sectionFootprints, sectionNeighbours, sectionSpans, sectionSpansOrWhole, sectionedCenterline, sectionedEndPose, sliceCenterline, spanOverhang, stateToDoc, storedPartToTrackPart, toSectionRelative, trackMeetsEndplateIssues, trackPart, trackPath, turnoutClosure, turnoutFacing, turnoutOccupiedSpan, turnoutPartForSize, usableCapacity };