@buerli.io/headless 0.2.0 → 0.3.0-beta.0

package/build/history.d.ts

@@ -1,4 +1,4 @@
-import { FlipType, ReorientedType } from '@buerli.io/classcad';
+import { BooleanOperationType, ChamferType, FlipType, ReorientedType, WorkAxisType, WorkCoordSystemType, WorkPlaneType, WorkPointType, ViewType, OrientationType, ExtrusionType, BrepElemType } from '@buerli.io/classcad';
 import { ObjectID, PointMemValue } from '@buerli.io/core';
 import { BufferGeometry, Scene } from 'three';
 /**
@@ -60,8 +60,8 @@ export declare type ApiHistory = {
      * @image // tbd
      */
     addNodes: (...nodes: {
-        productId: number;
-        ownerId: number;
+        productId: VID;
+        ownerId: VID;
         transformation: Transform;
         name?: string;
     }[]) => IDs;
@@ -135,9 +135,9 @@ export declare type ApiHistory = {
      * @return array of ids of the added dimensions
      */
     addDimensions: (...dimensions: {
-        productId: number;
+        productId: VID;
         dimParam: {
-            dimType: DimTypes;
+            dimType: 'LinearDimension';
             dimName?: string;
             dimLabel: string;
             dimValue?: number | null;
@@ -145,11 +145,11 @@ export declare type ApiHistory = {
             dimEndPos: PointMemValue;
             dimTextPos: PointMemValue;
             dimTextAngle: number;
-            dimOrientation: OrientationTypes;
+            dimOrientation: OrientationType;
             dimColor?: number;
             dimLayer?: string;
         };
-        dxfView: ViewTypes;
+        dxfView: ViewType;
     }[]) => IDs;
     /**
      * Creates different 2D views, depending on the given view types, in the given product.
@@ -163,7 +163,7 @@ export declare type ApiHistory = {
      * await api.create2DViews(productId, ['Top', 'Right_90°', 'Iso'])
      * @image // tbd
      */
-    create2DViews: (productId: VID, viewTypes: ViewTypes[]) => IDs;
+    create2DViews: (productId: VID, viewTypes: ViewType[]) => IDs;
     /**
      * This method returns the boundary box of the given views.
      * @param productId id of the product from where the boundary box will returned
@@ -176,8 +176,9 @@ export declare type ApiHistory = {
      * console.info(bbs) // [[{x: -105, y: -89, z: 0}, {x: 105, y: 55, z: 0}], [...], [...]]
      * @image // tbd
      */
-    getBoundaryBoxFromViews: (productId: VID, viewTypes?: ViewTypes[]) => Promise<[PointMemValue, PointMemValue][]>;
+    getBoundaryBoxFromViews: (productId: VID, viewTypes?: ViewType[]) => Promise<[PointMemValue, PointMemValue][]>;
     /**
+     * Place the 2D views relatively to the origin.
      * @param productId id of the product where the views will be placed in
      * @param viewPositions array of objects, containing the viewType and a vector which defines the moving vector of the given view
      * @example
@@ -189,10 +190,11 @@ export declare type ApiHistory = {
      * @image // tbd
      */
     place2DViews: (productId: VID, viewPositions: {
-        viewType: ViewTypes;
+        viewType: ViewType;
         vector: PointMemValue;
     }[]) => Promise<void>;
     /**
+     * Export the placed views as dxf file.
      * @param productId id of the product where the views exist for export
      * @example
      * // After creating and placing the views, see place2DViews(), you can export them
@@ -202,13 +204,79 @@ export declare type ApiHistory = {
      */
     exportDXF: (productId: VID) => Promise<Uint8Array | null>;
     /**
+     * Export the placed views as svg file.
+     * @param productId id of the product where the views exist for export
+     * @example
+     * // After creating and placing the views, see place2DViews(), you can export them
+     * // You will get the svg stream back
+     * await api.exportSVG(productId)
+     * @image // tbd
+     */
+    exportSVG: (productId: VID) => Promise<Uint8Array | null>;
+    /**
+     * Remove existing dimensions from the view.
      * @param dimensionsIds ids of the dimensions to be removed
      * @example
      * // You can remove existing dimensions
      * await api.removeDimensions(dimensionIds)
      * @image // tbd
      */
-    removeDimensions: (dimensionIds: number[]) => Promise<void>;
+    removeDimensions: (dimensionIds: VID[]) => Promise<void>;
+    /**
+     * Creates a linear pattern
+     * @param partId Id of the part to create the linear pattern in.
+     * @param entities included entities of linear operation.
+     * @param references1 references for the first axis of the pattern. E.g. edge / work axis or 2 vertices / work points
+     * @param params1 parameter object which includes inverted flag, distance, count and merged flag
+     * for the first direction of the pattern.
+     * @param references2 optional references for the second axis of the pattern.
+     * @param params2 optional parameter object for second direction of pattern.
+     */
+    linearPattern: (partId: VID, entities: VID[], references1: VID[], params1: {
+        inverted: 0 | 1;
+        distance: number | string;
+        count: number | string;
+        merged: 0 | 1;
+    }, references2?: VID[], params2?: {
+        inverted: 0 | 1;
+        distance: number | string;
+        count: number | string;
+    }) => ID;
+    /**
+     * Creates a circular pattern
+     * @param partId Id of the part to create the circular pattern in.
+     * @param entities included entities of circular operation.
+     * @param references references for the rotation axis of the pattern. E.g. edge / work axis or 2 vertices / work points
+     * @param params parameter object which includes inverted flag, angle, count and merged flag.
+     */
+    circularPattern: (partId: VID, entities: VID[], references: VID[], params: {
+        inverted: 0 | 1;
+        angle: number | string;
+        count: number | string;
+        merged: 0 | 1;
+    }) => ID;
+    /**
+     * Creates an extrusion
+     * @param partId Id of the part to create the extrusion in.
+     * @param sketchId Id of the sketch to extrude
+     * @param type Type of extrusion (up, down, symmetric, custom)
+     * @param limit1 Start of extrusion (0 = start at sketch, only for type custom necessary)
+     * @param limit2 End of extrusion, which is actually the height
+     * @param taperAngle Angle of taper for extrusion
+     * @param direction Direction of extrusion
+     * @param capEnds If true, ends will be capped, else a sheet will be created
+     */
+    extrusion: (partId: VID, sketchId: VID, type: ExtrusionType, limit1: number | string, limit2: number | string, taperAngle: number | string, direction: PointMemValue, capEnds: 0 | 1) => ID;
+    /**
+     * Creates a revolve
+     * @param partId Id of the part to create the revolve in.
+     * @param sketchId Id of the sketch to revolve
+     * @param axisIds Array of ids, either [lineId] or [point1Id, point2Id], ids can be both ccId or graphicId
+     * @param angle1 Start of revolve in degrees
+     * @param angle2 End of revolve in degrees
+     * @param inverted flag, whether to invert the axis or not
+     */
+    revolve: (partId: VID, sketchId: VID, axisIds: VID[], angle1: number | string, angle2: number | string, inverted: 0 | 1) => ID;
     /**
      * Creates a boolean operation.
      * @param partId id of the part where the operation will be created on
@@ -219,12 +287,12 @@ export declare type ApiHistory = {
      * const part = api.createPart('Part')
      * const cyl = api.cylinder(part, [], 10, 100)
      * const box = api.box(part, [], 20, 20, 20)
-     * api.boolean(part, 'Subtraction', [box, cyl])
+     * api.boolean(part, BooleanOperationType.Subtraction, [box, cyl])
      * const geoms = await api.createBufferGeometry(part)
      * return geoms.map(geom => new THREE.Mesh(geom, new THREE.MeshStandardMaterial()))
      * @image /doc/assets/history/boolean.jpg
      */
-    boolean: (partId: VID, type: BooleanTypes, entities: VID[]) => ID;
+    boolean: (partId: VID, type: BooleanOperationType, entities: VID[]) => ID;
     /**
      * Creates a simple box entity
      * @param partId id of the part where the box will be created
@@ -240,7 +308,7 @@ export declare type ApiHistory = {
      * return geoms.map(geom => new THREE.Mesh(geom, new THREE.MeshStandardMaterial()))
      * @image /doc/assets/history/box.jpg
      */
-    box: (partId: VID, references: number[], width: number | string, length: number | string, height: number | string) => ID;
+    box: (partId: VID, references: VID[], width: number | string, length: number | string, height: number | string) => ID;
     /**
      * Creates a simple cylinder entity
      * @param partId id of the part where the cylinder will be created
@@ -255,7 +323,7 @@ export declare type ApiHistory = {
      * return geoms.map(geom => new THREE.Mesh(geom, new THREE.MeshStandardMaterial()))
      * @image /doc/assets/history/cylinder.jpg
      */
-    cylinder: (partId: VID, references: number[], diameter: number | string, height: number | string) => ID;
+    cylinder: (partId: VID, references: VID[], diameter: number | string, height: number | string) => ID;
     /**
      * Creates a chamfer at the given edge references.
      * @param partId id of the part where the chamfers will be created
@@ -269,12 +337,12 @@ export declare type ApiHistory = {
      * const part = api.createPart('Part')
      * api.cylinder(part, [], 10, 100)
      * const bottomEdges = await api.pick(part, 'edge', [{ x: 0, y: 0, z: 0 }])
-     * api.chamfer(part, 'Equal_Distance', bottomEdges, 2, 0, 0)
+     * api.chamfer(part, ChamferType.Equal_Distance, bottomEdges, 2, 0, 0)
      * const geoms = await api.createBufferGeometry(part)
      * return geoms.map(geom => new THREE.Mesh(geom, new THREE.MeshStandardMaterial()))
      * @image // tbd
      */
-    chamfer: (partId: VID, type: ChamferTypes, references: VID[], dist1: number, dist2: number, angle: number) => ID;
+    chamfer: (partId: VID, type: ChamferType, references: VIDs, dist1: number | string, dist2: number | string, angle: number | string) => ID;
     /**
      * Creates a simple cone entity.
      * @param partId id of the part where the cone will be created
@@ -290,7 +358,7 @@ export declare type ApiHistory = {
      * return geoms.map(geom => new THREE.Mesh(geom, new THREE.MeshStandardMaterial()))
      * @image /doc/assets/history/cone.jpg
      */
-    cone: (partId: VID, references: number[], bDiameter: number, tDiameter: number, height: number) => ID;
+    cone: (partId: VID, references: VID[], bDiameter: number | string, tDiameter: number | string, height: number | string) => ID;
     /**
      * Creates a fastened constraint between two mates of an assembly.
      * @param asmId id of the assembly to create constraints on
@@ -335,16 +403,16 @@ export declare type ApiHistory = {
      * @image /doc/assets/history/fastenedConstraint.jpg
      */
     createFastenedConstraint: (asmId: VID, mate1: {
-        matePath: number[];
-        wcsId: number;
+        matePath: VID[];
+        wcsId: VID;
         flip: FlipType;
         reoriented: ReorientedType;
     }, mate2: {
-        matePath: number[];
-        wcsId: number;
+        matePath: VID[];
+        wcsId: VID;
         flip: FlipType;
         reoriented: ReorientedType;
-    }, xOffset: number, yOffset: number, zOffset: number, name: string) => ID;
+    }, xOffset: number | string, yOffset: number | string, zOffset: number | string, name: string) => ID;
     /**
      * Updates a fastened constraint.
      * @param constrId id of the constraint to update
@@ -357,16 +425,16 @@ export declare type ApiHistory = {
      * @image // tbd
      */
     updateFastenedConstraint: (constrId: VID, mate1: {
-        matePath: number[];
-        wcsId: number;
+        matePath: VID[];
+        wcsId: VID;
         flip: FlipType;
         reoriented: ReorientedType;
     }, mate2: {
-        matePath: number[];
-        wcsId: number;
+        matePath: VID[];
+        wcsId: VID;
         flip: FlipType;
         reoriented: ReorientedType;
-    }, xOffset: number, yOffset: number, zOffset: number) => Promise<void>;
+    }, xOffset: number | string, yOffset: number | string, zOffset: number | string) => Promise<void>;
     /**
      * Updates multiple fastened constraints
      * @param constraints array of constraint parameter objects
@@ -374,22 +442,22 @@ export declare type ApiHistory = {
      * @image // tbd
      */
     updateFastenedConstraints: (...constraints: {
-        constrId: number;
+        constrId: VID;
         mate1: {
             matePath: number[];
-            wcsId: number;
+            wcsId: VID;
             flip: number;
             reoriented: number;
         };
         mate2: {
             matePath: number[];
-            wcsId: number;
+            wcsId: VID;
             flip: number;
             reoriented: number;
         };
-        xOffset: number;
-        yOffset: number;
-        zOffset: number;
+        xOffset: number | string;
+        yOffset: number | string;
+        zOffset: number | string;
     }[]) => Promise<void>;
     /**
      * Creates a fastened origin constraint for mate1 to the origin (0, 0, 0).
@@ -428,11 +496,11 @@ export declare type ApiHistory = {
      * @image /doc/assets/history/fastenedOriginConstraint.jpg
      */
     createFastenedOriginConstraint: (asmId: VID, mate1: {
-        matePath: number[];
-        wcsId: number;
+        matePath: VID[];
+        wcsId: VID;
         flip: FlipType;
         reoriented: ReorientedType;
-    }, xOffset: number, yOffset: number, zOffset: number, name: string) => ID;
+    }, xOffset: number | string, yOffset: number | string, zOffset: number | string, name: string) => ID;
     /**
      * Updates a fastened origin constraint.
      * @param constrId id of the constraint to update
@@ -444,11 +512,11 @@ export declare type ApiHistory = {
      * @image // tbd
      */
     updateFastenedOriginConstraint: (constrId: VID, mate1: {
-        matePath: number[];
-        wcsId: number;
+        matePath: VID[];
+        wcsId: VID;
         flip: FlipType;
         reoriented: ReorientedType;
-    }, xOffset: number, yOffset: number, zOffset: number) => Promise<void>;
+    }, xOffset: number | string, yOffset: number | string, zOffset: number | string) => Promise<void>;
     /**
      * Updates multiple fastened origin constraints
      * @param constraints array of constraint parameter objects
@@ -463,9 +531,9 @@ export declare type ApiHistory = {
             flip: number;
             reoriented: number;
         };
-        xOffset: number;
-        yOffset: number;
-        zOffset: number;
+        xOffset: number | string;
+        yOffset: number | string;
+        zOffset: number | string;
     }[]) => Promise<void>;
     /**
      * Creates the buffer geometry of the product (part or assembly).
@@ -507,7 +575,7 @@ export declare type ApiHistory = {
     createExpressions: (partId: VID, ...members: {
         name: string;
         value: number | PointMemValue | string;
-    }[]) => Promise<void>;
+    }[]) => Promise<boolean>;
     /**
      * Creates a new assembly template. This template can be used multiple times as a sub assembly in the root assembly.
      * @param name [optional] name of the assembly template. Default = 'Assembly'
@@ -548,7 +616,7 @@ export declare type ApiHistory = {
      * return geoms.map(geom => new THREE.Mesh(geom, new THREE.MeshStandardMaterial()))
      * @image /doc/assets/history/assemblyTemplate.jpg
      */
-    createAssemblyAsTemplate: (name?: string) => Promise<number | null>;
+    createAssemblyAsTemplate: (name?: string) => ID;
     /**
      * Creates a new rootAssembly. This is the top level assembly.
      * @param name [optional] name of the root assembly. Default = 'AssemblyRoot'
@@ -574,7 +642,7 @@ export declare type ApiHistory = {
      * return geoms.map(geom => new THREE.Mesh(geom, new THREE.MeshStandardMaterial()))
      * @image // tbd
      */
-    createRootAssembly: (name?: string) => Promise<number | null>;
+    createRootAssembly: (name?: string) => ID;
     /**
      * Creates a new part.
      * @param name [optional] name of the part. Default = 'Part'
@@ -586,7 +654,7 @@ export declare type ApiHistory = {
      * return geoms.map(geom => new THREE.Mesh(geom, new THREE.MeshStandardMaterial()))
      * @image // tbd
      */
-    createPart: (name?: string) => Promise<number | null>;
+    createPart: (name?: string) => ID;
     /**
      * Creates a new part template. This template can be used multiple times to build assemblies.
      * @param name [optional] name of the part. Default = 'Part'
@@ -612,7 +680,7 @@ export declare type ApiHistory = {
      * return geoms.map(geom => new THREE.Mesh(geom, new THREE.MeshStandardMaterial()))
      * @image // tbd
      */
-    createPartAsTemplate: (name?: string) => Promise<number | null>;
+    createPartAsTemplate: (name?: string) => ID;
     /**
      * Creates a new work axis for the given part
      * @param partId id of the part to add the new work axis to
@@ -625,7 +693,7 @@ export declare type ApiHistory = {
      * @example //tbd
      * @image // tbd
      */
-    createWorkAxis: (partId: VID, type: WATypes, references: VID[], position: PointMemValue, direction: PointMemValue, local: boolean, name?: string) => ID;
+    createWorkAxis: (partId: VID, type: WorkAxisType, references: VID[], position: PointMemValue, direction: PointMemValue, local: boolean, name?: string) => ID;
     /**
      * Creates a new work coordinate system for the given part.
      * @param partId id of the part to add the new work coord system to
@@ -651,13 +719,13 @@ export declare type ApiHistory = {
      *
      * // Creates a part template and adds geometry to it
      * const partTempl1 = await api.createPartAsTemplate('Part_Template1')
-     * const wcs1 = await api.createWorkCoordSystem(partTempl1, 'Custom', [], offset1, rot, 0, false, 'wcs1')
-     * const wcs3 = await api.createWorkCoordSystem(partTempl1, 'Custom', [], offset3, rot, 0, false, 'wcs3')
+     * const wcs1 = await api.createWorkCoordSystem(partTempl1, WorkCoordSystemType.WCS_Custom, [], offset1, rot, 0, false, 'wcs1')
+     * const wcs3 = await api.createWorkCoordSystem(partTempl1, WorkCoordSystemType.WCS_Custom, [], offset3, rot, 0, false, 'wcs3')
      * api.box(partTempl1, [wcs1], 30, 30, 30)
      *
      * // Creates another part template and adds geometry to it
      * const partTempl2 = await api.createPartAsTemplate('Part_Template2')
-     * const wcs2 = await api.createWorkCoordSystem(partTempl2, 'Custom', [], offset2, rot, 0, false, 'wcs2')
+     * const wcs2 = await api.createWorkCoordSystem(partTempl2, WorkCoordSystemType.WCS_Custom, [], offset2, rot, 0, false, 'wcs2')
      * api.cone(partTempl2, [wcs2], 30, 0.1, 30)
      *
      * // Adds the created part templates as nodes to the root assembly
@@ -670,7 +738,7 @@ export declare type ApiHistory = {
      * return geoms.map(geom => new THREE.Mesh(geom, new THREE.MeshStandardMaterial()))
      * @image // tbd
      */
-    createWorkCoordSystem: (partId: VID, type: WCSTypes, references: VID[], coordinateSystem: PointMemValue[], offset: PointMemValue, rotation: PointMemValue, inverted: 0 | 1, local: boolean, name?: string) => ID;
+    createWorkCoordSystem: (partId: VID, type: WorkCoordSystemType, references: VID[], coordinateSystem: PointMemValue[], offset: PointMemValue, rotation: PointMemValue, inverted: 0 | 1, local: boolean, name?: string) => ID;
     /**
      * Creates a new work plane for the given part
      * @param partId id of the part to add the new work plane to
@@ -685,7 +753,7 @@ export declare type ApiHistory = {
      * @example // tbd
      * @image // tbd
      */
-    createWorkPlane: (partId: VID, type: WPTypes, references: VID[], offset: number, angle: number, position: PointMemValue, normal: PointMemValue, local: boolean, name?: string) => ID;
+    createWorkPlane: (partId: VID, type: WorkPlaneType, references: VID[], offset: number, angle: number, position: PointMemValue, normal: PointMemValue, local: boolean, name?: string) => ID;
     /**
      * Creates a new work point for the given part
      * @param partId id of the part to add the new work point to
@@ -698,7 +766,7 @@ export declare type ApiHistory = {
      * @example // tbd
      * @image // tbd
      */
-    createWorkPoint: (partId: VID, type: WPTypes, references: VID[], position: PointMemValue, local: boolean, name?: string) => ID;
+    createWorkPoint: (partId: VID, type: WorkPointType, references: VID[], position: PointMemValue, local: boolean, name?: string) => ID;
     /**
      * Deletes an existing expression.
      * @param partId id of part to delete expressions from
@@ -713,7 +781,53 @@ export declare type ApiHistory = {
      * return geoms.map(geom => new THREE.Mesh(geom, new THREE.MeshStandardMaterial()))
      * @image // tbd
      */
-    deleteExpressions: (partId: VID, members: string[]) => void;
+    deleteExpressions: (partId: VID, members: string[]) => Promise<boolean>;
+    /**
+     * Loads a sketch from a of1 filestream and adds its elements to a new sketch.
+     * The id of this new created sketch will be returned.
+     *
+     * @param partId id of the part we want to create the new sketch and copy the sketch elements into it
+     * @param strm stream of of1 file which contains the sketch
+     * @param planeId id of the face or workplane to set the new sketch on
+     * @param name optional name of the sketch to load from filestream
+     */
+    loadSketch: (partId: VID, strm: ArrayBuffer, planeId: VID, name?: string) => ID;
+    /**
+     * Copy an existing sketch and adds its elements to a new sketch.
+     * The id of this new created sketch will be returned.
+     *
+     * @param partId id of the part we want to create the new sketch and copy the sketch elements into it
+     * @param sketchId id of the sketch to copy
+     * @param planeId id of the face or workplane to set the new sketch on
+     */
+    copySketch: (partId: VID, sketchId: VID, planeId: VID) => ID;
+    /**
+     * Place/position the sketch with plane, axis and origin references.
+     *
+     * @param sketchId id of the sketch to place
+     * @param planeId - id of a face or a workplane. This will be the plane where the sketch lies on.
+     * If a plane reference already exists, planeId is optional
+     * @param invertPlane - if true, the normal of the plane will be inverted
+     * @param axisId - optional id of an edge or workaxis. This will be the x-Axis
+     * @param isXAxis - if true, the axisId will be the x-axis of the sketch, else the x-Axis will be the crossvector of the normal and the axisId
+     * @param invertAxis - if true, the direction of the axis will be inverted
+     * @param originId - optional point or vertex of the sketch's origin reference
+     */
+    placeSketch: (sketchId: VID, planeId: VID, invertPlane: boolean, axisId: VID, isXAxis: boolean, invertAxis: boolean, originId: VID) => Promise<void>;
+    /**
+     * Creates a simple sphere entity.
+     * @param partId id of the part where the cone will be created
+     * @param references reference of work coordinate system to place the cone at
+     * @param radius bottom diameter of the cone
+     * @example
+     * // Creates a sphere with radius = 20
+     * const part = api.createPart('Part')
+     * api.sphere(part, [], 20)
+     * const geoms = await api.createBufferGeometry(part)
+     * return geoms.map(geom => new THREE.Mesh(geom, new THREE.MeshStandardMaterial()))
+     * @image // tbd
+     */
+    sphere: (partId: VID, references: VID[], radius: number | string) => ID;
     /**
      * Creates a fillet at the given edge references.
      * @param partId id of the part where the fillet will be created
@@ -729,7 +843,17 @@ export declare type ApiHistory = {
      * return geoms.map(geom => new THREE.Mesh(geom, new THREE.MeshStandardMaterial()))
      * @image // tbd
      */
-    fillet: (partId: VID, references: VID[], radius: number | string) => void;
+    fillet: (partId: VID, references: VIDs, radius: number | string) => ID;
+    /**
+     * Find geometry (vertices, edges, faces, loops) by given positions or selection. If positions parameter is null,
+     * user can select geometry in graphical interface. For all selected geometries this function logs its
+     * relevant points into console, to find the geometry later by points
+     * @param partId id of the part looking for geometry in or selecting them
+     * @param type type of geometry to find or select
+     * @param length number of selections to make before resolving the selection
+     * @param positions array of point arrays where to look for geometry or null if the geometry wants to be selected
+     */
+    findOrSelect: (partId: VID, type: BrepElemType, length: number, positions: PointMemValue[][] | null) => IDs;
     /**
      * Returns the assembly with given name from assembly container.
      * If asmName is empty, all assemblies from assembly container will be returned.
@@ -760,7 +884,7 @@ export declare type ApiHistory = {
      * @example // tbd
      * @image // tbd
      */
-    setCurrentNode: (refId: VID) => void;
+    setCurrentNode: (refId: VID) => Promise<void>;
     /**
      * Sets the product with productId to the new current product
      *
@@ -768,7 +892,7 @@ export declare type ApiHistory = {
      * @example // tbd
      * @image // tbd
      */
-    setCurrentProduct: (productId: VID) => void;
+    setCurrentProduct: (productId: VID) => Promise<void>;
     /**
      * Returns the id of the current node
      * @example // tbd
@@ -889,7 +1013,7 @@ export declare type ApiHistory = {
      * @example // tbd
      * @image // tbd
      */
-    removeNode: (referenceId: ObjectID, ownerId: ObjectID) => Promise<void>;
+    removeNode: (referenceId: VID, ownerId: VID) => Promise<void>;
     /**
      * Removes multiple nodes from an assembly node at once
      * @param nodes array of node parameter objects. See also removeNode().
@@ -897,11 +1021,11 @@ export declare type ApiHistory = {
      * @image // tbd
      */
     removeNodes: (...nodes: {
-        referenceId: number;
-        ownerId: number;
+        referenceId: VID;
+        ownerId: VID;
     }[]) => Promise<void>;
     /**
-     * Transforms the node with referenceId with the given transformation
+     * Transforms the node with referenceId with the given transformation within an assembly
      *
      * @param referenceId id of the node to transform
      * @param ownerId id of the owner (parent) of node we want to transform
@@ -945,7 +1069,7 @@ export declare type ApiHistory = {
      * return geoms.map(geom => new THREE.Mesh(geom, new THREE.MeshStandardMaterial()))
      * @image // tbd
      */
-    pick: (partId: VID, type: PickTypes, points: PointMemValue[]) => IDs;
+    pick: (partId: VID, type: 'vertex' | 'edge' | 'face', points: PointMemValue[]) => IDs;
     /**
      * Updates an existing expression
      * @param partId id of part to update expression
@@ -990,6 +1114,7 @@ export default class CAD {
     destroy(): void;
 }
 declare type VID = ObjectID | Promise<ObjectID> | null | Promise<number | null>;
+declare type VIDs = ObjectID[] | Promise<ObjectID[]>;
 declare type ID = Promise<ObjectID> | Promise<number | null>;
 declare type IDs = Promise<ObjectID[]>;
 declare type Point = {
@@ -998,21 +1123,12 @@ declare type Point = {
     z: number;
 };
 export declare type Transform = [Point, Point, Point];
-declare type BooleanTypes = 'Union' | 'Subtraction' | 'Intersection';
-declare type WCSTypes = 'XYAxisOrigin' | 'Custom';
-declare type WATypes = 'Custom' | 'WorkPoints' | 'PointAndDirection' | 'SketchLine' | 'Curve' | '2Points' | '2Planes';
-declare type WPTypes = 'Custom' | 'Plane' | 'EdgeAndPoint' | '3Points' | 'PointAndNormal' | 'PointAndFace' | 'LinePlaneAndAngle';
-declare type ChamferTypes = 'Equal_Distance' | 'Two_Distances' | 'Distance_And_Angle';
-declare type PickTypes = 'vertex' | 'edge' | 'face';
 declare type DataTypes = 'of1' | 'stp' | 'step';
 declare type SupportedImportFormats = 'STEP' | 'STP' | 'SAT' | 'IWB' | 'IWP' | 'IWC' | 'IGS' | 'STL' | 'DXF' | 'DWG';
-declare type DimTypes = 'LinearDimension';
-declare type ViewTypes = 'Top' | 'Front' | 'Right' | 'Left' | 'Bottom' | 'Right_90°' | 'Left_90°' | 'Back' | 'Iso';
-export declare type OrientationTypes = 'Horizontal' | 'Vertical';
 export declare type DimensionType = {
-    productId: number;
+    productId: VID;
     dimParam: {
-        dimType: DimTypes;
+        dimType: 'LinearDimension';
         dimName?: string;
         dimLabel: string;
         dimValue?: number | null;
@@ -1020,11 +1136,11 @@ export declare type DimensionType = {
         dimEndPos: PointMemValue;
         dimTextPos: PointMemValue;
         dimTextAngle: number;
-        dimOrientation: OrientationTypes;
+        dimOrientation: OrientationType;
         dimColor?: number;
         dimLayer?: string;
     };
-    dxfView: ViewTypes;
+    dxfView: ViewType;
 };
 /**
  * Information about constraint.