@floless/app 0.34.2 → 0.35.0

package/dist/floless-server.cjs

@@ -50822,7 +50822,7 @@ function deriveSandboxLicenseDir() {
 deriveSandboxLicenseDir();
 
 // main.ts
-var import_node_child_process8 = require("node:child_process");
+var import_node_child_process9 = require("node:child_process");
 var import_node_readline2 = require("node:readline");
 
 // index.ts
@@ -50830,7 +50830,7 @@ var import_node_url4 = require("node:url");
 var import_node_path26 = require("node:path");
 var import_node_os18 = require("node:os");
 var import_node_fs28 = require("node:fs");
-var import_node_child_process6 = require("node:child_process");
+var import_node_child_process7 = require("node:child_process");
 
 // log.mjs
 var import_node_path = require("node:path");
@@ -52856,7 +52856,7 @@ function appVersion() {
   return resolveVersion({
     isSea: isSea2(),
     sqVersionXml: readSqVersionXml(),
-    define: true ? "0.34.2" : void 0,
+    define: true ? "0.35.0" : void 0,
     pkgVersion: readPkgVersion()
   });
 }
@@ -52866,7 +52866,7 @@ function resolveChannel(s) {
   return "dev";
 }
 function appChannel() {
-  return resolveChannel({ isSea: isSea2(), define: true ? "0.34.2" : void 0 });
+  return resolveChannel({ isSea: isSea2(), define: true ? "0.35.0" : void 0 });
 }
 
 // oauth-presets.ts
@@ -53948,6 +53948,42 @@ function writeTeklaApp(dir, appId, scene, teklaVersion = "2026.0") {
   return flo;
 }
 
+// tekla-version.ts
+var import_node_child_process3 = require("node:child_process");
+var import_node_util = require("node:util");
+var pexec = (0, import_node_util.promisify)(import_node_child_process3.execFile);
+var DEFAULT_TEKLA_VERSION = "2026.0";
+function parseTeklaVersionFromExePath(p) {
+  const m = /Tekla Structures[\\/]+([^\\/]+)[\\/]+bin\b/i.exec(p);
+  return m ? m[1].trim() : null;
+}
+async function detectRunningTeklaVersion() {
+  if (process.platform !== "win32") return null;
+  try {
+    const { stdout } = await pexec(
+      "powershell",
+      [
+        "-NoProfile",
+        "-NonInteractive",
+        "-Command",
+        `Get-CimInstance Win32_Process -Filter "Name='TeklaStructures.exe'" | Select-Object -First 1 -ExpandProperty ExecutablePath`
+      ],
+      { timeout: 5e3, windowsHide: true }
+    );
+    const exePath = stdout.trim();
+    if (!exePath) return null;
+    const version = parseTeklaVersionFromExePath(exePath);
+    if (!version) console.warn(`tekla-version: Tekla is running but no version parsed from "${exePath}" \u2014 baking ${DEFAULT_TEKLA_VERSION}`);
+    return version;
+  } catch (e) {
+    console.warn(`tekla-version: could not detect the running Tekla version (${e instanceof Error ? e.message : String(e)}) \u2014 baking ${DEFAULT_TEKLA_VERSION}`);
+    return null;
+  }
+}
+async function teklaVersionToBake() {
+  return await detectRunningTeklaVersion() ?? DEFAULT_TEKLA_VERSION;
+}
+
 // bom-format.ts
 var round1 = (n) => Math.round(n * 10) / 10;
 function contractToBom(contractInput) {
@@ -55187,7 +55223,7 @@ function isGatedAwareRoute(url, method) {
 }
 
 // autostart.mjs
-var import_node_child_process3 = require("node:child_process");
+var import_node_child_process4 = require("node:child_process");
 var import_node_fs22 = require("node:fs");
 var import_node_os14 = require("node:os");
 var import_node_path19 = require("node:path");
@@ -55296,7 +55332,7 @@ function currentUserId() {
 }
 function removeLegacyRunKey() {
   try {
-    (0, import_node_child_process3.execFileSync)("reg", ["delete", RUN_KEY, "/v", RUN_VALUE, "/f"], { stdio: "ignore", windowsHide: true });
+    (0, import_node_child_process4.execFileSync)("reg", ["delete", RUN_KEY, "/v", RUN_VALUE, "/f"], { stdio: "ignore", windowsHide: true });
   } catch {
   }
 }
@@ -55314,7 +55350,7 @@ function registerAutostart(exePath) {
   const tmp = (0, import_node_path19.join)((0, import_node_os14.tmpdir)(), `floless-autostart-${process.pid}-${Date.now()}.xml`);
   (0, import_node_fs22.writeFileSync)(tmp, "\uFEFF" + xml, { encoding: "utf16le" });
   try {
-    (0, import_node_child_process3.execFileSync)("schtasks", ["/Create", "/TN", TASK_NAME, "/XML", tmp, "/F"], {
+    (0, import_node_child_process4.execFileSync)("schtasks", ["/Create", "/TN", TASK_NAME, "/XML", tmp, "/F"], {
       stdio: ["ignore", "ignore", "ignore"],
       windowsHide: true
     });
@@ -55332,7 +55368,7 @@ function registerAutostart(exePath) {
 function autostartPresent() {
   if (!isWin) return false;
   try {
-    (0, import_node_child_process3.execFileSync)("schtasks", ["/query", "/tn", TASK_NAME], { stdio: "ignore", windowsHide: true });
+    (0, import_node_child_process4.execFileSync)("schtasks", ["/query", "/tn", TASK_NAME], { stdio: "ignore", windowsHide: true });
     return true;
   } catch {
     return false;
@@ -55349,14 +55385,14 @@ function ensureAutostart(exePath) {
 function unregisterAutostart() {
   if (!isWin) return;
   try {
-    (0, import_node_child_process3.execFileSync)("schtasks", ["/delete", "/tn", TASK_NAME, "/f"], { stdio: "ignore", windowsHide: true });
+    (0, import_node_child_process4.execFileSync)("schtasks", ["/delete", "/tn", TASK_NAME, "/f"], { stdio: "ignore", windowsHide: true });
   } catch {
   }
   removeLegacyRunKey();
 }
 
 // updater.ts
-var import_node_child_process4 = require("node:child_process");
+var import_node_child_process5 = require("node:child_process");
 var import_node_crypto6 = require("node:crypto");
 var import_node_fs24 = require("node:fs");
 var import_node_stream = require("node:stream");
@@ -55547,7 +55583,7 @@ async function applyUpdate(check, opts) {
   const pkg = await downloadPackage(check.asset);
   if (opts?.onBeforeApply) await opts.onBeforeApply();
   await new Promise((resolve6, reject) => {
-    const child = (0, import_node_child_process4.spawn)(exe, ["apply", "--package", pkg, "--waitPid", String(process.pid)], {
+    const child = (0, import_node_child_process5.spawn)(exe, ["apply", "--package", pkg, "--waitPid", String(process.pid)], {
       cwd: installRoot(),
       detached: true,
       stdio: "ignore",
@@ -55780,7 +55816,7 @@ function isTraceCorrupt(events) {
 }
 
 // launch.mjs
-var import_node_child_process5 = require("node:child_process");
+var import_node_child_process6 = require("node:child_process");
 var import_node_path22 = require("node:path");
 var import_node_url2 = require("node:url");
 var import_node_fs25 = require("node:fs");
@@ -55866,7 +55902,7 @@ function startServerDetached() {
   const { cmd, args, shell } = resolveServerStart();
   rotateLog();
   const fd = openLogFd();
-  const child = (0, import_node_child_process5.spawn)(cmd, args, {
+  const child = (0, import_node_child_process6.spawn)(cmd, args, {
     cwd: __dirname2,
     detached: true,
     stdio: fd == null ? "ignore" : ["ignore", fd, fd],
@@ -55876,13 +55912,13 @@ function startServerDetached() {
   child.unref();
 }
 function openBrowser2(url) {
-  if (isWin2) (0, import_node_child_process5.spawn)("cmd", ["/c", "start", "", url], { windowsHide: true }).unref();
-  else (0, import_node_child_process5.spawn)(process.platform === "darwin" ? "open" : "xdg-open", [url], { detached: true }).unref();
+  if (isWin2) (0, import_node_child_process6.spawn)("cmd", ["/c", "start", "", url], { windowsHide: true }).unref();
+  else (0, import_node_child_process6.spawn)(process.platform === "darwin" ? "open" : "xdg-open", [url], { detached: true }).unref();
 }
 function stopServer() {
   if (!isWin2) {
     try {
-      (0, import_node_child_process5.execSync)(`bash -lc "fuser -k ${PORT}/tcp"`, { stdio: "ignore" });
+      (0, import_node_child_process6.execSync)(`bash -lc "fuser -k ${PORT}/tcp"`, { stdio: "ignore" });
       return true;
     } catch {
       return false;
@@ -55890,7 +55926,7 @@ function stopServer() {
   }
   try {
     const ps = `$p = Get-NetTCPConnection -LocalPort ${PORT} -State Listen -ErrorAction SilentlyContinue | Select-Object -Expand OwningProcess -Unique; if ($p) { $p | ForEach-Object { taskkill /PID $_ /T /F } } else { exit 9 }`;
-    (0, import_node_child_process5.execSync)(`powershell -NoProfile -Command "${ps}"`, { stdio: "ignore" });
+    (0, import_node_child_process6.execSync)(`powershell -NoProfile -Command "${ps}"`, { stdio: "ignore" });
     return true;
   } catch {
     return false;
@@ -55942,7 +55978,7 @@ async function cmdSupervise() {
   if (isSeaChannel && !process.env[SUPERVISE_RESPAWN_ENV]) {
     rotateLog();
     const fd = openLogFd();
-    const child = (0, import_node_child_process5.spawn)(process.execPath, ["--supervise"], {
+    const child = (0, import_node_child_process6.spawn)(process.execPath, ["--supervise"], {
       detached: true,
       stdio: fd == null ? "ignore" : ["ignore", fd, fd],
       windowsHide: true,
@@ -55997,7 +56033,7 @@ function enumerateProcesses() {
   if (!isWin2) return [];
   try {
     const ps = "Get-CimInstance Win32_Process | Select-Object ProcessId,CommandLine | ConvertTo-Json -Compress";
-    const out = (0, import_node_child_process5.execSync)(`powershell -NoProfile -Command "${ps}"`, {
+    const out = (0, import_node_child_process6.execSync)(`powershell -NoProfile -Command "${ps}"`, {
       encoding: "utf8",
       windowsHide: true,
       maxBuffer: 16 * 1024 * 1024
@@ -56020,7 +56056,7 @@ function killSupervisor({ tree = true } = {}) {
   for (const pid of pids) {
     log(`stopping supervisor (pid ${pid})\u2026`);
     try {
-      (0, import_node_child_process5.execFileSync)("taskkill", taskkillArgs(pid, { tree }), { stdio: "ignore", windowsHide: true });
+      (0, import_node_child_process6.execFileSync)("taskkill", taskkillArgs(pid, { tree }), { stdio: "ignore", windowsHide: true });
     } catch {
     }
   }
@@ -56111,11 +56147,11 @@ async function cmdUpdate() {
 function removeRegistryFootprint() {
   if (!isWin2) return;
   try {
-    (0, import_node_child_process5.execFileSync)("reg", ["delete", RUN_KEY, "/v", RUN_VALUE, "/f"], { stdio: "ignore", windowsHide: true });
+    (0, import_node_child_process6.execFileSync)("reg", ["delete", RUN_KEY, "/v", RUN_VALUE, "/f"], { stdio: "ignore", windowsHide: true });
   } catch {
   }
   try {
-    (0, import_node_child_process5.execFileSync)("reg", ["delete", PROTOCOL_KEY, "/f"], { stdio: "ignore", windowsHide: true });
+    (0, import_node_child_process6.execFileSync)("reg", ["delete", PROTOCOL_KEY, "/f"], { stdio: "ignore", windowsHide: true });
   } catch {
   }
 }
@@ -56141,13 +56177,13 @@ async function cmdUninstall(flags = {}) {
   if (removeAware) {
     log("removing the AWARE runtime \u2014 this will affect ANY other tool that uses @aware-aeco/cli.");
     try {
-      (0, import_node_child_process5.execSync)("npm uninstall -g @aware-aeco/cli", { stdio: "inherit", shell: isWin2 });
+      (0, import_node_child_process6.execSync)("npm uninstall -g @aware-aeco/cli", { stdio: "inherit", shell: isWin2 });
     } catch {
       log('warning: "npm uninstall -g @aware-aeco/cli" failed \u2014 see the output above.');
     }
     let lsJson = "";
     try {
-      lsJson = (0, import_node_child_process5.execSync)("npm ls -g @aware-aeco/cli --depth=0 --json", {
+      lsJson = (0, import_node_child_process6.execSync)("npm ls -g @aware-aeco/cli --depth=0 --json", {
         encoding: "utf8",
         stdio: ["ignore", "pipe", "ignore"],
         shell: isWin2
@@ -58226,7 +58262,7 @@ async function startServer() {
   const isWin3 = process.platform === "win32";
   const has = (cmd) => {
     try {
-      (0, import_node_child_process6.execFileSync)(isWin3 ? "where" : "which", [cmd], { stdio: "ignore", windowsHide: true, timeout: 5e3 });
+      (0, import_node_child_process7.execFileSync)(isWin3 ? "where" : "which", [cmd], { stdio: "ignore", windowsHide: true, timeout: 5e3 });
       return true;
     } catch {
       return false;
@@ -58235,7 +58271,7 @@ async function startServer() {
   function installAwareGlobal(spec, onLine = () => {
   }) {
     return new Promise((resolve6, reject) => {
-      const child = (0, import_node_child_process6.spawn)("npm", ["i", "-g", `@aware-aeco/cli@${spec}`], { shell: isWin3, windowsHide: true });
+      const child = (0, import_node_child_process7.spawn)("npm", ["i", "-g", `@aware-aeco/cli@${spec}`], { shell: isWin3, windowsHide: true });
       let stderrTail = "";
       let combinedTail = "";
       const tail = (buf, s) => (buf + s).slice(-4e3);
@@ -58625,7 +58661,14 @@ async function startServer() {
         const first = v.errors[0];
         return reply.status(400).send({ ok: false, error: `contract failed schema validation \u2014 ${first ? `${first.path}: ${first.message}` : "invalid"}` });
       }
-      const target = typeof req.body?.target === "number" ? req.body.target : 70;
+      const docTarget = doc2 && typeof doc2 === "object" ? doc2.target_confidence : void 0;
+      let appDefault = 70;
+      try {
+        const inp = readApp(req.params.appId).inputs.find((i) => i.name === "target_confidence");
+        if (typeof inp?.default === "number") appDefault = inp.default;
+      } catch {
+      }
+      const target = typeof req.body?.target === "number" ? req.body.target : typeof docTarget === "number" ? docTarget : appDefault;
       const result = scoreContract2(doc2);
       const meetsTarget = result.score != null && result.score >= target;
       return {
@@ -58637,6 +58680,19 @@ async function startServer() {
       };
     }
   );
+  app.post(
+    "/api/contract/:appId/scene",
+    async (req, reply) => {
+      const doc2 = req.body && "contract" in req.body ? req.body.contract : readContract(req.params.appId);
+      if (doc2 == null) return reply.status(404).send({ ok: false, error: "no contract to render" });
+      const v = validateSteelTakeoff(doc2);
+      if (!v.valid) {
+        const first = v.errors[0];
+        return reply.status(400).send({ ok: false, error: `contract failed schema validation \u2014 ${first ? `${first.path}: ${first.message}` : "invalid"}` });
+      }
+      return { ok: true, ...contractToScene(doc2) };
+    }
+  );
   function awareStderr(e) {
     if (e instanceof AwareError && e.detail && typeof e.detail === "object") {
       const s = e.detail.stderr;
@@ -58732,9 +58788,10 @@ async function startServer() {
       return reply.status(422).send({ ok: false, error: "no resolvable members to bake \u2014 every member is an RFI (no AISC size yet)", skipped });
     }
     const companionId = `${req.params.appId}-tekla`;
+    const teklaVersion = await teklaVersionToBake();
     let flo;
     try {
-      flo = writeTeklaApp(appPath(companionId), companionId, scene);
+      flo = writeTeklaApp(appPath(companionId), companionId, scene, teklaVersion);
     } catch (e) {
       app.log.error({ companionId, err: e instanceof Error ? e.message : e }, "export-tekla: companion app write failed");
       return reply.status(500).send({ ok: false, error: `could not write the Tekla companion app: ${e instanceof Error ? e.message : "write error"}` });
@@ -59526,10 +59583,10 @@ async function startServer() {
 }
 
 // protocol.ts
-var import_node_child_process7 = require("node:child_process");
+var import_node_child_process8 = require("node:child_process");
 var BASE = PROTOCOL_KEY;
 function reg(args) {
-  (0, import_node_child_process7.execFileSync)("reg", args, { stdio: "ignore", windowsHide: true });
+  (0, import_node_child_process8.execFileSync)("reg", args, { stdio: "ignore", windowsHide: true });
 }
 function registerProtocol(exePath) {
   if (process.platform !== "win32") return;
@@ -59569,13 +59626,13 @@ async function removeAwarePerDecision(removeAwareFlag, prompt) {
   );
   const shell = process.platform === "win32" ? process.env.ComSpec || "cmd.exe" : "/bin/sh";
   try {
-    (0, import_node_child_process8.execSync)("npm uninstall -g @aware-aeco/cli", { stdio: "inherit", shell });
+    (0, import_node_child_process9.execSync)("npm uninstall -g @aware-aeco/cli", { stdio: "inherit", shell });
   } catch {
     process.stdout.write('floless: warning: "npm uninstall -g @aware-aeco/cli" failed \u2014 see the output above.\n');
   }
   let lsJson = "";
   try {
-    lsJson = (0, import_node_child_process8.execSync)("npm ls -g @aware-aeco/cli --depth=0 --json", {
+    lsJson = (0, import_node_child_process9.execSync)("npm ls -g @aware-aeco/cli --depth=0 --json", {
       encoding: "utf8",
       stdio: ["ignore", "pipe", "ignore"],
       shell

package/dist/schemas/steel.takeoff.v1.schema.json

@@ -8,6 +8,7 @@
   "additionalProperties": true,
   "properties": {
     "type": { "const": "steel.takeoff/v1", "description": "Renderer-registry discriminator." },
+    "target_confidence": { "type": "number", "minimum": 0, "maximum": 100, "description": "User's per-read confidence target (%); overrides the app's target_confidence input default. The editor chip and the /score endpoint use it." },
     "active": { "type": "integer", "description": "Index into plans of the active sheet." },
     "palette": { "type": "array", "items": { "type": "string" }, "description": "Default per-index profile colours." },
     "weights": { "type": "object", "additionalProperties": { "type": ["number", "null"] }, "description": "profile -> plf (pounds per linear foot), from the AISC lookup. null for an unresolved profile (e.g. an unsized moment-frame mark) that has no weight yet." },

package/dist/skills/floless-app-steel-takeoff/SKILL.md

@@ -117,9 +117,12 @@ Follow the methodology condensed here (full detail + every gotcha in
 
 ### 3. Honor `target_confidence` — score, then LOOP to the goal
 
-Read the app's `target_confidence` input (default 70). The confidence score is a **deterministic
-function of observable evidence** — not a model self-report — so you measure it with the server,
-never by eyeballing. Per-member bands (full method in
+Read the app's `target_confidence` input (default 70). The user may also set a **per-read override**
+via the editor (stored as a top-level `target_confidence` on the contract); it wins over the input
+default. On a **re-read / rebake**, preserve any `target_confidence` already on the existing contract
+(carry it into the new draft) so the user's chosen target isn't reset. The confidence score is a
+**deterministic function of observable evidence** — not a model self-report — so you measure it with
+the server, never by eyeballing. Per-member bands (full method in
 `docs/superpowers/specs/2026-06-20-steel-takeoff-confidence-report.md`):
 
 - **Verified (1.0)** — human-confirmed. **High (0.9)** — resolved from drawing evidence, no contradiction.

package/dist/web/package.json

@@ -0,0 +1,5 @@
+{
+  "private": true,
+  "type": "module",
+  "//": "Marks web/*.js as ES modules so node (the steel-3d-core unit tests) and the browser agree. Not an npm package — just a module-type marker. The browser ignores it; the bundle copies it harmlessly."
+}

package/dist/web/steel-3d-core.js

@@ -0,0 +1,137 @@
+/*
+ * steel-3d-core.js — PURE, framework-free core for the steel 3D editor (no Three.js, no DOM, no
+ * window). Unit-tested in node (server/steel-3d-core.test.ts) AND loaded by web/steel-3d-view.js.
+ * This is the extraction-ready unit: the generic snap engine + the typed-candidate model are what
+ * later lift into AWARE viewer-3d; only `snapCandidates` (beam top-flange centerline, column
+ * plan-center) is steel-specific.
+ *
+ * Coordinate map MUST match server/contract-to-scene.ts (the bake) so editing-space == render-space:
+ *   scene is mm, Z-up. mmX = dispX·k, mmY = -dispY·k   (k = FT_TO_MM / pt_per_ft, Y flipped),
+ *   mmZ = elevation_inches · IN_TO_MM. planPointToWp is the inverse (editing-only; the bake never
+ *   needs it).
+ */
+
+export const FT_TO_MM = 304.8;
+export const IN_TO_MM = 25.4;
+
+const kOf = (ptPerFt) => FT_TO_MM / (ptPerFt > 0 ? ptPerFt : 1);
+
+const nz = (n) => n + 0; // normalize -0 → 0 (negating 0 yields -0, which surprises equality checks)
+
+/** display-space wp point → scene mm [x,y] (Y flipped, matching contractToScene.dispToMm). */
+export function dispToMm(pt, ptPerFt) { const k = kOf(ptPerFt); return [nz(pt[0] * k), nz(-pt[1] * k)]; }
+
+/** scene mm point [x,y,…] → display-space wp [px,py] (inverse of dispToMm). */
+export function planPointToWp(p, ptPerFt) { const k = kOf(ptPerFt); return [nz(p[0] / k), nz(-p[1] / k)]; }
+
+/**
+ * member → its 3D centerline `{ kind, line:[[x,y,z],[x,y,z]] }` in mm, matching contractToScene's
+ * from/to. Beam: work-line at T.O.S. Column: vertical at the plan point, bos→tos.
+ */
+export function memberGeometry(m, ptPerFt, defaultTosMm = 0) {
+  const a = dispToMm(m.wp[0], ptPerFt), b = dispToMm(m.wp[1], ptPerFt);
+  if (m.role === 'column') {
+    const bos = m.col && m.col.bos != null ? m.col.bos * IN_TO_MM : 0;
+    const tos = m.col && m.col.tos != null ? m.col.tos * IN_TO_MM : defaultTosMm;
+    return { kind: 'column', line: [[a[0], a[1], bos], [a[0], a[1], tos]] };
+  }
+  const e = m.ends || [];
+  const z0 = e[0] && e[0].tos != null ? e[0].tos * IN_TO_MM : defaultTosMm;
+  const z1 = e[1] && e[1].tos != null ? e[1].tos * IN_TO_MM : defaultTosMm;
+  return { kind: 'beam', line: [[a[0], a[1], z0], [b[0], b[1], z1]] };
+}
+
+/** XY intersection point of segments a-b and c-d (within both), or null (parallel / outside). */
+function segXY(a, b, c, d) {
+  const rx = b[0] - a[0], ry = b[1] - a[1], sx = d[0] - c[0], sy = d[1] - c[1];
+  const rxs = rx * sy - ry * sx;
+  if (Math.abs(rxs) < 1e-9) return null; // parallel/collinear
+  const qpx = c[0] - a[0], qpy = c[1] - a[1];
+  const t = (qpx * sy - qpy * sx) / rxs, u = (qpx * ry - qpy * rx) / rxs;
+  if (t < 0 || t > 1 || u < 0 || u > 1) return null; // crossing lies outside a segment
+  return [a[0] + rx * t, a[1] + ry * t];
+}
+
+/**
+ * Snap targets from the other members (the dragged one excluded). Beam → its top-flange centerline
+ * (the work-line at T.O.S) + endpoint vertices + a midpoint. Column → a vertical axis at its plan
+ * point + endpoint vertices. Plus member-member centerline INTERSECTIONS (Tekla-standard). Each
+ * tagged `fromId`. Generic `grid-line` targets (from plan grids) plug in here too.
+ */
+export function snapCandidates(members, ptPerFt, defaultTosMm, excludeId) {
+  const out = [];
+  const lines = []; // beam centerlines, for pairwise intersections
+  for (const m of members || []) {
+    if (!m || m.id === excludeId || !Array.isArray(m.wp) || m.wp.length < 2) continue;
+    const { kind, line } = memberGeometry(m, ptPerFt, defaultTosMm);
+    const [p0, p1] = line;
+    if (kind === 'column') { out.push({ type: 'vertical-axis', p: p0, fromId: m.id }); }
+    else {
+      out.push({ type: 'centerline', a: p0, b: p1, fromId: m.id });
+      out.push({ type: 'midpoint', p: [(p0[0] + p1[0]) / 2, (p0[1] + p1[1]) / 2, (p0[2] + p1[2]) / 2], fromId: m.id });
+      lines.push({ id: m.id, p0, p1 });
+    }
+    out.push({ type: 'vertex', p: p0, fromId: m.id });
+    out.push({ type: 'vertex', p: p1, fromId: m.id });
+  }
+  for (let i = 0; i < lines.length; i++) {
+    for (let j = i + 1; j < lines.length; j++) {
+      const x = segXY(lines[i].p0, lines[i].p1, lines[j].p0, lines[j].p1);
+      if (x) out.push({ type: 'intersection', p: [x[0], x[1], (lines[i].p0[2] + lines[j].p0[2]) / 2], fromIds: [lines[i].id, lines[j].id] });
+    }
+  }
+  return out;
+}
+
+/**
+ * Distinct elevation levels (mm, sorted) among the OTHER members' endpoints — the snap targets for a
+ * vertical (Alt) drag, so a member can be raised/lowered onto another's T.O.S level. The caller turns
+ * each level into a point candidate at the dragged member's plan X/Y and reuses snapPoint().
+ */
+export function elevationLevels(members, ptPerFt, defaultTosMm, excludeId) {
+  const set = new Set();
+  for (const m of members || []) {
+    if (!m || m.id === excludeId || !Array.isArray(m.wp) || m.wp.length < 2) continue;
+    const { line } = memberGeometry(m, ptPerFt, defaultTosMm);
+    set.add(Math.round(line[0][2])); set.add(Math.round(line[1][2]));
+  }
+  return [...set].sort((a, b) => a - b);
+}
+
+// Lower wins when two candidates are both within tolerance.
+const PRECEDENCE = { vertex: 0, intersection: 1, midpoint: 2, centerline: 3, 'vertical-axis': 4, 'grid-line': 5, level: 1 };
+
+function closestOnSeg(p, a, b) {
+  const ab = [b[0] - a[0], b[1] - a[1], b[2] - a[2]];
+  const len2 = ab[0] * ab[0] + ab[1] * ab[1] + ab[2] * ab[2] || 1;
+  let t = ((p[0] - a[0]) * ab[0] + (p[1] - a[1]) * ab[1] + (p[2] - a[2]) * ab[2]) / len2;
+  t = Math.max(0, Math.min(1, t));
+  return [a[0] + ab[0] * t, a[1] + ab[1] * t, a[2] + ab[2] * t];
+}
+
+/** The 3D point a candidate proposes for the dragged point. */
+function candidatePoint(c, dragged) {
+  if (c.type === 'vertex' || c.type === 'intersection' || c.type === 'midpoint' || c.type === 'level') return c.p; // fixed points
+  if (c.type === 'vertical-axis') return [c.p[0], c.p[1], dragged[2]]; // lock plan X/Y to the axis, keep dragged Z
+  return closestOnSeg(dragged, c.a, c.b);                              // centerline / grid-line
+}
+
+/**
+ * Snap `dragged` (3D mm) to the nearest candidate within `tolPx` SCREEN pixels. `toScreen` maps a 3D
+ * mm point → `{x,y}` screen px (injected — keeps this DOM-free). Ties within tolerance break by
+ * PRECEDENCE (endpoint > intersection > centerline > axis > grid). Returns `{ snapped, candidate }`;
+ * candidate is null (and snapped === dragged) when nothing is in range.
+ */
+export function snapPoint(dragged, candidates, toScreen, tolPx) {
+  const ds = toScreen(dragged);
+  let best = null, bestPt = null, bestPrec = Infinity, bestD = Infinity;
+  for (const c of candidates || []) {
+    const pt = candidatePoint(c, dragged);
+    const s = toScreen(pt);
+    const d = Math.hypot(s.x - ds.x, s.y - ds.y);
+    if (d > tolPx) continue;
+    const prec = PRECEDENCE[c.type] ?? 9;
+    if (prec < bestPrec || (prec === bestPrec && d < bestD)) { best = c; bestPt = pt; bestPrec = prec; bestD = d; }
+  }
+  return best ? { snapped: bestPt, candidate: best } : { snapped: dragged, candidate: null };
+}