@willcgage/module-schematic 0.61.0 → 0.62.0

package/dist/index.d.cts

@@ -43,6 +43,19 @@ interface SchematicEndplate {
         y: number;
         heading: number;
     };
+    /** Whether that pose was AUTHORED — placed or typed by the owner — rather
+     * than a derived one that found its way into the doc (#182).
+     *
+     * Authorship used to be inferred from `pose` merely existing, so a derived
+     * pose written back silently PINNED the plate: it stopped following the
+     * module and went stale the moment the length changed (FMN-0068 ended up with
+     * endplate B at x=48 on a 47.9″ board). A pose is only an override when the
+     * owner meant it.
+     *
+     * Absent on A/B = derived residue, ignored. Absent on a placed branch
+     * endplate (one with `at`) = still authored — placing it IS the gesture, and
+     * docs predate this flag. */
+    poseAuthored?: boolean;
     /** Free-moN endplate FACE width across the track, inches — the physical size
      * of the standard interface at this end. Free-moN spec: 12″ minimum, 24″
      * recommended. Absent = the recommended default (modules may differ end to

package/dist/index.d.ts

@@ -43,6 +43,19 @@ interface SchematicEndplate {
         y: number;
         heading: number;
     };
+    /** Whether that pose was AUTHORED — placed or typed by the owner — rather
+     * than a derived one that found its way into the doc (#182).
+     *
+     * Authorship used to be inferred from `pose` merely existing, so a derived
+     * pose written back silently PINNED the plate: it stopped following the
+     * module and went stale the moment the length changed (FMN-0068 ended up with
+     * endplate B at x=48 on a 47.9″ board). A pose is only an override when the
+     * owner meant it.
+     *
+     * Absent on A/B = derived residue, ignored. Absent on a placed branch
+     * endplate (one with `at`) = still authored — placing it IS the gesture, and
+     * docs predate this flag. */
+    poseAuthored?: boolean;
     /** Free-moN endplate FACE width across the track, inches — the physical size
      * of the standard interface at this end. Free-moN spec: 12″ minimum, 24″
      * recommended. Absent = the recommended default (modules may differ end to

package/dist/index.js

@@ -667,7 +667,7 @@ function buildTransition(state) {
 }
 function withPoses(endplates, overrides) {
   return endplates.map(
-    (e) => overrides[e.id] ? { ...e, pose: overrides[e.id] } : e
+    (e) => overrides[e.id] ? { ...e, pose: overrides[e.id], poseAuthored: true } : e
   );
 }
 function withWidths(endplates, widths, offsets = {}) {
@@ -2031,10 +2031,26 @@ function trackMeetsEndplateIssues(path, pose, opts) {
 function poseNeedsManual(geometryType) {
   return geometryType === "wye" || geometryType === "other";
 }
+function isAxialPose(p) {
+  const h = norm360(p.heading);
+  return Math.abs(p.y) < 1e-6 && (Math.abs(h) < 1e-6 || Math.abs(h - 180) < 1e-6);
+}
 function poseOverridesFromDoc(doc) {
   const out = {};
   for (const e of doc.endplates ?? []) {
-    if (e.id && e.pose && typeof e.pose.x === "number" && typeof e.pose.y === "number" && typeof e.pose.heading === "number") {
+    if (e.id && e.pose && typeof e.pose.x === "number" && typeof e.pose.y === "number" && typeof e.pose.heading === "number" && // Only an AUTHORED pose overrides derivation (#182) — but docs written
+    // before the flag existed have to keep working, so authorship is inferred
+    // for the two cases that can only BE authored:
+    //   · a placed branch endplate (`at`) — dropping it on the board is the
+    //     gesture, and it has no derivable position at all;
+    //   · an OFF-AXIS pose on A/B — a hand-placed plate is off-axis by
+    //     definition (that's why it needed hand placing, e.g. a wye's B).
+    // What's left is an axial A/B pose, which is exactly the shape plain
+    // derivation produces — residue. Honouring it silently pins the plate so
+    // it stops following the module and goes stale (FMN-0068's B sat at 48 on
+    // a 47.9″ board). Anything saved from now on carries the flag, so this
+    // guesswork only ever applies to old docs.
+    (e.poseAuthored === true || !!e.at || !isAxialPose(e.pose))) {
       out[e.id] = { x: e.pose.x, y: e.pose.y, heading: e.pose.heading };
     }
   }