@floless/app 0.79.0 → 0.80.0

package/dist/floless-server.cjs

@@ -53093,7 +53093,7 @@ function appVersion() {
   return resolveVersion({
     isSea: isSea2(),
     sqVersionXml: readSqVersionXml(),
-    define: true ? "0.79.0" : void 0,
+    define: true ? "0.80.0" : void 0,
     pkgVersion: readPkgVersion()
   });
 }
@@ -53103,7 +53103,7 @@ function resolveChannel(s) {
   return "dev";
 }
 function appChannel() {
-  return resolveChannel({ isSea: isSea2(), define: true ? "0.79.0" : void 0 });
+  return resolveChannel({ isSea: isSea2(), define: true ? "0.80.0" : void 0 });
 }
 
 // workflow-update.ts

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

@@ -98,6 +98,19 @@ export function elevationLevels(members, ptPerFt, defaultTosMm, excludeId) {
   return [...set].sort((a, b) => a - b);
 }
 
+// Snap a raw elevation (mm) to the nearest level datum { z, label } within `tol`, returning the snapped
+// value + its source, or the raw value when nothing is in range. Nearest wins. Pure — backs the Mode B
+// column-base pick (the levels come from elevationLevels()). Malformed datums are skipped.
+export function snapElevation(z, levels, tol) {
+  let best = null, bestD = tol;
+  for (const lv of levels || []) {
+    if (!lv || typeof lv.z !== 'number' || !isFinite(lv.z)) continue;
+    const d = Math.abs(z - lv.z);
+    if (d <= bestD) { bestD = d; best = lv; }
+  }
+  return best ? { z: best.z, snapped: true, label: best.label ?? null } : { z, snapped: false, label: null };
+}
+
 // Lower wins when two candidates are both within tolerance. Grid intersections rank with member
 // intersections (columns land on them); grid lines below member centerlines.
 const PRECEDENCE = { vertex: 0, intersection: 1, 'grid-int': 1, midpoint: 2, centerline: 3, 'vertical-axis': 4, 'grid-line': 5, level: 1 };

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

@@ -17,7 +17,7 @@
 import * as THREE from 'three';
 import { OrbitControls } from 'three/addons/OrbitControls.js';
 import { Brush, Evaluator, SUBTRACTION } from 'three-bvh-csg';
-import { snapCandidates, snapPoint, planPointToWp, memberGeometry, elevationLevels, dim3dGeom, planeBasis, projectToPlane, planeFrom3Points, vecToPlane } from './steel-3d-core.js';
+import { snapCandidates, snapPoint, planPointToWp, memberGeometry, elevationLevels, snapElevation, dim3dGeom, planeBasis, projectToPlane, planeFrom3Points, vecToPlane } from './steel-3d-core.js';
 import { gridGeometry, gridCandidates3d, mmPerPx } from './grid-core.js';
 
 let renderer, scene, perspCam, orthoCam, camera, controls, root, api, canvasEl, ro, rafId, grid, raycaster, downXY, lastPick = '(none)';
@@ -31,6 +31,10 @@ let hoverEp = null, dragEp = null;          // {id,end} of the hovered / dragged
 let refGroup = null; let refLineOn = false; // optional reference (work) lines between each member's end points
 let insertMode = false;            // armed "place a vectored detail" pick (mirrors clipMode)
 let insertPending = null;          // {name,url} — the detail the editor queued for the next placement click
+let basePickCol = null;            // Mode B: armed "trim column to base" pick — the target column id, or null
+let basePickLevels = null;         // [{ z, label }] level datums the base pick snaps its elevation to
+const ELEV_SNAP_PX = 10;           // screen-pixel snap radius for the base-pick elevation (world tol via pxToWorldAt, so it's consistent at any zoom)
+const BASE_PICK_HIT_PX = 40;       // the base pick only commits when the click is within this many px of the column axis (rejects an accidental empty-canvas click)
 let labelsOnFlag = false;          // member mark/id overlay labels toggle (a readability aid)
 let memberLabelHost = null;        // fixed-position container for the member labels (positioned each frame)
 const memberLabelPool = [];        // reused <div> labels, one per member, positioned in the loop
@@ -631,6 +635,57 @@ function setInsertMode(on, pending) {
   if (api && api.onInsertModeChange) api.onInsertModeChange(insertMode);
 }
 function insertModeOn() { return insertMode; }
+
+// Mode B: arm a "trim column to base" pick on `colId`. The level datums are derived from the OTHER members'
+// rendered top/bottom (world mm, so no display→mm conversion), each labelled by its member mark, so the pick
+// snaps the base to a real framing level. A one-shot left-click hands the picked base elevation to the editor
+// via api.onBasePick. Mirrors setInsertMode.
+function setBasePickMode(colId) {
+  basePickCol = colId || null;
+  basePickLevels = null;
+  if (basePickCol) {
+    setInsertMode(false); if (api && api.disarmTransform) api.disarmTransform(); if (api && api.disarmAdd) api.disarmAdd(); setClipMode(null);
+    root.updateMatrixWorld(true);
+    basePickLevels = [];
+    const _b = new THREE.Box3();
+    for (const [id, m] of meshById) {
+      // MEMBER meshes only (their id is a plain mark): a ':' marks a connection part (`joint:part`) or a
+      // detail (`det:…`), so those are excluded — the base must snap to framing levels, not the moving
+      // base-plate/anchor/weld hardware of the very connection being re-seated.
+      if (id === basePickCol || !m.visible || String(id).includes(':')) continue;
+      _b.setFromObject(m); if (_b.isEmpty()) continue;
+      basePickLevels.push({ z: Math.round(_b.max.z), label: id + ' top' }, { z: Math.round(_b.min.z), label: id + ' base' });
+    }
+  }
+  if (canvasEl) canvasEl.style.cursor = basePickCol ? 'crosshair' : 'default';
+  if (!basePickCol) { if (marker) marker.visible = false; if (readout) readout.style.display = 'none'; }
+  if (api && api.onBasePickModeChange) api.onBasePickModeChange(basePickModeOn());
+}
+function basePickModeOn() { return !!basePickCol; }
+// A point along the target column's VERTICAL axis at the cursor, elevation snapped to the level datums.
+// Intersect the pick ray with a vertical plane through the column axis facing the camera — so a click
+// anywhere near the (thin) column reads as an elevation on its reference line. Returns { z, snapped, label, x, y }.
+function basePickPoint(cx, cy) {
+  const col = meshById.get(basePickCol); if (!col) return null;
+  camera.updateMatrixWorld(); root.updateMatrixWorld(true);
+  const box = new THREE.Box3().setFromObject(col);
+  const ax = (box.min.x + box.max.x) / 2, ay = (box.min.y + box.max.y) / 2;
+  const rect = canvasEl.getBoundingClientRect(); if (!rect.width || !rect.height) return null;
+  const ndc = new THREE.Vector2(((cx - rect.left) / rect.width) * 2 - 1, -((cy - rect.top) / rect.height) * 2 + 1);
+  raycaster.setFromCamera(ndc, camera);
+  const toCam = new THREE.Vector3(camera.position.x - ax, camera.position.y - ay, 0);
+  if (toCam.lengthSq() < 1e-6) toCam.set(1, 0, 0);
+  toCam.normalize();
+  const plane = new THREE.Plane().setFromNormalAndCoplanarPoint(toCam, new THREE.Vector3(ax, ay, 0));
+  const g = new THREE.Vector3();
+  if (!raycaster.ray.intersectPlane(plane, g)) return null;
+  // The plane is infinite, so gate the pick to clicks NEAR the column axis (else an accidental empty-canvas
+  // click would commit a trim). g lies on the plane through the axis; its horizontal offset from the axis is
+  // how far to the side the cursor is.
+  if (Math.hypot(g.x - ax, g.y - ay) > pxToWorldAt(BASE_PICK_HIT_PX, g)) return null;
+  const s = snapElevation(g.z, basePickLevels, pxToWorldAt(ELEV_SNAP_PX, g)); // screen-scaled tol so the snap window is ~constant on-screen
+  return { z: s.z, snapped: s.snapped, label: s.label, x: ax, y: ay };
+}
 // The placement raycast: a member face under the cursor gives the point + its basis + the member id to
 // anchor to; empty space drops the detail on the ground plane (z=0) with a default vertical orientation.
 function insertPick(cx, cy) {
@@ -1348,6 +1403,7 @@ function onKey(e) {
   if (pending && pending.clipDrag && e.key === 'Escape') { e.preventDefault(); const p = pending; if (p.plane) p.clip.point = p.prePoint; else p.clip.box.copy(p.preBox); rebuildClipPlanes(p.clip); applyClips(); renderClipGizmo(); pending = dragging = null; if (controls) controls.enabled = true; if (readout) readout.style.display = 'none'; return; } // Esc mid-drag → undo the handle move
   if (wpMode && e.key === 'Escape') { e.preventDefault(); if (wpMode === '3pt' && wpDraft && wpDraft.length) { wpDraft.pop(); updateStatusChip(); } else { wpMode = null; wpDraft = null; marker.visible = false; canvasEl.style.cursor = 'default'; reflectWpBar(); updateStatusChip(); } return; } // Esc steps a 3pt pick back, else disarms the set-plane mode
   if (insertMode && e.key === 'Escape') { e.preventDefault(); setInsertMode(false); if (api && api.toast) api.toast('Insert cancelled'); return; }   // Esc disarms the detail-placement pick
+  if (basePickCol && e.key === 'Escape') { e.preventDefault(); setBasePickMode(null); if (api && api.toast) api.toast('Trim cancelled'); return; }   // Esc disarms the Mode B column-base pick
   if (clipMode && e.key === 'Escape') { e.preventDefault(); if (clipMode === 'box' && clipBoxDraft) { if (clipBoxDraft.b) clipBoxDraft.b = null; else clipBoxDraft = null; setClipPreview(null); updateStatusChip(); } else setClipMode(null); return; } // Esc steps back: height→footprint→cancel, else disarms the pick
   if (isolatedIds && e.key === 'Escape' && !dimMode3d) { e.preventDefault(); clearIsolation(); return; } // Esc exits isolate-selected (the dim tool's own Esc wins while it's armed)
   if (e.key === 'Escape' && !dimMode3d && !cmActive() && ascendConn()) { e.preventDefault(); return; } // Esc ascends the connection drill: part → whole → nothing
@@ -2341,6 +2397,7 @@ function onDown(e) {
     return; }
   if (addActive()) { e.stopPropagation(); controls.enabled = true; drClick(e); return; }  // Add-member armed (editor state) → two plane picks draw a member
   if (cmActive()) { if (tfClick(e)) { e.stopPropagation(); controls.enabled = true; return; } }  // Move/Copy armed (editor state) → picks land on the working plane; an empty-selection click falls through to select
+  if (basePickCol) { e.stopPropagation(); const r = basePickPoint(e.clientX, e.clientY); if (r) { if (api && api.onBasePick) api.onBasePick(r); setBasePickMode(null); } return; }  // Mode B: commit + disarm only on a valid on-column pick; an off-column click is ignored (stays armed) — Esc cancels
   if (insertMode) { e.stopPropagation(); const r = insertPick(e.clientX, e.clientY); if (r && api && api.onInsertPlace) api.onInsertPlace(r, insertPending); setInsertMode(false); return; }  // armed: place the queued detail at the pick, then disarm (one shot)
   if (clipMode === 'plane') { e.stopPropagation(); addClipPlaneAtScreen(e.clientX, e.clientY); return; } // armed: left-click a face → place a clip plane (stays armed)
   if (clipMode === 'box') { e.stopPropagation(); onClipBoxClick(e); return; }                            // armed: 2-corner clip-box draw on the floor plane
@@ -2620,6 +2677,17 @@ function onHoverMove(e) {
   hoverRAF = requestAnimationFrame(() => {
     hoverRAF = 0;
     if (!lastHoverXY || pending || dragging || boxSel) return;
+    if (basePickCol) {                         // Mode B armed: reticle on the column axis + a live elevation readout
+      const p = basePickPoint(lastHoverXY[0], lastHoverXY[1]);
+      if (p) {
+        showMarker([p.x, p.y, p.z], p.snapped ? 'end' : 'dot');
+        canvasEl.style.cursor = p.snapped ? 'none' : 'crosshair';
+        readout._dist.textContent = api.fmtLen ? api.fmtLen(p.z) : (p.z / 304.8).toFixed(2) + ' ft';
+        readout._type.textContent = p.snapped ? ' · ' + (p.label || 'level') : ' ↕';
+        readout.style.left = (lastHoverXY[0] + 14) + 'px'; readout.style.top = (lastHoverXY[1] + 14) + 'px'; readout.style.display = 'block';
+      } else { marker.visible = false; readout.style.display = 'none'; canvasEl.style.cursor = 'crosshair'; }
+      return;
+    }
     if (wpMode) {                              // armed set-plane pick: crosshair (+ snap marker for the 3pt flow)
       canvasEl.style.cursor = 'crosshair';
       if (wpMode === '3pt') { const r = dimPointAt({ clientX: lastHoverXY[0], clientY: lastHoverXY[1], altKey: dimLastAlt });
@@ -2805,6 +2873,7 @@ window.Steel3DView = {
   setProjection, projection, setDisplayMode, mode: () => displayMode, frameAll, frameSelection, applyView,
   setRefLine, refLine: () => refLineOn,
   setInsertMode, insertMode: insertModeOn,          // arm/query the detail-placement pick (Slice 4)
+  setBasePickMode, basePickMode: basePickModeOn,    // arm/query the Mode B column-base pick (level-snapped elevation)
   selectWholeConn, clearConnSel, ascendConn, connContext, connEnvelopeOn: () => !!connEnvelope, // Connection Components (Slice A): whole-select / drill / ascend + test probes
   setLabelsOn, labelsOn: () => labelsOnFlag,          // member mark/id label overlay toggle
   syncMemberLabels,                                  // editor calls after a mark/id edit to refresh labels

package/dist/web/steel-editor.html

@@ -941,6 +941,16 @@ function retargetTos(m,srcDef,dstDef){const d=dstDef-srcDef;ensureMeta(m);
 // best-effort: framing plans carry TOS at the level UNO — assume the L2 datum +16'-6" (198"); each end's
 // 'default' checkbox links it to this value (auto-updates when changed); uncheck to override.
 let defaultTOS=198, addProfile='';
+let basePickColId=null;            // Mode B: the column whose base an armed 3D level-pick retargets
+const MIN_COL_STUB_IN=12;          // never trim a column below a 1' stub (keeps bos < tos)
+// Mode B: arm the 3D column-base pick on `colId` (a level-snapped elevation → col.bos). 3D-view only.
+function armBaseTrim(colId){
+  if(!view3d){toast('Open the 3D view to pick the column base point');return;}
+  if(!(window.Steel3DView&&window.Steel3DView.setBasePickMode))return;
+  basePickColId=colId;
+  window.Steel3DView.setBasePickMode(colId);
+  toast('Click a point along '+colId+' — the base snaps to framing levels · Esc cancels');
+}
 function syncDefaults(){for(const m of P.members){ensureMeta(m);
  if(m.role==='column'){if(m.col.tosDef!==false&&defaultTOS!=null)m.col.tos=defaultTOS;if(m.col.bos==null)m.col.bos=0;}
  else for(const en of m.ends)if(en.tosDef!==false&&defaultTOS!=null)en.tos=defaultTOS;}}
@@ -1738,12 +1748,14 @@ function panel(){
      <div class=divrow><hr></div>
      <div class="row f" style="gap:6px;flex-wrap:wrap">
        <button class=ghostw id=cmpEdit data-tip="Edit this connection's parameters on ${esc(j.main)}">✎ Edit parameters on ${esc(j.main)} →</button>
+       ${isBP?`<button class=ghostw id=cmpTrim data-tip="Pick a point on ${esc(j.main)} — trim or extend the column so its base seats there (snaps to framing levels)">⭶ Trim / Extend column to base…</button>`:''}
        <button class=ghostw id=cmpAsk data-tip="Record a request for your terminal AI to modify / replace / move this connection">Modify connection…</button>
        <button class=danger id=cmpDel data-tip="Remove this whole connection">Delete connection</button>
      </div>`;
    const toMember=()=>{if(window.Steel3DView&&window.Steel3DView.clearConnSel)window.Steel3DView.clearConnSel();selIds=new Set([j.main]);selDimIds.clear();sel3dDimIds.clear();render();};
    {const b=document.getElementById('cmpMember');if(b)b.onclick=toMember;}
    {const b=document.getElementById('cmpEdit');if(b)b.onclick=toMember;}
+   {const b=document.getElementById('cmpTrim');if(b)b.onclick=()=>armBaseTrim(j.main);}
    {const b=document.getElementById('cmpAsk');if(b)b.onclick=()=>connModifyRequest(j);}
    {const b=document.getElementById('cmpDel');if(b)b.onclick=()=>edit(()=>{C.joints=(C.joints||[]).filter(x=>x!==j);selIds.clear();});}
    return;
@@ -1901,7 +1913,7 @@ function panel(){
   ${pFld('plateWidth','Plate width "N"','auto','mm')}${pFld('plateDepth','Plate depth "B"','auto','mm')}${pFld('thickness','Thickness','1"','mm')}${pFld('weldLeg','Weld leg','5/16"','mm')}
   <div class=elab style="margin-top:7px;opacity:.7">Anchor kit</div>
   ${pFld('boltCols','Bolt columns','2','')}${pFld('boltRows','Bolt rows','2','')}${pFld('boltDia','Bolt ⌀','1"','mm')}${pFld('embedment','Embedment','auto','mm')}${pFld('grout','Grout','auto','mm')}
-  <div class="row f"><button class="ghostw" id=bpRemove data-tip="Delete this column's base plate" style="color:#fca5a5;border-color:#7f1d1d">Remove base plate</button></div>`:'';
+  <div class="row f"><button class="ghostw" id=bpTrim data-tip="Pick a point on ${esc(m.id)} — trim or extend the column so its base seats there (snaps to framing levels)">⭶ Trim / Extend column to base…</button><button class="ghostw" id=bpRemove data-tip="Delete this column's base plate" style="color:#fca5a5;border-color:#7f1d1d">Remove base plate</button></div>`:'';
  // This BEAM's shear-plate joints — one params block per detailed END (start/end). Mirrors bpSect but
  // per-end (a beam can be detailed at both ends), and adds the clearance + web-side + stiffener controls.
  const spjs=col?[]:[0,1].map(e=>({e,j:(C.joints||[]).find(j=>j&&j.kind==='shear-plate'&&j.main===m.id&&j.at==='end'+e)})).filter(x=>x.j);
@@ -1977,7 +1989,8 @@ function panel(){
        else delete bpj.params[key];  // empty / invalid / ≤0 → drop the override so the engine falls back to its default
        bpj.source='user';});};};  // through edit() → the param change is undoable; editing also makes the plate user-owned (survives the auto-detail "Clear")
    ['plateWidth','plateDepth','thickness','boltDia','weldLeg','embedment','grout'].forEach(k=>wireBp(k,false));['boltCols','boltRows'].forEach(k=>wireBp(k,true));
-   {const rm=document.getElementById('bpRemove');if(rm)rm.onclick=()=>edit(()=>{C.joints=(C.joints||[]).filter(j=>j!==bpj);});}}  // Remove is undoable
+   {const rm=document.getElementById('bpRemove');if(rm)rm.onclick=()=>edit(()=>{C.joints=(C.joints||[]).filter(j=>j!==bpj);});}
+   {const tb=document.getElementById('bpTrim');if(tb)tb.onclick=()=>armBaseTrim(m.id);}}  // Remove is undoable; Trim arms the 3D base pick
  }else{
   wireTos('tosA',m.ends[0]);
   document.getElementById('ntA').onchange=e=>edit(()=>{m.ends[0].note=e.target.value;});
@@ -3072,6 +3085,23 @@ const view3dApi={
  beginClipEdit:()=>pushUndo(snapshot()),   // a clip / work-area manipulation → push a pre-edit snapshot so Ctrl+Z/Y restores it
  onClipModeChange:(m)=>{const b=document.getElementById('m3dClip');if(b){b.classList.toggle('on',!!m);b.textContent=m?'Clip ✕':'Clip ▾';}},  // armed → button fills brand-blue + becomes a cancel target (✕ = cancel)
  onInsertModeChange:(on)=>{const b=document.getElementById('m3dInsert');if(b){b.classList.toggle('on',!!on);b.textContent=on?'✕ Cancel insert':'Insert…';}},  // armed → cancel target
+ onBasePickModeChange:()=>{},   // Mode B armed state shows via the 3D crosshair + elevation readout; nothing else to reflect
+ onBasePick:(p)=>{   // Mode B: retarget the armed column's base to the picked elevation (world mm → inches), ONE undo entry
+  const m=byId(basePickColId); if(!m||m.role!=='column'||!m.col){toast('No column to trim');return;}
+  const tos=(m.col.tos!=null?m.col.tos:defaultTOS);   // inches (col.bos/tos are inches; memberGeometry ×25.4 → mm)
+  if(tos==null){toast('Set the column top (TOS) first');return;}
+  const want=p.z/25.4, cap=tos-MIN_COL_STUB_IN;
+  const bosIn=Math.min(want, cap);   // world mm → inches; clamp so the column keeps a min stub (bos<tos)
+  const clamped=want>cap+0.02;       // the pick was above the min-stub cap → we seated at the cap, not the picked level
+  const cur=(m.col.bos!=null?m.col.bos:0);
+  if(Math.abs(bosIn-cur)<0.02){toast('Column base already at that level');return;}
+  const dir=bosIn<cur?'extended':'trimmed';   // lower base = longer column = extended; higher = trimmed
+  edit(()=>{m.col.bos=bosIn;});   // set BOS only (leave tosDef — the top isn't edited); the base plate re-seats at the new base via expandBasePlate, same undo
+  // Report the ACTUAL result: a snapped level when honored, else the ft-in elevation; call out the clamp so a
+  // pick above the min stub isn't misreported as landing on the snapped level.
+  const where=clamped?(fmtFtIn(bosIn)+' (clamped to a 1′ minimum stub)'):(p.snapped?(p.label||'a level'):fmtFtIn(bosIn));
+  toast('Column '+m.id+' base '+dir+' to '+where+' — base plate re-seated');
+ },
  onInsertPlace:(pick,pending)=>{
   if(pending&&pending.kind==='connection'&&pending.connection){
    const conn=pending.connection;const rc=conn.recipe;

package/package.json

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