si-funciona 1.2.0 → 2.0.1

package/dist/helpers/numbers/absoluteMin.d.ts

@@ -0,0 +1,11 @@
+import 'core-js/stable';
+/**
+ * Helper for returning the absolute min value
+ * @function
+ * @memberOf module:numberHelpers
+ * @param {number} num1 - A number to compare
+ * @param {number} num2 - Another number to be compared against
+ * @returns {number}
+ */
+declare const absoluteMin: (num1: number, num2: number) => number;
+export default absoluteMin;

package/dist/helpers/numbers/absoluteMin.js

@@ -5,13 +5,13 @@ Object.defineProperty(exports, '__esModule', {
 })
 exports.default = void 0
 require('core-js/stable')
-/**
- * Helper for returning the absolute min value
- * @function
- * @memberOf module:numberHelpers
- * @param {number} num1 - A number to compare
- * @param {number} num2 - Another number to be compared against
- * @returns {number}
+/**
+ * Helper for returning the absolute min value
+ * @function
+ * @memberOf module:numberHelpers
+ * @param {number} num1 - A number to compare
+ * @param {number} num2 - Another number to be compared against
+ * @returns {number}
  */
 const absoluteMin = (num1, num2) => Math.abs(num1) < Math.abs(num2) ? num1 : num2
 var _default = absoluteMin

package/dist/helpers/numbers/compare.d.ts

@@ -0,0 +1,14 @@
+import 'core-js/stable';
+/**
+ * Compare two numbers and return:
+ * -1 to indicate val1 is less than val2
+ * 0 to indicate both values are the equal
+ * 1 to indicate val1 is greater than val2
+ * @function
+ * @memberOf module:numberHelpers
+ * @param {number} val1 - The first number to compare
+ * @param {number} val2 - The second number to compare
+ * @returns {number}
+ */
+declare const compare: (val1: number, val2: number) => number;
+export default compare;

package/dist/helpers/numbers/compare.js

@@ -5,16 +5,16 @@ Object.defineProperty(exports, '__esModule', {
 })
 exports.default = void 0
 require('core-js/stable')
-/**
- * Compare two numbers and return:
- * -1 to indicate val1 is less than val2
- * 0 to indicate both values are the equal
- * 1 to indicate val1 is greater than val2
- * @function
- * @memberOf module:numberHelpers
- * @param {number} val1 - The first number to compare
- * @param {number} val2 - The second number to compare
- * @returns {number}
+/**
+ * Compare two numbers and return:
+ * -1 to indicate val1 is less than val2
+ * 0 to indicate both values are the equal
+ * 1 to indicate val1 is greater than val2
+ * @function
+ * @memberOf module:numberHelpers
+ * @param {number} val1 - The first number to compare
+ * @param {number} val2 - The second number to compare
+ * @returns {number}
  */
 const compare = (val1, val2) => val1 === val2 ? 0 : val1 > val2 ? 1 : -1
 var _default = compare

package/dist/helpers/numbers/randomInteger.d.ts

@@ -0,0 +1,14 @@
+import 'core-js/stable';
+/**
+ * Create a single random integer within provide range. And with optional offset,
+ * The distance between the result numbers can be adjusted with interval.
+ * @function
+ * @memberOf module:numberHelpers
+ * @param {number} range - Choose the breadth of the random number (0-100 would be 100 for range)
+ * @param {number} [offset=0] - Choose the starting number (1-10 would be 1 for offset, 9 for range)
+ * @param {number} [interval=1] - Choose the distance between numbers (5, 10, 15 would be 5 for interval, 1 for
+ * offset, 2 for range)
+ * @returns {number}
+ */
+declare const randomInteger: (range: number, offset?: number, interval?: number) => number;
+export default randomInteger;

package/dist/helpers/numbers/randomInteger.js

@@ -5,16 +5,16 @@ Object.defineProperty(exports, '__esModule', {
 })
 exports.default = void 0
 require('core-js/stable')
-/**
- * Create a single random integer within provide range. And with optional offset,
- * The distance between the result numbers can be adjusted with interval.
- * @function
- * @memberOf module:numberHelpers
- * @param {number} range - Choose the breadth of the random number (0-100 would be 100 for range)
- * @param {number} [offset=0] - Choose the starting number (1-10 would be 1 for offset, 9 for range)
- * @param {number} [interval=1] - Choose the distance between numbers (5, 10, 15 would be 5 for interval, 1 for
- * offset, 2 for range)
- * @returns {number}
+/**
+ * Create a single random integer within provide range. And with optional offset,
+ * The distance between the result numbers can be adjusted with interval.
+ * @function
+ * @memberOf module:numberHelpers
+ * @param {number} range - Choose the breadth of the random number (0-100 would be 100 for range)
+ * @param {number} [offset=0] - Choose the starting number (1-10 would be 1 for offset, 9 for range)
+ * @param {number} [interval=1] - Choose the distance between numbers (5, 10, 15 would be 5 for interval, 1 for
+ * offset, 2 for range)
+ * @returns {number}
  */
 const randomInteger = function (range) {
   const offset = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : 0

package/dist/helpers/numbers/randomNumber.d.ts

@@ -0,0 +1,14 @@
+import 'core-js/stable';
+/**
+ * Create a single random number within provided range. And with optional offset,
+ * The distance between the result numbers can be adjusted with interval.
+ * @function
+ * @memberOf module:numberHelpers
+ * @param {number} range - Choose the breadth of the random number (0-100 would be 100 for range)
+ * @param {number} [offset=0] - Choose the starting number (1-10 would be 1 for offset, 9 for range)
+ * @param {number} [interval=1] - Choose the distance between numbers (~5, ~10, ~15 would be 5 for interval, 1 for
+ * offset, 2 for range)
+ * @returns {number}
+ */
+declare const randomNumber: (range: number, offset?: number, interval?: number) => number;
+export default randomNumber;

package/dist/helpers/numbers/randomNumber.js

@@ -5,16 +5,16 @@ Object.defineProperty(exports, '__esModule', {
 })
 exports.default = void 0
 require('core-js/stable')
-/**
- * Create a single random number within provided range. And with optional offset,
- * The distance between the result numbers can be adjusted with interval.
- * @function
- * @memberOf module:numberHelpers
- * @param {number} range - Choose the breadth of the random number (0-100 would be 100 for range)
- * @param {number} [offset=0] - Choose the starting number (1-10 would be 1 for offset, 9 for range)
- * @param {number} [interval=1] - Choose the distance between numbers (~5, ~10, ~15 would be 5 for interval, 1 for
- * offset, 2 for range)
- * @returns {number}
+/**
+ * Create a single random number within provided range. And with optional offset,
+ * The distance between the result numbers can be adjusted with interval.
+ * @function
+ * @memberOf module:numberHelpers
+ * @param {number} range - Choose the breadth of the random number (0-100 would be 100 for range)
+ * @param {number} [offset=0] - Choose the starting number (1-10 would be 1 for offset, 9 for range)
+ * @param {number} [interval=1] - Choose the distance between numbers (~5, ~10, ~15 would be 5 for interval, 1 for
+ * offset, 2 for range)
+ * @returns {number}
  */
 const randomNumber = function (range) {
   const offset = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : 0

package/dist/helpers/numbers.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Some number comparators and random number generators.
+ * @file
+ * @author Joshua Heagle <joshuaheagle@gmail.com>
+ * @version 1.0.0
+ * @module numberHelpers
+ * @memberOf module:siFunciona
+ */
+import 'core-js/stable';
+declare const _default: {
+    absoluteMax: (num1: number, num2: number) => number;
+    absoluteMin: (num1: number, num2: number) => number;
+    compare: (val1: number, val2: number) => number;
+    randomInteger: (range: number, offset?: number, interval?: number) => number;
+    randomNumber: (range: number, offset?: number, interval?: number) => number;
+};
+export default _default;

package/dist/helpers/numbers.js

@@ -5,19 +5,19 @@ Object.defineProperty(exports, '__esModule', {
 })
 exports.default = void 0
 require('core-js/stable')
-var _absoluteMax = _interopRequireDefault(require('./numbers/absoluteMax.js'))
-var _absoluteMin = _interopRequireDefault(require('./numbers/absoluteMin.js'))
-var _compare = _interopRequireDefault(require('./numbers/compare.js'))
-var _randomInteger = _interopRequireDefault(require('./numbers/randomInteger.js'))
-var _randomNumber = _interopRequireDefault(require('./numbers/randomNumber.js'))
+var _absoluteMax = _interopRequireDefault(require('./numbers/absoluteMax'))
+var _absoluteMin = _interopRequireDefault(require('./numbers/absoluteMin'))
+var _compare = _interopRequireDefault(require('./numbers/compare'))
+var _randomInteger = _interopRequireDefault(require('./numbers/randomInteger'))
+var _randomNumber = _interopRequireDefault(require('./numbers/randomNumber'))
 function _interopRequireDefault (obj) { return obj && obj.__esModule ? obj : { default: obj } }
-/**
- * Some number comparators and random number generators.
- * @file
- * @author Joshua Heagle <joshuaheagle@gmail.com>
- * @version 1.0.0
- * @module numberHelpers
- * @memberOf module:siFunciona
+/**
+ * Some number comparators and random number generators.
+ * @file
+ * @author Joshua Heagle <joshuaheagle@gmail.com>
+ * @version 1.0.0
+ * @module numberHelpers
+ * @memberOf module:siFunciona
  */
 var _default = {
   absoluteMax: _absoluteMax.default,

package/dist/helpers/numbers.min.js

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:!0}),exports.default=void 0,require("core-js/stable");var _absoluteMax=_interopRequireDefault(require("./numbers/absoluteMax.js")),_absoluteMin=_interopRequireDefault(require("./numbers/absoluteMin.js")),_compare=_interopRequireDefault(require("./numbers/compare.js")),_randomInteger=_interopRequireDefault(require("./numbers/randomInteger.js")),_randomNumber=_interopRequireDefault(require("./numbers/randomNumber.js"));function _interopRequireDefault(e){return e&&e.__esModule?e:{default:e}}var _default={absoluteMax:_absoluteMax.default,absoluteMin:_absoluteMin.default,compare:_compare.default,randomInteger:_randomInteger.default,randomNumber:_randomNumber.default};exports.default=_default;
+"use strict";Object.defineProperty(exports,"__esModule",{value:!0}),exports.default=void 0,require("core-js/stable");var _absoluteMax=_interopRequireDefault(require("./numbers/absoluteMax")),_absoluteMin=_interopRequireDefault(require("./numbers/absoluteMin")),_compare=_interopRequireDefault(require("./numbers/compare")),_randomInteger=_interopRequireDefault(require("./numbers/randomInteger")),_randomNumber=_interopRequireDefault(require("./numbers/randomNumber"));function _interopRequireDefault(e){return e&&e.__esModule?e:{default:e}}var _default={absoluteMax:_absoluteMax.default,absoluteMin:_absoluteMin.default,compare:_compare.default,randomInteger:_randomInteger.default,randomNumber:_randomNumber.default};exports.default=_default;

package/dist/helpers/objects/cloneObject.d.ts

@@ -0,0 +1,21 @@
+import 'core-js/stable';
+type cloneObjectOptions = {
+    mapLimit?: number;
+    depthLimit?: number;
+    relevancyRange?: number;
+};
+/**
+ * Clone objects for manipulation without data corruption, returns a copy of the provided object.
+ * NOTE: Use the mapLimit and relevancyRange to resolve "too much recursion" when the object is large and is known to
+ * have circular references. A high mapLimit may lead to heavy memory usage and slow performance.
+ * @function
+ * @memberOf module:objectHelpers
+ * @param {Object} object - The original object that is being cloned
+ * @param {Object} [options={}]
+ * @param {number} [options.mapLimit=100] - Size of temporary reference array used in memory before assessing relevancy.
+ * @param {number} [options.depthLimit=-1] - Control how many nested levels deep will be used, -1 = no limit, >-1 = nth level limited.
+ * @param {number} [options.relevancyRange=1000] - Total reference map length subtract this range, any relevancy less than that amount at time of evaluation will be removed.
+ * @returns {Object}
+ */
+declare const cloneObject: (object: object, { mapLimit, depthLimit, relevancyRange }?: cloneObjectOptions) => object;
+export default cloneObject;

package/dist/helpers/objects/cloneObject.js

@@ -7,18 +7,18 @@ exports.default = void 0
 require('core-js/stable')
 var _mergeObjectsBase = _interopRequireDefault(require('./mergeObjectsBase'))
 function _interopRequireDefault (obj) { return obj && obj.__esModule ? obj : { default: obj } }
-/**
- * Clone objects for manipulation without data corruption, returns a copy of the provided object.
- * NOTE: Use the mapLimit and relevancyRange to resolve "too much recursion" when the object is large and is known to
- * have circular references. A high mapLimit may lead to heavy memory usage and slow performance.
- * @function
- * @memberOf module:objectHelpers
- * @param {Object} object - The original object that is being cloned
- * @param {Object} [options={}]
- * @param {number} [options.mapLimit=100] - Size of temporary reference array used in memory before assessing relevancy.
- * @param {number} [options.depthLimit=-1] - Control how many nested levels deep will be used, -1 = no limit, >-1 = nth level limited.
- * @param {number} [options.relevancyRange=1000] - Total reference map length subtract this range, any relevancy less than that amount at time of evaluation will be removed.
- * @returns {Object}
+/**
+ * Clone objects for manipulation without data corruption, returns a copy of the provided object.
+ * NOTE: Use the mapLimit and relevancyRange to resolve "too much recursion" when the object is large and is known to
+ * have circular references. A high mapLimit may lead to heavy memory usage and slow performance.
+ * @function
+ * @memberOf module:objectHelpers
+ * @param {Object} object - The original object that is being cloned
+ * @param {Object} [options={}]
+ * @param {number} [options.mapLimit=100] - Size of temporary reference array used in memory before assessing relevancy.
+ * @param {number} [options.depthLimit=-1] - Control how many nested levels deep will be used, -1 = no limit, >-1 = nth level limited.
+ * @param {number} [options.relevancyRange=1000] - Total reference map length subtract this range, any relevancy less than that amount at time of evaluation will be removed.
+ * @returns {Object}
  */
 const cloneObject = function (object) {
   const {

package/dist/helpers/objects/dotGet.d.ts

@@ -0,0 +1,13 @@
+import 'core-js/stable';
+import { dotNotateableItem, dotNotationString } from './dotNotate';
+/**
+ * Get a nested property value from an object.
+ * @function
+ * @memberOf module:objectHelpers
+ * @param {Object} arrayObject - The array or object to get the property from
+ * @param {string} dotNotation - The path to the property
+ * @param {string|null} [defaultValue=null] - The default value to return if the property is not found
+ * @returns {*} The value of the property
+ */
+declare const dotGet: (arrayObject: dotNotateableItem, dotNotation: dotNotationString, defaultValue?: string | null) => any;
+export default dotGet;

package/dist/helpers/objects/dotGet.js

@@ -20,6 +20,7 @@ function _interopRequireDefault (obj) { return obj && obj.__esModule ? obj : { d
  */
 const dotGet = function (arrayObject, dotNotation) {
   const defaultValue = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : null
+  var _a
   let key = (0, _strBefore.default)(dotNotation, '.')
   const lastKey = !key
   if (lastKey) {
@@ -28,25 +29,30 @@ const dotGet = function (arrayObject, dotNotation) {
   if (key === '*') {
     const result = []
     for (const wildKey in arrayObject) {
+      // @ts-ignore
       const wildValue = arrayObject[wildKey]
       if (lastKey) {
+        // @ts-ignore
         result[wildKey] = wildValue
         continue
       }
       if (!(0, _isObject.default)(wildValue)) {
         continue
       }
+      // @ts-ignore
       result[wildKey] = dotGet(wildValue, (0, _strAfter.default)(dotNotation, '.'), defaultValue)
     }
     return result
   }
   if (lastKey) {
-    var _arrayObject$dotNotat
-    return (_arrayObject$dotNotat = arrayObject[dotNotation]) !== null && _arrayObject$dotNotat !== void 0 ? _arrayObject$dotNotat : defaultValue
+    // @ts-ignore
+    return (_a = arrayObject[dotNotation]) !== null && _a !== void 0 ? _a : defaultValue
   }
+  // @ts-ignore
   if (typeof arrayObject[key] === 'undefined') {
     return defaultValue
   }
+  // @ts-ignore
   const next = arrayObject[key]
   if (!(0, _isObject.default)(next)) {
     return defaultValue

package/dist/helpers/objects/dotGet.min.js

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:!0}),exports.default=void 0,require("core-js/stable");var _isObject=_interopRequireDefault(require("./isObject")),_strAfter=_interopRequireDefault(require("../strings/strAfter")),_strBefore=_interopRequireDefault(require("../strings/strBefore"));function _interopRequireDefault(e){return e&&e.__esModule?e:{default:e}}const dotGet=function(e,t){let r=arguments.length>2&&void 0!==arguments[2]?arguments[2]:null,u=(0,_strBefore.default)(t,".");const i=!u;if(i&&(u=t),"*"===u){const u=[];for(let o in e){const s=e[o];i?u[o]=s:(0,_isObject.default)(s)&&(u[o]=dotGet(s,(0,_strAfter.default)(t,"."),r))}return u}var o;if(i)return null!==(o=e[t])&&void 0!==o?o:r;if(void 0===e[u])return r;const s=e[u];return(0,_isObject.default)(s)?dotGet(s,(0,_strAfter.default)(t,"."),r):r};var _default=dotGet;exports.default=_default;
+"use strict";Object.defineProperty(exports,"__esModule",{value:!0}),exports.default=void 0,require("core-js/stable");var _isObject=_interopRequireDefault(require("./isObject")),_strAfter=_interopRequireDefault(require("../strings/strAfter")),_strBefore=_interopRequireDefault(require("../strings/strBefore"));function _interopRequireDefault(e){return e&&e.__esModule?e:{default:e}}const dotGet=function(e,t){let r=arguments.length>2&&void 0!==arguments[2]?arguments[2]:null;var u;let i=(0,_strBefore.default)(t,".");const o=!i;if(o&&(i=t),"*"===i){const u=[];for(let i in e){const s=e[i];o?u[i]=s:(0,_isObject.default)(s)&&(u[i]=dotGet(s,(0,_strAfter.default)(t,"."),r))}return u}if(o)return null!==(u=e[t])&&void 0!==u?u:r;if(void 0===e[i])return r;const s=e[i];return(0,_isObject.default)(s)?dotGet(s,(0,_strAfter.default)(t,"."),r):r};var _default=dotGet;exports.default=_default;

package/dist/helpers/objects/dotNotate.d.ts

@@ -0,0 +1,29 @@
+import 'core-js/stable';
+export type dotNotateableItem = Array<any> | {
+    [k: string]: any;
+};
+/**
+ * A string representing the full-path to a property in an object. Each depth of the path is separated by a period.
+ * @example 'a.b.c'
+ * @typedef {string} DotNotationString
+ * @memberOf module:objectHelpers
+ */
+export type dotNotationString = string;
+/**
+ * An array or object where all properties have been flatted and keyed by a dot-notated string.
+ * @typedef {Object.<DotNotationString, *>} DotNotatedObject
+ * @memberOf module:objectHelpers
+ */
+type dotNotatedObject = {
+    [k: dotNotationString]: any;
+};
+/**
+ * Convert an array or object to a single dimensional associative array with dot notation.
+ * @function
+ * @memberOf module:objectHelpers
+ * @param {Object} arrayObject - The array or object to dot-notate
+ * @param {Array.<DotNotationString>} [retainObjects=[]] - An array of keys to retain as objects
+ * @returns {DotNotatedObject} The dot-notated object
+ */
+declare const dotNotate: (arrayObject: object, retainObjects?: Array<dotNotationString>) => dotNotatedObject;
+export default dotNotate;

package/dist/helpers/objects/dotNotate.js

@@ -10,18 +10,6 @@ require('core-js/modules/es.string.replace.js')
 require('core-js/stable')
 var _isObject = _interopRequireDefault(require('./isObject'))
 function _interopRequireDefault (obj) { return obj && obj.__esModule ? obj : { default: obj } }
-/**
- * A string representing the full-path to a property in an object. Each depth of the path is separated by a period.
- * @example 'a.b.c'
- * @typedef {string} DotNotationString
- * @memberOf module:objectHelpers
- */
-
-/**
- * An array or object where all properties have been flatted and keyed by a dot-notated string.
- * @typedef {Object.<DotNotationString, *>} DotNotatedObject
- * @memberOf module:objectHelpers
- */
 /**
  * Convert an array of keys into a regex, return a function to test if incoming keys match.
  * @inner
@@ -29,13 +17,14 @@ function _interopRequireDefault (obj) { return obj && obj.__esModule ? obj : { d
  * @param {Array.<DotNotationString>} [retainObjects=[]] - An array of keys to retain as objects
  * @returns {Function} The dot-notated array
  */
-const handleRetainObjects = retainObjects => {
+const handleRetainObjects = function () {
+  let retainObjects = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : []
   if (!retainObjects.length) {
     /**
      * Bypass the test function if there are no retainObjects.
      * @returns {false}
      */
-    return () => false
+    return (currentKey, value, results) => false
   }
   retainObjects = retainObjects.map(key => key.replace('\.', '\\.'))
   const retainRegex = new RegExp('('.concat(retainObjects.join('|'), ')$'))
@@ -50,11 +39,11 @@ const handleRetainObjects = retainObjects => {
     if (!currentKey.match(retainRegex)) {
       return false
     }
+    // @ts-ignore
     results[currentKey] = value
     return true
   }
 }
-
 /**
  * The underlying logic function for converting arrays to dot-notation.
  * @inner
@@ -68,7 +57,9 @@ const handleRetainObjects = retainObjects => {
 const performDotNotate = function (arrayObject, didRetain) {
   const prepend = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : ''
   const results = arguments.length > 3 && arguments[3] !== undefined ? arguments[3] : {}
+  // @ts-ignore
   for (const key in arrayObject) {
+    // @ts-ignore
     const value = arrayObject[key]
     const currentKey = ''.concat(prepend).concat(key)
     if (didRetain(currentKey, value, results)) {
@@ -82,7 +73,6 @@ const performDotNotate = function (arrayObject, didRetain) {
   }
   return results
 }
-
 /**
  * Convert an array or object to a single dimensional associative array with dot notation.
  * @function

package/dist/helpers/objects/dotNotate.min.js

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:!0}),exports.default=void 0,require("core-js/modules/esnext.async-iterator.map.js"),require("core-js/modules/esnext.iterator.map.js"),require("core-js/modules/es.string.replace.js"),require("core-js/stable");var _isObject=_interopRequireDefault(require("./isObject"));function _interopRequireDefault(e){return e&&e.__esModule?e:{default:e}}const handleRetainObjects=e=>{if(!e.length)return()=>!1;e=e.map((e=>e.replace(".","\\.")));const t=new RegExp("(".concat(e.join("|"),")$"));return(e,r,o)=>!!e.match(t)&&(o[e]=r,!0)},performDotNotate=function(e,t){let r=arguments.length>2&&void 0!==arguments[2]?arguments[2]:"",o=arguments.length>3&&void 0!==arguments[3]?arguments[3]:{};for(let n in e){const a=e[n],s="".concat(r).concat(n);t(s,a,o)||((0,_isObject.default)(a)?performDotNotate(a,t,"".concat(s,"."),o):o[s]=a)}return o},dotNotate=function(e){return performDotNotate(e,handleRetainObjects(arguments.length>1&&void 0!==arguments[1]?arguments[1]:[]))};var _default=dotNotate;exports.default=_default;
+"use strict";Object.defineProperty(exports,"__esModule",{value:!0}),exports.default=void 0,require("core-js/modules/esnext.async-iterator.map.js"),require("core-js/modules/esnext.iterator.map.js"),require("core-js/modules/es.string.replace.js"),require("core-js/stable");var _isObject=_interopRequireDefault(require("./isObject"));function _interopRequireDefault(e){return e&&e.__esModule?e:{default:e}}const handleRetainObjects=function(){let e=arguments.length>0&&void 0!==arguments[0]?arguments[0]:[];if(!e.length)return(e,t,r)=>!1;e=e.map((e=>e.replace(".","\\.")));const t=new RegExp("(".concat(e.join("|"),")$"));return(e,r,o)=>!!e.match(t)&&(o[e]=r,!0)},performDotNotate=function(e,t){let r=arguments.length>2&&void 0!==arguments[2]?arguments[2]:"",o=arguments.length>3&&void 0!==arguments[3]?arguments[3]:{};for(let n in e){const a=e[n],i="".concat(r).concat(n);t(i,a,o)||((0,_isObject.default)(a)?performDotNotate(a,t,"".concat(i,"."),o):o[i]=a)}return o},dotNotate=function(e){return performDotNotate(e,handleRetainObjects(arguments.length>1&&void 0!==arguments[1]?arguments[1]:[]))};var _default=dotNotate;exports.default=_default;

package/dist/helpers/objects/dotSet.d.ts

@@ -0,0 +1,13 @@
+import 'core-js/stable';
+import { dotNotateableItem, dotNotationString } from './dotNotate';
+/**
+ * Set a nested property value an object.
+ * @function
+ * @memberOf module:objectHelpers
+ * @param {Object} arrayObject - The array or object to set the property on
+ * @param {string} dotNotation - The path for the property
+ * @param {*} value - The default value to return if the property is not found
+ * @returns {Object} The modified object
+ */
+declare const dotSet: (arrayObject: dotNotateableItem, dotNotation: dotNotationString, value?: any) => dotNotateableItem;
+export default dotSet;

package/dist/helpers/objects/dotSet.js

@@ -19,8 +19,8 @@ function _interopRequireDefault (obj) { return obj && obj.__esModule ? obj : { d
  * @returns {Object} The modified object
  */
 const dotSet = function (arrayObject, dotNotation) {
-  var _arrayObject$key
   const value = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : null
+  var _a
   let key = (0, _strBefore.default)(dotNotation, '.')
   const lastKey = !key
   if (lastKey) {
@@ -29,21 +29,27 @@ const dotSet = function (arrayObject, dotNotation) {
   if (key === '*') {
     for (const wildKey in arrayObject) {
       if (lastKey) {
+        // @ts-ignore
         arrayObject[wildKey] = value
         continue
       }
+      // @ts-ignore
       if (!(0, _isObject.default)(arrayObject[wildKey])) {
         continue
       }
+      // @ts-ignore
       dotSet(arrayObject[wildKey], (0, _strAfter.default)(dotNotation, '.'), value)
     }
     return arrayObject
   }
   if (lastKey) {
+    // @ts-ignore
     arrayObject[dotNotation] = value
     return arrayObject
   }
-  const next = (_arrayObject$key = arrayObject[key]) !== null && _arrayObject$key !== void 0 ? _arrayObject$key : []
+  // @ts-ignore
+  const next = (_a = arrayObject[key]) !== null && _a !== void 0 ? _a : []
+  // @ts-ignore
   arrayObject[key] = dotSet(next, (0, _strAfter.default)(dotNotation, '.'), value)
   return arrayObject
 }

package/dist/helpers/objects/dotSet.min.js

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:!0}),exports.default=void 0,require("core-js/stable");var _isObject=_interopRequireDefault(require("./isObject")),_strAfter=_interopRequireDefault(require("../strings/strAfter")),_strBefore=_interopRequireDefault(require("../strings/strBefore"));function _interopRequireDefault(e){return e&&e.__esModule?e:{default:e}}const dotSet=function(e,t){var r;let u=arguments.length>2&&void 0!==arguments[2]?arguments[2]:null,i=(0,_strBefore.default)(t,".");const o=!i;if(o&&(i=t),"*"===i){for(let r in e)o?e[r]=u:(0,_isObject.default)(e[r])&&dotSet(e[r],(0,_strAfter.default)(t,"."),u);return e}if(o)return e[t]=u,e;const f=null!==(r=e[i])&&void 0!==r?r:[];return e[i]=dotSet(f,(0,_strAfter.default)(t,"."),u),e};var _default=dotSet;exports.default=_default;
+"use strict";Object.defineProperty(exports,"__esModule",{value:!0}),exports.default=void 0,require("core-js/stable");var _isObject=_interopRequireDefault(require("./isObject")),_strAfter=_interopRequireDefault(require("../strings/strAfter")),_strBefore=_interopRequireDefault(require("../strings/strBefore"));function _interopRequireDefault(e){return e&&e.__esModule?e:{default:e}}const dotSet=function(e,t){let r=arguments.length>2&&void 0!==arguments[2]?arguments[2]:null;var u;let i=(0,_strBefore.default)(t,".");const o=!i;if(o&&(i=t),"*"===i){for(let u in e)o?e[u]=r:(0,_isObject.default)(e[u])&&dotSet(e[u],(0,_strAfter.default)(t,"."),r);return e}if(o)return e[t]=r,e;const f=null!==(u=e[i])&&void 0!==u?u:[];return e[i]=dotSet(f,(0,_strAfter.default)(t,"."),r),e};var _default=dotSet;exports.default=_default;

package/dist/helpers/objects/dotUnset.d.ts

@@ -0,0 +1,12 @@
+import 'core-js/stable';
+import { dotNotateableItem, dotNotationString } from './dotNotate';
+/**
+ * Unset a nested property value an object.
+ * @function
+ * @memberOf module:objectHelpers
+ * @param {Object} arrayObject - The array or object to set the property on
+ * @param {string} dotNotation - The path for the property
+ * @returns {Object} The modified object
+ */
+declare const dotUnset: (arrayObject: dotNotateableItem, dotNotation: dotNotationString) => dotNotateableItem;
+export default dotUnset;

package/dist/helpers/objects/dotUnset.js

@@ -18,7 +18,7 @@ function _interopRequireDefault (obj) { return obj && obj.__esModule ? obj : { d
  * @returns {Object} The modified object
  */
 const dotUnset = (arrayObject, dotNotation) => {
-  var _arrayObject$key
+  var _a
   let key = (0, _strBefore.default)(dotNotation, '.')
   const lastKey = !key
   if (lastKey) {
@@ -27,21 +27,27 @@ const dotUnset = (arrayObject, dotNotation) => {
   if (key === '*') {
     for (const wildKey in arrayObject) {
       if (lastKey) {
+        // @ts-ignore
         delete arrayObject[wildKey]
         continue
       }
+      // @ts-ignore
       if (!(0, _isObject.default)(arrayObject[wildKey])) {
         continue
       }
+      // @ts-ignore
       dotUnset(arrayObject[wildKey], (0, _strAfter.default)(dotNotation, '.'))
     }
     return arrayObject
   }
   if (lastKey) {
+    // @ts-ignore
     delete arrayObject[dotNotation]
     return arrayObject
   }
-  const next = (_arrayObject$key = arrayObject[key]) !== null && _arrayObject$key !== void 0 ? _arrayObject$key : []
+  // @ts-ignore
+  const next = (_a = arrayObject[key]) !== null && _a !== void 0 ? _a : []
+  // @ts-ignore
   arrayObject[key] = dotUnset(next, (0, _strAfter.default)(dotNotation, '.'))
   return arrayObject
 }

package/dist/helpers/objects/emptyObject.d.ts

@@ -0,0 +1,10 @@
+import 'core-js/stable';
+/**
+ * Helper function for testing if the item is an Object or Array that does not have any properties
+ * @function
+ * @memberOf module:objectHelpers
+ * @param {Object|Array} item - Object or Array to test
+ * @returns {boolean}
+ */
+declare const emptyObject: (item: Array<any> | Object) => boolean;
+export default emptyObject;

package/dist/helpers/objects/emptyObject.js

@@ -8,12 +8,12 @@ require('core-js/stable')
 var _isObject = _interopRequireDefault(require('./isObject'))
 var _objectKeys = _interopRequireDefault(require('./objectKeys'))
 function _interopRequireDefault (obj) { return obj && obj.__esModule ? obj : { default: obj } }
-/**
- * Helper function for testing if the item is an Object or Array that does not have any properties
- * @function
- * @memberOf module:objectHelpers
- * @param {Object|Array} item - Object or Array to test
- * @returns {boolean}
+/**
+ * Helper function for testing if the item is an Object or Array that does not have any properties
+ * @function
+ * @memberOf module:objectHelpers
+ * @param {Object|Array} item - Object or Array to test
+ * @returns {boolean}
  */
 const emptyObject = item => (typeof item === 'function' || (0, _isObject.default)(item)) && !(0, _objectKeys.default)(item).length
 var _default = emptyObject

package/dist/helpers/objects/filterObject.d.ts

@@ -0,0 +1,28 @@
+import 'core-js/stable';
+type filterableItem = Array<any> | {
+    [k: number | string]: any;
+};
+/**
+ * Function is a predicate, to test each property value of the object. Return true to keep the element, false
+ * otherwise, taking three arguments
+ * @callback module:objectHelpers~filterCallback
+ * @memberOf module:objectHelpers
+ * @param {*} currentProperty - The current property being processed in the object.
+ * @param {string} [currentIndex] - The property name of the current property being processed in the object.
+ * @param {Object|Array} [object] - The object filter was called upon.
+ * @returns {boolean}
+ */
+type filterCallback = (currentProperty: any, currentIndex: keyof filterableItem, object: filterableItem) => boolean;
+/**
+ * This function is intended to replicate behaviour of the Array.filter() function but for Objects.
+ * If an array is passed in instead then it will perform standard filter(). It is recommended to
+ * always use the standard filter() function when it is known that the object is actually an array.
+ * @function
+ * @memberOf module:objectHelpers
+ * @param {Object|Array} obj - The Object (or Array) to be filtered
+ * @param {module:objectHelpers~filterCallback|Function} fn - The function to be processed for each filtered property
+ * @param {Object|Array} [thisArg] - Optional. Value to use as this when executing callback.
+ * @returns {Object|Array}
+ */
+declare const filterObject: (obj: filterableItem, fn: filterCallback, thisArg?: filterableItem) => filterableItem;
+export default filterObject;