opengeometry 2.0.9 → 2.0.11

package/src/operations/offset-regions.d.ts

@@ -0,0 +1,41 @@
+/** A point of a returned offset region ring (kernel `Vector3` shape). */
+export interface OffsetRegionPoint {
+    x: number;
+    y: number;
+    z: number;
+}
+/** One offset region: a CW outer ring + its CCW inner-void hole rings. */
+export interface OffsetRegion {
+    /** Outer ring (CW, canonical start). */
+    outer: OffsetRegionPoint[];
+    /** Inner-void hole rings (CCW), e.g. the interior void of a closed loop. */
+    holes: OffsetRegionPoint[][];
+}
+/**
+ * Offset a centreline by ±half-width into one or more filled REGIONS, via the
+ * deterministic analytic offset — miters / flat bevels at `miterLimit`, concave
+ * trims, and nonzero-winding resolution of reflex / closed loops. NO boolean union
+ * (so it is deterministic, unlike the 3D-mesh CSG path). A simple centreline returns
+ * one region; a self-crossing closed centreline (e.g. a figure-8) returns one per
+ * simple sub-loop. Returns an EMPTY array for a genuinely unbuildable input (does
+ * not throw, so it never looks like a kernel crash). Rings are CW-outer / CCW-holes.
+ *
+ * @param centrelineFlat centreline points as `[x,y,z, …]`.
+ * @param width full stroke width (offset ±width/2 on each side).
+ * @param miterLimit SVG stroke-miterlimit; corners sharper than this bevel. Default 4.
+ */
+export declare function offsetPolylineRegions(centrelineFlat: number[] | Float64Array, width: number, closed: boolean, miterLimit?: number): OffsetRegion[];
+/** One polyline in an offset group: centreline `[x,y,z, …]`, stroke width, closed flag. */
+export interface OffsetPolyline {
+    centreline: number[];
+    width: number;
+    closed: boolean;
+}
+/**
+ * Merge a GROUP of separate polylines (a crossing T / X / L overlap) into one clean
+ * region by nonzero-winding union of their mitered bands — the overlapping strokes
+ * merge into a single region with mitered/bevelled corners, no internal edges.
+ * Returns CW-outer / CCW-hole regions (one or more); empty if nothing is buildable.
+ * No CSG. Used to render/extrude an overlapping crossing as one joined mass.
+ */
+export declare function offsetPolylineGroupRegions(polylines: OffsetPolyline[]): OffsetRegion[];

package/src/toolkit/index.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Domain (BIM) builders on top of the generic geometry kernel.
+ */
+export * from "./wall.js";

package/src/toolkit/wall.d.ts

@@ -0,0 +1,40 @@
+/** A point of a returned wall footprint ring (kernel `Vector3` shape). */
+export interface WallFootprintPoint {
+    x: number;
+    y: number;
+    z: number;
+}
+/** One footprint region: a CW outer ring + its CCW inner-void hole rings. */
+export interface WallFootprintRegion {
+    /** Outer ring (CW, canonical start). */
+    outer: WallFootprintPoint[];
+    /** Inner-void hole rings (CCW), e.g. the room void of a closed wall. */
+    holes: WallFootprintPoint[][];
+}
+/**
+ * Build the base 2D wall footprint as one or more REGIONS from a centreline, via
+ * the deterministic analytic offset — miters / flat bevels at `miterLimit`,
+ * concave trims, and nonzero-winding resolution of reflex / closed loops. NO
+ * boolean union (so it is deterministic, unlike the 3D-mesh CSG path). Normal walls
+ * return one region; a self-crossing closed wall (e.g. a figure-8) returns one per
+ * simple sub-loop. Returns an EMPTY array for a genuinely unbuildable wall (does
+ * not throw, so it never looks like a kernel crash). Rings are CW-outer / CCW-holes.
+ *
+ * @param centrelineFlat centreline points as `[x,y,z, …]`.
+ * @param miterLimit SVG stroke-miterlimit; corners sharper than this bevel. Default 4.
+ */
+export declare function buildWallFootprint(centrelineFlat: number[] | Float64Array, thickness: number, closed: boolean, miterLimit?: number): WallFootprintRegion[];
+/** One wall in a junction group: centreline `[x,y,z, …]`, thickness, closed flag. */
+export interface WallGroupMember {
+    centreline: number[];
+    thickness: number;
+    closed: boolean;
+}
+/**
+ * Merge a GROUP of separate walls (a cross-wall T / X / L junction) into one clean
+ * 2D footprint by nonzero-winding union of their mitered bands — the overlapping
+ * walls merge into a single region with mitered/bevelled corners, no internal edges.
+ * Returns CW-outer / CCW-hole regions (one or more); empty if nothing is buildable.
+ * No CSG. Used to render/extrude a junction as one joined mass in both views.
+ */
+export declare function buildWallGroupFootprint(walls: WallGroupMember[]): WallFootprintRegion[];

package/src/shapes/extrusion.d.ts

@@ -1,64 +0,0 @@
-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;
-}