okgeometry-api 1.5.0 → 1.9.0

package/src/wasm-bindings.d.ts

@@ -12,6 +12,97 @@ export function arc_length(radius: number, start_angle: number, end_angle: numbe
  */
 export function arc_point_at(cx: number, cy: number, cz: number, nx: number, ny: number, nz: number, radius: number, start_angle: number, end_angle: number, t: number): Float64Array;
 
+/**
+ * Parametric BREP boolean: exact surface–surface intersection curves with
+ * trimmed-surface output. Both operands must be closed solids.
+ * op: "union" | "intersect" | "subtract".
+ * Returns the result BREP as JSON, or {"error": "..."} on failure.
+ */
+export function brep_boolean_op(a_json: string, b_json: string, op: string, tolerance: number): string;
+
+/**
+ * All BREP edges as polylines: [num_polylines, n1, x,y,z..., n2, ...].
+ */
+export function brep_edges(json: string, tolerance: number): Float64Array;
+
+/**
+ * Extrude a profile curve into a BREP (closed profile → capped solid,
+ * open profile → sheet). Returns JSON.
+ */
+export function brep_extrude_curve(curve_data: Float64Array, dx: number, dy: number, dz: number, height: number): string;
+
+/**
+ * Iso-parametric curve of a NURBS face's backing surface (untrimmed).
+ * Returns curve data, or empty for planar faces.
+ */
+export function brep_face_iso_curve(json: string, face_index: number, t: number, u_dir: boolean): Float64Array;
+
+/**
+ * Geometric backing of a face.
+ * Returns [0, ox,oy,oz, ux,uy,uz, vx,vy,vz] for planes,
+ * or [1, surface_data...] for NURBS faces.
+ */
+export function brep_face_surface(json: string, face_index: number): Float64Array;
+
+/**
+ * Tessellate a single BREP face. Returns the standard mesh buffer.
+ */
+export function brep_face_tessellate(json: string, face_index: number, tolerance: number): Float64Array;
+
+/**
+ * BREP structure summary: [face_count, edge_count, vertex_count, is_closed].
+ */
+export function brep_info(json: string): Float64Array;
+
+/**
+ * Loft through profile curves into a BREP.
+ * Input: [num_curves, curve1_data..., curve2_data...]. Returns JSON.
+ */
+export function brep_loft_curves(data: Float64Array): string;
+
+/**
+ * BREP primitives.
+ * kind: "box"      [minx,miny,minz, maxx,maxy,maxz]
+ *       "cylinder" [bx,by,bz, ax,ay,az, radius, height]
+ *       "sphere"   [cx,cy,cz, radius]
+ *       "cone"     [bx,by,bz, ax,ay,az, radius0, radius1, height]
+ *       "torus"    [cx,cy,cz, major, minor]
+ * Returns the BREP as JSON ("" on failure).
+ */
+export function brep_primitive(kind: string, params: Float64Array): string;
+
+/**
+ * Revolve a profile curve into a BREP. Returns JSON.
+ */
+export function brep_revolve_curve(curve_data: Float64Array, ox: number, oy: number, oz: number, ax: number, ay: number, az: number, angle: number): string;
+
+/**
+ * Untrimmed sheet BREP from a NURBS surface. Returns JSON.
+ */
+export function brep_sheet_from_surface(surface_data: Float64Array): string;
+
+/**
+ * Tessellate a BREP into the standard mesh buffer
+ * [vertexCount, positions..., indices...]. Crack-free across shared edges.
+ */
+export function brep_tessellate(json: string, tolerance: number): Float64Array;
+
+/**
+ * Apply a row-major 4x4 matrix to a BREP. Returns transformed JSON.
+ */
+export function brep_transform(json: string, matrix: Float64Array): string;
+
+/**
+ * Validate a BREP. Returns a JSON report:
+ * {"isClosed":bool,"boundaryEdgeCount":n,"maxCoherenceError":e,"issues":[...]}
+ */
+export function brep_validate(json: string, tolerance: number): string;
+
+/**
+ * Volume and surface area from tessellation: [volume, area].
+ */
+export function brep_volume_area(json: string, tolerance: number): Float64Array;
+
 /**
  * Build a NURBS curve from raw control points with kernel-managed knots and weights.
  *
@@ -326,6 +417,17 @@ export function mesh_build_render_buffers(vertex_count: number, buffer: Float64A
  */
 export function mesh_chamfer_all_edges(mesh_type: string, params: Float64Array, offset: number): Float64Array;
 
+/**
+ * Clip a polyline against a closed mesh volume (boolean intersection for curves).
+ *
+ * `points` is a flat [x,y,z, ...] vertex list; `closed` marks a closed loop
+ * (no duplicated seam point required, one is tolerated).
+ * Returns two concatenated polyline buffers — inside pieces first, then
+ * outside pieces — each encoded as [num_polylines, n1, x,y,z,..., ...].
+ * Returns an empty buffer on failure (open cutter, degenerate polyline).
+ */
+export function mesh_clip_polyline(vertex_count: number, buffer: Float64Array, points: Float64Array, closed: boolean): Float64Array;
+
 /**
  * Compute planar curve normal from ordered points.
  */
@@ -549,6 +651,21 @@ export function mesh_scale(vertex_count: number, buffer: Float64Array, sx: numbe
 
 export function mesh_solid_split_plane(vertex_count: number, buffer: Float64Array, nx: number, ny: number, nz: number, d: number, operation: string): Float64Array;
 
+/**
+ * Trim an OPEN host surface by all closed cutter meshes in one WASM call.
+ *
+ * `packed` layout matches `mesh_boolean_difference_all`: the FIRST mesh is
+ * the open host and every following mesh is a closed cutter volume.
+ * `flags`: `""` or `"trustedInput"`.
+ *
+ * Unlike folding pairwise surface-split subtracts over the cutter list,
+ * every host triangle is cut by ALL relevant cutters at once (one CDT per
+ * triangle) and classified inside-any-cutter — one pass over the host
+ * instead of N passes over an ever-growing, ever-degrading host.
+ * Returns the outside (kept) mesh buffer, or an empty vector on failure.
+ */
+export function mesh_surface_difference_all(packed: Float64Array, flags: string): Float64Array;
+
 export function mesh_surface_split(vertex_count_a: number, buffer_a: Float64Array, vertex_count_b: number, buffer_b: Float64Array, operation: string): Float64Array;
 
 export function mesh_surface_split_plane(vertex_count: number, buffer: Float64Array, nx: number, ny: number, nz: number, d: number, operation: string): Float64Array;
@@ -587,12 +704,58 @@ export function nurbs_curve_curve_intersect(data_a: Float64Array, data_b: Float6
  */
 export function nurbs_curve_plane_intersect(data: Float64Array, nx: number, ny: number, nz: number, d: number): Float64Array;
 
+/**
+ * Closest point on the surface to (x, y, z).
+ * Returns [u, v, px, py, pz] with u, v normalized to [0,1].
+ */
+export function nurbs_surface_closest_point(data: Float64Array, x: number, y: number, z: number): Float64Array;
+
+/**
+ * Surface curvature at normalized (u, v): [k1, k2, gaussian, mean, nx, ny, nz].
+ */
+export function nurbs_surface_curvature(data: Float64Array, u: number, v: number): Float64Array;
+
+/**
+ * Analytic surface derivatives at normalized (u, v) in [0,1]².
+ * Returns 18 floats: [S, Su, Sv, Suu, Suv, Svv] (xyz each), derivatives taken
+ * with respect to the NORMALIZED parameters (chain rule applied).
+ */
+export function nurbs_surface_derivatives(data: Float64Array, u: number, v: number): Float64Array;
+
+/**
+ * Exact degree elevation by `t` in one direction.
+ */
+export function nurbs_surface_elevate_degree(data: Float64Array, u_dir: boolean, t: number): Float64Array;
+
 /**
  * Evaluate a NURBS surface at normalized parameters (u, v) in [0,1].
  * Returns [x, y, z]
  */
 export function nurbs_surface_evaluate(data: Float64Array, u: number, v: number): Float64Array;
 
+/**
+ * Exact sub-patch extraction over normalized ranges.
+ */
+export function nurbs_surface_extract_region(data: Float64Array, u0: number, u1: number, v0: number, v1: number): Float64Array;
+
+/**
+ * Exact extruded (translational) surface from a profile curve.
+ */
+export function nurbs_surface_extrude(curve_data: Float64Array, dx: number, dy: number, dz: number): Float64Array;
+
+/**
+ * Exact knot insertion at normalized parameter t (repeated `times`).
+ * Returns the refined surface in standard surface format.
+ */
+export function nurbs_surface_insert_knot(data: Float64Array, u_dir: boolean, t: number, times: number): Float64Array;
+
+/**
+ * Exact rational iso-parametric curve. `u_dir = true` extracts the curve
+ * running along u at constant v = t; false extracts along v at constant u = t.
+ * t is normalized [0,1]. Returns curve data [degree, n, pts..., w..., knots...].
+ */
+export function nurbs_surface_iso_curve(data: Float64Array, t: number, u_dir: boolean): Float64Array;
+
 /**
  * Evaluate a NURBS surface unit normal at normalized parameters (u, v) in [0,1].
  * Returns [x, y, z]
@@ -606,12 +769,51 @@ export function nurbs_surface_normal(data: Float64Array, u: number, v: number):
  */
 export function nurbs_surface_plane_intersect(surface_data: Float64Array, nx: number, ny: number, nz: number, d: number, tess: number): Float64Array;
 
+/**
+ * Exact rational primitive surfaces.
+ * kind: "cylinder" [bx,by,bz, ax,ay,az, radius, height]
+ *       "sphere"   [cx,cy,cz, radius]
+ *       "cone"     [bx,by,bz, ax,ay,az, radius0, radius1, height]
+ *       "torus"    [cx,cy,cz, major, minor]
+ */
+export function nurbs_surface_primitive(kind: string, params: Float64Array): Float64Array;
+
+/**
+ * Exact surface of revolution from a profile curve (A8.1).
+ */
+export function nurbs_surface_revolve(curve_data: Float64Array, ox: number, oy: number, oz: number, ax: number, ay: number, az: number, angle: number): Float64Array;
+
+/**
+ * Exact ruled surface between two curves (auto degree/knot compatibility).
+ */
+export function nurbs_surface_ruled(curve_a: Float64Array, curve_b: Float64Array): Float64Array;
+
+/**
+ * Exact split at normalized parameter t. Returns [lenA, surfaceA..., lenB, surfaceB...].
+ */
+export function nurbs_surface_split(data: Float64Array, u_dir: boolean, t: number): Float64Array;
+
 /**
  * Intersect two NURBS surfaces.
  * Returns polyline buffer.
  */
 export function nurbs_surface_surface_intersect(data_a: Float64Array, data_b: Float64Array, tess: number): Float64Array;
 
+/**
+ * Curvature-adaptive tessellation against a chordal tolerance.
+ * Returns the standard mesh buffer [vertexCount, positions..., indices...].
+ */
+export function nurbs_surface_tessellate_adaptive(data: Float64Array, tolerance: number, max_segments_per_span: number): Float64Array;
+
+/**
+ * Display-ready render tessellation: twist-aware adaptive grid with ANALYTIC
+ * surface normals, plus feature edges only where the surface really has them
+ * (boundaries, kinked C0 knot lines, kinked closed seams).
+ * Output (f32, same packing as `mesh_build_render_buffers`):
+ * [vertexCount, positions..., normals..., edgeSegmentCount, edgeSegments...]
+ */
+export function nurbs_surface_tessellate_render(data: Float64Array, tolerance: number, max_segments_per_span: number, crease_angle_deg: number): Float32Array;
+
 /**
  * Offset a polycurve made of line and arc segments.
  * Input format: [segment_count, type, ...data, ...]
@@ -737,6 +939,21 @@ export interface InitOutput {
     readonly memory: WebAssembly.Memory;
     readonly arc_length: (a: number, b: number, c: number) => number;
     readonly arc_point_at: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number, j: number) => [number, number];
+    readonly brep_boolean_op: (a: number, b: number, c: number, d: number, e: number, f: number, g: number) => [number, number];
+    readonly brep_edges: (a: number, b: number, c: number) => [number, number];
+    readonly brep_extrude_curve: (a: number, b: number, c: number, d: number, e: number, f: number) => [number, number];
+    readonly brep_face_iso_curve: (a: number, b: number, c: number, d: number, e: number) => [number, number];
+    readonly brep_face_surface: (a: number, b: number, c: number) => [number, number];
+    readonly brep_face_tessellate: (a: number, b: number, c: number, d: number) => [number, number];
+    readonly brep_info: (a: number, b: number) => [number, number];
+    readonly brep_loft_curves: (a: number, b: number) => [number, number];
+    readonly brep_primitive: (a: number, b: number, c: number, d: number) => [number, number];
+    readonly brep_revolve_curve: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number) => [number, number];
+    readonly brep_sheet_from_surface: (a: number, b: number) => [number, number];
+    readonly brep_tessellate: (a: number, b: number, c: number) => [number, number];
+    readonly brep_transform: (a: number, b: number, c: number, d: number) => [number, number];
+    readonly brep_validate: (a: number, b: number, c: number) => [number, number];
+    readonly brep_volume_area: (a: number, b: number, c: number) => [number, number];
     readonly build_nurbs_curve: (a: number, b: number, c: number, d: number) => [number, number];
     readonly chamfer_polycurve: (a: number, b: number, c: number) => [number, number];
     readonly circle_length: (a: number) => number;
@@ -791,6 +1008,7 @@ export interface InitOutput {
     readonly mesh_build_coplanar_connected_face_groups: (a: number, b: number, c: number) => [number, number];
     readonly mesh_build_render_buffers: (a: number, b: number, c: number, d: number) => [number, number];
     readonly mesh_chamfer_all_edges: (a: number, b: number, c: number, d: number, e: number) => [number, number];
+    readonly mesh_clip_polyline: (a: number, b: number, c: number, d: number, e: number, f: number) => [number, number];
     readonly mesh_compute_planar_curve_normal: (a: number, b: number, c: number) => [number, number];
     readonly mesh_contains_point: (a: number, b: number, c: number, d: number, e: number, f: number) => number;
     readonly mesh_create_box: (a: number, b: number, c: number) => [number, number];
@@ -831,6 +1049,7 @@ export interface InitOutput {
     readonly mesh_rotate: (a: number, b: number, c: number, d: number, e: number, f: number, g: number) => [number, number];
     readonly mesh_scale: (a: number, b: number, c: number, d: number, e: number, f: number) => [number, number];
     readonly mesh_solid_split_plane: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number) => [number, number];
+    readonly mesh_surface_difference_all: (a: number, b: number, c: number, d: number) => [number, number];
     readonly mesh_surface_split: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number) => [number, number];
     readonly mesh_surface_split_plane: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number) => [number, number];
     readonly mesh_topology_metrics: (a: number, b: number, c: number) => [number, number];
@@ -838,10 +1057,24 @@ export interface InitOutput {
     readonly mesh_translate: (a: number, b: number, c: number, d: number, e: number, f: number) => [number, number];
     readonly nurbs_curve_curve_intersect: (a: number, b: number, c: number, d: number) => [number, number];
     readonly nurbs_curve_plane_intersect: (a: number, b: number, c: number, d: number, e: number, f: number) => [number, number];
+    readonly nurbs_surface_closest_point: (a: number, b: number, c: number, d: number, e: number) => [number, number];
+    readonly nurbs_surface_curvature: (a: number, b: number, c: number, d: number) => [number, number];
+    readonly nurbs_surface_derivatives: (a: number, b: number, c: number, d: number) => [number, number];
+    readonly nurbs_surface_elevate_degree: (a: number, b: number, c: number, d: number) => [number, number];
     readonly nurbs_surface_evaluate: (a: number, b: number, c: number, d: number) => [number, number];
+    readonly nurbs_surface_extract_region: (a: number, b: number, c: number, d: number, e: number, f: number) => [number, number];
+    readonly nurbs_surface_extrude: (a: number, b: number, c: number, d: number, e: number) => [number, number];
+    readonly nurbs_surface_insert_knot: (a: number, b: number, c: number, d: number, e: number) => [number, number];
+    readonly nurbs_surface_iso_curve: (a: number, b: number, c: number, d: number) => [number, number];
     readonly nurbs_surface_normal: (a: number, b: number, c: number, d: number) => [number, number];
     readonly nurbs_surface_plane_intersect: (a: number, b: number, c: number, d: number, e: number, f: number, g: number) => [number, number];
+    readonly nurbs_surface_primitive: (a: number, b: number, c: number, d: number) => [number, number];
+    readonly nurbs_surface_revolve: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number) => [number, number];
+    readonly nurbs_surface_ruled: (a: number, b: number, c: number, d: number) => [number, number];
+    readonly nurbs_surface_split: (a: number, b: number, c: number, d: number) => [number, number];
     readonly nurbs_surface_surface_intersect: (a: number, b: number, c: number, d: number, e: number) => [number, number];
+    readonly nurbs_surface_tessellate_adaptive: (a: number, b: number, c: number, d: number) => [number, number];
+    readonly nurbs_surface_tessellate_render: (a: number, b: number, c: number, d: number, e: number) => [number, number];
     readonly offset_polycurve: (a: number, b: number, c: number, d: number, e: number, f: number, g: number) => [number, number];
     readonly offset_polycurve_all: (a: number, b: number, c: number, d: number, e: number, f: number, g: number) => [number, number];
     readonly offset_polyline_curve: (a: number, b: number, c: number, d: number, e: number, f: number) => [number, number];