@buerli.io/headless 0.6.0 → 0.7.0

package/README.md

@@ -10,3 +10,17 @@ Usage information and reference details can be found in the [buerli documentatio
 npm install @buerli.io/headless
 yarn add @buerli.io/headless
 ```
+
+### Usage
+
+```jsx
+import { history } from '@buerli.io/headless'
+import { init, SocketIOClient } from '@buerli.io/classcad'
+
+init(id => return new SocketIOClient('ws://localhost:9091', id))
+const history = new history()
+instance.init(api => {
+  const part = await api.createPart('Part')
+  // ...
+})
+```

package/build/cjs/history.js

@@ -50,6 +50,12 @@ let BufferGeometryUtils = BufferGeometryUtils_;
 if (BufferGeometryUtils.BufferGeometryUtils) {
     BufferGeometryUtils = BufferGeometryUtils.BufferGeometryUtils;
 }
+const resolveVec = (value) => {
+    if (Array.isArray(value))
+        return { x: value[0], y: value[1], z: value[2] };
+    else
+        return value;
+};
 /**
  * Returns the cclass of the given dimension type
  * @param type type of the dimension as string
@@ -132,7 +138,7 @@ const createRecursiveScene = async (object, drawingId, root, result, options) =>
         const entities = object.link ? tree[object.link].solids : object.solids;
         if (entities != undefined) {
             const part = new three_1.Group();
-            part.matrix = core_1.MathUtils.convertToMatrix4(object.coordinateSystem);
+            part.matrix = object.coordinateSystem ? core_1.MathUtils.convertToMatrix4(object.coordinateSystem) : new three_1.Matrix4();
             part.matrixAutoUpdate = false;
             part.userData = { id: object.id }; // product reference id
             part.name = object.name; // product reference name
@@ -192,7 +198,7 @@ const createRecursiveScene = async (object, drawingId, root, result, options) =>
     else if (object.children) {
         // Assembly
         const assembly = new three_1.Group();
-        assembly.matrix = core_1.MathUtils.convertToMatrix4(object.coordinateSystem);
+        assembly.matrix = object.coordinateSystem ? core_1.MathUtils.convertToMatrix4(object.coordinateSystem) : new three_1.Matrix4();
         assembly.matrixAutoUpdate = false;
         assembly.userData = { id: object.id }; // assembly root or product reference id
         assembly.name = object.name; // assembly root or product reference name
@@ -216,9 +222,10 @@ const logPoints = (points) => {
     if (points && points.length > 0) {
         for (let i = 0; i < points.length; i++) {
             for (let j = 0; j < points[i].length; j++) {
-                const x = Math.round(points[i][j].x * 1000) / 1000;
-                const y = Math.round(points[i][j].y * 1000) / 1000;
-                const z = Math.round(points[i][j].z * 1000) / 1000;
+                const point = resolveVec(points[i][j]);
+                const x = Math.round(point.x * 1000) / 1000;
+                const y = Math.round(point.y * 1000) / 1000;
+                const z = Math.round(point.z * 1000) / 1000;
                 log += '{ x: ' + x + ', y: ' + y + ', z: ' + z + '}';
                 log += points[i].length - 1 === j ? '' : ',';
             }
@@ -288,9 +295,9 @@ class CAD {
                                     name: dim.dimParam.dimName,
                                     label: dim.dimParam.dimLabel,
                                     value: dim.dimParam.dimValue,
-                                    startPos: dim.dimParam.dimStartPos,
-                                    endPos: dim.dimParam.dimEndPos,
-                                    textPos: dim.dimParam.dimTextPos,
+                                    startPos: resolveVec(dim.dimParam.dimStartPos),
+                                    endPos: resolveVec(dim.dimParam.dimEndPos),
+                                    textPos: resolveVec(dim.dimParam.dimTextPos),
                                     textAngle: dim.dimParam.dimTextAngle,
                                     orientation: dim.dimParam.dimOrientation,
                                     color: dim.dimParam.dimColor,
@@ -328,7 +335,10 @@ class CAD {
                 },
                 place2DViews: (productId, viewPositions) => {
                     return this.resolve(async ([rProductId]) => {
-                        return drawing2DAPI.place2DViews(drawingId, rProductId, viewPositions);
+                        return drawing2DAPI.place2DViews(drawingId, rProductId, viewPositions.map(({ viewType, vector }) => ({
+                            viewType,
+                            vector: resolveVec(vector),
+                        })));
                     }, productId);
                 },
                 exportDXF: (productId, dxfTemplateFilename) => {
@@ -449,7 +459,7 @@ class CAD {
                                     isExpr: typeof taperAngle === 'string',
                                 };
                                 const directionParam = {
-                                    value: direction,
+                                    value: resolveVec(direction),
                                     isExpr: typeof direction === 'string',
                                 };
                                 await featureAPI.updateExtrusion(drawingId, extrusion, sketchLines, type, limit1Param, limit2Param, taperAngleParam, directionParam, capEnds);
@@ -1119,11 +1129,11 @@ class CAD {
                         const wAId = await featureAPI.createWorkGeometry(drawingId, rPartId, classcad_1.CCClasses.CCWorkAxis, wAName);
                         if (wAId != null) {
                             const positionParam = {
-                                value: position,
+                                value: resolveVec(position),
                                 isExpr: typeof position === 'string',
                             };
                             const directionParam = {
-                                value: direction,
+                                value: resolveVec(direction),
                                 isExpr: typeof direction === 'string',
                             };
                             await featureAPI.updateWorkAxis(drawingId, wAId, type, rReferences, positionParam, directionParam, local);
@@ -1132,17 +1142,20 @@ class CAD {
                         return null;
                     }, partId, ...references);
                 },
-                createWorkCoordSystem: (partId, type, references, coordinateSystem, offset, rotation, inverted, local, name) => {
+                createWorkCoordSystem: (partId, type, references, coordinateSystem, offset, rotation, inverted = false, local = false, name) => {
                     return this.resolve(async ([rPartId, ...rReferences]) => {
                         const wCSName = name ? name : 'WorkCoordSystem';
                         const wCSId = await featureAPI.createWorkGeometry(drawingId, rPartId, classcad_1.CCClasses.CCWorkCoordSystem, wCSName);
                         if (wCSId != null) {
-                            const offsetParam = { value: offset, isExpr: typeof offset === 'string' };
+                            const offsetParam = {
+                                value: resolveVec(offset),
+                                isExpr: typeof offset === 'string',
+                            };
                             const rotationParam = {
-                                value: rotation,
+                                value: resolveVec(rotation),
                                 isExpr: typeof rotation === 'string',
                             };
-                            await featureAPI.updateWorkCoordSystem(drawingId, wCSId, type, rReferences, coordinateSystem, offsetParam, rotationParam, inverted, local);
+                            await featureAPI.updateWorkCoordSystem(drawingId, wCSId, type, rReferences, coordinateSystem.map(resolveVec), offsetParam, rotationParam, inverted ? 1 : 0, local);
                             return wCSId;
                         }
                         return null;
@@ -1156,10 +1169,13 @@ class CAD {
                             const offsetParam = { value: offset, isExpr: typeof offset === 'string' };
                             const angleParam = { value: angle, isExpr: typeof angle === 'string' };
                             const positionParam = {
-                                value: position,
+                                value: resolveVec(position),
                                 isExpr: typeof position === 'string',
                             };
-                            const normalParam = { value: normal, isExpr: typeof normal === 'string' };
+                            const normalParam = {
+                                value: resolveVec(normal),
+                                isExpr: typeof normal === 'string',
+                            };
                             await featureAPI.updateWorkPlane(drawingId, wPId, type, rReferences, offsetParam, angleParam, positionParam, normalParam, local);
                             return wPId;
                         }
@@ -1172,7 +1188,7 @@ class CAD {
                         const wPTId = await featureAPI.createWorkGeometry(drawingId, rPartId, classcad_1.CCClasses.CCWorkPoint, wPTName);
                         if (wPTId != undefined) {
                             const positionParam = {
-                                value: position,
+                                value: resolveVec(position),
                                 isExpr: typeof position === 'string',
                             };
                             await featureAPI.updateWorkPoint(drawingId, wPTId, type, rReferences, positionParam, local);
@@ -1210,7 +1226,7 @@ class CAD {
                                 break;
                         }
                         const geometries = positions
-                            ? await geometryAPI.findGeometriesByPoints(drawingId, rPartId, type, positions)
+                            ? await geometryAPI.findGeometriesByPoints(drawingId, rPartId, type, positions.map(p => p.map(resolveVec)))
                             : await (0, selection_1.waitForSelect)(length, filter, (resolveSelection, items, diff) => {
                                 if (items.length > length - 1) {
                                     resolveSelection(items.map(i => i.data.graphicId));
@@ -1452,6 +1468,15 @@ class CAD {
                         return null;
                     }, partId);
                 },
+                getGeometryInformation: (objectId) => {
+                    return this.resolve(async ([rProductOrSolidId]) => {
+                        const values = await baseModelerAPI.getGeometryInformation(drawingId, rProductOrSolidId);
+                        if (values !== null) {
+                            return { centerOfGravity: values[0], volume: values[1] };
+                        }
+                        return null;
+                    }, objectId);
+                },
                 removeNodes: (...nodes) => {
                     return this.resolve(async ([...rNodes]) => {
                         return assemblyBuilderAPI.removeNodes(drawingId, rNodes);
@@ -1572,7 +1597,7 @@ class CAD {
                 },
                 pick: (partId, type, points) => {
                     return this.resolve(async ([rPartId]) => {
-                        const refs = await featureAPI.pick(drawingId, rPartId, type, points);
+                        const refs = await featureAPI.pick(drawingId, rPartId, type, points.map(resolveVec));
                         if (refs != undefined) {
                             return Array.isArray(refs) ? refs : [refs];
                         }

package/build/esm/history.js

@@ -8,7 +8,7 @@ var __asyncValues = (this && this.__asyncValues) || function (o) {
 /* eslint-disable max-lines */
 import { ccAPI, CCClasses, ccUtils, DataType, SVGModusType, } from '@buerli.io/classcad';
 import { api, getDrawing, lineSegmentsFilter, loopFilter, MathUtils, planeFilter, pointFilter, } from '@buerli.io/core';
-import { Group, Mesh, MeshStandardMaterial, Scene } from 'three';
+import { Group, Matrix4, Mesh, MeshStandardMaterial, Scene } from 'three';
 import * as BufferGeometryUtils_ from 'three/examples/jsm/utils/BufferGeometryUtils';
 import { waitForSelect } from './utils/selection';
 import { getDifferentColoredMeshesFromEntity } from './utils/meshes';
@@ -25,6 +25,12 @@ let BufferGeometryUtils = BufferGeometryUtils_;
 if (BufferGeometryUtils.BufferGeometryUtils) {
     BufferGeometryUtils = BufferGeometryUtils.BufferGeometryUtils;
 }
+const resolveVec = (value) => {
+    if (Array.isArray(value))
+        return { x: value[0], y: value[1], z: value[2] };
+    else
+        return value;
+};
 /**
  * Returns the cclass of the given dimension type
  * @param type type of the dimension as string
@@ -107,7 +113,7 @@ const createRecursiveScene = async (object, drawingId, root, result, options) =>
         const entities = object.link ? tree[object.link].solids : object.solids;
         if (entities != undefined) {
             const part = new Group();
-            part.matrix = MathUtils.convertToMatrix4(object.coordinateSystem);
+            part.matrix = object.coordinateSystem ? MathUtils.convertToMatrix4(object.coordinateSystem) : new Matrix4();
             part.matrixAutoUpdate = false;
             part.userData = { id: object.id }; // product reference id
             part.name = object.name; // product reference name
@@ -167,7 +173,7 @@ const createRecursiveScene = async (object, drawingId, root, result, options) =>
     else if (object.children) {
         // Assembly
         const assembly = new Group();
-        assembly.matrix = MathUtils.convertToMatrix4(object.coordinateSystem);
+        assembly.matrix = object.coordinateSystem ? MathUtils.convertToMatrix4(object.coordinateSystem) : new Matrix4();
         assembly.matrixAutoUpdate = false;
         assembly.userData = { id: object.id }; // assembly root or product reference id
         assembly.name = object.name; // assembly root or product reference name
@@ -191,9 +197,10 @@ const logPoints = (points) => {
     if (points && points.length > 0) {
         for (let i = 0; i < points.length; i++) {
             for (let j = 0; j < points[i].length; j++) {
-                const x = Math.round(points[i][j].x * 1000) / 1000;
-                const y = Math.round(points[i][j].y * 1000) / 1000;
-                const z = Math.round(points[i][j].z * 1000) / 1000;
+                const point = resolveVec(points[i][j]);
+                const x = Math.round(point.x * 1000) / 1000;
+                const y = Math.round(point.y * 1000) / 1000;
+                const z = Math.round(point.z * 1000) / 1000;
                 log += '{ x: ' + x + ', y: ' + y + ', z: ' + z + '}';
                 log += points[i].length - 1 === j ? '' : ',';
             }
@@ -263,9 +270,9 @@ export default class CAD {
                                     name: dim.dimParam.dimName,
                                     label: dim.dimParam.dimLabel,
                                     value: dim.dimParam.dimValue,
-                                    startPos: dim.dimParam.dimStartPos,
-                                    endPos: dim.dimParam.dimEndPos,
-                                    textPos: dim.dimParam.dimTextPos,
+                                    startPos: resolveVec(dim.dimParam.dimStartPos),
+                                    endPos: resolveVec(dim.dimParam.dimEndPos),
+                                    textPos: resolveVec(dim.dimParam.dimTextPos),
                                     textAngle: dim.dimParam.dimTextAngle,
                                     orientation: dim.dimParam.dimOrientation,
                                     color: dim.dimParam.dimColor,
@@ -303,7 +310,10 @@ export default class CAD {
                 },
                 place2DViews: (productId, viewPositions) => {
                     return this.resolve(async ([rProductId]) => {
-                        return drawing2DAPI.place2DViews(drawingId, rProductId, viewPositions);
+                        return drawing2DAPI.place2DViews(drawingId, rProductId, viewPositions.map(({ viewType, vector }) => ({
+                            viewType,
+                            vector: resolveVec(vector),
+                        })));
                     }, productId);
                 },
                 exportDXF: (productId, dxfTemplateFilename) => {
@@ -424,7 +434,7 @@ export default class CAD {
                                     isExpr: typeof taperAngle === 'string',
                                 };
                                 const directionParam = {
-                                    value: direction,
+                                    value: resolveVec(direction),
                                     isExpr: typeof direction === 'string',
                                 };
                                 await featureAPI.updateExtrusion(drawingId, extrusion, sketchLines, type, limit1Param, limit2Param, taperAngleParam, directionParam, capEnds);
@@ -1094,11 +1104,11 @@ export default class CAD {
                         const wAId = await featureAPI.createWorkGeometry(drawingId, rPartId, CCClasses.CCWorkAxis, wAName);
                         if (wAId != null) {
                             const positionParam = {
-                                value: position,
+                                value: resolveVec(position),
                                 isExpr: typeof position === 'string',
                             };
                             const directionParam = {
-                                value: direction,
+                                value: resolveVec(direction),
                                 isExpr: typeof direction === 'string',
                             };
                             await featureAPI.updateWorkAxis(drawingId, wAId, type, rReferences, positionParam, directionParam, local);
@@ -1107,17 +1117,20 @@ export default class CAD {
                         return null;
                     }, partId, ...references);
                 },
-                createWorkCoordSystem: (partId, type, references, coordinateSystem, offset, rotation, inverted, local, name) => {
+                createWorkCoordSystem: (partId, type, references, coordinateSystem, offset, rotation, inverted = false, local = false, name) => {
                     return this.resolve(async ([rPartId, ...rReferences]) => {
                         const wCSName = name ? name : 'WorkCoordSystem';
                         const wCSId = await featureAPI.createWorkGeometry(drawingId, rPartId, CCClasses.CCWorkCoordSystem, wCSName);
                         if (wCSId != null) {
-                            const offsetParam = { value: offset, isExpr: typeof offset === 'string' };
+                            const offsetParam = {
+                                value: resolveVec(offset),
+                                isExpr: typeof offset === 'string',
+                            };
                             const rotationParam = {
-                                value: rotation,
+                                value: resolveVec(rotation),
                                 isExpr: typeof rotation === 'string',
                             };
-                            await featureAPI.updateWorkCoordSystem(drawingId, wCSId, type, rReferences, coordinateSystem, offsetParam, rotationParam, inverted, local);
+                            await featureAPI.updateWorkCoordSystem(drawingId, wCSId, type, rReferences, coordinateSystem.map(resolveVec), offsetParam, rotationParam, inverted ? 1 : 0, local);
                             return wCSId;
                         }
                         return null;
@@ -1131,10 +1144,13 @@ export default class CAD {
                             const offsetParam = { value: offset, isExpr: typeof offset === 'string' };
                             const angleParam = { value: angle, isExpr: typeof angle === 'string' };
                             const positionParam = {
-                                value: position,
+                                value: resolveVec(position),
                                 isExpr: typeof position === 'string',
                             };
-                            const normalParam = { value: normal, isExpr: typeof normal === 'string' };
+                            const normalParam = {
+                                value: resolveVec(normal),
+                                isExpr: typeof normal === 'string',
+                            };
                             await featureAPI.updateWorkPlane(drawingId, wPId, type, rReferences, offsetParam, angleParam, positionParam, normalParam, local);
                             return wPId;
                         }
@@ -1147,7 +1163,7 @@ export default class CAD {
                         const wPTId = await featureAPI.createWorkGeometry(drawingId, rPartId, CCClasses.CCWorkPoint, wPTName);
                         if (wPTId != undefined) {
                             const positionParam = {
-                                value: position,
+                                value: resolveVec(position),
                                 isExpr: typeof position === 'string',
                             };
                             await featureAPI.updateWorkPoint(drawingId, wPTId, type, rReferences, positionParam, local);
@@ -1185,7 +1201,7 @@ export default class CAD {
                                 break;
                         }
                         const geometries = positions
-                            ? await geometryAPI.findGeometriesByPoints(drawingId, rPartId, type, positions)
+                            ? await geometryAPI.findGeometriesByPoints(drawingId, rPartId, type, positions.map(p => p.map(resolveVec)))
                             : await waitForSelect(length, filter, (resolveSelection, items, diff) => {
                                 if (items.length > length - 1) {
                                     resolveSelection(items.map(i => i.data.graphicId));
@@ -1427,6 +1443,15 @@ export default class CAD {
                         return null;
                     }, partId);
                 },
+                getGeometryInformation: (objectId) => {
+                    return this.resolve(async ([rProductOrSolidId]) => {
+                        const values = await baseModelerAPI.getGeometryInformation(drawingId, rProductOrSolidId);
+                        if (values !== null) {
+                            return { centerOfGravity: values[0], volume: values[1] };
+                        }
+                        return null;
+                    }, objectId);
+                },
                 removeNodes: (...nodes) => {
                     return this.resolve(async ([...rNodes]) => {
                         return assemblyBuilderAPI.removeNodes(drawingId, rNodes);
@@ -1547,7 +1572,7 @@ export default class CAD {
                 },
                 pick: (partId, type, points) => {
                     return this.resolve(async ([rPartId]) => {
-                        const refs = await featureAPI.pick(drawingId, rPartId, type, points);
+                        const refs = await featureAPI.pick(drawingId, rPartId, type, points.map(resolveVec));
                         if (refs != undefined) {
                             return Array.isArray(refs) ? refs : [refs];
                         }

package/build/types/history.d.ts

@@ -1,6 +1,7 @@
 import { BooleanOperationType, ChamferType, FlipType, ReorientedType, WorkAxisType, WorkCoordSystemType, WorkPlaneType, WorkPointType, ViewType, OrientationType, ExtrusionType, BrepElemType, WorkGeomType, SVGModusType, LimitsParam, LimitedValue } from '@buerli.io/classcad';
 import { ObjectIdent, ObjectID, PointMemValue } from '@buerli.io/core';
 import { BufferGeometry, Group, Mesh, Scene } from 'three';
+export declare type Vec = number[] | PointMemValue | THREE.Vector3 | THREE.Euler;
 /**
  * History based modeling is similar to solid modeling, but it is non-destructive and
  * parametric. You can move back and forth in the modeling history and create feature
@@ -90,9 +91,9 @@ export declare type ApiHistory = {
             dimName?: string;
             dimLabel: string;
             dimValue?: number | null;
-            dimStartPos: PointMemValue;
-            dimEndPos: PointMemValue;
-            dimTextPos: PointMemValue;
+            dimStartPos: Vec;
+            dimEndPos: Vec;
+            dimTextPos: Vec;
             dimTextAngle: number;
             dimOrientation: OrientationType;
             dimColor?: number;
@@ -127,7 +128,7 @@ export declare type ApiHistory = {
      * // Returns for each view a min and max point
      * console.info(bbs) // [[{x: -105, y: -89, z: 0}, {x: 105, y: 55, z: 0}], [...], [...]]
      */
-    getBoundaryBoxFromViews: (productId: VID, viewTypes?: ViewType[]) => Promise<[PointMemValue, PointMemValue][]>;
+    getBoundaryBoxFromViews: (productId: VID, viewTypes?: ViewType[]) => Promise<[Vec, Vec][]>;
     /**
      * Place the 2D views relatively to the origin.
      * @param productId id of the product where the views will be placed in
@@ -141,7 +142,7 @@ export declare type ApiHistory = {
      */
     place2DViews: (productId: VID, viewPositions: {
         viewType: ViewType;
-        vector: PointMemValue;
+        vector: Vec;
     }[]) => Promise<void>;
     /**
      * Export the placed views as dxf file.
@@ -225,7 +226,7 @@ export declare type ApiHistory = {
      * @param direction Direction of extrusion
      * @param capEnds If true, ends will be capped, else a sheet will be created
      */
-    extrusion: (partId: VID, sketchOrRegionIds: VID | VIDs, type: ExtrusionType, limit1: number | string, limit2: number | string, taperAngle: number | string, direction: PointMemValue, capEnds: 0 | 1) => ID;
+    extrusion: (partId: VID, sketchOrRegionIds: VID | VIDs, type: ExtrusionType, limit1: number | string, limit2: number | string, taperAngle: number | string, direction: Vec, capEnds: 0 | 1) => ID;
     /**
      * Creates a revolve
      * @param partId Id of the part to create the revolve in.
@@ -748,7 +749,7 @@ export declare type ApiHistory = {
      * @param name name of the work axis, if not set default name = 'WorkAxis'
      * @example //tbd
      */
-    createWorkAxis: (partId: VID, type: WorkAxisType, references: VID[], position: PointMemValue, direction: PointMemValue, local: boolean, name?: string) => ID;
+    createWorkAxis: (partId: VID, type: WorkAxisType, references: VID[], position: Vec, direction: Vec, 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
@@ -792,7 +793,7 @@ export declare type ApiHistory = {
      * const geoms = await api.createBufferGeometry(rootAsm)
      * return geoms.map(geom => new THREE.Mesh(geom, new THREE.MeshStandardMaterial()))
      */
-    createWorkCoordSystem: (partId: VID, type: WorkCoordSystemType, references: VID[], coordinateSystem: PointMemValue[], offset: PointMemValue, rotation: PointMemValue, inverted: 0 | 1, local: boolean, name?: string) => ID;
+    createWorkCoordSystem: (partId: VID, type: WorkCoordSystemType, references: VID[], coordinateSystem: Vec[], offset: Vec, rotation: Vec, inverted: boolean, 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
@@ -806,7 +807,7 @@ export declare type ApiHistory = {
      * @param name name of the work plane, if not set default name = 'WorkAxis'
      * @example // tbd
      */
-    createWorkPlane: (partId: VID, type: WorkPlaneType, 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: Vec, normal: Vec, 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
@@ -818,7 +819,7 @@ export declare type ApiHistory = {
      * @param name name of the work point, if not set default name = 'WorkPoint'
      * @example // tbd
      */
-    createWorkPoint: (partId: VID, type: WorkPointType, references: VID[], position: PointMemValue, local: boolean, name?: string) => ID;
+    createWorkPoint: (partId: VID, type: WorkPointType, references: VID[], position: Vec, local: boolean, name?: string) => ID;
     /**
      * Deletes an existing expression.
      * @param partId id or identifier of part to delete expressions from
@@ -902,7 +903,7 @@ export declare type ApiHistory = {
      * @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;
+    findOrSelect: (partId: VID, type: BrepElemType, length: number, positions: Vec[][] | null) => IDs;
     /**
      * Returns the assembly with given name from assembly container.
      * If asmName is empty, all assemblies from assembly container will be returned.
@@ -1083,6 +1084,16 @@ export declare type ApiHistory = {
      * @example // tbd
      */
     getFeatureByName: (partId: VID, featureName: string) => ID;
+    /**
+     * Returns an object containing the center of gravity and the volume of the given
+     * product, node or solid. Depending on the input parameter the calculations were made
+     * on a single solid, a part, a subassembly, the whole model, ... E.g. the center of gravity of
+     * a root assembly, will be the sum of all solid's center of gravity over the whole assembly structure
+     *
+     * @param objectId id of the part, assembly, node or solid we want the information from
+     * @example // tbd
+     */
+    getGeometryInformation: (objectId: VID) => Promise<ModelInfo | null>;
     /**
      * Writes the current drawing to a stream and returns the data.
      *
@@ -1201,7 +1212,7 @@ export declare type ApiHistory = {
      * const geoms = await api.createBufferGeometry(part)
      * return geoms.map(geom => new THREE.Mesh(geom, new THREE.MeshStandardMaterial()))
      */
-    pick: (partId: VID, type: 'vertex' | 'edge' | 'face', points: PointMemValue[]) => IDs;
+    pick: (partId: VID, type: 'vertex' | 'edge' | 'face', points: Vec[]) => IDs;
     /**
      * Updates multiple expressions in different parts at once
      *
@@ -1258,6 +1269,10 @@ declare type Point = {
     y: number;
     z: number;
 };
+declare type ModelInfo = {
+    centerOfGravity: Vec;
+    volume: number;
+};
 declare type MateParam = {
     matePath: VID[];
     wcsId: VID;
@@ -1272,9 +1287,9 @@ export declare type DimensionType = {
         dimName?: string;
         dimLabel: string;
         dimValue?: number | null;
-        dimStartPos: PointMemValue;
-        dimEndPos: PointMemValue;
-        dimTextPos: PointMemValue;
+        dimStartPos: Vec;
+        dimEndPos: Vec;
+        dimTextPos: Vec;
         dimTextAngle: number;
         dimOrientation: OrientationType;
         dimColor?: number;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@buerli.io/headless",
-  "version": "0.6.0",
+  "version": "0.7.0",
   "description": "A non-manifold CAD workflow for the web",
   "author": "AWV Informatik AG <info@awv-informatik.ch>",
   "license": "ISC",
@@ -30,7 +30,7 @@
     "three": ">=0.138"
   },
   "dependencies": {
-    "@buerli.io/classcad": "0.6.0",
+    "@buerli.io/classcad": "0.7.0",
     "flat-promise": "^1.0.3"
   }
 }