opengeometry 2.0.2 → 2.0.4

package/src/shapes/cylinder.d.ts

@@ -1,6 +1,9 @@
 import { Vector3 } from "../../opengeometry/pkg/opengeometry.js";
 import * as THREE from "three";
-import type { ShapeSubtractOperand, ShapeSubtractOptions, ShapeSubtractResult } from "./boolean-subtract.js";
+import type { ShapeSubtractOperands, ShapeSubtractOptions, ShapeSubtractResult } from "./boolean-subtract.js";
+/**
+ * Construction options for a cylinder shape.
+ */
 export interface ICylinderOptions {
     ogid?: string;
     center: Vector3;
@@ -15,13 +18,25 @@ export interface ICylinderOptions {
     rotation?: Vector3;
     scale?: Vector3;
 }
+/**
+ * Placement updates accepted by `Cylinder`.
+ */
 export interface CylinderPlacementOptions {
     translation?: Vector3;
     rotation?: Vector3;
     scale?: Vector3;
 }
+/**
+ * Partial config payload accepted by `Cylinder.setConfig(...)`.
+ */
 export type CylinderConfigUpdate = Partial<Omit<ICylinderOptions, "translation" | "rotation" | "scale">>;
+/**
+ * Alias for `Cylinder` placement updates.
+ */
 export type CylinderPlacementUpdate = CylinderPlacementOptions;
+/**
+ * Cylinder wrapper backed by the kernel cylindrical primitive.
+ */
 export declare class Cylinder extends THREE.Mesh {
     #private;
     ogid: string;
@@ -50,9 +65,9 @@ export declare class Cylinder extends THREE.Mesh {
     generateGeometry(): void;
     getBrep(): any;
     /**
-     * Subtracts another boolean operand, such as an Opening, from this cylinder.
+     * Subtracts one or more boolean operands, such as Opening volumes, from this cylinder.
      */
-    subtract(operand: ShapeSubtractOperand, options?: ShapeSubtractOptions): ShapeSubtractResult;
+    subtract(operands: ShapeSubtractOperands, options?: ShapeSubtractOptions): ShapeSubtractResult;
     set outline(enable: boolean);
     get outline(): boolean;
     set fatOutlines(value: boolean);

package/src/shapes/extrusion.d.ts

@@ -0,0 +1,64 @@
+import { Vector3 } from "../../opengeometry/pkg/opengeometry.js";
+import * as THREE from "three";
+import type { ShapeSubtractOperand, ShapeSubtractOptions, ShapeSubtractResult } from "./boolean-subtract.js";
+export interface IExtrusionOptions {
+    ogid?: string;
+    vertices: Vector3[];
+    holes?: Vector3[][];
+    height: number;
+    color: number;
+    fatOutlines?: boolean;
+    outlineWidth?: number;
+    translation?: Vector3;
+    rotation?: Vector3;
+    scale?: Vector3;
+}
+export interface ExtrusionPlacementOptions {
+    translation?: Vector3;
+    rotation?: Vector3;
+    scale?: Vector3;
+}
+export type ExtrusionConfigUpdate = Partial<Omit<IExtrusionOptions, "translation" | "rotation" | "scale">>;
+export type ExtrusionPlacementUpdate = ExtrusionPlacementOptions;
+export declare class Extrusion extends THREE.Mesh {
+    #private;
+    ogid: string;
+    options: IExtrusionOptions;
+    private extrusion;
+    private _outlineEnabled;
+    private _fatOutlines;
+    private _outlineWidth;
+    private _outlineColor;
+    set color(color: number);
+    constructor(options?: IExtrusionOptions);
+    validateOptions(): void;
+    setConfig(options: ExtrusionConfigUpdate): void;
+    getConfig(): IExtrusionOptions;
+    getAnchor(): Vector3;
+    setAnchor(anchor: Vector3): void;
+    resetAnchor(): void;
+    setPlacement(placement: ExtrusionPlacementUpdate): void;
+    setTransform(translation: Vector3, rotation: Vector3, scale: Vector3): void;
+    setTranslation(translation: Vector3): void;
+    setRotation(rotation: Vector3): void;
+    setScale(scale: Vector3): void;
+    getPlacement(): import("../editor.js").ParametricPlacement;
+    getEditCapabilities(): import("../editor.js").ParametricEditCapabilities;
+    canConvertToFreeform(): boolean;
+    toFreeform(id?: string): import("../freeform.js").FreeformGeometry;
+    cleanGeometry(): void;
+    generateGeometry(): void;
+    getBrepData(): any;
+    subtract(operand: ShapeSubtractOperand, options?: ShapeSubtractOptions): ShapeSubtractResult;
+    set outlineColor(color: number);
+    get outlineColor(): number;
+    set outline(enable: boolean);
+    get outline(): boolean;
+    set fatOutlines(value: boolean);
+    get fatOutlines(): boolean;
+    set outlineWidth(value: number);
+    get outlineWidth(): number;
+    clearOutlineMesh(): void;
+    discardGeometry(): void;
+    private writePositionsToGeometry;
+}

package/src/shapes/index.d.ts

@@ -2,6 +2,7 @@
  * High-level 3D shape wrappers backed by the OpenGeometry kernel.
  */
 export * from './polygon.js';
+export * from './solid.js';
 export * from './cylinder.js';
 export * from './cuboid.js';
 export * from './opening.js';

package/src/shapes/opening.d.ts

@@ -1,7 +1,10 @@
 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 { ShapeSubtractOperand, ShapeSubtractOperands, ShapeSubtractOptions, ShapeSubtractResult } from "./boolean-subtract.js";
+/**
+ * Construction options for an architectural opening volume.
+ */
 export interface IOpeningOptions {
     ogid?: string;
     center: Vector3;
@@ -15,13 +18,25 @@ export interface IOpeningOptions {
     rotation?: Vector3;
     scale?: Vector3;
 }
+/**
+ * Placement updates accepted by `Opening`.
+ */
 export interface OpeningPlacementOptions {
     translation?: Vector3;
     rotation?: Vector3;
     scale?: Vector3;
 }
+/**
+ * Partial config payload accepted by `Opening.setConfig(...)`.
+ */
 export type OpeningConfigUpdate = Partial<Omit<IOpeningOptions, "translation" | "rotation" | "scale">>;
+/**
+ * Alias for `Opening` placement updates.
+ */
 export type OpeningPlacementUpdate = OpeningPlacementOptions;
+/**
+ * Opening wrapper used as a subtractive solid in architectural workflows.
+ */
 export declare class Opening extends THREE.Mesh {
     #private;
     ogid: string;
@@ -56,11 +71,14 @@ export declare class Opening extends THREE.Mesh {
     generateGeometry(): void;
     getBrepData(): any;
     /**
-     * Subtracts another boolean operand from this opening volume.
+     * Subtracts one or more boolean operands from this opening volume.
      */
-    subtract(operand: ShapeSubtractOperand, options?: ShapeSubtractOptions): ShapeSubtractResult;
+    subtract(operands: ShapeSubtractOperands, options?: ShapeSubtractOptions): ShapeSubtractResult;
     /**
      * Uses this opening volume to cut a host shape.
+     *
+     * Prefer this helper for wall, slab, and other host-cutting workflows in
+     * browser-based AEC/BIM tools.
      */
     subtractFrom(host: ShapeSubtractOperand, options?: ShapeSubtractOptions): ShapeSubtractResult;
     set outline(enable: boolean);

package/src/shapes/outline-utils.d.ts

@@ -1,14 +1,35 @@
 import * as THREE from "three";
 import { LineSegments2 } from "three/examples/jsm/lines/LineSegments2.js";
+/**
+ * Outline mesh variants used by shape wrappers.
+ */
 export type ShapeOutlineMesh = THREE.LineSegments | LineSegments2;
+/**
+ * Options for building a shape outline mesh.
+ */
 export interface ShapeOutlineMeshOptions {
     positions: number[];
     color?: number;
     fatOutlines?: boolean;
     outlineWidth?: number;
 }
+/**
+ * Clamps outline width inputs to the supported positive finite range.
+ */
 export declare function sanitizeOutlineWidth(width?: number): number;
+/**
+ * Creates either a thin or fat outline mesh from line segment positions.
+ */
 export declare function createShapeOutlineMesh({ positions, color, fatOutlines, outlineWidth, }: ShapeOutlineMeshOptions): ShapeOutlineMesh;
+/**
+ * Disposes the geometry and material owned by an outline mesh.
+ */
 export declare function disposeShapeOutlineMesh(mesh: ShapeOutlineMesh | null): void;
+/**
+ * Updates the color of an existing outline mesh in place.
+ */
 export declare function setShapeOutlineColor(mesh: ShapeOutlineMesh | null, color: number): void;
+/**
+ * Reads the current outline color, falling back when no outline exists.
+ */
 export declare function getShapeOutlineColor(mesh: ShapeOutlineMesh | null, fallback?: number): number;

package/src/shapes/polygon.d.ts

@@ -1,6 +1,10 @@
 import * as THREE from "three";
 import { OGPolygon, Vector3 } from "../../opengeometry/pkg/opengeometry.js";
-import type { ShapeSubtractOperand, ShapeSubtractOptions, ShapeSubtractResult } from "./boolean-subtract.js";
+import { Solid } from "./solid.js";
+import type { ShapeSubtractOperands, ShapeSubtractOptions, ShapeSubtractResult } from "./boolean-subtract.js";
+/**
+ * Construction options for a planar polygon.
+ */
 export interface IPolygonOptions {
     ogid?: string;
     vertices: Vector3[];
@@ -17,8 +21,17 @@ export interface PolygonPlacementOptions {
     rotation?: Vector3;
     scale?: Vector3;
 }
+/**
+ * Partial polygon config updates that regenerate the profile when geometry changes.
+ */
 export type PolygonConfigUpdate = Partial<Omit<IPolygonOptions, "translation" | "rotation" | "scale">>;
+/**
+ * Placement updates accepted by `Polygon`.
+ */
 export type PolygonPlacementUpdate = PolygonPlacementOptions;
+/**
+ * Planar polygon mesh with support for holes, booleans, and extrusion to `Solid`.
+ */
 export declare class Polygon extends THREE.Mesh {
     #private;
     ogid: string;
@@ -28,10 +41,8 @@ export declare class Polygon extends THREE.Mesh {
     private _fatOutlines;
     private _outlineWidth;
     private _outlineColor;
-    transformationMatrix: THREE.Matrix4;
     set color(color: number);
     get color(): number;
-    private _geometryCenterOffset;
     constructor(options?: IPolygonOptions);
     validateOptions(): void;
     setConfig(options: PolygonConfigUpdate): void;
@@ -45,19 +56,37 @@ export declare class Polygon extends THREE.Mesh {
     setRotation(rotation: Vector3): void;
     setScale(scale: Vector3): void;
     getPlacement(): import("../editor.js").ParametricPlacement;
+    /**
+     * Returns the editing capability payload advertised by parametric wrappers.
+     */
     getEditCapabilities(): import("../editor.js").ParametricEditCapabilities;
+    /**
+     * Polygon always supports conversion into the freeform editing wrapper.
+     */
     canConvertToFreeform(): boolean;
+    /**
+     * Returns a freeform wrapper for direct BRep editing of this polygon.
+     */
     toFreeform(id?: string): import("../freeform.js").FreeformGeometry;
     cleanGeometry(): void;
     generateGeometry(): void;
     addVertices(vertices: Vector3[]): void;
-    saveTransformationToBREP(): void;
     addHole(holeVertices: Vector3[]): void;
+    /**
+     * Builds a kernel-backed `Solid` by extruding this polygon face by `height`.
+     *
+     * This is the recommended public path when a browser CAD or AEC workflow
+     * starts from a planar profile and needs a boolean-ready solid.
+     */
+    extrude(height: number): Solid;
+    /**
+     * Returns the serialized BRep payload for this polygon.
+     */
     getBrepData(): string | null;
     /**
-     * Subtracts another boolean operand from this polygon.
+     * Subtracts one or more boolean operands from this polygon.
      */
-    subtract(operand: ShapeSubtractOperand, options?: ShapeSubtractOptions): ShapeSubtractResult;
+    subtract(operands: ShapeSubtractOperands, options?: ShapeSubtractOptions): ShapeSubtractResult;
     set outlineColor(color: number);
     get outlineColor(): number;
     set outline(enable: boolean);
@@ -70,4 +99,5 @@ export declare class Polygon extends THREE.Mesh {
     private clearOutlineMesh;
     dispose(): void;
     private writePositionsToGeometry;
+    private disposeResources;
 }

package/src/shapes/solid.d.ts

@@ -0,0 +1,116 @@
+import { Vector3 } from "../../opengeometry/pkg/opengeometry.js";
+import * as THREE from "three";
+import { type FreeformGeometry } from "../freeform.js";
+import type { FreeformSource } from "../freeform/types.js";
+import type { ShapeSubtractOperands, ShapeSubtractOptions, ShapeSubtractResult } from "./boolean-subtract.js";
+/**
+ * Construction options for a generic BRep-backed solid.
+ */
+export interface ISolidOptions {
+    ogid?: string;
+    brep: FreeformSource;
+    color: number;
+    fatOutlines?: boolean;
+    outlineWidth?: number;
+    anchor?: Vector3;
+    translation?: Vector3;
+    rotation?: Vector3;
+    scale?: Vector3;
+}
+/**
+ * Placement updates accepted by `Solid`.
+ */
+export interface SolidPlacementOptions {
+    translation?: Vector3;
+    rotation?: Vector3;
+    scale?: Vector3;
+}
+/**
+ * Additional options accepted when creating a `Solid` through face extrusion.
+ */
+export interface ExtrudeSolidOptions extends Omit<ISolidOptions, "brep" | "ogid" | "anchor" | "translation" | "rotation" | "scale"> {
+    ogid?: string;
+    anchor?: Vector3;
+    translation?: Vector3;
+    rotation?: Vector3;
+    scale?: Vector3;
+}
+/**
+ * Generic renderable BRep-backed solid used for extrusion outputs and other
+ * kernel results that are not dedicated parametric shapes.
+ */
+export declare class Solid extends THREE.Mesh {
+    #private;
+    ogid: string;
+    options: ISolidOptions;
+    private solid;
+    private _outlineEnabled;
+    private _fatOutlines;
+    private _outlineWidth;
+    private _outlineColor;
+    set color(color: number);
+    get color(): number;
+    constructor(options: ISolidOptions);
+    /**
+     * Extrudes a face-like BRep source and wraps the result as a renderable solid.
+     *
+     * Prefer `polygon.extrude(height)` when the source is already a `Polygon`.
+     */
+    static extrude(source: FreeformSource, height: number, options: ExtrudeSolidOptions): Solid;
+    /**
+     * Returns the current placement values as cloned vectors.
+     */
+    getPlacement(): import("../editor.js").ParametricPlacement;
+    /**
+     * Applies translation, rotation, and scale updates to the wrapped BRep.
+     */
+    setPlacement(placement: SolidPlacementOptions): void;
+    setTransform(translation: Vector3, rotation: Vector3, scale: Vector3): void;
+    setTranslation(translation: Vector3): void;
+    setRotation(rotation: Vector3): void;
+    setScale(scale: Vector3): void;
+    getAnchor(): Vector3;
+    setAnchor(anchor: Vector3): void;
+    /**
+     * Solid is always convertible back to the freeform editing wrapper.
+     */
+    canConvertToFreeform(): boolean;
+    /**
+     * Returns a freeform wrapper for direct editing of this solid's BRep.
+     */
+    toFreeform(id?: string): FreeformGeometry;
+    /**
+     * Returns the world-space serialized BRep payload for this solid.
+     */
+    getBrepSerialized(): string;
+    /**
+     * Returns the local-space serialized BRep payload for this solid.
+     */
+    getLocalBrepSerialized(): string;
+    /**
+     * Returns the parsed world-space BRep object for this solid.
+     */
+    getBrepData(): any;
+    /**
+     * Subtracts one or more boolean operands from this solid.
+     *
+     * This is the main shape-level boolean workflow after operations like
+     * `polygon.extrude(height)` or `Solid.extrude(...)`.
+     */
+    subtract(operands: ShapeSubtractOperands, options?: ShapeSubtractOptions): ShapeSubtractResult;
+    /**
+     * Rebuilds the visible mesh and outline from the current freeform geometry.
+     */
+    generateGeometry(): void;
+    set outlineColor(color: number);
+    get outlineColor(): number;
+    set outline(enable: boolean);
+    get outline(): boolean;
+    set fatOutlines(value: boolean);
+    get fatOutlines(): boolean;
+    set outlineWidth(value: number);
+    get outlineWidth(): number;
+    clearOutlineMesh(): void;
+    private getPlacementTransform;
+    private writePositionsToGeometry;
+}

package/src/shapes/sphere.d.ts

@@ -2,7 +2,10 @@ import * as OGKernel from "../../opengeometry/pkg/opengeometry.js";
 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";
+/**
+ * Construction options for a sphere shape.
+ */
 export interface ISphereOptions {
     ogid?: string;
     center: Vector3;
@@ -16,13 +19,25 @@ export interface ISphereOptions {
     rotation?: Vector3;
     scale?: Vector3;
 }
+/**
+ * Placement updates accepted by `Sphere`.
+ */
 export interface SpherePlacementOptions {
     translation?: Vector3;
     rotation?: Vector3;
     scale?: Vector3;
 }
+/**
+ * Partial config payload accepted by `Sphere.setConfig(...)`.
+ */
 export type SphereConfigUpdate = Partial<Omit<ISphereOptions, "translation" | "rotation" | "scale">>;
+/**
+ * Alias for `Sphere` placement updates.
+ */
 export type SpherePlacementUpdate = SpherePlacementOptions;
+/**
+ * Sphere wrapper backed by the kernel sphere primitive.
+ */
 export declare class Sphere extends THREE.Mesh {
     #private;
     ogid: string;
@@ -51,9 +66,9 @@ export declare class Sphere extends THREE.Mesh {
     generateGeometry(): void;
     getBrep(): any;
     /**
-     * Subtracts another boolean operand, such as an Opening, from this sphere.
+     * Subtracts one or more boolean operands, such as Opening volumes, from this sphere.
      */
-    subtract(operand: ShapeSubtractOperand, options?: ShapeSubtractOptions): ShapeSubtractResult;
+    subtract(operands: ShapeSubtractOperands, options?: ShapeSubtractOptions): ShapeSubtractResult;
     set outline(enable: boolean);
     get outline(): boolean;
     set fatOutlines(value: boolean);

package/src/shapes/sweep.d.ts

@@ -1,7 +1,10 @@
 import * as OGKernel from "../../opengeometry/pkg/opengeometry.js";
 import { Vector3 } from "../../opengeometry/pkg/opengeometry.js";
 import * as THREE from "three";
-import type { ShapeSubtractOperand, ShapeSubtractOptions, ShapeSubtractResult } from "./boolean-subtract.js";
+import type { ShapeSubtractOperands, ShapeSubtractOptions, ShapeSubtractResult } from "./boolean-subtract.js";
+/**
+ * Construction options for a swept solid.
+ */
 export interface ISweepOptions {
     ogid?: string;
     path: Vector3[];
@@ -15,13 +18,25 @@ export interface ISweepOptions {
     rotation?: Vector3;
     scale?: Vector3;
 }
+/**
+ * Placement updates accepted by `Sweep`.
+ */
 export interface SweepPlacementOptions {
     translation?: Vector3;
     rotation?: Vector3;
     scale?: Vector3;
 }
+/**
+ * Partial config payload accepted by `Sweep.setConfig(...)`.
+ */
 export type SweepConfigUpdate = Partial<Omit<ISweepOptions, "translation" | "rotation" | "scale">>;
+/**
+ * Alias for `Sweep` placement updates.
+ */
 export type SweepPlacementUpdate = SweepPlacementOptions;
+/**
+ * Sweep wrapper backed by the kernel sweep primitive.
+ */
 export declare class Sweep extends THREE.Mesh {
     #private;
     ogid: string;
@@ -51,9 +66,9 @@ export declare class Sweep extends THREE.Mesh {
     generateGeometry(): void;
     getBrep(): any;
     /**
-     * Subtracts another boolean operand, such as an Opening, from this sweep.
+     * Subtracts one or more boolean operands, such as Opening volumes, from this sweep.
      */
-    subtract(operand: ShapeSubtractOperand, options?: ShapeSubtractOptions): ShapeSubtractResult;
+    subtract(operands: ShapeSubtractOperands, options?: ShapeSubtractOptions): ShapeSubtractResult;
     set outline(enable: boolean);
     get outline(): boolean;
     set fatOutlines(value: boolean);

package/src/shapes/wedge.d.ts

@@ -1,7 +1,10 @@
 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";
+/**
+ * Construction options for a wedge/prism shape.
+ */
 export interface IWedgeOptions {
     ogid?: string;
     center: Vector3;
@@ -15,13 +18,25 @@ export interface IWedgeOptions {
     rotation?: Vector3;
     scale?: Vector3;
 }
+/**
+ * Placement updates accepted by `Wedge`.
+ */
 export interface WedgePlacementOptions {
     translation?: Vector3;
     rotation?: Vector3;
     scale?: Vector3;
 }
+/**
+ * Partial config payload accepted by `Wedge.setConfig(...)`.
+ */
 export type WedgeConfigUpdate = Partial<Omit<IWedgeOptions, "translation" | "rotation" | "scale">>;
+/**
+ * Alias for `Wedge` placement updates.
+ */
 export type WedgePlacementUpdate = WedgePlacementOptions;
+/**
+ * Wedge wrapper backed by the kernel wedge primitive.
+ */
 export declare class Wedge extends THREE.Mesh {
     #private;
     ogid: string;
@@ -49,9 +64,9 @@ export declare class Wedge extends THREE.Mesh {
     generateGeometry(): void;
     getBrepData(): any;
     /**
-     * Subtracts another boolean operand, such as an Opening, from this wedge.
+     * Subtracts one or more boolean operands, such as Opening volumes, from this wedge.
      */
-    subtract(operand: ShapeSubtractOperand, options?: ShapeSubtractOptions): ShapeSubtractResult;
+    subtract(operands: ShapeSubtractOperands, options?: ShapeSubtractOptions): ShapeSubtractResult;
     set outline(enable: boolean);
     get outline(): boolean;
     set fatOutlines(value: boolean);