@floless/app 0.63.0 → 0.65.0

package/dist/floless-server.cjs

@@ -53022,7 +53022,7 @@ function appVersion() {
   return resolveVersion({
     isSea: isSea2(),
     sqVersionXml: readSqVersionXml(),
-    define: true ? "0.63.0" : void 0,
+    define: true ? "0.65.0" : void 0,
     pkgVersion: readPkgVersion()
   });
 }
@@ -53032,7 +53032,7 @@ function resolveChannel(s) {
   return "dev";
 }
 function appChannel() {
-  return resolveChannel({ isSea: isSea2(), define: true ? "0.63.0" : void 0 });
+  return resolveChannel({ isSea: isSea2(), define: true ? "0.65.0" : void 0 });
 }
 
 // workflow-update.ts
@@ -59133,14 +59133,16 @@ function writeViewer3dApp(dir, appId, scene) {
   bakeSceneIntoApp(flo, scene);
   return flo;
 }
-function writeIfcApp(dir, appId, scene, outputPath) {
+function writeIfcApp(dir, appId, scene, outputPath, opts = {}) {
   (0, import_node_fs20.mkdirSync)(dir, { recursive: true });
   const flo = (0, import_node_path17.join)(dir, `${appId}.flo`);
+  const displayName = opts.displayName ?? "Steel IFC";
+  const description = opts.description ?? "IFC file written from an approved steel.takeoff/v1 contract (a companion export; the contract is the source of truth).";
   (0, import_node_fs20.writeFileSync)(flo, [
     `app: ${appId}`,
     "version: 0.1.0",
-    "display-name: Steel IFC",
-    "description: IFC file written from an approved steel.takeoff/v1 contract (a companion export; the contract is the source of truth).",
+    `display-name: ${displayName}`,
+    `description: ${description}`,
     "exposes-as-agent: false",
     "requires:",
     "  - ifc@0.1.x",
@@ -64076,7 +64078,7 @@ async function startServer() {
     { bodyLimit: 25 * 1024 * 1024 },
     // contracts embed rasters (matches PUT /api/contract) — the editor POSTs the live contract on every 3D rebuild
     async (req, reply) => {
-      const doc = req.body && "contract" in req.body ? req.body.contract : readContract(req.params.appId);
+      const doc = req.body && "contract" in req.body ? req.body.contract : readContractForApp(req.params.appId);
       if (doc == null) return reply.status(404).send({ ok: false, error: "no contract to render" });
       if (doc && typeof doc === "object" && doc.type === "drawing.vector/v1") {
         const cleaned = postProcess(doc);
@@ -64142,20 +64144,41 @@ async function startServer() {
     return { ok: true, report: { ...extracted, interactive: true }, skipped };
   });
   app.post("/api/contract/:appId/export-ifc", async (req, reply) => {
-    const doc = readContract(req.params.appId);
+    const doc = readContractForApp(req.params.appId);
     if (doc == null) return reply.status(404).send({ ok: false, error: "no contract to export" });
-    const v = validateSteelTakeoff(doc);
-    if (!v.valid) return reply.status(400).send({ ok: false, error: "stored contract is invalid \u2014 re-save it in the editor" });
-    const { scene, skipped } = contractToScene(doc);
+    const isVector = typeof doc === "object" && doc != null && doc.type === "drawing.vector/v1";
+    let scene;
+    let skipped;
+    let extrusionsSkipped = 0;
+    let writeOpts;
+    let emptyError;
+    if (isVector) {
+      const cleaned = postProcess(doc);
+      const vv = validateContract(cleaned);
+      if (!vv.valid) return reply.status(400).send({ ok: false, error: "stored contract is invalid \u2014 re-save it in the editor" });
+      const built = viewsToScene(cleaned);
+      extrusionsSkipped = built.scene.elements.filter((e) => e.kind === "extrusion").length;
+      scene = { ...built.scene, elements: built.scene.elements.filter((e) => e.kind === "box") };
+      skipped = built.skipped;
+      writeOpts = { displayName: "Drawing IFC", description: "IFC file written from a reconstructed drawing.vector/v1 model (member geometry only; a companion export)." };
+      emptyError = extrusionsSkipped > 0 ? `no member geometry to export \u2014 this model is ${extrusionsSkipped} extruded ${extrusionsSkipped === 1 ? "body" : "bodies"}, which don't export to IFC yet` : "no 3D to export \u2014 reconstruct a plan + elevation first (open View 3D to see what's missing)";
+    } else {
+      const v = validateSteelTakeoff(doc);
+      if (!v.valid) return reply.status(400).send({ ok: false, error: "stored contract is invalid \u2014 re-save it in the editor" });
+      const built = contractToScene(doc);
+      scene = built.scene;
+      skipped = built.skipped;
+      emptyError = "no resolvable members to export \u2014 every member is an RFI (no AISC size yet)";
+    }
     if (scene.elements.length === 0) {
-      return reply.status(422).send({ ok: false, error: "no resolvable members to export \u2014 every member is an RFI (no AISC size yet)", skipped });
+      return reply.status(422).send({ ok: false, error: emptyError, skipped });
     }
     const companionId = `${req.params.appId}-ifc`;
     const filename = `${req.params.appId}.ifc`;
     const outPath = (0, import_node_path28.join)(appPath(companionId), filename);
     let flo;
     try {
-      flo = writeIfcApp(appPath(companionId), companionId, scene, outPath);
+      flo = writeIfcApp(appPath(companionId), companionId, scene, outPath, writeOpts);
     } catch (e) {
       app.log.error({ companionId, err: e instanceof Error ? e.message : e }, "export-ifc: companion app write failed");
       return reply.status(500).send({ ok: false, error: `could not write the IFC companion app: ${e instanceof Error ? e.message : "write error"}` });
@@ -64178,7 +64201,7 @@ async function startServer() {
     if (!(0, import_node_fs30.existsSync)(outPath)) return reply.send({ ok: false, error: "the IFC export produced no file" });
     const content = (0, import_node_fs30.readFileSync)(outPath, "utf8");
     broadcast({ type: "apps-changed" });
-    return { ok: true, filename, content, bytes: Buffer.byteLength(content), skipped };
+    return { ok: true, filename, content, bytes: Buffer.byteLength(content), skipped, ...extrusionsSkipped ? { extrusionsSkipped } : {} };
   });
   app.post("/api/contract/:appId/export-tekla", async (req, reply) => {
     const doc = readContract(req.params.appId);

package/dist/skills/floless-app-vectorize/SKILL.md

@@ -1,8 +1,8 @@
 ---
 name: floless-app-vectorize
-description: Vectorize a drawing into an editable drawing.vector/v1 contract in floless.app — the "Vectorize" reader. Triggers on a pending floless `rebake` request for the `vectorize` app (queued from its "Re-read & re-bake ▸" button), or asks like "vectorize this PDF", "turn my sketch into clean CAD linework", "read this detail into vectors", "trace this photo". Teaches the host AI to read a drawing at COMPOSE time — a vector PDF via ONE deterministic PyMuPDF pass (no LLM), a scan/photo/hand sketch via AWARE's fenced vision.extract (schema-bound, cached) — emit the drawing.vector/v1 contract, PUT it to the contract store, and hand the 2D vector editor to the user.
+description: Vectorize a drawing into an editable drawing.vector/v1 contract in floless.app — the "Vectorize" reader. Triggers on a pending floless `rebake` request for the `vectorize` app (queued from its "Re-read & re-bake ▸" button), or asks like "vectorize this PDF", "turn my sketch into clean CAD linework", "read this detail into vectors", "trace this photo", "make this drawing 3D". Teaches the host AI to read a drawing at COMPOSE time — a vector PDF via ONE deterministic PyMuPDF pass (no LLM), a scan/photo/hand sketch via AWARE's fenced vision.extract (schema-bound, cached) — emit the drawing.vector/v1 contract, PUT it to the contract store, and hand the 2D vector editor to the user; and, for a multi-view set (plan + elevation), to classify views, read datums, and declare entities so the server reconstructs a viewable 3D model.
 metadata:
-  version: 0.3.0
+  version: 0.4.0
 ---
 
 # Vectorize — read a drawing into a drawing.vector/v1 contract
@@ -26,8 +26,14 @@ The drawing is read **at compose time**, by one of two paths:
 There is **no model in the run path** either way. The app ships with a tiny hard-coded
 example; this skill is how the user's OWN drawing replaces it.
 
-**Later slices (mention as "next", do not attempt here):** multi-view 3D reconstruction,
-DXF export.
+A **multi-view set** (a plan plus an elevation/section of the same object) can additionally be
+**reconstructed in 3D**: the skill's multi-view pass (step 3c) adds view classification, datums
+and entity declarations to the contract, and the server's deterministic reconstruction renders
+it in the **View 3D** viewer — members and extruded bodies, with everything unplaceable listed
+honestly with a reason.
+
+**Later slices (mention as "next", do not attempt here):** DXF export, placing details into a
+live model.
 
 > **Pasted a request?** If the user pastes a message beginning with a `[floless-request
 > type=rebake id=…]` marker, that's a request copied from the FloLess Dashboard — resolve it
@@ -119,6 +125,50 @@ For each raster image (or rasterized PDF page exported to an image):
    the vision output matches what the drawing actually says. A wildly wrong trace usually means
    the image is too low-contrast — say so rather than shipping garbage.
 
+### 3c. Multi-view pass — make a plan + elevation set 3D (optional)
+
+Run this ONLY when the set contains **multiple views of one object** and the user wants 3D.
+Prerequisite discipline: `reading-structural-drawings` — **massing + coordinate frame FIRST**,
+entities last, cross-validate every view. All fields below are additive on the contract the
+2D pass (3a/3b) already produced; the server's reconstruction (`views-to-scene`) is
+deterministic and **refuses to guess** — anything you leave unresolved lands in the 3D view's
+"Not shown in 3D" list with a reason, never at a made-up position.
+
+1. **Classify every sheet** — set `sheets[].view`:
+   `{ kind: 'plan'|'elevation'|'section'|'detail', dir, datum }`. `dir` is the observer look
+   direction in world axes (a plan looks `-z`; a south elevation looks `+y`; a west-looking
+   section `+x`). **Cross-validate the scale of each axis pair with one known dimension**
+   (a labeled length that appears in both views) before trusting it — a wrong `dir` or scale
+   silently mirrors or misplaces the model. **Show the user the classification and get an OK**
+   ("s1 = plan at 1:50, s2 = south elevation — reconstruct from these?") before writing 3D
+   fields — this is the same confirm gate the steel reader uses before its heavy pass.
+2. **One world frame.** Give every sheet a `transform` (`scale` = world units per display unit,
+   `origin` = the display point that is world [0,0], `rotation` if the frame is turned) chosen
+   so the views AGREE: pick one shared reference (a grid intersection, a corner that appears in
+   both views) as the common origin. World units are the contract's `units` (mm canonical).
+3. **Datums** — read the height ladder off the elevation (level lines + labels) into the
+   top-level `datums: [{ id:'lv1', kind:'level', axis:'z', value:<world units>, label, sheet }]`.
+   Grid lines go in the same array with `axis:'x'|'y'`. Only `z` datums can drive heights.
+4. **Entities** — group the linework into `sheets[].groups`:
+   - a **member** (beam/bar/stud seen along its axis): `axis: [[x0,y0],[x1,y1]]` (this sheet's
+     display coords) + `section: { w, d }` in WORLD units — from a callout or a dimension, never
+     eyeballed;
+   - an **extruded body** (plate/wall/slab footprint): `footprint: [[x,y]…]` +
+     `extrude: { from, to }` where each end is a **z-datum id** or a world number. A present
+     extrude that doesn't resolve is an ERROR (surfaced, not guessed) — omit `extrude` entirely
+     if the height must come from the elevation instead;
+   - annotation groups (labels, dims) get neither — they simply don't build.
+5. **Links** — where a section mark or the drawing itself says two groups are the same object in
+   two views, add `links: [{ kind:'same-entity', a:{sheet,id}, b:{sheet,id} }]` (ids are only
+   sheet-unique — always the composite). A linked elevation entity gives its plan twin the
+   Z extent directly; unlinked entities are matched by their shared horizontal span, and
+   **anything ambiguous (two elevation entities over the same span) is skipped until you link it**.
+6. **PUT** the contract (step 4) and **open View 3D ▸** on the read node. Work the
+   "Not shown in 3D" panel like a worklist: each row says exactly what is missing (a datum, a
+   link, an extrude); fix the contract, re-PUT, reopen. Reconstructed members export through the
+   existing 3D/IFC path later; extruded bodies render in FloLess's own viewer only for now —
+   say so if the user asks about IFC.
+
 ### 4. Write to the contract store
 
 ```
@@ -147,6 +197,9 @@ Tell the user:
 - **Approve & bake lock**: when satisfied, the user clicks Approve in the editor header — it
   bakes the (edited) contract into the `read` node's `config.takeoff` and recompiles, arming
   the Run gate. Never auto-approve on their behalf.
+- **View 3D ▸** (after a multi-view pass, step 3c): the node action opens the read-only
+  reconstruction viewer — orbit/pan/zoom, solid/wire/x-ray, per-group toggles, and the
+  "Not shown in 3D" panel listing every entity that couldn't be placed, with the reason.
 
 ### 6. Clear the request
 

package/dist/web/aware.js

@@ -1360,6 +1360,14 @@
       // openContractEditor() returns false and the click would silently do nothing.
       if (contractType && window.CONTRACT_RENDERERS && window.CONTRACT_RENDERERS[contractType]) {
         addNodeAction(card, 'Edit contract ▸', () => openContractEditor(currentId, contractType));
+        // A renderer with a LOCAL 3D viewer (the drawing.vector reconstruction) gets View 3D via
+        // that page — distinct from the steel `scene` chain below (AWARE exporter companions).
+        if (window.CONTRACT_RENDERERS[contractType].viewerUrl) {
+          addNodeAction(card, 'View 3D ▸', () => openLocalViewer(currentId, contractType));
+          // A reconstructed model's MEMBER geometry exports to IFC through the same companion as
+          // steel (extruded bodies are view-only for now — the server says so if there's nothing).
+          addNodeAction(card, 'Export IFC ▸', () => exportContractIfc(currentId, true)); // isVector → "unplaced" skip wording
+        }
         // The 3D/IFC/BOM/Tekla chain derives a scene from the contract — only contract types that
         // declare `scene` support it (a drawing.vector node would 4xx on these endpoints).
         if (window.CONTRACT_RENDERERS[contractType].scene) {
@@ -1770,6 +1778,21 @@
     $contractEditor.hidden = false;
     return true;
   }
+  // A renderer-declared LOCAL viewer page (e.g. the drawing.vector 3D reconstruction) — reuses the
+  // contract-editor overlay/iframe. Read-only: no Approve (the editor owns that gate).
+  function openLocalViewer(appId, type) {
+    const r = window.CONTRACT_RENDERERS && window.CONTRACT_RENDERERS[type];
+    if (!r || !r.viewerUrl) return false;
+    const ap = document.getElementById('contract-editor-approve'); if (ap) ap.hidden = true;
+    $contractEditorTitle.replaceChildren(
+      Object.assign(document.createElement('span'), { textContent: appId, style: 'color:var(--text);font-weight:600' }),
+      Object.assign(document.createElement('span'), { textContent: ' · 3D view', style: 'color:var(--text-muted)' }),
+    );
+    $contractEditorFrame.onload = () => { try { $contractEditorFrame.contentWindow.focus(); } catch (_) {} };
+    $contractEditorFrame.src = r.viewerUrl(appId);
+    $contractEditor.hidden = false;
+    return true;
+  }
   // The steel filter pre-stage view — reuses the contract-editor overlay/iframe to load the served
   // steel-filter.html (layer/thickness/colour facets + eyedropper). Same seam as the editor: the
   // iframe talks to /api/contract directly and Save writes contract.filter.
@@ -1842,7 +1865,7 @@
   // Export IFC ▸ — write the approved takeoff OUT to a universal .ifc and download it. The server
   // builds a model-free ifc companion, runs it, and returns the .ifc text (res.content); the browser
   // turns it into a download. api() throws on any failure (no contract, all-RFI, compile/write error).
-  async function exportContractIfc(appId) {
+  async function exportContractIfc(appId, isVector) {
     showToast('Generating IFC…', 'info');
     try {
       const res = await api('/api/contract/' + encodeURIComponent(appId) + '/export-ifc', { method: 'POST' });
@@ -1853,7 +1876,13 @@
       document.body.appendChild(a); a.click(); a.remove();
       setTimeout(() => URL.revokeObjectURL(url), 4000);
       const dropped = Array.isArray(res.skipped) ? res.skipped.length : 0;
-      showToast(`IFC downloaded — ${res.filename || appId + '.ifc'}${dropped ? ` · ${dropped} RFI member(s) skipped` : ''}`, 'ok');
+      // Skip wording differs by contract: steel `skipped` = RFI members (no AISC size); a vector
+      // reconstruction's `skipped` = unplaced entities, plus extruded bodies (extrusionsSkipped)
+      // that don't export to IFC yet. Label each honestly.
+      const notes = [];
+      if (dropped) notes.push(isVector ? `${dropped} unplaced` : `${dropped} RFI member${dropped === 1 ? '' : 's'}`);
+      if (res.extrusionsSkipped) notes.push(`${res.extrusionsSkipped} extruded ${res.extrusionsSkipped === 1 ? 'body' : 'bodies'} (view-only)`);
+      showToast(`IFC downloaded — ${res.filename || appId + '.ifc'}${notes.length ? ' · ' + notes.join(', ') + ' skipped' : ''}`, 'ok');
     } catch (e) {
       showToast('IFC export failed: ' + (e && e.message ? e.message : String(e)), 'warn');
     }

package/dist/web/renderers.js

@@ -19,6 +19,9 @@ window.CONTRACT_RENDERERS = {
   },
   'drawing.vector/v1': {
     editorUrl: (appId) => '/vector-editor.html?app=' + encodeURIComponent(appId),
+    // Local read-only 3D reconstruction viewer (views-to-scene) — NOT the AWARE exporter chain
+    // (`scene`), which only steel supports; extrusion bodies render floless-side only for now.
+    viewerUrl: (appId) => '/vector-3d.html?app=' + encodeURIComponent(appId),
   },
 };
 

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

@@ -280,6 +280,43 @@ function placePlate(mesh, el) {
   mesh.position.set(...(el.center || [0, 0, 0]));
 }
 
+// Signed area of a closed 2D polygon (shoelace) — used to reject a zero-area/collinear footprint.
+function shoelaceArea(pts) {
+  let a = 0;
+  for (let i = 0, n = pts.length; i < n; i++) {
+    const p = pts[i], q = pts[(i + 1) % n];
+    a += p[0] * q[1] - q[0] * p[1];
+  }
+  return a / 2;
+}
+
+// A vertical extrusion of an arbitrary world-XY footprint between two Z values — the multi-view
+// reconstruction's generic body (a plate, wall or slab read from a plan + elevation; see
+// server/views-to-scene.ts). Same ExtrudeGeometry recipe as placePlate, but the outline is the
+// element's own polygon in WORLD coordinates and the sweep is always +Z, so no basis rotation.
+function placeExtrusion(mesh, el) {
+  const fp = el.footprint || [];
+  // Reject a degenerate outline (fewer than 3 vertices, or a zero-area collinear loop by the
+  // shoelace test) — ExtrudeGeometry on it produces a NaN/empty body, not an honest shape.
+  if (fp.length < 3 || Math.abs(shoelaceArea(fp)) < 1e-6) { mesh.geometry = new THREE.BufferGeometry(); return; }
+  const shape = new THREE.Shape();
+  shape.moveTo(fp[0][0], fp[0][1]);
+  for (let i = 1; i < fp.length; i++) shape.lineTo(fp[i][0], fp[i][1]);
+  shape.closePath();
+  for (const h of el.holes || []) { // optional opening loops (same world-XY polygon form)
+    if (!h || h.length < 3) continue;
+    const hole = new THREE.Path();
+    hole.moveTo(h[0][0], h[0][1]);
+    for (let i = 1; i < h.length; i++) hole.lineTo(h[i][0], h[i][1]);
+    hole.closePath();
+    shape.holes.push(hole);
+  }
+  const z0 = Math.min(el.from || 0, el.to || 0), z1 = Math.max(el.from || 0, el.to || 0);
+  mesh.geometry = new THREE.ExtrudeGeometry(shape, { depth: Math.max(z1 - z0, 0.5), bevelEnabled: false });
+  mesh.quaternion.identity();
+  mesh.position.set(0, 0, z0); // the shape carries world XY; lift the slab to its bottom face
+}
+
 // A cylinder between two points (anchor rod / bolt shank).
 function placeBar(mesh, a, b, r, radial) {
   const A = V(a[0], a[1], a[2]), B = V(b[0], b[1], b[2]);
@@ -331,6 +368,7 @@ function placeWasher(mesh, el) {
 function placeElement(mesh, el) {
   switch (el.kind || 'box') {
     case 'box': placeMember(mesh, el.from, el.to, el); return true;
+    case 'extrusion': placeExtrusion(mesh, el); return true;
     case 'plate': placePlate(mesh, el); return true;
     case 'rod': placeBar(mesh, el.from, el.to, Math.max((el.d || 20) / 2, 0.5), 16); return true;
     case 'nut': placeNut(mesh, el); return true;
@@ -1962,11 +2000,13 @@ function onDown(e) {
     const geo = m ? memberGeometry(m, ppf, dtos) : null;
     const mesh = meshById.get(id);
     const planeZ = geo ? (geo.line[0][2] + geo.line[1][2]) / 2 : 0;
+    const ctrl = e.ctrlKey || e.metaKey;
     pending = {
-      id, ctrl: e.ctrlKey || e.metaKey, ppf, planeZ,
+      id, ctrl, ppf, planeZ,
+      copy: ctrl, copyIds: ctrl ? (selIds.has(id) ? [...selIds] : [id]) : null,  // Ctrl+drag copies: the selection if this member is in it, else just it
       grab: geo ? rayToPlane(e.clientX, e.clientY, planeZ) : null,
       origMm: geo ? geo.line.map((p) => [p[0], p[1], p[2]]) : null,
-      candidates: allCandidates(id),
+      candidates: allCandidates(ctrl ? undefined : id),  // member + grid snap targets; a copy (ctrl) snaps to the ORIGINAL too (align the duplicate), a move excludes itself
       levels: elevationLevels(members(), ppf, dtos, id), // Alt-drag (vertical) snaps to these T.O.S levels
       mesh, meshPos0: mesh ? mesh.position.clone() : null, delta: null, mode: null,
     };
@@ -2029,7 +2069,9 @@ function onMove(e) {
   if (pending.epDrag) { onMoveEndpoint(e); return; }
   if (!pending.grab || !pending.origMm) return;
   if (!dragging && Math.hypot(e.clientX - downXY[0], e.clientY - downXY[1]) <= DRAG_TOL_PX) return;
-  if (!dragging) pending.mode = e.altKey ? 'vertical' : 'plan'; // lock the mode at drag start (Alt = vertical/elevation)
+  const canDrag = pending.copy || (api && api.dragMoveEnabled && api.dragMoveEnabled());
+  if (!canDrag) { if (!pending._hinted) { pending._hinted = true; if (api && api.dragMoveHint) api.dragMoveHint(); } return; }  // drag-move OFF, plain grab → never translate; onUp selects the member (dragging stays false)
+  if (!dragging) pending.mode = pending.copy ? 'copy' : (e.altKey ? 'vertical' : 'plan'); // lock the mode at drag start (copy is plan-only; Alt = vertical/elevation)
   dragging = pending;
   if (pending.mode === 'vertical') { onMoveVertical(e); return; }
   const cur = rayToPlane(e.clientX, e.clientY, pending.planeZ); if (!cur) return;
@@ -2045,7 +2087,8 @@ function onMove(e) {
   }
   if (corr) { dx += corr[0]; dy += corr[1]; }
   pending.delta = [dx, dy];
-  if (pending.mesh && pending.meshPos0) pending.mesh.position.set(pending.meshPos0.x + dx, pending.meshPos0.y + dy, pending.meshPos0.z);
+  if (pending.copy) positionCopyGhost(dx, dy);                                     // Ctrl+drag: move a translucent ghost, never the original
+  else if (pending.mesh && pending.meshPos0) pending.mesh.position.set(pending.meshPos0.x + dx, pending.meshPos0.y + dy, pending.meshPos0.z);
   if (at) { marker.position.set(at[0], at[1], at[2]); marker.scale.setScalar(markerSize()); marker.visible = true; } else marker.visible = false;
   // live dimension readout: plan distance moved (feet) + the snap type, near the cursor
   readout._dist.textContent = (Math.hypot(dx, dy) / FT_MM).toFixed(2) + ' ft';
@@ -2053,6 +2096,17 @@ function onMove(e) {
   readout.style.left = (e.clientX + 14) + 'px'; readout.style.top = (e.clientY + 14) + 'px'; readout.style.display = 'block';
 }
 
+// Ctrl+drag copy: a translucent ghost of the grabbed set (copyIds) shifted by the plan delta. Clones
+// share the source geometry + one material (like the Move/Copy tool's ghost) — nothing to dispose.
+let copyGhost = null;
+function positionCopyGhost(dx, dy) {
+  if (copyGhost) scene.remove(copyGhost);
+  copyGhost = new THREE.Group();
+  if (!tfGhostMat) tfGhostMat = new THREE.MeshBasicMaterial({ color: 0x3b82f6, transparent: true, opacity: 0.3, depthWrite: false });
+  for (const id of (pending.copyIds || [])) { const m = meshById.get(id); if (!m || !m.visible) continue; const c = new THREE.Mesh(m.geometry, tfGhostMat); c.applyMatrix4(m.matrixWorld); c.position.x += dx; c.position.y += dy; copyGhost.add(c); }
+  scene.add(copyGhost);
+}
+function clearCopyGhost() { if (copyGhost) { scene.remove(copyGhost); copyGhost = null; } }
 function onBoxMove(e) {
   if (Math.hypot(e.clientX - boxSel.x, e.clientY - boxSel.y) < DRAG_TOL_PX) { rubber.style.display = 'none'; return; }
   boxSel.moved = true;
@@ -2076,7 +2130,7 @@ function membersInRect(x0, y0, x1, y1) {
 }
 
 function onUp(e) {
-  if (marker) marker.visible = false; if (readout) readout.style.display = 'none'; if (rubber) rubber.style.display = 'none'; if (epPreview) epPreview.visible = false; dragEp = null; // always clear overlays
+  if (marker) marker.visible = false; if (readout) readout.style.display = 'none'; if (rubber) rubber.style.display = 'none'; if (epPreview) epPreview.visible = false; clearCopyGhost(); dragEp = null; // always clear overlays
   if (!renderer || !canvasEl || canvasEl.style.display === 'none') { downXY = null; boxSel = pending = dragging = null; if (controls) controls.enabled = true; return; } // 3D hidden mid-gesture → drop stale gesture state (no resume on re-show)
   const bs = boxSel; boxSel = null;
   if (bs) { // empty-space gesture: drag = box-select, click = clear selection
@@ -2111,7 +2165,14 @@ function onUp(e) {
     }
     return;
   }
-  if (!wasDragging) { clickSelect(e.clientX, e.clientY, p.ctrl); return; } // click → cycle-pick: member, or a derived part stacked on it at a joint
+  if (!wasDragging) {
+    if (p.id && !p.geo && !p.epDrag && !p.copy && moved > DRAG_TOL_PX && api && api.onSelect) { api.onSelect(p.id, false); return; } // a blocked drag (drag-move OFF) selects the GRABBED member, not whatever's under the release point
+    clickSelect(e.clientX, e.clientY, p.ctrl); return; // click → cycle-pick: member, or a derived part stacked on it at a joint (Ctrl+click = additive select)
+  }
+  if (p.copy) { // Ctrl+drag → commit a copy at the plan delta (the editor clones + selects); the ghost was the preview
+    if (p.delta && !(p.delta[0] === 0 && p.delta[1] === 0) && api && api.onCopyDrag3d) api.onCopyDrag3d(p.copyIds, p.delta[0], p.delta[1]);
+    return;
+  }
   if (p.mode === 'vertical') { // elevation drag → write T.O.S (inches)
     if (p.dz && Math.abs(p.dz) > 1e-6) {
       if (api && api.onSelect) api.onSelect(p.id, false);
@@ -2180,7 +2241,8 @@ function onHoverMove(e) {
     hoverEp = null;
     let top = null; try { top = pickAllAt(lastHoverXY[0], lastHoverXY[1])[0] || null; } catch { top = null; }
     const topMesh = top ? meshById.get(top) : null, isPart = !!(topMesh && topMesh.userData.derived);
-    canvasEl.style.cursor = geoMode() ? 'crosshair' : (top ? (isPart ? 'pointer' : 'grab') : 'default'); // derived part → pointer (select-only); member → grab (draggable)
+    const canDrag = api && api.dragMoveEnabled && api.dragMoveEnabled();
+    canvasEl.style.cursor = geoMode() ? 'crosshair' : (top ? ((isPart || !canDrag) ? 'pointer' : 'grab') : 'default'); // derived part → pointer (select-only); member → grab only when drag-move is ON, else pointer (a click just selects — the cursor tells the truth, like 2D)
     if (top !== hoverId) { hoverId = top; rebuildEndpoints(); updateStatusChip(); }
   });
 }
@@ -2200,7 +2262,12 @@ function updateStatusChip() {
   else if (showId) { const m = members().find((x) => x.id === showId); txt = m ? `${m.id} · ${m.profile || '—'}` : ''; }
   else if (selIds.size > 1) txt = `${selIds.size} members selected`;
   else if (isolatedIds) txt = `Isolated: ${isolatedIds.size} · Show all to restore`;
-  else txt = 'Drag to move · ends to stretch · Alt+drag elevation · right-drag orbit · dbl-click to zoom in';
+  // A read-only host (the vector 3D viewer) supplies its own idle hint — the default speaks editing
+  // verbs (move/stretch/elevate) a viewer's no-op api would silently ignore. Otherwise the default
+  // tells the truth about the drag-move toggle (grab-to-move ON vs click-to-select + Ctrl+drag-copy).
+  else if (api && typeof api.statusHint === 'function' && api.statusHint()) txt = api.statusHint();
+  else { const canDrag = api && api.dragMoveEnabled && api.dragMoveEnabled();
+    txt = (canDrag ? 'Drag to move · ' : 'Click to select · Ctrl+drag to copy · ') + 'ends to stretch · Alt+drag elevation · right-drag orbit · dbl-click to zoom in'; }
   hoverChip.textContent = txt;
   hoverChip.style.left = (rect.left + rect.width / 2) + 'px'; hoverChip.style.transform = 'translateX(-50%)';
   hoverChip.style.top = (rect.bottom - 30) + 'px';
@@ -2214,6 +2281,7 @@ function hide() {
   if (wpMode) { wpMode = null; wpDraft = null; if (marker) marker.visible = false; reflectWpBar(); }  // drop an in-progress set-plane pick — else a stale face/3pt pick steals the first click on return
   cmClear3d(); drClear3d();                     // and any 3D Move/Copy or draw draft/ghosts
   if (dimLabelHost) dimLabelHost.style.display = 'none'; // the loop that hides labels is about to stop — hide synchronously so none are stranded
+  clearCopyGhost();                                // drop a stale Ctrl+drag copy ghost on the way out
   if (canvasEl) canvasEl.style.display = 'none'; if (hoverChip) hoverChip.style.display = 'none'; if (rafId) { cancelAnimationFrame(rafId); rafId = null; }
 }
 function isReady() { return built; }

package/dist/web/steel-editor.html

@@ -31,7 +31,8 @@
  select,input{background:#0f172a;color:var(--text);border:1px solid #475569;border-radius:6px;padding:6px;width:100%;font:13px system-ui}
  .row{margin:8px 0} .danger{background:#7f1d1d;border-color:#991b1b} .danger:hover{background:#991b1b}
  .pill{display:inline-block;padding:1px 6px;border-radius:4px;font-size:11px}
- line.member{cursor:move;stroke-width:6;stroke-linecap:round}
+ line.member{cursor:pointer;stroke-width:6;stroke-linecap:round}    /* default (drag-move OFF): a click selects → the pointer cursor tells the truth */
+ body.dragmove line.member{cursor:move}                            /* drag-move ON: the move cursor signals a drag will translate — a per-hover second signal beside the toolbar pill */
  line.member.sel{stroke-width:7} line.member.rfi{stroke-dasharray:10 6}
  circle.handle{fill:var(--bg);stroke:#f8fafc;stroke-width:3;cursor:grab}
  line.seg{stroke:#475569;stroke-width:2;opacity:0;cursor:crosshair} body.add line.seg{opacity:.5}
@@ -130,6 +131,9 @@
  #comboPop .opt:hover,#comboPop .opt.active{background:#334155}
  /* "More" overflow menu — themed popup (reuses the #comboPop look); flat rows keep each button's id + handler. */
  /* Move/Copy split buttons + transform-suite chrome — all within the locked baseline tokens. */
+.hdrsep{width:1px;height:20px;background:var(--line);flex:none;margin:0 2px}   /* header divider: sets the Drag-to-move mode toggle apart from the transform actions */
+#dragMoveB{white-space:nowrap;flex:none}
+#dragMoveB.on{background:var(--brand);border-color:var(--brand);color:#fff}
 .cmwrap{position:relative;display:inline-flex}
 .cmwrap>button:first-child{border-radius:6px 0 0 6px}
 .cmwrap .cmcaret{border-radius:0 6px 6px 0;border-left:0;padding:0 5px;min-width:22px;color:var(--mut)}
@@ -339,6 +343,8 @@
    <button id=cpLevelB>Copy to level…</button>
   </div>
  </div>
+ <span class=hdrsep></span>
+ <button id=dragMoveB aria-pressed=false title="Drag to move — when ON, dragging a member with the left mouse moves it. When OFF (default), a click only selects, so members can't be nudged by accident (the ↔ Move tool and Ctrl+drag-copy still work). Applies to 2D and 3D.">Drag to move</button>
  <button id=askAiBtn>Ask AI ▸</button>
  <div id=moreWrap>
   <button id=moreBtn title="More actions" aria-haspopup=menu aria-expanded=false aria-label="More actions">⋯</button>
@@ -1693,6 +1699,13 @@ function dimRefreshPrev(){if(!dimMode||!dimDraft||!dimLastPtr)return;
 // array N×M. Same shell as the Dimension tool: armed flag routes the pointer handlers, the preview
 // lives in its own <g> (no render() until commit), commits go through edit()/pushUndo. ---
 let cmTool=null,cmArrayMode=false,cmDraft=null,cmAxis='free',cmCount=1,cmCountA=2,cmCountB=2,cmLastPtr=null,cmLastEvt=null;
+// Drag-to-move: OFF by default so a click only selects (no accidental nudges). Persisted per-browser,
+// global (a UI pref, not per-app). Ctrl+drag-copy ignores this — it's an explicit gesture.
+let dragMoveOn=false; try{dragMoveOn=localStorage.getItem('steel:dragmove:v1')==='1';}catch(_){}
+let dragHintShown=false; try{dragHintShown=localStorage.getItem('steel:dragmovehint:v1')==='1';}catch(_){}   // one-time "drag-move is off" teach on the first blocked drag
+function setDragMove(on){dragMoveOn=!!on;document.body.classList.toggle('dragmove',dragMoveOn);
+ const b=document.getElementById('dragMoveB');if(b){b.classList.toggle('on',dragMoveOn);b.setAttribute('aria-pressed',String(dragMoveOn));}
+ try{localStorage.setItem('steel:dragmove:v1',dragMoveOn?'1':'0');}catch(_){}}
 // cmDraft: {base:[x,y], vA:null} — array mode sets vA=[dx,dy,0] once direction A is picked/typed
 function setCmUi(){document.body.classList.toggle('cmon',!!cmTool);
  document.getElementById('mvB').classList.toggle('on',cmTool==='move');
@@ -1968,12 +1981,16 @@ svg.addEventListener('pointerdown',e=>{if(e.button!==0)return;const t=e.target;
    return;}}
  if(t.classList.contains('seg')&&mode==='add'){addFromSeg(t.dataset.seg);return;}
  if(t.tagName==='image'&&mode==='add'){buildSnap(null);let q=toSvg(e),x0=q.x,y0=q.y;if(!e.altKey){const sn=snap(x0,y0);x0=sn.x;y0=sn.y;}const ln=document.createElementNS('http://www.w3.org/2000/svg','line');ln.setAttribute('class','draw');ln.setAttribute('x1',x0);ln.setAttribute('y1',y0);ln.setAttribute('x2',x0);ln.setAttribute('y2',y0);svg.appendChild(ln);drag={type:'draw',x0,y0,line:ln};svg.setPointerCapture(e.pointerId);e.preventDefault();return;}
- if(t.classList.contains('member')&&mode==='sel'){const id=t.dataset.id;
-   if(e.ctrlKey||e.metaKey){selIds.has(id)?selIds.delete(id):selIds.add(id);render();return;}
-   if(!selIds.has(id)){selIds=new Set([id]);render();}
-   const p=toSvg(e),items=selArr().map(m=>({id:m.id,o0:m.wp[0].slice(),o1:m.wp[1].slice()}));
-   buildSnap(new Set(items.map(it=>it.id)));                         // snap a dragged line to other members'/segments' endpoints (grid lines)
-   drag={type:'move',start:[p.x,p.y],items,pre:snapshot()};svg.setPointerCapture(e.pointerId);e.preventDefault();return;}
+ if(t.classList.contains('member')&&mode==='sel'){const id=t.dataset.id,ctrl=(e.ctrlKey||e.metaKey),p=toSvg(e);
+   // Plain click selects on down (so a no-drag click still selects even with drag-move off). Ctrl defers
+   // its select to up — a ctrl-DRAG copies, a ctrl-CLICK toggles selection (today's behavior).
+   if(!ctrl&&!selIds.has(id)){selIds=new Set([id]);render();}
+   const canDrag=ctrl||dragMoveOn;                                   // plain grab only translates when the toggle is on; ctrl always drags (to copy)
+   const srcIds=(ctrl&&!selIds.has(id))?new Set([id]):new Set(selArr().map(m=>m.id));  // ctrl on an unselected member copies just it; else the whole selection
+   const items=[...srcIds].map(mid=>{const m=byId(mid);return{id:mid,o0:m.wp[0].slice(),o1:m.wp[1].slice()};});
+   buildSnap(srcIds);                                                // snap the dragged line(s) to OTHER members'/segments' endpoints
+   drag={type:'grab',copy:ctrl,armed:canDrag,start:[p.x,p.y],items,clickId:id,pre:snapshot(),moved:false};
+   svg.setPointerCapture(e.pointerId);e.preventDefault();return;}   // always capture: even an unarmed grab tracks the gesture so a blocked drag can teach the toggle
  if((t===svg||t.tagName==='image'||t.classList.contains('seg'))&&mode==='sel'){const p=toSvg(e);   // t===svg → drag on bare canvas (no raster) still box-selects
    const rc=document.createElementNS('http://www.w3.org/2000/svg','rect');rc.setAttribute('class','marquee');svg.appendChild(rc);
    drag={type:'marquee',x0:p.x,y0:p.y,add:(e.ctrlKey||e.metaKey),rect:rc};svg.setPointerCapture(e.pointerId);e.preventDefault();}});
@@ -2022,7 +2039,17 @@ svg.addEventListener('pointermove',e=>{
    drag.line.setAttribute('x2',x);drag.line.setAttribute('y2',y);drag.cur=[x,y];return;}
  if(drag.type==='marquee'){const x=Math.min(drag.x0,p.x),y=Math.min(drag.y0,p.y),w=Math.abs(p.x-drag.x0),h=Math.abs(p.y-drag.y0);
    drag.rect.setAttribute('x',x);drag.rect.setAttribute('y',y);drag.rect.setAttribute('width',w);drag.rect.setAttribute('height',h);drag.cur=[x,y,x+w,y+h];return;}
- if(drag.type==='move'){let dx=p.x-drag.start[0],dy=p.y-drag.start[1];
+ if(drag.type==='grab'){const rawdx=p.x-drag.start[0],rawdy=p.y-drag.start[1];
+   if(!drag.moved){
+     if(Math.hypot(rawdx,rawdy)<4/zoom)return;                       // below the drag threshold — still a potential click
+     drag.moved=true;
+     if(!drag.armed)return;                                          // drag-move OFF, plain grab → never translate (the up-handler teaches the toggle)
+     if(drag.copy){                                                  // materialize clones once; from here it's a normal move of the clones
+       const ns=new Set(),ci=[];
+       for(const it of drag.items){const src=byId(it.id);if(!src)continue;const c=cloneMember(src);P.members.push(c);ns.add(c.id);ci.push({id:c.id,o0:c.wp[0].slice(),o1:c.wp[1].slice()});}
+       selIds=ns;drag.items=ci;buildSnap(ns);render();}}             // select the clones + snap them to the sources/others; render shows them (drag continues via updateLine)
+   if(!drag.armed)return;
+   let dx=rawdx,dy=rawdy;
    if(e.shiftKey){[dx,dy]=orthoLock(0,0,dx,dy);snapClear();}                          // ortho move — lock the delta to the local frame (or screen H/V)
    else if(!e.altKey){let best=null,bd=SNAP_PX/zoom;                  // shift the group so a moving endpoint lands on a snap target (endpoint, midpoint △, OR line)
      for(const it of drag.items)for(const o of [it.o0,it.o1]){const nx=o[0]+dx,ny=o[1]+dy;
@@ -2056,6 +2083,16 @@ svg.addEventListener('pointerup',()=>{if(!drag)return;snapClear();
    const r=drag.cur;if(r&&(r[2]-r[0]>2||r[3]-r[1]>2)){for(const m of P.members)if(rectHit(m.wp[0],m.wp[1],r))selIds.add(m.id);
      if(dimsVisible)for(const d of P.dims){const g=dimGeo(d.a,d.b,d.axis,d.off,d.rot);if(rectHit(g.p1,g.p2,r)||rectHit(g.w[0][0],g.w[0][1],r)||rectHit(g.w[1][0],g.w[1][1],r))selDimIds.add(d.id);}}  // area-select grabs dims by their VISIBLE geometry — the dim line + its two witness lines (not the invisible anchor span)
    drag.rect.remove();drag=null;render();return;}
+ if(drag.type==='grab'){
+   if(!drag.moved){                                                  // no drag past threshold → it was a click
+     if(drag.copy){selIds.has(drag.clickId)?selIds.delete(drag.clickId):selIds.add(drag.clickId);}  // ctrl+click toggles selection (deferred from down)
+     drag=null;render();return;}
+   if(!drag.armed){                                                  // dragged but drag-move OFF → nothing moved; teach the toggle once
+     drag=null;render();
+     if(!dragHintShown){dragHintShown=true;try{localStorage.setItem('steel:dragmovehint:v1','1');}catch(_){}toast('Drag-to-move is off — turn it on in the toolbar, or use ↔ Move (M)');}
+     return;}
+   if(drag.pre&&snapshot()!==drag.pre)pushUndo(drag.pre);           // armed move/copy committed (copy always changed geometry via its clones)
+   const wasCopy=drag.copy;drag=null;render();if(wasCopy)toast('Copied '+selIds.size+' member'+(selIds.size===1?'':'s'));return;}
  if(drag.pre&&snapshot()!==drag.pre)pushUndo(drag.pre);drag=null;render();});
 svg.addEventListener('pointercancel',()=>{if(drag&&drag.type==='gridline'){drag=null;gridReadoutHide();snapClear();render();}});   // a cancelled pointer must not strand the floating readout
 svg.addEventListener('dblclick',e=>{   // dbl-click a grid bubble → rename that label in place
@@ -2092,6 +2129,8 @@ document.getElementById('mrgB').onclick=()=>{const r=mergeCollinearJS(P.members)
  toast('Merged '+r.mergedAway+' segment'+(r.mergedAway===1?'':'s')+' into '+r.runs+' member'+(r.runs===1?'':'s'));};
 document.getElementById('undoB').onclick=doUndo;
 document.getElementById('redoB').onclick=doRedo;
+document.getElementById('dragMoveB').onclick=()=>{setDragMove(!dragMoveOn);toast(dragMoveOn?'Drag to move: ON — dragging a member moves it':'Drag to move: OFF — a click only selects');};
+setDragMove(dragMoveOn);   // reflect the persisted state on load (body class + pill)
 addEventListener('keydown',e=>{
  const inForm=/^(INPUT|SELECT|TEXTAREA)$/.test((document.activeElement||{}).tagName);
  if(e.key==='Escape'&&moreOpen()){closeMore();moreBtn.focus();return;}
@@ -2189,6 +2228,12 @@ const view3dApi={
  defaultTosMm:()=>(defaultTOS!=null?defaultTOS*25.4:0),      // editor stores default T.O.S in inches
  geoMode:()=>geoMode,                                        // 'el' | 'split' | null — armed Trim/Extend/Split state
  onMoveMember:(id,newWp)=>{edit(()=>{const m=byId(id);if(m)m.wp=newWp;});},  // 3D drag → write wp (undoable, autosaves, syncs 2D/chip/BOM)
+ dragMoveEnabled:()=>dragMoveOn,                                                    // the 3D view gates its plain member-drag on this
+ dragMoveHint:()=>{if(dragHintShown)return;dragHintShown=true;try{localStorage.setItem('steel:dragmovehint:v1','1');}catch(_){}toast('Drag-to-move is off — turn it on in the toolbar, or use ↔ Move (M)');},
+ onCopyDrag3d:(ids,dxMm,dyMm)=>{const k=304.8/((P&&P.pt_per_ft>0)?P.pt_per_ft:1),r6=n=>Math.round(n*1e6)/1e6;   // Ctrl+drag copy: mm delta → plan px (Y FLIPPED), clone + translate + select
+   const dpx=r6(dxMm/k),dpy=r6(-dyMm/k);
+   edit(()=>{const ns=new Set();for(const id of (ids||[])){const src=byId(id);if(!src)continue;const c=cloneMember(src);translateMembers([c],[dpx,dpy,0]);P.members.push(c);ns.add(c.id);}selIds=ns;});
+   toast('Copied '+(ids?ids.length:0)+' member'+((ids&&ids.length===1)?'':'s'));},
  onMoveEndpoint:(id,end,wp)=>{edit(()=>{const m=byId(id);if(m&&Array.isArray(m.wp)&&m.wp.length>=2)m.wp[end]=wp;});},  // 3D end-node drag → write just that endpoint
  onElevateMember:(id,dIn)=>{edit(()=>{const m=byId(id);if(!m)return;ensureMeta(m);  // 3D Alt-drag → raise/lower T.O.S by dIn inches
    if(m.role==='column'){m.col.tos=(m.col.tos!=null?m.col.tos:defaultTOS)+dIn;m.col.bos=(m.col.bos!=null?m.col.bos:0)+dIn;m.col.tosDef=false;}  // rigid raise (bos null→0, both shift) so the column isn't stretched

package/dist/web/vector-3d.html

@@ -0,0 +1,242 @@
+<!doctype html>
+<html lang="en">
+<head>
+<meta charset="utf-8">
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<title>Vectorize — 3D view</title>
+<style>
+  /* Locked baseline: shadcn dark slate-blue (same tokens + scrollbar theming as the sibling editors). */
+  :root{--bg:#0f172a;--panel:#1e293b;--line:#334155;--text:#e2e8f0;--mut:#94a3b8;--brand:#3b82f6}
+  *{scrollbar-width:thin;scrollbar-color:#475569 transparent}
+  *::-webkit-scrollbar{width:10px;height:10px}
+  *::-webkit-scrollbar-track{background:transparent}
+  *::-webkit-scrollbar-thumb{background:#475569;border-radius:6px;border:2px solid transparent;background-clip:content-box}
+  *::-webkit-scrollbar-thumb:hover{background:#5b6b85;background-clip:content-box}
+  *::-webkit-scrollbar-corner{background:transparent}
+  *{box-sizing:border-box}
+  body{margin:0;background:var(--bg);color:var(--text);font:13px system-ui;height:100vh;display:flex;flex-direction:column;overflow:hidden}
+  header{display:flex;align-items:center;gap:14px;padding:8px 14px;background:var(--panel);border-bottom:1px solid var(--line);flex:none}
+  header b{font-size:14px}
+  header .spacer{flex:1}
+  .stat{color:var(--mut)} .stat b{color:var(--text);font-variant-numeric:tabular-nums}
+  /* The unplaced-entities chip — amber "needs review" language (never red: honesty, not error). */
+  #skipChip{display:inline-flex;align-items:center;gap:6px;background:transparent;border:1px solid var(--line);color:#f59e0b;border-radius:6px;padding:4px 10px;font:inherit;cursor:pointer}
+  #skipChip:hover{border-color:#f59e0b}
+  #skipChip[hidden]{display:none} /* the id's display beats the [hidden] UA rule — restore it */
+  /* Full-bleed canvas. Wrapper bg matches the Three.js clear color EXACTLY (#020817) so the brief
+     WebGL-init frame never flashes a seam against the app --bg. */
+  #wrap{flex:1;position:relative;min-height:0;background:#020817}
+  #stage3d{position:absolute;inset:0;width:100%;height:100%;outline:none}
+  #state{position:absolute;inset:0;display:none;align-items:center;justify-content:center;flex-direction:column;gap:10px;background:var(--bg);color:var(--mut);text-align:center;padding:24px;z-index:4}
+  #state.show{display:flex}
+  #state .spin{width:26px;height:26px;border:3px solid var(--line);border-top-color:var(--brand);border-radius:50%;animation:spin .8s linear infinite}
+  #state .msg{max-width:520px;line-height:1.55}
+  #state .msg b{color:var(--text)}
+  @keyframes spin{to{transform:rotate(360deg)}}
+  /* Floating toolbar pill, top-left (the established 3D slot). */
+  #bar{position:absolute;top:12px;left:12px;display:flex;gap:6px;align-items:center;z-index:5}
+  #bar .seg-group{display:inline-flex;border:1px solid var(--line);border-radius:6px;overflow:hidden;background:var(--panel);box-shadow:0 4px 14px rgba(0,0,0,.45)}
+  #bar .seg-group button{padding:5px 11px;margin:0;border:0;border-radius:0;background:transparent;color:var(--mut);font:600 12px system-ui;cursor:pointer}
+  #bar .seg-group button+button{border-left:1px solid var(--line)}
+  #bar .seg-group button:hover{color:var(--text)}
+  #bar .seg-group button.on{background:#0f172a;color:var(--text);box-shadow:inset 0 -2px 0 var(--brand)}
+  #bar>button{background:var(--panel);border:1px solid var(--line);border-radius:6px;color:var(--text);font:600 12px system-ui;padding:5px 11px;cursor:pointer;box-shadow:0 4px 14px rgba(0,0,0,.45)}
+  #bar>button:hover{border-color:var(--brand)}
+  #bar .tb-sep{width:1px;height:18px;background:var(--line);flex:0 0 auto}
+  /* Group visibility toggles folded INLINE into the pill (leaves bottom-left to the skip panel). */
+  #bar .gck{display:inline-flex;align-items:center;gap:6px;background:var(--panel);border:1px solid var(--line);border-radius:6px;padding:4px 9px;box-shadow:0 4px 14px rgba(0,0,0,.45);cursor:pointer;color:var(--text);font-size:12px}
+  #bar .gck input{accent-color:var(--brand);cursor:pointer;margin:0}
+  #bar .gck .ct{color:var(--mut);font-variant-numeric:tabular-nums;font-size:11px}
+  #bar .gck .sw{width:9px;height:9px;border-radius:2px;flex:none}
+  /* The unplaced-entities panel, docked bottom-left. Glanceable (never a modal — it coexists with
+     the scene it annotates). Inner list scrolls with the themed scrollbar. */
+  #skipPanel{position:absolute;left:12px;bottom:12px;width:380px;max-width:calc(100% - 24px);background:var(--panel);border:1px solid var(--line);border-radius:8px;box-shadow:0 8px 24px rgba(0,0,0,.5);z-index:5;display:none}
+  #skipPanel.open{display:block}
+  #skipPanel h3{margin:0;padding:9px 12px 4px;font-size:11px;color:var(--mut);text-transform:uppercase;letter-spacing:.06em}
+  #skipPanel .hint{padding:0 12px 7px;color:var(--mut);font-size:12px;line-height:1.45}
+  #skipList{max-height:200px;overflow:auto;padding:0 6px 8px;display:flex;flex-direction:column;gap:2px}
+  .srow{display:flex;align-items:baseline;gap:6px;padding:4px 6px;border-radius:6px;font-size:12px}
+  .srow:hover{background:var(--line)}
+  .srow .sid{color:#f59e0b;flex:none;font-variant-numeric:tabular-nums}
+  .srow .rsn{color:var(--text);overflow:hidden;text-overflow:ellipsis;white-space:nowrap}
+</style>
+</head>
+<body>
+  <header>
+    <b>Vectorize — 3D</b>
+    <span class="stat" id="title">—</span>
+    <span class="spacer"></span>
+    <span class="stat"><b id="nBoxes">0</b> members · <b id="nExtr">0</b> bodies</span>
+    <button id="skipChip" hidden>⚠ <b id="nSkipped">0</b> unplaced</button>
+  </header>
+  <div id="wrap">
+    <canvas id="stage3d"></canvas>
+    <div id="bar" hidden>
+      <div class="seg-group" id="projSeg">
+        <button data-proj="persp" class="on" title="Perspective view — natural depth">Persp</button>
+        <button data-proj="ortho" title="Orthographic — true scale, no perspective">Ortho</button>
+      </div>
+      <button id="fitBtn" title="Fit all to view">Fit</button>
+      <span class="tb-sep"></span>
+      <div class="seg-group" id="modeSeg">
+        <button data-mode="solid" class="on" title="Solid shaded model">Solid</button>
+        <button data-mode="wire" title="Wireframe — edges only">Wire</button>
+        <button data-mode="xray" title="See-through — reveal hidden parts">X-ray</button>
+      </div>
+      <span class="tb-sep"></span>
+      <span id="groupToggles"></span>
+    </div>
+    <div id="skipPanel">
+      <h3 id="skipTitle">Not shown in 3D</h3>
+      <div class="hint">These couldn't be matched to a 3D position. Fix the reason below, then reopen this view.</div>
+      <div id="skipList"></div>
+    </div>
+    <div id="state" class="show" role="status" aria-live="polite"><div class="spin"></div><div class="msg" id="stateMsg">Reconstructing…</div></div>
+  </div>
+<script type="importmap">{"imports":{"three":"./vendor/three.module.js","three/addons/":"./vendor/","three-bvh-csg":"./vendor/three-bvh-csg.module.js"}}</script>
+<script type="module" src="./steel-3d-view.js"></script>
+<script type="module">
+(function poll(waited) { // steel-3d-view registers window.Steel3DView on module load — wait for it
+  if (window.Steel3DView) { boot(window.Steel3DView); return; }
+  if (waited > 8000) { // the module never loaded (bad vendor path / script error) — don't spin forever
+    document.getElementById('stateMsg').textContent = 'Could not load the 3D viewer. Reload the page, or check the console.';
+    document.getElementById('state').querySelector('.spin').style.display = 'none';
+    return;
+  }
+  setTimeout(() => poll((waited || 0) + 20), 20);
+})(0);
+
+function boot(v3d) {
+  const $ = (id) => document.getElementById(id);
+  const params = new URLSearchParams(location.search);
+  const app = params.get('app');
+  let scene = null;
+  let skipped = [];
+
+  function showState(msgNode, spinning) {
+    $('stateMsg').replaceChildren(msgNode);
+    $('state').classList.add('show');
+    $('state').querySelector('.spin').style.display = spinning ? '' : 'none';
+  }
+  function hideState() { $('state').classList.remove('show'); }
+
+  // The read-only host api: the module's editing/dim/snap hooks are inert here — a viewer never
+  // mutates the contract. fetchScene serves the one scene this page already loaded.
+  const api = {
+    fetchScene: async () => scene,
+    getMembers: () => [],
+    ptPerFt: () => 1,
+    defaultTosMm: () => 0,
+    geoMode: () => null,
+    fmtLen: (mm) => `${Math.round(mm)} mm`,
+    getDimOverlays: () => [],
+    getDims3d: () => [],
+    selDim3d: () => [],
+    newDim3dId: () => 'd0',
+    onSelect: () => {}, onSelectMany: () => {}, onSelectDim3d: () => {}, onAddDim3d: () => {},
+    onMoveMember: () => {}, onMoveEndpoint: () => {}, onElevateMember: () => {}, onSplit: () => {},
+    onTrimExtend: () => {}, onIsolateChange: () => {}, onClipModeChange: () => {}, onClipsChange: () => {},
+    onWorkAreaChange: () => {}, beginClipEdit: () => {},
+    statusHint: () => 'Right-drag orbit · middle-drag pan · wheel zoom · dbl-click to zoom in',
+  };
+
+  function emptyStateNode() {
+    // Plain AEC language — a cold empty state must not lean on schema vocabulary (per design consult).
+    // Two distinct zero-element cases: NOTHING was declared as a 3D entity (cold set), vs entities
+    // were read but NONE could be placed (all skipped) — the honest message differs.
+    const d = document.createElement('div');
+    const b = document.createElement('b');
+    const p = document.createElement('div');
+    p.style.marginTop = '8px';
+    if (skipped.length > 0) {
+      b.textContent = skipped.length === 1
+        ? 'Nothing placed in 3D yet — the one entity read couldn’t be placed.'
+        : `Nothing placed in 3D yet — all ${skipped.length} entities are unplaced.`;
+      p.textContent = 'Each one is listed with the reason in the "Not shown in 3D" panel — usually a missing height (a level datum, an extrude value, or a matching elevation). Fix the reasons and reopen this view.';
+    } else {
+      b.textContent = 'No 3D yet — this drawing set doesn’t have matched plan and elevation sheets.';
+      p.textContent = '3D reconstruction needs at least one plan sheet and one elevation (or section) sheet that share entities, so heights can be worked out from the elevation. Classify your sheets as plan/elevation and make sure floor levels or extrude heights are set, then reopen this view — or ask your terminal AI to do it.';
+    }
+    d.append(b, p);
+    return d;
+  }
+
+  function renderSkipPanel() {
+    const chip = $('skipChip');
+    chip.hidden = skipped.length === 0;
+    $('nSkipped').textContent = skipped.length;
+    $('skipTitle').textContent = `Not shown in 3D (${skipped.length})`;
+    const list = $('skipList');
+    while (list.firstChild) list.removeChild(list.firstChild);
+    for (const s of skipped) {
+      const row = document.createElement('div'); row.className = 'srow';
+      const sid = document.createElement('span'); sid.className = 'sid'; sid.textContent = s.id;
+      const rsn = document.createElement('span'); rsn.className = 'rsn'; rsn.textContent = s.reason; rsn.title = s.reason;
+      row.append(sid, rsn); list.appendChild(row);
+    }
+  }
+
+  function renderGroupToggles() {
+    const box = $('groupToggles');
+    while (box.firstChild) box.removeChild(box.firstChild);
+    const counts = new Map();
+    for (const el of scene.elements) counts.set(el.group, (counts.get(el.group) || 0) + 1);
+    for (const g of v3d.getGroups()) {
+      const lab = document.createElement('label'); lab.className = 'gck';
+      const inp = document.createElement('input'); inp.type = 'checkbox'; inp.checked = true;
+      inp.addEventListener('change', () => v3d.toggleGroup(g.key));
+      const sw = document.createElement('span'); sw.className = 'sw'; sw.style.background = g.color;
+      const nm = document.createElement('span'); nm.textContent = g.label;
+      const ct = document.createElement('span'); ct.className = 'ct'; ct.textContent = String(counts.get(g.key) || 0);
+      lab.append(inp, sw, nm, ct); box.appendChild(lab);
+    }
+  }
+
+  $('fitBtn').addEventListener('click', () => v3d.frameAll());
+  $('projSeg').addEventListener('click', (e) => {
+    const b = e.target.closest('button'); if (!b) return;
+    v3d.setProjection(b.dataset.proj);
+    for (const x of $('projSeg').children) x.classList.toggle('on', x === b);
+  });
+  $('modeSeg').addEventListener('click', (e) => {
+    const b = e.target.closest('button'); if (!b) return;
+    v3d.setDisplayMode(b.dataset.mode);
+    for (const x of $('modeSeg').children) x.classList.toggle('on', x === b);
+  });
+  $('skipChip').addEventListener('click', () => $('skipPanel').classList.toggle('open'));
+
+  (async () => {
+    if (!app) { showState(document.createTextNode('No app given — open this view from a workflow node.'), false); return; }
+    let out;
+    try {
+      const r = await fetch('/api/contract/' + encodeURIComponent(app) + '/scene', {
+        method: 'POST', headers: { 'content-type': 'application/json' }, body: '{}',
+      });
+      out = await r.json();
+      if (!r.ok || !out.ok) throw new Error(out.error || ('HTTP ' + r.status));
+    } catch (e) {
+      showState(document.createTextNode('Could not reconstruct the drawing (' + e.message + ').'), false);
+      return;
+    }
+    scene = out.scene;
+    skipped = Array.isArray(out.skipped) ? out.skipped : [];
+    const name = (scene.meta && scene.meta.name) || app;
+    $('title').textContent = name;
+    document.title = 'Vectorize — 3D · ' + name;
+    const boxes = scene.elements.filter((e) => e.kind === 'box').length;
+    const extr = scene.elements.filter((e) => e.kind === 'extrusion').length;
+    $('nBoxes').textContent = boxes; $('nExtr').textContent = extr;
+    renderSkipPanel();
+    if (skipped.length) $('skipPanel').classList.add('open'); // partial/failed reconstruction: lead with honesty
+    if (scene.elements.length === 0) { showState(emptyStateNode(), false); return; } // (chip + panel still show above #state)
+    v3d.init($('stage3d'), api);
+    v3d.show();
+    await v3d.rebuild(true); // fit the camera on first build
+    renderGroupToggles();
+    $('bar').hidden = false;
+    hideState();
+  })();
+}
+</script>
+</body>
+</html>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@floless/app",
-  "version": "0.63.0",
+  "version": "0.65.0",
   "type": "module",
   "description": "Thin localhost host for floless.app — serves web/ and shells the aware CLI. No engine, no LLM.",
   "bin": {