@floless/app 0.62.0 → 0.64.0

package/dist/web/steel-editor.html

@@ -158,7 +158,7 @@
 #moreWrap{position:relative;display:inline-flex}
  #moreMenu{position:absolute;right:0;top:calc(100% + 6px);min-width:210px;background:var(--panel);border:1px solid #475569;border-radius:8px;box-shadow:0 8px 24px rgba(0,0,0,.5);padding:4px 0;z-index:30;display:none}
  #moreMenu.open{display:block}
- #moreMenu .mlabel{font-size:10px;letter-spacing:.08em;text-transform:uppercase;color:var(--mut);padding:8px 12px 2px}
+ #moreMenu .mlabel,.m3dmenu .mlabel{font-size:10px;letter-spacing:.08em;text-transform:uppercase;color:var(--mut);padding:8px 12px 2px}
  #moreMenu hr{border:0;border-top:1px solid var(--line);margin:4px 0}
  #moreMenu button{display:block;width:100%;text-align:left;background:transparent;border:0;border-radius:0;padding:7px 12px;color:var(--text);white-space:nowrap}
  #moreMenu button:hover{background:#334155}
@@ -191,6 +191,22 @@
  text.dimtx{fill:#e2e8f0;font-weight:600;font-family:system-ui;text-anchor:middle;dominant-baseline:central;pointer-events:none}
  line.dim.dimsel{stroke:#f59e0b} line.dimwit.dimsel{stroke:#f59e0b;opacity:1} rect.dimchip.dimsel{stroke:#f59e0b} circle.dimend.dimsel{fill:#f59e0b}
  circle.dimhandle{fill:#22d3ee;stroke:#0b1220;stroke-width:2;cursor:grab}
+ /* structural grid layer (under the members): dash-dot slate lines + label bubbles at both ends */
+ line.gridln{stroke:#64748b;stroke-width:1.3;stroke-dasharray:12 4 2 4;vector-effect:non-scaling-stroke;pointer-events:none;opacity:.85}
+ line.gridhit{stroke:transparent;stroke-width:9;vector-effect:non-scaling-stroke;pointer-events:stroke}
+ line.gridhit.gv{cursor:ew-resize} line.gridhit.gh{cursor:ns-resize}
+ line.gridln.gdrag{stroke:var(--brand);opacity:1}
+ circle.gridbub{fill:#0f172a;stroke:#64748b;stroke-width:1.5;vector-effect:non-scaling-stroke;cursor:grab;filter:drop-shadow(0 1px 2px rgba(0,0,0,.45))}
+ text.gridtx{fill:#e2e8f0;font-weight:700;font-family:system-ui;text-anchor:middle;dominant-baseline:central;pointer-events:none}
+ g.gridbubg:hover circle.gridbub{stroke:var(--brand);fill:#1e293b}
+ body.gridpick #svg,body.gridpick line.member,body.gridpick line.seg,body.gridpick image{cursor:crosshair}
+ .gin{width:100%;background:#0f172a;border:1px solid #475569;border-radius:6px;padding:6px 8px;color:var(--text);font:12px ui-monospace,Consolas,monospace}
+ .gin:focus{outline:none;border-color:var(--brand)}
+ .gfb{color:var(--mut);font-size:11px;margin-top:3px;font-variant-numeric:tabular-nums}
+ .gerr{color:#fca5a5;font-size:11px;margin-top:3px}
+ .gbtns{display:flex;flex-wrap:wrap;gap:8px;margin-top:12px} .gbtns button{margin:0}
+ .gck{display:flex;align-items:center;gap:8px;color:var(--text);cursor:pointer;font-size:12px;padding:2px 0}
+ .gck input{accent-color:var(--brand);cursor:pointer;margin:0;width:14px;height:14px;flex:none}  /* beat the panel's generic full-width input rule */
  body.dimsplit line.member,body.dimsplit line.seg,body.dimsplit line.dim,body.dimsplit line.dimwit,body.dimsplit image{cursor:crosshair}
  .dimprev{opacity:.85} line.dim.dimprev{stroke-dasharray:7 4}
  body.dimon line.member,body.dimon line.seg,body.dimon image{cursor:crosshair}
@@ -231,6 +247,10 @@
  .m3dmenu label{display:flex;align-items:center;gap:7px;padding:7px 12px;color:var(--text);font-size:12px;cursor:pointer;white-space:nowrap}
  .m3dmenu label:hover{background:#334155}
  .m3dmenu label input{margin:0;accent-color:var(--brand);cursor:pointer}
+ .m3dmenu .wpprow{display:flex;gap:4px;align-items:center;padding:4px 12px}
+ .m3dmenu .wpprow button{width:auto;flex:none;padding:4px 8px;border:1px solid var(--line);border-radius:5px}
+ .m3dmenu .wpprow input{width:74px;height:24px;background:var(--bg);color:var(--text);border:1px solid var(--line);border-radius:5px;padding:0 6px;font:12px system-ui}
+ .m3dmenu .wpprow input:focus{outline:none;border-color:var(--brand)}
  /* thin cluster divider in the 3D toolbar */
  #m3dBar .tb-sep{width:1px;height:18px;background:var(--line);flex:0 0 auto;align-self:center}
  /* Themed tooltip — replaces native title= so no OS-default tooltip leaks the dark theme. */
@@ -285,6 +305,9 @@
 </style>
 <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>
+<!-- grid-core is an ES module; the editor's classic script reaches it via window.GridCore (set before
+     the async contract fetch resolves in practice; gridcore-ready re-renders as a safety net). -->
+<script type="module">import * as GC from './grid-core.js';window.GridCore=GC;document.dispatchEvent(new Event('gridcore-ready'));</script>
 </head><body>
 <header>
  <b>Steel Model</b>
@@ -324,6 +347,10 @@
    <button id=dimToggleB title="Show or hide all placed dimensions on the plan">Hide dimensions</button>
    <button id=calloutToggleB title="Show or hide the clickable callout bubbles (section / elevation / detail references) on the plan">Hide callouts</button>
    <hr>
+   <div class=mlabel>Grid</div>
+   <button id=gridEditB title="Grid lines — a plan reference with Tekla-style spacings (n*d repeats a bay). Shows in 2D and 3D; drawing and drags snap to its lines and intersections.">Grid lines…</button>
+   <button id=gridToggleB title="Show or hide the grid lines in 2D and 3D">Hide grid</button>
+   <hr>
    <div class=mlabel>Coordinate system</div>
    <button id=csSetB title="Define a local X axis by clicking two points (origin, then X-direction). Y follows at 90°. Orthogonal drawing and X/Y dimensions then snap to this frame — for skewed framing.">↺ Set local axes…</button>
    <button id=csResetB title="Return to the global X/Y axes (default)" disabled>Reset to global</button>
@@ -377,6 +404,22 @@
      <button data-clip=clear class=mdanger data-tip="Remove every clip">Clear all clips</button>
     </div>
    </div>
+   <div class=m3dwrap>
+    <button id=m3dWp data-tip="Working plane — every 3D pick (Move/Copy, next: drawing) lands on it. Set it from a face, 3 points, or a principal plane.">◇ Plane ▾</button>
+    <div id=m3dWpMenu class=m3dmenu role=menu>
+     <button data-wp=face data-tip="One click on any member face — the plane lands on it">Pick a face…</button>
+     <button data-wp=3pt data-tip="Three snapped points: origin, X direction, a point on the Y side">3 points…</button>
+     <hr>
+     <div class=mlabel>Principal + offset</div>
+     <div class=wpprow>
+      <button data-wpp=xy data-tip="Horizontal plane at the offset elevation">XY</button><button data-wpp=xz data-tip="Vertical plane facing Y, offset along Y">XZ</button><button data-wpp=yz data-tip="Vertical plane facing X, offset along X">YZ</button>
+      <input id=m3dWpOff inputmode=decimal placeholder="16'-6" autocomplete=off data-tip="Offset along the plane normal (ft-in)">
+     </div>
+     <hr>
+     <label data-tip="Show or hide the plane's grid patch"><input type=checkbox id=m3dWpShow checked> Show plane</label>
+     <button data-wp=reset data-tip="Back to the active plan's level">Reset to level</button>
+    </div>
+   </div>
    <div class=m3dwrap>
     <button id=m3dWork data-tip="Working area — bound the view to a box (Tekla-style)">Work area ▾</button>
     <div id=m3dWorkMenu class=m3dmenu role=menu>
@@ -580,6 +623,7 @@ let P, X0,Y0,X1,Y1, FT, RB64, EXTX, EXTY, profs;   // per-plan, set by setPlan()
 let mode='sel', drag=null, picking=false, pickKind='profile', pickEnd=null, geoMode=null;
 let dimMode=false, dimDraft=null, dimAxis='free', selDimIds=new Set(), dimsVisible=true;   // Dimension tool: armed flag, in-progress {a,b,axis}, sticky axis, selected dim ids (multi-select), show/hide
 let calloutsVisible=true;   // Workstream B: show/hide the clickable callout bubbles (details + section/elevation/detail-ref) on the plan in select mode
+let gridMode=false, gridPick=false;   // Grid lines: panel-takeover editing mode + armed pick-origin click
 let csaxisMode=false, csDraft=null;   // Local coordinate system "set axes" tool: armed flag + in-progress origin [x,y] (null until click 1). P.frame={o,u} holds the committed local frame (null = global).
 let dimChain=false, dimChainPrev=null, dimSeq=0;   // chained "continuous" dimensioning: toggle, the running {point,axis,off,rot}, and a counter for unique ids on rapid clicks
 let dimSplitMode=false;   // "add split point" mode on a selected dim — each click inserts a point and splits the dim segment under it into two
@@ -667,7 +711,7 @@ const autofillTOS=syncDefaults;
 // live on one foundation sheet; the reader's ids are unique within the set that gets detailed). The one
 // unsupported edge is two DIFFERENT sheets each detailing a column that happens to share an id — then the
 // slice would over-match. Tracked as a reader-side id-uniqueness hardening. dims3d rides its own persistence.
-function snapshot(){const pm=new Set((P.members||[]).map(m=>m.id));return JSON.stringify({members:P.members,dims:P.dims||[],frame:P.frame||null,joints:(C.joints||[]).filter(j=>j&&pm.has(j.main)),clips:(window.Steel3DView&&window.Steel3DView.clipState)?window.Steel3DView.clipState():null});}  // clips/work area are view-state but ride the contract undo stack
+function snapshot(){const pm=new Set((P.members||[]).map(m=>m.id));return JSON.stringify({members:P.members,dims:P.dims||[],frame:P.frame||null,grid:P.grid||null,joints:(C.joints||[]).filter(j=>j&&pm.has(j.main)),clips:(window.Steel3DView&&window.Steel3DView.clipState)?window.Steel3DView.clipState():null});}  // clips/work area are view-state but ride the contract undo stack; grid is per-plan (like frame/dims) so the per-plan stack restores it safely
 // Cross-plan undo (spec §4.5): a commit that also touches ANOTHER plan captures that plan's member
 // slice too; undo/redo restore it by sheet. The entry lives on the CURRENT plan's stack — undoing
 // from the plan where the command ran is the supported path (same per-plan-stack rule as everything).
@@ -697,17 +741,18 @@ function refreshOverlayDims3d(){if(window.Steel3DView&&window.Steel3DView.refres
 function pushUndo(prev){undo.push(prev);if(undo.length>200)undo.shift();redo.length=0;scheduleSave();}
 function apply(json){const d=JSON.parse(json);
  if(Array.isArray(d))P.members=d;                                  // legacy member-only snapshot (e.g. the auto-dedupe push in setPlan)
- else{const pmOld=new Set((P.members||[]).map(m=>m.id));P.members=d.members||[];if(Array.isArray(d.dims))P.dims=d.dims;if('frame' in d)P.frame=d.frame||null;
+ else{const pmOld=new Set((P.members||[]).map(m=>m.id));P.members=d.members||[];if(Array.isArray(d.dims))P.dims=d.dims;if('frame' in d)P.frame=d.frame||null;if('grid' in d)P.grid=d.grid;
    if('joints' in d){const own=new Set([...pmOld,...P.members.map(m=>m.id)]);C.joints=(C.joints||[]).filter(j=>!(j&&own.has(j.main))).concat(d.joints||[]);}
    if(Array.isArray(d.others))for(const o of d.others){const tp=C.plans.find(p=>p.sheet===o.sheet);
      if(tp&&tp!==P)tp.members=(o.members||[]).map(ensureMeta);
-     else if(!tp){console.error('undo: sheet '+o.sheet+' not found — cross-plan slice skipped');toast('Undo couldn’t restore sheet '+o.sheet);}}}  // restore THIS plan's joint slice: drop joints owned by this plan (old ∪ restored member ids), re-add the snapshot's — OTHER sheets' joints stay untouched. Legacy member-only snapshots lack 'joints' → left alone. dims3d rides its own path. 'others' = the cross-plan slice a to-level commit captured.
+     else if(!tp){console.error('undo: sheet '+o.sheet+' not found — cross-plan slice skipped');toast('Undo couldn’t restore sheet '+o.sheet);}}}  // restore THIS plan's joint slice: drop joints owned by this plan (old ∪ restored member ids), re-add the snapshot's — OTHER sheets' joints stay untouched. grid is per-plan (restored above); 'others' = the cross-plan slice a to-level commit captured. dims3d rides its own path.
  updCS();
  selIds=new Set([...selIds].filter(id=>byId(id)));
  selDimIds.forEach(id=>{if(!(P.dims||[]).some(x=>x.id===id))selDimIds.delete(id);});  // drop any dim selection the undo removed
  if(sel3dDimIds.size){const ok=new Set((C.dims3d||[]).map(x=>x.id));sel3dDimIds=new Set([...sel3dDimIds].filter(id=>ok.has(id)));}  // drop stale 3D-dim selections
  dimDraft=null;dimChainPrev=null;dimPrevClear();   // undo/redo changed geometry under the tool → abandon any in-progress dim placement / chain (else the chain head points at a removed segment)
  cmDraft=null;cmPrevClear();cmHudClose();          // same for an in-progress Move/Copy pick — the base may reference removed geometry
+ if(window.Steel3DView&&window.Steel3DView.cmClear3d)window.Steel3DView.cmClear3d();   // and the 3D-side draft/ghosts
  if(window.Steel3DView&&window.Steel3DView.setClipState&&'clips' in d)window.Steel3DView.setClipState(d.clips);   // restore clips + work area alongside the contract
  scheduleSave();render();sync3D();}
 function doUndo(){if(!undo.length)return;redo.push(snapshotLike(undo[undo.length-1]));apply(undo.pop());}
@@ -724,7 +769,7 @@ function setSaved(state,msg){const el=document.getElementById('saveStat');if(!el
  else el.textContent=msg||'Auto-save on';}
 function persist(){try{localStorage.setItem(LSKEY,JSON.stringify({sig:dataSig(),ts:Date.now(),active:C.active,
    custom_details:C.custom_details, profile_colors:C.profile_colors, target_confidence:C.target_confidence, dims3d:C.dims3d, dim_overlays:C.dim_overlays, joints:C.joints,
-   plans:C.plans.map(p=>({sheet:p.sheet,members:p.members,default_tos:p.default_tos,details:p.details,dims:p.dims,frame:p.frame||null}))}));setSaved('ok');}catch(e){setSaved('err');console.error('local autosave failed',e);}}
+   plans:C.plans.map(p=>({sheet:p.sheet,members:p.members,default_tos:p.default_tos,details:p.details,dims:p.dims,frame:p.frame||null,grid:p.grid||null}))}));setSaved('ok');}catch(e){setSaved('err');console.error('local autosave failed',e);}}
 // --- server-side draft save: PUT the FULL contract C — this is the copy Approve bakes.
 // localStorage (persist) stays the instant per-browser draft cache; this is the durable one.
 // fetch does NOT reject on HTTP 400 (schema rejection), so treat !res.ok as 'err' (not a false 'Saved ✓'). ---
@@ -753,7 +798,7 @@ function restoreSaved(){try{const raw=localStorage.getItem(LSKEY);if(!raw)return
    if(d.custom_details)C.custom_details=d.custom_details;
    if(d.profile_colors)C.profile_colors=d.profile_colors;
    if(d.target_confidence!=null)C.target_confidence=d.target_confidence;
-   C.plans.forEach(p=>{const s=by[p.sheet];if(s){if(Array.isArray(s.members))p.members=s.members;if(s.default_tos!=null)p.default_tos=s.default_tos;if(Array.isArray(s.details))p.details=s.details;if(Array.isArray(s.dims))p.dims=s.dims;if('frame' in s)p.frame=s.frame||null;p.autofilled=true;}});
+   C.plans.forEach(p=>{const s=by[p.sheet];if(s){if(Array.isArray(s.members))p.members=s.members;if(s.default_tos!=null)p.default_tos=s.default_tos;if(Array.isArray(s.details))p.details=s.details;if(Array.isArray(s.dims))p.dims=s.dims;if('frame' in s)p.frame=s.frame||null;if('grid' in s)p.grid=s.grid||null;p.autofilled=true;}});
    if(Array.isArray(d.dims3d))C.dims3d=d.dims3d;   // restore model-global 3D dims from the local draft
    if(d.dim_overlays&&typeof d.dim_overlays==='object'&&!Array.isArray(d.dim_overlays)){const o=d.dim_overlays;C.dim_overlays={bolt_pitch:o.bolt_pitch!==false,edge_clearance:o.edge_clearance!==false,cope_size:o.cope_size!==false,base_plate:o.base_plate!==false,anchor_depth:o.anchor_depth!==false};}   // restore the legend DIMENSIONS toggles — sanitised to the known boolean keys (a corrupt/partial draft can't desync the legend from what's drawn; on unless explicitly false)
    if(Array.isArray(d.joints))C.joints=d.joints;   // restore model-global connection joints (base plates) from the local draft
@@ -847,12 +892,201 @@ function renderDims(){if(!dimsVisible||!Array.isArray(P.dims))return '';
  const HR=epR();for(const d of P.dims)if(selDimIds.has(d.id))   // each selected dim gets draggable anchor handles — drag an end to re-measure (snaps like drawing; Alt off)
    s+=`<circle class=dimhandle data-dim="${esc(d.id)}" data-dimend="0" cx="${d.a[0]}" cy="${d.a[1]}" r="${HR}"/><circle class=dimhandle data-dim="${esc(d.id)}" data-dimend="1" cx="${d.b[0]}" cy="${d.b[1]}" r="${HR}"/>`;
  return s;}
+// --- structural grid (Tekla-style; web/grid-core.js owns parsing/geometry — loaded via the module
+// shim as window.GridCore). The grid is PER-PLAN contract data (P.grid, like P.frame/P.dims — its
+// origin/spacings live in the sheet's display space, which is per-plan): X/Y are relative spacing
+// strings ("0 3*25'"), Z absolute levels. It renders under the members in 2D + as dashed lines/label
+// sprites in 3D, and feeds both snap engines. Riding the per-plan undo stack is therefore SAFE
+// (unlike the model-global dims3d). Visibility is P.grid.on (persisted, not undoable — a view toggle).
+const GC=()=>window.GridCore||null;
+function gridOn(){return !!(typeof P!=='undefined'&&P&&P.grid&&P.grid.on!==false);}
+function gridGeo(){const gc=GC();if(!gc||typeof P==='undefined'||!P||!P.grid)return null;try{return gc.gridGeometry(P.grid,(P.pt_per_ft>0)?P.pt_per_ft:1);}catch(_){return null;}}
+function gridSvg(){
+ if(!gridOn())return '';
+ const geo=gridGeo();if(!geo||(!geo.v.length&&!geo.h.length))return '';
+ const R=11/zoom,F=12/zoom;
+ let s='<g id=gridG>';
+ geo.v.forEach((l,i)=>{s+=`<line class=gridln data-gv="${i}" x1="${l.x}" y1="${l.lo}" x2="${l.x}" y2="${l.hi}"/><line class="gridhit gv" data-gv="${i}" x1="${l.x}" y1="${l.lo}" x2="${l.x}" y2="${l.hi}"><title>Grid ${esc(l.label)} — drag to move</title></line>`;});
+ geo.h.forEach((l,i)=>{s+=`<line class=gridln data-gh="${i}" x1="${l.lo}" y1="${l.y}" x2="${l.hi}" y2="${l.y}"/><line class="gridhit gh" data-gh="${i}" x1="${l.lo}" y1="${l.y}" x2="${l.hi}" y2="${l.y}"><title>Grid ${esc(l.label)} — drag to move</title></line>`;});
+ const bub=(x,y,lb,ax,i,end)=>`<g class=gridbubg data-${ax}="${i}" data-end="${end}"><title>Grid ${esc(lb)} — drag across to move, along to extend/shorten · dbl-click to rename · click to edit the grid</title><circle class=gridbub data-bx="${x}" data-by="${y}" cx="${x}" cy="${y}" r="${R}"/><text class=gridtx data-bx="${x}" data-by="${y}" x="${x}" y="${y}" style="font-size:${F}px">${esc(lb)}</text></g>`;
+ geo.v.forEach((l,i)=>{s+=bub(l.x,l.lo,l.label,'gv',i,0)+bub(l.x,l.hi,l.label,'gv',i,1);});
+ geo.h.forEach((l,i)=>{s+=bub(l.lo,l.y,l.label,'gh',i,0)+bub(l.hi,l.y,l.label,'gh',i,1);});
+ return s+'</g>';}
+// live re-render of just the grid layer while a line is being dragged (render() is too heavy per move)
+function refreshGridLayer(){const el=document.getElementById('gridG');if(el)el.outerHTML=gridSvg();}
+// cursor-following distance readout for grid drags (same chrome as the 3D drag readout)
+let gridRd=null;
+function gridReadout(e,main,sub){
+ if(!gridRd){gridRd=document.createElement('div');
+  gridRd.style.cssText='position:fixed;display:none;pointer-events:none;z-index:60;background:var(--panel);color:var(--text);border:1px solid var(--line);border-radius:4px;padding:3px 7px;font:12px system-ui;white-space:nowrap;box-shadow:0 2px 8px rgba(0,0,0,.5)';
+  gridRd._m=document.createElement('span');gridRd._s=document.createElement('span');gridRd._s.style.color='var(--mut)';
+  gridRd.append(gridRd._m,gridRd._s);document.body.appendChild(gridRd);}
+ gridRd._m.textContent=main;gridRd._s.textContent=sub||'';
+ gridRd.style.left=(e.clientX+14)+'px';gridRd.style.top=(e.clientY+14)+'px';gridRd.style.display='block';}
+function gridReadoutHide(){if(gridRd)gridRd.style.display='none';}
+const gridDelta=(d)=>'Δ '+(d<0?'−':'+')+dimValueText(Math.abs(d));
+// double-click a bubble → rename that one label in place (a themed input over the bubble; Enter/blur
+// commits into the labels override — undoable; the open grid panel's Labels field refreshes via render)
+function gridRenameBubble(axis,gi,anchorEl){
+ const gc=GC();if(!gc||!P.grid)return;
+ const geo=gridGeo();const lines=axis==='v'?geo.v:geo.h;const line=lines[gi];if(!line||!anchorEl)return;
+ const cur=line.label,r=anchorEl.getBoundingClientRect();
+ const inp=document.createElement('input');inp.value=cur;inp.className='gin';
+ inp.style.cssText='position:fixed;z-index:70;width:72px;text-align:center;left:'+(r.left+r.width/2-36)+'px;top:'+(r.top+r.height/2-14)+'px;padding:4px;border-color:var(--brand);box-shadow:0 4px 14px rgba(0,0,0,.5)';
+ document.body.appendChild(inp);inp.focus();inp.select();
+ let done=false;
+ const finish=(save)=>{if(done)return;done=true;inp.remove();
+  if(!save)return;
+  const nv=inp.value.trim();
+  if(!nv||nv===cur)return;
+  if(/\s/.test(nv)){toast('Labels can’t contain spaces');return;}
+  const key=axis==='v'?'labels_x':'labels_y',style=axis==='v'?'num':'alpha';
+  const toks=gc.labelsFor(P.grid[key],style,lines.length);toks[gi]=nv;
+  edit(()=>{P.grid[key]=toks.join(' ');});};
+ inp.addEventListener('keydown',ev=>{ev.stopPropagation();
+  if(ev.key==='Enter'){ev.preventDefault();finish(true);}
+  else if(ev.key==='Escape'){ev.preventDefault();finish(false);}});
+ inp.addEventListener('blur',()=>finish(true));}
+function planColumnCount(){let n=0;for(const m of ((P&&P.members)||[]))if(m.role==='column')n++;return n;}
+// The active plan's steel-filter elements (per-sheet linework the reader captured) — the source the
+// grid-from-drawing detector reads. Falls back to the legacy single-sheet filter shape.
+function filterElsForPlan(){const f=C&&C.filter;if(!f)return null;
+ const sh=(f.sheets||[]).find(s=>s&&s.sheet&&P&&P.sheet&&s.sheet.toUpperCase()===P.sheet.toUpperCase());
+ const els=(sh&&sh.elements)||((f.sheets||[]).length===0?f.elements:null);
+ return (Array.isArray(els)&&els.length)?els:null;}
+// Detect the printed grid in the sheet's linework (grid-core gridFromDrawing) and apply it. keep = an
+// existing grid whose Z levels / hand-set labels should survive a re-read.
+function gridReadFromDrawing(keep){
+ const gc=GC(),els=filterElsForPlan();if(!gc||!els)return;
+ let r=null;try{r=gc.gridFromDrawing(els,(P.pt_per_ft>0)?P.pt_per_ft:1);}catch(_){r=null;}
+ if(!r){toast('No grid found in this sheet’s linework — draw one with Start blank instead');return;}
+ const g=r.grid;
+ if(keep){g.z=keep.z;  // the user's levels always survive a re-read; their hand-set labels beat detected ones (the tooltip promises it)
+   if(keep.labels_x)g.labels_x=keep.labels_x;
+   if(keep.labels_y)g.labels_y=keep.labels_y;}
+ edit(()=>{P.grid=g;});
+ toast('Grid read from the drawing — '+r.info.v+' × '+r.info.h+' lines'+(r.info.labeled?'':'. Labels are auto — Ask AI can read the printed marks.'));}
+// The bubble marks on most CAD sets are OUTLINED (not text), so the detector can't read them. The
+// sanctioned path for that gap is the Ask-AI relay (the UI never calls an LLM): pre-fill the existing
+// tweak-contract request with a self-contained instruction; the terminal AI has vision + the source
+// PDF and PUTs the labels back as a contract revision.
+function gridAskAiLabels(){
+ const geo=gridGeo();if(!geo)return;
+ const t=document.getElementById('askAiText');
+ t.value='Read the structural grid bubble labels on sheet '+P.sheet+' from the source drawing and set plan.grid.labels_x and plan.grid.labels_y. '
+  +'The grid line positions are already detected: '+geo.v.length+' X lines (labels run left→right) and '+geo.h.length+' Y lines (labels run bottom→up). '
+  +'Give each as whitespace-separated tokens in that order, exactly as printed on the bubbles (e.g. "K J H G F.2 F D C B A").';
+ if(typeof askAiSyncSend==='function')askAiSyncSend();
+ askAiOpen();}
+function gridDefaultOrigin(){const xs=[],ys=[];for(const m of ((P&&P.members)||[]))if(Array.isArray(m.wp)&&m.wp.length>=2){xs.push(m.wp[0][0],m.wp[1][0]);ys.push(m.wp[0][1],m.wp[1][1]);}
+ if(xs.length)return [Math.min(...xs),Math.max(...ys)];                             // bottom-left of the steel
+ return [(typeof X0==='number'?X0:0)+50,(typeof Y1==='number'?Y1:300)-50];}         // empty plan → near the sheet corner
+function refresh3DGrid(){if(view3dReady&&window.Steel3DView&&window.Steel3DView.refreshGrid)window.Steel3DView.refreshGrid();}
+function updGridToggle(){const b=document.getElementById('gridToggleB');if(!b)return;b.disabled=!(typeof P!=='undefined'&&P&&P.grid);b.textContent=gridOn()?'Hide grid':'Show grid';}
+// ONE visibility switch, THREE surfaces: the grid panel's checkbox, the 3D legend's "Grid lines" row,
+// and the ⋯ menu item — all call this. grid.on is contract data, so the flip is undoable like every
+// other grid operation.
+function gridSetVisible(on){if(!C||typeof P==='undefined'||!P||!P.grid||on===gridOn())return;
+ edit(()=>{P.grid.on=!!on;});updGridToggle();refresh3DGrid();if(view3d)build3DLegend();}
+document.addEventListener('gridcore-ready',()=>{try{if(C)render();}catch(_){}});   // module shim finished after boot → paint the grid layer
+function setGridMode(on){if(!C)return;gridMode=!!on;
+ if(!gridMode){const ae=document.activeElement,pn=document.getElementById('panel');if(ae&&pn&&pn.contains(ae))ae.blur();  // commit a focused field (change fires on blur) BEFORE the panel is torn down — a canvas click's pointerdown runs before the browser's own focus change
+   gridPick=false;document.body.classList.remove('gridpick');snapClear();}
+ else{if(mode==='add'){mode='sel';setMode();}if(dimMode){dimMode=false;setDimMode();}if(csaxisMode){csaxisMode=false;setCsMode();}if(cmTool)disarmCm();geoMode=null;setGeo();selIds.clear();selDimIds.clear();}  // disarm Move/Copy too — grid mode and cmTool must be mutually exclusive (both own the left-click/Esc)
+ panel();}
+// The grid panel (armed-tool takeover, like the Dimension tool). Empty state = two explicit create
+// buttons (nothing is created just by opening — UX review); fields commit on change (blur/Enter),
+// one undo step each; keystrokes only update the live feedback line.
+function renderGridPanel(p){
+ const gc=GC();
+ if(!gc){p.innerHTML='<span class=badge>Grid lines</span><div class=hint style="margin-top:8px">Loading grid tools…</div>';return;}
+ const ppf=(P&&P.pt_per_ft>0)?P.pt_per_ft:1;
+ if(!P.grid){
+  const nCols=planColumnCount(),hasEls=!!filterElsForPlan();
+  p.innerHTML=`<span class=badge>Grid lines</span>
+   <div class=hint style="margin-top:8px">No grid yet. Grid lines are a plan reference — they don't constrain members.</div>
+   <div class=gbtns><button id=gridReadB ${hasEls?'':'disabled'} title="${hasEls?'Detect the printed grid lines and bubbles in this sheet’s linework. Undoable.':'Needs this sheet’s filter linework — re-read the drawing with the steel filter step to capture it.'}">From drawing</button><button id=gridAutoB ${nCols<2?'disabled':''} title="${nCols<2?'Needs at least two columns in the model to infer spacing.':'Infer spacings and origin from the column layout. Undoable.'}">Auto from columns</button><button id=gridBlankB title="Start from a 4×4 grid of 30' bays and edit the spacings. Undoable.">Start blank</button></div>
+   <div class=hint style="margin-top:10px">Spacing uses <b>n*d</b> to repeat (e.g. <b>3*25'</b> = three 25' bays). Tokens: <b>25'-6"</b>, <b>6"</b>, <b>7.5m</b>, bare mm.</div>`;
+  const rb=document.getElementById('gridReadB');if(rb)rb.onclick=()=>gridReadFromDrawing(null);
+  const ab=document.getElementById('gridAutoB');if(ab)ab.onclick=()=>{const g=gc.inferGrid(P.members,ppf);if(!g){toast('No columns to infer a grid from');return;}edit(()=>{P.grid=g;});};
+  const bb=document.getElementById('gridBlankB');if(bb)bb.onclick=()=>{const o=gridDefaultOrigin();edit(()=>{P.grid=gc.defaultGrid(o);});};
+  return;}
+ const g=P.grid,nCols=planColumnCount();
+ p.innerHTML=`<span class=badge>Grid lines</span>
+  <div class=hint style="margin-top:8px">A plan reference — doesn't constrain members. <b>n*d</b> repeats a bay (e.g. <b>3*25'</b>); tokens: <b>25'-6"</b>, <b>6"</b>, <b>7.5m</b>, bare mm.</div>
+  <label class=gck style="margin-top:10px"><input type=checkbox id=gShow ${gridOn()?'checked':''}><span>Show grid lines</span></label>
+  <div class=sect style="margin-top:12px">X spacings <span style="color:var(--mut);font-weight:400;text-transform:none">· lines 1, 2, 3…</span></div>
+  <input id=gX class=gin value="${esc(g.x||'')}" placeholder="e.g. 0 3*25' 20'-6&quot;" autocomplete=off spellcheck=false>
+  <div id=gXfb class=gfb></div>
+  <div class=sect style="margin-top:10px">Y spacings <span style="color:var(--mut);font-weight:400;text-transform:none">· lines A, B, C…</span></div>
+  <input id=gY class=gin value="${esc(g.y||'')}" placeholder="e.g. 0 4*30'" autocomplete=off spellcheck=false>
+  <div id=gYfb class=gfb></div>
+  <div class=sect style="margin-top:10px">Levels (Z)</div>
+  <input id=gZ class=gin value="${esc(g.z||'')}" placeholder="e.g. 0 16'-6&quot; 33'" autocomplete=off spellcheck=false>
+  <div id=gZfb class=gfb></div>
+  <div class=hint style="margin-top:3px">Absolute elevations, one per level — shown as tags in the 3D view.</div>
+  <div class=sect style="margin-top:10px">Labels</div>
+  <div style="display:flex;gap:6px"><input id=gLX class=gin value="${esc(g.labels_x||'')}" placeholder="auto: 1 2 3…" autocomplete=off spellcheck=false><input id=gLY class=gin value="${esc(g.labels_y||'')}" placeholder="auto: A B C…" autocomplete=off spellcheck=false></div>
+  <div id=gLfb class=gfb></div>
+  ${(!g.labels_x&&!g.labels_y)?'<div class=gbtns style="margin-top:6px"><button id=gridLabelsAiB class=ghostw title="Many drawings outline their bubble text, so the marks can’t be read deterministically. This sends a request to your AI terminal — it reads the printed marks from the source drawing and fills the labels as a contract update.">Ask AI to read the labels ▸</button></div>':''}
+  <div class=sect style="margin-top:10px">Extension</div>
+  <input id=gExt class=gin style="width:110px" value="${esc(gc.fmtLen(isFinite(g.ext)?g.ext:1524))}" autocomplete=off spellcheck=false>
+  <div class=hint style="margin-top:3px">How far every line runs past the outermost, in plan. Drag a bubble <b>along</b> its line to override just that one.</div>
+  ${(()=>{const n=Object.keys(g.ends_x||{}).length+Object.keys(g.ends_y||{}).length;return n?`<div class=gfb style="display:flex;align-items:center;gap:8px;margin-top:5px"><span>${n} line${n===1?'':'s'} with a custom extent</span><button id=gridResetExtB class=ghost style="height:22px;padding:0 8px;font-size:11px" title="Reset every line back to the Extension value above. Undoable.">Reset all</button></div>`:'';})()}
+  <div class=gbtns><button id=gridPickB class="${gridPick?'on':''}" title="Click the grid's 1-A corner on the plan — snaps to member ends. Esc cancels.">Pick origin</button><button id=gridReadB2 ${filterElsForPlan()?'':'disabled'} title="${filterElsForPlan()?'Re-detect the printed grid from this sheet’s linework — keeps your levels and hand-set labels. Undoable.':'Needs this sheet’s filter linework — re-read the drawing with the steel filter step to capture it.'}">From drawing</button><button id=gridAutoB2 ${nCols<2?'disabled':''} title="${nCols<2?'Needs at least two columns in the model to infer spacing.':'Re-infer spacings and origin from the column layout. Undoable.'}">Auto from columns</button></div>
+  ${gridPick?'<div class=hint style="margin-top:6px">Click the grid’s <b>1-A corner</b> on the plan — snaps to member ends (<b>Alt</b> off). <b>Esc</b> cancels.</div>':''}
+  <div class=gbtns style="margin-top:16px"><button id=gridRemoveB class=ghostw style="flex:1" title="Delete all grid lines and levels. Undoable.">Remove grid</button><button id=gridDoneB>Done</button></div>`;
+ const fbSpacing=(inpId,fbId,style,override,emptyMsg)=>{
+  const el=document.getElementById(fbId),v=document.getElementById(inpId).value;
+  const r=gc.parseSpacings(v);
+  if(r.err){el.className='gerr';el.textContent=r.err.replace(/^c/,'C')+(r.err.indexOf('read')>=0?" — expected n*distance, like 3*25'.":'');return;}
+  el.className='gfb';
+  if(!r.offsets.length){el.textContent=emptyMsg;return;}
+  const lbs=gc.labelsFor(document.getElementById(override).value,style,r.offsets.length);
+  const run=r.offsets[r.offsets.length-1]-r.offsets[0];
+  el.textContent=r.offsets.length+' line'+(r.offsets.length===1?'':'s')+' · '+lbs[0]+(r.offsets.length>1?'–'+lbs[lbs.length-1]:'')+(run>0?' · '+gc.fmtLen(run)+' total':'');};
+ const fbZ=()=>{const el=document.getElementById('gZfb'),toks=document.getElementById('gZ').value.trim().split(/[\s,]+/).filter(Boolean);
+  for(const t of toks)if(!isFinite(gc.parseLen(t))){el.className='gerr';el.textContent='Can’t read “'+t+'” — one elevation per level, like 16\'-6".';return;}
+  el.className='gfb';el.textContent=toks.length?(toks.length+' level'+(toks.length===1?'':'s')):'No levels — grid draws at elevation 0 in 3D.';};
+ const fbLabels=()=>{const el=document.getElementById('gLfb');
+  for(const [id,style,n] of [['gLX','num',gc.parseSpacings(document.getElementById('gX').value).offsets.length],['gLY','alpha',gc.parseSpacings(document.getElementById('gY').value).offsets.length]]){
+   const lbs=gc.labelsFor(document.getElementById(id).value,style,n),seen=new Set();
+   for(const lb of lbs){if(seen.has(lb)){el.className='gerr';el.textContent='Duplicate label “'+lb+'” — labels must be unique per direction.';return;}seen.add(lb);}}
+  el.className='gfb';el.textContent='';};
+ const fbAll=()=>{fbSpacing('gX','gXfb','num','gLX','No X lines — grid runs Y only.');fbSpacing('gY','gYfb','alpha','gLY','No Y lines — grid runs X only.');fbZ();fbLabels();};
+ fbAll();
+ // commit on change (blur/Enter); Esc restores the field; keystrokes refresh only the feedback line
+ const wire=(id,commit)=>{const el=document.getElementById(id),orig=el.value;
+  el.addEventListener('input',fbAll);
+  el.addEventListener('keydown',ev=>{ev.stopPropagation();
+   if(ev.key==='Enter'){ev.preventDefault();el.blur();}
+   else if(ev.key==='Escape'){ev.preventDefault();el.value=orig;fbAll();}});
+  el.addEventListener('change',()=>commit(el.value.trim(),el));};
+ wire('gX',(v)=>{const r=gc.parseSpacings(v);if(r.err)return;if(v!==(g.x||''))edit(()=>{  // a changed LINE COUNT invalidates the index-keyed per-line ends (they'd re-bind to the wrong lines)
+   if(P.grid.ends_x&&r.offsets.length!==gc.parseSpacings(P.grid.x).offsets.length)delete P.grid.ends_x;
+   P.grid.x=v;});});
+ wire('gY',(v)=>{const r=gc.parseSpacings(v);if(r.err)return;if(v!==(g.y||''))edit(()=>{
+   if(P.grid.ends_y&&r.offsets.length!==gc.parseSpacings(P.grid.y).offsets.length)delete P.grid.ends_y;
+   P.grid.y=v;});});
+ wire('gZ',(v)=>{const toks=v.split(/[\s,]+/).filter(Boolean);if(toks.some(t=>!isFinite(gc.parseLen(t))))return;if(v!==(g.z||''))edit(()=>{P.grid.z=v;});});
+ wire('gLX',(v)=>{if(v!==(g.labels_x||''))edit(()=>{P.grid.labels_x=v;});});
+ wire('gLY',(v)=>{if(v!==(g.labels_y||''))edit(()=>{P.grid.labels_y=v;});});
+ wire('gExt',(v,el)=>{const mm=gc.parseLen(v);if(!isFinite(mm)||mm<0){el.style.borderColor='#fca5a5';return;}el.style.borderColor='';if(Math.abs(mm-(isFinite(g.ext)?g.ext:1524))>0.5)edit(()=>{P.grid.ext=mm;});});
+ const gsh=document.getElementById('gShow');if(gsh)gsh.addEventListener('change',()=>gridSetVisible(gsh.checked));
+ const grx=document.getElementById('gridResetExtB');if(grx)grx.onclick=()=>{edit(()=>{delete P.grid.ends_x;delete P.grid.ends_y;});};   // drop every per-line extent override → all lines follow the global Extension again
+ document.getElementById('gridPickB').onclick=()=>{gridPick=!gridPick;document.body.classList.toggle('gridpick',gridPick);panel();};
+ const r2=document.getElementById('gridReadB2');if(r2)r2.onclick=()=>gridReadFromDrawing(P.grid);
+ const lb=document.getElementById('gridLabelsAiB');if(lb)lb.onclick=gridAskAiLabels;
+ const a2=document.getElementById('gridAutoB2');if(a2)a2.onclick=()=>{const ng=gc.inferGrid(P.members,ppf);if(!ng){toast('No columns to infer a grid from');return;}ng.z=P.grid.z;ng.labels_x=P.grid.labels_x;ng.labels_y=P.grid.labels_y;ng.ext=P.grid.ext;edit(()=>{P.grid=ng;});};  // re-infer geometry, keep the user's levels/labels/extension
+ document.getElementById('gridRemoveB').onclick=()=>{edit(()=>{P.grid=null;});};
+ document.getElementById('gridDoneB').onclick=()=>{setGridMode(false);render();};
+}
 function setGeo(){document.body.classList.toggle('geo',!!geoMode);}
 // --- repeat last command (AutoCAD/Tekla): when NO tool is active, Space/Enter re-invokes the last command ---
 let lastCmd=null;
 function setLastCmd(label,run){lastCmd={label,run};}
 function anyToolActive(){
- if(dimMode||dimChain||dimSplitMode||geoMode||csaxisMode||mode==='add'||picking||cmTool)return true;        // 2D tools armed (cmTool = Move/Copy)
+ if(dimMode||dimChain||dimSplitMode||geoMode||csaxisMode||gridMode||gridPick||mode==='add'||picking||cmTool)return true;        // 2D tools armed (cmTool = Move/Copy)
  if(view3d&&window.Steel3DView){if(window.Steel3DView.clipMode&&window.Steel3DView.clipMode())return true;const dm=document.getElementById('m3dDim');if(dm&&dm.classList.contains('on'))return true;}  // 3D dim/clip armed
  return false;
 }
@@ -958,6 +1192,7 @@ function esc(s){return String(s).replace(/[<>&"]/g,c=>({'<':'&lt;','>':'&gt;','&
 function render(){
  if(geoMode&&(selIds.size<1||(geoMode==='split'&&selIds.size!==1))){geoMode=null;document.body.classList.remove('geo');}   // Split needs exactly one member; Extend/Trim works on any selection
  let s=RB64?`<image href="data:image/jpeg;base64,${RB64}" x="${X0}" y="${Y0}" width="${X1-X0}" height="${Y1-Y0}"/>`:'';
+ s+=gridSvg();   // structural grid under the linework (members/dims stay on top)
  for(const sg of P.segments) s+=`<line class=seg data-seg="${sg.id}" x1="${sg.a[0]}" y1="${sg.a[1]}" x2="${sg.b[0]}" y2="${sg.b[1]}"/>`;
  for(const m of P.members){const c=colorFor(m.profile);const on=selIds.has(m.id);const g=on?` style="filter:drop-shadow(0 0 3px ${c}) drop-shadow(0 0 8px ${c})"`:'';
    s+=`<line class="member${m.rfi?' rfi':''}${on?' sel':''}" data-id="${m.id}" x1="${m.wp[0][0]}" y1="${m.wp[0][1]}" x2="${m.wp[1][0]}" y2="${m.wp[1][1]}" stroke="${c}"${g}/>`;}
@@ -991,7 +1226,7 @@ function render(){
      s+=`<circle class=numbg ${d} cx="${x}" cy="${y}" r="${R}"/><text class=numtx ${d} x="${x}" y="${y}" style="font-size:${F}px">${it.idx+1}</text>`;});}}
  s+=renderDims();
  if(P.frame)s+=axisGlyphSvg(P.frame.o,P.frame.u,false);   // local-axes glyph at the origin (only when a frame is set; removed on reset)
- svg.innerHTML=s; document.getElementById('profiles').innerHTML=profs.map(p=>`<option value="${esc(p)}">`).join(''); document.getElementById('details').innerHTML=(P.details||[]).map(d=>`<option value="${esc(d.text)}">`).join(''); stats(); panel(); updUR(); updDup(); updConf(); updCS(); updConnBtn(); updBpBtn(); updSpBtn();
+ svg.innerHTML=s; document.getElementById('profiles').innerHTML=profs.map(p=>`<option value="${esc(p)}">`).join(''); document.getElementById('details').innerHTML=(P.details||[]).map(d=>`<option value="${esc(d.text)}">`).join(''); stats(); panel(); updUR(); updDup(); updConf(); updCS(); updConnBtn(); updBpBtn(); updSpBtn(); updGridToggle();
  if(view3d&&window.Steel3DView){window.Steel3DView.setSelection(selIds);updateIsolateBtn();if(selIds.size&&window.Steel3DView.selectedClips&&window.Steel3DView.selectedClips().length)window.Steel3DView.setSelectedClips([]);}  // keep the 3D highlight in sync; selecting a member clears any clip selection (exclusive)
 }
 function updDup(){const n=redundantDups().length;
@@ -1006,6 +1241,8 @@ function updateBadges(){const R=12/zoom,F=13/zoom,ox=el=>(+el.dataset.fi-(+el.da
  svg.querySelectorAll('circle.handle,circle.dimhandle').forEach(h=>h.setAttribute('r',epR()));
  const dz=13/zoom;svg.querySelectorAll('text.dimtx').forEach(t=>t.style.fontSize=dz+'px');
  svg.querySelectorAll('circle.dimend').forEach(c=>c.setAttribute('r',3/zoom));
+ svg.querySelectorAll('circle.gridbub').forEach(c=>c.setAttribute('r',11/zoom));
+ svg.querySelectorAll('text.gridtx').forEach(t=>t.style.fontSize=(12/zoom)+'px');
  svg.querySelectorAll('rect.dimchip').forEach(r=>{const w=(+r.dataset.w)/zoom,h=(+r.dataset.h)/zoom;
    r.setAttribute('width',w);r.setAttribute('height',h);r.setAttribute('x',(+r.dataset.cx)-w/2);r.setAttribute('y',(+r.dataset.cy)-h/2);});
  const cg=svg.querySelector('g.csglyph');if(cg&&P.frame)cg.outerHTML=axisGlyphSvg(P.frame.o,P.frame.u,false);}  // glyph is sized in 1/zoom → regenerate on zoom (like the dim chips)
@@ -1024,6 +1261,7 @@ function agg(list,get){if(!list.length)return undefined;const f=get(list[0]);for
 function panel(){
  const p=document.getElementById('panel');
  if(!selDimIds.size||!dimsVisible)dimSplitMode=false;document.body.classList.toggle('dimsplit',dimSplitMode);   // split mode is meaningless without a (visible) dim selected — also disarms when dims are hidden
+ if(gridMode){renderGridPanel(p);return;}
  if(csaxisMode){p.innerHTML=`<span class=badge>Set local axes</span>
    <div class=hint id=csHint style="margin-top:8px">${csDraft?'Click the <b>second</b> point — the local-X direction. Y follows at 90°.':'Click the <b>origin</b> point to start.'}</div>
    <div class=hint style="margin-top:8px">Two clicks define the frame; snaps to member ends &amp; grid (<b>Alt</b> off). <b>Esc</b> cancels.</div>`;return;}
@@ -1064,7 +1302,7 @@ function panel(){
    <div class=hint id=pickHint style="margin-top:4px;font-style:italic">or click a label in the drawing</div>
    <div class=divrow><hr></div>
    <div class=sect>Draw a member</div>
-   <div class=hint>✏️ Drag two points on the canvas — or — click a detected segment. New members take the current profile. <b>Shift</b> = straight, <b>Esc</b> = exit.</div>`;
+   <div class=hint>✏️ ${view3d?'Click the start then the end — both land on the <b>working plane</b>. A near-vertical pick pair becomes a column.':'Drag two points on the canvas — or — click a detected segment.'} New members take the current profile. <b>Shift</b> = straight, <b>Esc</b> = exit.</div>`;
   const ap=document.getElementById('addProf');
   ap.oninput=ap.onchange=e=>{addProfile=e.target.value.toUpperCase().replace(/ /g,'');};
   return;}
@@ -1345,12 +1583,14 @@ function rectHit(p0,p1,r){
 // --- snap to existing member/segment/dimension endpoints + MIDPOINTS (△); members lie on grids → snaps to grid intersections; Alt = off ---
 const SNAP_PX=9; let snapPts=[], snapSegs=[], snapMids=[], lastSnapKind='end';   // lastSnapKind drives the marker glyph: 'mid' → triangle, else circle
 const _mid=(a,b)=>[(a[0]+b[0])/2,(a[1]+b[1])/2];
-function buildSnap(except){const ex=except instanceof Set?except:(except!=null?new Set([except]):new Set());   // id or Set of ids to skip
+function buildSnap(except,opts){const ex=except instanceof Set?except:(except!=null?new Set([except]):new Set());   // id or Set of ids to skip
  snapPts=[];snapSegs=[];snapMids=[];
  for(const m of P.members){if(ex.has(m.id))continue;snapPts.push(m.wp[0],m.wp[1]);snapSegs.push([m.wp[0],m.wp[1]]);snapMids.push(_mid(m.wp[0],m.wp[1]));}
  for(const s of P.segments){snapPts.push(s.a,s.b);snapSegs.push([s.a,s.b]);snapMids.push(_mid(s.a,s.b));}
  if(dimsVisible&&Array.isArray(P.dims))for(const d of P.dims){if(ex.has(d.id))continue;   // snap to a dimension's VISIBLE (offset) line — its ends, midpoint, and onto-line (dimGeo already gives g.mid)
-   const g=dimGeo(d.a,d.b,d.axis,d.off,d.rot);snapPts.push(g.p1,g.p2);snapSegs.push([g.p1,g.p2]);snapMids.push(g.mid);}}
+   const g=dimGeo(d.a,d.b,d.axis,d.off,d.rot);snapPts.push(g.p1,g.p2);snapSegs.push([g.p1,g.p2]);snapMids.push(g.mid);}
+ if(gridOn()&&!(opts&&opts.noGrid)){const geo=gridGeo();if(geo){const gs=GC().gridSnapGeom(geo);   // grid lines + intersections snap like member geometry (a hidden grid doesn't snap; a DRAGGED grid line must not stick to its own intersections)
+   for(const sg of gs.segs)snapSegs.push(sg);for(const q of gs.pts)snapPts.push(q);}}}
 // nearest point lying ON another member/segment LINE (perpendicular foot, clamped to the segment) within tol
 function nearestOnLine(x,y,tol){let bp=null,bd=tol;
  for(const sg of snapSegs){const pr=projPt([x,y],sg[0],sg[1]);const d=Math.hypot(pr.pt[0]-x,pr.pt[1]-y);if(d<bd){bd=d;bp=pr.pt;}}
@@ -1459,16 +1699,19 @@ function setCmUi(){document.body.classList.toggle('cmon',!!cmTool);
  document.getElementById('mvCaret').classList.toggle('on',cmTool==='move');
  document.getElementById('cpB').classList.toggle('on',cmTool==='copy');
  document.getElementById('cpCaret').classList.toggle('on',cmTool==='copy');}
-function disarmCm(){cmTool=null;cmArrayMode=false;cmDraft=null;cmHudClose();cmPrevClear();setCmUi();}
-function armCm(tool,array){ // re-arming the same config toggles the tool off
- if(view3d){toast('Move/Copy in 3D lands with the working plane (next slice) — switch to 2D');return;}
+function disarmCm(){cmTool=null;cmArrayMode=false;cmDraft=null;cmHudClose();cmPrevClear();setCmUi();
+ if(window.Steel3DView&&window.Steel3DView.cmClear3d)window.Steel3DView.cmClear3d();}   // drop the 3D-side pick/preview too
+function armCm(tool,array){ // re-arming the same config toggles the tool off — works in 2D and (on the working plane) in 3D
  if(cmTool===tool&&cmArrayMode===!!array){disarmCm();render();return;}
+ if(view3d&&window.Steel3DView){const dm=document.getElementById('m3dDim');if(dm&&dm.classList.contains('on'))window.Steel3DView.toggleDimTool();}  // the 3D dim tool shares the left-click — disarm it
  if(!selIds.size){toast('Select members first, then '+(tool==='move'?'Move':'Copy'));return;}
- if(mode==='add'){mode='sel';setMode();}
+ if(mode==='add'){mode='sel';setMode();if(window.Steel3DView&&window.Steel3DView.drClear3d)window.Steel3DView.drClear3d();}
  if(dimMode){dimMode=false;setDimMode();}
  if(csaxisMode){csaxisMode=false;setCsMode();}
+ if(gridMode||gridPick){gridMode=false;gridPick=false;document.body.classList.remove('gridpick');}  // arming Move/Copy leaves the grid panel — grid mode and cmTool must be mutually exclusive
  geoMode=null;setGeo();selDimIds.clear();dimSplitMode=false;picking=false;pickEnd=null;
  cmHudClose();cmPrevClear();   // switching Move⇄Copy mid-pick must drop the old HUD/preview — a stale HUD Enter would commit for the previous tool
+ if(window.Steel3DView&&window.Steel3DView.cmClear3d)window.Steel3DView.cmClear3d();   // and the 3D-side draft (same reason)
  cmTool=tool;cmArrayMode=!!array&&tool==='copy';cmDraft=null;cmAxis='free';setCmUi();render();
  setLastCmd(tool==='move'?'Move':(cmArrayMode?'Copy array':'Copy'),()=>{if(!cmTool)armCm(tool,array);});}
 function cmHintText(){if(!cmDraft)return (cmTool==='move'?'Move':'Copy')+' — click the base point (a snapped end, grid or line point).';
@@ -1514,22 +1757,28 @@ function cmRubSvg(a,c,dimmed){const L=Math.hypot(c[0]-a[0],c[1]-a[1]);if(L<1e-6)
  return `<line class=cmrub${dimmed?' style="opacity:.35"':''} x1="${a[0]}" y1="${a[1]}" x2="${c[0]}" y2="${c[1]}"/>`
   +`<path class=cmarrow${dimmed?' style="opacity:.35"':''} d="M ${c[0]} ${c[1]} L ${p1[0]} ${p1[1]} L ${p2[0]} ${p2[1]} Z"/>`
   +(dimmed?'':`<rect class=cmchip x="${mid[0]-cw/2/zoom}" y="${mid[1]-ch/2/zoom}" width="${cw/zoom}" height="${ch/zoom}" rx="${4/zoom}"/><text class=cmtx x="${mid[0]}" y="${mid[1]}" style="font-size:${12/zoom}px">${txt}</text>`);}
-function cmClick(e){const s=cmSnapAt(e);
+function cmClick(e){
+ if(!selIds.size){toast('Selection is empty — '+(cmTool==='move'?'Move':'Copy')+' ended');disarmCm();render();return;}  // selection drained while armed (undo/delete) — end the tool instead of collecting doomed picks
+ const s=cmSnapAt(e);
  if(!cmDraft){cmDraft={base:[s.x,s.y],vA:null};cmPrev(e);panel();return;}
  const v=[s.x-cmDraft.base[0],s.y-cmDraft.base[1],0];
  if(Math.hypot(v[0],v[1])<0.5)return;                               // ignore a zero-distance double-click
  if(cmArrayMode&&!cmDraft.vA){cmDraft.vA=v;cmPrev(e);panel();return;} // array: this click fixes direction A
  cmCommit(v);}
-function cmCommit(v){const sel=selArr();if(!sel.length){toast('Selection is empty — '+(cmTool==='move'?'Move':'Copy')+' ended');disarmCm();render();return;}
+// Shared commit core (2D picks, HUD, and the 3D flow all land here): offs = [dx,dy,dzIn] lists in
+// plan px / inches. Move applies offs[0] to the selection; copy clones per offset and selects the set.
+function cmApplyOffsets(offs){const sel=selArr();if(!sel.length){toast('Selection is empty — '+(cmTool==='move'?'Move':'Copy')+' ended');disarmCm();render();return;}
  if(cmArrayMode&&cmCountA*cmCountB>100){toast('Array capped at 100 instances — lower the counts (two passes reach further)');return;}
- const offs=cmOffsetsFor(v);
+ if(!offs.length){toast(cmArrayMode?'A 1 × 1 array places no copies — raise a count':'Nothing to place');return;}   // empty offset list (e.g. array 1×1) → no-op, never deref offs[0]
  edit(()=>{
-  if(cmTool==='move'){translateMembers(sel,v);}
+  if(cmTool==='move'){translateMembers(sel,offs[0]);}
   else{const ns=new Set();
    for(const off of offs)for(const m of sel){const c=cloneMember(m);translateMembers([c],off);P.members.push(c);ns.add(c.id);}
    selIds=ns;}});                                                   // copy selects the new set (numbered badges)
- toast((cmTool==='move'?'Moved ':'Copied ')+sel.length+' member'+(sel.length===1?'':'s')+(offs.length>1?' ×'+offs.length:'')+' · '+fmtFtIn(Math.hypot(v[0],v[1])/FT*12));
+ const L=Math.hypot(offs[0][0],offs[0][1],((offs[0][2]||0)*FT/12));  // dz shown in the same ft-in scale
+ toast((cmTool==='move'?'Moved ':'Copied ')+sel.length+' member'+(sel.length===1?'':'s')+(offs.length>1?' ×'+offs.length:'')+' · '+fmtFtIn(L/FT*12));
  cmHudClose();cmDraft=null;cmPrevClear();panel();}                  // tool stays armed for the next pick pair; Esc finishes
+function cmCommit(v){cmApplyOffsets(cmOffsetsFor(v));}
 // --- numeric HUD (spec §3.3): type after the base pick → exact distance or dx,dy[,dz] (dz inches).
 // Live parse echo while typing; unparseable Enter flags the chip red (inline, not just a toast). ---
 let cmHudEl=null;
@@ -1539,7 +1788,7 @@ function cmHudEcho(){const inp=cmHudEl.querySelector('input'),lbl=cmHudEl.queryS
  const pv=parseVec(inp.value),n=(cmTool==='copy'&&!cmArrayMode&&cmCount>1)?(' ×'+cmCount):'';
  lbl.textContent=(pv?(pv.dist!=null?('= '+fmtFtIn(pv.dist)):('= '+pv.comp.map(fmtFtIn).join(', ')))+n:n.trim());
  cmHudEl.classList.remove('err');}
-function cmHudShow(seed){if(!cmDraft)return;
+function cmHudShow(seed){if(!cmDraft&&!(view3d&&window.Steel3DView&&window.Steel3DView.cmHasBase&&window.Steel3DView.cmHasBase()))return;
  if(!cmHudEl){cmHudEl=document.createElement('div');cmHudEl.id='cmHud';
   const inp=document.createElement('input');inp.placeholder="12'-6 · or dx,dy";inp.autocomplete='off';inp.spellcheck=false;
   const lbl=document.createElement('span');lbl.id='cmHudLbl';
@@ -1548,13 +1797,19 @@ function cmHudShow(seed){if(!cmDraft)return;
   inp.addEventListener('keydown',ev=>{ev.stopPropagation();
    if(ev.key==='Enter'){ev.preventDefault();cmHudCommit(inp.value);}
    else if(ev.key==='Escape'){ev.preventDefault();cmHudClose();}});}
- const scr=cmLastEvt?[cmLastEvt.clientX,cmLastEvt.clientY]:[innerWidth/2,innerHeight/2];
+ const scr3=view3d&&window.Steel3DView&&window.Steel3DView.cmLastClient?window.Steel3DView.cmLastClient():null;
+ const scr=scr3||(cmLastEvt?[cmLastEvt.clientX,cmLastEvt.clientY]:[innerWidth/2,innerHeight/2]);
  cmHudEl.style.left=Math.min(scr[0]+16,innerWidth-200)+'px';cmHudEl.style.top=Math.min(scr[1]+16,innerHeight-46)+'px';
  cmHudEl.style.display='flex';cmHudEl.classList.remove('err');
  const inp=cmHudEl.querySelector('input');inp.value=seed||'';cmHudEcho();inp.focus();
  try{inp.setSelectionRange(inp.value.length,inp.value.length);}catch(_){}}
 function cmHudCommit(str){const pv=parseVec(str);
  if(!pv){cmHudEl.classList.add('err');toast('Enter a length (12\'-6) or components (dx,dy)');return;}
+ if(view3d&&window.Steel3DView&&window.Steel3DView.cmHudApply){   // 3D: the view maps the value into the working-plane basis and commits via onTransform3d
+  const res=window.Steel3DView.cmHudApply(pv);
+  if(res&&res.err){cmHudEl.classList.add('err');toast(res.err);return;}
+  if(res&&res.staged){cmHudClose();panel();return;}               // array direction A staged
+  cmHudClose();return;}
  let v;
  if(pv.comp){const u=P.frame?P.frame.u:[1,0],vv=[u[1],-u[0]];       // typed components live in the local frame; +Y = up the plan
   const dxp=pv.comp[0]*FT/12,dyp=pv.comp[1]*FT/12;
@@ -1571,7 +1826,7 @@ function cmHudCommit(str){const pv=parseVec(str);
 let lvModal=null;
 function lvOpen(){return !!lvModal;}
 function closeLevelModal(){if(lvModal){lvModal.remove();lvModal=null;}}
-function openLevelModal(tool){if(view3d){toast('Switch to 2D to move/copy between levels');return;}
+function openLevelModal(tool){   // works from 2D and 3D — the commit is plan-data-level
  if(!selIds.size){toast('Select members first, then '+(tool==='move'?'Move':'Copy')+' to level');return;}
  if(C.plans.length<2){toast('Only one plan is loaded — nothing to '+tool+' to');return;}
  closeLevelModal();
@@ -1665,6 +1920,18 @@ svg.addEventListener('pointerdown',e=>{if(e.button!==0)return;const t=e.target;
  if(csaxisMode){csClick(e);e.preventDefault();return;}                            // set-local-axes armed → clicks define origin then X-direction
  if(dimMode){dimClick(e);e.preventDefault();return;}                              // tool armed → all clicks place dimension points
  if(cmTool){cmClick(e);e.preventDefault();return;}                                // Move/Copy armed → clicks pick base/destination
+ if(gridPick){let q=toSvg(e),x=q.x,y=q.y;if(!e.altKey){buildSnap(null);const sn=snap(x,y);x=sn.x;y=sn.y;}snapClear();  // armed pick-origin → one snapped click sets the grid's 1-A corner (undoable)
+   gridPick=false;document.body.classList.remove('gridpick');if(P.grid)edit(()=>{P.grid.origin=[x,y];});else panel();e.preventDefault();return;}
+ {const gb=t.closest&&t.closest('g.gridbubg'),ghit=(t.classList&&t.classList.contains('gridhit'))?t:null;  // grid line body OR label bubble → drag slides the line (a no-move bubble click still opens the panel)
+  const gel=gb||ghit;
+  if(gel&&mode==='sel'&&!geoMode&&!dimSplitMode&&!picking&&P.grid){
+   const axis=gel.dataset.gv!=null?'v':'h',gi=+(gel.dataset.gv!=null?gel.dataset.gv:gel.dataset.gh);
+   if(isFinite(gi)){buildSnap(null,{noGrid:true});const q=toSvg(e);const geo=gridGeo();const line=geo&&geo[axis][gi];
+    if(line){const end=gb?+(gb.dataset.end||0):null;   // a bubble grab can become an END drag (along the line); a body grab is always a perpendicular move
+     drag={type:'gridline',axis,gi,startPt:[q.x,q.y],orig:axis==='v'?line.x:line.y,origEnd:end===0?line.lo:line.hi,end,
+      base:geo[axis].map(l=>axis==='v'?l.x:l.y),bubble:!!gb,moved:false,dir:null,pre:snapshot()};  // base = dragstart positions so one drag quantizes the string ONCE (no 1/16" creep on unmoved lines)
+     svg.setPointerCapture(e.pointerId);e.preventDefault();return;}}}}
+ if(gridMode)setGridMode(false);                                                   // any other canvas click leaves the grid panel — selection takes the panel back (fields commit on blur first)
  if(dimSplitMode&&selDimIds.size&&dimsVisible&&mode==='sel'){let q=toSvg(e),x=q.x,y=q.y;if(!e.altKey){buildSnap(null);const sn=snap(x,y);x=sn.x;y=sn.y;}snapClear();dimSplitAt([x,y]);e.preventDefault();return;}  // split mode → each click inserts a point into the selected dim under it
  if(t.dataset.dimend!=null&&mode==='sel'){const id=t.dataset.dim,end=+t.dataset.dimend;buildSnap(id);drag={type:'dimend',id,end,pre:snapshot()};svg.setPointerCapture(e.pointerId);e.preventDefault();return;}  // drag a selected dim's anchor handle → re-measure (snaps; exclude this dim so the end can't snap to its own line/midpoint)
  if(t.dataset.dim&&mode==='sel'){const did=t.dataset.dim;selIds.clear();           // a dim click is member-exclusive (clears any member selection)
@@ -1719,6 +1986,34 @@ svg.addEventListener('pointermove',e=>{
    const d=Math.hypot(q.x-raw.pt[0],q.y-raw.pt[1]);
    if(d<16/zoom&&raw.t>0.03&&raw.t<0.97){let cut=raw.pt;if(!e.altKey){buildSnap(m.id);const sn=snap(raw.pt[0],raw.pt[1]);if(sn.hit){const p2=projPt([sn.x,sn.y],m.wp[0],m.wp[1]);if(p2.t>0.02&&p2.t<0.98)cut=p2.pt;}}snapMark(cut[0],cut[1],'end');}else snapClear();}return;}  // the cut lands ON the member → always the neutral circle, never a stale midpoint △ (e.g. Alt held = no snap() this frame)
  if(!drag)return;const p=toSvg(e);
+ if(drag.type==='gridline'){const dxc=p.x-drag.startPt[0],dyc=p.y-drag.startPt[1];
+   if(!drag.moved){if(Math.hypot(dxc,dyc)<=4/zoom)return;drag.moved=true;   // past the tolerance = a drag, not a click
+     const along=drag.axis==='v'?Math.abs(dyc):Math.abs(dxc),perp=drag.axis==='v'?Math.abs(dxc):Math.abs(dyc);
+     drag.dir=(drag.end!=null&&along>perp)?'along':'perp';}                 // a bubble dragged ALONG the line adjusts that end; anything else slides the line
+   const gc=GC();if(!gc)return;const ppf=(P.pt_per_ft>0)?P.pt_per_ft:1;
+   if(drag.dir==='perp'){
+     let np=drag.orig+(drag.axis==='v'?dxc:dyc);
+     if(!e.altKey){let bd=SNAP_PX/zoom,bp=null;                             // slide-snap: the PERPENDICULAR coordinate of member/segment endpoints (align the grid to the steel)
+       for(const q of snapPts){const c=drag.axis==='v'?q[0]:q[1];const d=Math.abs(c-np);if(d<bd){bd=d;bp=c;}}
+       if(bp!=null){np=bp;snapMark(drag.axis==='v'?np:p.x,drag.axis==='v'?p.y:np,'line');}else snapClear();}
+     else snapClear();
+     const applied=gc.moveGridLine(P.grid,ppf,drag.axis,drag.gi,np,drag.base);  // clamps between neighbours, rebases origin on line 1/A
+     const geo=gridGeo(),lines=geo?geo[drag.axis]:null;                     // live readout: how far it moved + the bay it resizes
+     let sub='';
+     if(lines&&lines.length>1){const pos=(l)=>drag.axis==='v'?l.x:l.y;const bay=drag.gi>0?Math.abs(pos(lines[drag.gi])-pos(lines[drag.gi-1])):Math.abs(pos(lines[1])-pos(lines[0]));sub=' · bay '+dimValueText(bay);}
+     gridReadout(e,gridDelta((applied!=null?applied:np)-drag.orig),sub);
+   }else{
+     let np=drag.origEnd+(drag.axis==='v'?dyc:dxc);
+     if(!e.altKey){let bd=SNAP_PX/zoom,bp=null;                             // end-snap: the ALONG coordinate of member/segment endpoints
+       for(const q of snapPts){const c=drag.axis==='v'?q[1]:q[0];const d=Math.abs(c-np);if(d<bd){bd=d;bp=c;}}
+       if(bp!=null){np=bp;snapMark(drag.axis==='v'?drag.orig:np,drag.axis==='v'?np:drag.orig,'end');}else snapClear();}
+     else snapClear();
+     const applied=gc.moveGridLineEnd(P.grid,ppf,drag.axis,drag.gi,drag.end,np);  // 12" min length; near the full span → back to auto
+     gridReadout(e,gridDelta((applied!=null?applied:np)-drag.origEnd),'');
+   }
+   refreshGridLayer();
+   const dl=svg.querySelector(`line.gridln[data-g${drag.axis}="${drag.gi}"]`);if(dl)dl.classList.add('gdrag');  // highlight the line in flight
+   return;}
  if(drag.type==='dimend'){const d=P.dims.find(x=>x.id===drag.id);if(d){let x=p.x,y=p.y;if(!e.altKey){const sn=snap(x,y);x=sn.x;y=sn.y;sn.hit?snapMark(x,y):snapClear();}else snapClear();if(drag.end===0)d.a=[x,y];else d.b=[x,y];render();}return;}  // dragging a dim anchor → snap + re-measure live
  if(drag.type==='dim'){const d=P.dims.find(x=>x.id===drag.id);if(d){d.off=dimOffFromPointer(d.a,d.b,d.axis,[p.x,p.y],d.rot);render();}return;}
  if(drag.type==='draw'){let x=p.x,y=p.y;
@@ -1745,6 +2040,13 @@ svg.addEventListener('pointermove',e=>{
  else if(!e.altKey){const sn=snap(x,y);x=sn.x;y=sn.y;sn.hit?snapMark(x,y):snapClear();}else snapClear();
  m.wp[drag.h]=[x,y];updateLine(m);updateHandles(m);});
 svg.addEventListener('pointerup',()=>{if(!drag)return;snapClear();
+ if(drag.type==='gridline'){const wasBubble=drag.bubble,moved=drag.moved,pre=drag.pre;drag=null;gridReadoutHide();
+   if(!moved){if(wasBubble){setGridMode(true);                         // opens the panel (clears the logical selection). NO render() — replacing the bubble between the two clicks of a dbl-click would swallow the rename gesture…
+     svg.querySelectorAll('line.member.sel').forEach(n=>{n.classList.remove('sel');n.style.filter='';});   // …so drop the stale selection VISUALS surgically instead
+     svg.querySelectorAll('circle.handle,circle.dimhandle,circle.numbg,text.numtx').forEach(n=>n.remove());
+     svg.querySelectorAll('.dimsel').forEach(n=>n.classList.remove('dimsel'));}
+    return;}                                                           // a no-move line-body click is a no-op (selection untouched)
+   if(pre&&snapshot()!==pre)pushUndo(pre);render();return;}
  if(drag.type==='draw'){const a=[drag.x0,drag.y0],b=drag.cur||a;drag.line.remove();
    if(len(a,b)>6){const dx=Math.abs(b[0]-a[0]),dy=Math.abs(b[1]-a[1]),o=dx>3*dy?'H':(dy>3*dx?'V':'D');
      const id='m'+Date.now(),pv=snapshot();P.members.push(ensureMeta({id,profile:addProfile,wp:[a,b],angle:o,rfi:(_wt(addProfile)==null)}));
@@ -1755,8 +2057,17 @@ svg.addEventListener('pointerup',()=>{if(!drag)return;snapClear();
      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.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
+ const at=document.elementFromPoint(e.clientX,e.clientY);   // the pointer capture the drag takes retargets dblclick to the svg root — resolve the bubble by position, not e.target
+ const gb=at&&at.closest&&at.closest('g.gridbubg');
+ if(gb&&mode==='sel'&&P&&P.grid&&!dimMode&&!csaxisMode&&!geoMode&&!picking){
+  e.preventDefault();
+  gridRenameBubble(gb.dataset.gv!=null?'v':'h',+(gb.dataset.gv!=null?gb.dataset.gv:gb.dataset.gh),gb.querySelector('circle'));}});
 function setMode(){document.body.classList.toggle('add',mode==='add');document.getElementById('mAdd').classList.toggle('on',mode==='add');}
-document.getElementById('mAdd').onclick=()=>{if(dimMode){dimMode=false;setDimMode();}if(csaxisMode){csaxisMode=false;setCsMode();}if(cmTool)disarmCm();selDimIds.clear();mode=(mode==='add'?'sel':'add');if(mode==='add')selIds.clear();setMode();render();setLastCmd('Add member',()=>{if(mode!=='add'){if(dimMode){dimMode=false;setDimMode();}mode='add';selIds.clear();setMode();render();}});};  // entering add/sel disarms the Dimension + set-axes tools (else they keep eating canvas clicks) and drops any dim selection
+document.getElementById('mAdd').onclick=()=>{if(dimMode){dimMode=false;setDimMode();}if(csaxisMode){csaxisMode=false;setCsMode();}if(cmTool)disarmCm();
+ if(view3d&&window.Steel3DView){const dm=document.getElementById('m3dDim');if(dm&&dm.classList.contains('on'))window.Steel3DView.toggleDimTool();}  // the 3D dim tool shares the left-click — disarm it when entering add mode
+ selDimIds.clear();mode=(mode==='add'?'sel':'add');if(mode==='add')selIds.clear();else if(window.Steel3DView&&window.Steel3DView.drClear3d)window.Steel3DView.drClear3d();setMode();render();setLastCmd('Add member',()=>{if(mode!=='add'){if(dimMode){dimMode=false;setDimMode();}mode='add';selIds.clear();setMode();render();}});};  // entering add/sel disarms the Dimension + set-axes tools (else they keep eating canvas clicks) and drops any dim selection; leaving add clears the 3D draw draft
 document.getElementById('dimB').onclick=()=>{if(csaxisMode){csaxisMode=false;setCsMode();}dimMode=!dimMode;setDimMode();render();setLastCmd('Dimension',()=>{if(!dimMode){dimMode=true;setDimMode();render();}});};
 document.getElementById('csSetB').onclick=()=>{csaxisMode=!csaxisMode;setCsMode();render();};
 document.getElementById('csResetB').onclick=()=>{resetFrame();render();};
@@ -1764,6 +2075,8 @@ function updDimToggle(){const b=document.getElementById('dimToggleB');if(b)b.tex
 document.getElementById('dimToggleB').onclick=()=>{dimsVisible=!dimsVisible;updDimToggle();render();};
 function updCalloutToggle(){const b=document.getElementById('calloutToggleB');if(b)b.textContent=calloutsVisible?'Hide callouts':'Show callouts';}
 document.getElementById('calloutToggleB').onclick=()=>{calloutsVisible=!calloutsVisible;updCalloutToggle();render();};
+document.getElementById('gridEditB').onclick=()=>{setGridMode(!gridMode);render();};
+document.getElementById('gridToggleB').onclick=()=>gridSetVisible(!gridOn());
 document.getElementById('dupB').onclick=()=>{const ids=redundantDups();   // re-scan on demand (also runs live after every edit)
  if(!ids.length){const b=document.getElementById('dupB');b.dataset.flash='1';b.classList.add('ok');b.textContent='No duplicates ✓';
    setTimeout(()=>{delete b.dataset.flash;b.classList.remove('ok');updDup();},1500);return;}
@@ -1794,11 +2107,16 @@ addEventListener('keydown',e=>{
  if(e.key==='Home'){e.preventDefault();if(view3d&&window.Steel3DView)window.Steel3DView.frameAll();else fitToWindow();return;}
  if(!view3d&&!inForm&&(((e.key==='z'||e.key==='Z')&&e.altKey)||(e.key===' '&&e.shiftKey))){e.preventDefault();zoomToSelection();return;}  // 2D zoom-to-selected (Tekla Shift+Space / Alt+Z); 3D handles its own (steel-3d-view onKey)
  if((e.key===' '||e.key==='Enter')&&!inForm&&!e.ctrlKey&&!e.metaKey&&!e.altKey&&!e.shiftKey){if(!anyToolActive()&&lastCmd){e.preventDefault();repeatLast();}return;}  // idle Space/Enter → repeat the last command (AutoCAD/Tekla)
- if(e.key==='Escape'&&cmTool){if(cmHudIsOpen())cmHudClose();else if(cmDraft&&cmDraft.vA){cmDraft.vA=null;cmRefreshPrev();panel();}else if(cmDraft){cmDraft=null;cmPrevClear();panel();}else{disarmCm();render();}return;}  // Move/Copy Esc ladder: HUD → array dir A → base pick → exit tool
+ if(e.key==='Escape'&&gridPick){gridPick=false;document.body.classList.remove('gridpick');snapClear();panel();return;}  // Esc disarms pick-origin (grid mode stays)
+ if(e.key==='Escape'&&gridMode&&!inForm){setGridMode(false);render();return;}  // Esc exits the grid panel (a focused field handles its own Esc = revert)
+ if(e.key==='Escape'&&cmTool){if(cmHudIsOpen())cmHudClose();
+  else if(view3d&&window.Steel3DView&&window.Steel3DView.cmEscape&&window.Steel3DView.cmEscape()){}   // 3D: step the pick back (array dir A → base) before exiting
+  else if(cmDraft&&cmDraft.vA){cmDraft.vA=null;cmRefreshPrev();panel();}else if(cmDraft){cmDraft=null;cmPrevClear();panel();}else{disarmCm();render();}return;}  // Move/Copy Esc ladder: HUD → array dir A → base pick → exit tool
  if(e.key==='Escape'&&csaxisMode){if(csDraft){csDraft=null;csPrevClear();}else{csaxisMode=false;setCsMode();}render();return;}  // 1st Esc drops the in-progress origin, 2nd exits set-axes
  if(e.key==='Enter'&&dimMode&&dimChainPrev){e.preventDefault();dimChainPrev=null;dimPrevClear();render();return;}  // Enter ends a running chain
  if(e.key==='Escape'&&dimMode){if(dimChainPrev){dimChainPrev=null;dimPrevClear();}else if(dimDraft){dimDraft=null;dimPrevClear();}else{dimMode=false;setDimMode();}render();return;}  // Esc: end the chain → drop the in-progress dim → exit the tool
  if(e.key==='Escape'&&selDimIds.size){if(dimSplitMode){dimSplitMode=false;snapClear();render();}else{selDimIds.clear();render();}return;}  // Esc on a selected dim: end split mode → else deselect
+ if(e.key==='Escape'&&view3d&&mode==='add'&&window.Steel3DView&&window.Steel3DView.drEscape&&window.Steel3DView.drEscape()){return;}  // 3D draw: 1st Esc drops the in-progress start pick, 2nd exits add mode (falls through below)
  if(e.key==='Escape'){if(geoMode){geoMode=null;setGeo();render();return;}if(mode==='add'){mode='sel';setMode();}picking=false;pickKind='profile';pickEnd=null;selIds.clear();render();return;}
  if((e.key==='Delete'||e.key==='Backspace')&&view3d&&window.Steel3DView.selectedClips&&window.Steel3DView.selectedClips().length&&!selIds.size&&!sel3dDimIds.size&&!selDimIds.size&&!inForm){e.preventDefault();window.Steel3DView.deleteSelectedClips();return;}  // 3D: Del removes the selected clip plane(s)/box(es) — only when nothing else is selected (clip selection is exclusive)
  if((e.key==='Delete'||e.key==='Backspace')&&view3d&&sel3dDimIds.size&&!selIds.size&&!inForm){e.preventDefault();[...sel3dDimIds].forEach(id=>view3dApi.onDeleteDim3d(id));return;}  // 3D: Delete removes ALL selected 3D dims — only when no member is selected
@@ -1809,10 +2127,13 @@ addEventListener('keydown',e=>{
  if(dimMode&&!inForm&&!e.ctrlKey&&!e.metaKey&&!e.altKey){const dk=e.key.toLowerCase();
    if(dk==='x'||dk==='y'||dk==='f'){e.preventDefault();dimSetAxis(dk==='f'?'free':dk);dimDraft&&svg.querySelector('#dimPrevG')&&dimRefreshPrev();return;}
    if(dk==='c'){e.preventDefault();toggleDimChain();return;}}   // C — toggle chained (continuous) dimensioning
- if(cmTool&&!inForm&&!e.ctrlKey&&!e.metaKey&&!e.altKey){const ak=e.key.toLowerCase();   // Move/Copy armed: X/Y/F force the axis, typing opens the exact-value HUD
-  if(ak==='x'||ak==='y'||ak==='f'){e.preventDefault();cmAxis=ak==='f'?'free':ak;cmRefreshPrev();return;}
-  if(cmDraft&&/^[0-9.\-']$/.test(e.key)){e.preventDefault();cmHudShow(e.key);return;}}
- if(!inForm&&!e.ctrlKey&&!e.metaKey&&!e.altKey&&!view3d&&!dimMode){const ck=e.key.toLowerCase();   // M / C — arm Move / Copy (mirrors D for dims; dim-armed keys win above)
+ if(cmTool&&!inForm&&!e.ctrlKey&&!e.metaKey&&!e.altKey){const ak=e.key.toLowerCase();   // Move/Copy armed: X/Y/F force the axis (plane axes in 3D), typing opens the exact-value HUD
+  if(ak==='x'||ak==='y'||ak==='f'){e.preventDefault();
+   if(view3d&&window.Steel3DView&&window.Steel3DView.setCmAxis)window.Steel3DView.setCmAxis(ak);
+   else{cmAxis=ak==='f'?'free':ak;cmRefreshPrev();}return;}
+  const hasBase=cmDraft||(view3d&&window.Steel3DView&&window.Steel3DView.cmHasBase&&window.Steel3DView.cmHasBase());
+  if(hasBase&&/^[0-9.\-']$/.test(e.key)){e.preventDefault();cmHudShow(e.key);return;}}
+ if(!inForm&&!e.ctrlKey&&!e.metaKey&&!e.altKey&&!dimMode){const ck=e.key.toLowerCase();   // M / C — arm Move / Copy (2D and 3D; dim-armed keys win above)
   if(ck==='m'){e.preventDefault();armCm('move',false);return;}
   if(ck==='c'){e.preventDefault();armCm('copy',false);return;}}
  if(!inForm&&selDimIds.size>=1&&!selIds.size&&!e.ctrlKey&&!e.metaKey&&!e.altKey&&e.key.toLowerCase()==='s'){e.preventDefault();toggleDimSplit();return;}  // S — toggle "add split point" on the selected dimension(s)
@@ -1875,6 +2196,7 @@ const view3dApi={
  onTrimExtend:(targetId)=>{const tm=byId(targetId);if(tm){geoMode=null;setGeo();snapEndMulti(selArr(),tm.wp[0],tm.wp[1]);}},  // 3D Trim/Extend → every selected member's nearest end to the target line
  onSplit:(id,wp)=>{const m=byId(id);if(m){doSplit(m,wp);sync3D();}},  // 3D Split → cut at the clicked point on the member
  getDims3d:()=>C.dims3d||[],
+ getGrid:()=>(P&&P.grid)||null,                              // the ACTIVE plan's structural grid for the 3D render + plan-locked snapping (per-plan, display-space)
  getDimOverlays:()=>C.dim_overlays||{},   // the legend DIMENSIONS toggles {bolt_pitch,edge_clearance,cope_size} — the 3D view derives + filters overlays from this
  // dims3d is model-global: mutate + persist directly. NOT via edit() — a plan-scoped undo snapshot would corrupt dims3d across plans (undo on plan A could wipe dims added on plan B), and edit()'s sync3D would needlessly re-extrude every member mesh for a pure annotation. boot() guarantees C.dims3d is an array.
  onAddDim3d:(dim)=>{C.dims3d.push(dim);scheduleSave();refreshDims3d();},
@@ -1890,6 +2212,31 @@ const view3dApi={
  selDim3d:()=>[...sel3dDimIds],
  newDim3dId:()=>'d3'+Date.now()+'_'+(dimSeq++),   // same scheme as 2D dim ids (Date.now + dimSeq tie-breaker)
  fmtLen:(mm)=>fmtFtIn(mm/304.8*12),
+ toast:(m)=>toast(m),
+ // 3D Move/Copy: the 3D view reads the armed tool + counts, and hands commit offsets back in scene mm.
+ cmState:()=>cmTool?{tool:cmTool,array:cmArrayMode,count:cmCount,countA:cmCountA,countB:cmCountB}:null,
+ onTransform3d:(offsMm)=>{const k=304.8/((P&&P.pt_per_ft>0)?P.pt_per_ft:1),r6=(n)=>Math.round(n*1e6)/1e6;   // mm → plan px (Y FLIPPED, matching dispToMm) + inches for dz; r6 kills float-noise before it persists into wp
+   cmApplyOffsets(offsMm.map(o=>[r6(o[0]/k),r6(-o[1]/k),r6((o[2]||0)/25.4)]));},
+ disarmTransform:()=>{if(cmTool){disarmCm();render();}},   // the 3D dim tool arming kicks Move/Copy off the left-click
+ // 3D draw-on-plane (spec §7): the editor's add-member mode + profile drive it; two plane picks (scene mm) come back here.
+ addModeActive:()=>mode==='add',
+ disarmAdd:()=>{if(mode==='add'){mode='sel';setMode();render();}},
+ onAddMember3d:(aMm,bMm)=>{const k=304.8/((P&&P.pt_per_ft>0)?P.pt_per_ft:1),r6=n=>Math.round(n*1e6)/1e6;   // mm → wp px (Y FLIPPED) + elevation inches
+   const wpA=[r6(aMm[0]/k),r6(-aMm[1]/k)],wpB=[r6(bMm[0]/k),r6(-bMm[1]/k)];
+   const zA=r6(aMm[2]/25.4),zB=r6(bMm[2]/25.4);
+   const hpx=Math.hypot(wpB[0]-wpA[0],wpB[1]-wpA[1]),hIn=hpx/FT*12,dzIn=Math.abs(zB-zA);
+   const id='m'+Date.now();
+   edit(()=>{let m;
+     if(hIn<6&&dzIn>6){m=ensureMeta({id,profile:addProfile,wp:[wpA.slice(),wpA.slice()],role:'column'});   // near-vertical run → a column at the plan point
+       m.col={bos:Math.min(zA,zB),tos:Math.max(zA,zB),note:'',tosDef:false,detail:''};}
+     else{const near=z=>Math.abs(z-defaultTOS)<0.5;                                                        // a pick ON the level stays default-linked
+       m=ensureMeta({id,profile:addProfile,wp:[wpA,wpB],role:'beam',angle:_mAngle([wpA,wpB])});             // classify H/V/D from the PLAN delta — same rule as _mAngle + the 2D add path (all three agree)
+       const mfNote=/(^|[^A-Z])MF/i.test(addProfile||'')?'moment':'';                                       // a moment-frame profile keeps the auto note ensureMeta gives 2D-drawn members
+       m.ends=[{tos:near(zA)?null:zA,note:mfNote,tosDef:near(zA),detail:''},{tos:near(zB)?null:zB,note:mfNote,tosDef:near(zB),detail:''}];}
+     m.rfi=(_wt(addProfile)==null);P.members.push(m);
+     if(addProfile&&!profs.includes(addProfile)){profs.push(addProfile);profs.sort();}
+     selIds=new Set([id]);});
+   toast('Added '+(hIn<6&&dzIn>6?'a column':'a beam')+' on the working plane');},
  onClipsChange:()=>{build3DLegend();},   // a clip added / removed / toggled → rebuild the legend's Clip section
  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)
@@ -2082,6 +2429,18 @@ function build3DLegend(){const host=document.getElementById('m3dLegend');if(!hos
      host.appendChild(buildCatHeader(ck,dc.label,dc.cats.length,{sub:true,getState:()=>dcState(dc.cats),onToggle:()=>dcToggle(dc.cats),toggleTitle:'Show / hide all '+dc.label.toLowerCase()+' dimensions'}));
      if(!collapsedCats.has(ck))for(const k of dc.cats)addDimRow(k,DIM_LABEL[k],true);}
  }
+ // GRID — the structural grid's visibility (per-plan contract data; same undoable switch as the panel
+ // checkbox and the ⋯ menu item). Only shown when this plan has a grid — slate outline swatch to match
+ // the grid's colour, not the cyan dim overlays.
+ if(typeof P!=='undefined'&&P&&P.grid){
+   host.appendChild(Object.assign(document.createElement('div'),{className:'ldiv'}));
+   const grow=document.createElement('div');grow.className='lrow dim';grow.title='Show / hide the structural grid (2D + 3D)';
+   const gsw=document.createElement('span');gsw.className='lsw';gsw.style.borderColor='#64748b';
+   grow.append(gsw,document.createTextNode('Grid lines'));
+   grow.classList.toggle('dimoff',!gridOn());
+   grow.addEventListener('click',()=>gridSetVisible(!gridOn()));
+   host.appendChild(grow);
+ }
  // CLIP — the active clip planes/boxes (a third axis: each HIDES geometry beyond it). Click a row to enable/
  // disable it (eye-style, like a hidden part); the × deletes. Empty state reads "(no clips)" so the section
  // looks available, not broken. Rebuilt by api.onClipsChange whenever a clip is added/removed/toggled.
@@ -2159,7 +2518,25 @@ function wire3DBar(){if(bar3dWired||!window.Steel3DView)return;bar3dWired=true;
  function workMenuClose(){workMenu.classList.remove('open');document.removeEventListener('mousedown',workMenuOutside,true);}
  workBtn.onclick=e=>{e.stopPropagation();if(workMenu.classList.contains('open'))workMenuClose();else{updateWorkBtn();workMenu.classList.add('open');document.addEventListener('mousedown',workMenuOutside,true);}};
  workMenu.querySelectorAll('button[data-wa]').forEach(b=>b.onclick=()=>{workMenuClose();const a=b.dataset.wa;if(a==='all')d3.workAreaSetAll();else if(a==='sel'){if(!d3.workAreaFromSelection())d3.workAreaSetAll();}});  // define from selection; fall back to whole model if nothing's selected
- document.getElementById('m3dWorkOn').onchange=e=>{d3.workAreaToggle(e.target.checked);};}
+ document.getElementById('m3dWorkOn').onchange=e=>{d3.workAreaToggle(e.target.checked);};
+ // Working plane: ◇ Plane menu (face pick / 3 points / principal+offset / show / reset). While a pick
+ // mode is armed the button is a cancel target (reflectWpBar renders '✕' — same pattern as Clip).
+ const wpBtn=document.getElementById('m3dWp'),wpMenu=document.getElementById('m3dWpMenu');
+ function wpMenuOutside(e){if(!wpMenu.contains(e.target)&&e.target!==wpBtn)wpMenuClose();}
+ function wpMenuClose(){wpMenu.classList.remove('open');document.removeEventListener('mousedown',wpMenuOutside,true);}
+ wpBtn.onclick=e=>{e.stopPropagation();
+   const info=d3.workPlaneInfo();
+   if(info.mode){d3.armWorkPlanePick(info.mode);return;}                 // armed → cancel the pick
+   if(wpMenu.classList.contains('open'))wpMenuClose();
+   else{wpMenu.classList.add('open');document.addEventListener('mousedown',wpMenuOutside,true);}};
+ wpMenu.querySelectorAll('button[data-wp]').forEach(b=>b.onclick=()=>{wpMenuClose();const a=b.dataset.wp;
+   if(a==='reset')d3.clearWorkPlane();
+   else{d3.armWorkPlanePick(a);setLastCmd('Set working plane',()=>d3.armWorkPlanePick(a));}});
+ wpMenu.querySelectorAll('button[data-wpp]').forEach(b=>b.onclick=()=>{wpMenuClose();
+   const offIn=parseLen(document.getElementById('m3dWpOff').value)||0;   // ft-in → inches → mm along the normal
+   d3.setWorkPlanePrincipal(b.dataset.wpp,offIn*25.4);});
+ document.getElementById('m3dWpShow').onchange=e=>{d3.toggleWorkPlaneVisible(e.target.checked);};
+ document.getElementById('m3dWpOff').addEventListener('keydown',ev=>{ev.stopPropagation();if(ev.key==='Enter'){ev.preventDefault();const xy=wpMenu.querySelector('button[data-wpp=xy]');if(xy)xy.click();}});}  // Enter in the offset = apply XY (the common case); stopPropagation keeps editor shortcuts out
 function applyViewState(on){            // flip the toggle + swap the canvases (no 3D side effects)
  view3d=on;
  const t2=document.getElementById('vt2d'),t3=document.getElementById('vt3d');
@@ -2177,7 +2554,7 @@ function applyViewState(on){            // flip the toggle + swap the canvases (
 async function setView(on){
  if(on){
   if(dimMode||dimChain||dimSplitMode){dimMode=dimChain=dimSplitMode=false;selDimIds.clear();setDimMode();document.body.classList.remove('dimsplit');}  // entering 3D disarms the 2D dim/chain/split tools so their X/Y/F/S/Esc keys don't double-fire with the 3D tool
-  if(cmTool){disarmCm();render();}     // Move/Copy is 2D-only until the working-plane slice — disarm so its keys don't shadow the 3D tools
+  if(cmTool){cmDraft=null;cmPrevClear();cmHudClose();}   // Move/Copy stays armed across the view switch — only the in-progress 2D pick is dropped (it's in plan px)
   if(selIds.size)sel3dDimIds.clear();  // a member selected in 2D wins over a stale 3D-dim selection
   if(!window.Steel3DView){toast('3D view unavailable (renderer failed to load)');return;}  // stay in 2D
   try{
@@ -2192,7 +2569,8 @@ async function setView(on){
    applyViewState(false);if(window.Steel3DView)window.Steel3DView.hide();
    toast('Could not open 3D view: '+((e&&e.message)||e));
   }
- }else{applyViewState(false);if(window.Steel3DView)window.Steel3DView.hide();}
+ }else{if(cmTool&&window.Steel3DView&&window.Steel3DView.cmClear3d)window.Steel3DView.cmClear3d();   // 3D→2D: drop the mm-space pick the same way (tool stays armed)
+  applyViewState(false);if(window.Steel3DView)window.Steel3DView.hide();}
 }
 document.getElementById('vt2d').onclick=()=>{if(view3d)setView(false);};
 document.getElementById('vt3d').onclick=()=>{if(!view3d)setView(true);};
@@ -2648,6 +3026,9 @@ function setPlan(i){C.active=i;P=C.plans[i];
  if(!Array.isArray(P.segments))P.segments=[];
  if(!Array.isArray(P.dims))P.dims=[];
  sanitizeFrame(P);   // tolerate a hand-edited/AI-written frame: normalize or drop to global
+ // grid: drop a malformed hand-edited/AI-written grid at the load boundary (like sanitizeFrame) —
+ // the renderers assume a finite [x,y] origin; the spacing strings report their own errors inline.
+ if(P.grid!=null&&(typeof P.grid!=='object'||Array.isArray(P.grid)||!Array.isArray(P.grid.origin)||P.grid.origin.length<2||!isFinite(P.grid.origin[0])||!isFinite(P.grid.origin[1]))){console.warn('discarding malformed grid on '+P.sheet);P.grid=null;}
  // clip = the drawing's display-space crop. A contract may ship WITHOUT a raster/clip (a shared or
  // committed contract strips raster_b64 for confidentiality), so fall back to the members' bounding
  // box (padded) → the editor renders members on a blank canvas instead of crashing on P.clip[0].
@@ -2671,6 +3052,7 @@ function setPlan(i){C.active=i;P=C.plans[i];
  undo=P.undo||(P.undo=[]);redo=P.redo||(P.redo=[]);
  selIds=new Set();picking=false;pickKind='profile';pickEnd=null;mode='sel';geoMode=null;
  dimMode=false;dimChain=false;dimSplitMode=false;selDimIds=new Set();setDimMode();   // Dimension tool resets per plan (incl. chain + split); setDimMode syncs the button/body.dimon classes + clears any draft/preview/chain (dimsVisible persists across plans)
+ if(gridMode||gridPick){gridMode=false;gridPick=false;document.body.classList.remove('gridpick');}   // grid panel/pick-origin disarm per plan like the other takeover tools (a leaked pick would set the origin in the WRONG sheet's display space)
  csaxisMode=false;setCsMode();                     // set-axes tool resets per plan; P.frame itself is per-plan data (persisted), so it stays
  disarmCm();                                       // Move/Copy resets per plan too (its counts persist — they're session prefs, not plan data)
  defaultTOS=(P.default_tos!=null?P.default_tos:198);