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/assembly-constraints__parallel-constraint.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>Parallel Constraint - 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>Parallel Constraint</h1><p>Status: Implemented</p><p><img src="assembly-constraints___Parallel_Constraint_dialog.png" alt="Parallel Constraint dialog" width="280" loading="lazy" /></p><p>Parallel constraints align the directions of two faces, edges, or components. They are the primary orientation tool for planar or cylindrical features that must stay parallel without requiring contact.</p><h2>Inputs</h2><ul><li><code>id</code> – unique identifier surfaced in the UI.</li><li><code>elements</code> – two selections (faces, edges, or components). Each selection must resolve to a direction vector.</li><li><code>applyImmediately</code> – historical flag retained for UI compatibility; the solver always iterates instead of applying a single shot correction.</li><li><code>reverse</code> – toggles the stored orientation preference so the constraint can align outward-facing normals instead of inward-facing normals.</li></ul><h2>Behaviour</h2><ul><li>Resolves both selections using the parallel alignment utilities, which gather a world-space origin, direction, and normal sampling metadata.</li><li>Stores an orientation preference (<code>persistentData.preferredOppose</code>) the first time the constraint runs. Subsequent solves reuse that preference until <code>reverse</code> flips it.</li><li>Delegates the heavy lifting to <code>solveParallelAlignment()</code> in <code>constraintUtils/parallelAlignment.js</code>, which computes the quaternion(s) necessary to make the direction vectors parallel while respecting <code>MAX_ROTATION_PER_ITERATION</code>.</li><li>Fills <code>persistentData.error</code> and <code>persistentData.errorDeg</code> with the angular difference so the UI can display progress down to very small tolerances.</li><li>Emits optional debug arrows when the solver runs in <code>debugMode</code> to visualise the directions currently being enforced.</li></ul><h2>Usage Tips</h2><ul><li>Combine Parallel with Distance or Coincident when you need both orientation and translation control.</li><li>If the constraint keeps flipping between inward and outward normals, toggle the <code>reverse</code> flag to pin the preferred orientation.</li><li>Keep an eye on <code>lastAppliedRotations</code>; sustained non-zero rotations usually indicate other constraints are pulling the components out of alignment between iterations.</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/assembly-constraints__solver.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>Assembly Constraint Solver - 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>Assembly Constraint Solver</h1><p>Status: Implemented</p><p>The assembly constraint solver manages constraint instances attached to an assembly and iteratively applies translations or rotations until every constraint reports that it is satisfied (or until the iteration budget is exhausted). It lives alongside the constraint implementations in <code>src/assemblyConstraints</code> and mirrors the documentation pattern already used for PMI annotations.</p><h2>Key Files</h2><ul><li><code>src/assemblyConstraints/AssemblyConstraintHistory.js</code> – orchestrates constraint storage, scheduling, and the iterative solve loop.</li><li><code>src/assemblyConstraints/AssemblyConstraintRegistry.js</code> – registers built-in constraint classes and resolves aliases.</li><li><code>src/assemblyConstraints/BaseAssemblyConstraint.js</code> – base class that exposes shared helpers and metadata conventions for concrete constraints.</li></ul><h2>Runtime Flow</h2><ul><li>Every constraint entry carries a <code>type</code>, <code>inputParams</code>, and <code>persistentData</code>. Defaults come from the constraint&#39;s <code>inputParamsSchema</code>, and each entry receives an auto-generated <code>id</code> (for example <code>COIN12</code>).</li><li><code>AssemblyConstraintHistory.runAll()</code> is the primary entry point. It validates entries, removes disabled constraints, detects duplicates before instantiating anything, and then constructs one runtime instance per constraint.</li><li>During each iteration the solver calls <code>solve(context)</code> (or <code>run(context)</code> for legacy classes) on every instance. A constraint may mark itself satisfied, request additional adjustments, or block if both components are fixed.</li><li>When a constraint applies a motion it must call <code>context.applyTranslation(component, vector)</code> or <code>context.applyRotation(component, quaternion)</code>, both of which update the component transform and record that the component needs to be synced back to feature data.</li><li>The loop stops early if an iteration makes no changes, if all constraints are satisfied, or if an abort signal supplied through the controller is triggered.</li><li>After the run completes, persistent data (status, message, last applied moves, etc.) is merged back into the stored constraint entries so the UI reflects the latest state.</li></ul><h2>Solver Context</h2><p>Each constraint receives the same runtime context object. The most frequently used fields are:</p><ul><li><code>tolerance</code>, <code>translationGain</code>, and <code>rotationGain</code> – clamped values supplied through solver options to moderate how aggressively each constraint moves parts.</li><li><code>resolveObject(selection)</code> and <code>resolveComponent(selection)</code> – turn serialized selection info back into scene objects or assembly components.</li><li><code>applyTranslation(component, THREE.Vector3)</code> and <code>applyRotation(component, THREE.Quaternion)</code> – helpers that mutate component transforms and keep the solver&#39;s bookkeeping in sync.</li><li><code>isComponentFixed(component)</code> – reports whether a component is already locked by a Fixed constraint or by feature metadata.</li><li><code>renderScene()</code> and <code>viewer</code> – allow constraints or debug hooks to request a redraw between iterations.</li><li><code>debugMode</code> – when true, constraint implementations may emit temporary helpers (for example normal arrows).</li></ul><h2>Hooks, Scheduling, and Debugging</h2><ul><li><code>runAll()</code> accepts an optional controller with an abort <code>signal</code> and <code>hooks</code> object. The solver will attempt to invoke <code>onStart</code>, <code>onIterationStart</code>, <code>onConstraintStart</code>, <code>onConstraintEnd</code>, <code>onConstraintSkipped</code>, <code>onIterationComplete</code>, and <code>onComplete</code> at appropriate times.</li><li>Adding, removing, or editing constraints schedules an automatic background solve via <code>AssemblyConstraintHistory.#scheduleAutoRun()</code>. The auto-run uses the default tolerance, gain, and iteration count unless the caller overrides them.</li><li>Duplicate detection (<code>checkConstraintErrors()</code> and <code>#detectDuplicateConstraints()</code>) ensures identical selections are not solved twice; duplicates inherit a <code>status: &#39;duplicate&#39;</code> result and are skipped during the run.</li><li>Constraint implementations may stash arbitrary data (for example <code>lastAppliedMoves</code>) inside <code>persistentData</code>; the solver copies those fields back onto the stored entry after each run so the UI can display progress.</li></ul><h2>Constraint Catalog</h2><p>Built-in constraints are registered in the registry and documented individually:</p><ul><li><a href="assembly-constraints__angle-constraint.html">Angle Constraint</a></li><li><a href="assembly-constraints__coincident-constraint.html">Coincident Constraint</a></li><li><a href="assembly-constraints__distance-constraint.html">Distance Constraint</a></li><li><a href="assembly-constraints__fixed-constraint.html">Fixed Constraint</a></li><li><a href="assembly-constraints__parallel-constraint.html">Parallel Constraint</a></li><li><a href="assembly-constraints__touch-align-constraint.html">Touch Align Constraint</a></li></ul><h2>Adding Components for Constraints</h2><p>Assembly constraints operate on <code>AssemblyComponent</code> instances, not ad-hoc solids. Add every part to the assembly using the <a href="features__assembly-component.html">Assembly Component</a> feature first; this inserts the 3MF-backed component into the assembly graph, preserves face/body naming for selections, and exposes the transform that constraints manipulate. Solids added by other modeling features won’t participate in the constraint solver until they’re brought in as assembly components.</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>