polystrata-3d 0.0.0-stage → 0.1.0

package/dist/types.d.ts

@@ -0,0 +1,106 @@
+/**
+ * Standard 2-body Boolean operation selector.
+ */
+export type BooleanOp = "union" | "intersect" | "difference" | "xor";
+/**
+ * Winding rule used to classify inside/outside of a 3D solid from its signed 3D solid-angle winding number:
+ * - `"positive"`: `w >= 1` (standard CAD/B-Rep convention where outward shell = +1, interior void = -1)
+ * - `"nonZero"`: `w !== 0`
+ * - `"evenOdd"`: `|w| % 2 === 1`
+ */
+export type WindingRule = "positive" | "nonZero" | "evenOdd";
+/**
+ * Configuration options for the 3D Stratified Tolerance Complex kernel.
+ */
+export interface KernelOptions {
+    /**
+     * Explicit base snap tolerance `r0` in world units.
+     * When omitted or `<= 0`, the kernel automatically selects a scale-aware tolerance
+     * (`1e-9 * boundingBoxDiagonal`) and caps vertex tolerance ball growth at `r_max = 4 * r0`.
+     */
+    snapTolerance?: number;
+    /**
+     * Merge collinear degree-2 vertices on output boundary loops (default: `true`).
+     */
+    simplifyCollinear?: boolean;
+    /**
+     * Winding rule used to determine inside/outside for each input solid (default: `"positive"`).
+     */
+    windingRule?: WindingRule;
+}
+/**
+ * A 3D point in IEEE-754 double-precision (`f64`) world coordinates.
+ */
+export interface Point3D {
+    x: number;
+    y: number;
+    z: number;
+}
+/**
+ * A 3-element coordinate tuple `[x, y, z]`.
+ */
+export type TuplePoint3D = readonly [number, number, number];
+/**
+ * A planar 3D polygon face with an outward-oriented outer boundary loop and zero or more interior holes.
+ */
+export interface Face3D {
+    /** Outer boundary loop in CCW order when viewed against `normal`. */
+    outer: Point3D[];
+    /** Optional interior hole loops in CW order when viewed against `normal`. */
+    holes: Point3D[][];
+    /** Outward unit normal vector `(nx, ny, nz)`. */
+    normal: Point3D;
+}
+/**
+ * A 3D planar Boundary-Representation (B-Rep) solid.
+ */
+export interface Solid3D {
+    faces: Face3D[];
+}
+/**
+ * A single 3D surface triangle emitted by ear-clipping a `Face3D`.
+ */
+export interface Triangle3D {
+    a: Point3D;
+    b: Point3D;
+    c: Point3D;
+    normal: Point3D;
+    faceIndex: number;
+}
+/**
+ * Output of a 3D Boolean or topological healing operation.
+ */
+export interface BRepResult3D {
+    /** Closed watertight 3D planar B-Rep solid. */
+    solid: Solid3D;
+    /** Triangulated surface mesh of `solid` for immediate 3D WebGL/Canvas rendering. */
+    triangles: Triangle3D[];
+    /** Signed enclosed volume via the Divergence Theorem (`(1/6) ∑ a · (b × c)`). */
+    totalVolume: number;
+    /** Total boundary surface area. */
+    totalSurfaceArea: number;
+    /** Number of canonical 3D vertices (`0-strata`). */
+    vertexCount: number;
+    /** Number of canonical 3D edges (`1-strata`). */
+    edgeCount: number;
+    /** Number of unmatched directed half-edges (`0` for a closed watertight 2-manifold). */
+    unmatchedHalfEdgeCount: number;
+}
+/**
+ * Lightweight zero-copy TypedArray result returned by `prepareBooleanTask` / `prepareBooleanTask3D`.
+ */
+export interface WasmBRep3DResult {
+    readonly faceCount: number;
+    readonly loopCount: number;
+    readonly triangleCount: number;
+    readonly totalVolume: number;
+    readonly totalSurfaceArea: number;
+    readonly vertexCount: number;
+    readonly edgeCount: number;
+    readonly unmatchedHalfEdgeCount: number;
+    readonly coords: Float64Array;
+    readonly loopMeta: Uint32Array;
+    readonly faceNormals: Float64Array;
+    readonly triangles: Float64Array;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,WAAW,GAAG,YAAY,GAAG,KAAK,CAAC;AAErE;;;;;GAKG;AACH,MAAM,MAAM,WAAW,GAAG,UAAU,GAAG,SAAS,GAAG,SAAS,CAAC;AAE7D;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B;;;;OAIG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;OAEG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B;;OAEG;IACH,WAAW,CAAC,EAAE,WAAW,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,OAAO;IACtB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX;AAED;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;AAE7D;;GAEG;AACH,MAAM,WAAW,MAAM;IACrB,qEAAqE;IACrE,KAAK,EAAE,OAAO,EAAE,CAAC;IACjB,6EAA6E;IAC7E,KAAK,EAAE,OAAO,EAAE,EAAE,CAAC;IACnB,iDAAiD;IACjD,MAAM,EAAE,OAAO,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,OAAO;IACtB,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,CAAC,EAAE,OAAO,CAAC;IACX,CAAC,EAAE,OAAO,CAAC;IACX,CAAC,EAAE,OAAO,CAAC;IACX,MAAM,EAAE,OAAO,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,+CAA+C;IAC/C,KAAK,EAAE,OAAO,CAAC;IACf,oFAAoF;IACpF,SAAS,EAAE,UAAU,EAAE,CAAC;IACxB,iFAAiF;IACjF,WAAW,EAAE,MAAM,CAAC;IACpB,mCAAmC;IACnC,gBAAgB,EAAE,MAAM,CAAC;IACzB,oDAAoD;IACpD,WAAW,EAAE,MAAM,CAAC;IACpB,iDAAiD;IACjD,SAAS,EAAE,MAAM,CAAC;IAClB,wFAAwF;IACxF,sBAAsB,EAAE,MAAM,CAAC;CAChC;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,sBAAsB,EAAE,MAAM,CAAC;IACxC,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC;IAC/B,QAAQ,CAAC,WAAW,EAAE,YAAY,CAAC;IACnC,QAAQ,CAAC,SAAS,EAAE,YAAY,CAAC;CAClC"}

package/dist/wasm-bytes.d.ts

@@ -0,0 +1,2 @@
+export declare const WASM_BASE64: string;
+//# sourceMappingURL=wasm-bytes.d.ts.map

package/dist/wasm-bytes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wasm-bytes.d.ts","sourceRoot":"","sources":["../src/wasm-bytes.ts"],"names":[],"mappings":"AACA,eAAO,MAAM,WAAW,EAAE,MAAmijuB,CAAC"}

package/dist/wasm-kernel.d.ts

@@ -0,0 +1,37 @@
+export interface Polystrata3DWasmExports {
+    memory: WebAssembly.Memory;
+    wasm_brep3d_alloc_input: (f64Count: number) => number;
+    wasm_brep3d_execute: (opCode: number, windingRule: number, snapFactor: number, simplifyCollinear: number) => number;
+    wasm_brep3d_get_out_coords_ptr: () => number;
+    wasm_brep3d_get_out_coords_len: () => number;
+    wasm_brep3d_get_out_loop_meta_ptr: () => number;
+    wasm_brep3d_get_out_loop_count: () => number;
+    wasm_brep3d_get_out_face_normals_ptr: () => number;
+    wasm_brep3d_get_out_face_count: () => number;
+    wasm_brep3d_get_out_triangles_ptr: () => number;
+    wasm_brep3d_get_out_triangles_len: () => number;
+    wasm_brep3d_get_out_volume: () => number;
+    wasm_brep3d_get_out_area: () => number;
+    wasm_brep3d_get_out_vertex_count: () => number;
+    wasm_brep3d_get_out_edge_count: () => number;
+    wasm_brep3d_get_out_unmatched_he_count: () => number;
+}
+/**
+ * Asynchronously initialize the embedded 3D WebAssembly module.
+ *
+ * In Node.js, Bun, Deno, and Web Workers, `polystrata-3d` initializes synchronously on first call
+ * so calling `initPolystrata3D()` is optional. On browser main threads that restrict synchronous
+ * `new WebAssembly.Module()` compilation for modules > 4 KB, call `await initPolystrata3D()` once
+ * at application startup before invoking synchronous 3D Boolean operations.
+ */
+export declare function initPolystrata3D(): Promise<void>;
+/**
+ * Alias for {@link initPolystrata3D}.
+ */
+export declare const initPolystrata: typeof initPolystrata3D;
+/**
+ * Alias for {@link initPolystrata3D}.
+ */
+export declare const initPolystrataWasm: typeof initPolystrata3D;
+export declare function getWasm(): Polystrata3DWasmExports;
+//# sourceMappingURL=wasm-kernel.d.ts.map

package/dist/wasm-kernel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wasm-kernel.d.ts","sourceRoot":"","sources":["../src/wasm-kernel.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE,WAAW,CAAC,MAAM,CAAC;IAC3B,uBAAuB,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,MAAM,CAAC;IACtD,mBAAmB,EAAE,CACnB,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,MAAM,EAClB,iBAAiB,EAAE,MAAM,KACtB,MAAM,CAAC;IACZ,8BAA8B,EAAE,MAAM,MAAM,CAAC;IAC7C,8BAA8B,EAAE,MAAM,MAAM,CAAC;IAC7C,iCAAiC,EAAE,MAAM,MAAM,CAAC;IAChD,8BAA8B,EAAE,MAAM,MAAM,CAAC;IAC7C,oCAAoC,EAAE,MAAM,MAAM,CAAC;IACnD,8BAA8B,EAAE,MAAM,MAAM,CAAC;IAC7C,iCAAiC,EAAE,MAAM,MAAM,CAAC;IAChD,iCAAiC,EAAE,MAAM,MAAM,CAAC;IAChD,0BAA0B,EAAE,MAAM,MAAM,CAAC;IACzC,wBAAwB,EAAE,MAAM,MAAM,CAAC;IACvC,gCAAgC,EAAE,MAAM,MAAM,CAAC;IAC/C,8BAA8B,EAAE,MAAM,MAAM,CAAC;IAC7C,sCAAsC,EAAE,MAAM,MAAM,CAAC;CACtD;AAsBD;;;;;;;GAOG;AACH,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC,CAStD;AAED;;GAEG;AACH,eAAO,MAAM,cAAc,yBAAmB,CAAC;AAE/C;;GAEG;AACH,eAAO,MAAM,kBAAkB,yBAAmB,CAAC;AAEnD,wBAAgB,OAAO,IAAI,uBAAuB,CAcjD"}

package/package.json

@@ -1,6 +1,76 @@
 {
   "name": "polystrata-3d",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.0",
+  "type": "module",
+  "license": "MIT",
+  "description": "High-performance 3D Planar B-Rep Boolean operations, coplanar face unification, and topological healing kernel powered by Rust/WebAssembly",
+  "homepage": "https://polystrata3d.ptrbyr.com",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/pboyer/polystrata-3d.git"
+  },
+  "bugs": {
+    "url": "https://github.com/pboyer/polystrata-3d/issues"
+  },
+  "keywords": [
+    "3d-boolean",
+    "csg",
+    "brep",
+    "mesh-boolean",
+    "boolean-operations",
+    "geometry",
+    "computational-geometry",
+    "cad",
+    "wasm",
+    "3d"
+  ],
+  "sideEffects": false,
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    },
+    "./package.json": "./package.json"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "scripts": {
+    "dev": "vite",
+    "build:wasm": "cargo build --target wasm32-unknown-unknown --release && node -e \"const fs=require('fs');const b=fs.readFileSync('target/wasm32-unknown-unknown/release/polystrata_3d.wasm');fs.writeFileSync('src/wasm-bytes.ts','// Auto-generated from crates/polystrata-3d-wasm\\nexport const WASM_BASE64: string = \\\"'+b.toString('base64')+'\\\";\\n');\"",
+    "build": "vite build --config vite.lib.config.ts && tsc -p tsconfig.build.json && node -e \"require('fs').copyFileSync('dist/index.d.ts','dist/index.d.cts')\"",
+    "build:demo": "vite build",
+    "preview": "vite preview",
+    "bench": "tsx bench/run.ts",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "npm run build && npm test"
+  },
+  "devDependencies": {
+    "@jscad/modeling": "^2.13.0",
+    "@types/node": "^26.6.5",
+    "@types/three": "^0.186.0",
+    "manifold-3d": "^3.5.4",
+    "three": "^0.186.1",
+    "three-bvh-csg": "^0.0.18",
+    "three-mesh-bvh": "^0.9.16",
+    "tsx": "^4.23.15",
+    "typescript": "^5.6.3",
+    "vite": "^5.4.11",
+    "vitest": "^2.1.8"
+  }
+}