npm - brep-io-kernel - Versions diffs - 1.0.0 → 1.0.11 - Mend

brep-io-kernel 1.0.0 → 1.0.11

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (134) hide show

package/dist-kernel/help/brep-kernel.html DELETED Viewed

@@ -1,258 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
-<head>
-<meta charset="utf-8" />
-<meta name="viewport" content="width=device-width,initial-scale=1" />
-<title>BREP Kernel Reference - BREP</title>
-<style>
-:root{
-  --bg:#0b0f14; --panel:#0f141b; --text:#d7dde6; --muted:#9aa7b2;
-  --border:#1b2430; --accent:#5cc8ff; --chip:#121823;
-}
-*{box-sizing:border-box}
-html,body{margin:0;background:var(--bg);color:var(--text);font:14px/1.5 ui-monospace,SFMono-Regular,Menlo,Consolas,'Liberation Mono','Courier New',monospace}
-main{max-width:1100px;margin:0 auto;padding:28px}
-h1{margin:0 0 18px;font-size:22px;color:var(--accent);font-weight:700}
-.summary{color:var(--muted);margin-bottom:22px}
-.card{background:var(--panel);border:1px solid var(--border);border-radius:14px;padding:18px;margin:0 0 18px}
-.readme{padding:0}
-.readme .header{padding:16px 18px;border-bottom:1px solid var(--border)}
-.readme .content{padding:18px}
-.doc-card{padding:18px}
-.doc-nav{margin:0 0 18px;display:flex;gap:12px;flex-wrap:wrap;align-items:center;color:var(--muted)}
-.doc-nav-links{display:flex;gap:12px;flex-wrap:wrap;align-items:center}
-.doc-nav a{color:var(--accent);font-weight:600}
-.doc-list{list-style:none;margin:18px 0;padding:0}
-.doc-list li{margin:6px 0}
-.doc-list a{color:var(--accent)}
-.nav-search{margin-left:auto;position:relative;display:flex;align-items:center;gap:8px;flex-wrap:wrap;justify-content:flex-end;min-width:240px;max-width:520px}
-.search-title{font-weight:700;font-size:14px;margin-bottom:4px}
-.search-hint{color:var(--muted);font-size:12px;margin:0}
-.search-input-row{display:flex;gap:8px;align-items:center;width:100%}
-.search-input{flex:1;border:1px solid var(--border);border-radius:10px;background:var(--chip);color:var(--text);padding:10px 12px}
-.search-input:focus{outline:1px solid var(--accent);box-shadow:0 0 0 3px rgba(92,200,255,0.15)}
-.search-clear{border:1px solid var(--border);background:var(--panel);color:var(--muted);border-radius:10px;padding:9px 12px;cursor:pointer;font-weight:600}
-.search-clear:hover{border-color:var(--accent);color:var(--accent)}
-.search-status{color:var(--muted);font-size:12px;margin-top:4px;width:100%;text-align:right}
-.search-results{position:absolute;top:100%;right:0;margin-top:10px;border:1px solid var(--border);border-radius:12px;background:var(--panel);max-height:360px;overflow:auto;min-width:320px;max-width:520px;box-shadow:0 12px 30px rgba(0,0,0,0.35);z-index:25}
-.search-results ul{list-style:none;margin:0;padding:0}
-.search-item{padding:10px 12px;border-bottom:1px solid var(--border)}
-.search-item:last-child{border-bottom:none}
-.search-item a{display:block;color:var(--accent);font-weight:600}
-.search-snippet{color:var(--muted);font-size:13px;margin-top:4px}
-.search-results mark{background:rgba(92,200,255,0.2);color:var(--text);border-radius:4px;padding:0 2px}
-.prose h1{font-size:24px;margin:0 0 12px}
-.prose h2{font-size:18px;margin:18px 0 8px}
-.prose h3{font-size:16px;margin:14px 0 6px}
-.prose p{margin:0 0 10px}
-.prose ul,.prose ol{margin:0 0 10px 18px}
-.prose li{margin:4px 0}
-.prose code{background:#0d1520;border:1px solid var(--border);padding:1px 5px;border-radius:6px;font-family:ui-monospace,SFMono-Regular,Menlo,Consolas,'Liberation Mono','Courier New',monospace;font-size:12px}
-.prose pre{background:#0d1520;border:1px solid var(--border);padding:12px;border-radius:12px;overflow:auto}
-.prose a{color:var(--accent)}
-.prose img{max-width:100%;height:auto;}
-.prose table{border-collapse:collapse;width:100%;margin:16px 0;background:var(--panel);border:1px solid var(--border);border-radius:8px;overflow:hidden}
-.prose th,.prose td{padding:8px 12px;text-align:left;border-bottom:1px solid var(--border)}
-.prose th{background:var(--chip);color:var(--text);font-weight:600;font-size:13px}
-.prose tr:last-child td{border-bottom:none}
-.prose tbody tr:hover{background:rgba(92,200,255,0.05)}
-.license{
-  background:var(--panel);border:1px solid var(--border);border-radius:14px;
-  padding:16px 16px 8px;margin:0 0 18px;
-}
-.license > h2{margin:0 0 10px;font-size:16px;font-weight:700}
-.pkg{
-  border-top:1px solid var(--border);padding:10px 0;
-  display:grid;grid-template-columns:1fr auto;gap:10px;align-items:center;
-}
-.pkg:first-of-type{border-top:none}
-.pkg .meta{display:flex;gap:10px;flex-wrap:wrap}
-.pkg .name{font-weight:600}
-.pkg .desc{color:var(--muted);margin-top:2px}
-a{color:var(--accent);text-decoration:none} a:hover{text-decoration:underline}
-.chip{background:var(--chip);border:1px solid var(--border);border-radius:999px;padding:2px 8px;font-size:12px;color:var(--muted)}
-.footer{margin-top:26px;color:var(--muted);font-size:12px}
-</style>
-</head>
-<body>
-<main>
-  <nav class="doc-nav">
-    <div class="doc-nav-links">
-      <a href="index.html">Help Home</a><span>&middot;</span><a href="/help/table-of-contents.html">Table of Contents</a><span>&middot;</span><a href="https://github.com/mmiscool/BREP" target="_blank" rel="noopener noreferrer">GitHub</a>
-    </div>
-    <div class="nav-search">
-      <div class="search-input-row">
-        <input type="search" id="doc-search" class="search-input" placeholder="Search docs... Type at least 2 characters to search" autocomplete="off" spellcheck="false" />
-        <button type="button" class="search-clear" id="doc-search-clear">Clear</button>
-      </div>
-      <div class="search-status" id="doc-search-status"></div>
-      <div class="search-results" id="doc-search-results" hidden>
-        <ul id="doc-search-list"></ul>
-      </div>
-    </div>
-  </nav>
-  <section class="card doc-card">
-    <div class="prose">
-<h1>BREP Kernel Reference</h1><p>This page catalogs the core classes and helpers that make up the BREP kernel (everything under <code>src/BREP</code>). Use it alongside <code>docs/solid-methods.md</code> for <code>Solid</code> details and <code>docs/brep-api.md</code> for the export map.</p><h2>Core types</h2><ul><li><strong>Solid / Face / Edge / Vertex</strong> – Geometry + selection primitives (<code>Solid</code> API in <code>docs/solid-methods.md</code>).</li><li><strong>AssemblyComponent</strong> – Groups one or more solids for the assembly constraint solver. Options: <code>{ name=&#39;Component&#39;, fixed=false }</code>.</li></ul><h2>Primitives (<code>src/BREP/primitives.js</code>)</h2><p>All extend <code>Solid</code> and immediately generate geometry.</p><ul><li><code>Cube({ x=1, y=1, z=1, name })</code></li><li><code>Pyramid({ bL=1, s=4, h=1, name })</code> (<code>s</code> is side count ≥ 3)</li><li><code>Sphere({ r=1, resolution=24, name })</code></li><li><code>Cylinder({ radius=1, height=1, resolution=32, name })</code></li><li><code>Cone({ r1=0.5, r2=1, h=1, resolution=32, name })</code></li><li><code>Torus({ mR=2, tR=0.5, resolution=48, arcDegrees=360, name })</code></li></ul><h2>Feature solids</h2><p>- <strong>ExtrudeSolid</strong> – <code>{ face, distance=1 | dir:Vector3, distanceBack=0, name=&#39;Extrude&#39; }</code>.</p><ul><li><strong>Sweep</strong> – <code>{ face, sweepPathEdges=[], distance=1, distanceBack=0, mode=&#39;translate&#39;, name=&#39;Sweep&#39;, omitBaseCap=false }</code>.</li><li><strong>Revolve</strong> – <code>{ face, axis, angle=360, resolution=64, name=&#39;Revolve&#39; }</code>.</li><li><strong>TubeSolid (Tube)</strong> – <code>{ points=[], radius=1, innerRadius=0, resolution=32, closed=false, name=&#39;Tube&#39; }</code>.</li></ul><p>- <strong>ChamferSolid</strong> – <code>{ edgeToChamfer, distance=1, sampleCount=50, snapSeamToEdge=true, sideStripSubdiv=8, seamInsetScale=1e-3, direction=&#39;INSET&#39;|&#39;OUTSET&#39;, inflate=0, flipSide=false, debug=false, debugStride=12 }</code>.</p><ul><li><strong>OffsetShellSolid.generate(sourceSolid, distance, { newSolidName, featureId=&#39;OffsetShell&#39; })</strong> – Static helper to build offset shells.</li></ul><h2>Fillet utilities (<code>src/BREP/fillets/fillet.js</code>)</h2><p>- <code>filletSolid({ edgeToFillet, radius, sideMode=&#39;INSET&#39;|&#39;OUTSET&#39;, inflate=0.1, resolution=32, showTangentOverlays=false, debug=false, name=&#39;fillet&#39; })</code> – Builds wedge/tube helpers and returns <code>{ finalSolid, tube, wedge }</code>; overlays add tangency polylines to the tube for debugging/PMI tagging.</p><ul><li><code>computeFilletCenterline(edgeObj, radius, sideMode)</code> – Returns centerline/tangents/edge polylines plus a <code>closedLoop</code> flag.</li><li><code>attachFilletCenterlineAuxEdge(solid, edgeObj, radius, sideMode=&#39;INSET&#39;, name=&#39;FILLET_CENTERLINE&#39;, options)</code> – Adds centerline as an aux edge; <code>options</code> mirrors <code>Solid.addAuxEdge</code>.</li></ul><h2>Boolean helper</h2><p>- <code>applyBooleanOperation(partHistory, baseSolid, booleanParam, featureID)</code> – Runs <code>UNION|INTERSECT|SUBTRACT</code> between <code>baseSolid</code> and <code>booleanParam.targets</code> (objects or names). Returns <code>{ added, removed }</code>. Subtract semantics invert: each target subtracts the new base.</p><h2>Conversion and repair</h2><ul><li><strong>MeshToBrep</strong> – <code>new MeshToBrep(geometryOrMesh, faceDeflectionAngle=30, weldTolerance=1e-5)</code> groups triangles into faces based on normal deflection and welds shared vertices.</li><li><strong>MeshRepairer</strong> – Per-geometry repair pipeline:</li><p>- <code>weldVertices(geometry, epsilon=1e-4)</code> - <code>fixTJunctions(geometry, lineEps=5e-4, gridCell=0.01)</code> - <code>removeOverlappingTriangles(geometry, posEps=1e-6)</code> - <code>fillHoles(geometry)</code> - <code>fixTriangleNormals(geometry)</code> - <code>repairAll(geometry, { weldEps=5e-4, lineEps=5e-4, gridCell=0.01 })</code></p><li><strong>Point cloud wrapper</strong> – <code>buildTightPointCloudWrap(rawPoints, { padding=0.02*diag, alphaRadius=0.6*medianKNN })</code> builds a solid via marching cubes over a density field.</li></ul><h2>Misc helpers</h2><ul><li><strong>MeshToBrep</strong>, <strong>MeshRepairer</strong>, <strong>applyBooleanOperation</strong>, <strong>PointCloudWrap</strong> live in <code>src/BREP</code> and are re-exported via <code>BREP.js</code> (<code>docs/brep-api.md</code>).</li><li><strong>SolidMethod docs</strong> – <code>docs/solid-methods.md</code> covers all core operations (authoring, cleanup, booleans, export).</li></ul><h2>Example: boolean with primitives</h2><p><pre><code>js
-import { BREP } from &#39;../src/BREP/BREP.js&#39;;
-const box = new BREP.Cube({ x: 20, y: 10, z: 10, name: &#39;Box&#39; });
-const hole = new BREP.Cylinder({ radius: 3, height: 10, name: &#39;Hole&#39; });
-hole.position.set(10, 5, 0);
-hole.bakeTransform(hole.matrixWorld);
-const result = box.subtract(hole);
-result.name = &#39;BoxWithHole&#39;;
-result.visualize();</code></pre></p>
-    </div>
-  </section>
-</main>
-<script>
-(() => {
-  const searchInput = document.getElementById("doc-search");
-  const resultsBox = document.getElementById("doc-search-results");
-  const resultsList = document.getElementById("doc-search-list");
-  const statusEl = document.getElementById("doc-search-status");
-  const clearBtn = document.getElementById("doc-search-clear");
-  if (!searchInput || !resultsBox || !resultsList || !statusEl || !clearBtn) return;
-  const indexUrl = "./search-index.json";
-  let indexPromise = null;
-  let cachedEntries = null;
-  const escapeHtml = (text = "") =>
-    text
-      .replace(/&/g, "&amp;")
-      .replace(/</g, "&lt;")
-      .replace(/>/g, "&gt;");
-  const escapeRegExp = (text = "") => text.replace(/[.*+?^{}()|[]\$]/g, "\$&");
-  const highlight = (text, terms) => {
-    if (!terms.length) return escapeHtml(text);
-    const pattern = terms.map(escapeRegExp).join("|");
-    const regex = new RegExp(`(${pattern})`, "gi");
-    return escapeHtml(text).replace(regex, "<mark>$1</mark>");
-  };
-  const buildSnippet = (entry, terms) => {
-    const source = entry.content || entry.summary || "";
-    if (!source) return { plain: "", highlighted: "" };
-    let hit = source.length;
-    for (const term of terms) {
-      const idx = entry.contentLower.indexOf(term);
-      if (idx !== -1 && idx < hit) hit = idx;
-    }
-    if (!Number.isFinite(hit) || hit === source.length) hit = 0;
-    const start = Math.max(0, hit - 60);
-    const end = Math.min(source.length, hit + 140);
-    const snippet = source.slice(start, end);
-    return { plain: snippet, highlighted: highlight(snippet, terms) };
-  };
-  const updateStatus = (message) => {
-    statusEl.textContent = message;
-  };
-  const loadIndex = async () => {
-    if (cachedEntries) return cachedEntries;
-    if (!indexPromise) {
-      indexPromise = fetch(indexUrl, { cache: "no-store" })
-        .then((res) => {
-          if (!res.ok) throw new Error("Failed to load search index");
-          return res.json();
-        })
-        .then((json) => {
-          cachedEntries = Array.isArray(json)
-            ? json.map((entry) => ({
-                ...entry,
-                contentLower: (entry.content || "").toLowerCase(),
-                titleLower: (entry.title || "").toLowerCase(),
-              }))
-            : [];
-          return cachedEntries;
-        })
-        .catch((err) => {
-          console.error("Search index load failed", err);
-          cachedEntries = [];
-          throw err;
-        });
-    }
-    return indexPromise;
-  };
-  const renderResults = (entries, terms) => {
-    if (!terms.length) {
-      resultsBox.hidden = true;
-      return;
-    }
-    if (!entries.length) {
-      resultsList.innerHTML = '<li class="search-item"><div class="search-snippet">No matches found.</div></li>';
-      resultsBox.hidden = false;
-      return;
-    }
-    const rendered = entries
-      .slice(0, 30)
-      .map((entry) => {
-        const snippet = buildSnippet(entry, terms);
-        const title = highlight(entry.title || entry.href, terms);
-        const hasFragment = snippet.plain && snippet.plain.trim().length > 0;
-        const fragment = hasFragment ? `#:~:text=${encodeURIComponent(snippet.plain.trim())}` : "";
-        const hrefWithFragment = hasFragment
-          ? (entry.href.includes("#") ? `${entry.href}&:~:text=${encodeURIComponent(snippet.plain.trim())}` : `${entry.href}${fragment}`)
-          : entry.href;
-        const snippetHtml = snippet.highlighted ? `<div class="search-snippet">${snippet.highlighted}</div>` : "";
-        return `<li class="search-item"><a href="${hrefWithFragment}">${title}</a>${snippetHtml}</li>`;
-      })
-      .join("");
-    resultsList.innerHTML = rendered;
-    resultsBox.hidden = false;
-  };
-  const performSearch = async () => {
-    const rawQuery = searchInput.value.trim();
-    if (rawQuery.length < 2) {
-      updateStatus("Type at least 2 characters to search.");
-      resultsBox.hidden = true;
-      return;
-    }
-    const terms = rawQuery.toLowerCase().split(/\s+/).filter(Boolean);
-    updateStatus("Searching...");
-    try {
-      const entries = await loadIndex();
-      const matches = entries.filter((entry) =>
-        terms.every((term) => entry.contentLower.includes(term) || entry.titleLower.includes(term))
-      );
-      renderResults(matches, terms);
-      updateStatus(matches.length ? `${matches.length} result${matches.length === 1 ? "" : "s"} for "${rawQuery}"` : "No matches found.");
-    } catch (err) {
-      updateStatus("Search unavailable (could not load index).");
-    }
-  };
-  searchInput.addEventListener("input", performSearch);
-  searchInput.addEventListener("focus", () => {
-    if (!cachedEntries) {
-      loadIndex().catch(() => updateStatus("Search unavailable (could not load index)."));
-    }
-  });
-  clearBtn.addEventListener("click", () => {
-    searchInput.value = "";
-    resultsBox.hidden = true;
-    updateStatus("Type at least 2 characters to search.");
-    searchInput.focus();
-  });
-  document.addEventListener("keydown", (evt) => {
-    if (evt.key === "Escape" && document.activeElement === searchInput) {
-      searchInput.value = "";
-      resultsBox.hidden = true;
-      updateStatus("Type at least 2 characters to search.");
-    }
-  });
-})();
-</script>
-</body>
-</html>

package/dist-kernel/help/brep-model.html DELETED Viewed

@@ -1,248 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
-<head>
-<meta charset="utf-8" />
-<meta name="viewport" content="width=device-width,initial-scale=1" />
-<title>BREP Model and Classes - BREP</title>
-<style>
-:root{
-  --bg:#0b0f14; --panel:#0f141b; --text:#d7dde6; --muted:#9aa7b2;
-  --border:#1b2430; --accent:#5cc8ff; --chip:#121823;
-}
-*{box-sizing:border-box}
-html,body{margin:0;background:var(--bg);color:var(--text);font:14px/1.5 ui-monospace,SFMono-Regular,Menlo,Consolas,'Liberation Mono','Courier New',monospace}
-main{max-width:1100px;margin:0 auto;padding:28px}
-h1{margin:0 0 18px;font-size:22px;color:var(--accent);font-weight:700}
-.summary{color:var(--muted);margin-bottom:22px}
-.card{background:var(--panel);border:1px solid var(--border);border-radius:14px;padding:18px;margin:0 0 18px}
-.readme{padding:0}
-.readme .header{padding:16px 18px;border-bottom:1px solid var(--border)}
-.readme .content{padding:18px}
-.doc-card{padding:18px}
-.doc-nav{margin:0 0 18px;display:flex;gap:12px;flex-wrap:wrap;align-items:center;color:var(--muted)}
-.doc-nav-links{display:flex;gap:12px;flex-wrap:wrap;align-items:center}
-.doc-nav a{color:var(--accent);font-weight:600}
-.doc-list{list-style:none;margin:18px 0;padding:0}
-.doc-list li{margin:6px 0}
-.doc-list a{color:var(--accent)}
-.nav-search{margin-left:auto;position:relative;display:flex;align-items:center;gap:8px;flex-wrap:wrap;justify-content:flex-end;min-width:240px;max-width:520px}
-.search-title{font-weight:700;font-size:14px;margin-bottom:4px}
-.search-hint{color:var(--muted);font-size:12px;margin:0}
-.search-input-row{display:flex;gap:8px;align-items:center;width:100%}
-.search-input{flex:1;border:1px solid var(--border);border-radius:10px;background:var(--chip);color:var(--text);padding:10px 12px}
-.search-input:focus{outline:1px solid var(--accent);box-shadow:0 0 0 3px rgba(92,200,255,0.15)}
-.search-clear{border:1px solid var(--border);background:var(--panel);color:var(--muted);border-radius:10px;padding:9px 12px;cursor:pointer;font-weight:600}
-.search-clear:hover{border-color:var(--accent);color:var(--accent)}
-.search-status{color:var(--muted);font-size:12px;margin-top:4px;width:100%;text-align:right}
-.search-results{position:absolute;top:100%;right:0;margin-top:10px;border:1px solid var(--border);border-radius:12px;background:var(--panel);max-height:360px;overflow:auto;min-width:320px;max-width:520px;box-shadow:0 12px 30px rgba(0,0,0,0.35);z-index:25}
-.search-results ul{list-style:none;margin:0;padding:0}
-.search-item{padding:10px 12px;border-bottom:1px solid var(--border)}
-.search-item:last-child{border-bottom:none}
-.search-item a{display:block;color:var(--accent);font-weight:600}
-.search-snippet{color:var(--muted);font-size:13px;margin-top:4px}
-.search-results mark{background:rgba(92,200,255,0.2);color:var(--text);border-radius:4px;padding:0 2px}
-.prose h1{font-size:24px;margin:0 0 12px}
-.prose h2{font-size:18px;margin:18px 0 8px}
-.prose h3{font-size:16px;margin:14px 0 6px}
-.prose p{margin:0 0 10px}
-.prose ul,.prose ol{margin:0 0 10px 18px}
-.prose li{margin:4px 0}
-.prose code{background:#0d1520;border:1px solid var(--border);padding:1px 5px;border-radius:6px;font-family:ui-monospace,SFMono-Regular,Menlo,Consolas,'Liberation Mono','Courier New',monospace;font-size:12px}
-.prose pre{background:#0d1520;border:1px solid var(--border);padding:12px;border-radius:12px;overflow:auto}
-.prose a{color:var(--accent)}
-.prose img{max-width:100%;height:auto;}
-.prose table{border-collapse:collapse;width:100%;margin:16px 0;background:var(--panel);border:1px solid var(--border);border-radius:8px;overflow:hidden}
-.prose th,.prose td{padding:8px 12px;text-align:left;border-bottom:1px solid var(--border)}
-.prose th{background:var(--chip);color:var(--text);font-weight:600;font-size:13px}
-.prose tr:last-child td{border-bottom:none}
-.prose tbody tr:hover{background:rgba(92,200,255,0.05)}
-.license{
-  background:var(--panel);border:1px solid var(--border);border-radius:14px;
-  padding:16px 16px 8px;margin:0 0 18px;
-}
-.license > h2{margin:0 0 10px;font-size:16px;font-weight:700}
-.pkg{
-  border-top:1px solid var(--border);padding:10px 0;
-  display:grid;grid-template-columns:1fr auto;gap:10px;align-items:center;
-}
-.pkg:first-of-type{border-top:none}
-.pkg .meta{display:flex;gap:10px;flex-wrap:wrap}
-.pkg .name{font-weight:600}
-.pkg .desc{color:var(--muted);margin-top:2px}
-a{color:var(--accent);text-decoration:none} a:hover{text-decoration:underline}
-.chip{background:var(--chip);border:1px solid var(--border);border-radius:999px;padding:2px 8px;font-size:12px;color:var(--muted)}
-.footer{margin-top:26px;color:var(--muted);font-size:12px}
-</style>
-</head>
-<body>
-<main>
-  <nav class="doc-nav">
-    <div class="doc-nav-links">
-      <a href="index.html">Help Home</a><span>&middot;</span><a href="/help/table-of-contents.html">Table of Contents</a><span>&middot;</span><a href="https://github.com/mmiscool/BREP" target="_blank" rel="noopener noreferrer">GitHub</a>
-    </div>
-    <div class="nav-search">
-      <div class="search-input-row">
-        <input type="search" id="doc-search" class="search-input" placeholder="Search docs... Type at least 2 characters to search" autocomplete="off" spellcheck="false" />
-        <button type="button" class="search-clear" id="doc-search-clear">Clear</button>
-      </div>
-      <div class="search-status" id="doc-search-status"></div>
-      <div class="search-results" id="doc-search-results" hidden>
-        <ul id="doc-search-list"></ul>
-      </div>
-    </div>
-  </nav>
-  <section class="card doc-card">
-    <div class="prose">
-<h1>BREP Model and Classes</h1><h2>Overview</h2><ul><li>BREP combines a triangle mesh with per-triangle face labels. Labels map to globally unique IDs in Manifold so selections survive boolean operations.</li><li>During manifoldization, triangle windings are made consistent, outward orientation is enforced, and an optional weld epsilon deduplicates vertices.</li><li>Visualization builds one mesh per face label and edge polylines for label boundaries, enabling semantic selection in the UI and PMI tooling.</li></ul><h2>Solid</h2><ul><li><code>Solid</code> is a <code>THREE.Group</code> subclass that handles authoring, CSG, queries, and export.</li><li>Geometry storage uses <code>_vertProperties</code> (flat positions), <code>_triVerts</code> (triangle indices), and <code>_triIDs</code> (face IDs) plus name-to-ID maps.</li><li>Key methods include <code>addTriangle</code>, <code>setEpsilon</code>, <code>mirrorAcrossPlane</code>, <code>invertNormals</code>, <code>fixTriangleWindingsByAdjacency</code>, <code>removeTinyBoundaryTriangles</code>, <code>getMesh</code>, <code>getFace</code>, <code>getFaces</code>, <code>getFaceNames</code>, <code>getBoundaryEdgePolylines</code>, <code>visualize</code>, <code>union</code>, <code>subtract</code>, <code>intersect</code>, <code>difference</code>, <code>simplify</code>, <code>setTolerance</code>, <code>volume</code>, <code>surfaceArea</code>, <code>toSTL</code>, and <code>writeSTL</code>.</li><li>Full per-method descriptions and examples live in <code>docs/solid-methods.md</code>.</li></ul><h2>Face</h2><ul><li><code>Face</code> is a <code>THREE.Mesh</code> representing all triangles that share a label.</li><li>Provides <code>getAverageNormal()</code> and <code>surfaceArea()</code> helpers for inspection and downstream logic.</li></ul><h2>Edge</h2><ul><li><code>Edge</code> instances represent boundary polylines between two face labels and expose metadata describing the adjacent faces.</li><li>Use edges for PMI dimension snapping, measurement, and preview visualization.</li></ul><p>Additional implementation details can be explored in <code>src/BREP/BetterSolid.js</code> and related helpers.</p>
-    </div>
-  </section>
-</main>
-<script>
-(() => {
-  const searchInput = document.getElementById("doc-search");
-  const resultsBox = document.getElementById("doc-search-results");
-  const resultsList = document.getElementById("doc-search-list");
-  const statusEl = document.getElementById("doc-search-status");
-  const clearBtn = document.getElementById("doc-search-clear");
-  if (!searchInput || !resultsBox || !resultsList || !statusEl || !clearBtn) return;
-  const indexUrl = "./search-index.json";
-  let indexPromise = null;
-  let cachedEntries = null;
-  const escapeHtml = (text = "") =>
-    text
-      .replace(/&/g, "&amp;")
-      .replace(/</g, "&lt;")
-      .replace(/>/g, "&gt;");
-  const escapeRegExp = (text = "") => text.replace(/[.*+?^{}()|[]\$]/g, "\$&");
-  const highlight = (text, terms) => {
-    if (!terms.length) return escapeHtml(text);
-    const pattern = terms.map(escapeRegExp).join("|");
-    const regex = new RegExp(`(${pattern})`, "gi");
-    return escapeHtml(text).replace(regex, "<mark>$1</mark>");
-  };
-  const buildSnippet = (entry, terms) => {
-    const source = entry.content || entry.summary || "";
-    if (!source) return { plain: "", highlighted: "" };
-    let hit = source.length;
-    for (const term of terms) {
-      const idx = entry.contentLower.indexOf(term);
-      if (idx !== -1 && idx < hit) hit = idx;
-    }
-    if (!Number.isFinite(hit) || hit === source.length) hit = 0;
-    const start = Math.max(0, hit - 60);
-    const end = Math.min(source.length, hit + 140);
-    const snippet = source.slice(start, end);
-    return { plain: snippet, highlighted: highlight(snippet, terms) };
-  };
-  const updateStatus = (message) => {
-    statusEl.textContent = message;
-  };
-  const loadIndex = async () => {
-    if (cachedEntries) return cachedEntries;
-    if (!indexPromise) {
-      indexPromise = fetch(indexUrl, { cache: "no-store" })
-        .then((res) => {
-          if (!res.ok) throw new Error("Failed to load search index");
-          return res.json();
-        })
-        .then((json) => {
-          cachedEntries = Array.isArray(json)
-            ? json.map((entry) => ({
-                ...entry,
-                contentLower: (entry.content || "").toLowerCase(),
-                titleLower: (entry.title || "").toLowerCase(),
-              }))
-            : [];
-          return cachedEntries;
-        })
-        .catch((err) => {
-          console.error("Search index load failed", err);
-          cachedEntries = [];
-          throw err;
-        });
-    }
-    return indexPromise;
-  };
-  const renderResults = (entries, terms) => {
-    if (!terms.length) {
-      resultsBox.hidden = true;
-      return;
-    }
-    if (!entries.length) {
-      resultsList.innerHTML = '<li class="search-item"><div class="search-snippet">No matches found.</div></li>';
-      resultsBox.hidden = false;
-      return;
-    }
-    const rendered = entries
-      .slice(0, 30)
-      .map((entry) => {
-        const snippet = buildSnippet(entry, terms);
-        const title = highlight(entry.title || entry.href, terms);
-        const hasFragment = snippet.plain && snippet.plain.trim().length > 0;
-        const fragment = hasFragment ? `#:~:text=${encodeURIComponent(snippet.plain.trim())}` : "";
-        const hrefWithFragment = hasFragment
-          ? (entry.href.includes("#") ? `${entry.href}&:~:text=${encodeURIComponent(snippet.plain.trim())}` : `${entry.href}${fragment}`)
-          : entry.href;
-        const snippetHtml = snippet.highlighted ? `<div class="search-snippet">${snippet.highlighted}</div>` : "";
-        return `<li class="search-item"><a href="${hrefWithFragment}">${title}</a>${snippetHtml}</li>`;
-      })
-      .join("");
-    resultsList.innerHTML = rendered;
-    resultsBox.hidden = false;
-  };
-  const performSearch = async () => {
-    const rawQuery = searchInput.value.trim();
-    if (rawQuery.length < 2) {
-      updateStatus("Type at least 2 characters to search.");
-      resultsBox.hidden = true;
-      return;
-    }
-    const terms = rawQuery.toLowerCase().split(/\s+/).filter(Boolean);
-    updateStatus("Searching...");
-    try {
-      const entries = await loadIndex();
-      const matches = entries.filter((entry) =>
-        terms.every((term) => entry.contentLower.includes(term) || entry.titleLower.includes(term))
-      );
-      renderResults(matches, terms);
-      updateStatus(matches.length ? `${matches.length} result${matches.length === 1 ? "" : "s"} for "${rawQuery}"` : "No matches found.");
-    } catch (err) {
-      updateStatus("Search unavailable (could not load index).");
-    }
-  };
-  searchInput.addEventListener("input", performSearch);
-  searchInput.addEventListener("focus", () => {
-    if (!cachedEntries) {
-      loadIndex().catch(() => updateStatus("Search unavailable (could not load index)."));
-    }
-  });
-  clearBtn.addEventListener("click", () => {
-    searchInput.value = "";
-    resultsBox.hidden = true;
-    updateStatus("Type at least 2 characters to search.");
-    searchInput.focus();
-  });
-  document.addEventListener("keydown", (evt) => {
-    if (evt.key === "Escape" && document.activeElement === searchInput) {
-      searchInput.value = "";
-      resultsBox.hidden = true;
-      updateStatus("Type at least 2 characters to search.");
-    }
-  });
-})();
-</script>
-</body>
-</html>