@floless/app 0.73.1 → 0.75.0

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

@@ -236,19 +236,38 @@
     },
     "joint": {
       "type": "object",
-      "required": ["id", "kind", "main"],
+      "required": ["id", "kind"],
       "additionalProperties": true,
-      "description": "A placed connection — the geometry-bearing recipe the connection engine expands into real 3D parts bound to its member(s). Distinct from the `connections[]` library (vendor-neutral type/detail/targets identities a joint can cite). The engine derives all geometry from this recipe + the live member positions, so a joint moves/re-solves with its members. v1 kinds: base-plate, shear-plate.",
+      "description": "A placed connection the connection engine expands into real 3D parts. A parametric RECIPE kind (base-plate, shear-plate) derives all geometry from its `params` + the live member positions, so it moves/re-solves with its members. A 'custom' kind is an imported connection (read from IFC via AWARE's connection-reader) that carries its own opaque tessellated `geometry` and a `place` point — move / replace only, no per-dimension edit. Distinct from the `connections[]` library (vendor-neutral type/detail/targets identities a joint can cite). v1 kinds: base-plate, shear-plate, custom.",
       "properties": {
-        "id": { "type": "string", "description": "Stable joint id, e.g. j-bp-1 / sp-b3-e0." },
-        "kind": { "type": "string", "description": "Connection kind the engine knows how to expand: base-plate, shear-plate (v1). end-plate / cap-plate / … follow." },
-        "main": { "type": "string", "description": "Id of the host member this joint hangs off. For a base-plate this is the column; for a shear-plate this is the SUPPORTED BEAM (the joint sits at one of the beam's ends — see `at`)." },
+        "id": { "type": "string", "description": "Stable joint id, e.g. j-bp-1 / sp-b3-e0 / cx-<id>." },
+        "kind": { "type": "string", "description": "Connection kind: base-plate, shear-plate (parametric recipes the engine expands), or custom (imported IFC geometry). end-plate / cap-plate / … follow." },
+        "main": { "type": "string", "description": "Id of the host member this joint hangs off. For a base-plate this is the column; for a shear-plate this is the SUPPORTED BEAM (the joint sits at one of the beam's ends — see `at`). Required for the recipe kinds; optional for 'custom' (an imported connection carries its own geometry rather than deriving it from a member)." },
         "secondaries": { "type": "array", "items": { "type": "string" }, "description": "Ids of the other members this joint binds — e.g. the SUPPORT a shear-plate frames into. Optional and inferred by geometry; the shear-plate engine does not require it (the fin plate is placed off the beam end + beam axis). Empty for a base-plate." },
         "at": { "type": "string", "description": "Where on the main member the joint sits (kind-dependent): base-plate = base; shear-plate = end0 | end1 — the beam end framing into the support (end0 ↔ ends[0]/start, end1 ↔ ends[1]/end)." },
         "conn": { "type": "string", "description": "Optional `connections[]` row id this joint cites for its type/detail identity (keeps the connection library + confidence scoring in play)." },
-        "params": { "type": "object", "additionalProperties": true, "description": "Geometry settings (mm) with engine defaults; absent = all defaults. base-plate: plateWidth/plateDepth/thickness, boltCols/boltRows/boltDia/edgeDist, weldLeg, anchor kit, levelingNut. shear-plate: plateThickness, plateWidth (along the beam), plateHeight (vertical), boltCols/boltRows/boltDia/boltPitch/edgeDist, weldLeg, clearance (the erection gap so the beam clears the support, ~½–¾\"; pulls the beam box back), webSide (+1/-1 — which face of the beam web the plate laps), boltGrade (A325 | A490 — the AISC bolt length auto-sizes from the grip), stiffener (bool — a full-height stiffener on the far side of a girder web)." },
+        "params": { "type": "object", "additionalProperties": true, "description": "Geometry settings (mm) with engine defaults; absent = all defaults. base-plate: plateWidth/plateDepth/thickness, boltCols/boltRows/boltDia/edgeDist, weldLeg, anchor kit, levelingNut. shear-plate: plateThickness, plateWidth (along the beam), plateHeight (vertical), boltCols/boltRows/boltDia/boltPitch/edgeDist, weldLeg, clearance (the erection gap so the beam clears the support, ~½–¾\"; pulls the beam box back), webSide (+1/-1 — which face of the beam web the plate laps), boltGrade (A325 | A490 — the AISC bolt length auto-sizes from the grip), stiffener (bool — a full-height stiffener on the far side of a girder web). Not used by 'custom'." },
         "source": { "enum": ["auto", "user"], "description": "auto = proposed by auto-detail from the takeoff; user = placed/edited by hand." },
-        "verified": { "type": "boolean", "description": "True = a human confirmed this joint." }
+        "verified": { "type": "boolean", "description": "True = a human confirmed this joint." },
+        "name": { "type": "string", "description": "custom only: display label carried from the source IFC (e.g. \"COLUMN C102\")." },
+        "place": { "$ref": "#/$defs/point3", "description": "custom only: the world-mm point the connection's LOCAL `geometry` is translated by — its placement in the model." },
+        "geometry": { "type": "array", "items": { "$ref": "#/$defs/meshPart" }, "description": "custom only: imported mesh parts (one per plate/bolt/weld) in the connection's LOCAL mm frame. Read once from IFC by AWARE's connection-reader; opaque tessellated geometry (no per-dimension edit)." }
+      },
+      "allOf": [
+        { "if": { "properties": { "kind": { "enum": ["base-plate", "shear-plate"] } } }, "then": { "required": ["main"] } },
+        { "if": { "properties": { "kind": { "const": "custom" } } }, "then": { "required": ["geometry"] } }
+      ]
+    },
+    "meshPart": {
+      "type": "object",
+      "required": ["positions", "indices"],
+      "additionalProperties": true,
+      "description": "One tessellated mesh part of a 'custom' connection (a plate / bolt / weld), in the connection's LOCAL mm frame: flat x,y,z position triples + 0-based triangle indices — AWARE's generic kind:\"mesh\" scene primitive. Read from IFC by the connection-reader; never hand-authored.",
+      "properties": {
+        "id": { "type": "string", "description": "Source part id (the IFC element GlobalId)." },
+        "role": { "type": "string", "description": "Hardware role from the source IFC: plate | bolt | weld." },
+        "positions": { "type": "array", "items": { "type": "number" }, "description": "Flat x,y,z vertex coordinates (mm), local to the connection; length is a multiple of 3." },
+        "indices": { "type": "array", "items": { "type": "number" }, "description": "0-based triangle vertex indices (triples) into positions." }
       }
     },
     "point2": {

package/dist/web/app.css

@@ -3312,7 +3312,7 @@ body {
 /* ── Workspaces (mode shell) — see docs/superpowers/mockups/2026-07-03-workspaces-mockup.html ── */
 /* The display rules below (display:flex etc.) would otherwise override the `hidden` attribute's
    UA display:none — these guards keep hidden winning so nothing leaks across modes. */
-.ws-landing[hidden], .ws-project[hidden], .ws-spine[hidden], .ws-frame[hidden], .ws-exports[hidden] { display:none !important; }
+.ws-landing[hidden], .ws-project[hidden], .ws-spine[hidden], .ws-frame[hidden], .ws-exports[hidden], .ws-history[hidden] { display:none !important; }
 .mode-switch { display:inline-flex; border:1px solid var(--border-strong); border-radius:6px;
   overflow:hidden; background:var(--surface-2); flex:none; }
 .mode-switch button { background:transparent; border:none; border-radius:0; color:var(--text-muted);
@@ -3428,3 +3428,64 @@ body {
   background:var(--surface-2); border:1px solid var(--border-strong); color:var(--text-muted); cursor:pointer; transition:all .15s; }
 .ecard .e-act button:hover:not(:disabled) { color:var(--text); border-color:var(--accent-dim); background:var(--surface); }
 .ecard .e-act button:disabled { opacity:0.6; cursor:not-allowed; }
+
+/* ── Workspaces ▸ History step (shell-rendered pane; the project's version ledger). Ports the
+      mockup's table.hist into app tokens. `position:relative` anchors the rollback confirm popover. */
+.ws-history { flex:1; min-height:0; position:relative; overflow-y:auto; padding:16px 20px;
+  scrollbar-width:thin; scrollbar-color:var(--border-strong) transparent; }
+.ws-history::-webkit-scrollbar { width:10px; }
+.ws-history::-webkit-scrollbar-thumb { background:var(--border-strong); border-radius:5px; }
+.ws-history::-webkit-scrollbar-track { background:transparent; }
+.ws-history .hist-note { font-size:12px; color:var(--text-muted); margin:0 0 14px; }
+.ws-history .hist-note b { color:var(--text); font-weight:600; }
+/* Working-copy banner — sibling of .ws-exports-gate; NEUTRAL (accent-dim rail, never a danger
+   color): "unapproved" is an absence-of-signature, not an error. Names the Exports-lock consequence. */
+.hist-working { margin:0 0 14px; padding:9px 13px; display:flex; align-items:center; gap:6px; flex-wrap:wrap;
+  background:var(--surface-2); border:1px solid var(--border); border-left:3px solid var(--accent-dim);
+  border-radius:6px; font-size:12px; color:var(--text-muted); }
+.hist-working b { color:var(--text); font-weight:600; }
+.hist-working button { background:none; border:none; padding:0; font:inherit; color:var(--accent); cursor:pointer; }
+.hist-working button:hover { color:var(--accent-bright); text-decoration:underline; }
+/* Empty state — an inline-action banner (never a bare header row, which reads as broken/loading). */
+.hist-empty { margin:6px 0 0; padding:11px 14px; background:var(--surface-2); border:1px solid var(--border);
+  border-left:3px solid var(--accent-dim); border-radius:6px; font-size:12.5px; color:var(--text-muted); }
+.hist-empty b { color:var(--text); }
+.hist-empty button { background:none; border:none; padding:0; font:inherit; color:var(--accent); cursor:pointer; }
+.hist-empty button:hover { color:var(--accent-bright); text-decoration:underline; }
+
+table.hist { width:100%; border-collapse:collapse; font-size:12.5px; }
+table.hist th { text-align:left; font-size:10px; text-transform:uppercase; letter-spacing:.1em; color:var(--text-dim);
+  font-weight:600; padding:0 12px 8px; border-bottom:1px solid var(--border); white-space:nowrap; }
+table.hist td { padding:11px 12px; border-bottom:1px solid var(--border); color:var(--text); vertical-align:middle; }
+table.hist td.change { line-height:1.45; }
+table.hist tr:hover td { background:var(--surface-2); }
+table.hist tr.current td { background:var(--accent-soft); }
+.hist .ver { font-family:var(--mono); font-size:11.5px; color:var(--text-dim); }
+.hist .ver.cur { color:var(--accent-bright); }
+.hist .htime { color:var(--text-muted); white-space:nowrap; }
+.hist .hby { display:inline-flex; align-items:center; gap:7px; white-space:nowrap; }
+.hist .avatar { width:20px; height:20px; border-radius:50%; flex:none; display:inline-flex; align-items:center;
+  justify-content:center; font-size:8.5px; font-weight:700; letter-spacing:.02em; }
+.hist .avatar.you { background:var(--surface-3); border:1px solid var(--border-strong); color:var(--text); }
+.hist .avatar.ai  { background:var(--accent-dim); color:var(--text); }
+/* Gate badge — the signed sign-off, its own column so a long change message never buries it.
+   "Model" (accent, signed) vs "unsigned" (dim/bordered — an absence of signature, not a warning). */
+.hist .gate-badge { display:inline-block; padding:2px 7px; border-radius:4px; font-size:9.5px; font-weight:600;
+  text-transform:uppercase; letter-spacing:.05em; background:transparent; border:1px solid var(--border-strong); color:var(--text-dim); }
+.hist .gate-badge.model { background:var(--accent-soft); border-color:var(--accent-dim); color:var(--accent-bright); }
+.hist .btn-mini { background:none; border:1px solid var(--border-strong); color:var(--text-muted); border-radius:6px;
+  padding:4px 10px; font-size:11px; cursor:pointer; white-space:nowrap; }
+.hist .btn-mini:hover { color:var(--text); border-color:var(--accent); }
+
+/* Rollback confirm — a styled anchored popover (NEVER a native dialog); names the Exports re-lock. */
+.hist-confirm { position:absolute; z-index:20; width:264px; padding:12px 13px; background:var(--surface-3);
+  border:1px solid var(--border-strong); border-radius:8px; box-shadow:0 8px 24px rgba(0,0,0,.4); }
+.hist-confirm .hc-title { font-size:12.5px; font-weight:600; color:var(--text); margin-bottom:5px; }
+.hist-confirm .hc-body { font-size:11.5px; color:var(--text-muted); line-height:1.45; margin-bottom:11px; }
+.hist-confirm .hc-act { display:flex; gap:8px; justify-content:flex-end; }
+.hist-confirm .hc-go { background:var(--accent); border:1px solid var(--accent); color:white; font-weight:600;
+  border-radius:6px; padding:5px 11px; font-size:11.5px; cursor:pointer; }
+.hist-confirm .hc-go:hover { background:var(--accent-bright); border-color:var(--accent-bright); box-shadow:0 0 14px var(--accent-glow); }
+.hist-confirm .hc-cancel { background:none; border:1px solid var(--border-strong); color:var(--text-muted);
+  border-radius:6px; padding:5px 11px; font-size:11.5px; cursor:pointer; }
+.hist-confirm .hc-cancel:hover { color:var(--text); border-color:var(--accent); }

package/dist/web/index.html

@@ -168,6 +168,7 @@
           <button type="button" data-step="drawings" role="tab" aria-selected="false">Drawings</button>
           <button type="button" data-step="model" class="active" role="tab" aria-selected="true">Model</button>
           <button type="button" data-step="exports" role="tab" aria-selected="false">Exports</button>
+          <button type="button" data-step="history" role="tab" aria-selected="false">History</button>
         </div>
         <!-- Two lazily-srced iframes so switching steps never reloads the editor's 3D state.
              Same-origin like #contract-editor-frame (they call /api/contract directly). -->
@@ -176,6 +177,10 @@
         <!-- Exports = a SHELL-rendered pane (not an iframe): export cards over the project's own
              contract. workspaces.js fills it on step-switch (renderExports). -->
         <div class="ws-exports" id="ws-exports" hidden></div>
+        <!-- History = a SHELL-rendered pane (not an iframe): the project's version ledger.
+             workspaces.js fills it on step-switch (renderHistory). Rollback is per-row (a header
+             ↺ Rollback verb was cut in design review — no selection context; per-row is unambiguous). -->
+        <div class="ws-history" id="ws-history" hidden></div>
       </div>
       <div class="hint" id="canvas-hint">Click any node to inspect. Star ★ a node to save it as a reusable Template. Drag the background to pan — or press Home to fit.</div>
       <div class="fav-bar" id="fav-bar">

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

@@ -422,6 +422,18 @@ function placeWasher(mesh, el) {
   mesh.position.copy(A); // extrudes from `from` toward `to`
 }
 
+// An imported connection part (slice B): AWARE's generic kind:"mesh" primitive — flat world-mm
+// positions + 0-based triangle indices straight from the connection-reader. Absolute coordinates, so
+// the mesh sits at the root origin like a member box (no local transform). Winding order isn't trusted
+// (its material is double-sided) — computeVertexNormals so it still shades.
+function placeMesh(mesh, el) {
+  const g = new THREE.BufferGeometry();
+  g.setAttribute('position', new THREE.Float32BufferAttribute(el.positions || [], 3));
+  if (Array.isArray(el.indices) && el.indices.length) g.setIndex(el.indices);
+  g.computeVertexNormals();
+  mesh.geometry = g;
+}
+
 // Build a mesh for one scene element by kind: a member box (default) or a connection part. Returns
 // false for an unknown kind so the caller skips it (forward-compatible with later part kinds).
 function placeElement(mesh, el) {
@@ -434,6 +446,7 @@ function placeElement(mesh, el) {
     case 'nut': placeNut(mesh, el); return true;
     case 'washer': placeWasher(mesh, el); return true;
     case 'weld': placeWeld(mesh, el); return true;
+    case 'mesh': placeMesh(mesh, el); return true;
     default: return false;
   }
 }
@@ -444,7 +457,10 @@ function materialFor(groupKey) {
     // Fasteners (anchor rods / bolts / nuts / washers) read more metallic (zinc-plated); plates/welds/members stay matte.
     const metallic = groupKey === 'anchor' || groupKey === 'bolt' || groupKey === 'nut' || groupKey === 'washer';
     const metal = metallic ? 0.5 : 0.1, rough = metallic ? 0.4 : 0.75;
-    baseMat.set(groupKey, new THREE.MeshStandardMaterial({ color: col, metalness: metal, roughness: rough }));
+    // Imported (custom) connection meshes are tessellated with untrusted winding order → render both
+    // faces so no triangle drops out; matte steel like a plate.
+    const dbl = groupKey === 'custom';
+    baseMat.set(groupKey, new THREE.MeshStandardMaterial({ color: col, metalness: metal, roughness: rough, side: dbl ? THREE.DoubleSide : THREE.FrontSide }));
   }
   return baseMat.get(groupKey);
 }

package/dist/web/steel-editor.html

@@ -94,7 +94,7 @@
  g.cohot:hover circle.cobub{opacity:1;stroke-width:2;filter:drop-shadow(0 0 4px currentColor)}
  text.cotx{fill:#e2e8f0;font:bold 11px system-ui;text-anchor:middle;dominant-baseline:central;pointer-events:none;opacity:.6}
  g.cohot:hover text.cotx{opacity:1}
- #detailsModal,#framesModal,#rfiModal,#confModal,#askAiModal,#connModal{position:fixed;inset:0;z-index:20;display:none;align-items:center;justify-content:center}
+ #detailsModal,#framesModal,#rfiModal,#confModal,#askAiModal,#connModal,#connImportModal{position:fixed;inset:0;z-index:20;display:none;align-items:center;justify-content:center}
  #askAiDrop:hover{border-color:var(--brand);color:var(--text)} #askAiDrop.has{border-style:solid;border-color:var(--brand)}
  .aithumb{position:relative;display:inline-flex} .aithumb img{height:60px;border-radius:4px;border:1px solid var(--line);background:#fff;display:block}
  .aithumb button{position:absolute;top:-5px;right:-5px;width:16px;height:16px;padding:0;border-radius:8px;font-size:10px;line-height:16px;text-align:center;background:#7f1d1d;border-color:#991b1b;color:#fecaca}
@@ -363,6 +363,30 @@
  #propPop .pprow.node{font-weight:500}
  #propPop .pprow .cnt{color:var(--mut);font-size:10px;font-variant-numeric:tabular-nums;white-space:nowrap;flex:none}
  #propPop .pprow.selrow{border-left:2px solid var(--brand);background:rgba(59,130,246,.16)}
+ /* Import-a-connection-from-IFC modal (slice B): dropzone → parse progress → candidate pick-list →
+    extract progress → (closes, arms the crosshair place). Built from the same tokens as .mpanel /
+    #propPop / #dnDrop — no new vocabulary. Themed inner scroll comes from the global * scrollbar rule. */
+ #connImportModal .mpanel{width:min(560px,92vw)}
+ #connImportModal.pick .mpanel{width:min(720px,92vw)}
+ #ciBody{padding:16px;display:flex;flex-direction:column;gap:10px;overflow:auto;max-height:76vh}
+ #ciDrop{border:1px dashed #475569;border-radius:8px;background:#0b1220;min-height:104px;display:flex;align-items:center;justify-content:center;text-align:center;color:var(--mut);cursor:pointer;padding:16px;font-size:12px}
+ #ciDrop:hover{border-color:var(--brand);color:var(--text)}
+ #ciDrop.drag{border-style:solid;border-color:var(--brand);color:var(--text);background:#0d1526}
+ .ci-prog{display:flex;align-items:center;gap:10px;padding:22px 4px;color:var(--text);font-size:13px}
+ .ci-spin{width:18px;height:18px;border-radius:50%;flex:none;border:2px solid var(--line);border-top-color:var(--brand);animation:ci-spin .8s linear infinite}
+ @keyframes ci-spin{to{transform:rotate(360deg)}}
+ #ciSearch{width:100%;height:28px;background:var(--bg);color:var(--text);border:1px solid var(--line);border-radius:6px;padding:0 10px;font:12px system-ui;box-sizing:border-box}
+ #ciSearch:focus{outline:none;border-color:var(--brand)}
+ #ciCount{color:var(--mut);font-size:11px}
+ #ciList{overflow:auto;max-height:min(52vh,360px);border:1px solid var(--line);border-radius:8px}
+ .ci-row{display:flex;align-items:center;gap:10px;min-height:34px;padding:6px 12px;cursor:pointer;border:0;border-bottom:1px solid #0f1a2e;background:transparent;text-align:left;width:100%;box-sizing:border-box}
+ .ci-row:last-child{border-bottom:0}
+ .ci-row:hover{background:#1e293b}
+ .ci-row.sel{background:rgba(59,130,246,.16);border-left:2px solid var(--brand);padding-left:10px}
+ .ci-row .pn{flex:1;color:var(--text);white-space:nowrap;overflow:hidden;text-overflow:ellipsis;font-size:12px}
+ .ci-row .pv{color:var(--mut);font-size:11px;font-variant-numeric:tabular-nums;white-space:nowrap;flex:none}
+ .ci-empty{color:var(--mut);font-size:12px;padding:16px;text-align:center}
+ #ciFoot{display:flex;justify-content:flex-end;gap:8px;margin-top:2px}
  /* 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. */
@@ -486,7 +510,7 @@
     <button id=detailsBtn>Details</button>
     <button id=connBtn data-tip="A lookup table of connection types (moment, shear, pinned, …). Each maps to a design detail and, per platform, a component ID; reference a row from each member end.">Connections</button>
     <div class="m3dwrap ins-in-menu" id=insWrap>
-     <button id=m3dInsert data-tip="Insert a 2D detail image into the 3D scene, near a beam (3D view only)">Insert detail…</button>
+     <button id=m3dInsert data-tip="Insert a detail image or an imported steel connection into the 3D scene (3D view only)">Insert…</button>
      <div id=m3dInsertMenu class=m3dmenu role=menu></div>
      <input id=insFile type=file accept="image/*" style="display:none">
     </div>
@@ -637,6 +661,30 @@
 <div id=rfiModal><div class=mbackdrop id=rfiBackdrop></div>
  <div class=mpanel><div class=mhead><b>Unresolved members — RFI</b><button id=rfiClose>✕</button></div>
  <div id=rfiGrid style="padding:14px;overflow:auto"></div></div></div>
+<div id=connImportModal><div class=mbackdrop id=ciBackdrop></div>
+ <div class=mpanel><div class=mhead><b id=ciTitle>Import a connection</b><button id=ciClose data-tip="Close">✕</button></div>
+  <div id=ciBody>
+   <!-- stage: dropzone -->
+   <div id=ciDropStage>
+    <div id=ciDrop data-tip="Click to browse, or drag an IFC file here"><span id=ciDropTxt>Drop an IFC file here, or click to browse</span></div>
+    <input id=ciFile type=file accept=".ifc,.ifczip" hidden>
+    <div class=hint style="margin-top:10px">Design a connection in IDEA StatiCa, Tekla or any tool, export IFC, and drop it here to place it in your model. The file stays on your machine.</div>
+    <div class=gerr id=ciDropErr style="display:none"></div>
+   </div>
+   <!-- stage: progress (parse / extract) -->
+   <div id=ciProgStage style="display:none">
+    <div class=ci-prog><span class=ci-spin aria-hidden=true></span><span id=ciProgTxt>Parsing IFC… reading connections</span></div>
+    <div style="display:flex;justify-content:flex-end;margin-top:8px"><button id=ciCancel class=ghost>Cancel</button></div>
+   </div>
+   <!-- stage: candidate pick-list -->
+   <div id=ciPickStage style="display:none">
+    <div style="margin-bottom:8px"><input id=ciSearch placeholder="Filter by name…" autocomplete=off></div>
+    <div id=ciCount style="margin-bottom:6px">—</div>
+    <div id=ciList></div>
+    <div id=ciFoot><button id=ciImport disabled data-tip="Place the selected connection in the model">Import</button></div>
+   </div>
+  </div>
+ </div></div>
 <div id=confModal><div class=mbackdrop id=confBackdrop></div>
  <div class=mpanel><div class=mhead><b>Confidence report</b><label class=conf-tgt data-tip="Confidence target for this read (%). Overrides the workflow default; saved with the contract.">Target <input id=confTarget type=number min=0 max=100 step=1> %</label><button id=confClose>✕</button></div>
  <div id=confCats class=conf-cats></div>
@@ -1520,10 +1568,12 @@ async function connModifyRequest(j){
  if(!j) return;
  try{await window.flushContract();}catch(_){}
  try{persist();}catch(_){}
- const kindName=j.kind==='base-plate'?'base plate':j.kind==='shear-plate'?'shear plate':'connection';
- const instruction='Modify the '+kindName+' connection "'+j.id+'" on member '+j.main+' (sheet '+((P&&P.sheet)||'?')+') — adjust, replace or move it per my request.';
+ const kindName=j.kind==='base-plate'?'base plate':j.kind==='shear-plate'?'shear plate':j.kind==='custom'?'imported':'connection';
+ const onMember=j.main?' on member '+j.main:'';
+ const label=j.kind==='custom'&&j.name?' ("'+j.name+'")':'';
+ const instruction='Modify the '+kindName+' connection "'+j.id+'"'+label+onMember+' (sheet '+((P&&P.sheet)||'?')+') — adjust, replace or move it per my request.';
  try{const res=await fetch('/api/contract-request',{method:'POST',headers:{'content-type':'application/json'},
-     body:JSON.stringify({appId:APP_ID,instruction,intent:'modify',target:{sheet:(P&&P.sheet)||undefined,ids:[j.id,j.main]}})});
+     body:JSON.stringify({appId:APP_ID,instruction,intent:'modify',target:{sheet:(P&&P.sheet)||undefined,ids:[j.id,j.main].filter(Boolean)}})});
    toast(res.ok?'Change queued for your terminal AI session':'Could not queue the request');
  }catch(_){toast('Could not queue the request');}
 }
@@ -1614,7 +1664,27 @@ function panel(){
  // Modify (relay) / Edit-on-member. Precedes the single-part branch below (which handles the DRILLED case).
  {const cs=connSelInfo();
   if(cs&&cs.whole){
-   const j=cs.joint,isBP=j.kind==='base-plate',pp=j.params||{};
+   const j=cs.joint;
+   // An imported (custom) connection — opaque IFC geometry, move / replace only. NEUTRAL chip (a normal
+   // state, not a fault); NO param block (replaced by a short note, never a disabled empty form).
+   if(j.kind==='custom'){
+    const nm=j.name?esc(j.name):'Imported connection';
+    const onLine=j.main?`On <button class=pilllink id=cmpMember data-tip="Select ${esc(j.main)}">${esc(j.main)}</button> · `:'';
+    p.innerHTML=`<span class=badge>Custom connection</span>
+     <div class=row style="margin:0 0 6px"><span class=chip style="border-color:var(--line);color:var(--mut)">Imported geometry — move / replace only</span></div>
+     <div class="row hint" style="margin:0 0 2px">${onLine}${cs.childIds.length} parts · ${nm}</div>
+     <div class="row hint" style="margin:0 0 6px;font-size:11px">Read from IFC — opaque tessellated geometry (no per-dimension edit). <b>Esc</b> steps back.</div>
+     <div class=divrow><hr></div>
+     <div class="row f" style="gap:6px;flex-wrap:wrap">
+       <button class=ghostw id=cmpAsk data-tip="Record a request for your terminal AI to move / replace this connection">Modify connection…</button>
+       <button class=danger id=cmpDel data-tip="Remove this whole imported connection">Delete connection</button>
+     </div>`;
+    {const b=document.getElementById('cmpMember');if(b)b.onclick=()=>{if(window.Steel3DView&&window.Steel3DView.clearConnSel)window.Steel3DView.clearConnSel();selIds=new Set([j.main]);selDimIds.clear();sel3dDimIds.clear();render();};}
+    {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;
+   }
+   const isBP=j.kind==='base-plate',pp=j.params||{};
    const plate=(partsById||{})[cs.conn+':plate']||null;
    const dim=(n)=>(n==null?'<span style="color:var(--mut)">auto</span>':esc(fmtFtIn(Number(n)/25.4)));
    const kv=(l,val)=>`<div style="display:flex;justify-content:space-between;gap:8px;font-size:12px;margin:3px 0"><span style="color:var(--mut)">${esc(l)}</span><span style="font-variant-numeric:tabular-nums">${val}</span></div>`;
@@ -2964,8 +3034,20 @@ const view3dApi={
  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)
- onInsertModeChange:(on)=>{const b=document.getElementById('m3dInsert');if(b){b.classList.toggle('on',!!on);b.textContent=on?'✕ Cancel insert':'Insert detail…';}},  // armed → cancel target
- onInsertPlace:(pick,pending)=>{if(!pending||!pending.name){toast('Pick a detail to insert first');return;}   // Slice 4: place the queued detail at the pick, select it, record the create intent
+ onInsertModeChange:(on)=>{const b=document.getElementById('m3dInsert');if(b){b.classList.toggle('on',!!on);b.textContent=on?'✕ Cancel insert':'Insert…';}},  // armed → cancel target
+ onInsertPlace:(pick,pending)=>{
+  // Slice B: place an IMPORTED connection — bake a `custom` joint carrying its LOCAL mesh geometry at
+  // the picked point (joint.place); expandCustom re-expands it into the scene as one selectable unit.
+  if(pending&&pending.kind==='connection'&&pending.connection&&Array.isArray(pending.connection.geometry)){
+   const conn=pending.connection;
+   const id='cx'+Date.now().toString(36)+Math.floor(Math.random()*1e4).toString(36);
+   const joint={id,kind:'custom',name:conn.name||'Imported connection',place:pick.point,geometry:conn.geometry,source:'user'};
+   if(pick.anchorId)joint.main=pick.anchorId; // snapped to a member face → record it for the inspector's "on member" line
+   edit(()=>{if(!Array.isArray(C.joints))C.joints=[];C.joints.push(joint);selIds=new Set(conn.geometry.map((g,i)=>id+':'+(g.id||'m'+i)));});
+   toast('Connection “'+(conn.name||'imported')+'” placed'+(pick.anchorId?' on '+pick.anchorId:'')+' — select it to move or replace');
+   return;
+  }
+  if(!pending||!pending.name){toast('Pick a detail to insert first');return;}   // Slice 4: place the queued detail at the pick, select it, record the create intent
   const id='det'+Date.now().toString(36)+Math.floor(Math.random()*1e4).toString(36);const sheet=(P&&P.sheet)||'';
   const place={id,detailName:pending.name,sheet,anchorId:pick.anchorId||null,pos:pick.point,u:pick.u,n:pick.n,rotZ:0,size:1000,opacity:1};
   edit(()=>{if(!Array.isArray(C.detail_placements))C.detail_placements=[];C.detail_placements.push(place);selIds=new Set(['det:'+id]);});
@@ -2976,7 +3058,7 @@ const view3dApi={
 };
 // Re-extrude the 3D model after a structural edit (keeps the camera where it is). Selection-only
 // changes go through render()'s setSelection — only geometry mutations need a rebuild.
-function sync3D(){if(view3d&&view3dReady&&window.Steel3DView){window.Steel3DView.rebuild(false).then(()=>{window.Steel3DView.setSelection(selIds);build3DLegend();}).catch(()=>{});}}  // rebuild also refreshes the legend (an edit may add/remove a profile)
+function sync3D(){if(view3d&&view3dReady&&window.Steel3DView){window.Steel3DView.rebuild(false).then(()=>{window.Steel3DView.setSelection(selIds);build3DLegend();panel();}).catch(()=>{});}}  // rebuild also refreshes the legend (an edit may add/remove a profile) + re-renders the inspector so a selection of just-created parts (e.g. a placed custom connection) resolves against the freshly-fetched partsById, not the pre-rebuild stale copy
 // Insert-a-detail helpers (Slice 4). armInsert queues a detail image + arms the 3D placement pick;
 // detailRequest records a create/modify request on the SAME tweak-contract channel, adding intent+target
 // so the terminal AI knows whether to build a new detail or update a placed one, and where.
@@ -2984,6 +3066,12 @@ function armInsert(name){if(!name)return;const raw=(C.custom_details||{})[name];
   if(!view3d){toast('Switch to the 3D view to place a detail');return;}
   window.Steel3DView.setInsertMode(true,{name});
   toast('Click a beam or the model to place “'+name+'” — Esc to cancel');}
+// Slice B: arm the crosshair to place an IMPORTED connection (its LOCAL mesh geometry rides on the
+// pending object; onInsertPlace bakes the custom joint where the user clicks). 3D view only.
+function armConnectionInsert(connection){if(!connection||!Array.isArray(connection.geometry)||!connection.geometry.length){toast('That connection has no geometry to place');return;}
+  if(!view3d){toast('Switch to the 3D view to place a connection');return;}
+  window.Steel3DView.setInsertMode(true,{kind:'connection',connection});
+  toast('Click in the model to place “'+(connection.name||'connection')+'” — Esc to cancel');}
 async function detailRequest(intent,place,note){
   // flushContract PUTs C to the server so the terminal AI reads the latest contract — but it clears the
   // debounced autosave (saveT) WITHOUT writing localStorage, which would drop the just-placed detail from
@@ -3307,6 +3395,7 @@ function wire3DBar(){if(bar3dWired||!window.Steel3DView)return;bar3dWired=true;
    else{const note=document.createElement('div');note.style.cssText='padding:4px 10px;color:var(--mut);font-size:12px';note.textContent='No saved details yet — add one below.';frag.appendChild(note);}
    frag.appendChild(document.createElement('hr'));
    const add=document.createElement('button');add.textContent='＋ Add an image…';add.onclick=()=>{insMenuClose();closeMore();document.getElementById('insFile').click();};frag.appendChild(add);
+   const conn=document.createElement('button');conn.textContent='Connection…';conn.dataset.tip='Import a steel connection from an IFC file';conn.onclick=()=>{insMenuClose();closeMore();window.openConnImport();};frag.appendChild(conn);
    insMenu.replaceChildren(frag);}
  insBtn.onclick=e=>{e.stopPropagation();
    if(d3.insertMode()){d3.setInsertMode(false);return;}                     // armed → cancel the pick
@@ -3316,6 +3405,93 @@ function wire3DBar(){if(bar3dWired||!window.Steel3DView)return;bar3dWired=true;
    readImageCompressed(f,b64=>{if(!b64){toast('Could not read that image — try another.');return;}
      let base=(f.name||'Detail').replace(/\.[^.]+$/,'').trim()||'Detail',name=base,i=2;while(C.custom_details[name]!=null)name=base+' '+(i++);
      edit(()=>{C.custom_details[name]=b64;});armInsert(name);});};
+ // ── Import a connection from IFC (slice B): dropzone → parse → pick → extract → arm the crosshair
+ // place. The reader runs in AWARE (web-ifc) via /api/import-connection; the UI renders + relays. Staged
+ // states swap in one modal (never a disabled Place button — the whole body swaps). ──
+ { const ci$=id=>document.getElementById(id);
+   let ciConns=[],ciSha=null,ciSel=null,ciAbort=null,ciSoftT=null;
+   const ciClearSoft=()=>{if(ciSoftT){clearTimeout(ciSoftT);ciSoftT=null;}};
+   const ciStage=s=>{ // 'drop' | 'prog' | 'pick'
+     ci$('ciDropStage').style.display=s==='drop'?'':'none';
+     ci$('ciProgStage').style.display=s==='prog'?'':'none';
+     ci$('ciPickStage').style.display=s==='pick'?'':'none';
+     ci$('ciClose').style.display=s==='prog'?'none':'';           // no ✕ mid-run — Cancel owns the exit
+     ci$('connImportModal').classList.toggle('pick',s==='pick');  // widen the panel for the list
+     ci$('ciTitle').textContent=s==='prog'?'Reading the IFC file':s==='pick'?'Choose a connection':'Import a connection'; };
+   const ciProg=(label,soft)=>{ciClearSoft();ci$('ciProgTxt').textContent=label;
+     if(soft)ciSoftT=setTimeout(()=>{ci$('ciProgTxt').textContent=soft;},6000);}; // honest "still working" after 6s — no fake %
+   const ciDropErr=msg=>{const e=ci$('ciDropErr');if(msg){e.textContent=msg;e.style.display='';}else{e.style.display='none';e.textContent='';}};
+   const ciTotal=c=>(c.plates||0)+(c.bolts||0)+(c.welds||0)+(c.members||0);
+   const ciSummary=c=>{const b=[],one=(n,s)=>{if(n)b.push(n+' '+s+(n===1?'':'s'));};one(c.plates,'plate');one(c.bolts,'bolt');one(c.welds,'weld');return b.join(' · ')||'no hardware read';};
+   function openConnImport(){ if(!view3d){toast('Switch to the 3D view to import a connection');return;}
+     ciConns=[];ciSha=null;ciSel=null;ciDropErr('');ci$('ciDrop').classList.remove('drag');
+     ciStage('drop');ci$('connImportModal').style.display='flex'; }
+   window.openConnImport=openConnImport;   // the Insert ▾ menu item calls this
+   function ciClose(){ciClearSoft();if(ciAbort){try{ciAbort.abort();}catch(_){}}ciAbort=null;ci$('connImportModal').style.display='none';}
+   function ciReadFile(f){ if(!f)return;ciDropErr('');
+     if(!/\.(ifc|ifczip)$/i.test(f.name||'')){ciDropErr('Not a valid IFC file — expected .ifc or .ifczip.');return;}
+     const r=new FileReader();r.onload=()=>ciDoList(String(r.result||''));r.onerror=()=>ciDropErr('Could not read that file — try again.');r.readAsDataURL(f); }
+   ci$('ciDrop').onclick=()=>ci$('ciFile').click();
+   ci$('ciFile').onchange=e=>{const f=e.target.files&&e.target.files[0];e.target.value='';ciReadFile(f);};
+   ci$('ciDrop').addEventListener('dragover',e=>{e.preventDefault();ci$('ciDrop').classList.add('drag');});
+   ci$('ciDrop').addEventListener('dragleave',()=>ci$('ciDrop').classList.remove('drag'));
+   ci$('ciDrop').addEventListener('drop',e=>{e.preventDefault();ci$('ciDrop').classList.remove('drag');const f=e.dataTransfer&&e.dataTransfer.files&&e.dataTransfer.files[0];ciReadFile(f);});
+   async function ciDoList(dataUrl){
+     ciStage('prog');ciProg('Parsing IFC… reading connections','Still reading — larger models can take up to 20 seconds');
+     ciAbort=new AbortController();
+     try{
+       const res=await fetch('/api/import-connection/list',{method:'POST',headers:{'content-type':'application/json'},body:JSON.stringify({appId:APP_ID,dataUrl}),signal:ciAbort.signal});
+       const j=await res.json().catch(()=>({ok:false}));ciClearSoft();
+       if(!j.ok){ciStage('drop');ciDropErr(j.error||'Could not read that IFC file.');return;}
+       ciSha=j.sha;ciConns=(j.connections||[]).slice().sort((a,b)=>ciTotal(b)-ciTotal(a)); // richest connection first
+       if(!ciConns.length){ciStage('drop');ciDropErr('No connections found in that IFC — it may not be a detailed/fabricated model.');return;}
+       if(ciConns.length===1){toast('Found one connection — '+(ciConns[0].name||'connection')+'. Building it…');ciDoExtract(ciConns[0]);return;}
+       ciRenderList();
+     }catch(e){ciClearSoft();if(e&&e.name==='AbortError')return;ciStage('drop');ciDropErr('Could not read that IFC file.');}
+   }
+   function ciRenderList(){ciStage('pick');ciSel=null;ci$('ciImport').disabled=true;ci$('ciSearch').value='';ciFilter('');setTimeout(()=>ci$('ciSearch').focus(),0);}
+   function ciFilter(q){ q=(q||'').trim().toLowerCase();
+     const matches=q?ciConns.filter(c=>String(c.name||'').toLowerCase().includes(q)||String(c.id||'').toLowerCase().includes(q)):ciConns;
+     ci$('ciCount').textContent=q?(matches.length+' of '+ciConns.length+' match “'+q+'”'):(ciConns.length+' connection'+(ciConns.length===1?'':'s')+' found');
+     const list=ci$('ciList'),frag=document.createDocumentFragment();
+     if(!matches.length){const e=document.createElement('div');e.className='ci-empty';e.textContent='No connections match “'+q+'”. Try a different name.';frag.appendChild(e);}
+     else for(const c of matches.slice(0,600)){
+       const row=document.createElement('button');row.className='ci-row';row.dataset.id=c.id;
+       const nm=document.createElement('span');nm.className='pn';nm.textContent=c.name||c.id;
+       const pv=document.createElement('span');pv.className='pv';pv.textContent=ciSummary(c);
+       row.append(nm,pv);row.onclick=()=>ciSelect(c,row);row.ondblclick=()=>{ciSelect(c,row);ciDoExtract(c);};
+       frag.appendChild(row);
+     }
+     list.replaceChildren(frag);
+     if(ciSel&&!matches.some(c=>c.id===ciSel.id)){ciSel=null;ci$('ciImport').disabled=true;} // selection got filtered out
+   }
+   function ciSelect(c,row){ciSel=c;ci$('ciImport').disabled=false;
+     for(const r of ci$('ciList').querySelectorAll('.ci-row.sel'))r.classList.remove('sel');
+     if(row)row.classList.add('sel');}
+   function ciSelectByRow(row){const c=ciConns.find(x=>x.id===row.dataset.id);if(c)ciSelect(c,row);}
+   ci$('ciSearch').addEventListener('input',e=>ciFilter(e.target.value));
+   ci$('ciSearch').addEventListener('keydown',e=>{e.stopPropagation();
+     if(e.key==='Enter'){e.preventDefault();if(ciSel)ciDoExtract(ciSel);else{const f=ci$('ciList').querySelector('.ci-row');if(f)f.click();}}
+     else if(e.key==='ArrowDown'){e.preventDefault();const r=ci$('ciList').querySelector('.ci-row');if(r){r.focus();ciSelectByRow(r);}}});
+   ci$('ciList').addEventListener('keydown',e=>{const rows=[...ci$('ciList').querySelectorAll('.ci-row')];if(!rows.length)return;const i=rows.indexOf(document.activeElement);
+     if(e.key==='ArrowDown'){e.preventDefault();const n=rows[Math.min(rows.length-1,i+1)];if(n){n.focus();ciSelectByRow(n);}}
+     else if(e.key==='ArrowUp'){e.preventDefault();if(i<=0){ci$('ciSearch').focus();}else{const n=rows[i-1];n.focus();ciSelectByRow(n);}}
+     else if(e.key==='Enter'){e.preventDefault();if(ciSel)ciDoExtract(ciSel);}});
+   ci$('ciImport').onclick=()=>{if(ciSel)ciDoExtract(ciSel);};
+   async function ciDoExtract(cand){ if(!cand)return;
+     ciStage('prog');ciProg('Building '+(cand.name||'connection')+'…','Still building — tessellating geometry');
+     ciAbort=new AbortController();
+     try{
+       const res=await fetch('/api/import-connection/extract',{method:'POST',headers:{'content-type':'application/json'},body:JSON.stringify({appId:APP_ID,sha:ciSha,id:cand.id}),signal:ciAbort.signal});
+       const j=await res.json().catch(()=>({ok:false}));ciClearSoft();
+       if(!j.ok||!j.connection){toast(j.error||'Could not read that connection.');ciStage(ciConns.length>1?'pick':'drop');return;}
+       ciClose();armConnectionInsert(j.connection);
+     }catch(e){ciClearSoft();if(e&&e.name==='AbortError')return;toast('Could not read that connection.');ciStage(ciConns.length>1?'pick':'drop');}
+   }
+   ci$('ciCancel').onclick=ciClose; ci$('ciClose').onclick=ciClose;
+   ci$('ciBackdrop').onclick=()=>{if(ci$('ciProgStage').style.display==='none')ciClose();}; // no-op mid-run so a stray backdrop click can't orphan the AWARE run
+   document.addEventListener('keydown',e=>{if(e.key==='Escape'&&ci$('connImportModal').style.display==='flex'){e.stopPropagation();ciClose();}},true);
+ }
  document.getElementById('m3dIso').onclick=()=>{if(d3.isIsolated())d3.clearIsolation();else d3.isolateSelected();};  // onIsolateChange refreshes the button label/visibility
  // Work area: the ▢ Work area button opens a menu (Set to all objects / Define from selection / Show work area).
  const workBtn=document.getElementById('m3dWork'),workMenu=document.getElementById('m3dWorkMenu');