@ng-formworks/core 17.2.7 → 18.0.0

package/src/lib/shared/utility.functions.ts

@@ -1,373 +0,0 @@
-import {hasValue, inArray, isArray, isDefined, isEmpty, isMap, isObject, isSet, isString, PlainObject} from './validator.functions';
-
-/**
- * Utility function library:
- *
- * addClasses, copy, forEach, forEachCopy, hasOwn, mergeFilteredObject,
- * uniqueItems, commonItems, fixTitle, toTitleCase
-*/
-
-/**
- * 'addClasses' function
- *
- * Merges two space-delimited lists of CSS classes and removes duplicates.
- *
- * // {string | string[] | Set<string>} oldClasses
- * // {string | string[] | Set<string>} newClasses
- * // {string | string[] | Set<string>} - Combined classes
- */
-export function addClasses(
-  oldClasses: string | string[] | Set<string>,
-  newClasses: string | string[] | Set<string>
-): string | string[] | Set<string> {
-  const badType = i => !isSet(i) && !isArray(i) && !isString(i);
-  if (badType(newClasses)) { return oldClasses; }
-  if (badType(oldClasses)) { oldClasses = ''; }
-  const toSet = i => isSet(i) ? i : isArray(i) ? new Set(i) : new Set(i.split(' '));
-  const combinedSet: Set<any> = toSet(oldClasses);
-  const newSet: Set<any> = toSet(newClasses);
-  newSet.forEach(c => combinedSet.add(c));
-  if (isSet(oldClasses)) { return combinedSet; }
-  if (isArray(oldClasses)) { return Array.from(combinedSet); }
-  return Array.from(combinedSet).join(' ');
-}
-
-/**
- * 'copy' function
- *
- * Makes a shallow copy of a JavaScript object, array, Map, or Set.
- * If passed a JavaScript primitive value (string, number, boolean, or null),
- * it returns the value.
- *
- * // {Object|Array|string|number|boolean|null} object - The object to copy
- * // {boolean = false} errors - Show errors?
- * // {Object|Array|string|number|boolean|null} - The copied object
- */
-export function copy(object: any, errors = false): any {
-  if (typeof object !== 'object' || object === null) { return object; }
-  if (isMap(object))    { return new Map(object); }
-  if (isSet(object))    { return new Set(object); }
-  if (isArray(object))  { return [ ...object ];   }
-  if (isObject(object)) { return { ...object };   }
-  if (errors) {
-    console.error('copy error: Object to copy must be a JavaScript object or value.');
-  }
-  return object;
-}
-
-/**
- * 'forEach' function
- *
- * Iterates over all items in the first level of an object or array
- * and calls an iterator funciton on each item.
- *
- * The iterator function is called with four values:
- * 1. The current item's value
- * 2. The current item's key
- * 3. The parent object, which contains the current item
- * 4. The root object
- *
- * Setting the optional third parameter to 'top-down' or 'bottom-up' will cause
- * it to also recursively iterate over items in sub-objects or sub-arrays in the
- * specified direction.
- *
- * // {Object|Array} object - The object or array to iterate over
- * // {function} fn - the iterator funciton to call on each item
- * // {boolean = false} errors - Show errors?
- * // {void}
- */
-export function forEach(
-  object: any, fn: (v: any, k?: string | number, c?: any, rc?: any) => any,
-  recurse: boolean | string = false, rootObject: any = object, errors = false
-): void {
-  if (isEmpty(object)) { return; }
-  if ((isObject(object) || isArray(object)) && typeof fn === 'function') {
-    for (const key of Object.keys(object)) {
-      const value = object[key];
-      if (recurse === 'bottom-up' && (isObject(value) || isArray(value))) {
-        forEach(value, fn, recurse, rootObject);
-      }
-      fn(value, key, object, rootObject);
-      if (recurse === 'top-down' && (isObject(value) || isArray(value))) {
-        forEach(value, fn, recurse, rootObject);
-      }
-    }
-  }
-  if (errors) {
-    if (typeof fn !== 'function') {
-      console.error('forEach error: Iterator must be a function.');
-      console.error('function', fn);
-    }
-    if (!isObject(object) && !isArray(object)) {
-      console.error('forEach error: Input object must be an object or array.');
-      console.error('object', object);
-    }
-  }
-}
-
-/**
- * 'forEachCopy' function
- *
- * Iterates over all items in the first level of an object or array
- * and calls an iterator function on each item. Returns a new object or array
- * with the same keys or indexes as the original, and values set to the results
- * of the iterator function.
- *
- * Does NOT recursively iterate over items in sub-objects or sub-arrays.
- *
- * // {Object | Array} object - The object or array to iterate over
- * // {function} fn - The iterator funciton to call on each item
- * // {boolean = false} errors - Show errors?
- * // {Object | Array} - The resulting object or array
- */
-export function forEachCopy(
-  object: any, fn: (v: any, k?: string | number, o?: any, p?: string) => any,
-  errors = false
-): any {
-  if (!hasValue(object)) { return; }
-  if ((isObject(object) || isArray(object)) && typeof object !== 'function') {
-    const newObject: any = isArray(object) ? [] : {};
-    for (const key of Object.keys(object)) {
-      newObject[key] = fn(object[key], key, object);
-    }
-    return newObject;
-  }
-  if (errors) {
-    if (typeof fn !== 'function') {
-      console.error('forEachCopy error: Iterator must be a function.');
-      console.error('function', fn);
-    }
-    if (!isObject(object) && !isArray(object)) {
-      console.error('forEachCopy error: Input object must be an object or array.');
-      console.error('object', object);
-    }
-  }
-}
-
-/**
- * 'hasOwn' utility function
- *
- * Checks whether an object or array has a particular property.
- *
- * // {any} object - the object to check
- * // {string} property - the property to look for
- * // {boolean} - true if object has property, false if not
- */
-export function hasOwn(object: any, property: string): boolean {
-  if (!object || !['number', 'string', 'symbol'].includes(typeof property) ||
-    (!isObject(object) && !isArray(object) && !isMap(object) && !isSet(object))
-  ) { return false; }
-  if (isMap(object) || isSet(object)) { return object.has(property); }
-  if (typeof property === 'number') {
-    if (isArray(object)) { return object[<number>property]; }
-    property = property + '';
-  }
-  return object.hasOwnProperty(property);
-}
-
-/**
- * Types of possible expressions which the app is able to evaluate.
- */
-export enum ExpressionType {
-  EQUALS,
-  NOT_EQUALS,
-  NOT_AN_EXPRESSION
-}
-
-/**
- * Detects the type of expression from the given candidate. `==` for equals,
- * `!=` for not equals. If none of these are contained in the candidate, the candidate
- * is not considered to be an expression at all and thus `NOT_AN_EXPRESSION` is returned.
- * // {expressionCandidate} expressionCandidate - potential expression
- */
-export function getExpressionType(expressionCandidate: string): ExpressionType {
-  if (expressionCandidate.indexOf('==') !== -1) {
-    return ExpressionType.EQUALS;
-  }
-
-  if (expressionCandidate.toString().indexOf('!=') !== -1) {
-    return ExpressionType.NOT_EQUALS;
-  }
-
-  return ExpressionType.NOT_AN_EXPRESSION;
-}
-
-export function isEqual(expressionType) {
-  return expressionType as ExpressionType === ExpressionType.EQUALS;
-}
-
-export function isNotEqual(expressionType) {
-  return expressionType as ExpressionType === ExpressionType.NOT_EQUALS;
-}
-
-export function isNotExpression(expressionType) {
-  return expressionType as ExpressionType === ExpressionType.NOT_AN_EXPRESSION;
-}
-
-/**
- * Splits the expression key by the expressionType on a pair of values
- * before and after the equals or nor equals sign.
- * // {expressionType} enum of an expression type
- * // {key} the given key from a for loop iver all conditions
- */
-export function getKeyAndValueByExpressionType(expressionType: ExpressionType, key: string) {
-  if (isEqual(expressionType)) {
-    return key.split('==', 2);
-  }
-
-  if (isNotEqual(expressionType)) {
-    return key.split('!=', 2);
-  }
-
-  return null;
-}
-
-export function cleanValueOfQuotes(keyAndValue): String {
-  if (keyAndValue.charAt(0) === '\'' && keyAndValue.charAt(keyAndValue.length - 1) === '\'') {
-    return keyAndValue.replace('\'', '').replace('\'', '');
-  }
-  return keyAndValue;
-}
-
-/**
- * 'mergeFilteredObject' utility function
- *
- * Shallowly merges two objects, setting key and values from source object
- * in target object, excluding specified keys.
- *
- * Optionally, it can also use functions to transform the key names and/or
- * the values of the merging object.
- *
- * // {PlainObject} targetObject - Target object to add keys and values to
- * // {PlainObject} sourceObject - Source object to copy keys and values from
- * // {string[]} excludeKeys - Array of keys to exclude
- * // {(string: string) => string = (k) => k} keyFn - Function to apply to keys
- * // {(any: any) => any = (v) => v} valueFn - Function to apply to values
- * // {PlainObject} - Returns targetObject
- */
-export function mergeFilteredObject(
-  targetObject: PlainObject,
-  sourceObject: PlainObject,
-  excludeKeys = <string[]>[],
-  keyFn = (key: string): string => key,
-  valFn = (val: any): any => val
-): PlainObject {
-  if (!isObject(sourceObject)) { return targetObject; }
-  if (!isObject(targetObject)) { targetObject = {}; }
-  for (const key of Object.keys(sourceObject)) {
-    if (!inArray(key, excludeKeys) && isDefined(sourceObject[key])) {
-      targetObject[keyFn(key)] = valFn(sourceObject[key]);
-    }
-  }
-  return targetObject;
-}
-
-/**
- * 'uniqueItems' function
- *
- * Accepts any number of string value inputs,
- * and returns an array of all input vaues, excluding duplicates.
- *
- * // {...string} ...items -
- * // {string[]} -
- */
-export function uniqueItems(...items): string[] {
-  const returnItems = [];
-  for (const item of items) {
-    if (!returnItems.includes(item)) { returnItems.push(item); }
-  }
-  return returnItems;
-}
-
-/**
- * 'commonItems' function
- *
- * Accepts any number of strings or arrays of string values,
- * and returns a single array containing only values present in all inputs.
- *
- * // {...string|string[]} ...arrays -
- * // {string[]} -
- */
-export function commonItems(...arrays): string[] {
-  let returnItems = null;
-  for (let array of arrays) {
-    if (isString(array)) { array = [array]; }
-    returnItems = returnItems === null ? [ ...array ] :
-      returnItems.filter(item => array.includes(item));
-    if (!returnItems.length) { return []; }
-  }
-  return returnItems;
-}
-
-/**
- * 'fixTitle' function
- *
- *
- * // {string} input -
- * // {string} -
- */
-export function fixTitle(name: string): string {
-  return name && toTitleCase(name.replace(/([a-z])([A-Z])/g, '$1 $2').replace(/_/g, ' '));
-}
-
-/**
- * 'toTitleCase' function
- *
- * Intelligently converts an input string to Title Case.
- *
- * Accepts an optional second parameter with a list of additional
- * words and abbreviations to force into a particular case.
- *
- * This function is built on prior work by John Gruber and David Gouch:
- * http://daringfireball.net/2008/08/title_case_update
- * https://github.com/gouch/to-title-case
- *
- * // {string} input -
- * // {string|string[]} forceWords? -
- * // {string} -
- */
-export function toTitleCase(input: string, forceWords?: string|string[]): string {
-  if (!isString(input)) { return input; }
-  let forceArray: string[] = ['a', 'an', 'and', 'as', 'at', 'but', 'by', 'en',
-   'for', 'if', 'in', 'nor', 'of', 'on', 'or', 'per', 'the', 'to', 'v', 'v.',
-   'vs', 'vs.', 'via'];
-  if (isString(forceWords)) { forceWords = (<string>forceWords).split('|'); }
-  if (isArray(forceWords)) { forceArray = forceArray.concat(forceWords); }
-  const forceArrayLower: string[] = forceArray.map(w => w.toLowerCase());
-  const noInitialCase: boolean =
-    input === input.toUpperCase() || input === input.toLowerCase();
-  let prevLastChar = '';
-  input = input.trim();
-  return input.replace(/[A-Za-z0-9\u00C0-\u00FF]+[^\s-]*/g, (word, idx) => {
-    if (!noInitialCase && word.slice(1).search(/[A-Z]|\../) !== -1) {
-      return word;
-    } else {
-      let newWord: string;
-      const forceWord: string =
-        forceArray[forceArrayLower.indexOf(word.toLowerCase())];
-      if (!forceWord) {
-        if (noInitialCase) {
-          if (word.slice(1).search(/\../) !== -1) {
-            newWord = word.toLowerCase();
-          } else {
-            newWord = word[0].toUpperCase() + word.slice(1).toLowerCase();
-          }
-        } else {
-          newWord = word[0].toUpperCase() + word.slice(1);
-        }
-      } else if (
-        forceWord === forceWord.toLowerCase() && (
-          idx === 0 || idx + word.length === input.length ||
-          prevLastChar === ':' || input[idx - 1].search(/[^\s-]/) !== -1 ||
-          (input[idx - 1] !== '-' && input[idx + word.length] === '-')
-        )
-      ) {
-        newWord = forceWord[0].toUpperCase() + forceWord.slice(1);
-      } else {
-        newWord = forceWord;
-      }
-      prevLastChar = word.slice(-1);
-      return newWord;
-    }
-  });
-}

package/src/lib/shared/validator.functions.spec.ts

@@ -1,55 +0,0 @@
-import {
-  toIsoString,
-  toJavaScriptType,
-  toSchemaType,
-} from "./validator.functions";
-
-describe("Validator functions", () => {
-  describe("toIsoString", () => {
-    it("should work with timezone", () => {
-      expect(toIsoString(new Date("05 October 2011 14:48 UTC"))).toEqual(
-        "2011-10-05"
-      );
-    });
-  });
-  describe("toJavaScriptType", () => {
-    it("Converts an input (probably string) value to a JavaScript primitive type 'string', 'number', 'boolean', or 'null' - before storing in a JSON object.", () => {
-      expect(toJavaScriptType("10", "number")).toEqual(10);
-      expect(toJavaScriptType("10", "integer")).toEqual(10);
-      expect(toJavaScriptType(10, "integer")).toEqual(10);
-      expect(toJavaScriptType(10, "string")).toEqual("10");
-      expect(toJavaScriptType("10.5", "integer")).toEqual(null);
-      expect(toJavaScriptType(10.5, "integer")).toEqual(null);
-    });
-  });
-  describe("toSchemaType", () => {
-    it("Number conversion examples", () => {
-      expect(toSchemaType(10, ["number", "integer", "string"])).toEqual(10);
-      expect(toSchemaType(10, ["number", "string"])).toEqual(10);
-      expect(toSchemaType(10, ["string"])).toEqual("10");
-      expect(toSchemaType(10.5, ["number", "integer", "string"])).toEqual(10.5);
-      expect(toSchemaType(10.5, ["integer", "string"])).toEqual("10.5");
-      expect(toSchemaType(10.5, ["integer"])).toEqual(10);
-    });
-    it("Boolean conversion examples", () => {
-      expect(
-        toSchemaType("1", ["integer", "number", "string", "boolean"])
-      ).toEqual("1");
-      expect(toSchemaType("1", ["string", "boolean"])).toEqual("1");
-      expect(toSchemaType("1", ["boolean"])).toEqual("1");
-      expect(toSchemaType("true", ["number", "string", "boolean"])).toEqual(
-        "true"
-      );
-      expect(toSchemaType("true", ["boolean"])).toEqual("true");
-      expect(toSchemaType("true", ["number"])).toEqual(0);
-    });
-    it("string conversion examples", () => {
-      expect(
-        toSchemaType("1.58", ["boolean", "number", "integer", "string"])
-      ).toEqual("1.58");
-      expect(toSchemaType("1.5", ["boolean", "number", "integer"])).toEqual(
-        "1.5"
-      );
-    });
-  });
-});

package/src/lib/widget-library/add-reference.component.ts

@@ -1,59 +0,0 @@
-import {
-  ChangeDetectionStrategy,
-  Component,
-  Input,
-  OnInit
-  } from '@angular/core';
-import { JsonSchemaFormService } from '../json-schema-form.service';
-
-
-@Component({
-  // tslint:disable-next-line:component-selector
-  selector: 'add-reference-widget',
-  template: `
-    <button *ngIf="showAddButton"
-      [class]="options?.fieldHtmlClass || ''"
-      [disabled]="options?.readonly"
-      (click)="addItem($event)">
-      <span *ngIf="options?.icon" [class]="options?.icon"></span>
-      <span *ngIf="options?.title" [innerHTML]="buttonText"></span>
-    </button>`,
-    changeDetection: ChangeDetectionStrategy.Default,
-})
-export class AddReferenceComponent implements OnInit {
-  options: any;
-  itemCount: number;
-  previousLayoutIndex: number[];
-  previousDataIndex: number[];
-  @Input() layoutNode: any;
-  @Input() layoutIndex: number[];
-  @Input() dataIndex: number[];
-
-  constructor(
-    private jsf: JsonSchemaFormService
-  ) { }
-
-  ngOnInit() {
-    this.options = this.layoutNode.options || {};
-  }
-
-  get showAddButton(): boolean {
-    return !this.layoutNode.arrayItem ||
-      this.layoutIndex[this.layoutIndex.length - 1] < this.options.maxItems;
-  }
-
-  addItem(event) {
-    event.preventDefault();
-    this.jsf.addItem(this);
-  }
-
-  get buttonText(): string {
-    const parent: any = {
-      dataIndex: this.dataIndex.slice(0, -1),
-      layoutIndex: this.layoutIndex.slice(0, -1),
-      layoutNode: this.jsf.getParentNode(this)
-    };
-    return parent.layoutNode.add ||
-      this.jsf.setArrayItemTitle(parent, this.layoutNode, this.itemCount);
-  }
-}

package/src/lib/widget-library/button.component.ts

@@ -1,54 +0,0 @@
-import { AbstractControl } from '@angular/forms';
-import { Component, Input, OnInit } from '@angular/core';
-import { JsonSchemaFormService } from '../json-schema-form.service';
-
-
-@Component({
-  // tslint:disable-next-line:component-selector
-  selector: 'button-widget',
-  template: `
-    <div
-      [class]="options?.htmlClass || ''">
-      <button
-        [attr.readonly]="options?.readonly ? 'readonly' : null"
-        [attr.aria-describedby]="'control' + layoutNode?._id + 'Status'"
-        [class]="options?.fieldHtmlClass || ''"
-        [disabled]="controlDisabled"
-        [name]="controlName"
-        [type]="layoutNode?.type"
-        [value]="controlValue"
-        (click)="updateValue($event)">
-        <span *ngIf="options?.icon || options?.title"
-          [class]="options?.icon"
-          [innerHTML]="options?.title"></span>
-      </button>
-    </div>`,
-})
-export class ButtonComponent implements OnInit {
-  formControl: AbstractControl;
-  controlName: string;
-  controlValue: any;
-  controlDisabled = false;
-  boundControl = false;
-  options: any;
-  @Input() layoutNode: any;
-  @Input() layoutIndex: number[];
-  @Input() dataIndex: number[];
-
-  constructor(
-    private jsf: JsonSchemaFormService
-  ) { }
-
-  ngOnInit() {
-    this.options = this.layoutNode.options || {};
-    this.jsf.initializeControl(this);
-  }
-
-  updateValue(event) {
-    if (typeof this.options.onClick === 'function') {
-      this.options.onClick(event);
-    } else {
-      this.jsf.updateValue(this, event.target.value);
-    }
-  }
-}

package/src/lib/widget-library/checkbox.component.ts

@@ -1,74 +0,0 @@
-import { AbstractControl } from '@angular/forms';
-import { Component, Input, OnInit } from '@angular/core';
-import { JsonSchemaFormService } from '../json-schema-form.service';
-
-
-@Component({
-  // tslint:disable-next-line:component-selector
-  selector: 'checkbox-widget',
-  template: `
-    <label
-      [attr.for]="'control' + layoutNode?._id"
-      [class]="options?.itemLabelHtmlClass || ''">
-      <input *ngIf="boundControl"
-        [formControl]="formControl"
-        [attr.aria-describedby]="'control' + layoutNode?._id + 'Status'"
-        [class]="(options?.fieldHtmlClass || '') + (isChecked ?
-          (' ' + (options?.activeClass || '') + ' ' + (options?.style?.selected || '')) :
-          (' ' + (options?.style?.unselected || '')))"
-        [id]="'control' + layoutNode?._id"
-        [name]="controlName"
-        [readonly]="options?.readonly ? 'readonly' : null"
-        type="checkbox">
-      <input *ngIf="!boundControl"
-        [attr.aria-describedby]="'control' + layoutNode?._id + 'Status'"
-        [checked]="isChecked ? 'checked' : null"
-        [class]="(options?.fieldHtmlClass || '') + (isChecked ?
-          (' ' + (options?.activeClass || '') + ' ' + (options?.style?.selected || '')) :
-          (' ' + (options?.style?.unselected || '')))"
-        [disabled]="controlDisabled"
-        [id]="'control' + layoutNode?._id"
-        [name]="controlName"
-        [readonly]="options?.readonly ? 'readonly' : null"
-        [value]="controlValue"
-        type="checkbox"
-        (change)="updateValue($event)">
-      <span *ngIf="options?.title"
-        [style.display]="options?.notitle ? 'none' : ''"
-        [innerHTML]="options?.title"></span>
-    </label>`,
-})
-export class CheckboxComponent implements OnInit {
-  formControl: AbstractControl;
-  controlName: string;
-  controlValue: any;
-  controlDisabled = false;
-  boundControl = false;
-  options: any;
-  trueValue: any = true;
-  falseValue: any = false;
-  @Input() layoutNode: any;
-  @Input() layoutIndex: number[];
-  @Input() dataIndex: number[];
-
-  constructor(
-    private jsf: JsonSchemaFormService
-  ) { }
-
-  ngOnInit() {
-    this.options = this.layoutNode.options || {};
-    this.jsf.initializeControl(this);
-    if (this.controlValue === null || this.controlValue === undefined) {
-      this.controlValue = this.options.title;
-    }
-  }
-
-  updateValue(event) {
-    event.preventDefault();
-    this.jsf.updateValue(this, event.target.checked ? this.trueValue : this.falseValue);
-  }
-
-  get isChecked() {
-    return this.jsf.getFormControlValue(this) === this.trueValue;
-  }
-}