@bitbybit-dev/base 0.19.8 → 0.20.0

package/lib/api/services/dates.js

@@ -0,0 +1,450 @@
+/**
+ * Contains various date methods.
+ */
+export class Dates {
+    /**
+     * Returns a date as a string value.
+     * @param inputs a date
+     * @returns date as string
+     * @group convert
+     * @shortname date to string
+     * @drawable false
+     */
+    toDateString(inputs) {
+        return inputs.date.toDateString();
+    }
+    /**
+     * Returns a date as a string value in ISO format.
+     * @param inputs a date
+     * @returns date as string
+     * @group convert
+     * @shortname date to iso string
+     * @drawable false
+     */
+    toISOString(inputs) {
+        return inputs.date.toISOString();
+    }
+    /**
+     * Returns a date as a string value in JSON format.
+     * @param inputs a date
+     * @returns date as string
+     * @group convert
+     * @shortname date to json
+     * @drawable false
+     */
+    toJSON(inputs) {
+        return inputs.date.toJSON();
+    }
+    /**
+     * Returns a string representation of a date. The format of the string depends on the locale.
+     * @param inputs a date
+     * @returns date as string
+     * @group convert
+     * @shortname date to locale string
+     * @drawable false
+     */
+    toString(inputs) {
+        return inputs.date.toString();
+    }
+    /**
+     * Returns a time as a string value.
+     * @param inputs a date
+     * @returns time as string
+     * @group convert
+     * @shortname date to time string
+     * @drawable false
+     */
+    toTimeString(inputs) {
+        return inputs.date.toTimeString();
+    }
+    /**
+     * Returns a date converted to a string using Universal Coordinated Time (UTC).
+     * @param inputs a date
+     * @returns date as utc string
+     * @group convert
+     * @shortname date to utc string
+     * @drawable false
+     */
+    toUTCString(inputs) {
+        return inputs.date.toUTCString();
+    }
+    /**
+     * Returns the current date and time.
+     * @returns date
+     * @group create
+     * @shortname now
+     * @drawable false
+     */
+    now() {
+        return new Date(Date.now());
+    }
+    /**
+     * Creates a new date object using the provided date params.
+     * @param inputs a date
+     * @returns date
+     * @group create
+     * @shortname create date
+     * @drawable false
+     */
+    createDate(inputs) {
+        return new Date(inputs.year, inputs.month, inputs.day, inputs.hours, inputs.minutes, inputs.seconds, inputs.milliseconds);
+    }
+    /**
+     * Returns the number of milliseconds between midnight, January 1, 1970 Universal Coordinated Time (UTC) (or GMT) and the specified date.
+     * @param inputs a date
+     * @returns date
+     * @group create
+     * @shortname create utc date
+     * @drawable false
+     */
+    createDateUTC(inputs) {
+        return new Date(Date.UTC(inputs.year, inputs.month, inputs.day, inputs.hours, inputs.minutes, inputs.seconds, inputs.milliseconds));
+    }
+    /**
+     * Creates a new date object using the provided unix time stamp.
+     * @param inputs a unix time stamp
+     * @returns date
+     * @group create
+     * @shortname create from unix timestamp
+     * @drawable false
+     */
+    createFromUnixTimeStamp(inputs) {
+        return new Date(inputs.unixTimeStamp);
+    }
+    /**
+     * Parses a string containing a date, and returns the number of milliseconds between that date and midnight, January 1, 1970.
+     * @param inputs a date string
+     * @returns the number of milliseconds between that date and midnight, January 1, 1970.
+     * @group parse
+     * @shortname parse date string
+     * @drawable false
+     */
+    parseDate(inputs) {
+        return Date.parse(inputs.dateString);
+    }
+    /**
+     * Gets the day-of-the-month, using local time.
+     * @returns date
+     * @group get
+     * @shortname get date of month
+     * @drawable false
+     */
+    getDayOfMonth(inputs) {
+        return inputs.date.getDate();
+    }
+    /**
+     * Gets the day of the week, using local time.
+     * @returns day
+     * @group get
+     * @shortname get weekday
+     * @drawable false
+     */
+    getWeekday(inputs) {
+        return inputs.date.getDay();
+    }
+    /**
+     * Gets the year, using local time.
+     * @returns year
+     * @group get
+     * @shortname get year
+     * @drawable false
+     */
+    getYear(inputs) {
+        return inputs.date.getFullYear();
+    }
+    /**
+     * Gets the month, using local time.
+     * @returns month
+     * @group get
+     * @shortname get month
+     * @drawable false
+     */
+    getMonth(inputs) {
+        return inputs.date.getMonth();
+    }
+    /**
+     * Gets the hours in a date, using local time.
+     * @returns hours
+     * @group get
+     * @shortname get hours
+     * @drawable false
+     */
+    getHours(inputs) {
+        return inputs.date.getHours();
+    }
+    /**
+     * Gets the minutes of a Date object, using local time.
+     * @returns minutes
+     * @group get
+     * @shortname get minutes
+     * @drawable false
+     */
+    getMinutes(inputs) {
+        return inputs.date.getMinutes();
+    }
+    /**
+     * Gets the seconds of a Date object, using local time.
+     * @returns seconds
+     * @group get
+     * @shortname get seconds
+     * @drawable false
+     */
+    getSeconds(inputs) {
+        return inputs.date.getSeconds();
+    }
+    /**
+     * Gets the milliseconds of a Date, using local time.
+     * @returns milliseconds
+     * @group get
+     * @shortname get milliseconds
+     * @drawable false
+     */
+    getMilliseconds(inputs) {
+        return inputs.date.getMilliseconds();
+    }
+    /**
+     * Returns the stored time value in milliseconds since midnight, January 1, 1970 UTC.
+     * @returns time
+     * @group get
+     * @shortname get time
+     * @drawable false
+     */
+    getTime(inputs) {
+        return inputs.date.getTime();
+    }
+    /**
+     * Gets the year using Universal Coordinated Time (UTC).
+     * @returns year
+     * @group get
+     * @shortname get utc year
+     * @drawable false
+     */
+    getUTCYear(inputs) {
+        return inputs.date.getUTCFullYear();
+    }
+    /**
+     * Gets the month of a Date object using Universal Coordinated Time (UTC).
+     * @returns month
+     * @group get
+     * @shortname get utc month
+     * @drawable false
+     */
+    getUTCMonth(inputs) {
+        return inputs.date.getUTCMonth();
+    }
+    /**
+     * Gets the day-of-the-month, using Universal Coordinated Time (UTC).
+     * @returns day
+     * @group get
+     * @shortname get utc day
+     * @drawable false
+     */
+    getUTCDay(inputs) {
+        return inputs.date.getUTCDate();
+    }
+    /**
+     * Gets the hours value in a Date object using Universal Coordinated Time (UTC).
+     * @returns hours
+     * @group get
+     * @shortname get utc hours
+     * @drawable false
+     */
+    getUTCHours(inputs) {
+        return inputs.date.getUTCHours();
+    }
+    /**
+     * Gets the minutes of a Date object using Universal Coordinated Time (UTC).
+     * @returns minutes
+     * @group get
+     * @shortname get utc minutes
+     * @drawable false
+     */
+    getUTCMinutes(inputs) {
+        return inputs.date.getUTCMinutes();
+    }
+    /**
+     * Gets the seconds of a Date object using Universal Coordinated Time (UTC).
+     * @returns seconds
+     * @group get
+     * @shortname get utc seconds
+     * @drawable false
+     */
+    getUTCSeconds(inputs) {
+        return inputs.date.getUTCSeconds();
+    }
+    /**
+     * Gets the milliseconds of a Date object using Universal Coordinated Time (UTC).
+     * @returns milliseconds
+     * @group get
+     * @shortname get utc milliseconds
+     * @drawable false
+     */
+    getUTCMilliseconds(inputs) {
+        return inputs.date.getUTCMilliseconds();
+    }
+    /**
+     * Sets the year of the Date object using local time.
+     * @param inputs a date and the year
+     * @returns date
+     * @group set
+     * @shortname set year
+     * @drawable false
+     * */
+    setYear(inputs) {
+        return new Date(inputs.date.setFullYear(inputs.year));
+    }
+    /**
+     * Sets the month value in the Date object using local time.
+     * @param inputs a date and the month
+     * @returns date
+     * @group set
+     * @shortname set month
+     * @drawable false
+     * */
+    setMonth(inputs) {
+        return new Date(inputs.date.setMonth(inputs.month));
+    }
+    /**
+     * Sets the numeric day-of-the-month value of the Date object using local time.
+     * @param inputs a date and the day
+     * @returns date
+     * @group set
+     * @shortname set day of month
+     * @drawable false
+     */
+    setDayOfMonth(inputs) {
+        return new Date(inputs.date.setDate(inputs.day));
+    }
+    /**
+     * Sets the hour value in the Date object using local time.
+     * @param inputs a date and the hours
+     * @returns date
+     * @group set
+     * @shortname set hours
+     * @drawable false
+     * */
+    setHours(inputs) {
+        return new Date(inputs.date.setHours(inputs.hours));
+    }
+    /**
+     * Sets the minutes value in the Date object using local time.
+     * @param inputs a date and the minutes
+     * @returns date
+     * @group set
+     * @shortname set minutes
+     * @drawable false
+     * */
+    setMinutes(inputs) {
+        return new Date(inputs.date.setMinutes(inputs.minutes));
+    }
+    /**
+     * Sets the seconds value in the Date object using local time.
+     * @param inputs a date and the seconds
+     * @returns date
+     * @group set
+     * @shortname set seconds
+     * @drawable false
+     */
+    setSeconds(inputs) {
+        return new Date(inputs.date.setSeconds(inputs.seconds));
+    }
+    /**
+     * Sets the milliseconds value in the Date object using local time.
+     * @param inputs a date and the milliseconds
+     * @returns date
+     * @group set
+     * @shortname set milliseconds
+     * @drawable false
+     */
+    setMilliseconds(inputs) {
+        return new Date(inputs.date.setMilliseconds(inputs.milliseconds));
+    }
+    /**
+     * Sets the date and time value in the Date object.
+     * @param inputs a date and the time
+     * @returns date
+     * @group set
+     * @shortname set time
+     * @drawable false
+     */
+    setTime(inputs) {
+        return new Date(inputs.date.setTime(inputs.time));
+    }
+    /**
+     * Sets the year value in the Date object using Universal Coordinated Time (UTC).
+     * @param inputs a date and the year
+     * @returns date
+     * @group set
+     * @shortname set utc year
+     * @drawable false
+     * */
+    setUTCYear(inputs) {
+        return new Date(inputs.date.setUTCFullYear(inputs.year));
+    }
+    /**
+     * Sets the month value in the Date object using Universal Coordinated Time (UTC).
+     * @param inputs a date and the month
+     * @returns date
+     * @group set
+     * @shortname set utc month
+     * @drawable false
+     * */
+    setUTCMonth(inputs) {
+        return new Date(inputs.date.setUTCMonth(inputs.month));
+    }
+    /**
+     * Sets the numeric day of the month in the Date object using Universal Coordinated Time (UTC).
+     * @param inputs a date and the day
+     * @returns date
+     * @group set
+     * @shortname set utc day
+     * @drawable false
+     */
+    setUTCDay(inputs) {
+        return new Date(inputs.date.setUTCDate(inputs.day));
+    }
+    /**
+     * Sets the hours value in the Date object using Universal Coordinated Time (UTC).
+     * @param inputs a date and the hours
+     * @returns date
+     * @group set
+     * @shortname set utc hours
+     * @drawable false
+     * */
+    setUTCHours(inputs) {
+        return new Date(inputs.date.setUTCHours(inputs.hours));
+    }
+    /**
+     * Sets the minutes value in the Date object using Universal Coordinated Time (UTC).
+     * @param inputs a date and the minutes
+     * @returns date
+     * @group set
+     * @shortname set utc minutes
+     * @drawable false
+     * */
+    setUTCMinutes(inputs) {
+        return new Date(inputs.date.setUTCMinutes(inputs.minutes));
+    }
+    /**
+     * Sets the seconds value in the Date object using Universal Coordinated Time (UTC).
+     * @param inputs a date and the seconds
+     * @returns date
+     * @group set
+     * @shortname set utc seconds
+     * @drawable false
+     */
+    setUTCSeconds(inputs) {
+        return new Date(inputs.date.setUTCSeconds(inputs.seconds));
+    }
+    /**
+     * Sets the milliseconds value in the Date object using Universal Coordinated Time (UTC).
+     * @param inputs a date and the milliseconds
+     * @returns date
+     * @group set
+     * @shortname set utc milliseconds
+     * @drawable false
+     */
+    setUTCMilliseconds(inputs) {
+        return new Date(inputs.date.setUTCMilliseconds(inputs.milliseconds));
+    }
+}

package/lib/api/services/geometry-helper.d.ts

@@ -0,0 +1,15 @@
+import * as Inputs from "../inputs";
+export declare class GeometryHelper {
+    transformControlPoints(transformation: number[][] | number[][][], transformedControlPoints: Inputs.Base.Point3[]): Inputs.Base.Point3[];
+    getFlatTransformations(transformation: number[][] | number[][][]): number[][];
+    getArrayDepth: (value: any) => number;
+    transformPointsByMatrixArray(points: Inputs.Base.Point3[], transform: number[]): Inputs.Base.Point3[];
+    transformPointsCoordinates(points: Inputs.Base.Point3[], transform: number[]): Inputs.Base.Point3[];
+    removeAllDuplicateVectors(vectors: number[][], tolerance?: number): number[][];
+    removeConsecutiveVectorDuplicates(vectors: number[][], checkFirstAndLast?: boolean, tolerance?: number): number[][];
+    vectorsTheSame(vec1: number[], vec2: number[], tolerance: number): boolean;
+    approxEq(num1: number, num2: number, tolerance: number): boolean;
+    removeConsecutivePointDuplicates(points: Inputs.Base.Point3[], checkFirstAndLast?: boolean, tolerance?: number): Inputs.Base.Point3[];
+    arePointsTheSame(pointA: Inputs.Base.Point3 | Inputs.Base.Point2, pointB: Inputs.Base.Point3 | Inputs.Base.Point2, tolerance: number): boolean;
+    private transformCoordinates;
+}

package/lib/api/services/{geometry-helper.ts → geometry-helper.js}

@@ -1,41 +1,34 @@
-import * as Inputs from "../inputs";
-
 export class GeometryHelper {
-
-    transformControlPoints(transformation: number[][] | number[][][], transformedControlPoints: Inputs.Base.Point3[]): Inputs.Base.Point3[] {
+    constructor() {
+        this.getArrayDepth = (value) => {
+            return Array.isArray(value) ?
+                1 + Math.max(...value.map(this.getArrayDepth)) :
+                0;
+        };
+    }
+    transformControlPoints(transformation, transformedControlPoints) {
         const transformationArrays = this.getFlatTransformations(transformation);
-
         transformationArrays.forEach(transform => {
-
             transformedControlPoints = this.transformPointsByMatrixArray(transformedControlPoints, transform);
         });
         return transformedControlPoints;
     }
-
-    getFlatTransformations(transformation: number[][] | number[][][]): number[][] {
+    getFlatTransformations(transformation) {
         let transformationArrays = [];
-
         if (this.getArrayDepth(transformation) === 3) {
             transformation.forEach(transform => {
                 transformationArrays.push(...transform);
             });
-        } else {
+        }
+        else {
             transformationArrays = transformation;
         }
         return transformationArrays;
-}
-
-    getArrayDepth = (value): number => {
-        return Array.isArray(value) ?
-            1 + Math.max(...value.map(this.getArrayDepth)) :
-            0;
-    };
-
-    transformPointsByMatrixArray(points: Inputs.Base.Point3[], transform: number[]): Inputs.Base.Point3[] {
+    }
+    transformPointsByMatrixArray(points, transform) {
         return this.transformPointsCoordinates(points, transform);
     }
-
-    transformPointsCoordinates(points: Inputs.Base.Point3[], transform: number[]): Inputs.Base.Point3[] {
+    transformPointsCoordinates(points, transform) {
         const transformedPoints = [];
         for (const pt of points) {
             const transformedVector = this.transformCoordinates(pt[0], pt[1], pt[2], transform);
@@ -43,10 +36,9 @@ export class GeometryHelper {
         }
         return transformedPoints;
     }
-
     // Algorithm works with arbitrary length numeric vectors. This algorithm is more costly for longer arrays of vectors
-    removeAllDuplicateVectors(vectors: number[][], tolerance = 1e-7): number[][] {
-        const cleanVectors: number[][] = [];
+    removeAllDuplicateVectors(vectors, tolerance = 1e-7) {
+        const cleanVectors = [];
         vectors.forEach(vector => {
             // when there are no vectors in cleanVectors array that match the current vector, push it in.
             if (!cleanVectors.some(s => this.vectorsTheSame(vector, s, tolerance))) {
@@ -55,10 +47,9 @@ export class GeometryHelper {
         });
         return cleanVectors;
     }
-
     // Algorithm works with arbitrary length numeric vectors. 
-    removeConsecutiveVectorDuplicates(vectors: number[][], checkFirstAndLast = true, tolerance = 1e-7): number[][] {
-        const vectorsRemaining: number[][] = [];
+    removeConsecutiveVectorDuplicates(vectors, checkFirstAndLast = true, tolerance = 1e-7) {
+        const vectorsRemaining = [];
         if (vectors.length > 1) {
             for (let i = 1; i < vectors.length; i++) {
                 const currentVector = vectors[i];
@@ -77,17 +68,18 @@ export class GeometryHelper {
                     vectorsRemaining.pop();
                 }
             }
-        } else if (vectors.length === 1) {
+        }
+        else if (vectors.length === 1) {
             vectorsRemaining.push(...vectors);
         }
         return vectorsRemaining;
     }
-
-    vectorsTheSame(vec1: number[], vec2: number[], tolerance: number) {
+    vectorsTheSame(vec1, vec2, tolerance) {
         let result = false;
         if (vec1.length !== vec2.length) {
             return result;
-        } else {
+        }
+        else {
             result = true;
             for (let i = 0; i < vec1.length; i++) {
                 if (!this.approxEq(vec1[i], vec2[i], tolerance)) {
@@ -98,13 +90,11 @@ export class GeometryHelper {
         }
         return result;
     }
-
-    approxEq(num1: number, num2: number, tolerance: number): boolean {
+    approxEq(num1, num2, tolerance) {
         const res = Math.abs(num1 - num2) < tolerance;
         return res;
     }
-
-    removeConsecutivePointDuplicates(points: Inputs.Base.Point3[], checkFirstAndLast = true, tolerance = 1e-7): Inputs.Base.Point3[] {
+    removeConsecutivePointDuplicates(points, checkFirstAndLast = true, tolerance = 1e-7) {
         const pointsRemaining = [];
         if (points.length > 1) {
             for (let i = 1; i < points.length; i++) {
@@ -124,20 +114,21 @@ export class GeometryHelper {
                     pointsRemaining.pop();
                 }
             }
-        } else if (points.length === 1) {
+        }
+        else if (points.length === 1) {
             pointsRemaining.push(...points);
         }
         return pointsRemaining;
     }
-
-    arePointsTheSame(pointA: Inputs.Base.Point3 | Inputs.Base.Point2, pointB: Inputs.Base.Point3 | Inputs.Base.Point2, tolerance: number): boolean {
+    arePointsTheSame(pointA, pointB, tolerance) {
         let result = false;
         if (pointA.length === 2 && pointB.length === 2) {
             if (this.approxEq(pointA[0], pointB[0], tolerance) &&
                 this.approxEq(pointA[1], pointB[1], tolerance)) {
                 result = true;
             }
-        } else if (pointA.length === 3 && pointB.length === 3) {
+        }
+        else if (pointA.length === 3 && pointB.length === 3) {
             if (this.approxEq(pointA[0], pointB[0], tolerance) &&
                 this.approxEq(pointA[1], pointB[1], tolerance) &&
                 this.approxEq(pointA[2], pointB[2], tolerance)) {
@@ -146,18 +137,15 @@ export class GeometryHelper {
         }
         return result;
     }
-
-    private transformCoordinates(x: number, y: number, z: number, transformation: number[]): Inputs.Base.Vector3 {
+    transformCoordinates(x, y, z, transformation) {
         const m = transformation;
         const rx = x * m[0] + y * m[4] + z * m[8] + m[12];
         const ry = x * m[1] + y * m[5] + z * m[9] + m[13];
         const rz = x * m[2] + y * m[6] + z * m[10] + m[14];
         const rw = 1 / (x * m[3] + y * m[7] + z * m[11] + m[15]);
-
         const newx = rx * rw;
         const newy = ry * rw;
         const newz = rz * rw;
         return [newx, newy, newz];
     }
-
 }

package/lib/api/services/{index.ts → index.d.ts}

@@ -4,6 +4,7 @@ export * from "./logic";
 export * from "./math";
 export * from "./point";
 export * from "./text";
+export * from "./dates";
 export * from "./vector";
 export * from "./transforms";
-export * from "./geometry-helper";
+export * from "./geometry-helper";

package/lib/api/services/index.js

@@ -0,0 +1,10 @@
+export * from "./color";
+export * from "./lists";
+export * from "./logic";
+export * from "./math";
+export * from "./point";
+export * from "./text";
+export * from "./dates";
+export * from "./vector";
+export * from "./transforms";
+export * from "./geometry-helper";