@colijnit/sharedcomponents 261.1.0 → 261.1.2

package/projects/sharedcomponents/src/lib/utils/array-utils.ts

@@ -0,0 +1,225 @@
+import {ObjectUtils} from "./object-utils";
+import {NumberUtils} from "./number-utils";
+import {isNill} from "./is-nill.function";
+import {notNill} from "./function/not-nill.function";
+
+export class ArrayUtils {
+    /**
+     * Returns whether at least one element in given array could be found by given finder function.
+     *
+     * @param {T[]} array
+     * @param {(element: T) => boolean} finder A finder function that takes an element of the array and returns a boolean that represents
+     * the 'found status' for that element; whether it should have been found or not.
+     */
+    public static ContainsAnElementFoundBy<T>(array: T[], finder: (element: T) => boolean): boolean {
+        if (!array || !finder) {
+            return false;
+        }
+
+        return notNill(this.Find<T>(array, finder));
+    }
+
+    /**
+     * Cross-browser Array.find() function. Returns the first item in given array for which the foundBy function returns true. Returns
+     * undefined when none was found.
+     *
+     * Example usage:
+     * const foundItem: BusinessObject = ArrayUtils.Find<BusinessObject>(modelArray, (modelItem: BusinessObject) => <br>
+     *     (return modelItem.getId() === '1')
+     *   * });
+     *
+     * @param array The array with items to search in.
+     * @param foundBy The finder function applied on each items of the array, when that returns true, the item is considered found.
+     */
+    public static Find<T>(array: T[], foundBy: (item: T) => boolean): T {
+        if (!array || !foundBy) {
+            return undefined;
+        }
+
+        for (let i: number = 0, len: number = array.length; i < len; i++) {
+            const itemCur: T = array[i];
+            if (foundBy(itemCur) ) {
+                return itemCur;
+            }
+        }
+        return undefined;
+    }
+
+    // @returns empty array when nothing found, otherwise array with found items
+    public static FindAll<T>(array: T[], foundBy: (item: T) => boolean): T[] {
+        const answer: T[] = [];
+        if (!array || !foundBy) {
+            return answer;
+        }
+
+        for (let i: number = 0, len: number = array.length; i < len; i++) {
+            const itemCur: T = array[i];
+            if (foundBy(itemCur)) {
+                answer.push(itemCur);
+            }
+        }
+        return answer;
+    }
+
+    // returns a simple clone of given array, using array.slice(0)
+    public static CloneArray<T>(array: T[]): T[] {
+        let answer: T[] = [];
+
+        if (array) {
+            answer = array.slice(0);
+        }
+
+        return answer;
+    }
+
+    /**
+     * Returns a 'semi deep clone' of given array. Its first-level members are object-shallow-cloned (optionally with a strongly typed constructor),
+     * or just as plain object (see param arrayItemsClass).
+     * @param array
+     * @param arrayItemsClass If provided, the cloned array's first-level items will be strongly typed to / constructed as this class. Otherwise
+     * it'll be a plain object.
+     * @param deepClone Set to true if array items contain FUNCTIONS that need to be cloned..
+     * @returns {Array} semi-deep clone of given array
+     */
+    public static CloneArrayAndItsItems<T>(array: T[], arrayItemsClass?: any, deepClone: boolean = false): T[] {
+        const cloneArray: T[] = [];
+
+        if (array) {
+            for (let i: number = 0, len: number = array.length; i < len; i++) {
+                if (deepClone) {
+                    cloneArray.push(ObjectUtils.GetDeepClone(array[i]));
+                } else {
+                    cloneArray.push(ObjectUtils.GetShallowClone(array[i], arrayItemsClass));
+                }
+            }
+        } else {
+            return [];
+        }
+
+        return cloneArray;
+    }
+
+    /**
+     * Removes element at given index from given array. Doesn't just set it to null like JavaScripts standard 'delete' does, but really
+     * removes the element using splice().
+     *
+     * @param {number} index
+     * @param {any[]} array in-out
+     * @returns {boolean} True if and only if the element on given index is succesfully removed from given array.
+     */
+    public static RemoveElementAtIndex(index: number, array: any[]): boolean {
+        if (NumberUtils.IsNaN(index) || index < 0 || !Array.isArray(array) || array.length === 0) {
+            return false;
+        }
+
+        if (index in array) {
+            array.splice(index, 1);
+            return true;
+        } else {
+            return false;
+        }
+    }
+
+    /**
+     * Removes given element from given array. Doesn't just set it to null like JavaScripts standard 'delete' does, but really removes the
+     * element using splice(). Also works on associative arrays.
+     *
+     * @param {T} element The element to remove.
+     * @param {T[]} array The array to remove the element from.
+     * @returns {boolean} True iff given element was truly successfully removed from given array.
+     */
+    public static RemoveElement<T>(element: T, array: T[]): boolean {
+        if (!Array.isArray(array)) {
+            return false;
+        }
+
+        const index: number = array.indexOf(element);
+        return ArrayUtils.RemoveElementAtIndex(index, array);
+    }
+
+    // Checks if given array is defined, and is an array, and has length > 0, and, optionally checks that the first element is of type given clazz.
+    public static IsArrayWithElements<T>(arrayToCheck: T[], classItemsMustBeInstanceOf?: any): boolean {
+        if (isNill(arrayToCheck)) {
+            return false;
+        }
+
+        if (Array.isArray(arrayToCheck) && arrayToCheck.length > 0) {
+            if (classItemsMustBeInstanceOf) {
+                return arrayToCheck[0] instanceof classItemsMustBeInstanceOf;
+            } else {
+                return true;
+            }
+        } else {
+            return false;
+        }
+    }
+
+    // Removes all elements from given array for which given filter function holds true. Returns true if at least one removed, else false.
+    public static RemoveElementsByFilter(array: any[], filterFunction: (item: any) => boolean): boolean {
+        if (!ArrayUtils.IsArrayWithElements(array) || !filterFunction) {
+            return false;
+        }
+
+        let atLeastOneRemoved: boolean = false;
+
+        const len: number = array.length;
+        for (let i: number = len - 1; i >= 0; i--) {
+            const item: any = array[i];
+            if (filterFunction.call(this, item) === true) {
+                array.splice(i, 1);
+                atLeastOneRemoved = true;
+            }
+        }
+
+        return atLeastOneRemoved;
+    }
+
+    public static MoveElement<T>(element: T, toIndex: number, array: T[]): boolean {
+        if (!Array.isArray(array) || isNill(toIndex)) {
+            return false;
+        }
+
+        const fromIndex: number = array.indexOf(element);
+        const toIndexCorrected: number = NumberUtils.GetNearestNumberWithinBounds(toIndex, 0, array.length - 1);
+        if (fromIndex === -1 || array[toIndexCorrected] === element) {
+            // element did not exist in given array, or already existed on given toIndex
+            return false;
+        }
+        array.splice(toIndexCorrected, 0, array.splice(fromIndex, 1)[0]);
+        return true;
+    }
+
+    // PRE: elements exists in given array. POST: given elementToPlace has a lower index than given afterThisElement. Array is in-out manipulated.
+    public static PlaceElementAfterOther(array: any[], elementToPlace: any, afterThisElement: any): void {
+        if (array) {
+            const afterThisElIdx: number = array.indexOf(afterThisElement);
+            const elToPlaceIdx: number = array.indexOf(elementToPlace);
+            if (afterThisElIdx >= elToPlaceIdx) {
+                ArrayUtils.MoveElement(elementToPlace, afterThisElIdx + 1, array);
+            }
+        }
+    }
+
+  /**
+   * Returns max value from all resulting values from applying given itemValueFunction to all items of given array.
+   * @param array
+   * @param itemValueFunction The function applied to each array item that gives it a numerical value. The max num val found is returned.
+   */
+  public static GetMaxCalculatedValue<T>(array: T[], itemValueFunction: (item: T) => number): number {
+    if (!array || !itemValueFunction) {
+      return NaN;
+    }
+
+    let max: number = undefined;
+
+    const len: number = array.length;
+    for (let i: number = 0; i < len; i++) {
+      const valueCur: number = itemValueFunction.call(this);
+      if (valueCur > max) {
+        max = valueCur;
+      }
+    }
+
+    return max;
+  }
+}

package/projects/sharedcomponents/src/lib/utils/browser-utils.ts

@@ -0,0 +1,124 @@
+
+import {ElementRef} from "@angular/core";
+import {ElementPosition} from "@colijnit/corecomponents_v12/lib/core/model/element-position";
+
+export class BrowserUtils {
+    public static ScrollToTop(nativeElement: any, milliSeconds: number = 200): void {
+        return BrowserUtils._ScrollTo("scrollTop", nativeElement, milliSeconds, 0);
+    }
+
+    public static DownloadFile(encodedUri: string, fileType: string): void {
+        const link: HTMLAnchorElement = document.createElement("a");
+        const date: string = new Date().toDateString();
+
+        link.href = encodedUri;
+        link.target = "_blank";
+        link.download = "export_" + date + fileType;
+
+        document.body.appendChild(link);
+        link.click();
+        document.body.removeChild(link);
+    }
+
+    public static CopyToClipboard(data: string): void {
+
+        const textArea: any = document.createElement("TEXTAREA");
+        const textNode: any = document.createTextNode(data);
+
+        textArea.appendChild(textNode);
+        document.body.appendChild(textArea); // Required for FF
+        textArea.select();
+        document.execCommand("copy");
+        document.body.removeChild(textArea);
+    }
+
+    public static TabFocusNextElement(): void {
+        const nextTabStop: any = BrowserUtils._FindNextTabStop(document.activeElement);
+        if (nextTabStop) {
+            nextTabStop.focus();
+        }
+    }
+
+    public static AreDimensionsInView(dimensions: ElementPosition, view?: ElementRef): boolean {
+        const vp: ElementPosition = BrowserUtils.GetDimensions(view);
+
+        return dimensions.top >= vp.top && dimensions.left >= vp.left && dimensions.bottom <= vp.bottom && dimensions.right <= vp.right;
+    }
+
+    public static HorizontalFitInView(dimensions: ElementPosition, view?: ElementRef): boolean {
+        const vp: ElementPosition = BrowserUtils.GetDimensions(view);
+
+        return dimensions.left >= vp.left && dimensions.right <= vp.right;
+    }
+
+    public static VerticalFitInView(dimensions: ElementPosition, view?: ElementRef): boolean {
+        const vp: ElementPosition = BrowserUtils.GetDimensions(view);
+
+        return dimensions.top >= vp.top && dimensions.bottom <= vp.bottom;
+    }
+
+    public static GetViewport(): ElementPosition {
+
+        let viewPortWidth: number;
+        let viewPortHeight: number;
+
+        // the more standards compliant browsers (mozilla/netscape/opera/IE7) use window.innerWidth and window.innerHeight
+        if (typeof window.innerWidth !== "undefined") {
+            viewPortWidth = window.innerWidth;
+            viewPortHeight = window.innerHeight;
+        } else if (typeof document.documentElement !== "undefined" &&
+            typeof document.documentElement.clientWidth !== "undefined" &&
+            document.documentElement.clientWidth !== 0) {
+            viewPortWidth = document.documentElement.clientWidth;
+            viewPortHeight = document.documentElement.clientHeight;
+        } else {
+            viewPortWidth = document.getElementsByTagName("body")[0].clientWidth;
+            viewPortHeight = document.getElementsByTagName("body")[0].clientHeight;
+        }
+
+        return {left: 0, top: 0, right: viewPortWidth, bottom: viewPortHeight};
+    }
+
+    public static GetDimensions(view?: ElementRef): ElementPosition {
+        if (!view) {
+            return this.GetViewport();
+        } else {
+            const elem: HTMLElement = view instanceof HTMLElement ? view : view.nativeElement;
+            const cr: ClientRect = elem.getBoundingClientRect();
+            return {left: cr.left, top: cr.top, right: cr.right, bottom: cr.bottom};
+        }
+    }
+
+    // Recursive.
+    private static _ScrollTo(elementScrollProp: string, element: any, milliSeconds: number, toScrollEnd: number): void {
+        if (!element || milliSeconds <= 0) {
+            return;
+        }
+
+        const difference: number = toScrollEnd - element[elementScrollProp];
+        const scrollPerTick: number = difference / milliSeconds * 10;
+
+        setTimeout(() => {
+            element[elementScrollProp] = element[elementScrollProp] + scrollPerTick;
+            if (element[elementScrollProp] === toScrollEnd) {
+                return;
+            }
+            BrowserUtils._ScrollTo(elementScrollProp, element, milliSeconds - 10, toScrollEnd);
+        }, 10);
+    }
+
+    private static _FindNextTabStop(element: Element): Element {
+        const tabStopElements: NodeListOf<Element> = document.querySelectorAll(
+            "a[href], area[href], input:not(.hidden):not(.disabled):not(.readonly):not(.read-only), select:not(.hidden):not(.disabled):not(.readonly):not(.read-only), textarea:not(.hidden):not(.disabled):not(.readonly):not(.read-only), button:not(.hidden):not(.disabled):not(.readonly):not(.read-only), iframe, object, embed, *[tabindex]:not(.hidden):not(.disabled):not(.readonly):not(.read-only), *[contenteditable]:not(.hidden):not(.disabled):not(.readonly):not(.read-only)"
+        );
+        const actualStopEls: Element[] = [];
+        for (let i: number = 0, len: number = tabStopElements.length; i < len; i++) {
+            const tabEl: any = tabStopElements[i];
+            if (tabEl.tabIndex >= 0) {
+                actualStopEls.push(tabEl);
+            }
+        }
+        const elIdx: number = actualStopEls.indexOf(element);
+        return actualStopEls[elIdx + 1] || undefined;
+    }
+}

package/projects/sharedcomponents/src/lib/utils/calendar.utils.ts

@@ -0,0 +1,199 @@
+import {DateUtils} from "./date-utils";
+import {Weekday} from "../model/weekday.model";
+import {Inject, LOCALE_ID} from "@angular/core";
+import {LanguageCode} from "../enum/language-code.enum";
+import {Week} from "../model/week.model";
+
+export class CalendarUtils {
+    public static Locale: LanguageCode = undefined;
+
+    public static Now: Date = new Date();
+
+    constructor(
+        @Inject(LOCALE_ID) private readonly _locale: LanguageCode
+    ) {
+        CalendarUtils.Locale = _locale;
+    }
+
+    // public static GetCurrentYear(): number {
+    //     return this.Now.getFullYear();
+    // }
+    //
+    // public static GetCurrentMonth(): number {
+    //     return this.Now.getUTCMonth() + 1;
+    // }
+
+    public static GetDayHours(day: Date): Date[] {
+        const datesByTheHour: Date[] = [];
+        if (day) {
+            let newDate: Date = new Date(day);
+            newDate.setHours(0, 0, 0, 0);
+            datesByTheHour.push(newDate);
+            for (let i: number = 0; i < 23; i++) {
+                newDate = new Date(newDate);
+                newDate.setHours(newDate.getHours() + 1);
+                datesByTheHour.push(newDate);
+            }
+        }
+        return datesByTheHour;
+    }
+
+    public static GetDaysOfWeek(date: Date): Week {
+      let day = date ? new Date(date) : new Date();
+      day = CalendarUtils.getMonday(day);
+        const daysOfWeek: Weekday[] = [];
+        let options: any;
+        let month: number;
+        for (let i: number = 0; i < 7; i++) {
+            const dayPerWeek: Weekday = new Weekday();
+            const dayHours: Date[] = CalendarUtils.GetDayHours(day);
+            dayPerWeek.newMonth = day.getMonth() !== month;
+            dayPerWeek.weekdaySelected = day.getDay() === date.getDay();
+            dayPerWeek.weekdayDay = day.getDate();
+            options = { weekday: "short" };
+            dayPerWeek.weekdayShort = day.toLocaleDateString(CalendarUtils.Locale, options);
+            options = { weekday: "long" };
+            dayPerWeek.weekdayLong = day.toLocaleDateString(CalendarUtils.Locale, options);
+
+            options = { month: "short" };
+            dayPerWeek.weekdayMonthShort = day.toLocaleDateString(CalendarUtils.Locale, options);
+            options = { month: "long" };
+            dayPerWeek.weekdayMonthLong = day.toLocaleDateString(CalendarUtils.Locale, options);
+            dayPerWeek.weekdayYear = day.getFullYear();
+
+            dayPerWeek.date = new Date(day);
+            dayPerWeek.datesByTheHour = dayHours;
+            daysOfWeek.push(dayPerWeek);
+            month = day.getMonth();
+            day = new Date(day);
+            day.setDate(day.getDate() + 1);
+        }
+        const week: Week = new Week();
+        week.weekDays = daysOfWeek;
+        return week;
+    }
+
+  public static GetWorkDaysOfWeek(date: Date): Week {
+    let day = date ? new Date(date) : new Date();
+    day = CalendarUtils.getMonday(day);
+    const daysOfWeek: Weekday[] = [];
+    let options: any;
+    let month: number;
+    for (let i: number = 0; i < 5; i++) {
+      const dayPerWeek: Weekday = new Weekday();
+      const dayHours: Date[] = CalendarUtils.GetDayHours(day);
+      dayPerWeek.newMonth = day.getMonth() !== month;
+      dayPerWeek.weekdaySelected = day.getDay() === date.getDay();
+      dayPerWeek.weekdayDay = day.getDate();
+      options = { weekday: "short" };
+      dayPerWeek.weekdayShort = day.toLocaleDateString(CalendarUtils.Locale, options);
+      options = { weekday: "long" };
+      dayPerWeek.weekdayLong = day.toLocaleDateString(CalendarUtils.Locale, options);
+
+      options = { month: "short" };
+      dayPerWeek.weekdayMonthShort = day.toLocaleDateString(CalendarUtils.Locale, options);
+      options = { month: "long" };
+      dayPerWeek.weekdayMonthLong = day.toLocaleDateString(CalendarUtils.Locale, options);
+      dayPerWeek.weekdayYear = day.getFullYear();
+
+      dayPerWeek.date = new Date(day);
+      dayPerWeek.datesByTheHour = dayHours;
+      daysOfWeek.push(dayPerWeek);
+      month = day.getMonth();
+      day = new Date(day);
+      day.setDate(day.getDate() + 1);
+    }
+    const week: Week = new Week();
+    week.weekDays = daysOfWeek;
+    return week;
+  }
+  public static GetThreeDays(date: Date): Week {
+    let day;
+    if(!date) {
+      day = new Date();
+    } else {
+      day = date;
+    }
+    const daysOfWeek: Weekday[] = [];
+    let options: any;
+    let month: number;
+    for (let i: number = 0; i < 3; i++) {
+      const dayPerWeek: Weekday = new Weekday();
+      const dayHours: Date[] = CalendarUtils.GetDayHours(day);
+      dayPerWeek.newMonth = day.getMonth() !== month;
+      dayPerWeek.weekdaySelected = day.getDay() === date.getDay();
+      dayPerWeek.weekdayDay = day.getDate();
+      options = { weekday: "short" };
+      dayPerWeek.weekdayShort = day.toLocaleDateString(CalendarUtils.Locale, options);
+      options = { weekday: "long" };
+      dayPerWeek.weekdayLong = day.toLocaleDateString(CalendarUtils.Locale, options);
+
+      options = { month: "short" };
+      dayPerWeek.weekdayMonthShort = day.toLocaleDateString(CalendarUtils.Locale, options);
+      options = { month: "long" };
+      dayPerWeek.weekdayMonthLong = day.toLocaleDateString(CalendarUtils.Locale, options);
+      dayPerWeek.weekdayYear = day.getFullYear();
+
+      dayPerWeek.date = new Date(day);
+      dayPerWeek.datesByTheHour = dayHours;
+      daysOfWeek.push(dayPerWeek);
+      month = day.getMonth();
+      day = new Date(day);
+      day.setDate(day.getDate() + 1);
+    }
+    const week: Week = new Week();
+    week.weekDays = daysOfWeek;
+    return week;
+  }
+  public static GetDaysAround(date: Date): Week {
+    const daysAround: Weekday[] = [];
+    const currentDate = date ? new Date(date) : new Date();
+    currentDate.setHours(0, 0, 0, 0);
+
+    // Get the current day and go two days back
+    let day = new Date(currentDate);
+    day.setDate(day.getDate() - 2);
+
+    // Loop to get the two days before and four days after the current day
+    for (let i = 0; i < 7; i++) {
+      const dayPerWeek: Weekday = new Weekday();
+      const dayHours: Date[] = CalendarUtils.GetDayHours(day);
+
+      dayPerWeek.newMonth = day.getMonth() !== currentDate.getMonth();
+      dayPerWeek.weekdaySelected = day.getDate() === currentDate.getDate();
+      dayPerWeek.weekdayDay = day.getDate();
+
+      let options: any = { weekday: "short" };
+      dayPerWeek.weekdayShort = day.toLocaleDateString(CalendarUtils.Locale, options);
+      options = { weekday: "long" };
+      dayPerWeek.weekdayLong = day.toLocaleDateString(CalendarUtils.Locale, options);
+
+      options = { month: "short" };
+      dayPerWeek.weekdayMonthShort = day.toLocaleDateString(CalendarUtils.Locale, options);
+      options = { month: "long" };
+      dayPerWeek.weekdayMonthLong = day.toLocaleDateString(CalendarUtils.Locale, options);
+      dayPerWeek.weekdayYear = day.getFullYear();
+
+      dayPerWeek.date = new Date(day);
+      dayPerWeek.datesByTheHour = dayHours;
+      daysAround.push(dayPerWeek);
+
+      // Move to the next day
+      day.setDate(day.getDate() + 1);
+    }
+
+    const week: Week = new Week();
+    week.weekDays = daysAround;
+    return week;
+  }
+
+  private static getMonday(date: Date): Date {
+    const d = new Date(date);
+    const day = d.getDay(); // 0 (Sun) - 6 (Sat)
+    const diff = (day === 0 ? -6 : 1) - day;
+    d.setDate(d.getDate() + diff);
+    d.setHours(0, 0, 0, 0);
+    return d;
+  }
+
+}

package/projects/sharedcomponents/src/lib/utils/check-precision-and-scale-result.ts

@@ -0,0 +1,5 @@
+// Output object shape for NumberUtils.CheckPrecisionAndScale().
+export interface CheckPrecisionAndScaleResult {
+    isOk: boolean;
+    nearestOkNr?: number;
+}

package/projects/sharedcomponents/src/lib/utils/co-document-shared-field-logic.ts

@@ -0,0 +1,58 @@
+import {CoDocument} from "@colijnit/mainapi/build/model/co-document.bo";
+import {FileType} from "../enum/file-type";
+import {BuildImagesAndDocumentationResult} from "../businessobject/build-images-and-documentation-result";
+
+
+export class CoDocumentSharedFieldLogic {
+
+    public static BuildAllDocuments(documentation: CoDocument[], images: CoDocument[]): CoDocument[] {
+        let allDocuments: CoDocument[] = [];
+        allDocuments = allDocuments.concat(documentation);
+        allDocuments = allDocuments.concat(images);
+        allDocuments.sort((a: CoDocument, b: CoDocument) => {
+            return a.index < b.index ? -1 : 1;
+        });
+        return allDocuments;
+    }
+
+    public static BuildImagesAndDocumentation(documents: CoDocument[]): BuildImagesAndDocumentationResult {
+        const images: CoDocument[] = [];
+        const documentation: CoDocument[] = [];
+
+        const len: number = documents.length;
+        for (let i: number = 0; i < len; i++) {
+            // re-index documents order
+            documents[i].index = i + 1;
+            if (documents[i].fileType === FileType.Image) {
+                images.push(documents[i]);
+            } else {
+                documentation.push(documents[i]);
+            }
+        }
+
+        return {
+            images: images,
+            documentation: documentation
+        };
+    }
+
+    // Returns an index number that is 1 higher than the highest one in the collection
+    public static GenerateAvailableIndexNr(documents: CoDocument[]): number {
+        const indexNumbers: number[] = [];
+        documents.forEach((collectionItem) => {
+            if (collectionItem && collectionItem.index > -1) {
+                indexNumbers.push(collectionItem.index);
+            }
+        });
+
+        indexNumbers.sort((a: number, b: number) => {
+            return a - b;
+        });
+
+        if (indexNumbers && indexNumbers.length > 0) {
+            return indexNumbers[indexNumbers.length - 1] + 1;
+        } else {
+            return 0;
+        }
+    }
+}