okgeometry-api 1.5.0 → 1.9.0

package/dist/Brep.d.ts

@@ -0,0 +1,177 @@
+import { Point } from "./Point.js";
+import { Vec3 } from "./Vec3.js";
+import { Plane } from "./Plane.js";
+import { Mesh, type MeshBooleanOptions } from "./Mesh.js";
+import { Polyline } from "./Polyline.js";
+import { NurbsCurve } from "./NurbsCurve.js";
+import { NurbsSurface } from "./NurbsSurface.js";
+/** Options for Brep boolean operations. */
+export interface BrepBooleanOptions extends MeshBooleanOptions {
+    /**
+     * Chordal deviation tolerance used to tessellate BREP operands before the
+     * boolean runs (model units). Defaults to 0.005, matching `toMesh()`.
+     */
+    tolerance?: number;
+}
+/** Options for PARAMETRIC Brep booleans (exact SSI, BREP result). */
+export interface BrepParametricBooleanOptions {
+    /**
+     * Absolute geometric tolerance for intersection edges and coincident-face
+     * classification (model units). Defaults to 1e-6.
+     */
+    tolerance?: number;
+}
+/** Validation report for a BREP body. */
+export interface BrepValidationReport {
+    isClosed: boolean;
+    boundaryEdgeCount: number;
+    maxCoherenceError: number;
+    issues: string[];
+}
+/** Structure summary of a BREP body. */
+export interface BrepInfo {
+    faceCount: number;
+    edgeCount: number;
+    vertexCount: number;
+    isClosed: boolean;
+}
+/**
+ * Boundary representation (BREP) solid or sheet backed by the WASM kernel.
+ *
+ * A Brep is a graph of faces (trimmed exact surfaces — planes or NURBS),
+ * edges (exact 3D curves shared between faces) and vertices. Unlike a Mesh,
+ * the geometry stays EXACT: a cylinder face is a true rational surface, and
+ * tessellation density is a display decision made at query time.
+ *
+ * Topology is carried as JSON (kernel-defined schema) so it can persist in
+ * documents; tessellation and queries are binary WASM calls.
+ */
+export declare class Brep {
+    readonly json: string;
+    private _info;
+    private constructor();
+    /** Restore a Brep from its JSON representation. */
+    static fromJson(json: string): Brep;
+    /** Exact BREP box between two corners (6 planar faces, 12 edges, 8 vertices). */
+    static box(min: Point, max: Point): Brep;
+    /** Exact BREP cylinder (rational side surface + planar caps). */
+    static cylinder(base: Point, axis: Vec3, radius: number, height: number): Brep;
+    /** Exact BREP sphere (single rational face, degenerate poles). */
+    static sphere(center: Point, radius: number): Brep;
+    /** Exact BREP cone or frustum (radius1 = 0 produces an apex). */
+    static cone(base: Point, axis: Vec3, radius0: number, radius1: number, height: number): Brep;
+    /** Exact BREP torus (single rational face, axis +Z through center). */
+    static torus(center: Point, major: number, minor: number): Brep;
+    private static fromPrimitive;
+    /**
+     * Extrude a planar profile curve. Closed profiles produce a capped solid
+     * with proper shared-edge topology; open profiles produce a sheet.
+     */
+    static extrude(profile: NurbsCurve, direction: Vec3, height: number): Brep;
+    /**
+     * Revolve a profile curve around an axis.
+     * Full revolutions of closed profiles produce torus-like single-face solids;
+     * open profiles with on-axis endpoints close at the poles (sphere/cone style);
+     * partial revolutions of closed planar profiles get planar caps.
+     */
+    static revolve(profile: NurbsCurve, origin: Point, axis: Vec3, angle: number): Brep;
+    /** Loft through profile curves (compatibility handled automatically). */
+    static loft(profiles: NurbsCurve[]): Brep;
+    /** Untrimmed sheet BREP from a NURBS surface (4 boundary edges). */
+    static fromSurface(surface: NurbsSurface): Brep;
+    /** Face/edge/vertex counts and closedness (cached). */
+    get info(): BrepInfo;
+    get faceCount(): number;
+    get edgeCount(): number;
+    /** Whether every non-degenerate edge is shared by exactly two faces (solid). */
+    isClosed(): boolean;
+    /**
+     * Tessellate the whole body into a triangle mesh. Adjacent faces share the
+     * same edge samples, so the result is crack-free (watertight for solids).
+     * @param tolerance - Chordal deviation tolerance (model units)
+     */
+    tessellate(tolerance?: number): Mesh;
+    /** Tessellate a single face into a triangle mesh. */
+    tessellateFace(faceIndex: number, tolerance?: number): Mesh;
+    /** Exact model edges sampled as polylines (feature curves for display/selection). */
+    edges(tolerance?: number): Polyline[];
+    /**
+     * Exact backing surface of a face: a NurbsSurface for curved faces, a Plane
+     * for planar faces.
+     */
+    faceSurface(faceIndex: number): NurbsSurface | Plane;
+    /**
+     * Exact iso-parametric curve of a curved face's backing surface.
+     * Returns null for planar faces.
+     * @param t - Normalized parameter [0, 1]
+     * @param direction - "u" extracts along u at constant v=t; "v" the converse
+     */
+    faceIsoCurve(faceIndex: number, t: number, direction: "u" | "v"): NurbsCurve | null;
+    /** Apply a row-major 4x4 matrix to all geometry (exact). */
+    applyMatrix(matrix: number[] | Float64Array): Brep;
+    /** Translate the body. */
+    translate(offset: Vec3): Brep;
+    /** Validate topology and trim coherence. */
+    validate(tolerance?: number): BrepValidationReport;
+    /** Volume and surface area (from tessellation at the given tolerance). */
+    volumeArea(tolerance?: number): {
+        volume: number;
+        area: number;
+    };
+    /** Convert to a mesh body (e.g. for boolean operations with meshes). */
+    toMesh(tolerance?: number): Mesh;
+    private static resolveBooleanOperand;
+    private runBoolean;
+    /**
+     * Boolean union with another Brep or Mesh.
+     *
+     * Both operands are tessellated at `options.tolerance` (BREP tessellation
+     * is crack-free, so closed bodies stay watertight) and combined with the
+     * mesh CSG pipeline. The result is a Mesh — exact trimmed-BREP boolean
+     * output is not supported. Requires both bodies to be closed solids.
+     */
+    union(other: Brep | Mesh, options?: BrepBooleanOptions): Mesh;
+    /**
+     * Boolean subtraction (this − other) with another Brep or Mesh.
+     *
+     * Closed − closed runs full CSG; an open sheet Brep minus a closed solid
+     * trims the sheet (split, keep outside). The result is a Mesh.
+     */
+    subtract(other: Brep | Mesh, options?: BrepBooleanOptions): Mesh;
+    /**
+     * Boolean intersection with another Brep or Mesh.
+     *
+     * Closed ∩ closed returns the shared volume; an open sheet Brep ∩ a closed
+     * solid trims the sheet (split, keep inside). The result is a Mesh.
+     */
+    intersect(other: Brep | Mesh, options?: BrepBooleanOptions): Mesh;
+    /**
+     * Intersection CURVES with another Brep or Mesh — the polylines where the
+     * two surfaces cross (no volume classification). Tolerance controls the
+     * tessellation density of both operands.
+     */
+    intersectCurves(other: Brep | Mesh, tolerance?: number): Polyline[];
+    private runParametricBoolean;
+    /**
+     * PARAMETRIC boolean union: exact surface–surface intersection curves with
+     * trimmed-surface output. Result faces keep their parents' exact surfaces
+     * (planes/NURBS, untessellated); intersection edges are Newton-refined SSI
+     * curves stored as tolerant NURBS edges with matched pcurves on both
+     * adjacent faces. Both operands must be CLOSED solids.
+     *
+     * `options.tolerance` is the absolute geometric tolerance of intersection
+     * edges and coincident-face classification (default 1e-6).
+     *
+     * Known limitation: exactly tangential surface contact (e.g. equal-radius
+     * cylinders touching along a line/point) is not resolved into pinch
+     * topology; transversal and coincident (coplanar) configurations are exact.
+     */
+    unionBrep(other: Brep, options?: BrepParametricBooleanOptions): Brep;
+    /** PARAMETRIC boolean subtraction (this − other). See {@link unionBrep}. */
+    subtractBrep(other: Brep, options?: BrepParametricBooleanOptions): Brep;
+    /** PARAMETRIC boolean intersection. See {@link unionBrep}. */
+    intersectBrep(other: Brep, options?: BrepParametricBooleanOptions): Brep;
+    /** JSON representation (persistence). */
+    toJson(): string;
+}
+//# sourceMappingURL=Brep.d.ts.map

package/dist/Brep.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Brep.d.ts","sourceRoot":"","sources":["../src/Brep.ts"],"names":[],"mappings":"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"}

package/dist/Brep.js

@@ -0,0 +1,368 @@
+import { ensureInit } from "./engine.js";
+import { Point } from "./Point.js";
+import { Vec3 } from "./Vec3.js";
+import { Plane } from "./Plane.js";
+import { Mesh } from "./Mesh.js";
+import { Polyline } from "./Polyline.js";
+import { NurbsCurve } from "./NurbsCurve.js";
+import { NurbsSurface } from "./NurbsSurface.js";
+import * as wasm from "./wasm-bindings.js";
+/**
+ * Boundary representation (BREP) solid or sheet backed by the WASM kernel.
+ *
+ * A Brep is a graph of faces (trimmed exact surfaces — planes or NURBS),
+ * edges (exact 3D curves shared between faces) and vertices. Unlike a Mesh,
+ * the geometry stays EXACT: a cylinder face is a true rational surface, and
+ * tessellation density is a display decision made at query time.
+ *
+ * Topology is carried as JSON (kernel-defined schema) so it can persist in
+ * documents; tessellation and queries are binary WASM calls.
+ */
+export class Brep {
+    constructor(json) {
+        this.json = json;
+        this._info = null;
+        if (!json)
+            throw new Error("Brep: empty body");
+    }
+    // ── Constructors ──
+    /** Restore a Brep from its JSON representation. */
+    static fromJson(json) {
+        return new Brep(json);
+    }
+    /** Exact BREP box between two corners (6 planar faces, 12 edges, 8 vertices). */
+    static box(min, max) {
+        ensureInit();
+        return Brep.fromPrimitive("box", [min.x, min.y, min.z, max.x, max.y, max.z]);
+    }
+    /** Exact BREP cylinder (rational side surface + planar caps). */
+    static cylinder(base, axis, radius, height) {
+        ensureInit();
+        return Brep.fromPrimitive("cylinder", [
+            base.x, base.y, base.z, axis.x, axis.y, axis.z, radius, height,
+        ]);
+    }
+    /** Exact BREP sphere (single rational face, degenerate poles). */
+    static sphere(center, radius) {
+        ensureInit();
+        return Brep.fromPrimitive("sphere", [center.x, center.y, center.z, radius]);
+    }
+    /** Exact BREP cone or frustum (radius1 = 0 produces an apex). */
+    static cone(base, axis, radius0, radius1, height) {
+        ensureInit();
+        return Brep.fromPrimitive("cone", [
+            base.x, base.y, base.z, axis.x, axis.y, axis.z, radius0, radius1, height,
+        ]);
+    }
+    /** Exact BREP torus (single rational face, axis +Z through center). */
+    static torus(center, major, minor) {
+        ensureInit();
+        return Brep.fromPrimitive("torus", [center.x, center.y, center.z, major, minor]);
+    }
+    static fromPrimitive(kind, params) {
+        const json = wasm.brep_primitive(kind, new Float64Array(params));
+        if (!json)
+            throw new Error(`Brep.${kind} construction failed`);
+        return new Brep(json);
+    }
+    /**
+     * Extrude a planar profile curve. Closed profiles produce a capped solid
+     * with proper shared-edge topology; open profiles produce a sheet.
+     */
+    static extrude(profile, direction, height) {
+        ensureInit();
+        const json = wasm.brep_extrude_curve(profile.data, direction.x, direction.y, direction.z, height);
+        if (!json)
+            throw new Error("Brep.extrude failed (profile must be planar)");
+        return new Brep(json);
+    }
+    /**
+     * Revolve a profile curve around an axis.
+     * Full revolutions of closed profiles produce torus-like single-face solids;
+     * open profiles with on-axis endpoints close at the poles (sphere/cone style);
+     * partial revolutions of closed planar profiles get planar caps.
+     */
+    static revolve(profile, origin, axis, angle) {
+        ensureInit();
+        const json = wasm.brep_revolve_curve(profile.data, origin.x, origin.y, origin.z, axis.x, axis.y, axis.z, angle);
+        if (!json)
+            throw new Error("Brep.revolve failed");
+        return new Brep(json);
+    }
+    /** Loft through profile curves (compatibility handled automatically). */
+    static loft(profiles) {
+        ensureInit();
+        if (profiles.length < 2)
+            throw new Error("Brep.loft needs at least 2 profiles");
+        const parts = [profiles.length];
+        for (const c of profiles) {
+            const d = c.data;
+            for (let i = 0; i < d.length; i++)
+                parts.push(d[i]);
+        }
+        const json = wasm.brep_loft_curves(new Float64Array(parts));
+        if (!json)
+            throw new Error("Brep.loft failed");
+        return new Brep(json);
+    }
+    /** Untrimmed sheet BREP from a NURBS surface (4 boundary edges). */
+    static fromSurface(surface) {
+        ensureInit();
+        const json = wasm.brep_sheet_from_surface(surface.data);
+        if (!json)
+            throw new Error("Brep.fromSurface failed");
+        return new Brep(json);
+    }
+    // ── Structure ──
+    /** Face/edge/vertex counts and closedness (cached). */
+    get info() {
+        if (!this._info) {
+            ensureInit();
+            const r = wasm.brep_info(this.json);
+            if (r.length < 4)
+                throw new Error("Brep.info failed");
+            this._info = {
+                faceCount: Number(r[0]),
+                edgeCount: Number(r[1]),
+                vertexCount: Number(r[2]),
+                isClosed: r[3] > 0.5,
+            };
+        }
+        return this._info;
+    }
+    get faceCount() {
+        return this.info.faceCount;
+    }
+    get edgeCount() {
+        return this.info.edgeCount;
+    }
+    /** Whether every non-degenerate edge is shared by exactly two faces (solid). */
+    isClosed() {
+        return this.info.isClosed;
+    }
+    // ── Tessellation / display ──
+    /**
+     * Tessellate the whole body into a triangle mesh. Adjacent faces share the
+     * same edge samples, so the result is crack-free (watertight for solids).
+     * @param tolerance - Chordal deviation tolerance (model units)
+     */
+    tessellate(tolerance = 0.01) {
+        ensureInit();
+        const buf = wasm.brep_tessellate(this.json, tolerance);
+        if (buf.length < 1)
+            throw new Error("Brep.tessellate failed");
+        return Mesh.fromBuffer(buf);
+    }
+    /** Tessellate a single face into a triangle mesh. */
+    tessellateFace(faceIndex, tolerance = 0.01) {
+        ensureInit();
+        const buf = wasm.brep_face_tessellate(this.json, faceIndex, tolerance);
+        if (buf.length < 1)
+            throw new Error(`Brep.tessellateFace(${faceIndex}) failed`);
+        return Mesh.fromBuffer(buf);
+    }
+    /** Exact model edges sampled as polylines (feature curves for display/selection). */
+    edges(tolerance = 0.01) {
+        ensureInit();
+        const buf = wasm.brep_edges(this.json, tolerance);
+        if (buf.length < 1)
+            return [];
+        const out = [];
+        let idx = 1;
+        const count = Number(buf[0]);
+        for (let i = 0; i < count; i++) {
+            const n = Number(buf[idx++]);
+            const pts = [];
+            for (let k = 0; k < n; k++) {
+                pts.push(new Point(buf[idx], buf[idx + 1], buf[idx + 2]));
+                idx += 3;
+            }
+            if (pts.length >= 2)
+                out.push(new Polyline(pts));
+        }
+        return out;
+    }
+    // ── Face geometry ──
+    /**
+     * Exact backing surface of a face: a NurbsSurface for curved faces, a Plane
+     * for planar faces.
+     */
+    faceSurface(faceIndex) {
+        ensureInit();
+        const buf = wasm.brep_face_surface(this.json, faceIndex);
+        if (buf.length < 1)
+            throw new Error(`Brep.faceSurface(${faceIndex}) failed`);
+        if (Number(buf[0]) === 0) {
+            if (buf.length < 10)
+                throw new Error("Brep.faceSurface: bad plane data");
+            const origin = new Point(buf[1], buf[2], buf[3]);
+            const uDir = new Vec3(buf[4], buf[5], buf[6]);
+            const vDir = new Vec3(buf[7], buf[8], buf[9]);
+            const normal = uDir.cross(vDir);
+            return new Plane(origin, normal, uDir);
+        }
+        return NurbsSurface.fromData(buf.slice(1));
+    }
+    /**
+     * Exact iso-parametric curve of a curved face's backing surface.
+     * Returns null for planar faces.
+     * @param t - Normalized parameter [0, 1]
+     * @param direction - "u" extracts along u at constant v=t; "v" the converse
+     */
+    faceIsoCurve(faceIndex, t, direction) {
+        ensureInit();
+        const buf = wasm.brep_face_iso_curve(this.json, faceIndex, t, direction === "u");
+        if (buf.length < 2)
+            return null;
+        return NurbsCurve.fromData(buf);
+    }
+    // ── Transforms ──
+    /** Apply a row-major 4x4 matrix to all geometry (exact). */
+    applyMatrix(matrix) {
+        ensureInit();
+        if (matrix.length < 16)
+            throw new Error("Brep.applyMatrix: need 16 entries");
+        const json = wasm.brep_transform(this.json, new Float64Array(matrix));
+        if (!json)
+            throw new Error("Brep.applyMatrix failed");
+        return new Brep(json);
+    }
+    /** Translate the body. */
+    translate(offset) {
+        return this.applyMatrix([
+            1, 0, 0, offset.x,
+            0, 1, 0, offset.y,
+            0, 0, 1, offset.z,
+            0, 0, 0, 1,
+        ]);
+    }
+    // ── Analysis ──
+    /** Validate topology and trim coherence. */
+    validate(tolerance = 1e-7) {
+        ensureInit();
+        const json = wasm.brep_validate(this.json, tolerance);
+        if (!json)
+            throw new Error("Brep.validate failed");
+        return JSON.parse(json);
+    }
+    /** Volume and surface area (from tessellation at the given tolerance). */
+    volumeArea(tolerance = 0.001) {
+        ensureInit();
+        const r = wasm.brep_volume_area(this.json, tolerance);
+        if (r.length < 2)
+            throw new Error("Brep.volumeArea failed");
+        return { volume: r[0], area: r[1] };
+    }
+    /** Convert to a mesh body (e.g. for boolean operations with meshes). */
+    toMesh(tolerance = 0.005) {
+        return this.tessellate(tolerance);
+    }
+    // ── Booleans ──
+    static resolveBooleanOperand(other, tolerance) {
+        return other instanceof Mesh ? other : other.toMesh(tolerance);
+    }
+    runBoolean(other, op, options) {
+        const tolerance = options?.tolerance ?? 0.005;
+        // The mesh CSG pipeline is sensitive to specific tessellation densities on
+        // curved (especially rational) surfaces; a failed run usually succeeds at
+        // a slightly perturbed density. Retry with nudged (coarser — finer risks
+        // the face-count safety limits) tolerances before giving up; accuracy
+        // stays within the requested band.
+        const attempts = [1.0, 1.12, 1.25, 1.4];
+        let lastError;
+        for (const factor of attempts) {
+            const tol = tolerance * factor;
+            try {
+                const lhs = this.toMesh(tol);
+                const rhs = Brep.resolveBooleanOperand(other, tol);
+                return lhs[op](rhs, options);
+            }
+            catch (e) {
+                lastError = e;
+            }
+        }
+        throw lastError;
+    }
+    /**
+     * Boolean union with another Brep or Mesh.
+     *
+     * Both operands are tessellated at `options.tolerance` (BREP tessellation
+     * is crack-free, so closed bodies stay watertight) and combined with the
+     * mesh CSG pipeline. The result is a Mesh — exact trimmed-BREP boolean
+     * output is not supported. Requires both bodies to be closed solids.
+     */
+    union(other, options) {
+        return this.runBoolean(other, "union", options);
+    }
+    /**
+     * Boolean subtraction (this − other) with another Brep or Mesh.
+     *
+     * Closed − closed runs full CSG; an open sheet Brep minus a closed solid
+     * trims the sheet (split, keep outside). The result is a Mesh.
+     */
+    subtract(other, options) {
+        return this.runBoolean(other, "subtract", options);
+    }
+    /**
+     * Boolean intersection with another Brep or Mesh.
+     *
+     * Closed ∩ closed returns the shared volume; an open sheet Brep ∩ a closed
+     * solid trims the sheet (split, keep inside). The result is a Mesh.
+     */
+    intersect(other, options) {
+        return this.runBoolean(other, "intersect", options);
+    }
+    /**
+     * Intersection CURVES with another Brep or Mesh — the polylines where the
+     * two surfaces cross (no volume classification). Tolerance controls the
+     * tessellation density of both operands.
+     */
+    intersectCurves(other, tolerance = 0.005) {
+        const lhs = this.toMesh(tolerance);
+        const rhs = Brep.resolveBooleanOperand(other, tolerance);
+        return lhs.intersectMesh(rhs);
+    }
+    // ── Parametric booleans (BREP → BREP) ──
+    runParametricBoolean(other, op, options) {
+        ensureInit();
+        const tolerance = options?.tolerance ?? 1e-6;
+        const json = wasm.brep_boolean_op(this.json, other.json, op, tolerance);
+        if (!json)
+            throw new Error(`Brep.${op}Brep failed`);
+        if (json.startsWith('{"error"')) {
+            const parsed = JSON.parse(json);
+            throw new Error(`Brep.${op}Brep failed: ${parsed.error}`);
+        }
+        return new Brep(json);
+    }
+    /**
+     * PARAMETRIC boolean union: exact surface–surface intersection curves with
+     * trimmed-surface output. Result faces keep their parents' exact surfaces
+     * (planes/NURBS, untessellated); intersection edges are Newton-refined SSI
+     * curves stored as tolerant NURBS edges with matched pcurves on both
+     * adjacent faces. Both operands must be CLOSED solids.
+     *
+     * `options.tolerance` is the absolute geometric tolerance of intersection
+     * edges and coincident-face classification (default 1e-6).
+     *
+     * Known limitation: exactly tangential surface contact (e.g. equal-radius
+     * cylinders touching along a line/point) is not resolved into pinch
+     * topology; transversal and coincident (coplanar) configurations are exact.
+     */
+    unionBrep(other, options) {
+        return this.runParametricBoolean(other, "union", options);
+    }
+    /** PARAMETRIC boolean subtraction (this − other). See {@link unionBrep}. */
+    subtractBrep(other, options) {
+        return this.runParametricBoolean(other, "subtract", options);
+    }
+    /** PARAMETRIC boolean intersection. See {@link unionBrep}. */
+    intersectBrep(other, options) {
+        return this.runParametricBoolean(other, "intersect", options);
+    }
+    /** JSON representation (persistence). */
+    toJson() {
+        return this.json;
+    }
+}
+//# sourceMappingURL=Brep.js.map

package/dist/Brep.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Brep.js","sourceRoot":"","sources":["../src/Brep.ts"],"names":[],"mappings":"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"}

package/dist/Mesh.d.ts

@@ -497,7 +497,12 @@ export declare class Mesh {
     static sweepCurves(profile: SweepableCurve, path: SweepableCurve, segments?: number, caps?: boolean): Mesh;
     /** Encode a curve into the WASM format for sweep_curves. */
     private static encodeCurve;
-    private static mergeMeshes;
+    /**
+     * Concatenate meshes into one multi-component mesh (buffer merge with
+     * index offsetting — no welding and no CSG). Useful for collecting split
+     * pieces back into a single body.
+     */
+    static mergeMeshes(meshes: Mesh[]): Mesh;
     /**
      * Raycast against many meshes and return all hits sorted by distance.
      */
@@ -656,6 +661,21 @@ export declare class Mesh {
      * @returns Array of polylines representing intersection curves
      */
     intersectMesh(other: Mesh): Polyline[];
+    /**
+     * Clip a polyline against this CLOSED mesh volume — boolean intersection
+     * semantics for curves. The polyline is split at every crossing with the
+     * mesh surface; pieces inside the volume land in `inside`, the rest in
+     * `outside`. Closed loops merge the piece spanning the loop seam, and a
+     * loop that never crosses the mesh comes back as one closed polyline.
+     *
+     * @param polyline - Polyline (closedness inferred) or raw point list
+     * @param closed - Treat the points as a closed loop (defaults to the
+     *   polyline's own closedness; required when passing a raw point list)
+     */
+    clipPolyline(polyline: Polyline | Point[], closed?: boolean): {
+        inside: Polyline[];
+        outside: Polyline[];
+    };
     /**
      * Apply a 4x4 transformation matrix.
      * @param matrix - Row-major flat array of 16 numbers