@qrvey/utils 1.2.9-2 → 1.2.9-6

package/README.md

@@ -1,4 +1,4 @@
-# [@qrvey/utils](https://bitbucket.org/qrvey/qrvey_utils/wiki/Home) *1.2.9-2*
+# [@qrvey/utils](https://bitbucket.org/qrvey/qrvey_utils/wiki/Home) *1.2.9-6*
 
 > Helper, Utils for all Qrvey Projects
 
@@ -366,6 +366,35 @@ Get the new property base on the old date grouping properties
 
 
 
+### dist/filters/adapters/adaptFilterData.js
+
+
+#### adaptFilterData(filterData, getUIFilterData, datasetsInfo) 
+
+Checks and adapts the v2.0 Filter Data Structure to the v2.1
+
+
+
+
+##### Parameters
+
+| Name | Type | Description |  |
+| ---- | ---- | ----------- | -------- |
+| filterData |  | The filter data structure. Accepts both v2.1 or v2.0 |   |
+| getUIFilterData |  | Flag to get a Filter Data (False) or the UI Filter Data (True) |   |
+| datasetsInfo |  | Collection of datasets information. If getUIFilterData is true, the datasetsInfo should be mandatory |   |
+
+
+
+
+##### Returns
+
+
+-  A new filter data structure v2.1
+
+
+
+
 ### dist/filters/adapters/adaptFilterValues.js
 
 
@@ -515,35 +544,6 @@ Gets an filter structure for the filter data
 
 
 
-### dist/filters/adapters/adaptFilterData.js
-
-
-#### adaptFilterData(filterData, getUIFilterData, datasetsInfo) 
-
-Checks and adapts the v2.0 Filter Data Structure to the v2.1
-
-
-
-
-##### Parameters
-
-| Name | Type | Description |  |
-| ---- | ---- | ----------- | -------- |
-| filterData |  | The filter data structure. Accepts both v2.1 or v2.0 |   |
-| getUIFilterData |  | Flag to get a Filter Data (False) or the UI Filter Data (True) |   |
-| datasetsInfo |  | Collection of datasets information. If getUIFilterData is true, the datasetsInfo should be mandatory |   |
-
-
-
-
-##### Returns
-
-
--  A new filter data structure v2.1
-
-
-
-
 ### dist/filters/adapters/flatUIToLogic.js
 
 
@@ -930,6 +930,26 @@ const filterData = transformFilters(oldPreferenceFilters, 'ANALYZE');
 
 
 
+### dist/filters/classes/FilterInputErrorHandler.js
+
+
+#### new FilterInputErrorHandler() 
+
+
+
+
+
+
+
+
+##### Returns
+
+
+- `Void`
+
+
+
+
 ### dist/filters/helpers/applyHierarchyForAggFilters.js
 
 
@@ -1041,14 +1061,22 @@ Gets the Scopes IDS for the Available Scope function by any config
 
 
 
-### dist/filters/classes/FilterInputErrorHandler.js
+### dist/general/array/delete.js
 
 
-#### new FilterInputErrorHandler() 
+#### ArrayDelete(array, index) 
+
+Inmutable Array Item deletion
 
 
 
 
+##### Parameters
+
+| Name | Type | Description |  |
+| ---- | ---- | ----------- | -------- |
+| array | `Array`  | a collection of items to delete |   |
+| index | `Number`  | the position of the item to delete |   |
 
 
 
@@ -1056,17 +1084,20 @@ Gets the Scopes IDS for the Available Scope function by any config
 ##### Returns
 
 
-- `Void`
+-  a new Array or the given parameter when is empty or not an array
 
 
 
 
-### dist/dates/adapters/mdyDateToDate.js
+### dist/general/array/filterNestedTree.js
 
 
-#### mdyDateToDate(monthYearDate, time) 
+#### filterNestedTree(arr, childArrKey, condition) 
 
-Transforms String Date from a [mm/dd/yyyy] format to Date object.
+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
 
 
 
@@ -1075,8 +1106,9 @@ Transforms String Date from a [mm/dd/yyyy] format to Date object.
 
 | Name | Type | Description |  |
 | ---- | ---- | ----------- | -------- |
-| monthYearDate |  | String of [mm/dd/yyyy] date |   |
-| time |  | Flag to parse the object date to milliseconds. |   |
+| 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 |   |
 
 
 
@@ -1084,17 +1116,17 @@ Transforms String Date from a [mm/dd/yyyy] format to Date object.
 ##### Returns
 
 
--  The date object or the date in milliseconds
+-  array filtered
 
 
 
 
-### dist/dates/adapters/monthYearToDate.js
+### dist/general/array/flattenDeep.js
 
 
-#### monthYearToDate(monthYearDate, time) 
+#### flattenDeep(arr) 
 
-Transforms String Date from a [Month Year] format to Date object.
+Flat deeply an array
 
 
 
@@ -1103,8 +1135,7 @@ Transforms String Date from a [Month Year] format to Date object.
 
 | Name | Type | Description |  |
 | ---- | ---- | ----------- | -------- |
-| monthYearDate |  | String of [Month Year] date |   |
-| time |  | Flag to parse the object date to milliseconds. |   |
+| arr |  | Array to flat deeply |   |
 
 
 
@@ -1112,17 +1143,17 @@ Transforms String Date from a [Month Year] format to Date object.
 ##### Returns
 
 
--  The date object or the date in milliseconds
+-  flatten array
 
 
 
 
-### dist/dates/adapters/quarterYearToDate.js
+### dist/general/array/getFirstIndexFromArray.js
 
 
-#### quarterYearToDate(quarterYearDate, time) 
+#### getFirstIndexFromArray(array, callback) 
 
-Transforms String Date from a [Quarter Year] format to Date object.
+Gets the first index from the array by a callback condition
 
 
 
@@ -1131,8 +1162,8 @@ Transforms String Date from a [Quarter Year] format to Date object.
 
 | Name | Type | Description |  |
 | ---- | ---- | ----------- | -------- |
-| quarterYearDate |  | String of [Quarter Year] date |   |
-| time |  | Flag to parse the object date to milliseconds. |   |
+| array |  |  |   |
+| callback |  | function callback |   |
 
 
 
@@ -1140,17 +1171,17 @@ Transforms String Date from a [Quarter Year] format to Date object.
 ##### Returns
 
 
--  The date object or the date in milliseconds
+-  the first index of the array. -1 when the condition is not satisfied
 
 
 
 
-### dist/dates/adapters/weekYearToDate.js
+### dist/general/array/getLastIndexFromArray.js
 
 
-#### weekYearToDate(date, time) 
+#### getLastIndexFromArray(array, callback) 
 
-Transforms String Date from a [Week Year] format to Date object.
+Gets the last index from the array by a callback condition
 
 
 
@@ -1159,8 +1190,8 @@ Transforms String Date from a [Week Year] format to Date object.
 
 | Name | Type | Description |  |
 | ---- | ---- | ----------- | -------- |
-| date |  | String of [Week Year] date |   |
-| time |  | Flag to parse the object date to milliseconds. |   |
+| array |  |  |   |
+| callback |  | function callback |   |
 
 
 
@@ -1168,17 +1199,17 @@ Transforms String Date from a [Week Year] format to Date object.
 ##### Returns
 
 
--  The date object or the date in milliseconds
+-  the last index of the array. -1 when the condition is not satisfied
 
 
 
 
-### dist/dates/adapters/yearToDate.js
+### dist/general/function/debounce.js
 
 
-#### yearToDate(yearDate, time) 
+#### debounce(fn, time) 
 
-Transforms String Date from a [Year] format to Date object.
+Delays invoking _fn_ until after _time_ milliseconds have elapsed since the last time the debounced function was invoked.
 
 
 
@@ -1187,8 +1218,8 @@ Transforms String Date from a [Year] format to Date object.
 
 | Name | Type | Description |  |
 | ---- | ---- | ----------- | -------- |
-| yearDate |  | String of [Year] date |   |
-| time |  | Flag to parse the object date to milliseconds. |   |
+| fn | `Function`  | original Function |   |
+| time | `Number`  | default 500ms |   |
 
 
 
@@ -1196,17 +1227,17 @@ Transforms String Date from a [Year] format to Date object.
 ##### Returns
 
 
--  The date object or the date in milliseconds
+- `Function`  debounced functions
 
 
 
 
-### dist/dates/helpers/getDateByDateFormat.js
+### dist/general/function/throttled.js
 
 
-#### getDateByDateFormat(date, format, time) 
+#### throttled(fn, time) 
 
-Gets a Date Object instance by a Date format
+Make sure to only invokes _fn_ at most once per every _time_ milliseconds
 
 
 
@@ -1215,9 +1246,8 @@ Gets a Date Object instance by a Date format
 
 | Name | Type | Description |  |
 | ---- | ---- | ----------- | -------- |
-| date |  | String with a formatted date |   |
-| format |  | The date format |   |
-| time |  | flag to convert the formatted date to miliseconds |   |
+| fn | `Function`  | original Function |   |
+| time | `Number`  | default 500ms |   |
 
 
 
@@ -1225,17 +1255,18 @@ Gets a Date Object instance by a Date format
 ##### Returns
 
 
--  a Date object, milisecond time or the same value if date format does not match.
+- `Function`  throttled function
 
 
 
 
-### dist/dates/helpers/getDateFormatByProperty.js
+### dist/general/mix/compareDeep.js
 
 
-#### getDateFormatByProperty(property) 
+#### compareDeep(object1, object2) 
 
-Gets the date format by the given property
+Compares two objects to know if they are equals. Go across nested objects.
+Includes arrays in the comparison.
 
 
 
@@ -1244,7 +1275,8 @@ Gets the date format by the given property
 
 | Name | Type | Description |  |
 | ---- | ---- | ----------- | -------- |
-| property |  | The Column Property |   |
+| object1 |  | First Object to compare |   |
+| object2 |  | Second Object to compare |   |
 
 
 
@@ -1252,17 +1284,17 @@ Gets the date format by the given property
 ##### Returns
 
 
--  The date format
+-  True: objects are equal. False: Objects are not equal. Undefined: invalid
 
 
 
 
-### dist/dates/helpers/getDateFormatRegularExpressionInArray.js
+### dist/general/mix/getTag.js
 
 
-#### getDateFormatRegularExpressionInArray(dateFormat) 
+#### getTag(value) 
 
-Gets an array of regular expressions by the given date format
+Gets the `toStringTag` of `value`.
 
 
 
@@ -1271,7 +1303,7 @@ Gets an array of regular expressions by the given date format
 
 | Name | Type | Description |  |
 | ---- | ---- | ----------- | -------- |
-| dateFormat |  | the date format |   |
+| value |  | The value to query. |   |
 
 
 
@@ -1279,17 +1311,17 @@ Gets an array of regular expressions by the given date format
 ##### Returns
 
 
--  an array of regular expressions
+- `string`  Returns the `toStringTag`.
 
 
 
 
-### dist/dates/helpers/getSeparatorByDateFormat.js
+### dist/general/mix/importScripts.js
 
 
-#### getSeparatorByDateFormat(format) 
+#### importScripts(scripts) 
 
-Gets the separator of the date format
+Import a set of external Scripts given the URL in both serie and cascade way
 
 
 
@@ -1298,26 +1330,54 @@ Gets the separator of the date format
 
 | Name | Type | Description |  |
 | ---- | ---- | ----------- | -------- |
-| format |  | the date format |   |
+| 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; |
 
 
 
 
-##### Returns
+##### 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 }
+]);
 
--  a separator string
+// 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'
+]);
+```
 
 
+##### Returns
 
 
-### dist/dates/helpers/getWeek.js
+- `Promise`  Promise when all script have been loaded
 
 
-#### getWeek(date) 
 
-Gets the week number of the year
-Additionally, the month and the year
+#### loadScript(url, type, noModule) 
+
+Creates the script element and appends to document.head
+return a Promise that is resolved when the script is loaded
 
 
 
@@ -1326,7 +1386,9 @@ Additionally, the month and the year
 
 | Name | Type | Description |  |
 | ---- | ---- | ----------- | -------- |
-| date |  | the date object | &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; |
 
 
 
@@ -1334,20 +1396,17 @@ Additionally, the month and the year
 ##### Returns
 
 
--  an object with the week, month and year.
+- `Void`
 
 
 
 
-### dist/dates/helpers/validateDate.js
+### dist/general/mix/isEmpty.js
 
 
-#### validateDate(date, format) 
+#### isEmpty(variable, includeFalsy) 
 
-Validate a string date depending on giving format
-- If the string is a token label, the function lets it pass.
-- Otherwise depends of the format
-- Some escenarios the string is a mix of token labels and dates
+Validates if the given argument is empty
 
 
 
@@ -1356,26 +1415,28 @@ Validate a string date depending on giving format
 
 | Name | Type | Description |  |
 | ---- | ---- | ----------- | -------- |
-| date |  | String of date | &nbsp; |
-| format |  | String of the format to validate | &nbsp; |
-
+| variable |  | the given variable | &nbsp; |
+| includeFalsy |  | flag to determine include the falsy variables into the validation | &nbsp; |
+
 
 
 
 ##### Returns
 
 
--  True if it is valid or not. Undefined if date is undefined
+-  true: the given argument is empty; false: is not.
 
 
 
 
-### dist/dates/helpers/validateDateByDateFormat.js
+### dist/general/mix/isNaNV2.js
 
 
-#### validateDateByDateFormat(date, dateForma) 
+#### isNaNV2(variable) 
 
-Validates the given string as Date by its date format.
+Validates if the recieved number is NaN type.
+This function recieves any variable but will return false.
+Validates if variable is null, undefined, or an empty string, also, the function uses isNaN native function.
 
 
 
@@ -1384,8 +1445,7 @@ Validates the given string as Date by its date format.
 
 | Name | Type | Description |  |
 | ---- | ---- | ----------- | -------- |
-| date |  | a string to validate as date form | &nbsp; |
-| dateForma |  | the format of the date to validate the string | &nbsp; |
+| variable |  | the variable to validate | &nbsp; |
 
 
 
@@ -1393,17 +1453,18 @@ Validates the given string as Date by its date format.
 ##### Returns
 
 
--  true: the string is a valida date
+-  True if variable is a NaN or false otherwise
 
 
 
 
-### dist/dates/range/getDateRange.js
+### dist/general/mix/isNull.js
 
 
-#### getDateRange(value, dateGroupLabel, withTime) 
+#### isNull(arg) 
 
-Get date range object from a string date value
+return if a given variable is either `null` or `undefined`
+useful to avoid falsify validating Number Zero (0)
 
 
 
@@ -1412,74 +1473,37 @@ 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; |
-
-
-
-
-##### Examples
-
-```javascript
-// 1) Year:
-getDateRange('2020', 'YEAR');
-// Will return:
-{
-   from: '01/01/2020 00:00:00',
-   to: '12/31/2020 23:59:59'
-}
+| arg | `any`  |  | &nbsp; |
 
-// 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
 
 
-- `Object`  an object with the date range with two string date properties: from and to
-
-
-
-
-### dist/dates/relative/Adapter.js
-
-
-#### value() 
-
-Resolves statement and returns statement value
-
+- `Boolean`  
 
 
 
 
+### dist/general/mix/randomId.js
 
-##### Returns
 
+#### randomId(length, exclude) 
 
-- `AbsoluteRange` `string`  
+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.
 
 
 
-#### valueAsAnchor() 
-
-Resolves statement as an anchor
 
+##### Parameters
 
+| Name | Type | Description |  |
+| ---- | ---- | ----------- | -------- |
+| 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; |
 
 
 
@@ -1487,31 +1511,28 @@ Resolves statement as an anchor
 ##### Returns
 
 
-- `string`  
-
-
-
-#### _statementToRange()  *private method*
-
-Convert verbal statement to range value
-
-
+- `String`  Random string
 
 
 
 
-##### Returns
+### dist/general/mix/size.js
 
 
-- `AbsoluteRange`  
+#### size(obj) 
 
+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.
 
 
-#### _resolveAsThis()  *private method*
 
-Apply 'this' cursor logic to statement
 
+##### Parameters
 
+| Name | Type | Description |  |
+| ---- | ---- | ----------- | -------- |
+| obj | `Any`  | Any object-type variable | &nbsp; |
 
 
 
@@ -1519,45 +1540,45 @@ Apply 'this' cursor logic to statement
 ##### Returns
 
 
-- `AbsoluteStatement`  
-
+- `Number`  the size of the given variable
 
 
-#### _resolveAsTheLast()  *private method*
-
-Apply 'the last' cursor logic to statement
 
 
+### dist/general/string/capitalize.js
 
 
+#### capitalize(text) 
 
+Upper case the first letter of a given text
 
-##### Returns
 
 
-- `AbsoluteStatement`  
-
 
+##### Parameters
 
-#### _resolveAsTheNext()  *private method*
+| Name | Type | Description |  |
+| ---- | ---- | ----------- | -------- |
+| text | `String`  |  | &nbsp; |
 
-Apply 'the next' cursor logic to statement
 
 
 
+##### Returns
 
 
+- `String`  a capitalized text
 
-##### Returns
 
 
-- `AbsoluteStatement`  
 
+### dist/general/object/cloneDeep.js
 
 
-#### replaceNowToken(value, now) 
+#### cloneDeep(obj) 
 
-Replace '@now' token inside a string
+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
 
 
 
@@ -1566,8 +1587,7 @@ Replace '@now' token inside a string
 
 | Name | Type | Description |  |
 | ---- | ---- | ----------- | -------- |
-| value | `string`  |  | &nbsp; |
-| now | `Date`  |  | &nbsp; |
+| obj |  | The object | &nbsp; |
 
 
 
@@ -1575,13 +1595,21 @@ Replace '@now' token inside a string
 ##### Returns
 
 
-- `string`  
+-  The new reference object or the given object if the parsing is incorrect or empty
 
 
 
-#### convertRelativeToAbsolute(args) 
 
-Returns a range object (date) from a group of statement params
+### dist/general/object/get.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.
+
+Empty arrays and empty objects are returned but the defaultValue is not
+Undefined and null values will return the defaultValue.
 
 
 
@@ -1590,7 +1618,9 @@ Returns a range object (date) from a group of statement params
 
 | Name | Type | Description |  |
 | ---- | ---- | ----------- | -------- |
-| args | `RelativeToAbsoluteStruct`  |  | &nbsp; |
+| 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; |
 
 
 
@@ -1598,37 +1628,49 @@ Returns a range object (date) from a group of statement params
 ##### Examples
 
 ```javascript
-pivot = '2021-03-03T12:30:40'
-unit = month
-steps = 2
-setTo = END
-resolverAsCalendar: true
-=> Returns  '2021-05-31T23:59:59'
+// returns 'Hello'
+_get({ item1: 'Hello', item2: 'World' }, 'item1')
 ```
 ```javascript
-pivot = '2021-03-03T12:30:40'
-unit = month
-steps = -2
-setTo = START
-resolverAsCalendar: false
-=> Returns '2021-01-03T00:00:00'
+// 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
 
 
-- `string`  
+-  the resolved value.
 
 
 
 
-### dist/dates/relative/relative.js
+### dist/general/object/getAttribute.js
 
 
-#### resolveRelative(statements, clock) 
+#### getAttribute(obj, key) 
 
-Resolve a list of relative statements according to operator
+Searchs for properties in different case styles such as: lower, upper, camel and pascal
+- To optimize the searching, it is required a key in a snake_case style
+- List of cases that do not match
+-- From lower to snake case
+-- From upper to snake case
+-- From lower to camel case
+-- From upper to camel case
+-- From lower to pascal case
+-- From upper to pascal case
 
 
 
@@ -1637,8 +1679,8 @@ 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; |
+| obj | `object`  | object to look for | &nbsp; |
+| key | `string`  | String attribute in snake_case style | &nbsp; |
 
 
 
@@ -1646,35 +1688,24 @@ Resolve a list of relative statements according to operator
 ##### Examples
 
 ```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" }
+getAttribute(obj, 'snake_case') //it search for: obj.snake_case || obj.snakeCase || obj.SnakeCase || obj.snakecase || obj.SNAKECASE
 ```
 
 
 ##### Returns
 
 
-- `Array.&lt;AbsoluteRange&gt;` `Array.&lt;string&gt;`  
+- `Void`
 
 
 
 
-### dist/general/array/delete.js
+### dist/general/object/hasProperty.js
 
 
-#### ArrayDelete(array, index) 
+#### _hasProperty(obj, property) 
 
-Inmutable Array Item deletion
+Use the hasOwnProperty in order to verify if the given property exists in the object.
 
 
 
@@ -1683,29 +1714,38 @@ Inmutable Array Item deletion
 
 | Name | Type | Description |  |
 | ---- | ---- | ----------- | -------- |
-| array | `Array`  | a collection of items to delete | &nbsp; |
-| index | `Number`  | the position of the item to delete | &nbsp; |
+| obj | `object`  | an object | &nbsp; |
+| property | `string`  | String to verify if exists in the object as property | &nbsp; |
+
 
 
 
+##### Examples
+
+```javascript
+const prop = 'prop2'
+const obj1 = { prop1: 'hello', prop2: 'world'}
+_hasProperty(ob1, prop1) // true
+
+const obj2 = { prop1: 'hello world' }
+_hasProperty(ob1, prop2) // false
+```
+
 
 ##### Returns
 
 
--  a new Array or the given parameter when is empty or not an array
+-  True if the object has the given property; otherwise, false.
 
 
 
 
-### dist/general/array/filterNestedTree.js
+### dist/general/object/isObject.js
 
 
-#### filterNestedTree(arr, childArrKey, condition) 
+#### isObject(obj) 
 
-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
+Checks if the given argument is an object type
 
 
 
@@ -1714,9 +1754,7 @@ Filters a nested tree array by a custom condition on the last child node
 
 | Name | Type | Description |  |
 | ---- | ---- | ----------- | -------- |
-| 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; |
+| obj |  | the variable to check | &nbsp; |
 
 
 
@@ -1724,17 +1762,18 @@ Filters a nested tree array by a custom condition on the last child node
 ##### Returns
 
 
--  array filtered
+-  True: It is an object; False: It is not.
 
 
 
 
-### dist/general/array/flattenDeep.js
+### dist/general/object/mapValues.js
 
 
-#### flattenDeep(arr) 
+#### mapValues(baseObject, iteratee) 
 
-Flat deeply an array
+Invoke iteratee (function) for each object key-value pair
+and return a mapped object
 
 
 
@@ -1743,7 +1782,8 @@ Flat deeply an array
 
 | Name | Type | Description |  |
 | ---- | ---- | ----------- | -------- |
-| arr |  | Array to flat deeply | &nbsp; |
+| baseObject | `Object`  | Base object. | &nbsp; |
+| iteratee | `Function`  | The executed per iteration. | &nbsp; |
 
 
 
@@ -1751,17 +1791,18 @@ Flat deeply an array
 ##### Returns
 
 
--  flatten array
+- `Object`  New mapped object.
 
 
 
 
-### dist/general/array/getFirstIndexFromArray.js
+### dist/general/object/mergeDeep.js
 
 
-#### getFirstIndexFromArray(array, callback) 
+#### mergeDeep(obj1, obj2, settings) 
 
-Gets the first index from the array by a callback condition
+Merges two objects into a new one.
+The second given argument to the first given argument.
 
 
 
@@ -1770,8 +1811,9 @@ Gets the first index from the array by a callback condition
 
 | Name | Type | Description |  |
 | ---- | ---- | ----------- | -------- |
-| array |  |  | &nbsp; |
-| callback |  | function callback | &nbsp; |
+| obj1 |  | The target object | &nbsp; |
+| obj2 |  | The object to be merged | &nbsp; |
+| settings |  | Object settings for this function | &nbsp; |
 
 
 
@@ -1779,17 +1821,13 @@ 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
-
-
-
+-  a new merged object
 
-### dist/general/array/getLastIndexFromArray.js
 
 
-#### getLastIndexFromArray(array, callback) 
+#### isValid(obj1, obj2) 
 
-Gets the last index from the array by a callback condition
+Validates if the two arguments are objects
 
 
 
@@ -1798,8 +1836,8 @@ Gets the last index from the array by a callback condition
 
 | Name | Type | Description |  |
 | ---- | ---- | ----------- | -------- |
-| array |  |  | &nbsp; |
-| callback |  | function callback | &nbsp; |
+| obj1 |  | The target object | &nbsp; |
+| obj2 |  | The object to be merged | &nbsp; |
 
 
 
@@ -1807,17 +1845,13 @@ Gets the last index from the array by a callback condition
 ##### Returns
 
 
--  the last index of the array. -1 when the condition is not satisfied
-
-
-
+-  true: they are valid; false: they are not
 
-### dist/general/function/debounce.js
 
 
-#### debounce(fn, time) 
+#### getParamsToMergeDeep(settings) 
 
-Delays invoking _fn_ until after _time_ milliseconds have elapsed since the last time the debounced function was invoked.
+Validates and gets the settings with all set parameters.
 
 
 
@@ -1826,8 +1860,7 @@ Delays invoking _fn_ until after _time_ milliseconds have elapsed since the last
 
 | Name | Type | Description |  |
 | ---- | ---- | ----------- | -------- |
-| fn | `Function`  | original Function | &nbsp; |
-| time | `Number`  | default 500ms | &nbsp; |
+| settings |  | the settings object | &nbsp; |
 
 
 
@@ -1835,17 +1868,17 @@ Delays invoking _fn_ until after _time_ milliseconds have elapsed since the last
 ##### Returns
 
 
-- `Function`  debounced functions
+-  a new settings object with all set parameters.
 
 
 
 
-### dist/general/function/throttled.js
+### dist/general/object/objectCopy.js
 
 
-#### throttled(fn, time) 
+#### objectCopy(entity, cache) 
 
-Make sure to only invokes _fn_ at most once per every _time_ milliseconds
+Created a new reference of the given argument
 
 
 
@@ -1854,8 +1887,8 @@ Make sure to only invokes _fn_ at most once per every _time_ milliseconds
 
 | Name | Type | Description |  |
 | ---- | ---- | ----------- | -------- |
-| fn | `Function`  | original Function | &nbsp; |
-| time | `Number`  | default 500ms | &nbsp; |
+| entity |  | The variable to be copied | &nbsp; |
+| cache |  |  | &nbsp; |
 
 
 
@@ -1863,18 +1896,17 @@ Make sure to only invokes _fn_ at most once per every _time_ milliseconds
 ##### Returns
 
 
-- `Function`  throttled function
+-  A new reference of the given argument
 
 
 
 
-### dist/general/mix/compareDeep.js
+### dist/general/object/omit.js
 
 
-#### compareDeep(object1, object2) 
+#### omit(obj, props) 
 
-Compares two objects to know if they are equals. Go across nested objects.
-Includes arrays in the comparison.
+return a new Object excluding attributes in _props_ list
 
 
 
@@ -1883,8 +1915,8 @@ Includes arrays in the comparison.
 
 | Name | Type | Description |  |
 | ---- | ---- | ----------- | -------- |
-| object1 |  | First Object to compare | &nbsp; |
-| object2 |  | Second Object to compare | &nbsp; |
+| obj | `Object`  | base object | &nbsp; |
+| props | `Array.<String>`  | list of attribute to exclude | &nbsp; |
 
 
 
@@ -1892,17 +1924,17 @@ Includes arrays in the comparison.
 ##### Returns
 
 
--  True: objects are equal. False: Objects are not equal. Undefined: invalid
+- `Object`  clean object
 
 
 
 
-### dist/general/mix/getTag.js
+### dist/general/object/pick.js
 
 
-#### getTag(value) 
+#### pick(baseObject, keys) 
 
-Gets the `toStringTag` of `value`.
+return a new object just with attributes in _keys_ list
 
 
 
@@ -1911,7 +1943,8 @@ Gets the `toStringTag` of `value`.
 
 | Name | Type | Description |  |
 | ---- | ---- | ----------- | -------- |
-| value |  | The value to query. | &nbsp; |
+| baseObject | `Object`  | base object | &nbsp; |
+| keys | `Array.<String>`  | list of attributes to preserve | &nbsp; |
 
 
 
@@ -1919,17 +1952,17 @@ Gets the `toStringTag` of `value`.
 ##### Returns
 
 
-- `string`  Returns the `toStringTag`.
+- `Object`  new object just with desired attributes
 
 
 
 
-### dist/general/mix/importScripts.js
+### dist/general/object/serialize.js
 
 
-#### importScripts(scripts) 
+#### serialize(obj) 
 
-Import a set of external Scripts given the URL in both serie and cascade way
+serialize object to url param
 
 
 
@@ -1938,54 +1971,25 @@ 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; |
-
-
-
+| obj |  | - Object to be serialized | &nbsp; |
 
-##### 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'] }
-]);
+##### Returns
 
-// 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/dates/adapters/mdyDateToDate.js
 
 
-#### loadScript(url, type, noModule) 
+#### mdyDateToDate(monthYearDate, time) 
 
-Creates the script element and appends to document.head
-return a Promise that is resolved when the script is loaded
+Transforms String Date from a [mm/dd/yyyy] format to Date object.
 
 
 
@@ -1994,9 +1998,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; |
+| monthYearDate |  | String of [mm/dd/yyyy] date | &nbsp; |
+| time |  | Flag to parse the object date to milliseconds. | &nbsp; |
 
 
 
@@ -2004,17 +2007,17 @@ return a Promise that is resolved when the script is loaded
 ##### Returns
 
 
-- `Void`
+-  The date object or the date in milliseconds
 
 
 
 
-### dist/general/mix/isEmpty.js
+### dist/dates/adapters/monthYearToDate.js
 
 
-#### isEmpty(variable, includeFalsy) 
+#### monthYearToDate(monthYearDate, time) 
 
-Validates if the given argument is empty
+Transforms String Date from a [Month Year] format to Date object.
 
 
 
@@ -2023,8 +2026,8 @@ 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; |
+| monthYearDate |  | String of [Month Year] date | &nbsp; |
+| time |  | Flag to parse the object date to milliseconds. | &nbsp; |
 
 
 
@@ -2032,19 +2035,17 @@ Validates if the given argument is empty
 ##### Returns
 
 
--  true: the given argument is empty; false: is not.
+-  The date object or the date in milliseconds
 
 
 
 
-### dist/general/mix/isNaNV2.js
+### dist/dates/adapters/quarterYearToDate.js
 
 
-#### isNaNV2(variable) 
+#### quarterYearToDate(quarterYearDate, time) 
 
-Validates if the recieved number is NaN type.
-This function recieves any variable but will return false.
-Validates if variable is null, undefined, or an empty string, also, the function uses isNaN native function.
+Transforms String Date from a [Quarter Year] format to Date object.
 
 
 
@@ -2053,7 +2054,8 @@ Validates if variable is null, undefined, or an empty string, also, the function
 
 | Name | Type | Description |  |
 | ---- | ---- | ----------- | -------- |
-| variable |  | the variable to validate | &nbsp; |
+| quarterYearDate |  | String of [Quarter Year] date | &nbsp; |
+| time |  | Flag to parse the object date to milliseconds. | &nbsp; |
 
 
 
@@ -2061,18 +2063,17 @@ Validates if variable is null, undefined, or an empty string, also, the function
 ##### Returns
 
 
--  True if variable is a NaN or false otherwise
+-  The date object or the date in milliseconds
 
 
 
 
-### dist/general/mix/isNull.js
+### dist/dates/adapters/weekYearToDate.js
 
 
-#### isNull(arg) 
+#### weekYearToDate(date, time) 
 
-return if a given variable is either `null` or `undefined`
-useful to avoid falsify validating Number Zero (0)
+Transforms String Date from a [Week Year] format to Date object.
 
 
 
@@ -2081,7 +2082,8 @@ useful to avoid falsify validating Number Zero (0)
 
 | Name | Type | Description |  |
 | ---- | ---- | ----------- | -------- |
-| arg | `any`  |  | &nbsp; |
+| date |  | String of [Week Year] date | &nbsp; |
+| time |  | Flag to parse the object date to milliseconds. | &nbsp; |
 
 
 
@@ -2089,19 +2091,17 @@ useful to avoid falsify validating Number Zero (0)
 ##### Returns
 
 
-- `Boolean`  
+-  The date object or the date in milliseconds
 
 
 
 
-### dist/general/mix/randomId.js
+### dist/dates/adapters/yearToDate.js
 
 
-#### randomId(length, exclude) 
+#### yearToDate(yearDate, time) 
 
-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.
+Transforms String Date from a [Year] format to Date object.
 
 
 
@@ -2110,8 +2110,8 @@ Creates a random string
 
 | Name | Type | Description |  |
 | ---- | ---- | ----------- | -------- |
-| 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; |
+| yearDate |  | String of [Year] date | &nbsp; |
+| time |  | Flag to parse the object date to milliseconds. | &nbsp; |
 
 
 
@@ -2119,19 +2119,17 @@ Creates a random string
 ##### Returns
 
 
-- `String`  Random string
+-  The date object or the date in milliseconds
 
 
 
 
-### dist/general/mix/size.js
+### dist/dates/helpers/getDateByDateFormat.js
 
 
-#### size(obj) 
+#### getDateByDateFormat(date, format, time) 
 
-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.
+Gets a Date Object instance by a Date format
 
 
 
@@ -2140,7 +2138,9 @@ Gets the length of the given array.
 
 | Name | Type | Description |  |
 | ---- | ---- | ----------- | -------- |
-| obj | `Any`  | Any object-type variable | &nbsp; |
+| date |  | String with a formatted date | &nbsp; |
+| format |  | The date format | &nbsp; |
+| time |  | flag to convert the formatted date to miliseconds | &nbsp; |
 
 
 
@@ -2148,17 +2148,17 @@ Gets the length of the given array.
 ##### Returns
 
 
-- `Number`  the size of the given variable
+-  a Date object, milisecond time or the same value if date format does not match.
 
 
 
 
-### dist/general/string/capitalize.js
+### dist/dates/helpers/getDateFormatByProperty.js
 
 
-#### capitalize(text) 
+#### getDateFormatByProperty(property) 
 
-Upper case the first letter of a given text
+Gets the date format by the given property
 
 
 
@@ -2167,7 +2167,7 @@ Upper case the first letter of a given text
 
 | Name | Type | Description |  |
 | ---- | ---- | ----------- | -------- |
-| text | `String`  |  | &nbsp; |
+| property |  | The Column Property | &nbsp; |
 
 
 
@@ -2175,18 +2175,17 @@ Upper case the first letter of a given text
 ##### Returns
 
 
-- `String`  a capitalized text
+-  The date format
 
 
 
 
-### dist/general/object/cloneDeep.js
+### dist/dates/helpers/getDateFormatRegularExpressionInArray.js
 
 
-#### cloneDeep(obj) 
+#### getDateFormatRegularExpressionInArray(dateFormat) 
 
-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 an array of regular expressions by the given date format
 
 
 
@@ -2195,7 +2194,7 @@ Not to use this function with inner objects and functions
 
 | Name | Type | Description |  |
 | ---- | ---- | ----------- | -------- |
-| obj |  | The object | &nbsp; |
+| dateFormat |  | the date format | &nbsp; |
 
 
 
@@ -2203,21 +2202,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
-
+-  an array of regular expressions
 
 
 
-### dist/general/object/get.js
 
+### dist/dates/helpers/getSeparatorByDateFormat.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.
+#### getSeparatorByDateFormat(format) 
 
-Empty arrays and empty objects are returned but the defaultValue is not
-Undefined and null values will return the defaultValue.
+Gets the separator of the date format
 
 
 
@@ -2226,59 +2221,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; |
-
-
-
+| format |  | the date format | &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.
+-  a separator string
 
 
 
 
-### dist/general/object/getAttribute.js
+### dist/dates/helpers/getWeek.js
 
 
-#### getAttribute(obj, key) 
+#### getWeek(date) 
 
-Searchs for properties in different case styles such as: lower, upper, camel and pascal
-- To optimize the searching, it is required a key in a snake_case style
-- List of cases that do not match
--- From lower to snake case
--- From upper to snake case
--- From lower to camel case
--- From upper to camel case
--- From lower to pascal case
--- From upper to pascal case
+Gets the week number of the year
+Additionally, the month and the year
 
 
 
@@ -2287,73 +2249,56 @@ Searchs for properties in different case styles such as: lower, upper, camel and
 
 | Name | Type | Description |  |
 | ---- | ---- | ----------- | -------- |
-| obj | `object`  | object to look for | &nbsp; |
-| key | `string`  | String attribute in snake_case style | &nbsp; |
-
-
-
+| date |  | the date object | &nbsp; |
 
-##### Examples
 
-```javascript
-getAttribute(obj, 'snake_case') //it search for: obj.snake_case || obj.snakeCase || obj.SnakeCase || obj.snakecase || obj.SNAKECASE
-```
 
 
 ##### Returns
 
 
-- `Void`
-
-
-
-
-### dist/general/object/hasProperty.js
+-  an object with the week, month and year.
 
 
-#### _hasProperty(obj, property) 
 
-Use the hasOwnProperty in order to verify if the given property exists in the object.
 
+### dist/dates/helpers/validateDate.js
 
 
+#### validateDate(date, format) 
 
-##### Parameters
+Validate a string date depending on giving format
+- If the string is a token label, the function lets it pass.
+- Otherwise depends of the format
+- Some escenarios the string is a mix of token labels and dates
 
-| Name | Type | Description |  |
-| ---- | ---- | ----------- | -------- |
-| obj | `object`  | an object | &nbsp; |
-| property | `string`  | String to verify if exists in the object as property | &nbsp; |
 
 
 
+##### Parameters
 
-##### Examples
+| Name | Type | Description |  |
+| ---- | ---- | ----------- | -------- |
+| date |  | String of date | &nbsp; |
+| format |  | String of the format to validate | &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.
+-  True if it is valid or not. Undefined if date is undefined
 
 
 
 
-### dist/general/object/isObject.js
+### dist/dates/helpers/validateDateByDateFormat.js
 
 
-#### isObject(obj) 
+#### validateDateByDateFormat(date, dateForma) 
 
-Checks if the given argument is an object type
+Validates the given string as Date by its date format.
 
 
 
@@ -2362,7 +2307,8 @@ Checks if the given argument is an object type
 
 | Name | Type | Description |  |
 | ---- | ---- | ----------- | -------- |
-| obj |  | the variable to check | &nbsp; |
+| date |  | a string to validate as date form | &nbsp; |
+| dateForma |  | the format of the date to validate the string | &nbsp; |
 
 
 
@@ -2370,18 +2316,17 @@ Checks if the given argument is an object type
 ##### Returns
 
 
--  True: It is an object; False: It is not.
+-  true: the string is a valida date
 
 
 
 
-### dist/general/object/mapValues.js
+### dist/dates/range/getDateRange.js
 
 
-#### mapValues(baseObject, iteratee) 
+#### getDateRange(value, dateGroupLabel, withTime) 
 
-Invoke iteratee (function) for each object key-value pair
-and return a mapped object
+Get date range object from a string date value
 
 
 
@@ -2390,38 +2335,58 @@ and return a mapped object
 
 | Name | Type | Description |  |
 | ---- | ---- | ----------- | -------- |
-| baseObject | `Object`  | Base object. | &nbsp; |
-| iteratee | `Function`  | The executed per iteration. | &nbsp; |
+| 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; |
 
 
 
 
-##### Returns
+##### Examples
+
+```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'
+}
 
-- `Object`  New mapped object.
+// 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/mergeDeep.js
+- `Object`  an object with the date range with two string date properties: from and to
 
 
-#### mergeDeep(obj1, obj2, settings) 
 
-Merges two objects into a new one.
-The second given argument to the first given argument.
 
+### dist/dates/relative/Adapter.js
 
 
+#### value() 
+
+Resolves statement and returns statement value
 
-##### Parameters
 
-| Name | Type | Description |  |
-| ---- | ---- | ----------- | -------- |
-| obj1 |  | The target object | &nbsp; |
-| obj2 |  | The object to be merged | &nbsp; |
-| settings |  | Object settings for this function | &nbsp; |
 
 
 
@@ -2429,74 +2394,63 @@ The second given argument to the first given argument.
 ##### Returns
 
 
--  a new merged object
+- `AbsoluteRange` `string`  
 
 
 
-#### isValid(obj1, obj2) 
+#### valueAsAnchor() 
 
-Validates if the two arguments are objects
+Resolves statement as an anchor
 
 
 
 
-##### Parameters
 
-| Name | Type | Description |  |
-| ---- | ---- | ----------- | -------- |
-| obj1 |  | The target object | &nbsp; |
-| obj2 |  | The object to be merged | &nbsp; |
 
+##### Returns
 
 
+- `string`  
 
-##### Returns
 
 
--  true: they are valid; false: they are not
+#### _statementToRange()  *private method*
 
+Convert verbal statement to range value
 
 
-#### getParamsToMergeDeep(settings) 
 
-Validates and gets the settings with all set parameters.
 
 
 
+##### Returns
 
-##### Parameters
 
-| Name | Type | Description |  |
-| ---- | ---- | ----------- | -------- |
-| settings |  | the settings object | &nbsp; |
+- `AbsoluteRange`  
 
 
 
+#### _resolveAsThis()  *private method*
 
-##### Returns
+Apply 'this' cursor logic to statement
 
 
--  a new settings object with all set parameters.
 
 
 
 
-### dist/general/object/objectCopy.js
+##### Returns
 
 
-#### objectCopy(entity, cache) 
+- `AbsoluteStatement`  
 
-Created a new reference of the given argument
 
 
+#### _resolveAsTheLast()  *private method*
 
+Apply 'the last' cursor logic to statement
 
-##### Parameters
 
-| Name | Type | Description |  |
-| ---- | ---- | ----------- | -------- |
-| entity |  | The variable to be copied | &nbsp; |
-| cache |  |  | &nbsp; |
 
 
 
@@ -2504,17 +2458,29 @@ Created a new reference of the given argument
 ##### Returns
 
 
--  A new reference of the given argument
+- `AbsoluteStatement`  
 
 
 
+#### _resolveAsTheNext()  *private method*
 
-### dist/general/object/omit.js
+Apply 'the next' cursor logic to statement
 
 
-#### omit(obj, props) 
 
-return a new Object excluding attributes in _props_ list
+
+
+
+##### Returns
+
+
+- `AbsoluteStatement`  
+
+
+
+#### replaceNowToken(value, now) 
+
+Replace '@now' token inside a string
 
 
 
@@ -2523,8 +2489,8 @@ return a new Object excluding attributes in _props_ list
 
 | Name | Type | Description |  |
 | ---- | ---- | ----------- | -------- |
-| obj | `Object`  | base object | &nbsp; |
-| props | `Array.<String>`  | list of attribute to exclude | &nbsp; |
+| value | `string`  |  | &nbsp; |
+| now | `Date`  |  | &nbsp; |
 
 
 
@@ -2532,17 +2498,13 @@ return a new Object excluding attributes in _props_ list
 ##### Returns
 
 
-- `Object`  clean object
-
-
-
+- `string`  
 
-### dist/general/object/pick.js
 
 
-#### pick(baseObject, keys) 
+#### convertRelativeToAbsolute(args) 
 
-return a new object just with attributes in _keys_ list
+Returns a range object (date) from a group of statement params
 
 
 
@@ -2551,26 +2513,45 @@ 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; |
+| args | `RelativeToAbsoluteStruct`  |  | &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
 
 
-- `Object`  new object just with desired attributes
+- `string`  
 
 
 
 
-### dist/general/object/serialize.js
+### dist/dates/relative/relative.js
 
 
-#### serialize(obj) 
+#### resolveRelative(statements, clock) 
 
-serialize object to url param
+Resolve a list of relative statements according to operator
 
 
 
@@ -2579,15 +2560,34 @@ serialize object to url param
 
 | Name | Type | Description |  |
 | ---- | ---- | ----------- | -------- |
-| obj |  | - Object to be serialized | &nbsp; |
+| statements | `Array.<RelativeStatement>` `Array.<string>`  | - Raw statements/values | &nbsp; |
+| clock | `Date`  | - Clock/time reference for relative date resolution | &nbsp; |
+
+
 
 
+##### Examples
+
+```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
 
 
-- `Void`
+- `Array.&lt;AbsoluteRange&gt;` `Array.&lt;string&gt;`  
 
 
 
@@ -2703,12 +2703,12 @@ try to find this string as a variable on Windows object
 
 
 
-### dist/services/api/getAllDatasets.api.js
+### dist/typescript/decorators/Debounce.js
 
 
-#### getAllDatasets(qrveyids) 
+#### Debounce(time) 
 
-Get a dataset list from a collection of Qrvey IDs
+(Method Decorator) Debounce Class Method
 
 
 
@@ -2717,7 +2717,7 @@ Get a dataset list from a collection of Qrvey IDs
 
 | Name | Type | Description |  |
 | ---- | ---- | ----------- | -------- |
-| qrveyids |  | Collection of Qrvey IDs | &nbsp; |
+| time |  | (optional) deafult 500 | &nbsp; |
 
 
 
@@ -2725,17 +2725,17 @@ Get a dataset list from a collection of Qrvey IDs
 ##### Returns
 
 
--  a promise
+- `Void`
 
 
 
 
-### dist/services/api/getAllQrveys.api.js
+### dist/typescript/decorators/Throttled.js
 
 
-#### getAllQrveys(config, params) 
+#### Throttled(time) 
 
-POST Request for getting Qrveys such as Web Forms and Datasets. Use params for getting precise data
+(Method Decorator) Throttled Class Method
 
 
 
@@ -2744,8 +2744,7 @@ POST Request for getting Qrveys such as Web Forms and Datasets. Use params for g
 
 | Name | Type | Description |  |
 | ---- | ---- | ----------- | -------- |
-| config |  | Configuration | &nbsp; |
-| params |  | Object for getting precise data | &nbsp; |
+| time |  | (optional) deafult 500 | &nbsp; |
 
 
 
@@ -2758,12 +2757,12 @@ POST Request for getting Qrveys such as Web Forms and Datasets. Use params for g
 
 
 
-### dist/services/api/getDatasetColumns.api.js
+### dist/services/api/getAllDatasets.api.js
 
 
-#### getDatasetColumns(qrveyid) 
+#### getAllDatasets(qrveyids) 
 
-Get a dataset by Qrvey ID
+Get a dataset list from a collection of Qrvey IDs
 
 
 
@@ -2772,7 +2771,7 @@ Get a dataset by Qrvey ID
 
 | Name | Type | Description |  |
 | ---- | ---- | ----------- | -------- |
-| qrveyid |  | The Qrvey ID | &nbsp; |
+| qrveyids |  | Collection of Qrvey IDs | &nbsp; |
 
 
 
@@ -2785,12 +2784,12 @@ Get a dataset by Qrvey ID
 
 
 
-### dist/typescript/decorators/Debounce.js
+### dist/services/api/getAllQrveys.api.js
 
 
-#### Debounce(time) 
+#### getAllQrveys(config, params) 
 
-(Method Decorator) Debounce Class Method
+POST Request for getting Qrveys such as Web Forms and Datasets. Use params for getting precise data
 
 
 
@@ -2799,7 +2798,8 @@ Get a dataset by Qrvey ID
 
 | Name | Type | Description |  |
 | ---- | ---- | ----------- | -------- |
-| time |  | (optional) deafult 500 | &nbsp; |
+| config |  | Configuration | &nbsp; |
+| params |  | Object for getting precise data | &nbsp; |
 
 
 
@@ -2812,12 +2812,12 @@ Get a dataset by Qrvey ID
 
 
 
-### dist/typescript/decorators/Throttled.js
+### dist/services/api/getDatasetColumns.api.js
 
 
-#### Throttled(time) 
+#### getDatasetColumns(qrveyid) 
 
-(Method Decorator) Throttled Class Method
+Get a dataset by Qrvey ID
 
 
 
@@ -2826,7 +2826,7 @@ Get a dataset by Qrvey ID
 
 | Name | Type | Description |  |
 | ---- | ---- | ----------- | -------- |
-| time |  | (optional) deafult 500 | &nbsp; |
+| qrveyid |  | The Qrvey ID | &nbsp; |
 
 
 
@@ -2834,7 +2834,7 @@ Get a dataset by Qrvey ID
 ##### Returns
 
 
-- `Void`
+-  a promise