opengeometry 2.0.13 → 2.0.15

package/src/shapes/cylinder.d.ts

@@ -1,80 +1,36 @@
 import { Vector3 } from "../../opengeometry/pkg/opengeometry.js";
 import * as THREE from "three";
-import type { ShapeSubtractOperands, ShapeSubtractOptions, ShapeSubtractResult } from "./boolean-subtract.js";
-/**
- * Construction options for a cylinder shape.
- */
+import { AnalyticSolid, type AnalyticAccuracy } from "./analytic-solid.js";
 export interface ICylinderOptions {
+    ogid?: string;
+    center?: Vector3;
+    radius?: number;
+    height?: number;
+    startAngle?: number;
+    sweepAngle?: number;
+    deflection?: number;
+    accuracy?: AnalyticAccuracy;
+    color?: THREE.ColorRepresentation;
+}
+interface NormalizedCylinderOptions {
     ogid?: string;
     center: Vector3;
     radius: number;
     height: number;
-    segments: number;
-    angle: number;
-    color: number;
-    fatOutlines?: boolean;
-    outlineWidth?: number;
-    translation?: Vector3;
-    rotation?: Vector3;
-    scale?: Vector3;
-}
-/**
- * Placement updates accepted by `Cylinder`.
- */
-export interface CylinderPlacementOptions {
-    translation?: Vector3;
-    rotation?: Vector3;
-    scale?: Vector3;
+    startAngle: number;
+    sweepAngle: number;
+    deflection: number;
+    accuracy?: AnalyticAccuracy;
+    color: THREE.ColorRepresentation;
 }
-/**
- * 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;
-    options: ICylinderOptions;
-    private cylinder;
-    private _outlineEnabled;
-    private _fatOutlines;
-    private _outlineWidth;
-    set radius(value: number);
-    set color(color: number);
+/** Authoritative Plane/Cylinder BRep with transient deflection tessellation. */
+export declare class Cylinder extends AnalyticSolid {
+    readonly options: Readonly<NormalizedCylinderOptions>;
     constructor(options?: ICylinderOptions);
-    validateOptions(): void;
-    setConfig(options: CylinderConfigUpdate): void;
-    getConfig(): ICylinderOptions;
-    getAnchor(): Vector3;
-    setPlacement(placement: CylinderPlacementUpdate): 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;
-    getBrep(): any;
-    /**
-     * Subtracts one or more boolean operands, such as Opening volumes, from this cylinder.
-     */
-    subtract(operands: ShapeSubtractOperands, options?: ShapeSubtractOptions): ShapeSubtractResult;
-    set outline(enable: boolean);
-    get outline(): boolean;
-    set fatOutlines(value: boolean);
-    get fatOutlines(): boolean;
-    set outlineWidth(value: number);
-    get outlineWidth(): number;
-    private clearOutlineMesh;
-    discardGeometry(): void;
-    private writePositionsToGeometry;
+    get radius(): number;
+    get height(): number;
+    get startAngle(): number;
+    get sweepAngle(): number;
+    getAnchor(): THREE.Vector3;
 }
+export {};

package/src/shapes/opening.d.ts

@@ -1,94 +1,31 @@
 import { Vector3 } from "../../opengeometry/pkg/opengeometry.js";
 import * as THREE from "three";
-import { ShapeOutlineMesh } from "./outline-utils.js";
-import type { ShapeSubtractOperand, ShapeSubtractOperands, ShapeSubtractOptions, ShapeSubtractResult } from "./boolean-subtract.js";
-/**
- * Construction options for an architectural opening volume.
- */
-export interface IOpeningOptions {
+import { AnalyticSolid, type AnalyticAccuracy } from "./analytic-solid.js";
+import { Cuboid, type CuboidConfigUpdate, type CuboidPlacementOptions } from "./cuboid.js";
+export interface IOpeningOptions extends CuboidPlacementOptions {
     ogid?: string;
-    center: Vector3;
-    width: number;
-    height: number;
-    depth: number;
-    color: number;
-    fatOutlines?: boolean;
-    outlineWidth?: number;
-    translation?: Vector3;
-    rotation?: Vector3;
-    scale?: Vector3;
+    center?: Vector3;
+    width?: number;
+    height?: number;
+    depth?: number;
+    color?: THREE.ColorRepresentation;
+    deflection?: number;
+    accuracy?: AnalyticAccuracy;
 }
-/**
- * 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 OpeningPlacementOptions = CuboidPlacementOptions;
+export type OpeningConfigUpdate = CuboidConfigUpdate;
 export type OpeningPlacementUpdate = OpeningPlacementOptions;
-/**
- * Opening wrapper used as a subtractive solid in architectural workflows.
- */
-export declare class Opening extends THREE.Mesh {
-    #private;
-    ogid: string;
-    options: IOpeningOptions;
-    private opening;
-    private _outlineEnabled;
-    private _fatOutlines;
-    private _outlineWidth;
-    set width(value: number);
-    set height(value: number);
-    set depth(value: number);
+/** Strict BRep v2 subtractive box. */
+export declare class Opening extends Cuboid {
+    constructor(options?: IOpeningOptions);
     get dimensions(): {
         width: number;
         height: number;
         depth: number;
     };
-    constructor(options?: IOpeningOptions);
-    validateOptions(): void;
-    setConfig(options: OpeningConfigUpdate): void;
-    getConfig(): IOpeningOptions;
-    getAnchor(): Vector3;
-    setPlacement(placement: OpeningPlacementUpdate): 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;
-    /**
-     * Subtracts one or more boolean operands from this opening volume.
-     */
-    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);
-    get outline(): boolean;
-    set fatOutlines(value: boolean);
-    get fatOutlines(): boolean;
-    set outlineWidth(value: number);
-    get outlineWidth(): number;
-    get outlineMesh(): ShapeOutlineMesh | null;
-    private clearOutlineMesh;
-    discardGeometry(): void;
-    private writePositionsToGeometry;
+    subtractFrom(host: AnalyticSolid, options?: {
+        deflection?: number;
+        color?: THREE.ColorRepresentation;
+    }): AnalyticSolid;
 }

package/src/shapes/polygon.d.ts

@@ -1,7 +1,7 @@
 import * as THREE from "three";
 import { OGPolygon, Vector3 } from "../../opengeometry/pkg/opengeometry.js";
 import { Solid } from "./solid.js";
-import type { ShapeSubtractOperands, ShapeSubtractOptions, ShapeSubtractResult } from "./boolean-subtract.js";
+import { type PolygonLoftOptions } from "../operations/loft.js";
 /**
  * Construction options for a planar polygon.
  */
@@ -79,14 +79,13 @@ export declare class Polygon extends THREE.Mesh {
      * starts from a planar profile and needs a boolean-ready solid.
      */
     extrude(height: number): Solid;
+    /** Builds a capped analytic ruled loft from this profile to `other`. */
+    loftTo(other: Polygon, options?: PolygonLoftOptions): import("./analytic-solid.js").AnalyticSolid;
     /**
      * Returns the serialized BRep payload for this polygon.
      */
     getBrepData(): string | null;
-    /**
-     * Subtracts one or more boolean operands from this polygon.
-     */
-    subtract(operands: ShapeSubtractOperands, options?: ShapeSubtractOptions): ShapeSubtractResult;
+    private worldProfilePoints;
     set outlineColor(color: number);
     get outlineColor(): number;
     set outline(enable: boolean);

package/src/shapes/solid.d.ts

@@ -2,7 +2,6 @@ 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.
  */
@@ -91,13 +90,6 @@ export declare class Solid extends THREE.Mesh {
      * 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.
      */

package/src/shapes/sphere.d.ts

@@ -1,82 +1,27 @@
-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 { ShapeSubtractOperands, ShapeSubtractOptions, ShapeSubtractResult } from "./boolean-subtract.js";
-/**
- * Construction options for a sphere shape.
- */
+import { AnalyticSolid, type AnalyticAccuracy } from "./analytic-solid.js";
 export interface ISphereOptions {
+    ogid?: string;
+    center?: Vector3;
+    radius?: number;
+    deflection?: number;
+    accuracy?: AnalyticAccuracy;
+    color?: THREE.ColorRepresentation;
+}
+interface NormalizedSphereOptions {
     ogid?: string;
     center: Vector3;
     radius: number;
-    widthSegments: number;
-    heightSegments: number;
-    color: number;
-    fatOutlines?: boolean;
-    outlineWidth?: number;
-    translation?: Vector3;
-    rotation?: Vector3;
-    scale?: Vector3;
-}
-/**
- * Placement updates accepted by `Sphere`.
- */
-export interface SpherePlacementOptions {
-    translation?: Vector3;
-    rotation?: Vector3;
-    scale?: Vector3;
+    deflection: number;
+    accuracy?: AnalyticAccuracy;
+    color: THREE.ColorRepresentation;
 }
-/**
- * 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;
-    options: ISphereOptions;
-    private sphere;
-    private _outlineEnabled;
-    private _fatOutlines;
-    private _outlineWidth;
-    set radius(value: number);
-    set color(color: number);
+/** Authoritative spherical BRep with explicit poles and transient deflection tessellation. */
+export declare class Sphere extends AnalyticSolid {
+    readonly options: Readonly<NormalizedSphereOptions>;
     constructor(options?: ISphereOptions);
-    validateOptions(): void;
-    setConfig(options: SphereConfigUpdate): void;
-    getConfig(): ISphereOptions;
-    getAnchor(): OGKernel.Vector3;
-    setPlacement(placement: SpherePlacementUpdate): 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;
-    getBrep(): any;
-    /**
-     * Subtracts one or more boolean operands, such as Opening volumes, from this sphere.
-     */
-    subtract(operands: ShapeSubtractOperands, options?: ShapeSubtractOptions): ShapeSubtractResult;
-    set outline(enable: boolean);
-    get outline(): boolean;
-    set fatOutlines(value: boolean);
-    get fatOutlines(): boolean;
-    set outlineWidth(value: number);
-    get outlineWidth(): number;
-    get outlineMesh(): ShapeOutlineMesh | null;
-    private clearOutlineMesh;
-    discardGeometry(): void;
-    private writePositionsToGeometry;
+    get radius(): number;
+    getAnchor(): THREE.Vector3;
 }
+export {};

package/src/shapes/sweep.d.ts

@@ -1,7 +1,6 @@
 import * as OGKernel from "../../opengeometry/pkg/opengeometry.js";
 import { Vector3 } from "../../opengeometry/pkg/opengeometry.js";
 import * as THREE from "three";
-import type { ShapeSubtractOperands, ShapeSubtractOptions, ShapeSubtractResult } from "./boolean-subtract.js";
 /**
  * Construction options for a swept solid.
  */
@@ -65,10 +64,6 @@ export declare class Sweep extends THREE.Mesh {
     cleanGeometry(): void;
     generateGeometry(): void;
     getBrep(): any;
-    /**
-     * Subtracts one or more boolean operands, such as Opening volumes, from this sweep.
-     */
-    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,6 @@
 import { Vector3 } from "../../opengeometry/pkg/opengeometry.js";
 import * as THREE from "three";
 import { ShapeOutlineMesh } from "./outline-utils.js";
-import type { ShapeSubtractOperands, ShapeSubtractOptions, ShapeSubtractResult } from "./boolean-subtract.js";
 /**
  * Construction options for a wedge/prism shape.
  */
@@ -63,10 +62,6 @@ export declare class Wedge extends THREE.Mesh {
     cleanGeometry(): void;
     generateGeometry(): void;
     getBrepData(): any;
-    /**
-     * Subtracts one or more boolean operands, such as Opening volumes, from this wedge.
-     */
-    subtract(operands: ShapeSubtractOperands, options?: ShapeSubtractOptions): ShapeSubtractResult;
     set outline(enable: boolean);
     get outline(): boolean;
     set fatOutlines(value: boolean);

package/src/examples/wall-from-offsets.d.ts

@@ -1,40 +0,0 @@
-import * as THREE from "three";
-import { Cuboid } from "../shapes/cuboid.js";
-import { Polyline } from "../primitives/polyline.js";
-import { Polygon } from "../shapes/polygon.js";
-export interface WallFromOffsetsOptions {
-    /**
-     * Number of doors to subtract from the extruded wall. Doors are placed at
-     * evenly distributed centerline-segment midpoints. Default `0` (no cuts).
-     */
-    doorCount?: number;
-    /**
-     * Cutter overshoot in millimeters. The debt sheet's `#6a` symptom is at
-     * 1mm; default 1mm so callers exercise the snap-tolerance regime by default
-     * when cuts are enabled.
-     */
-    overshootMm?: number;
-    /**
-     * Wall extrusion height in meters. Default `2.6` to match the example HTML.
-     */
-    height?: number;
-}
-/**
- * Renders a human-readable description for a typed `BooleanError` (or any
- * other thrown value). Used by the example HTML to surface kernel failures
- * in a status panel without losing the structured payload.
- */
-export declare function describeWallSubtractError(error: unknown): string;
-export declare function createWallFromOffsetsExample(scene: THREE.Scene, options?: WallFromOffsetsOptions): {
-    centerline: Polyline;
-    leftOffsetPolyline: Polyline;
-    rightOffsetPolyline: Polyline;
-    wallPolygon: Polygon;
-    leftOffset: import("../primitives/polyline.js").IOffsetResult;
-    rightOffset: import("../primitives/polyline.js").IOffsetResult;
-    cutResult: {
-        wall: THREE.Object3D;
-        cutters: Cuboid[];
-    } | null;
-    cutError: unknown;
-};

package/src/operations/boolean-errors.d.ts

@@ -1,90 +0,0 @@
-/**
- * Typed error hierarchy for boolean operations.
- *
- * The Rust kernel emits a structured `BooleanError` as JSON across the WASM
- * boundary (see `main/opengeometry/src/booleans/error.rs`). This module parses
- * that JSON and re-throws it as a typed `BooleanError` (or a more specific
- * subclass) so app code can `instanceof`-discriminate without parsing message
- * strings.
- *
- * Cutter indices are **0-based** to match `Vec` / array indexing on both
- * sides of the boundary.
- */
-import * as THREE from "three";
-export type BooleanErrorPhase = "input_validation" | "union_pre_pass" | "subtract_step" | "output_validation";
-export type BooleanErrorReason = "invalid_operand" | "malformed_input" | "mixed_operand_kinds" | "unsupported_operand_kind" | "non_coplanar_planar_operands" | "topology_error" | "kernel_failure" | "non_manifold_edges" | "open_shell" | "coincident_faces" | "degenerate_triangle" | "empty_result" | "overlapping_cutters" | "cutter_exceeds_host";
-interface KindPayload {
-    code: BooleanErrorReason;
-    other_index?: number;
-    axis?: string;
-    overshoot?: number;
-}
-interface BooleanErrorJson {
-    kind: KindPayload;
-    phase: BooleanErrorPhase;
-    cutter_index: number | null;
-    message: string;
-    details: string | null;
-    edge_samples: Array<[{
-        x: number;
-        y: number;
-        z: number;
-    }, {
-        x: number;
-        y: number;
-        z: number;
-    }]> | null;
-}
-/**
- * Base class for every typed boolean error. Carries the structured payload the
- * kernel emitted across WASM. Specialized subclasses (`OverlappingCuttersError`,
- * `CutterExceedsHostError`, `NonManifoldOutputError`, `CoincidentFacesError`)
- * narrow the payload for the variants that carry extra fields.
- */
-export declare class BooleanError extends Error {
-    readonly reason: BooleanErrorReason;
-    readonly phase: BooleanErrorPhase;
-    readonly cutterIndex: number | null;
-    readonly details: string | null;
-    readonly edgeSamples: ReadonlyArray<[THREE.Vector3, THREE.Vector3]> | null;
-    constructor(payload: BooleanErrorJson);
-}
-/**
- * Two cutters overlap each other. `otherIndex` is the 0-based index of the
- * cutter that conflicts with the one at `cutterIndex`.
- */
-export declare class OverlappingCuttersError extends BooleanError {
-    readonly otherIndex: number;
-    constructor(payload: BooleanErrorJson);
-}
-/**
- * A cutter extends past the host's hull along the named axis.
- */
-export declare class CutterExceedsHostError extends BooleanError {
-    readonly axis: "x" | "y" | "z";
-    readonly overshoot: number;
-    constructor(payload: BooleanErrorJson);
-}
-/**
- * Output mesh has open or over-shared edges after a boolean. `edgeSamples`
- * carries up to ~8 sample non-manifold edges to aid app-side debugging.
- */
-export declare class NonManifoldOutputError extends BooleanError {
-    constructor(payload: BooleanErrorJson);
-}
-/**
- * Cutter and host share a coplanar face. Distinct from
- * `DegenerateTriangleError` (zero-area input) — see `06a-snap-tolerance.md`.
- */
-export declare class CoincidentFacesError extends BooleanError {
-    constructor(payload: BooleanErrorJson);
-}
-/**
- * Parses a WASM-thrown error and returns the appropriate typed `BooleanError`
- * subclass. If the error's message is not valid `BooleanError` JSON, returns a
- * fallback `BooleanError` with `reason: "kernel_failure"` carrying the original
- * string, so callers always get a typed error and never have to `try/catch`
- * twice.
- */
-export declare function parseBooleanError(raw: unknown): BooleanError;
-export {};

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

@@ -1,21 +0,0 @@
-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, operands: ShapeSubtractOperands, options?: ShapeSubtractOptions): ShapeSubtractResult;