opengeometry 2.0.5 → 2.0.7

package/README.md

@@ -7,7 +7,7 @@
 <h1 align="center">OpenGeometry</h1>
 
 <p align="center">
-  <strong>CAD kernel for the web — built with Rust, WebAssembly, and Three.js.</strong>
+  <strong>Browser-native CAD kernel built with Rust, WebAssembly, and Three.js.</strong>
 </p>
 
 <p align="center">
@@ -30,11 +30,11 @@
 
 ## What is OpenGeometry?
 
-OpenGeometry is an **open-source CAD kernel** purpose-built for the browser. The geometry engine is written in **Rust**, compiled to **WebAssembly**, and ships with a **Three.js integration layer** — so you can build real CAD tools that run entirely on the web.
+OpenGeometry is an **open-source, browser-native CAD kernel**. The geometry engine is written in **Rust**, compiled to **WebAssembly**, and paired with a **Three.js-friendly TypeScript layer** so you can build real CAD tools that run in the browser.
 
-OpenGeometry is best suited for **browser-based CAD, AEC/BIM, configurators, and geometry-heavy web tools**. Whether you're building a parametric modeler, a wall/opening workflow, a BIM viewer, or a custom Three.js modeling tool, OpenGeometry gives you kernel-backed primitives and operations without leaving JavaScript.
+OpenGeometry is best suited for **browser-based CAD, AEC/BIM, configurators, and geometry-heavy web tools**. Whether you're building a parametric modeler, a wall/opening workflow, a BIM viewer, or a custom Three.js modeling tool, OpenGeometry gives you deterministic, kernel-backed primitives and operations without leaving JavaScript.
 
-OpenPlans is an application/toolkit built on top of OpenGeometry for AEC workflows. In this repository, OpenGeometry is the engine.
+It is the geometry engine layer, not a full CAD application. OpenPlans is a downstream application/toolkit built on top of OpenGeometry for AEC workflows. In this repository, OpenGeometry is the primary SDK and engine.
 
 ## When to use OpenGeometry
 
@@ -45,15 +45,41 @@ Use OpenGeometry when you need:
 - polygon extrusion into solids for CAD or AEC modeling
 - IFC, STEP, STL, and PDF-style export/projection in web apps
 - a Three.js-friendly CAD kernel instead of ad hoc mesh math
+- a deterministic geometry engine behind AI-assisted CAD or design workflows
+
+## Why it works well for AI-powered CAD apps
+
+OpenGeometry is a good fit for **AI-assisted CAD apps** because the kernel layer stays explicit and deterministic. An AI copilot or agent can suggest modeling steps, generate profiles, or orchestrate edits, while OpenGeometry executes the actual geometry operations, booleans, projections, and exports in a predictable browser runtime.
+
+Good examples include:
+
+- AI copilots that translate user intent into concrete modeling operations
+- prompt-to-geometry or agent-driven editing flows inside browser CAD tools
+- AI-assisted design interfaces that still need reliable extrusion, boolean, projection, and export workflows
+
+## Good fit / Not the right fit
+
+**Good fit**
+
+- browser CAD, AEC/BIM, and geometry-heavy web applications
+- Three.js-based modeling tools that need a real kernel behind them
+- AI-assisted CAD frontends that need deterministic geometry execution in the browser
+
+**Not the default fit**
+
+- desktop-native CAD products instead of an embeddable web SDK
+- non-browser runtimes with no WebAssembly or browser delivery story
+- pure visualization-only apps where raw Three.js is enough and kernel-backed modeling is unnecessary
 
 ## AI and Coding Agent Entrypoints
 
 If you are using ChatGPT, Claude, Gemini, Copilot, or other coding agents on this repository, start here:
 
-- [llms.txt](./llms.txt)
-- [llms-full.txt](./llms-full.txt)
-- [llm.txt](./llm.txt)
-- [AGENTS.md](./AGENTS.md)
+- [README.md](./README.md) - product overview, positioning, and quick start
+- [llms.txt](./llms.txt) - concise repo and API guide for coding agents
+- [llms-full.txt](./llms-full.txt) - expanded agent guide with workflows and examples
+- [llm.txt](./llm.txt) - redirect for tools that look for a single LLM entrypoint
+- [AGENTS.md](./AGENTS.md) - repository workflow rules and validation expectations
 - [Quickstart](https://docs.opengeometry.io/quickstart)
 - [Three.js integration](https://docs.opengeometry.io/integration/threejs)
 - [Boolean operations](https://docs.opengeometry.io/api/operations/boolean-operations)
@@ -85,6 +111,8 @@ Install from npm:
 npm install opengeometry
 ```
 
+A practical browser deployment looks like this: install `opengeometry` from npm, serve `opengeometry_bg.wasm` from your app, then initialize the runtime once with `OpenGeometry.create({ wasmURL })` before creating `Vector3` values or kernel-backed wrappers.
+
 ```ts
 import { Cuboid, OpenGeometry, Vector3 } from "opengeometry";
 
@@ -187,7 +215,10 @@ OpenGeometry is open source under the [MPL-2.0 license](./LICENSE.md). Contribut
 - Repository-level AI agent instructions are in [AGENTS.md](./AGENTS.md).
 - LLM-friendly repo entrypoints are [llms.txt](./llms.txt), [llms-full.txt](./llms-full.txt), and
   [llm.txt](./llm.txt).
-- All AI-generated documentation must live under [`AI-DOCs/`](./AI-DOCs/).
+- In the current workflow, [`AI-DOCs/`](./AI-DOCs/) is used for AI-generated handoffs, runbooks,
+  testing notes, and temporary implementation context.
+- The maintained user-facing docs live in [`docs/`](./docs/), and stable architecture/domain notes
+  are tracked in [`knowledge/`](./knowledge/).
 - AI-generated docs should not be added under app/code folders unless explicitly requested.
 
 ---

package/index.js

@@ -138,6 +138,11 @@ function passStringToWasm0(arg, malloc, realloc) {
   WASM_VECTOR_LEN = offset;
   return ptr;
 }
+function _assertClass(instance, klass) {
+  if (!(instance instanceof klass)) {
+    throw new Error(`expected instance of ${klass.name}`);
+  }
+}
 function takeFromExternrefTable0(idx) {
   const value = wasm.__wbindgen_export_2.get(idx);
   wasm.__externref_table_dealloc(idx);
@@ -154,9 +159,30 @@ function getArrayF64FromWasm0(ptr, len) {
   ptr = ptr >>> 0;
   return getFloat64ArrayMemory0().subarray(ptr / 8, ptr / 8 + len);
 }
-function _assertClass(instance, klass) {
-  if (!(instance instanceof klass)) {
-    throw new Error(`expected instance of ${klass.name}`);
+/**
+ * @param {string} local_brep_serialized
+ * @param {number} height
+ * @returns {string}
+ */
+function extrudeBrepFace$1(local_brep_serialized, height) {
+  let deferred3_0;
+  let deferred3_1;
+  try {
+    const ptr0 = passStringToWasm0(local_brep_serialized, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+    const len0 = WASM_VECTOR_LEN;
+    const ret = wasm.extrudeBrepFace(ptr0, len0, height);
+    var ptr2 = ret[0];
+    var len2 = ret[1];
+    if (ret[3]) {
+      ptr2 = 0;
+      len2 = 0;
+      throw takeFromExternrefTable0(ret[2]);
+    }
+    deferred3_0 = ptr2;
+    deferred3_1 = len2;
+    return getStringFromWasm0(ptr2, len2);
+  } finally {
+    wasm.__wbindgen_free(deferred3_0, deferred3_1, 1);
   }
 }
 let cachedDataViewMemory0 = null;
@@ -175,16 +201,6 @@ function passArrayJsValueToWasm0(array, malloc) {
   WASM_VECTOR_LEN = array.length;
   return ptr;
 }
-function getArrayJsValueFromWasm0(ptr, len) {
-  ptr = ptr >>> 0;
-  const mem = getDataViewMemory0();
-  const result = [];
-  for (let i = ptr; i < ptr + 4 * len; i += 4) {
-    result.push(wasm.__wbindgen_export_2.get(mem.getUint32(i, true)));
-  }
-  wasm.__externref_drop_slice(ptr, len);
-  return result;
-}
 function isLikeNone(x) {
   return x === undefined || x === null;
 }
@@ -271,32 +287,15 @@ function booleanSubtractionMany(lhs_brep_serialized, cutters_brep_serialized, op
   }
   return OGBooleanResult.__wrap(ret[0]);
 }
-
-/**
- * @param {string} local_brep_serialized
- * @param {number} height
- * @returns {string}
- */
-function extrudeBrepFace$1(local_brep_serialized, height) {
-  let deferred3_0;
-  let deferred3_1;
-  try {
-    const ptr0 = passStringToWasm0(local_brep_serialized, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
-    const len0 = WASM_VECTOR_LEN;
-    const ret = wasm.extrudeBrepFace(ptr0, len0, height);
-    var ptr2 = ret[0];
-    var len2 = ret[1];
-    if (ret[3]) {
-      ptr2 = 0;
-      len2 = 0;
-      throw takeFromExternrefTable0(ret[2]);
-    }
-    deferred3_0 = ptr2;
-    deferred3_1 = len2;
-    return getStringFromWasm0(ptr2, len2);
-  } finally {
-    wasm.__wbindgen_free(deferred3_0, deferred3_1, 1);
+function getArrayJsValueFromWasm0(ptr, len) {
+  ptr = ptr >>> 0;
+  const mem = getDataViewMemory0();
+  const result = [];
+  for (let i = ptr; i < ptr + 4 * len; i += 4) {
+    result.push(wasm.__wbindgen_export_2.get(mem.getUint32(i, true)));
   }
+  wasm.__externref_drop_slice(ptr, len);
+  return result;
 }
 const Matrix3Finalization = typeof FinalizationRegistry === 'undefined' ? {
   register: () => {},
@@ -4997,7 +4996,7 @@ class OGSweep {
    * @returns {Vector3}
    */
   get_anchor() {
-    const ret = wasm.ogsweep_get_anchor(this.__wbg_ptr);
+    const ret = wasm.ogarc_get_anchor(this.__wbg_ptr);
     return Vector3.__wrap(ret);
   }
   /**
@@ -7859,10 +7858,9 @@ class Solid extends THREE.Mesh {
         var _a;
         const bufferData = this.solid.getGeometryBuffer();
         this.writePositionsToGeometry(this.geometry, bufferData);
+        let material;
         if (this.material instanceof THREE.MeshStandardMaterial) {
-            this.material.color.set(this.options.color);
-            this.material.transparent = true;
-            this.material.opacity = 0.6;
+            material = this.material;
         }
         else {
             if (Array.isArray(this.material)) {
@@ -7871,12 +7869,21 @@ class Solid extends THREE.Mesh {
             else {
                 this.material.dispose();
             }
-            this.material = new THREE.MeshStandardMaterial({
+            material = new THREE.MeshStandardMaterial({
                 color: this.options.color,
-                transparent: true,
-                opacity: 0.6,
+                transparent: false,
+                opacity: 1,
+                depthWrite: true,
+                side: THREE.FrontSide,
             });
-        }
+            this.material = material;
+        }
+        material.color.set(this.options.color);
+        material.transparent = false;
+        material.opacity = 1;
+        material.depthWrite = true;
+        material.side = THREE.FrontSide;
+        material.needsUpdate = true;
         if (bufferData.length > 0) {
             this.geometry.computeVertexNormals();
             this.geometry.computeBoundingBox();
@@ -8487,8 +8494,8 @@ class Cylinder extends THREE.Mesh {
         this.writePositionsToGeometry(this.geometry, bufferData);
         if (this.material instanceof THREE.MeshStandardMaterial) {
             this.material.color.set(this.options.color);
-            this.material.transparent = true;
-            this.material.opacity = 0.6;
+            // this.material.transparent = true;
+            // this.material.opacity = 0.6;
         }
         else {
             if (Array.isArray(this.material)) {
@@ -8499,8 +8506,8 @@ class Cylinder extends THREE.Mesh {
             }
             this.material = new THREE.MeshStandardMaterial({
                 color: this.options.color,
-                transparent: true,
-                opacity: 0.6,
+                // transparent: true,
+                // opacity: 0.6,
             });
         }
         this.geometry.computeVertexNormals();
@@ -8698,8 +8705,8 @@ class Cuboid extends THREE.Mesh {
         this.writePositionsToGeometry(this.geometry, geometryData);
         if (this.material instanceof THREE.MeshStandardMaterial) {
             this.material.color.set(this.options.color);
-            this.material.transparent = true;
-            this.material.opacity = 0.6;
+            // this.material.transparent = true;
+            // this.material.opacity = 0.6;
         }
         else {
             if (Array.isArray(this.material)) {
@@ -8710,8 +8717,8 @@ class Cuboid extends THREE.Mesh {
             }
             this.material = new THREE.MeshStandardMaterial({
                 color: this.options.color,
-                transparent: true,
-                opacity: 0.6,
+                // transparent: true,
+                // opacity: 0.6,
             });
         }
         this.geometry.computeVertexNormals();
@@ -9311,8 +9318,8 @@ class Sphere extends THREE.Mesh {
         this.writePositionsToGeometry(this.geometry, bufferData);
         if (this.material instanceof THREE.MeshStandardMaterial) {
             this.material.color.set(this.options.color);
-            this.material.transparent = true;
-            this.material.opacity = 0.6;
+            // this.material.transparent = true;
+            // this.material.opacity = 0.6;
         }
         else {
             if (Array.isArray(this.material)) {
@@ -9323,8 +9330,8 @@ class Sphere extends THREE.Mesh {
             }
             this.material = new THREE.MeshStandardMaterial({
                 color: this.options.color,
-                transparent: true,
-                opacity: 0.6,
+                // transparent: true,
+                // opacity: 0.6,
             });
         }
         this.geometry.computeVertexNormals();
@@ -9579,8 +9586,8 @@ class Wedge extends THREE.Mesh {
         this.writePositionsToGeometry(this.geometry, bufferData);
         if (this.material instanceof THREE.MeshStandardMaterial) {
             this.material.color.set(this.options.color);
-            this.material.transparent = true;
-            this.material.opacity = 0.6;
+            // this.material.transparent = true;
+            // this.material.opacity = 0.6;
         }
         else {
             if (Array.isArray(this.material)) {
@@ -9591,8 +9598,8 @@ class Wedge extends THREE.Mesh {
             }
             this.material = new THREE.MeshStandardMaterial({
                 color: this.options.color,
-                transparent: true,
-                opacity: 0.6,
+                // transparent: true,
+                // opacity: 0.6,
             });
         }
         this.geometry.computeVertexNormals();
@@ -9878,8 +9885,8 @@ class Sweep extends THREE.Mesh {
         this.writePositionsToGeometry(this.geometry, bufferData);
         if (this.material instanceof THREE.MeshStandardMaterial) {
             this.material.color.set(this.options.color);
-            this.material.transparent = true;
-            this.material.opacity = 0.6;
+            // this.material.transparent = true;
+            // this.material.opacity = 0.6;
         }
         else {
             if (Array.isArray(this.material)) {
@@ -9890,8 +9897,8 @@ class Sweep extends THREE.Mesh {
             }
             this.material = new THREE.MeshStandardMaterial({
                 color: this.options.color,
-                transparent: true,
-                opacity: 0.6,
+                // transparent: true,
+                // opacity: 0.6,
             });
         }
         this.geometry.computeVertexNormals();