@meshinspector/meshlib-mt 3.1.3-429 → 3.1.4-297

package/README.md

@@ -20,14 +20,21 @@ npm install @meshinspector/meshlib-mt
 
 ## Use from CDN
 
-In the browser you can skip npm entirely and import the module directly:
+In the browser you can load the module from the CDN instead of npm, but the browser refuses to run a worker
+script from another origin, so pass the fetched module to the factory as a `Blob` and its worker pool starts
+from a same-origin `blob:` URL:
 
 ```js
-// latest version
-import createMeshLib from 'https://js.meshlib.io/meshlib-mt/meshlib-mt.mjs';
+// latest release
+const url = 'https://js.meshlib.io/meshlib-mt/meshlib-mt.mjs';
 
-// or pin a specific version
-import createMeshLib from 'https://js.meshlib.io/meshlib-mt@1.2.3/meshlib-mt.mjs';
+// or pin a release
+// const url = 'https://js.meshlib.io/meshlib-mt@v1.2.3.456/meshlib-mt.mjs';
+
+const { default: createMeshLib } = await import( url );
+const blob = new Blob( [ await ( await fetch( url ) ).text() ], { type: 'text/javascript' } );
+
+const ml = await createMeshLib( { mainScriptUrlOrBlob: blob } );
 ```
 
 ## Browser requirements: cross-origin isolation
@@ -65,6 +72,9 @@ export default {
 The default export is an async factory. Await it once to get the module instance, then call
 MeshLib functions on it:
 
+> `using` requires Node.js 24+ or a current browser. On older runtimes, call `.delete()`
+> instead — see [Memory management](#memory-management).
+
 ```js
 import createMeshLib from '@meshinspector/meshlib-mt';
 
@@ -88,37 +98,44 @@ console.log('volume =', mesh.volume()); // ~8
 // `using` frees these WebAssembly-backed objects automatically at the end of scope
 ```
 
-> `using` requires Node.js 24+ or a current browser. On older runtimes, call `.delete()`
-> instead — see [Memory management](#memory-management).
-
 ## Using with bundlers
 
-Bundlers (Vite, webpack, Rollup) hash and relocate the sidecar `meshlib-mt.wasm`, so the module
-can't locate it on its own. Import the wasm as an asset URL and hand it to the loader via
-`locateFile`:
+Vite 8 and webpack 5 resolve `meshlib-mt.wasm` from the module and emit it as an asset, so a plain `import`
+needs no configuration. For other bundlers, such as esbuild or Rollup, import the wasm as an asset URL
+and hand it to the loader via `locateFile`:
 
 ```js
 import createMeshLib from '@meshinspector/meshlib-mt';
-import wasmUrl from '@meshinspector/meshlib-mt/meshlib-mt.wasm?url';
+import wasmUrl from '@meshinspector/meshlib-mt/meshlib-mt.wasm';
 
 const ml = await createMeshLib( { locateFile: () => wasmUrl } );
 ```
 
+The bundler must treat `.wasm` files as static assets, so that the import resolves to the URL of the
+emitted file; the option is usually called an asset or file loader. For example:
+
+- **esbuild**: pass `--loader:.wasm=file`
+- **Rollup**: add `@rollup/plugin-url` with `include: /\.wasm$/`
+- **Parcel**: use the `url:` scheme on the import specifier: `import wasmUrl from 'url:@meshinspector/meshlib-mt/meshlib-mt.wasm';`
+
 The page must also be [cross-origin isolated](#browser-requirements-cross-origin-isolation).
 
 ## TypeScript
 
 The package ships type definitions, so `createMeshLib` and the whole module API are typed with
-no extra setup:
+minimal setup:
 
 ```ts
 import createMeshLib, { type Mesh } from '@meshinspector/meshlib-mt';
 
 const ml = await createMeshLib();
-using mesh: Mesh = ml.Mesh.fromTriangles(coords, tris);
+const mesh: Mesh = ml.Mesh.fromTriangles(coords, tris)!;
 const { valid, distSq } = ml.findProjection(point, mesh);
+mesh.delete();
 ```
 
+Also make sure to add `"type": "module"` to your package.json.
+
 ## Memory management
 
 Values returned from the API (meshes, bit sets, settings, result objects, …) hold

package/bindings.d.mts

@@ -1245,7 +1245,7 @@ export interface OffsetParameters extends BaseShellParameters {
    */
   memoryEfficient: boolean;
   /**
-   * @brief determines the method to compute distance sign
+   * determines the method to compute distance sign; offsetMesh implementing OffsetMode::Smooth supports only Unsigned, OpenVDB and HoleWindingRule here
    */
   signDetectionMode: SignDetectionMode;
 }
@@ -1705,7 +1705,7 @@ interface EmbindModule {
      */
     fromTriangles(vertexCoordinates: VertCoords, t: Triangulation): Mesh | null;
     /**
-     * construct mesh from vertex coordinates and a set of triangles with given ids; unlike simple fromTriangles() it tries to resolve non-manifold vertices by creating duplicate vertices
+     * construct mesh from vertex coordinates and a set of triangles with given ids; unlike simple fromTriangles() it tries to resolve non-manifold vertices by creating duplicate vertices; `betterCont` (if given) selects the best triangle among several possible continuations during the duplication
      */
     fromTrianglesDuplicatingNonManifoldVertices(vertexCoordinates: VertCoords, t: Triangulation): Mesh | null;
   };
@@ -2270,7 +2270,7 @@ interface EmbindModule {
    */
   getBoundaryVerts(topology: MeshTopology, region: FaceBitSet): VertBitSet;
   /**
-   * returns closed loop of region boundary starting from given region boundary edge (region faces on the right, and not-region faces or holes on the left); if more than two boundary edges connect in one vertex, then the function makes the most abrupt turn to left
+   * @brief same as above, but writes the loop in `outLoop` (cleared first), so a caller tracking many loops one by one reuses its capacity
    */
   trackRightBoundaryLoop(topology: MeshTopology, e0: number): Uint32Array;
   /**

package/index.d.mts

@@ -18,9 +18,9 @@ export * from './bindings.mjs';
 /** Options for the module factory (the Emscripten `Module` object). All optional. */
 export interface CreateMeshLibOptions {
   /**
-   * Resolve the URL of a runtime file — most importantly the sidecar `.wasm`. Bundlers should
-   * pass this pointing at a `?url` import of the wasm; see "Using with Vite / bundlers" in the
-   * README.
+   * Resolve the URL of a runtime file — most importantly the sidecar `.wasm`. Bundlers that do
+   * not emit the wasm on their own should pass this pointing at an asset-URL import of the wasm;
+   * see "Using with bundlers" in the README.
    */
   locateFile?: ( path: string, scriptDirectory: string ) => string;
   /** Multi-threaded build only: URL or Blob of the main script, so pthread workers can load it. */

package/meshlib-mt.mjs

@@ -150,7 +150,7 @@ c.Wb.count.value+=1;c.Wb.Rc=!1;return c},["delete"](){this.Wb.$b||qf(this);if(th
 const b=Symbol.dispose;b&&(a[b]=a["delete"])})();
 Object.assign(Mf.prototype,{Ud(a){this.Jd&&(a=this.Jd(a));return a},zd(a){this.yc?.(a)},tc:hf,ec:function(a){function b(){return this.dd?Lf(this.ac.Hc,{fc:this.ie,$b:c,rc:this,lc:a}):Lf(this.ac.Hc,{fc:this,$b:a})}var c=this.Ud(a);if(!c)return this.zd(a),null;var d=Kf(this.ac,c);if(void 0!==d){if(0===d.Wb.count.value)return d.Wb.$b=c,d.Wb.lc=a,d.clone();d=d.clone();this.zd(a);return d}d=this.ac.Td(c);d=xf[d];if(!d)return b.call(this);d=this.cd?d.Pd:d.pointerType;var e=If(c,this.ac,d.ac);return null===
 e?b.call(this):this.dd?Lf(d.ac.Hc,{fc:d,$b:e,rc:this,lc:a}):Lf(d.ac.Hc,{fc:d,$b:e})}});n||(k.wasmMemory?pa=k.wasmMemory:pa=new WebAssembly.Memory({initial:(k.INITIAL_MEMORY||16777216)/65536,maximum:65536,shared:!0}),qa());k.noExitRuntime&&(Id=k.noExitRuntime);k.print&&(ja=k.print);k.printErr&&(p=k.printErr);k.wasmBinary&&(ka=k.wasmBinary);k.thisProgram&&(da=k.thisProgram);if(k.preInit)for("function"==typeof k.preInit&&(k.preInit=[k.preInit]);0<k.preInit.length;)k.preInit.shift()();
-var og=[Hd,Jd,Yd,gb,hb,ib,jb,kb,lb,mb,nb,ob,pb,qb,rb,sb,tb,ub,vb,wb,xb,Bc,Cc,Ec,Fc,Gc,Hc,Ic],ng={2077132:a=>{throw Error(U(a));}},dd,Ba,ed,fd,gd,ya,Ea,hd,jd,kd,ld,H,md,nd,I,od,J,pd,qd,rd,sd,td,Ya;function Kc(a,b){var c=J();try{return L(a)(b)}catch(d){I(c);if(d!==d+0)throw d;H(1,0)}}function Xc(a,b,c,d){var e=J();try{L(a)(b,c,d)}catch(f){I(e);if(f!==f+0)throw f;H(1,0)}}function Oc(a,b,c,d,e){var f=J();try{return L(a)(b,c,d,e)}catch(g){I(f);if(g!==g+0)throw g;H(1,0)}}
+var og=[Hd,Jd,Yd,gb,hb,ib,jb,kb,lb,mb,nb,ob,pb,qb,rb,sb,tb,ub,vb,wb,xb,Bc,Cc,Ec,Fc,Gc,Hc,Ic],ng={2085260:a=>{throw Error(U(a));}},dd,Ba,ed,fd,gd,ya,Ea,hd,jd,kd,ld,H,md,nd,I,od,J,pd,qd,rd,sd,td,Ya;function Kc(a,b){var c=J();try{return L(a)(b)}catch(d){I(c);if(d!==d+0)throw d;H(1,0)}}function Xc(a,b,c,d){var e=J();try{L(a)(b,c,d)}catch(f){I(e);if(f!==f+0)throw f;H(1,0)}}function Oc(a,b,c,d,e){var f=J();try{return L(a)(b,c,d,e)}catch(g){I(f);if(g!==g+0)throw g;H(1,0)}}
 function Pc(a,b,c,d,e,f){var g=J();try{return L(a)(b,c,d,e,f)}catch(h){I(g);if(h!==h+0)throw h;H(1,0)}}function Vc(a,b){var c=J();try{L(a)(b)}catch(d){I(c);if(d!==d+0)throw d;H(1,0)}}function Wc(a,b,c){var d=J();try{L(a)(b,c)}catch(e){I(d);if(e!==e+0)throw e;H(1,0)}}function Nc(a,b,c,d){var e=J();try{return L(a)(b,c,d)}catch(f){I(e);if(f!==f+0)throw f;H(1,0)}}function Mc(a,b,c){var d=J();try{return L(a)(b,c)}catch(e){I(d);if(e!==e+0)throw e;H(1,0)}}
 function Uc(a){var b=J();try{L(a)()}catch(c){I(b);if(c!==c+0)throw c;H(1,0)}}function Lc(a,b,c){var d=J();try{return L(a)(b,c)}catch(e){I(d);if(e!==e+0)throw e;H(1,0)}}function Zc(a,b,c,d,e,f){var g=J();try{L(a)(b,c,d,e,f)}catch(h){I(g);if(h!==h+0)throw h;H(1,0)}}function Yc(a,b,c,d,e){var f=J();try{L(a)(b,c,d,e)}catch(g){I(f);if(g!==g+0)throw g;H(1,0)}}function Rc(a,b,c,d,e,f,g,h,m,l,q){var t=J();try{return L(a)(b,c,d,e,f,g,h,m,l,q)}catch(r){I(t);if(r!==r+0)throw r;H(1,0)}}
 function Jc(a){var b=J();try{return L(a)()}catch(c){I(b);if(c!==c+0)throw c;H(1,0)}}function $c(a,b,c,d,e,f,g){var h=J();try{L(a)(b,c,d,e,f,g)}catch(m){I(h);if(m!==m+0)throw m;H(1,0)}}function Qc(a,b,c,d,e,f,g,h){var m=J();try{return L(a)(b,c,d,e,f,g,h)}catch(l){I(m);if(l!==l+0)throw l;H(1,0)}}function Sc(a,b){var c=J();try{return L(a)(b)}catch(d){I(c);if(d!==d+0)throw d;H(1,0)}}function Tc(a,b,c,d,e,f){var g=J();try{return L(a)(b,c,d,e,f)}catch(h){I(g);if(h!==h+0)throw h;H(1,0)}}

package/meshlib-mt.node.mjs

@@ -184,7 +184,7 @@ c.Xb.count.value+=1;c.Xb.Zc=!1;return c},["delete"](){this.Xb.ac||vf(this);if(th
 const b=Symbol.dispose;b&&(a[b]=a["delete"])})();
 Object.assign(Rf.prototype,{ve(a){this.ae&&(a=this.ae(a));return a},Pd(a){this.Dc?.(a)},zc:mf,dc:function(a){function b(){return this.ld?Qf(this.bc.Lc,{hc:this.Ie,ac:c,tc:this,qc:a}):Qf(this.bc.Lc,{hc:this,ac:a})}var c=this.ve(a);if(!c)return this.Pd(a),null;var d=Pf(this.bc,c);if(void 0!==d){if(0===d.Xb.count.value)return d.Xb.ac=c,d.Xb.qc=a,d.clone();d=d.clone();this.Pd(a);return d}d=this.bc.te(c);d=Cf[d];if(!d)return b.call(this);d=this.kd?d.le:d.pointerType;var e=Nf(c,this.bc,d.bc);return null===
 e?b.call(this):this.ld?Qf(d.bc.Lc,{hc:d,ac:e,tc:this,qc:a}):Qf(d.bc.Lc,{hc:d,ac:e})}});q||(g.wasmMemory?ua=g.wasmMemory:ua=new WebAssembly.Memory({initial:(g.INITIAL_MEMORY||16777216)/65536,maximum:65536,shared:!0}),va());g.noExitRuntime&&(Ld=g.noExitRuntime);g.preloadPlugins&&(He=g.preloadPlugins);g.print&&(pa=g.print);g.printErr&&(u=g.printErr);g.wasmBinary&&(qa=g.wasmBinary);g.thisProgram&&(da=g.thisProgram);if(g.preInit)for("function"==typeof g.preInit&&(g.preInit=[g.preInit]);0<g.preInit.length;)g.preInit.shift()();
-var sg=[Kd,Md,$d,hb,ib,jb,kb,lb,mb,nb,ob,pb,qb,rb,sb,tb,ub,vb,wb,xb,yb,Cc,Dc,Fc,Gc,Hc,Ic,Jc],rg={2077132:a=>{throw Error(U(a));}},ed,Ha,fd,gd,hd,Ea,Ka,jd,kd,ld,md,H,nd,od,I,pd,J,qd,rd,sd,td,ud,Za;function Lc(a,b){var c=J();try{return L(a)(b)}catch(d){I(c);if(d!==d+0)throw d;H(1,0)}}function Yc(a,b,c,d){var e=J();try{L(a)(b,c,d)}catch(f){I(e);if(f!==f+0)throw f;H(1,0)}}function Pc(a,b,c,d,e){var f=J();try{return L(a)(b,c,d,e)}catch(h){I(f);if(h!==h+0)throw h;H(1,0)}}
+var sg=[Kd,Md,$d,hb,ib,jb,kb,lb,mb,nb,ob,pb,qb,rb,sb,tb,ub,vb,wb,xb,yb,Cc,Dc,Fc,Gc,Hc,Ic,Jc],rg={2085260:a=>{throw Error(U(a));}},ed,Ha,fd,gd,hd,Ea,Ka,jd,kd,ld,md,H,nd,od,I,pd,J,qd,rd,sd,td,ud,Za;function Lc(a,b){var c=J();try{return L(a)(b)}catch(d){I(c);if(d!==d+0)throw d;H(1,0)}}function Yc(a,b,c,d){var e=J();try{L(a)(b,c,d)}catch(f){I(e);if(f!==f+0)throw f;H(1,0)}}function Pc(a,b,c,d,e){var f=J();try{return L(a)(b,c,d,e)}catch(h){I(f);if(h!==h+0)throw h;H(1,0)}}
 function Qc(a,b,c,d,e,f){var h=J();try{return L(a)(b,c,d,e,f)}catch(k){I(h);if(k!==k+0)throw k;H(1,0)}}function Wc(a,b){var c=J();try{L(a)(b)}catch(d){I(c);if(d!==d+0)throw d;H(1,0)}}function Xc(a,b,c){var d=J();try{L(a)(b,c)}catch(e){I(d);if(e!==e+0)throw e;H(1,0)}}function Oc(a,b,c,d){var e=J();try{return L(a)(b,c,d)}catch(f){I(e);if(f!==f+0)throw f;H(1,0)}}function Nc(a,b,c){var d=J();try{return L(a)(b,c)}catch(e){I(d);if(e!==e+0)throw e;H(1,0)}}
 function Vc(a){var b=J();try{L(a)()}catch(c){I(b);if(c!==c+0)throw c;H(1,0)}}function Mc(a,b,c){var d=J();try{return L(a)(b,c)}catch(e){I(d);if(e!==e+0)throw e;H(1,0)}}function $c(a,b,c,d,e,f){var h=J();try{L(a)(b,c,d,e,f)}catch(k){I(h);if(k!==k+0)throw k;H(1,0)}}function Zc(a,b,c,d,e){var f=J();try{L(a)(b,c,d,e)}catch(h){I(f);if(h!==h+0)throw h;H(1,0)}}function Sc(a,b,c,d,e,f,h,k,n,m,p){var r=J();try{return L(a)(b,c,d,e,f,h,k,n,m,p)}catch(t){I(r);if(t!==t+0)throw t;H(1,0)}}
 function Kc(a){var b=J();try{return L(a)()}catch(c){I(b);if(c!==c+0)throw c;H(1,0)}}function ad(a,b,c,d,e,f,h){var k=J();try{L(a)(b,c,d,e,f,h)}catch(n){I(k);if(n!==n+0)throw n;H(1,0)}}function Rc(a,b,c,d,e,f,h,k){var n=J();try{return L(a)(b,c,d,e,f,h,k)}catch(m){I(n);if(m!==m+0)throw m;H(1,0)}}function Tc(a,b){var c=J();try{return L(a)(b)}catch(d){I(c);if(d!==d+0)throw d;H(1,0)}}function Uc(a,b,c,d,e,f){var h=J();try{return L(a)(b,c,d,e,f)}catch(k){I(h);if(k!==k+0)throw k;H(1,0)}}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@meshinspector/meshlib-mt",
-  "version": "3.1.3-429",
+  "version": "3.1.4-297",
   "description": "MeshLib geometry library compiled to WebAssembly (multi-threaded).",
   "type": "module",
   "main": "./meshlib-mt.mjs",