@qrvey/utils 1.1.2-0 → 1.1.4

package/README.md

@@ -1,4 +1,4 @@
-# [@qrvey/utils](https://bitbucket.org/qrvey/qrvey_utils/wiki/Home) *1.1.2-0*
+# [@qrvey/utils](https://bitbucket.org/qrvey/qrvey_utils/wiki/Home) *1.1.4*
 
 > Helper, Utils for all Qrvey Projects
 
@@ -365,6 +365,34 @@ Generates a Flattened UI Filter Structure from the UI Filter Data structure v2.1
 
 
 
+### dist/filters/adapters/adaptDateGroupingProperty.js
+
+
+#### adaptDateGroupingProperty(property) 
+
+[TODO: For 2022, eliminate this adapter]
+Get the new property base on the old date grouping properties
+
+
+
+
+##### Parameters
+
+| Name | Type | Description |  |
+| ---- | ---- | ----------- | -------- |
+| property |  |  |   |
+
+
+
+
+##### Returns
+
+
+-  
+
+
+
+
 ### dist/filters/adapters/adaptFilterData.js
 
 
@@ -1012,12 +1040,12 @@ Gets the Scopes IDS for the Available Scope function by any config
 
 
 
-### dist/general/array/filterNestedTree.js
+### dist/date/range/getDateRange.js
 
 
-#### filterNestedTree(arr, childArrKey, condition) 
+#### getDateRange(value, dateGroupLabel, withTime) 
 
-Filters a nested tree array by a custom condition on the las child node
+Get date range object from a string date value
 
 
 
@@ -1026,37 +1054,58 @@ Filters a nested tree array by a custom condition on the las child node
 
 | Name | Type | Description |  |
 | ---- | ---- | ----------- | -------- |
-| arr |  | nested tree array |   |
-| childArrKey |  | property representing the children array on the nested tree |   |
-| condition |  | function callback that determines if the filter is applied on the last child node of the nested tree |   |
+| value | `String`  | string date value |   |
+| dateGroupLabel | `String`  | could be 'YEAR', 'QUARTER', 'MONTH' or 'DAY'. Deafult is 'DAY' |   |
+| withTime | `Boolean`  | determines if the date range will include time. Default is true |   |
 
 
 
 
-##### Returns
+##### Examples
 
+```javascript
+// 1) Year:
+getDateRange('2020', 'YEAR');
+// Will return:
+{
+   from: '01/01/2020 00:00:00',
+   to: '12/31/2020 23:59:59'
+}
 
--  array filtered
+// 2) Quarter:
+getDateRange('Q3 2020', 'QUARTER');
+// Will return:
+{
+   from: '07/01/2020 00:00:00',
+   to: '09/30/2020 23:59:59'
+}
 
+// 3) Month:
+getDateRange('Oct 2020', 'MONTH');
+// Will return:
+{
+   from: '10/01/2020 00:00:00',
+   to: '10/31/2020 23:59:59'
+}
+```
 
 
+##### Returns
 
-### dist/general/array/delete.js
 
+- `Object`  an object with the date range with two string date properties: from and to
 
-#### ArrayDelete(array, index) 
 
-Inmutable Array Item deletion
 
 
+### dist/date/relative/Adapter.js
 
 
-##### Parameters
+#### value() 
+
+Resolves statement and returns statement value
+
 
-| Name | Type | Description |  |
-| ---- | ---- | ----------- | -------- |
-| array | `Array`  | a collection of items to delete |   |
-| index | `Number`  | the position of the item to delete |   |
 
 
 
@@ -1064,54 +1113,47 @@ Inmutable Array Item deletion
 ##### Returns
 
 
--  a new Array or the given parameter when is empty or not an array
+- `AbsoluteRange` `string`  
 
 
 
+#### valueAsAnchor() 
 
-### dist/general/array/flattenDeep.js
+Resolves statement as an anchor
 
 
-#### flattenDeep(arr) 
 
-Flat deeply an array
 
 
 
+##### Returns
 
-##### Parameters
 
-| Name | Type | Description |  |
-| ---- | ---- | ----------- | -------- |
-| arr |  | Array to flat deeply |   |
+- `string`  
 
 
 
+#### _statementToRange()  *private method*
 
-##### Returns
+Convert verbal statement to range value
 
 
--  flatten array
 
 
 
 
-### dist/general/array/getFirstIndexFromArray.js
+##### Returns
 
 
-#### getFirstIndexFromArray(array, callback) 
+- `AbsoluteRange`  
 
-Gets the first index from the array by a callback condition
 
 
+#### _resolveAsThis()  *private method*
 
+Apply 'this' cursor logic to statement
 
-##### Parameters
 
-| Name | Type | Description |  |
-| ---- | ---- | ----------- | -------- |
-| array |  |  |   |
-| callback |  | function callback |   |
 
 
 
@@ -1119,45 +1161,45 @@ Gets the first index from the array by a callback condition
 ##### Returns
 
 
--  the first index of the array. -1 when the condition is not satisfied
+- `AbsoluteStatement`  
 
 
 
+#### _resolveAsTheLast()  *private method*
+
+Apply 'the last' cursor logic to statement
 
-### dist/general/array/getLastIndexFromArray.js
 
 
-#### getLastIndexFromArray(array, callback) 
 
-Gets the last index from the array by a callback condition
 
 
+##### Returns
 
 
-##### Parameters
+- `AbsoluteStatement`  
 
-| Name | Type | Description |  |
-| ---- | ---- | ----------- | -------- |
-| array |  |  |   |
-| callback |  | function callback |   |
 
 
+#### _resolveAsTheNext()  *private method*
 
+Apply 'the next' cursor logic to statement
 
-##### Returns
 
 
--  the last index of the array. -1 when the condition is not satisfied
 
 
 
+##### Returns
 
-### dist/general/function/debounce.js
 
+- `AbsoluteStatement`  
 
-#### debounce(fn, time) 
 
-Delays invoking _fn_ until after _time_ milliseconds have elapsed since the last time the debounced function was invoked.
+
+#### replaceNowToken(value, now) 
+
+Replace '@now' token inside a string
 
 
 
@@ -1166,8 +1208,8 @@ Delays invoking _fn_ until after _time_ milliseconds have elapsed since the last
 
 | Name | Type | Description |  |
 | ---- | ---- | ----------- | -------- |
-| fn | `Function`  | original Function |   |
-| time | `Number`  | default 500ms |   |
+| value | `string`  |  |   |
+| now | `Date`  |  |   |
 
 
 
@@ -1175,17 +1217,13 @@ Delays invoking _fn_ until after _time_ milliseconds have elapsed since the last
 ##### Returns
 
 
-- `Function`  debounced functions
-
-
-
+- `string`  
 
-### dist/general/function/throttled.js
 
 
-#### throttled(fn, time) 
+#### convertRelativeToAbsolute(args) 
 
-Make sure to only invokes _fn_ at most once per every _time_ milliseconds
+Returns a range object (date) from a group of statement params
 
 
 
@@ -1194,26 +1232,45 @@ Make sure to only invokes _fn_ at most once per every _time_ milliseconds
 
 | Name | Type | Description |  |
 | ---- | ---- | ----------- | -------- |
-| fn | `Function`  | original Function |   |
-| time | `Number`  | default 500ms |   |
+| args | `RelativeToAbsoluteStruct`  |  |   |
+
+
+
 
+##### Examples
 
+```javascript
+pivot = '2021-03-03T12:30:40'
+unit = month
+steps = 2
+setTo = END
+resolverAsCalendar: true
+=> Returns  '2021-05-31T23:59:59'
+```
+```javascript
+pivot = '2021-03-03T12:30:40'
+unit = month
+steps = -2
+setTo = START
+resolverAsCalendar: false
+=> Returns '2021-01-03T00:00:00'
+```
 
 
 ##### Returns
 
 
-- `Function`  throttled function
+- `string`  
 
 
 
 
-### dist/general/mix/importScripts.js
+### dist/date/relative/relative.js
 
 
-#### importScripts(scripts) 
+#### resolveRelative(statements, clock) 
 
-Import a set of external Scripts given the URL in both serie and cascade way
+Resolve a list of relative statements according to operator
 
 
 
@@ -1222,12 +1279,8 @@ Import a set of external Scripts given the URL in both serie and cascade way
 
 | Name | Type | Description |  |
 | ---- | ---- | ----------- | -------- |
-| scripts | `Array.<String>` `Array.<Object>`  | can be an array of string or an array of object with the follow structure: | &nbsp; |
-| scripts.url | `String`  | CDN URL | &nbsp; |
-| scripts.namespace | `String` `Function`  | (Optional) if is a String, that name is evaluated on Window[namespace] object otherwise the Function is invoked expecting a Thrutly value | &nbsp; |
-| scripts.type | `String`  | (Optional) it could be `module` of `text/javascript`. Default `text/javascript` | &nbsp; |
-| scripts.noModule | `Boolean`  | (Optional) add `momodule` attribute to script tag. Default `false` | &nbsp; |
-| scripts.dependencies | `Array.<Object>`  | an array with the same structure to load in cascade mode | &nbsp; |
+| statements | `Array.<RelativeStatement>` `Array.<string>`  | - Raw statements/values | &nbsp; |
+| clock | `Date`  | - Clock/time reference for relative date resolution | &nbsp; |
 
 
 
@@ -1235,41 +1288,35 @@ Import a set of external Scripts given the URL in both serie and cascade way
 ##### Examples
 
 ```javascript
-// 1) Simple script (paralell loading)
-importScripts(['http://myscript.js', 'http://another.js']);
-
-// 2) Loading `.js` and `.esm.js` script (parallel loading)
-importScripts([
-  { url: 'http://myscript.esm.js', type: 'module' },
-  { url: 'http://myscript.js', noModule: true }
-]);
-
-// 3) import dependent scripts (cascade)
-importScripts([
-  { url: 'http://myscript.js', dependencies: ['http://myscript.plugin.js'] }
-]);
+Input:
+{
+ "cursor": "the_next",
+ "unit": "year",
+ "number": 1,
+ "includeCurrent": false,
+ "isCalendarDate": false,
+ "anchor": "03/05/2021"
+}
 
-// 4) mix
-importScripts([
-  { url: 'http://myscript.js', dependencies: ['http://myscript.plugin.js'] },
-  { url: 'http://another.esm.js', type: 'module' },
-  { url: 'http://another.js', noModule: true },
-  'http://simplescript.js'
-]);
+Output:
+{ gte: "03/06/2021 00:00:00", lte: "03/05/2022 23:59:59" }
 ```
 
 
 ##### Returns
 
 
-- `Promise`  Promise when all script have been loaded
+- `Array.&lt;AbsoluteRange&gt;` `Array.&lt;string&gt;`  
 
 
 
-#### loadScript(url, type, noModule) 
 
-Creates the script element and appends to document.head
-return a Promise that is resolved when the script is loaded
+### dist/general/array/delete.js
+
+
+#### ArrayDelete(array, index) 
+
+Inmutable Array Item deletion
 
 
 
@@ -1278,9 +1325,8 @@ return a Promise that is resolved when the script is loaded
 
 | Name | Type | Description |  |
 | ---- | ---- | ----------- | -------- |
-| url | `String`  | Cdn Url | &nbsp; |
-| type | `String`  | (Optional) it could be `module` of `text/javascript`. Default `text/javascript` | &nbsp; |
-| noModule | `boolean`  | (Optional) add `momodule` attribute to script tag. Default `false` | &nbsp; |
+| array | `Array`  | a collection of items to delete | &nbsp; |
+| index | `Number`  | the position of the item to delete | &nbsp; |
 
 
 
@@ -1288,17 +1334,17 @@ return a Promise that is resolved when the script is loaded
 ##### Returns
 
 
-- `Void`
+-  a new Array or the given parameter when is empty or not an array
 
 
 
 
-### dist/general/mix/isEmpty.js
+### dist/general/array/flattenDeep.js
 
 
-#### isEmpty(variable, includeFalsy) 
+#### flattenDeep(arr) 
 
-Validates if the given argument is empty
+Flat deeply an array
 
 
 
@@ -1307,8 +1353,7 @@ Validates if the given argument is empty
 
 | Name | Type | Description |  |
 | ---- | ---- | ----------- | -------- |
-| variable |  | the given variable | &nbsp; |
-| includeFalsy |  | flag to determine include the falsy variables into the validation | &nbsp; |
+| arr |  | Array to flat deeply | &nbsp; |
 
 
 
@@ -1316,18 +1361,20 @@ Validates if the given argument is empty
 ##### Returns
 
 
--  true: the given argument is empty; false: is not.
+-  flatten array
 
 
 
 
-### dist/general/mix/isNull.js
+### dist/general/array/filterNestedTree.js
 
 
-#### isNull(arg) 
+#### filterNestedTree(arr, childArrKey, condition) 
 
-return if a given variable is either `null` or `undefined`
-useful to avoid falsify validating Number Zero (0)
+Filters a nested tree array by a custom condition on the last child node
+- If the given arguments are not valid, the function returns the first argument.
+- If the childArrKey is not matched in the object, the condition tries to resolve the filter anyway and returns an empty array.
+- If the condition is not fulfilled, the function returns a filtered array, probably a empty array inside of the child array
 
 
 
@@ -1336,7 +1383,9 @@ useful to avoid falsify validating Number Zero (0)
 
 | Name | Type | Description |  |
 | ---- | ---- | ----------- | -------- |
-| arg | `any`  |  | &nbsp; |
+| arr |  | nested tree array | &nbsp; |
+| childArrKey |  | property representing the children array on the nested tree | &nbsp; |
+| condition |  | function callback that determines if the filter is applied on the last child node of the nested tree | &nbsp; |
 
 
 
@@ -1344,19 +1393,17 @@ useful to avoid falsify validating Number Zero (0)
 ##### Returns
 
 
-- `Boolean`  
+-  array filtered
 
 
 
 
-### dist/general/mix/size.js
+### dist/general/array/getFirstIndexFromArray.js
 
 
-#### size(obj) 
+#### getFirstIndexFromArray(array, callback) 
 
-get the length of an Array or String and also the number of first level attributes
-in an Object.
-For `null` or `undefined` argument the returned value will be 0.
+Gets the first index from the array by a callback condition
 
 
 
@@ -1365,7 +1412,8 @@ For `null` or `undefined` argument the returned value will be 0.
 
 | Name | Type | Description |  |
 | ---- | ---- | ----------- | -------- |
-| obj | `Any`  |  | &nbsp; |
+| array |  |  | &nbsp; |
+| callback |  | function callback | &nbsp; |
 
 
 
@@ -1373,17 +1421,17 @@ For `null` or `undefined` argument the returned value will be 0.
 ##### Returns
 
 
-- `Number`  
+-  the first index of the array. -1 when the condition is not satisfied
 
 
 
 
-### dist/general/mix/randomId.js
+### dist/general/array/getLastIndexFromArray.js
 
 
-#### randomId(length) 
+#### getLastIndexFromArray(array, callback) 
 
-create random unique string
+Gets the last index from the array by a callback condition
 
 
 
@@ -1392,7 +1440,8 @@ create random unique string
 
 | Name | Type | Description |  |
 | ---- | ---- | ----------- | -------- |
-| length | `Number`  | size of the generated string. Default 8 | &nbsp; |
+| array |  |  | &nbsp; |
+| callback |  | function callback | &nbsp; |
 
 
 
@@ -1400,17 +1449,17 @@ create random unique string
 ##### Returns
 
 
-- `String`  
+-  the last index of the array. -1 when the condition is not satisfied
 
 
 
 
-### dist/general/string/capitalize.js
+### dist/general/function/debounce.js
 
 
-#### capitalize(text) 
+#### debounce(fn, time) 
 
-Upper case teh first letter of a given text
+Delays invoking _fn_ until after _time_ milliseconds have elapsed since the last time the debounced function was invoked.
 
 
 
@@ -1419,7 +1468,8 @@ Upper case teh first letter of a given text
 
 | Name | Type | Description |  |
 | ---- | ---- | ----------- | -------- |
-| text | `String`  |  | &nbsp; |
+| fn | `Function`  | original Function | &nbsp; |
+| time | `Number`  | default 500ms | &nbsp; |
 
 
 
@@ -1427,21 +1477,17 @@ Upper case teh first letter of a given text
 ##### Returns
 
 
-- `String`  
-
+- `Function`  debounced functions
 
 
 
-### dist/general/object/get.js
 
+### dist/general/function/throttled.js
 
-#### _get(baseObject, path, defaultValue) 
 
-Like lodash _.get.
-Gets the value at path of object. If the resolved value is undefined, the defaultValue is returned in its place.
+#### throttled(fn, time) 
 
-Empty arrays and empty objects are returned but the defaultValue is not
-Undefined and null values will return the defaultValue.
+Make sure to only invokes _fn_ at most once per every _time_ milliseconds
 
 
 
@@ -1450,52 +1496,26 @@ Undefined and null values will return the defaultValue.
 
 | Name | Type | Description |  |
 | ---- | ---- | ----------- | -------- |
-| baseObject |  | The object to query | &nbsp; |
-| path |  | The string path or collection of string paths of the property to get. | &nbsp; |
-| defaultValue |  | The value returned for undefined resolved values. | &nbsp; |
-
+| fn | `Function`  | original Function | &nbsp; |
+| time | `Number`  | default 500ms | &nbsp; |
 
 
 
-##### Examples
-
-```javascript
-// returns 'Hello'
-_get({ item1: 'Hello', item2: 'World' }, 'item1')
-```
-```javascript
-// returns 'A simple Hello'
-_get({ item1: 'Hello', item2: 'World' }, 'item3', 'A simple Hello')
-```
-```javascript
-// returns 'Hello Again'
-_get({ item1: { item11: 'Hello Again' }, item2: {} }, 'item1.item11')
-```
-```javascript
-// returns 'Hello 2'
-_get({ item1: ['Hello 1', 'Hello 2' }, item2: [] }, 'item1[1]')
-```
-```javascript
-// returns 'Hello Again'
-_get({ item1: { item11: 'Hello Again' }, item2: {} }, ['item1', 'item11'])
-```
-
 
 ##### Returns
 
 
--  the resolved value.
+- `Function`  throttled function
 
 
 
 
-### dist/general/object/cloneDeep.js
+### dist/general/mix/getTag.js
 
 
-#### cloneDeep(obj) 
+#### getTag(value) 
 
-A simple Deep Cloning function. Valid only for primivite values and object with primitive values.
-Not to use this function with inner objects and functions
+Gets the `toStringTag` of `value`.
 
 
 
@@ -1504,7 +1524,7 @@ Not to use this function with inner objects and functions
 
 | Name | Type | Description |  |
 | ---- | ---- | ----------- | -------- |
-| obj |  | The object | &nbsp; |
+| value |  | The value to query. | &nbsp; |
 
 
 
@@ -1512,18 +1532,17 @@ Not to use this function with inner objects and functions
 ##### Returns
 
 
--  The new reference object or the given object if the parsing is incorrect or empty
+- `string`  Returns the `toStringTag`.
 
 
 
 
-### dist/general/object/getAttribute.js
+### dist/general/mix/importScripts.js
 
 
-#### getAttribute(obj, key) 
+#### importScripts(scripts) 
 
-search for properties in different case styles such as: lower, upper, camel and pascal
-But for this, is required ask for a property in snake_case style
+Import a set of external Scripts given the URL in both serie and cascade way
 
 
 
@@ -1532,8 +1551,12 @@ But for this, is required ask for a property in snake_case style
 
 | Name | Type | Description |  |
 | ---- | ---- | ----------- | -------- |
-| obj | `object`  | object to look for | &nbsp; |
-| key | `string`  | String attribute in snake_case style | &nbsp; |
+| scripts | `Array.<String>` `Array.<Object>`  | can be an array of string or an array of object with the follow structure: | &nbsp; |
+| scripts.url | `String`  | CDN URL | &nbsp; |
+| scripts.namespace | `String` `Function`  | (Optional) if is a String, that name is evaluated on Window[namespace] object otherwise the Function is invoked expecting a Thrutly value | &nbsp; |
+| scripts.type | `String`  | (Optional) it could be `module` of `text/javascript`. Default `text/javascript` | &nbsp; |
+| scripts.noModule | `Boolean`  | (Optional) add `momodule` attribute to script tag. Default `false` | &nbsp; |
+| scripts.dependencies | `Array.<Object>`  | an array with the same structure to load in cascade mode | &nbsp; |
 
 
 
@@ -1541,24 +1564,41 @@ But for this, is required ask for a property in snake_case style
 ##### Examples
 
 ```javascript
-getAttribute(obj, 'snake_case') //it search for: obj.snake_case || obj.snakeCase || obj.SnakeCase || obj.snakecase || obj.SNAKECASE
-```
+// 1) Simple script (paralell loading)
+importScripts(['http://myscript.js', 'http://another.js']);
 
+// 2) Loading `.js` and `.esm.js` script (parallel loading)
+importScripts([
+  { url: 'http://myscript.esm.js', type: 'module' },
+  { url: 'http://myscript.js', noModule: true }
+]);
 
-##### Returns
+// 3) import dependent scripts (cascade)
+importScripts([
+  { url: 'http://myscript.js', dependencies: ['http://myscript.plugin.js'] }
+]);
 
+// 4) mix
+importScripts([
+  { url: 'http://myscript.js', dependencies: ['http://myscript.plugin.js'] },
+  { url: 'http://another.esm.js', type: 'module' },
+  { url: 'http://another.js', noModule: true },
+  'http://simplescript.js'
+]);
+```
 
-- `Void`
 
+##### Returns
 
 
+- `Promise`  Promise when all script have been loaded
 
-### dist/general/object/hasProperty.js
 
 
-#### _hasProperty(obj, property) 
+#### loadScript(url, type, noModule) 
 
-Use the hasOwnProperty in order to verify if the given property exists in the object.
+Creates the script element and appends to document.head
+return a Promise that is resolved when the script is loaded
 
 
 
@@ -1567,38 +1607,55 @@ Use the hasOwnProperty in order to verify if the given property exists in the ob
 
 | Name | Type | Description |  |
 | ---- | ---- | ----------- | -------- |
-| obj | `object`  | an object | &nbsp; |
-| property | `string`  | String to verify if exists in the object as property | &nbsp; |
+| url | `String`  | Cdn Url | &nbsp; |
+| type | `String`  | (Optional) it could be `module` of `text/javascript`. Default `text/javascript` | &nbsp; |
+| noModule | `boolean`  | (Optional) add `momodule` attribute to script tag. Default `false` | &nbsp; |
 
 
 
 
-##### Examples
+##### Returns
+
+
+- `Void`
+
+
+
+
+### dist/general/mix/isNull.js
+
+
+#### isNull(arg) 
+
+return if a given variable is either `null` or `undefined`
+useful to avoid falsify validating Number Zero (0)
+
+
+
+
+##### Parameters
+
+| Name | Type | Description |  |
+| ---- | ---- | ----------- | -------- |
+| arg | `any`  |  | &nbsp; |
 
-```javascript
-const prop = 'prop2'
-const obj1 = { prop1: 'hello', prop2: 'world'}
-_hasProperty(ob1, prop1) // true
 
-const obj2 = { prop1: 'hello world' }
-_hasProperty(ob1, prop2) // false
-```
 
 
 ##### Returns
 
 
--  True if the object has the given property; otherwise, false.
+- `Boolean`  
 
 
 
 
-### dist/general/object/isObject.js
+### dist/general/mix/isEmpty.js
 
 
-#### isObject(obj) 
+#### isEmpty(variable, includeFalsy) 
 
-Checks if the given argument is an object type
+Validates if the given argument is empty
 
 
 
@@ -1607,7 +1664,8 @@ Checks if the given argument is an object type
 
 | Name | Type | Description |  |
 | ---- | ---- | ----------- | -------- |
-| obj |  | the variable to check | &nbsp; |
+| variable |  | the given variable | &nbsp; |
+| includeFalsy |  | flag to determine include the falsy variables into the validation | &nbsp; |
 
 
 
@@ -1615,18 +1673,19 @@ Checks if the given argument is an object type
 ##### Returns
 
 
--  True: It is an object; False: It is not.
+-  true: the given argument is empty; false: is not.
 
 
 
 
-### dist/general/object/mapValues.js
+### dist/general/mix/randomId.js
 
 
-#### mapValues(baseObject, iteratee) 
+#### randomId(length, exclude) 
 
-Invoke iteratee (function) for each object key-value pair
-and return a mapped object
+Creates a random string
+- If the first given argument is different than a length number, the variable is replaced by a default number
+- If the optional second given argument is passed the random string is permutated.
 
 
 
@@ -1635,8 +1694,8 @@ and return a mapped object
 
 | Name | Type | Description |  |
 | ---- | ---- | ----------- | -------- |
-| baseObject | `Object`  | Base object. | &nbsp; |
-| iteratee | `Function`  | The executed per iteration. | &nbsp; |
+| length | `Number`  | size of the generated string. Default 8 | &nbsp; |
+| exclude | `Array`  | collection of strings that is going to be excluded of the random string. | &nbsp; |
 
 
 
@@ -1644,17 +1703,19 @@ and return a mapped object
 ##### Returns
 
 
-- `Object`  New mapped object.
+- `String`  Random string
 
 
 
 
-### dist/general/object/omit.js
+### dist/general/mix/size.js
 
 
-#### omit(obj, props) 
+#### size(obj) 
 
-return a nwe Object excluding attributes in _props_ list
+Gets the length of the given array.
+- Useful for Object, Array and string type.
+- For `null` or `undefined` or else argument the returned value will be 0.
 
 
 
@@ -1663,8 +1724,7 @@ return a nwe Object excluding attributes in _props_ list
 
 | Name | Type | Description |  |
 | ---- | ---- | ----------- | -------- |
-| obj | `Object`  | base object | &nbsp; |
-| props | `Array.<String>`  | list of attribute to exclude | &nbsp; |
+| obj | `Any`  | Any object-type variable | &nbsp; |
 
 
 
@@ -1672,17 +1732,17 @@ return a nwe Object excluding attributes in _props_ list
 ##### Returns
 
 
-- `Object`  clean object
+- `Number`  the size of the given variable
 
 
 
 
-### dist/general/object/pick.js
+### dist/general/string/capitalize.js
 
 
-#### pick(baseObject, keys) 
+#### capitalize(text) 
 
-return a new object just with attributes in _keys_ list
+Upper case the first letter of a given text
 
 
 
@@ -1691,8 +1751,7 @@ return a new object just with attributes in _keys_ list
 
 | Name | Type | Description |  |
 | ---- | ---- | ----------- | -------- |
-| baseObject | `Object`  | base object | &nbsp; |
-| keys | `Array.<String>`  | list of attributes to preserve | &nbsp; |
+| text | `String`  |  | &nbsp; |
 
 
 
@@ -1700,17 +1759,18 @@ return a new object just with attributes in _keys_ list
 ##### Returns
 
 
-- `Object`  new object just with desired attributes
+- `String`  a capitalized text
 
 
 
 
-### dist/date/range/getDateRange.js
+### dist/general/object/cloneDeep.js
 
 
-#### getDateRange(value, dateGroupLabel, withTime) 
+#### cloneDeep(obj) 
 
-Get date range object from a string date value
+A simple Deep Cloning function. Valid only for primivite values and object with primitive values.
+Not to use this function with inner objects and functions
 
 
 
@@ -1719,106 +1779,131 @@ Get date range object from a string date value
 
 | Name | Type | Description |  |
 | ---- | ---- | ----------- | -------- |
-| value | `String`  | string date value | &nbsp; |
-| dateGroupLabel | `String`  | could be 'YEAR', 'QUARTER', 'MONTH' or 'DAY'. Deafult is 'DAY' | &nbsp; |
-| withTime | `Boolean`  | determines if the date range will include time. Default is true | &nbsp; |
+| obj |  | The object | &nbsp; |
 
 
 
 
-##### Examples
+##### Returns
 
-```javascript
-// 1) Year:
-getDateRange('2020', 'YEAR');
-// Will return:
-{
-   from: '01/01/2020 00:00:00',
-   to: '12/31/2020 23:59:59'
-}
 
-// 2) Quarter:
-getDateRange('Q3 2020', 'QUARTER');
-// Will return:
-{
-   from: '07/01/2020 00:00:00',
-   to: '09/30/2020 23:59:59'
-}
+-  The new reference object or the given object if the parsing is incorrect or empty
 
-// 3) Month:
-getDateRange('Oct 2020', 'MONTH');
-// Will return:
-{
-   from: '10/01/2020 00:00:00',
-   to: '10/31/2020 23:59:59'
-}
-```
 
 
-##### Returns
+
+### dist/general/object/get.js
 
 
-- `Object`  an object with the date range with two string date properties: from and to
+#### _get(baseObject, path, defaultValue) 
+
+Like lodash _.get.
+Gets the value at path of object. If the resolved value is undefined, the defaultValue is returned in its place.
 
+Empty arrays and empty objects are returned but the defaultValue is not
+Undefined and null values will return the defaultValue.
 
 
 
-### dist/date/relative/Adapter.js
 
+##### Parameters
 
-#### value() 
+| Name | Type | Description |  |
+| ---- | ---- | ----------- | -------- |
+| baseObject |  | The object to query | &nbsp; |
+| path |  | The string path or collection of string paths of the property to get. | &nbsp; |
+| defaultValue |  | The value returned for undefined resolved values. | &nbsp; |
 
-Resolves statement and returns statement value
 
 
 
+##### Examples
+
+```javascript
+// returns 'Hello'
+_get({ item1: 'Hello', item2: 'World' }, 'item1')
+```
+```javascript
+// returns 'A simple Hello'
+_get({ item1: 'Hello', item2: 'World' }, 'item3', 'A simple Hello')
+```
+```javascript
+// returns 'Hello Again'
+_get({ item1: { item11: 'Hello Again' }, item2: {} }, 'item1.item11')
+```
+```javascript
+// returns 'Hello 2'
+_get({ item1: ['Hello 1', 'Hello 2' }, item2: [] }, 'item1[1]')
+```
+```javascript
+// returns 'Hello Again'
+_get({ item1: { item11: 'Hello Again' }, item2: {} }, ['item1', 'item11'])
+```
+
+
+##### Returns
+
 
+-  the resolved value.
 
 
-##### Returns
 
 
-- `AbsoluteRange` `string`  
+### dist/general/object/hasProperty.js
 
 
+#### _hasProperty(obj, property) 
 
-#### valueAsAnchor() 
+Use the hasOwnProperty in order to verify if the given property exists in the object.
 
-Resolves statement as an anchor
 
 
 
+##### Parameters
 
+| Name | Type | Description |  |
+| ---- | ---- | ----------- | -------- |
+| obj | `object`  | an object | &nbsp; |
+| property | `string`  | String to verify if exists in the object as property | &nbsp; |
 
 
-##### Returns
 
 
-- `string`  
+##### Examples
 
+```javascript
+const prop = 'prop2'
+const obj1 = { prop1: 'hello', prop2: 'world'}
+_hasProperty(ob1, prop1) // true
 
+const obj2 = { prop1: 'hello world' }
+_hasProperty(ob1, prop2) // false
+```
 
-#### _statementToRange()  *private method*
 
-Convert verbal statement to range value
+##### Returns
 
 
+-  True if the object has the given property; otherwise, false.
 
 
 
 
-##### Returns
+### dist/general/object/isObject.js
 
 
-- `AbsoluteRange`  
+#### isObject(obj) 
 
+Checks if the given argument is an object type
 
 
-#### _resolveAsThis()  *private method*
 
-Apply 'this' cursor logic to statement
 
+##### Parameters
 
+| Name | Type | Description |  |
+| ---- | ---- | ----------- | -------- |
+| obj |  | the variable to check | &nbsp; |
 
 
 
@@ -1826,45 +1911,46 @@ Apply 'this' cursor logic to statement
 ##### Returns
 
 
-- `AbsoluteStatement`  
-
-
-
-#### _resolveAsTheLast()  *private method*
+-  True: It is an object; False: It is not.
 
-Apply 'the last' cursor logic to statement
 
 
 
+### dist/general/object/mapValues.js
 
 
+#### mapValues(baseObject, iteratee) 
 
-##### Returns
+Invoke iteratee (function) for each object key-value pair
+and return a mapped object
 
 
-- `AbsoluteStatement`  
 
 
+##### Parameters
 
-#### _resolveAsTheNext()  *private method*
+| Name | Type | Description |  |
+| ---- | ---- | ----------- | -------- |
+| baseObject | `Object`  | Base object. | &nbsp; |
+| iteratee | `Function`  | The executed per iteration. | &nbsp; |
 
-Apply 'the next' cursor logic to statement
 
 
 
+##### Returns
 
 
+- `Object`  New mapped object.
 
-##### Returns
 
 
-- `AbsoluteStatement`  
 
+### dist/general/object/objectCopy.js
 
 
-#### replaceNowToken(value, now) 
+#### objectCopy(entity, cache) 
 
-Replace '@now' token inside a string
+Created a new reference of the given argument
 
 
 
@@ -1873,8 +1959,8 @@ Replace '@now' token inside a string
 
 | Name | Type | Description |  |
 | ---- | ---- | ----------- | -------- |
-| value | `string`  |  | &nbsp; |
-| now | `Date`  |  | &nbsp; |
+| entity |  | The variable to be copied | &nbsp; |
+| cache |  |  | &nbsp; |
 
 
 
@@ -1882,60 +1968,45 @@ Replace '@now' token inside a string
 ##### Returns
 
 
-- `string`  
+-  A new reference of the given argument
 
 
 
-#### convertRelativeToAbsolute(args) 
 
-Returns a range object (date) from a group of statement params
+### dist/general/object/omit.js
 
 
+#### omit(obj, props) 
 
+return a nwe Object excluding attributes in _props_ list
 
-##### Parameters
 
-| Name | Type | Description |  |
-| ---- | ---- | ----------- | -------- |
-| args | `RelativeToAbsoluteStruct`  |  | &nbsp; |
 
 
+##### Parameters
 
+| Name | Type | Description |  |
+| ---- | ---- | ----------- | -------- |
+| obj | `Object`  | base object | &nbsp; |
+| props | `Array.<String>`  | list of attribute to exclude | &nbsp; |
 
-##### Examples
 
-```javascript
-pivot = '2021-03-03T12:30:40'
-unit = month
-steps = 2
-setTo = END
-resolverAsCalendar: true
-=> Returns  '2021-05-31T23:59:59'
-```
-```javascript
-pivot = '2021-03-03T12:30:40'
-unit = month
-steps = -2
-setTo = START
-resolverAsCalendar: false
-=> Returns '2021-01-03T00:00:00'
-```
 
 
 ##### Returns
 
 
-- `string`  
+- `Object`  clean object
 
 
 
 
-### dist/date/relative/relative.js
+### dist/general/object/pick.js
 
 
-#### resolveRelative(statements, clock) 
+#### pick(baseObject, keys) 
 
-Resolve a list of relative statements according to operator
+return a new object just with attributes in _keys_ list
 
 
 
@@ -1944,34 +2015,16 @@ Resolve a list of relative statements according to operator
 
 | Name | Type | Description |  |
 | ---- | ---- | ----------- | -------- |
-| statements | `Array.<RelativeStatement>` `Array.<string>`  | - Raw statements/values | &nbsp; |
-| clock | `Date`  | - Clock/time reference for relative date resolution | &nbsp; |
-
-
-
-
-##### Examples
+| baseObject | `Object`  | base object | &nbsp; |
+| keys | `Array.<String>`  | list of attributes to preserve | &nbsp; |
 
-```javascript
-Input:
-{
- "cursor": "the_next",
- "unit": "year",
- "number": 1,
- "includeCurrent": false,
- "isCalendarDate": false,
- "anchor": "03/05/2021"
-}
 
-Output:
-{ gte: "03/06/2021 00:00:00", lte: "03/05/2022 23:59:59" }
-```
 
 
 ##### Returns
 
 
-- `Array.&lt;AbsoluteRange&gt;` `Array.&lt;string&gt;`  
+- `Object`  new object just with desired attributes
 
 
 
@@ -2009,6 +2062,26 @@ someMethod() {
 
 
 
+### dist/stencil/util/createRef.js
+
+
+#### createRef() 
+
+lit implementation of React createRef (https://reactjs.org/docs/refs-and-the-dom.html)
+
+
+
+
+
+
+##### Returns
+
+
+-  function - Function to use in ref prop in html elements
+
+
+
+
 ### dist/stencil/util/getConfig.js
 
 
@@ -2040,32 +2113,39 @@ try to find this string as a variable on Windows object
 
 
 
-### dist/stencil/util/createRef.js
+### dist/typescript/decorators/Debounce.js
 
 
-#### createRef() 
+#### Debounce(time) 
 
-lit implementation of React createRef (https://reactjs.org/docs/refs-and-the-dom.html)
+(Method Decorator) Debounce Class Method
 
 
 
 
+##### Parameters
+
+| Name | Type | Description |  |
+| ---- | ---- | ----------- | -------- |
+| time |  | (optional) deafult 500 | &nbsp; |
+
+
 
 
 ##### Returns
 
 
--  function - Function to use in ref prop in html elements
+- `Void`
 
 
 
 
-### dist/typescript/decorators/Debounce.js
+### dist/typescript/decorators/Throttled.js
 
 
-#### Debounce(time) 
+#### Throttled(time) 
 
-(Method Decorator) Debounce Class Method
+(Method Decorator) Throttled Class Method
 
 
 
@@ -2087,12 +2167,12 @@ lit implementation of React createRef (https://reactjs.org/docs/refs-and-the-dom
 
 
 
-### dist/typescript/decorators/Throttled.js
+### dist/filters/helpers/builder/getFilterBuilderGeneralConfig.js
 
 
-#### Throttled(time) 
+#### getFilterBuilderGeneralConfig(config) 
 
-(Method Decorator) Throttled Class Method
+Returns a filter builder config object by a any given config
 
 
 
@@ -2101,7 +2181,7 @@ lit implementation of React createRef (https://reactjs.org/docs/refs-and-the-dom
 
 | Name | Type | Description |  |
 | ---- | ---- | ----------- | -------- |
-| time |  | (optional) deafult 500 | &nbsp; |
+| config |  | any config object | &nbsp; |
 
 
 
@@ -2109,7 +2189,7 @@ lit implementation of React createRef (https://reactjs.org/docs/refs-and-the-dom
 ##### Returns
 
 
-- `Void`
+-  The filter builder config object
 
 
 
@@ -2410,33 +2490,6 @@ Gets filters from the logic by the scopes hierarchy.
 
 
 
-### dist/filters/helpers/builder/getFilterBuilderGeneralConfig.js
-
-
-#### getFilterBuilderGeneralConfig(config) 
-
-Returns a filter builder config object by a any given config
-
-
-
-
-##### Parameters
-
-| Name | Type | Description |  |
-| ---- | ---- | ----------- | -------- |
-| config |  | any config object | &nbsp; |
-
-
-
-
-##### Returns
-
-
--  The filter builder config object
-
-
-
-
 ### dist/filters/helpers/common/arePropertiesDateP.js
 
 
@@ -2797,12 +2850,12 @@ Gets filters from Filter Data by Scopes/Scope IDs.
 
 
 
-### dist/filters/helpers/common/getMergeFiltersSettings.js
+### dist/filters/helpers/common/getFiltersByVisibility.js
 
 
-#### getMergeFiltersSettings(settings) 
+#### getFiltersByVisibility(filterData, scopes) 
 
-Transforms the given MergeFilters settings object. Adds the missing properties if they do not exist.
+Get a new Filter Data by filtering scopes/scope IDs and enabled flags
 
 
 
@@ -2811,7 +2864,8 @@ Transforms the given MergeFilters settings object. Adds the missing properties i
 
 | Name | Type | Description |  |
 | ---- | ---- | ----------- | -------- |
-| settings |  | an object to the MergeFilters settings | &nbsp; |
+| filterData |  | a Filter Data or UI Filter Data | &nbsp; |
+| scopes |  | a Scopes/Scope IDs array | &nbsp; |
 
 
 
@@ -2819,17 +2873,17 @@ Transforms the given MergeFilters settings object. Adds the missing properties i
 ##### Returns
 
 
--  a new MergeFilters settings object.
+-  a new Filter Data
 
 
 
 
-### dist/filters/helpers/common/getFiltersByVisibility.js
+### dist/filters/helpers/common/getMergeFiltersSettings.js
 
 
-#### getFiltersByVisibility(filterData, scopes) 
+#### getMergeFiltersSettings(settings) 
 
-Get a new Filter Data by filtering scopes/scope IDs and enabled flags
+Transforms the given MergeFilters settings object. Adds the missing properties if they do not exist.
 
 
 
@@ -2838,8 +2892,7 @@ Get a new Filter Data by filtering scopes/scope IDs and enabled flags
 
 | Name | Type | Description |  |
 | ---- | ---- | ----------- | -------- |
-| filterData |  | a Filter Data or UI Filter Data | &nbsp; |
-| scopes |  | a Scopes/Scope IDs array | &nbsp; |
+| settings |  | an object to the MergeFilters settings | &nbsp; |
 
 
 
@@ -2847,7 +2900,7 @@ Get a new Filter Data by filtering scopes/scope IDs and enabled flags
 ##### Returns
 
 
--  a new Filter Data
+-  a new MergeFilters settings object.
 
 
 
@@ -3316,6 +3369,33 @@ Excludes and returns a UI Flat Filters without filters by the given scopes
 
 
 
+### dist/filters/helpers/ui/getFilterPropertyLabel.js
+
+
+#### getFilterPropertyLabel(filter) 
+
+Gets the label of the filter property
+
+
+
+
+##### Parameters
+
+| Name | Type | Description |  |
+| ---- | ---- | ----------- | -------- |
+| filter |  | The UI Filter | &nbsp; |
+
+
+
+
+##### Returns
+
+
+-  a string of the filter property label
+
+
+
+
 ### dist/filters/helpers/ui/getOutputFormatByColumn.js