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

brep-io-kernel 1.0.0 → 1.0.12

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/features__sheet-metal-tab.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>Sheet Metal Tab - 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>Sheet Metal Tab</h1><p>Status: Implemented</p><p><img src="features__Sheet_Metal_Tab_dialog.png" alt="Sheet Metal Tab feature dialog" width="280" loading="lazy" /></p><p>The Sheet Metal Tab feature creates a base flange by extruding a closed sketch (or face) by a specified thickness. Besides generating geometry via the robust sweep implementation, it records the sheet thickness so downstream flange/cutout tools can reuse the value.</p><h2>Inputs</h2><ul><li><code>profile</code> – Closed sketch or face defining the tab footprint. If a sketch is selected it will be removed from the scene once the tab body is generated.</li><li><code>thickness</code> – Sheet metal thickness. The feature uses this value for both the physical extrusion distance and the stored sheet metadata.</li><li><code>placementMode</code> – Determines how the thickness is applied relative to the sketch plane: forward, reverse, or midplane (symmetric).</li><li><code>bendRadius</code> – Captured default bend radius for the part. The geometry ignores this value (tabs are planar) but downstream flange/cutout features reuse it.</li><li><code>consumeProfileSketch</code> – Checkbox to remove the driving sketch after the tab is created. Disable to leave the sketch visible for edits or reuse.</li><li><code>boolean.operation</code> / <code>boolean.targets</code> – Optional union/subtract/intersect with existing solids.</li></ul><h2>Behaviour</h2><ul><li>Tabs reuse the <code>BREP.Sweep</code> translator to form solids and automatically remove consumed sketches unless <code>consumeProfileSketch</code> is turned off.</li><li>Every resulting solid receives <code>userData.sheetMetal</code> metadata (<code>baseType: TAB</code>, <code>thickness</code>, <code>bendRadius</code>, <code>consumeProfileSketch</code>, etc.) plus mirrored entries in the <code>MetadataManager</code>.</li><li>Thickness must be greater than zero; negative inputs flip the placement automatically unless an explicit mode is chosen.</li></ul>
-    </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/features__sketch.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>Sketch - 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>Sketch</h1><p>Status: Implemented</p><p><img src="features__Sketch_dialog.png" alt="Sketch feature dialog" width="280" loading="lazy" /></p><p><img src="SKETCH.png" alt="Sketch Mode" loading="lazy" /></p><p>Sketch stores 2D geometry in feature-persistent data and visualises it on a selected plane or face. The sketch mode opens a 2D sketcher environment where you can draft profiles that become the basis for Extrude, Revolve, Loft, or Sweep features.</p><h2>Overview</h2><p>Sketch Mode opens the 2D sketcher on a selected plane or face. Geometry is constrained within a local coordinate system, letting you dimension lines, arcs, and splines precisely. When you finish, the sketch remains parametric and updates downstream features as you edit it later.</p><h2>Workflow</h2><ol><li>Choose a plane or datum, then activate Sketch Mode from the feature history</li><li>Draw with line, rectangle, circle, arc, spline, and text tools</li><li>Apply constraints and dimensions to lock intent before returning to Modeling Mode</li><li>Refine profiles with Trim, construction toggles, and spline edits</li><li>Use the sketch as input for other features like Extrude, Revolve, Sweep, or Loft</li></ol><h2>Tool Icons</h2><p>Sketch Mode uses Unicode icon buttons for quick tool switching. The top toolbar includes:</p><table><thead><tr><th>Icon</th><th>Tool</th><th>What it does</th></tr></thead><tbody><tr><td>👆</td><td>Select</td><td>Select and edit sketch points, curves, and constraints.</td></tr><tr><td>✂</td><td>Trim</td><td>Trim a curve at the nearest intersection(s) around the click.</td></tr><tr><td>⌖</td><td>Point</td><td>Create a point on the sketch plane.</td></tr><tr><td>/</td><td>Line</td><td>Create a line between two points.</td></tr><tr><td>☐</td><td>Rectangle</td><td>Create a rectangle from two corner points.</td></tr><tr><td>◯</td><td>Circle</td><td>Create a circle from center → radius point.</td></tr><tr><td>◠</td><td>Arc</td><td>Create an arc from center → start → end.</td></tr><tr><td>∿</td><td>Bezier</td><td>Create a cubic Bezier (end0 → ctrl0 → ctrl1 → end1).</td></tr><tr><td>🔗</td><td>Link external edge</td><td>Project edge endpoints into the sketch as fixed points.</td></tr><tr><td>↶</td><td>Undo</td><td>Undo the last sketch operation.</td></tr><tr><td>↷</td><td>Redo</td><td>Redo the last undone sketch operation.</td></tr></tbody></table><h2>Inputs</h2><ul><li><code>sketchPlane</code> – face or datum plane that defines the sketch basis. The plane orientation updates automatically when the reference moves.</li><li><code>Edit Sketch</code> – opens the in-app sketcher (<code>viewer.startSketchMode</code>) so you can add points, curves, and constraints.</li><li><code>curveResolution</code> – tessellation setting used when generating circular geometry for downstream features.</li></ul><h2>Behaviour</h2><ul><li>The feature builds a local coordinate frame from the selected plane, saves it in persistent data, and reuses it on every regenerate so the sketch tracks its reference.</li><li>Sketch geometry is kept as JSON, solved through the <code>ConstraintEngine</code>, and rendered as a <code>SKETCH</code> group containing faces and edges that other features (Extrude, Revolve, Sweep) can consume.</li><li>External references are projected into sketch space at regenerate time and expression-backed dimensions are evaluated before solving.</li></ul><h2>Constraints</h2><p>Sketch constraints show up as glyphs that use Unicode icons so you can tell them apart at a glance. The solver supports the following set:</p><table><thead><tr><th>Symbol</th><th>Constraint</th><th>What it does</th></tr></thead><tbody><tr><td>⏚</td><td>Ground</td><td>Locks a point in place. Used for the origin and any projected references so they cannot be dragged.</td></tr><tr><td>━</td><td>Horizontal</td><td>Forces two selected points to share the same <code>y</code> value.</td></tr><tr><td>│</td><td>Vertical</td><td>Forces two selected points to share the same <code>x</code> value.</td></tr><tr><td>≡</td><td>Coincident</td><td>Merges two points so they occupy the same coordinates; downstream coincident groups stay merged.</td></tr><tr><td>⟺</td><td>Distance</td><td>Adds a numeric dimension. On lines it fixes the segment length, on arcs/circles it becomes a radius or diameter dimension.</td></tr><tr><td>⇌</td><td>Equal Distance</td><td>Makes two segments (or two radii) match length. Works for line pairs or circular features that need equal radii.</td></tr><tr><td>∥</td><td>Parallel</td><td>Keeps two lines travelling in the same direction, reusing existing horizontal/vertical locks when possible.</td></tr><tr><td>⟂</td><td>Perpendicular / Tangent</td><td>For line pairs it enforces a 90° angle. When applied between a line and a circle/arc it constrains the line to stay tangent by keeping the radius perpendicular at the contact point.</td></tr><tr><td>∠</td><td>Angle</td><td>Stores an explicit angle between two segments. The initial value is captured from the current sketch state.</td></tr><tr><td>⏛</td><td>Point on Line</td><td>Projects a point onto the line defined by the first two selections, useful for keeping construction points collinear.</td></tr><tr><td>⋯</td><td>Midpoint</td><td>Centers the third point midway between the first two and retains equal distances as you edit the sketch.</td></tr></tbody></table><p>Grouped constraints that touch the same points share a single anchor and render their glyphs side by side so complex regions stay legible.</p><h2>Context Toolbar</h2><p>A floating context toolbar follows the sketch viewport and updates itself based on the active selection. It offers only the constraints and actions that apply to the selected entities, making it quick to add intent without digging through menus.</p><ul><li><strong>Adaptive constraints</strong> – Select two line segments and the toolbar lights up <code>Parallel ∥</code>, <code>Perpendicular ⟂</code>, <code>Angle ∠</code>, and <code>Equal Distance ⇌</code>. Pick a line and an arc and it switches to the tangent option. Single, double, or triple point selections surface the matching point-based constraints (<code>H ━</code>, <code>V │</code>, <code>Coincident ≡</code>, <code>Distance ⟺</code>, <code>Colinear ⏛</code>, etc.).</li><li><strong>Radial dimensions</strong> – Selecting a single circle or arc reveals <code>Radius</code> and <code>Diameter</code> dimension buttons so you can drop the right measurement without changing tools.</li><li><strong>Construction toggle</strong> – Any time geometry is highlighted the toolbar shows a toggle that flips the selection between regular sketch curves and construction geometry. Construction curves remain in the sketch for constraints but are ignored when profiles are consumed by downstream features.</li><li><strong>Fix / Unfix</strong> – When one or more points are selected the toolbar offers a fast fix toggle, adding or removing <code>⏚</code> constraints without opening the constraint picker.</li><li><strong>Cleanup &amp; delete</strong> – The toolbar always offers a cleanup button (🧹) to remove orphan points, and shows delete actions when a selection is active.</li></ul><h3>Context Action Icons</h3><table><thead><tr><th>Icon</th><th>Action</th><th>Notes</th></tr></thead><tbody><tr><td>◐</td><td>Construction toggle</td><td>Switch selected curves between construction and regular geometry.</td></tr><tr><td>🧹</td><td>Cleanup</td><td>Remove orphan points that are unused by geometry and lightly constrained.</td></tr><tr><td>🗑</td><td>Delete</td><td>Remove the current selection.</td></tr><tr><td>R</td><td>Radius</td><td>Create a radius dimension on an arc/circle.</td></tr><tr><td>⌀</td><td>Diameter</td><td>Create a diameter dimension on an arc/circle.</td></tr></tbody></table><h2>Trim Tool</h2><p>Trim removes the clicked segment of a curve using the closest intersection(s) around the cursor.</p><ul><li><strong>Activation</strong> – Choose the ✂ Trim tool from the top toolbar, then click the curve segment you want to remove.</li><li><strong>Supported geometry</strong> – Lines, arcs, circles, and Bezier splines can be trimmed.</li><li><strong>Local splitting</strong> – Trim only splits at the nearest intersection(s) around the click, not at every intersection along the curve.</li><li><strong>Closed curves</strong> – Circles (and full arcs) keep the segment opposite the clicked section.</li><li><strong>Degenerate cases</strong> – If a curve lies on top of another curve or an endpoint already sits on another curve and no valid trim bounds exist, Trim removes the curve entirely.</li><li><strong>Constraint preservation</strong> – When trimming against a line, the new trim point is constrained colinear to the cutting line (or coincident if it lands on the cutting line endpoint). For arcs/circles, trim points receive an equal‑distance constraint from the center to preserve the radius. Splines currently trim without adding constraints.</li></ul><h2>Spline (Bezier) Editing</h2><p>The sketcher includes direct Bezier editing with construction‑line helpers.</p><ul><li><strong>Creation</strong> – The ∿ tool creates a cubic Bezier using four points: end0 → ctrl0 → ctrl1 → end1.</li><li><strong>Construction guides</strong> – After creation, construction lines connect each endpoint to its adjacent handle so you can constrain handles with regular sketch constraints.</li><li><strong>Insert point</strong> – With the Bezier tool active, clicking near an existing Bezier inserts a new anchor at the closest location. The curve is split using de Casteljau so its shape is preserved, and new handle points plus construction guides are added.</li></ul><h2>Visual Feedback</h2><ul><li><strong>Under‑constrained points</strong> – Points that are not fixed and are not referenced by any non‑temporary constraint are rendered in orange to flag areas that still need intent.</li></ul><h2>Solver Settings</h2><p>The sketch sidebar exposes solver settings for iteration count, tolerance, and decimal precision. It also includes:</p><ul><li><strong>Auto‑remove orphan points (default on)</strong> – After delete and trim operations, the sketcher removes points that are not used by any geometry and either have no constraints or only a single coincident/point‑on‑line constraint. This is the same logic used by the 🧹 cleanup action in the context toolbar.</li></ul><h2>Linking External Geometry</h2><p>Sketch Mode can link to edges that live outside the current sketch so profiles stay tied to upstream solids:</p><ol><li>Switch to the sketch and pick <code>Link external edge</code> on the top toolbar.</li><li>Click scene edges or face boundaries; each pick projects both endpoints into sketch UV space and adds them as fixed points.</li><li>The viewer lists every linked edge; selecting a row reselects its projected points, and <code>Unlink</code> removes the pair and their auto-created ground constraints.</li></ol><p>The sketch feature stores external links as <code>externalRefs</code> in persistent data. On every regenerate it looks up the referenced edge by id or name, reprojects the endpoints into the sketch plane, and reapplies <code>⏚</code> constraints so the references remain locked. If the source geometry moves, the sketch updates automatically, keeping downstream features live without requiring you to redraw or manually re-reference the outline.</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>