opengeometry 2.0.2 → 2.0.4

package/src/editor/types.d.ts

@@ -1,6 +1,12 @@
 import { Vector3 } from "../../opengeometry/pkg/opengeometry.js";
 import type { ObjectTransformation } from "../freeform/types.js";
+/**
+ * Numeric identifier used for faces, edges, and vertices in freeform topology APIs.
+ */
 export type TopologyId = number;
+/**
+ * Kernel edit permissions shared by global and feature-scoped freeform capabilities.
+ */
 export interface FreeformOperationCapabilities {
     canPushPullFace: boolean;
     canMoveFace: boolean;
@@ -14,6 +20,9 @@ export interface FreeformOperationCapabilities {
     canLoopCut: boolean;
     reasons?: string[];
 }
+/**
+ * Global editing capabilities for a freeform geometry object.
+ */
 export interface FreeformEditCapabilities extends FreeformOperationCapabilities {
     editingMode: "freeform";
     entityType: "freeform";
@@ -22,29 +31,50 @@ export interface FreeformEditCapabilities extends FreeformOperationCapabilities
     canEditPlacement: false;
     canConvertToFreeform: false;
 }
+/**
+ * Feature-scoped editing capabilities for a single face, edge, or vertex.
+ */
 export interface FreeformFeatureEditCapabilities extends FreeformOperationCapabilities {
     domain: "face" | "edge" | "vertex";
     topologyId: TopologyId;
 }
+/**
+ * How a topology id changed after an edit.
+ */
 export type TopologyRemapStatus = "unchanged" | "split" | "merged" | "deleted";
+/**
+ * Maps an old topology id to the ids that replaced it.
+ */
 export interface TopologyRemapEntry {
     old_id: TopologyId;
     new_ids: TopologyId[];
     primary_id: TopologyId | null;
     status: TopologyRemapStatus;
 }
+/**
+ * Newly created topology ids emitted by a freeform edit.
+ */
 export interface TopologyCreatedIds {
     faces: TopologyId[];
     edges: TopologyId[];
     vertices: TopologyId[];
 }
+/**
+ * Topology remap payload returned by edits that change face/edge/vertex ids.
+ */
 export interface TopologyRemap {
     faces: TopologyRemapEntry[];
     edges: TopologyRemapEntry[];
     vertices: TopologyRemapEntry[];
     created_ids: TopologyCreatedIds;
 }
+/**
+ * Diagnostic severities returned by freeform validity checks.
+ */
 export type DiagnosticSeverity = "info" | "warning" | "error";
+/**
+ * Individual diagnostic emitted by a freeform edit or validation pass.
+ */
 export interface FreeformDiagnostic {
     code: string;
     severity: DiagnosticSeverity;
@@ -52,11 +82,17 @@ export interface FreeformDiagnostic {
     domain?: string;
     topology_id?: TopologyId;
 }
+/**
+ * Validity summary returned after a freeform edit.
+ */
 export interface FreeformValidity {
     ok: boolean;
     healed?: boolean;
     diagnostics: FreeformDiagnostic[];
 }
+/**
+ * Face metadata returned by the freeform editor.
+ */
 export interface FaceInfo {
     face_id: TopologyId;
     centroid: Vector3;
@@ -67,6 +103,9 @@ export interface FaceInfo {
     vertex_ids: TopologyId[];
     adjacent_face_ids: TopologyId[];
 }
+/**
+ * Edge metadata returned by the freeform editor.
+ */
 export interface EdgeInfo {
     edge_id: TopologyId;
     curve_type: string;
@@ -76,30 +115,48 @@ export interface EdgeInfo {
     end: Vector3;
     incident_face_ids: TopologyId[];
 }
+/**
+ * Vertex metadata returned by the freeform editor.
+ */
 export interface VertexInfo {
     vertex_id: TopologyId;
     position: Vector3;
     edge_ids: TopologyId[];
     face_ids: TopologyId[];
 }
+/**
+ * Triangulated face render data for topology overlays.
+ */
 export interface TopologyFaceRenderData {
     face_id: TopologyId;
     positions: number[];
     indices: number[];
 }
+/**
+ * Edge polyline render data for topology overlays.
+ */
 export interface TopologyEdgeRenderData {
     edge_id: TopologyId;
     positions: number[];
 }
+/**
+ * Vertex render data for topology overlays.
+ */
 export interface TopologyVertexRenderData {
     vertex_id: TopologyId;
     position: Vector3;
 }
+/**
+ * Full renderable topology payload emitted by the freeform editor.
+ */
 export interface TopologyRenderData {
     faces: TopologyFaceRenderData[];
     edges: TopologyEdgeRenderData[];
     vertices: TopologyVertexRenderData[];
 }
+/**
+ * Structured result payload returned by freeform edit operations.
+ */
 export interface FreeformEditResult {
     entity_id: string;
     brep_serialized?: string;
@@ -114,6 +171,9 @@ export interface FreeformEditResult {
     validity: FreeformValidity;
     placement: ObjectTransformation;
 }
+/**
+ * Optional flags that control how much auxiliary data an edit returns.
+ */
 export interface EditOperationOptions {
     includeBrepSerialized?: boolean;
     includeLocalBrepSerialized?: boolean;
@@ -127,16 +187,25 @@ export interface EditOperationOptions {
     constraintFrame?: "local" | "world";
     openSurfaceMode?: boolean;
 }
+/**
+ * High-level editing mode families exposed by public wrappers.
+ */
 export type EditingMode = "parametric" | "freeform";
 export type ParametricEntityType = "line" | "polyline" | "arc" | "curve" | "rectangle" | "polygon" | "cuboid" | "cylinder" | "sphere" | "wedge" | "opening" | "sweep";
 export type EntityType = ParametricEntityType | "freeform";
 export type EditFamily = "profile" | "curve" | "box" | "radial" | "wedge" | "sweep" | "freeform";
 export type ParametricEditFamily = Exclude<EditFamily, "freeform">;
+/**
+ * Shared placement structure for parametric wrappers.
+ */
 export interface ParametricPlacement {
     translation: Vector3;
     rotation: Vector3;
     scale: Vector3;
 }
+/**
+ * Base capability payload shared by parametric and freeform wrappers.
+ */
 export interface BaseEditCapabilities {
     editingMode: EditingMode;
     entityType: EntityType;
@@ -145,6 +214,9 @@ export interface BaseEditCapabilities {
     canEditPlacement: boolean;
     canConvertToFreeform: boolean;
 }
+/**
+ * Capability payload returned by parametric wrappers such as `Polygon` or `Cuboid`.
+ */
 export interface ParametricEditCapabilities extends BaseEditCapabilities {
     editingMode: "parametric";
     entityType: ParametricEntityType;

package/src/freeform/geometry.d.ts

@@ -1,21 +1,80 @@
 import { OGFreeformGeometry, Vector3 } from "../../opengeometry/pkg/opengeometry.js";
 import type { CreateFreeformGeometryOptions, FreeformSource, ObjectTransformation } from "./types.js";
+/**
+ * Thin client-side wrapper around the kernel `OGFreeformGeometry` object.
+ */
 export declare class FreeformGeometry {
     private readonly geometry;
     constructor(geometry: OGFreeformGeometry);
+    /**
+     * Returns the stable kernel-side id for this freeform geometry object.
+     */
     getId(): string;
+    /**
+     * Returns the world-space serialized BRep payload.
+     */
     getBrepSerialized(): string;
+    /**
+     * Returns the local-space serialized BRep payload.
+     */
     getLocalBrepSerialized(): string;
+    /**
+     * Returns the serialized triangle position buffer emitted by the kernel.
+     */
     getGeometrySerialized(): string;
+    /**
+     * Returns world-space triangle positions as a plain number array.
+     */
+    getGeometryBuffer(): number[];
+    /**
+     * Returns local-space triangle positions as a plain number array.
+     */
+    getLocalGeometryBuffer(): number[];
+    /**
+     * Returns the serialized outline buffer emitted by the kernel.
+     */
     getOutlineGeometrySerialized(): string;
+    /**
+     * Returns world-space outline segment positions as a plain number array.
+     */
+    getOutlineGeometryBuffer(): number[];
+    /**
+     * Returns local-space outline segment positions as a plain number array.
+     */
+    getLocalOutlineGeometryBuffer(): number[];
+    /**
+     * Returns the current normalized placement for this freeform geometry.
+     */
     getPlacement(): ObjectTransformation;
+    /**
+     * Replaces the full placement transform in one call.
+     */
     setPlacement(transform: ObjectTransformation): void;
+    /**
+     * Sets translation, rotation, and scale without changing the current anchor.
+     */
     setTransform(translation: Vector3, rotation: Vector3, scale: Vector3): void;
+    /**
+     * Updates only the translation component of the placement.
+     */
     setTranslation(translation: Vector3): void;
+    /**
+     * Updates only the rotation component of the placement.
+     */
     setRotation(rotation: Vector3): void;
+    /**
+     * Updates only the scale component of the placement.
+     */
     setScale(scale: Vector3): void;
+    /**
+     * Updates the explicit modeling anchor used by downstream transforms.
+     */
     setAnchor(anchor: Vector3): void;
     /** @internal */
     getKernelGeometry(): OGFreeformGeometry;
 }
+/**
+ * Creates a `FreeformGeometry` wrapper from serialized BRep JSON, a parsed
+ * BRep object, or another wrapper exposing BRep accessors.
+ */
 export declare function createFreeformGeometry(source: FreeformSource, options?: CreateFreeformGeometryOptions): FreeformGeometry;

package/src/freeform/index.d.ts

@@ -1,2 +1,5 @@
+/**
+ * Freeform geometry types and helpers for working with raw BRep-backed models.
+ */
 export * from "./types.js";
 export { FreeformGeometry, createFreeformGeometry } from "./geometry.js";

package/src/freeform/types.d.ts

@@ -1,20 +1,32 @@
 import { Vector3 } from "../../opengeometry/pkg/opengeometry.js";
+/**
+ * Placement values accepted when constructing freeform geometry wrappers.
+ */
 export interface FreeformPlacementInput {
     anchor?: Vector3;
     translation: Vector3;
     rotation: Vector3;
     scale: Vector3;
 }
+/**
+ * Fully normalized placement state used by freeform editing APIs.
+ */
 export interface ObjectTransformation {
     anchor: Vector3;
     translation: Vector3;
     rotation: Vector3;
     scale: Vector3;
 }
+/**
+ * Options for building a `FreeformGeometry` wrapper from a BRep-like source.
+ */
 export interface CreateFreeformGeometryOptions {
     id?: string;
     placement?: FreeformPlacementInput | ObjectTransformation;
 }
+/**
+ * Accepted sources for creating a freeform wrapper.
+ */
 export type FreeformSource = string | Record<string, unknown> | {
     getLocalBrepSerialized?: () => string;
     getLocalBrepData?: () => unknown;

package/src/operations/boolean.d.ts

@@ -1,23 +1,38 @@
 import * as THREE from "three";
 import { type CreateFreeformGeometryOptions, type FreeformGeometry } from "../freeform.js";
+/**
+ * Accepted operand formats for boolean helpers.
+ */
 export type BooleanOperand = string | Record<string, unknown> | {
     getBrep?: () => unknown;
     getBrepData?: () => unknown;
     getBrepSerialized?: () => string;
 };
+/**
+ * Kernel-side boolean tuning options.
+ */
 export interface BooleanKernelOptions {
     tolerance?: number;
     mergeCoplanarFaces?: boolean;
 }
+/**
+ * Rendering options applied to the boolean result mesh.
+ */
 export interface BooleanRenderOptions {
     color?: number;
     outline?: boolean;
     fatOutlines?: boolean;
     outlineWidth?: number;
 }
+/**
+ * Combined kernel and rendering options accepted by boolean helpers.
+ */
 export interface BooleanExecutionOptions extends BooleanRenderOptions {
     kernel?: BooleanKernelOptions;
 }
+/**
+ * Structured report returned by the kernel boolean pipeline.
+ */
 export interface BooleanReport {
     operation: string;
     operand_kind: string;
@@ -76,6 +91,9 @@ export declare class BooleanResult extends THREE.Mesh {
 }
 /**
  * Computes a kernel-backed boolean union and returns a renderable result mesh.
+ *
+ * Accepts wrapper objects directly, including `Solid`, `Cuboid`, `Opening`,
+ * and other shapes that expose BRep accessors.
  */
 export declare function booleanUnion(lhs: BooleanOperand, rhs: BooleanOperand, options?: BooleanExecutionOptions): BooleanResult;
 /**
@@ -84,6 +102,16 @@ export declare function booleanUnion(lhs: BooleanOperand, rhs: BooleanOperand, o
 export declare function booleanIntersection(lhs: BooleanOperand, rhs: BooleanOperand, options?: BooleanExecutionOptions): BooleanResult;
 /**
  * Computes a kernel-backed boolean subtraction and returns a renderable result mesh.
+ *
+ * Use this when you want a standalone helper rather than a shape-level
+ * convenience method like `opening.subtractFrom(host)`.
  */
 export declare function booleanSubtraction(lhs: BooleanOperand, rhs: BooleanOperand, options?: BooleanExecutionOptions): BooleanResult;
+/**
+ * Computes a kernel-backed repeated subtraction using a left-to-right cutter array.
+ *
+ * This is used by the shape-level `.subtract([...])` helpers so the heavy
+ * boolean orchestration stays in the Rust/WASM layer instead of JavaScript.
+ */
+export declare function executeBooleanSubtractionMany(lhs: BooleanOperand, cutters: BooleanOperand[], options?: BooleanExecutionOptions): BooleanResult;
 export {};

package/src/operations/extrude.d.ts

@@ -0,0 +1,9 @@
+import type { FreeformSource } from "../freeform.js";
+/**
+ * Sources accepted by the BRep-face extrusion helper.
+ */
+export type ExtrudeBrepSource = FreeformSource;
+/**
+ * Extrudes the first face or wire in a local BRep payload into a closed solid BRep.
+ */
+export declare function extrudeBrepFace(source: ExtrudeBrepSource, height: number): string;

package/src/operations/index.d.ts

@@ -2,3 +2,4 @@
  * Kernel-backed boolean helpers and renderable result mesh.
  */
 export * from "./boolean.js";
+export * from "./extrude.js";

package/src/primitives/arc.d.ts

@@ -1,5 +1,8 @@
 import { Vector3 } from "../../opengeometry/pkg/opengeometry.js";
 import * as THREE from "three";
+/**
+ * Construction options for an arc or full-circle primitive.
+ */
 export interface IArcOptions {
     ogid?: string;
     center: Vector3;
@@ -14,13 +17,25 @@ export interface IArcOptions {
     rotation?: Vector3;
     scale?: Vector3;
 }
+/**
+ * Placement updates accepted by `Arc`.
+ */
 export interface ArcPlacementOptions {
     translation?: Vector3;
     rotation?: Vector3;
     scale?: Vector3;
 }
+/**
+ * Partial config payload accepted by `Arc.setConfig(...)`.
+ */
 export type ArcConfigUpdate = Partial<Omit<IArcOptions, "translation" | "rotation" | "scale">>;
+/**
+ * Alias for `Arc` placement updates.
+ */
 export type ArcPlacementUpdate = ArcPlacementOptions;
+/**
+ * Arc wrapper backed by the kernel OGArc primitive.
+ */
 export declare class Arc extends THREE.Line {
     ogid: string;
     options: IArcOptions;

package/src/primitives/curve.d.ts

@@ -1,5 +1,8 @@
 import * as THREE from "three";
 import { Vector3 } from "../../opengeometry/pkg/opengeometry.js";
+/**
+ * Construction options for a control-point-driven curve.
+ */
 export interface ICurveOptions {
     ogid?: string;
     controlPoints: Vector3[];
@@ -8,18 +11,33 @@ export interface ICurveOptions {
     rotation?: Vector3;
     scale?: Vector3;
 }
+/**
+ * Placement updates accepted by `Curve`.
+ */
 export interface CurvePlacementOptions {
     translation?: Vector3;
     rotation?: Vector3;
     scale?: Vector3;
 }
+/**
+ * Partial config payload accepted by `Curve.setConfig(...)`.
+ */
 export type CurveConfigUpdate = Partial<Omit<ICurveOptions, "translation" | "rotation" | "scale">>;
+/**
+ * Alias for `Curve` placement updates.
+ */
 export type CurvePlacementUpdate = CurvePlacementOptions;
+/**
+ * Offset result returned by `Curve.offset(...)`.
+ */
 export interface ICurveOffsetResult {
     points: Vector3[];
     beveledVertexIndices: number[];
     isClosed: boolean;
 }
+/**
+ * Curve wrapper backed by the kernel OGCurve primitive.
+ */
 export declare class Curve extends THREE.Line {
     ogid: string;
     options: ICurveOptions;

package/src/primitives/line.d.ts

@@ -1,5 +1,8 @@
 import { Vector3 } from "../../opengeometry/pkg/opengeometry.js";
 import * as THREE from "three";
+/**
+ * Construction options for a line segment wrapper.
+ */
 export interface ILineOptions {
     ogid?: string;
     start: Vector3;
@@ -11,13 +14,25 @@ export interface ILineOptions {
     rotation?: Vector3;
     scale?: Vector3;
 }
+/**
+ * Placement updates accepted by `Line`.
+ */
 export interface LinePlacementOptions {
     translation?: Vector3;
     rotation?: Vector3;
     scale?: Vector3;
 }
+/**
+ * Partial config payload accepted by `Line.setConfig(...)`.
+ */
 export type LineConfigUpdate = Partial<Omit<ILineOptions, "translation" | "rotation" | "scale">>;
+/**
+ * Alias for `Line` placement updates.
+ */
 export type LinePlacementUpdate = LinePlacementOptions;
+/**
+ * Offset result returned by `Line.offset(...)`.
+ */
 export interface ILineOffsetResult {
     points: Vector3[];
     beveledVertexIndices: number[];

package/src/primitives/polyline.d.ts

@@ -1,5 +1,8 @@
 import * as THREE from 'three';
 import { Vector3 } from '../../opengeometry/pkg/opengeometry.js';
+/**
+ * Construction options for an ordered polyline wrapper.
+ */
 export interface IPolylineOptions {
     ogid?: string;
     color: number;
@@ -10,18 +13,33 @@ export interface IPolylineOptions {
     rotation?: Vector3;
     scale?: Vector3;
 }
+/**
+ * Placement updates accepted by `Polyline`.
+ */
 export interface PolylinePlacementOptions {
     translation?: Vector3;
     rotation?: Vector3;
     scale?: Vector3;
 }
+/**
+ * Partial config payload accepted by `Polyline.setConfig(...)`.
+ */
 export type PolylineConfigUpdate = Partial<Omit<IPolylineOptions, "translation" | "rotation" | "scale">>;
+/**
+ * Alias for `Polyline` placement updates.
+ */
 export type PolylinePlacementUpdate = PolylinePlacementOptions;
+/**
+ * Offset result returned by `Polyline.offset(...)`.
+ */
 export interface IOffsetResult {
     points: Vector3[];
     beveledVertexIndices: number[];
     isClosed: boolean;
 }
+/**
+ * Polyline wrapper backed by the kernel OGPolyline primitive.
+ */
 export declare class Polyline extends THREE.Line {
     ogid: string;
     options: IPolylineOptions;

package/src/primitives/rectangle.d.ts

@@ -1,5 +1,8 @@
 import { Vector3 } from "../../opengeometry/pkg/opengeometry.js";
 import * as THREE from "three";
+/**
+ * Construction options for a rectangle profile wrapper.
+ */
 export interface IRectangleOptions {
     ogid?: string;
     center: Vector3;
@@ -12,18 +15,33 @@ export interface IRectangleOptions {
     rotation?: Vector3;
     scale?: Vector3;
 }
+/**
+ * Placement updates accepted by `Rectangle`.
+ */
 export interface RectanglePlacementOptions {
     translation?: Vector3;
     rotation?: Vector3;
     scale?: Vector3;
 }
+/**
+ * Partial config payload accepted by `Rectangle.setConfig(...)`.
+ */
 export type RectangleConfigUpdate = Partial<Omit<IRectangleOptions, "translation" | "rotation" | "scale">>;
+/**
+ * Alias for `Rectangle` placement updates.
+ */
 export type RectanglePlacementUpdate = RectanglePlacementOptions;
+/**
+ * Offset result returned by `Rectangle.offset(...)`.
+ */
 export interface IRectangleOffsetResult {
     points: Vector3[];
     beveledVertexIndices: number[];
     isClosed: boolean;
 }
+/**
+ * Rectangle wrapper backed by the kernel OGRectangle primitive.
+ */
 export declare class Rectangle extends THREE.Line {
     ogid: string;
     options: IRectangleOptions;

package/src/shapes/boolean-subtract.d.ts

@@ -1,8 +1,21 @@
 import type { BooleanExecutionOptions, BooleanOperand, BooleanResult } from "../operations/boolean.js";
+/**
+ * Operand types accepted by shape instance `.subtract(...)` helpers.
+ */
 export type ShapeSubtractOperand = BooleanOperand;
+/**
+ * Array-only operand list accepted by shape instance `.subtract(...)` helpers.
+ */
+export type ShapeSubtractOperands = ShapeSubtractOperand[];
+/**
+ * Options accepted by shape instance `.subtract(...)` helpers.
+ */
 export type ShapeSubtractOptions = BooleanExecutionOptions;
+/**
+ * Return type for shape instance `.subtract(...)` helpers.
+ */
 export type ShapeSubtractResult = BooleanResult;
 /**
  * Executes a kernel-backed subtraction for a shape wrapper against another boolean operand.
  */
-export declare function subtractShapeOperand(host: ShapeSubtractOperand, operand: ShapeSubtractOperand, options?: ShapeSubtractOptions): ShapeSubtractResult;
+export declare function subtractShapeOperand(host: ShapeSubtractOperand, operands: ShapeSubtractOperands, options?: ShapeSubtractOptions): ShapeSubtractResult;

package/src/shapes/cuboid.d.ts

@@ -1,12 +1,18 @@
 import { Vector3 } from "../../opengeometry/pkg/opengeometry.js";
 import * as THREE from "three";
 import { ShapeOutlineMesh } from "./outline-utils.js";
-import type { ShapeSubtractOperand, ShapeSubtractOptions, ShapeSubtractResult } from "./boolean-subtract.js";
+import type { ShapeSubtractOperands, ShapeSubtractOptions, ShapeSubtractResult } from "./boolean-subtract.js";
+/**
+ * Placement updates accepted by `Cuboid`.
+ */
 export interface CuboidPlacementOptions {
     translation?: Vector3;
     rotation?: Vector3;
     scale?: Vector3;
 }
+/**
+ * Construction options for a cuboid shape.
+ */
 export interface ICuboidOptions extends CuboidPlacementOptions {
     ogid?: string;
     center: Vector3;
@@ -17,8 +23,17 @@ export interface ICuboidOptions extends CuboidPlacementOptions {
     fatOutlines?: boolean;
     outlineWidth?: number;
 }
+/**
+ * Partial config payload accepted by `Cuboid.setConfig(...)`.
+ */
 export type CuboidConfigUpdate = Partial<Omit<ICuboidOptions, "translation" | "rotation" | "scale">>;
+/**
+ * Alias for `Cuboid` placement updates.
+ */
 export type CuboidPlacementUpdate = CuboidPlacementOptions;
+/**
+ * Box-shaped solid wrapper backed by the kernel cuboid primitive.
+ */
 export declare class Cuboid extends THREE.Mesh {
     #private;
     ogid: string;
@@ -36,9 +51,9 @@ export declare class Cuboid extends THREE.Mesh {
     generateGeometry(): void;
     getBrepData(): any;
     /**
-     * Subtracts another boolean operand, such as an Opening, from this cuboid.
+     * Subtracts one or more boolean operands, such as Opening volumes, from this cuboid.
      */
-    subtract(operand: ShapeSubtractOperand, options?: ShapeSubtractOptions): ShapeSubtractResult;
+    subtract(operands: ShapeSubtractOperands, options?: ShapeSubtractOptions): ShapeSubtractResult;
     set outline(enable: boolean);
     get outline(): boolean;
     set fatOutlines(value: boolean);