@qrvey/utils 1.1.2-0 → 1.1.2-1

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.2-1*
 
 > Helper, Utils for all Qrvey Projects
 
@@ -107,12 +107,12 @@ Get a text and evaluate if it matchs with a token box label.
 
 
 
-### dist/filters/adapters/FDToFlatUI.js
+### dist/date/range/getDateRange.js
 
 
-#### FDToFlatUI(filterData, datasetsInfo) 
+#### getDateRange(value, dateGroupLabel, withTime) 
 
-Generates a Flattened UI filter structure from Filter Data structure.
+Get date range object from a string date value
 
 
 
@@ -121,59 +121,74 @@ Generates a Flattened UI filter structure from Filter Data structure.
 
 | Name | Type | Description |  |
 | ---- | ---- | ----------- | -------- |
-| filterData |  | The filter data object. |   |
-| datasetsInfo |  | Collection of datasets information |   |
-
+| 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
 
--  a flattened UI filters array
+```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'
+}
 
+// 3) Month:
+getDateRange('Oct 2020', 'MONTH');
+// Will return:
+{
+   from: '10/01/2020 00:00:00',
+   to: '10/31/2020 23:59:59'
+}
+```
 
-#### FD21ToFlatUI(scopes, datasetsInfo) 
 
-Generates a Filter Builder Structure from the Filter Data structure v2.1
+##### Returns
 
 
+- `Object`  an object with the date range with two string date properties: from and to
 
 
-##### Parameters
 
-| Name | Type | Description |  |
-| ---- | ---- | ----------- | -------- |
-| scopes |  | The filter scope section |   |
-| datasetsInfo |  | Collection of datasets information |   |
 
+### dist/date/relative/Adapter.js
 
 
+#### value() 
 
-##### Returns
+Resolves statement and returns statement value
 
 
--  a flattened UI filters array
 
 
 
 
-### dist/filters/adapters/FDToLogic.js
+##### Returns
 
 
-#### FDToLogic(filterData) 
+- `AbsoluteRange` `string`  
 
-Generates a Filter Logic structure from Filter Data structure.
 
 
+#### valueAsAnchor() 
 
+Resolves statement as an anchor
 
-##### Parameters
 
-| Name | Type | Description |  |
-| ---- | ---- | ----------- | -------- |
-| filterData |  | The filter data object. |   |
 
 
 
@@ -181,22 +196,15 @@ Generates a Filter Logic structure from Filter Data structure.
 ##### Returns
 
 
--  a filter logic array
-
-
-
-#### getLogicBodyFromFD21(filterData) 
+- `string`  
 
-Gets the logic body
 
 
+#### _statementToRange()  *private method*
 
+Convert verbal statement to range value
 
-##### Parameters
 
-| Name | Type | Description |  |
-| ---- | ---- | ----------- | -------- |
-| filterData |  | The filter data object |   |
 
 
 
@@ -204,71 +212,61 @@ Gets the logic body
 ##### Returns
 
 
--  a filter logic array
+- `AbsoluteRange`  
 
 
 
+#### _resolveAsThis()  *private method*
 
-### dist/filters/adapters/FDToUI.js
+Apply 'this' cursor logic to statement
 
 
-#### FDToUI(filterData, datasetsInfo) 
 
-Generates a UI filter structure from Filter Data structure.
 
 
 
+##### Returns
 
-##### Parameters
 
-| Name | Type | Description |  |
-| ---- | ---- | ----------- | -------- |
-| filterData |  | The filter data object. |   |
-| datasetsInfo |  | Collection of datasets information |   |
+- `AbsoluteStatement`  
 
 
 
+#### _resolveAsTheLast()  *private method*
 
-##### Returns
+Apply 'the last' cursor logic to statement
 
 
--  a UI Filters structure
 
 
 
-#### FD21ToUI(scopes, section, version, datasetsInfo) 
 
-Generates a UI filter Structure from the Filter Data structure v2.1
+##### Returns
 
 
+- `AbsoluteStatement`  
 
 
-##### Parameters
 
-| Name | Type | Description |  |
-| ---- | ---- | ----------- | -------- |
-| scopes |  | The filter scope section |   |
-| section |  | The filter section. |   |
-| version |  | The version of the filter structure |   |
-| datasetsInfo |  | Collection of datasets information |   |
+#### _resolveAsTheNext()  *private method*
 
+Apply 'the next' cursor logic to statement
 
 
 
-##### Returns
 
 
--  a UI filter Structure
 
+##### Returns
 
 
+- `AbsoluteStatement`  
 
-### dist/filters/adapters/UIToFD.js
 
 
-#### UIToFD(filterData) 
+#### replaceNowToken(value, now) 
 
-Generates a Filter Data Structure structure from UI Filter Data structure.
+Replace '@now' token inside a string
 
 
 
@@ -277,7 +275,8 @@ Generates a Filter Data Structure structure from UI Filter Data structure.
 
 | Name | Type | Description |  |
 | ---- | ---- | ----------- | -------- |
-| filterData |  | The UI filter data object. |   |
+| value | `string`  |  |   |
+| now | `Date`  |  |   |
 
 
 
@@ -285,13 +284,13 @@ Generates a Filter Data Structure structure from UI Filter Data structure.
 ##### Returns
 
 
--  a Filter Data structure
+- `string`  
 
 
 
-#### UI21ToFD(uFilterData, version) 
+#### convertRelativeToAbsolute(args) 
 
-Builds the Fitler Data structure from UI filter data
+Returns a range object (date) from a group of statement params
 
 
 
@@ -300,26 +299,45 @@ Builds the Fitler Data structure from UI filter data
 
 | Name | Type | Description |  |
 | ---- | ---- | ----------- | -------- |
-| uFilterData |  | The UI filter Data object |   |
-| version |  | the version of the structure |   |
+| 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
 
 
--  
+- `string`  
 
 
 
 
-### dist/filters/adapters/UIToFlatUI.js
+### dist/date/relative/relative.js
 
 
-#### UIToFlatUI(filterData, datasetsInfo) 
+#### resolveRelative(statements, clock) 
 
-Generates a Flattened UI filter structure from UI Filter Data structure.
+Resolve a list of relative statements according to operator
 
 
 
@@ -328,22 +346,44 @@ Generates a Flattened UI filter structure from UI Filter Data structure.
 
 | Name | Type | Description |  |
 | ---- | ---- | ----------- | -------- |
-| filterData |  | The UI filter data object. |   |
-| datasetsInfo |  | Collection of datasets information. Optional for updating the datasets info |   |
+| 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
 
 
--  a flattened UI filters array
+- `Array.&lt;AbsoluteRange&gt;` `Array.&lt;string&gt;`  
 
 
 
-#### UI21ToFlatUI(scopes) 
 
-Generates a Flattened UI Filter Structure from the UI Filter Data structure v2.1
+### dist/filters/adapters/FDToFlatUI.js
+
+
+#### FDToFlatUI(filterData, datasetsInfo) 
+
+Generates a Flattened UI filter structure from Filter Data structure.
 
 
 
@@ -352,7 +392,8 @@ Generates a Flattened UI Filter Structure from the UI Filter Data structure v2.1
 
 | Name | Type | Description |  |
 | ---- | ---- | ----------- | -------- |
-| scopes |  | The filter scope section | &nbsp; |
+| filterData |  | The filter data object. | &nbsp; |
+| datasetsInfo |  | Collection of datasets information | &nbsp; |
 
 
 
@@ -364,13 +405,9 @@ Generates a Flattened UI Filter Structure from the UI Filter Data structure v2.1
 
 
 
+#### FD21ToFlatUI(scopes, datasetsInfo) 
 
-### dist/filters/adapters/adaptFilterData.js
-
-
-#### adaptFilterData(filterData, getUIFilterData, datasetsInfo) 
-
-Checks and adapts the v2.0 Filter Data Structure to the v2.1
+Generates a Filter Builder Structure from the Filter Data structure v2.1
 
 
 
@@ -379,9 +416,8 @@ Checks and adapts the v2.0 Filter Data Structure to the v2.1
 
 | Name | Type | Description |  |
 | ---- | ---- | ----------- | -------- |
-| filterData |  | The filter data structure. Accepts both v2.1 or v2.0 | &nbsp; |
-| getUIFilterData |  | Flag to get a Filter Data (False) or the UI Filter Data (True) | &nbsp; |
-| datasetsInfo |  | Collection of datasets information. If getUIFilterData is true, the datasetsInfo should be mandatory | &nbsp; |
+| scopes |  | The filter scope section | &nbsp; |
+| datasetsInfo |  | Collection of datasets information | &nbsp; |
 
 
 
@@ -389,17 +425,17 @@ Checks and adapts the v2.0 Filter Data Structure to the v2.1
 ##### Returns
 
 
--  A new filter data structure v2.1
+-  a flattened UI filters array
 
 
 
 
-### dist/filters/adapters/flatUIToFD.js
+### dist/filters/adapters/FDToLogic.js
 
 
-#### flatUIToFD(uFilters, version) 
+#### FDToLogic(filterData) 
 
-Generates a filter data structure from the flatttened UI filters.
+Generates a Filter Logic structure from Filter Data structure.
 
 
 
@@ -408,8 +444,7 @@ Generates a filter data structure from the flatttened UI filters.
 
 | Name | Type | Description |  |
 | ---- | ---- | ----------- | -------- |
-| uFilters |  | Array of flattened filters from UI | &nbsp; |
-| version |  | Tag for the version of the filter data structure | &nbsp; |
+| filterData |  | The filter data object. | &nbsp; |
 
 
 
@@ -417,14 +452,13 @@ Generates a filter data structure from the flatttened UI filters.
 ##### Returns
 
 
--  a Filter Data.
+-  a filter logic array
 
 
 
-#### buildScopes(fbFilters) 
+#### getLogicBodyFromFD21(filterData) 
 
-Gets an array of scopes structure for the filter data. The scopes is organized by scope types and scope IDs
-Also, adds and organizes filters by datasets
+Gets the logic body
 
 
 
@@ -433,7 +467,7 @@ Also, adds and organizes filters by datasets
 
 | Name | Type | Description |  |
 | ---- | ---- | ----------- | -------- |
-| fbFilters |  | Array of flat filters from UI | &nbsp; |
+| filterData |  | The filter data object | &nbsp; |
 
 
 
@@ -441,13 +475,17 @@ Also, adds and organizes filters by datasets
 ##### Returns
 
 
--  an array of scopes structure.
+-  a filter logic array
 
 
 
-#### buildScope(uFilter) 
 
-Gets an scope structure for the filter data
+### dist/filters/adapters/FDToUI.js
+
+
+#### FDToUI(filterData, datasetsInfo) 
+
+Generates a UI filter structure from Filter Data structure.
 
 
 
@@ -456,7 +494,8 @@ Gets an scope structure for the filter data
 
 | Name | Type | Description |  |
 | ---- | ---- | ----------- | -------- |
-| uFilter |  | UI structure filter | &nbsp; |
+| filterData |  | The filter data object. | &nbsp; |
+| datasetsInfo |  | Collection of datasets information | &nbsp; |
 
 
 
@@ -464,13 +503,13 @@ Gets an scope structure for the filter data
 ##### Returns
 
 
--  an scope structure
+-  a UI Filters structure
 
 
 
-#### buildDataset(uFilter) 
+#### FD21ToUI(scopes, section, version, datasetsInfo) 
 
-Gets an dataset structure for the filter data
+Generates a UI filter Structure from the Filter Data structure v2.1
 
 
 
@@ -479,7 +518,10 @@ Gets an dataset structure for the filter data
 
 | Name | Type | Description |  |
 | ---- | ---- | ----------- | -------- |
-| uFilter |  | a UI structure filter | &nbsp; |
+| scopes |  | The filter scope section | &nbsp; |
+| section |  | The filter section. | &nbsp; |
+| version |  | The version of the filter structure | &nbsp; |
+| datasetsInfo |  | Collection of datasets information | &nbsp; |
 
 
 
@@ -487,18 +529,247 @@ Gets an dataset structure for the filter data
 ##### Returns
 
 
--  an dataset structure
+-  a UI filter Structure
 
 
 
-#### buildFilter(uFilter) 
 
-Gets an filter structure for the filter data
+### dist/filters/adapters/UIToFD.js
 
 
+#### UIToFD(filterData) 
 
+Generates a Filter Data Structure structure from UI Filter Data structure.
 
-##### Parameters
+
+
+
+##### Parameters
+
+| Name | Type | Description |  |
+| ---- | ---- | ----------- | -------- |
+| filterData |  | The UI filter data object. | &nbsp; |
+
+
+
+
+##### Returns
+
+
+-  a Filter Data structure
+
+
+
+#### UI21ToFD(uFilterData, version) 
+
+Builds the Fitler Data structure from UI filter data
+
+
+
+
+##### Parameters
+
+| Name | Type | Description |  |
+| ---- | ---- | ----------- | -------- |
+| uFilterData |  | The UI filter Data object | &nbsp; |
+| version |  | the version of the structure | &nbsp; |
+
+
+
+
+##### Returns
+
+
+-  
+
+
+
+
+### dist/filters/adapters/UIToFlatUI.js
+
+
+#### UIToFlatUI(filterData, datasetsInfo) 
+
+Generates a Flattened UI filter structure from UI Filter Data structure.
+
+
+
+
+##### Parameters
+
+| Name | Type | Description |  |
+| ---- | ---- | ----------- | -------- |
+| filterData |  | The UI filter data object. | &nbsp; |
+| datasetsInfo |  | Collection of datasets information. Optional for updating the datasets info | &nbsp; |
+
+
+
+
+##### Returns
+
+
+-  a flattened UI filters array
+
+
+
+#### UI21ToFlatUI(scopes) 
+
+Generates a Flattened UI Filter Structure from the UI Filter Data structure v2.1
+
+
+
+
+##### Parameters
+
+| Name | Type | Description |  |
+| ---- | ---- | ----------- | -------- |
+| scopes |  | The filter scope section | &nbsp; |
+
+
+
+
+##### Returns
+
+
+-  a flattened UI filters array
+
+
+
+
+### 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 | &nbsp; |
+| getUIFilterData |  | Flag to get a Filter Data (False) or the UI Filter Data (True) | &nbsp; |
+| datasetsInfo |  | Collection of datasets information. If getUIFilterData is true, the datasetsInfo should be mandatory | &nbsp; |
+
+
+
+
+##### Returns
+
+
+-  A new filter data structure v2.1
+
+
+
+
+### dist/filters/adapters/flatUIToFD.js
+
+
+#### flatUIToFD(uFilters, version) 
+
+Generates a filter data structure from the flatttened UI filters.
+
+
+
+
+##### Parameters
+
+| Name | Type | Description |  |
+| ---- | ---- | ----------- | -------- |
+| uFilters |  | Array of flattened filters from UI | &nbsp; |
+| version |  | Tag for the version of the filter data structure | &nbsp; |
+
+
+
+
+##### Returns
+
+
+-  a Filter Data.
+
+
+
+#### buildScopes(fbFilters) 
+
+Gets an array of scopes structure for the filter data. The scopes is organized by scope types and scope IDs
+Also, adds and organizes filters by datasets
+
+
+
+
+##### Parameters
+
+| Name | Type | Description |  |
+| ---- | ---- | ----------- | -------- |
+| fbFilters |  | Array of flat filters from UI | &nbsp; |
+
+
+
+
+##### Returns
+
+
+-  an array of scopes structure.
+
+
+
+#### buildScope(uFilter) 
+
+Gets an scope structure for the filter data
+
+
+
+
+##### Parameters
+
+| Name | Type | Description |  |
+| ---- | ---- | ----------- | -------- |
+| uFilter |  | UI structure filter | &nbsp; |
+
+
+
+
+##### Returns
+
+
+-  an scope structure
+
+
+
+#### buildDataset(uFilter) 
+
+Gets an dataset structure for the filter data
+
+
+
+
+##### Parameters
+
+| Name | Type | Description |  |
+| ---- | ---- | ----------- | -------- |
+| uFilter |  | a UI structure filter | &nbsp; |
+
+
+
+
+##### Returns
+
+
+-  an dataset structure
+
+
+
+#### buildFilter(uFilter) 
+
+Gets an filter structure for the filter data
+
+
+
+
+##### Parameters
 
 | Name | Type | Description |  |
 | ---- | ---- | ----------- | -------- |
@@ -1096,12 +1367,12 @@ Flat deeply an array
 
 
 
-### dist/general/array/getFirstIndexFromArray.js
+### dist/general/array/getLastIndexFromArray.js
 
 
-#### getFirstIndexFromArray(array, callback) 
+#### getLastIndexFromArray(array, callback) 
 
-Gets the first index from the array by a callback condition
+Gets the last index from the array by a callback condition
 
 
 
@@ -1119,17 +1390,17 @@ 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
+-  the last index of the array. -1 when the condition is not satisfied
 
 
 
 
-### dist/general/array/getLastIndexFromArray.js
+### dist/general/array/getFirstIndexFromArray.js
 
 
-#### getLastIndexFromArray(array, callback) 
+#### getFirstIndexFromArray(array, callback) 
 
-Gets the last index from the array by a callback condition
+Gets the first index from the array by a callback condition
 
 
 
@@ -1147,7 +1418,7 @@ 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
+-  the first index of the array. -1 when the condition is not satisfied
 
 
 
@@ -1321,13 +1592,12 @@ Validates if the given argument is empty
 
 
 
-### dist/general/mix/isNull.js
+### dist/general/mix/randomId.js
 
 
-#### isNull(arg) 
+#### randomId(length) 
 
-return if a given variable is either `null` or `undefined`
-useful to avoid falsify validating Number Zero (0)
+create random unique string
 
 
 
@@ -1336,7 +1606,7 @@ useful to avoid falsify validating Number Zero (0)
 
 | Name | Type | Description |  |
 | ---- | ---- | ----------- | -------- |
-| arg | `any`  |  | &nbsp; |
+| length | `Number`  | size of the generated string. Default 8 | &nbsp; |
 
 
 
@@ -1344,19 +1614,18 @@ useful to avoid falsify validating Number Zero (0)
 ##### Returns
 
 
-- `Boolean`  
+- `String`  
 
 
 
 
-### dist/general/mix/size.js
+### dist/general/mix/isNull.js
 
 
-#### size(obj) 
+#### isNull(arg) 
 
-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.
+return if a given variable is either `null` or `undefined`
+useful to avoid falsify validating Number Zero (0)
 
 
 
@@ -1365,7 +1634,7 @@ For `null` or `undefined` argument the returned value will be 0.
 
 | Name | Type | Description |  |
 | ---- | ---- | ----------- | -------- |
-| obj | `Any`  |  | &nbsp; |
+| arg | `any`  |  | &nbsp; |
 
 
 
@@ -1373,17 +1642,19 @@ For `null` or `undefined` argument the returned value will be 0.
 ##### Returns
 
 
-- `Number`  
+- `Boolean`  
 
 
 
 
-### dist/general/mix/randomId.js
+### dist/general/mix/size.js
 
 
-#### randomId(length) 
+#### size(obj) 
 
-create random unique string
+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.
 
 
 
@@ -1392,7 +1663,7 @@ create random unique string
 
 | Name | Type | Description |  |
 | ---- | ---- | ----------- | -------- |
-| length | `Number`  | size of the generated string. Default 8 | &nbsp; |
+| obj | `Any`  |  | &nbsp; |
 
 
 
@@ -1400,17 +1671,18 @@ create random unique string
 ##### Returns
 
 
-- `String`  
+- `Number`  
 
 
 
 
-### dist/general/string/capitalize.js
+### dist/general/object/cloneDeep.js
 
 
-#### capitalize(text) 
+#### cloneDeep(obj) 
 
-Upper case teh first letter of a given text
+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
 
 
 
@@ -1419,7 +1691,7 @@ Upper case teh first letter of a given text
 
 | Name | Type | Description |  |
 | ---- | ---- | ----------- | -------- |
-| text | `String`  |  | &nbsp; |
+| obj |  | The object | &nbsp; |
 
 
 
@@ -1427,7 +1699,7 @@ Upper case teh first letter of a given text
 ##### Returns
 
 
-- `String`  
+-  The new reference object or the given object if the parsing is incorrect or empty
 
 
 
@@ -1489,34 +1761,6 @@ _get({ item1: { item11: 'Hello Again' }, item2: {} }, ['item1', 'item11'])
 
 
 
-### dist/general/object/cloneDeep.js
-
-
-#### cloneDeep(obj) 
-
-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
-
-
-
-
-##### Parameters
-
-| Name | Type | Description |  |
-| ---- | ---- | ----------- | -------- |
-| obj |  | The object | &nbsp; |
-
-
-
-
-##### Returns
-
-
--  The new reference object or the given object if the parsing is incorrect or empty
-
-
-
-
 ### dist/general/object/getAttribute.js
 
 
@@ -1620,13 +1864,12 @@ Checks if the given argument is an object type
 
 
 
-### dist/general/object/mapValues.js
+### dist/general/object/omit.js
 
 
-#### mapValues(baseObject, iteratee) 
+#### omit(obj, props) 
 
-Invoke iteratee (function) for each object key-value pair
-and return a mapped object
+return a nwe Object excluding attributes in _props_ list
 
 
 
@@ -1635,8 +1878,8 @@ and return a mapped object
 
 | Name | Type | Description |  |
 | ---- | ---- | ----------- | -------- |
-| baseObject | `Object`  | Base object. | &nbsp; |
-| iteratee | `Function`  | The executed per iteration. | &nbsp; |
+| obj | `Object`  | base object | &nbsp; |
+| props | `Array.<String>`  | list of attribute to exclude | &nbsp; |
 
 
 
@@ -1644,17 +1887,18 @@ and return a mapped object
 ##### Returns
 
 
-- `Object`  New mapped object.
+- `Object`  clean object
 
 
 
 
-### dist/general/object/omit.js
+### dist/general/object/mapValues.js
 
 
-#### omit(obj, props) 
+#### mapValues(baseObject, iteratee) 
 
-return a nwe Object excluding attributes in _props_ list
+Invoke iteratee (function) for each object key-value pair
+and return a mapped object
 
 
 
@@ -1663,8 +1907,8 @@ 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; |
+| baseObject | `Object`  | Base object. | &nbsp; |
+| iteratee | `Function`  | The executed per iteration. | &nbsp; |
 
 
 
@@ -1672,7 +1916,7 @@ return a nwe Object excluding attributes in _props_ list
 ##### Returns
 
 
-- `Object`  clean object
+- `Object`  New mapped object.
 
 
 
@@ -1705,12 +1949,12 @@ return a new object just with attributes in _keys_ list
 
 
 
-### dist/date/range/getDateRange.js
+### dist/general/string/capitalize.js
 
 
-#### getDateRange(value, dateGroupLabel, withTime) 
+#### capitalize(text) 
 
-Get date range object from a string date value
+Upper case teh first letter of a given text
 
 
 
@@ -1719,122 +1963,7 @@ 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'
-}
-
-// 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/date/relative/Adapter.js
-
-
-#### value() 
-
-Resolves statement and returns statement value
-
-
-
-
-
-
-##### Returns
-
-
-- `AbsoluteRange` `string`  
-
-
-
-#### valueAsAnchor() 
-
-Resolves statement as an anchor
-
-
-
-
-
-
-##### Returns
-
-
-- `string`  
-
-
-
-#### _statementToRange()  *private method*
-
-Convert verbal statement to range value
-
-
-
-
-
-
-##### Returns
-
-
-- `AbsoluteRange`  
-
-
-
-#### _resolveAsThis()  *private method*
-
-Apply 'this' cursor logic to statement
-
-
-
-
-
-
-##### Returns
-
-
-- `AbsoluteStatement`  
-
-
-
-#### _resolveAsTheLast()  *private method*
-
-Apply 'the last' cursor logic to statement
-
-
+| text | `String`  |  | &nbsp; |
 
 
 
@@ -1842,163 +1971,112 @@ Apply 'the last' cursor logic to statement
 ##### Returns
 
 
-- `AbsoluteStatement`  
-
-
-
-#### _resolveAsTheNext()  *private method*
-
-Apply 'the next' cursor logic to statement
-
-
-
-
+- `String`  
 
 
-##### Returns
 
 
-- `AbsoluteStatement`  
+### dist/stencil/decorators/Config.js
 
 
+#### Config() 
 
-#### replaceNowToken(value, now) 
+Stencil.js - Prop Decorator
+Get and Parse the Widget Configuration Object and also provide the ability to get 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
 
-Replace '@now' token inside a string
 
 
 
 
-##### Parameters
 
-| Name | Type | Description |  |
-| ---- | ---- | ----------- | -------- |
-| value | `string`  |  | &nbsp; |
-| now | `Date`  |  | &nbsp; |
+##### Examples
 
+```javascript
+\ @Config() @Prop() settings;
 
+someMethod() {
+ this.settings.snake_case //it search for: obj.snake_case || obj.snakeCase || obj.SnakeCase || obj.snakecase || obj.SNAKECASE
+}
+```
 
 
 ##### Returns
 
 
-- `string`  
-
-
-
-#### convertRelativeToAbsolute(args) 
+- `Void`
 
-Returns a range object (date) from a group of statement params
 
 
 
+### dist/stencil/util/createRef.js
 
-##### Parameters
 
-| Name | Type | Description |  |
-| ---- | ---- | ----------- | -------- |
-| args | `RelativeToAbsoluteStruct`  |  | &nbsp; |
+#### createRef() 
 
+lit implementation of React createRef (https://reactjs.org/docs/refs-and-the-dom.html)
 
 
 
-##### 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`  
-
-
+-  function - Function to use in ref prop in html elements
 
 
-### dist/date/relative/relative.js
 
 
-#### resolveRelative(statements, clock) 
-
-Resolve a list of relative statements according to operator
-
+### dist/stencil/util/getConfig.js
 
 
+#### getConfig(cfg) 
 
-##### Parameters
+verify the Config object type and try to return a parsed Object
+- In case _cfg_ is a string, first try to make a JSON parse in other case
+try to find this string as a variable on Windows object
+- If _cfg_ is a fuction, tis is invoked and parsed
+- Finally, if is an object, _cfg_ is inmediatly returned
 
-| Name | Type | Description |  |
-| ---- | ---- | ----------- | -------- |
-| statements | `Array.<RelativeStatement>` `Array.<string>`  | - Raw statements/values | &nbsp; |
-| clock | `Date`  | - Clock/time reference for relative date resolution | &nbsp; |
 
 
 
+##### Parameters
 
-##### Examples
+| Name | Type | Description |  |
+| ---- | ---- | ----------- | -------- |
+| cfg |  |  | &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;`  
-
+- `Void`
 
 
 
-### dist/stencil/decorators/Config.js
 
+### dist/typescript/decorators/Throttled.js
 
-#### Config() 
 
-Stencil.js - Prop Decorator
-Get and Parse the Widget Configuration Object and also provide the ability to get 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
+#### Throttled(time) 
 
+(Method Decorator) Throttled Class Method
 
 
 
 
+##### Parameters
 
-##### Examples
+| Name | Type | Description |  |
+| ---- | ---- | ----------- | -------- |
+| time |  | (optional) deafult 500 | &nbsp; |
 
-```javascript
-\ @Config() @Prop() settings;
 
-someMethod() {
- this.settings.snake_case //it search for: obj.snake_case || obj.snakeCase || obj.SnakeCase || obj.snakecase || obj.SNAKECASE
-}
-```
 
 
 ##### Returns
@@ -2009,16 +2087,12 @@ someMethod() {
 
 
 
-### dist/stencil/util/getConfig.js
+### dist/typescript/decorators/Debounce.js
 
 
-#### getConfig(cfg) 
+#### Debounce(time) 
 
-verify the Config object type and try to return a parsed Object
-- In case _cfg_ is a string, first try to make a JSON parse in other case
-try to find this string as a variable on Windows object
-- If _cfg_ is a fuction, tis is invoked and parsed
-- Finally, if is an object, _cfg_ is inmediatly returned
+(Method Decorator) Debounce Class Method
 
 
 
@@ -2027,7 +2101,7 @@ try to find this string as a variable on Windows object
 
 | Name | Type | Description |  |
 | ---- | ---- | ----------- | -------- |
-| cfg |  |  | &nbsp; |
+| time |  | (optional) deafult 500 | &nbsp; |
 
 
 
@@ -2040,14 +2114,21 @@ try to find this string as a variable on Windows object
 
 
 
-### dist/stencil/util/createRef.js
+### dist/date/relative/helpers/formatStatement.js
 
 
-#### createRef() 
+#### formatStatement(statement) 
+
+Build a proper relative date statement type
+
 
-lit implementation of React createRef (https://reactjs.org/docs/refs-and-the-dom.html)
 
 
+##### Parameters
+
+| Name | Type | Description |  |
+| ---- | ---- | ----------- | -------- |
+| statement | `RelativeStatement`  |  | &nbsp; |
 
 
 
@@ -2055,17 +2136,17 @@ lit implementation of React createRef (https://reactjs.org/docs/refs-and-the-dom
 ##### Returns
 
 
--  function - Function to use in ref prop in html elements
+- `RelativeStatement`  
 
 
 
 
-### dist/typescript/decorators/Debounce.js
+### dist/date/relative/helpers/getStatementCase.js
 
 
-#### Debounce(time) 
+#### getStatementCase(includeCurrent, isCalendarDate) 
 
-(Method Decorator) Debounce Class Method
+Returns a number/constant that identifies a relative date case
 
 
 
@@ -2074,7 +2155,8 @@ lit implementation of React createRef (https://reactjs.org/docs/refs-and-the-dom
 
 | Name | Type | Description |  |
 | ---- | ---- | ----------- | -------- |
-| time |  | (optional) deafult 500 | &nbsp; |
+| includeCurrent | `boolean`  |  | &nbsp; |
+| isCalendarDate | `boolean`  |  | &nbsp; |
 
 
 
@@ -2082,17 +2164,17 @@ lit implementation of React createRef (https://reactjs.org/docs/refs-and-the-dom
 ##### Returns
 
 
-- `Void`
+- `number`  
 
 
 
 
-### dist/typescript/decorators/Throttled.js
+### dist/date/relative/helpers/parseDate.js
 
 
-#### Throttled(time) 
+#### parseDate(date) 
 
-(Method Decorator) Throttled Class Method
+Parses a string date and returns a dayjs date
 
 
 
@@ -2101,7 +2183,7 @@ lit implementation of React createRef (https://reactjs.org/docs/refs-and-the-dom
 
 | Name | Type | Description |  |
 | ---- | ---- | ----------- | -------- |
-| time |  | (optional) deafult 500 | &nbsp; |
+| date | `string` `Dayjs` `Date`  |  | &nbsp; |
 
 
 
@@ -2109,7 +2191,7 @@ lit implementation of React createRef (https://reactjs.org/docs/refs-and-the-dom
 ##### Returns
 
 
-- `Void`
+- `Dayjs`  A dayjs date
 
 
 
@@ -2437,12 +2519,12 @@ Returns a filter builder config object by a any given config
 
 
 
-### dist/filters/helpers/common/arePropertiesDateP.js
+### dist/filters/helpers/common/areFiltersEquals.js
 
 
-#### arePropertiesDateP(column, property) 
+#### areFiltersEquals(filter1, filter2) 
 
-Determines if the filter column and property is a distinct group dates type
+Validates if both filters are the same
 
 
 
@@ -2451,8 +2533,8 @@ Determines if the filter column and property is a distinct group dates type
 
 | Name | Type | Description |  |
 | ---- | ---- | ----------- | -------- |
-| column |  | The filter column | &nbsp; |
-| property |  | The filter property | &nbsp; |
+| filter1 |  | filter 1 | &nbsp; |
+| filter2 |  | filter 2 | &nbsp; |
 
 
 
@@ -2460,17 +2542,17 @@ Determines if the filter column and property is a distinct group dates type
 ##### Returns
 
 
--  True if the given property is included from distinct group dates type
+-  true: the filters are equal; false: the filters are NOT equal
 
 
 
 
-### dist/filters/helpers/common/areFiltersEquals.js
+### dist/filters/helpers/common/arePropertiesDateP.js
 
 
-#### areFiltersEquals(filter1, filter2) 
+#### arePropertiesDateP(column, property) 
 
-Validates if both filters are the same
+Determines if the filter column and property is a distinct group dates type
 
 
 
@@ -2479,8 +2561,8 @@ Validates if both filters are the same
 
 | Name | Type | Description |  |
 | ---- | ---- | ----------- | -------- |
-| filter1 |  | filter 1 | &nbsp; |
-| filter2 |  | filter 2 | &nbsp; |
+| column |  | The filter column | &nbsp; |
+| property |  | The filter property | &nbsp; |
 
 
 
@@ -2488,7 +2570,7 @@ Validates if both filters are the same
 ##### Returns
 
 
--  true: the filters are equal; false: the filters are NOT equal
+-  True if the given property is included from distinct group dates type
 
 
 
@@ -2585,12 +2667,12 @@ Excludes and returns a filter data without filters by the given scopes
 
 
 
-### dist/filters/helpers/common/getFilterColumnLabel.js
+### dist/filters/helpers/common/getFilterLabel.js
 
 
-#### getFilterColumnLabel(column) 
+#### getFilterLabel(filter) 
 
-Get an string of the properties of the given filter column.
+Gets the Filter Label + Column label
 
 
 
@@ -2599,7 +2681,7 @@ Get an string of the properties of the given filter column.
 
 | Name | Type | Description |  |
 | ---- | ---- | ----------- | -------- |
-| column |  | The filter column | &nbsp; |
+| filter |  | the UI filter | &nbsp; |
 
 
 
@@ -2607,17 +2689,17 @@ Get an string of the properties of the given filter column.
 ##### Returns
 
 
--  an string with the property, aggregate or calculation label.
+-  a sring label
 
 
 
 
-### dist/filters/helpers/common/getFilterLabel.js
+### dist/filters/helpers/common/getFilterColumnLabel.js
 
 
-#### getFilterLabel(filter) 
+#### getFilterColumnLabel(column) 
 
-Gets the Filter Label + Column label
+Get an string of the properties of the given filter column.
 
 
 
@@ -2626,7 +2708,7 @@ Gets the Filter Label + Column label
 
 | Name | Type | Description |  |
 | ---- | ---- | ----------- | -------- |
-| filter |  | the UI filter | &nbsp; |
+| column |  | The filter column | &nbsp; |
 
 
 
@@ -2634,7 +2716,7 @@ Gets the Filter Label + Column label
 ##### Returns
 
 
--  a sring label
+-  an string with the property, aggregate or calculation label.
 
 
 
@@ -2769,12 +2851,12 @@ Filters and gets a Filter Data by the given scopes
 
 
 
-### dist/filters/helpers/common/getFiltersByScopesIds.js
+### dist/filters/helpers/common/getFiltersByVisibility.js
 
 
-#### getFiltersByScopesIds(filterData, scopes) 
+#### getFiltersByVisibility(filterData, scopes) 
 
-Gets filters from Filter Data by Scopes/Scope IDs.
+Get a new Filter Data by filtering scopes/scope IDs and enabled flags
 
 
 
@@ -2783,8 +2865,8 @@ Gets filters from Filter Data by Scopes/Scope IDs.
 
 | Name | Type | Description |  |
 | ---- | ---- | ----------- | -------- |
-| filterData |  | The filter data | &nbsp; |
-| scopes |  | The collection of Scopes/Scope IDs | &nbsp; |
+| filterData |  | a Filter Data or UI Filter Data | &nbsp; |
+| scopes |  | a Scopes/Scope IDs array | &nbsp; |
 
 
 
@@ -2824,12 +2906,12 @@ Transforms the given MergeFilters settings object. Adds the missing properties i
 
 
 
-### dist/filters/helpers/common/getFiltersByVisibility.js
+### dist/filters/helpers/common/getFiltersByScopesIds.js
 
 
-#### getFiltersByVisibility(filterData, scopes) 
+#### getFiltersByScopesIds(filterData, scopes) 
 
-Get a new Filter Data by filtering scopes/scope IDs and enabled flags
+Gets filters from Filter Data by Scopes/Scope IDs.
 
 
 
@@ -2838,8 +2920,8 @@ 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; |
+| filterData |  | The filter data | &nbsp; |
+| scopes |  | The collection of Scopes/Scope IDs | &nbsp; |
 
 
 
@@ -3261,12 +3343,12 @@ Resolves the conditions by given params
 
 
 
-### dist/filters/helpers/ui/excludeUIFiltersByAggregate.js
+### dist/filters/helpers/ui/excludeUIFlatFiltersByScopes.js
 
 
-#### excludeUIFiltersByAggregate(uFilters) 
+#### excludeUIFlatFiltersByScopes(uFilters, scopes) 
 
-Excludes Aggregate Filters in the Flattened UI Filters array
+Excludes and returns a UI Flat Filters without filters by the given scopes
 
 
 
@@ -3275,7 +3357,8 @@ Excludes Aggregate Filters in the Flattened UI Filters array
 
 | Name | Type | Description |  |
 | ---- | ---- | ----------- | -------- |
-| uFilters |  | Collection of Flat UI Filters | &nbsp; |
+| uFilters |  | The Flatten UI Filters | &nbsp; |
+| scopes |  | collection of scopes types | &nbsp; |
 
 
 
@@ -3283,17 +3366,17 @@ Excludes Aggregate Filters in the Flattened UI Filters array
 ##### Returns
 
 
--  a new Flat UI Filters that were excluded the aggregate filters
+-  The new array of UI Flattened filters
 
 
 
 
-### dist/filters/helpers/ui/excludeUIFlatFiltersByScopes.js
+### dist/filters/helpers/ui/excludeUIFiltersByAggregate.js
 
 
-#### excludeUIFlatFiltersByScopes(uFilters, scopes) 
+#### excludeUIFiltersByAggregate(uFilters) 
 
-Excludes and returns a UI Flat Filters without filters by the given scopes
+Excludes Aggregate Filters in the Flattened UI Filters array
 
 
 
@@ -3302,8 +3385,7 @@ Excludes and returns a UI Flat Filters without filters by the given scopes
 
 | Name | Type | Description |  |
 | ---- | ---- | ----------- | -------- |
-| uFilters |  | The Flatten UI Filters | &nbsp; |
-| scopes |  | collection of scopes types | &nbsp; |
+| uFilters |  | Collection of Flat UI Filters | &nbsp; |
 
 
 
@@ -3311,7 +3393,7 @@ Excludes and returns a UI Flat Filters without filters by the given scopes
 ##### Returns
 
 
--  The new array of UI Flattened filters
+-  a new Flat UI Filters that were excluded the aggregate filters
 
 
 
@@ -3457,86 +3539,4 @@ Resolves conditions between UI flattened filter and given parameters
 
 
 
-### dist/date/relative/helpers/formatStatement.js
-
-
-#### formatStatement(statement) 
-
-Build a proper relative date statement type
-
-
-
-
-##### Parameters
-
-| Name | Type | Description |  |
-| ---- | ---- | ----------- | -------- |
-| statement | `RelativeStatement`  |  | &nbsp; |
-
-
-
-
-##### Returns
-
-
-- `RelativeStatement`  
-
-
-
-
-### dist/date/relative/helpers/getStatementCase.js
-
-
-#### getStatementCase(includeCurrent, isCalendarDate) 
-
-Returns a number/constant that identifies a relative date case
-
-
-
-
-##### Parameters
-
-| Name | Type | Description |  |
-| ---- | ---- | ----------- | -------- |
-| includeCurrent | `boolean`  |  | &nbsp; |
-| isCalendarDate | `boolean`  |  | &nbsp; |
-
-
-
-
-##### Returns
-
-
-- `number`  
-
-
-
-
-### dist/date/relative/helpers/parseDate.js
-
-
-#### parseDate(date) 
-
-Parses a string date and returns a dayjs date
-
-
-
-
-##### Parameters
-
-| Name | Type | Description |  |
-| ---- | ---- | ----------- | -------- |
-| date | `string` `Dayjs` `Date`  |  | &nbsp; |
-
-
-
-
-##### Returns
-
-
-- `Dayjs`  A dayjs date
-
-
-
-
 *Documentation generated with [doxdox](https://github.com/neogeek/doxdox).*