si-funciona 2.3.3 → 2.4.0

package/dist/helpers/functions/preloadParams.d.ts

@@ -1,21 +1,21 @@
-import 'core-js/stable';
-/**
- * The return function which takes the missing parameter in order to call the preloaded function.
- * @typedef {Function} module:functionHelpers~callWithMissing
- * @memberOf module:functionHelpers
- * @param {*} missing - The missing parameter to be applied
- * @returns {*}
- */
-type callWithMissing = (missing: any) => any;
-/**
- * Provide an array of parameters to be used with a function, allow the function to be called later
- * with the missing parameter.
- * @memberOf module:functionHelpers
- * @param {Function} fn - The function to be called
- * @param {Array} params - The parameters to preload
- * @param {number} [unassignedParam=0] - Position of missing parameter (zero indexed)
- * @returns {module:functionHelpers~callWithMissing}
- */
-declare const preloadParams: (fn: Function, params?: Array<any>, unassignedParam?: number) => callWithMissing;
-export default preloadParams;
+import 'core-js/stable';
+/**
+ * The return function which takes the missing parameter in order to call the preloaded function.
+ * @typedef {Function} module:functionHelpers~callWithMissing
+ * @memberOf module:functionHelpers
+ * @param {*} missing - The missing parameter to be applied
+ * @returns {*}
+ */
+type callWithMissing = (missing: any) => any;
+/**
+ * Provide an array of parameters to be used with a function, allow the function to be called later
+ * with the missing parameter.
+ * @memberOf module:functionHelpers
+ * @param {Function} fn - The function to be called
+ * @param {Array} params - The parameters to preload
+ * @param {number} [unassignedParam=0] - Position of missing parameter (zero indexed)
+ * @returns {module:functionHelpers~callWithMissing}
+ */
+declare const preloadParams: (fn: Function, params?: Array<any>, unassignedParam?: number) => callWithMissing;
+export default preloadParams;
 //# sourceMappingURL=preloadParams.d.ts.map

package/dist/helpers/functions/preloadParams.js

@@ -1,21 +1,21 @@
-'use strict'
-
-Object.defineProperty(exports, '__esModule', {
-  value: true
-})
-exports.default = void 0
-require('core-js/stable')
-/**
- * Provide an array of parameters to be used with a function, allow the function to be called later
- * with the missing parameter.
- * @memberOf module:functionHelpers
- * @param {Function} fn - The function to be called
- * @param {Array} params - The parameters to preload
- * @param {number} [unassignedParam=0] - Position of missing parameter (zero indexed)
- * @returns {module:functionHelpers~callWithMissing}
- */
-const preloadParams = (fn, params = [], unassignedParam = 0) => missing => {
-  params.splice(unassignedParam, 0, missing)
-  return fn(...params)
-}
-var _default = exports.default = preloadParams
+'use strict'
+
+Object.defineProperty(exports, '__esModule', {
+  value: true
+})
+exports.default = void 0
+require('core-js/stable')
+/**
+ * Provide an array of parameters to be used with a function, allow the function to be called later
+ * with the missing parameter.
+ * @memberOf module:functionHelpers
+ * @param {Function} fn - The function to be called
+ * @param {Array} params - The parameters to preload
+ * @param {number} [unassignedParam=0] - Position of missing parameter (zero indexed)
+ * @returns {module:functionHelpers~callWithMissing}
+ */
+const preloadParams = (fn, params = [], unassignedParam = 0) => missing => {
+  params.splice(unassignedParam, 0, missing)
+  return fn(...params)
+}
+var _default = exports.default = preloadParams

package/dist/helpers/functions/queueManager.d.ts

@@ -1,48 +1,50 @@
-import 'core-js/stable';
-import 'regenerator-runtime/runtime';
-import { IsQueue, queuedItem } from '../arrays/BasicQueue';
-/**
- * Each time queue handle is called the passed function is added to the queue to be called when ready.
- * @typedef {Object} module:functionHelpers~queueedRunnable
- * @memberOf module:functionHelpers
- * @property {Object.<fn|args, Function|Array.<*>>} item - Stores the function and the arguments to apply to it when called
- * @property {Generator} generator - The generator instance which can be used to yield function results
- */
-export type queuedRunnable = {
-    item: {
-        fn: Function | queuedItem;
-        args: any[];
-    };
-    generator: Generator;
-};
-/**
- * The pushed function is added to the queue to be called when ready.
- * @typedef {Function} module:functionHelpers~queueManagerPush
- * @memberOf module:functionHelpers
- * @param {Function} fn - A function to enqueue
- * @param  {...*} args - Arguments to be passed to the function once it is ready
- * @returns {Promise}
- */
-export type queuePush = (fn: Function, ...args: any) => Promise<any>;
-/**
- * Each time queue handle is called the passed function is added to the queue to be called when ready.
- * @typedef {Object} module:functionHelpers~queueManagerHandle
- * @memberOf module:functionHelpers
- * @property {Function} start - Callable property that will disable paused state and run the next queue
- * @property  {Function} pause - Callable property that will switch state to paused
- * @property {module:functionHelpers~queueManagerPush} push - Callable property that takes a function to add to the queue
- */
-export type queueManagerHandle = {
-    start: () => void;
-    pause: () => void;
-    push: queuePush;
-};
-/**
- * Manage functions to run sequentially.
- * @memberOf module:functionHelpers
- * @param {IsQueue} [queue=[]] - The iterable that can be used to store queued functions
- * @returns {module:functionHelpers~queueManagerHandle}
- */
-declare const queueManager: (queue?: IsQueue<queuedItem>) => queueManagerHandle;
-export default queueManager;
+import 'core-js/stable';
+import 'regenerator-runtime/runtime';
+import { IsQueue, queuedItem } from '../arrays/BasicQueue';
+/**
+ * Each time queue handle is called the passed function is added to the queue to be called when ready.
+ * @typedef {Object} module:functionHelpers~queueedRunnable
+ * @memberOf module:functionHelpers
+ * @property {Object.<fn|args, Function|Array.<*>>} item - Stores the function and the arguments to apply to it when called
+ * @property {Generator} generator - The generator instance which can be used to yield function results
+ */
+export type queuedRunnable = {
+    item: {
+        fn: Function | queuedItem;
+        args: any[];
+    };
+    generator: Generator;
+};
+/**
+ * The pushed function is added to the queue to be called when ready.
+ * @typedef {Function} module:functionHelpers~queueManagerPush
+ * @memberOf module:functionHelpers
+ * @param {Function} fn - A function to enqueue
+ * @param  {...*} args - Arguments to be passed to the function once it is ready
+ * @returns {Promise}
+ */
+export type queuePush = (fn: Function, ...args: any) => Promise<any>;
+/**
+ * Each time queue handle is called the passed function is added to the queue to be called when ready.
+ * @typedef {Object} module:functionHelpers~queueManagerHandle
+ * @memberOf module:functionHelpers
+ * @property {Function} start - Callable property that will disable paused state and run the next queue
+ * @property  {Function} pause - Callable property that will switch state to paused
+ * @property {module:functionHelpers~queueManagerPush} push - Callable property that takes a function to add to the queue
+ */
+export type queueManagerHandle = {
+    start: () => void;
+    pause: () => void;
+    push: queuePush;
+};
+/**
+ * Manage functions to run sequentially.
+ * @memberOf module:functionHelpers
+ * @param {IsQueue|Array} [queue=null] - The queue to manage. Pass a plain array to have it converted into a
+ * {@link module:arrayHelpers.BasicQueue} automatically, or a custom queue implementing `IsQueue`; omit it (or pass
+ * `null`) to have one created for you.
+ * @returns {module:functionHelpers~queueManagerHandle}
+ */
+declare const queueManager: (queue?: IsQueue<queuedItem>) => queueManagerHandle;
+export default queueManager;
 //# sourceMappingURL=queueManager.d.ts.map

package/dist/helpers/functions/queueManager.js

@@ -1,122 +1,124 @@
-'use strict'
-
-Object.defineProperty(exports, '__esModule', {
-  value: true
-})
-exports.default = void 0
-require('core-js/modules/esnext.iterator.constructor.js')
-require('core-js/modules/esnext.iterator.for-each.js')
-require('core-js/stable')
-require('regenerator-runtime/runtime')
-var _makeBasicQueue = _interopRequireDefault(require('./makeBasicQueue'))
-function _interopRequireDefault (e) { return e && e.__esModule ? e : { default: e } }
-/**
- * Manage functions to run sequentially.
- * @memberOf module:functionHelpers
- * @param {IsQueue} [queue=[]] - The iterable that can be used to store queued functions
- * @returns {module:functionHelpers~queueManagerHandle}
- */
-const queueManager = (queue = null) => {
-  let isRunning = false
-  let isPaused = true
-  /**
-   * Convert a function to a queueable object.
-   * @param {Promise.resolve} resolve
-   * @param {Promise.reject} reject
-   * @param {Function} fn
-   * @param {...*} args
-   * @returns {queuedRunnable}
-   */
-  const makeQueuedRunnable = (resolve, reject, fn, ...args) => {
-    const generator = (function * () {
-      const item = yield
-      return typeof item.fn === 'function' ? resolve(item.fn(...item.args)) : reject(item)
-    }())
-    // Prepare the generator to be used on the subsequent call
-    generator.next()
-    return {
-      item: {
-        fn: fn,
-        args: args
-      },
-      generator: generator
-    }
-  }
-  /**
-   * After an item is run, THEN run this function to reset isRunning
-   * @param {*} result
-   * @returns {*}
-   */
-  const postRun = result => {
-    isRunning = false
-    runNextItem()
-    return result
-  }
-  /**
-   * When ready, runs the next queued runnable generator.
-   * @returns {IteratorYieldResult|null}
-   */
-  const runNextItem = () => {
-    if (!isPaused && !queue.empty() && !isRunning) {
-      isRunning = true
-      let toRun = queue.dequeue()
-      if (typeof toRun === 'undefined' || toRun === null) {
-        return null
-      }
-      if (typeof toRun === 'function') {
-        new Promise((resolve, reject) => {
-          toRun = makeQueuedRunnable(resolve, reject, toRun)
-          runNextItem()
-        }).then(postRun)
-      }
-      if ('success' in toRun) {
-        // Some run responses return an object with 'success' property.
-        console.info(toRun.success)
-        return null
-      }
-      if (!toRun.generator || 'error' in toRun) {
-        // Some run responses return an object with an 'error' property
-        let errorMessage = 'Verify queued function implements "done()" state.'
-        if ('error' in toRun && toRun.error) {
-          errorMessage = `[${toRun.error}]: ${errorMessage}`
-        }
-        throw new Error(errorMessage)
-      }
-      if (toRun.generator && toRun.item) {
-        // Ensure the returned result has both the generator and the item to be valid
-        return toRun.generator.next(toRun.item)
-      }
-    }
-    return null
-  }
-  /**
-   * Add a function into the queue to be run when ready.
-   * @param {Function} fn - The function to run when ready
-   * @param {...*} args - Optional arguments to apply when the function is ready to be run
-   * @returns Promise
-   */
-  const pushAnother = (fn, ...args) => new Promise((resolve, reject) => {
-    queue.enqueue(makeQueuedRunnable(resolve, reject, fn, ...args))
-    runNextItem()
-  }).then(postRun)
-  if (Array.isArray(queue)) {
-    const queueArray = queue
-    queue = (0, _makeBasicQueue.default)()
-    queueArray.forEach(queued => pushAnother(queued))
-  }
-  if (queue === null) {
-    queue = (0, _makeBasicQueue.default)()
-  }
-  runNextItem()
-  return {
-    start: () => {
-      isPaused = false
-      runNextItem()
-    },
-    pause: () => {
-      isPaused = true
-    },
-    push: pushAnother
-  }
-}
-var _default = exports.default = queueManager
+'use strict'
+
+Object.defineProperty(exports, '__esModule', {
+  value: true
+})
+exports.default = void 0
+require('core-js/modules/esnext.iterator.constructor.js')
+require('core-js/modules/esnext.iterator.for-each.js')
+require('core-js/stable')
+require('regenerator-runtime/runtime')
+var _makeBasicQueue = _interopRequireDefault(require('./makeBasicQueue'))
+function _interopRequireDefault (e) { return e && e.__esModule ? e : { default: e } }
+/**
+ * Manage functions to run sequentially.
+ * @memberOf module:functionHelpers
+ * @param {IsQueue|Array} [queue=null] - The queue to manage. Pass a plain array to have it converted into a
+ * {@link module:arrayHelpers.BasicQueue} automatically, or a custom queue implementing `IsQueue`; omit it (or pass
+ * `null`) to have one created for you.
+ * @returns {module:functionHelpers~queueManagerHandle}
+ */
+const queueManager = (queue = null) => {
+  let isRunning = false
+  let isPaused = true
+  /**
+   * Convert a function to a queueable object.
+   * @param {Promise.resolve} resolve
+   * @param {Promise.reject} reject
+   * @param {Function} fn
+   * @param {...*} args
+   * @returns {queuedRunnable}
+   */
+  const makeQueuedRunnable = (resolve, reject, fn, ...args) => {
+    const generator = (function * () {
+      const item = yield
+      return typeof item.fn === 'function' ? resolve(item.fn(...item.args)) : reject(item)
+    }())
+    // Prepare the generator to be used on the subsequent call
+    generator.next()
+    return {
+      item: {
+        fn: fn,
+        args: args
+      },
+      generator: generator
+    }
+  }
+  /**
+   * After an item is run, THEN run this function to reset isRunning
+   * @param {*} result
+   * @returns {*}
+   */
+  const postRun = result => {
+    isRunning = false
+    runNextItem()
+    return result
+  }
+  /**
+   * When ready, runs the next queued runnable generator.
+   * @returns {IteratorYieldResult|null}
+   */
+  const runNextItem = () => {
+    if (!isPaused && !queue.empty() && !isRunning) {
+      isRunning = true
+      let toRun = queue.dequeue()
+      if (typeof toRun === 'undefined' || toRun === null) {
+        return null
+      }
+      if (typeof toRun === 'function') {
+        new Promise((resolve, reject) => {
+          toRun = makeQueuedRunnable(resolve, reject, toRun)
+          runNextItem()
+        }).then(postRun)
+      }
+      if ('success' in toRun) {
+        // Some run responses return an object with 'success' property.
+        console.info(toRun.success)
+        return null
+      }
+      if (!toRun.generator || 'error' in toRun) {
+        // Some run responses return an object with an 'error' property
+        let errorMessage = 'Verify queued function implements "done()" state.'
+        if ('error' in toRun && toRun.error) {
+          errorMessage = `[${toRun.error}]: ${errorMessage}`
+        }
+        throw new Error(errorMessage)
+      }
+      if (toRun.generator && toRun.item) {
+        // Ensure the returned result has both the generator and the item to be valid
+        return toRun.generator.next(toRun.item)
+      }
+    }
+    return null
+  }
+  /**
+   * Add a function into the queue to be run when ready.
+   * @param {Function} fn - The function to run when ready
+   * @param {...*} args - Optional arguments to apply when the function is ready to be run
+   * @returns Promise
+   */
+  const pushAnother = (fn, ...args) => new Promise((resolve, reject) => {
+    queue.enqueue(makeQueuedRunnable(resolve, reject, fn, ...args))
+    runNextItem()
+  }).then(postRun)
+  if (Array.isArray(queue)) {
+    const queueArray = queue
+    queue = (0, _makeBasicQueue.default)()
+    queueArray.forEach(queued => pushAnother(queued))
+  }
+  if (queue === null) {
+    queue = (0, _makeBasicQueue.default)()
+  }
+  runNextItem()
+  return {
+    start: () => {
+      isPaused = false
+      runNextItem()
+    },
+    pause: () => {
+      isPaused = true
+    },
+    push: pushAnother
+  }
+}
+var _default = exports.default = queueManager

package/dist/helpers/functions/queueTimeout.d.ts

@@ -1,22 +1,22 @@
-import 'core-js/stable';
-import 'regenerator-runtime/runtime';
-import { queueManagerHandle } from './queueManager';
-/**
- * Run Timeout functions one after the otherin queue.
- * @typedef {Function} module:functionHelpers~queueTimeoutHandle
- * @memberOf module:functionHelpers
- * @param {Function} fn - A callback function to be performed at some time in the future.
- * @param {number} time - The time in milliseconds to delay.
- * @param {...*} args - Arguments to be passed to the callback once it is implemented.
- * @returns {Promise}
- */
-type queueTimeoutHandle = (fn: Function, time: number, ...args: any) => Promise<any>;
-/**
- * Manage functions to run sequentially with delays.
- * @memberOf module:functionHelpers
- * @param {module:functionHelpers~queueManagerHandle} [queueManagerHandle=null]
- * @returns {module:functionHelpers~queueTimeoutHandle}
- */
-declare const queueTimeout: (queueManagerHandle?: queueManagerHandle) => queueTimeoutHandle;
-export default queueTimeout;
+import 'core-js/stable';
+import 'regenerator-runtime/runtime';
+import { queueManagerHandle } from './queueManager';
+/**
+ * Run Timeout functions one after the otherin queue.
+ * @typedef {Function} module:functionHelpers~queueTimeoutHandle
+ * @memberOf module:functionHelpers
+ * @param {Function} fn - A callback function to be performed at some time in the future.
+ * @param {number} time - The time in milliseconds to delay.
+ * @param {...*} args - Arguments to be passed to the callback once it is implemented.
+ * @returns {Promise}
+ */
+type queueTimeoutHandle = (fn: Function, time: number, ...args: any) => Promise<any>;
+/**
+ * Manage functions to run sequentially with delays.
+ * @memberOf module:functionHelpers
+ * @param {module:functionHelpers~queueManagerHandle} [queueManagerHandle=null]
+ * @returns {module:functionHelpers~queueTimeoutHandle}
+ */
+declare const queueTimeout: (queueManagerHandle?: queueManagerHandle) => queueTimeoutHandle;
+export default queueTimeout;
 //# sourceMappingURL=queueTimeout.d.ts.map

package/dist/helpers/functions/queueTimeout.js

@@ -1,23 +1,23 @@
-'use strict'
-
-Object.defineProperty(exports, '__esModule', {
-  value: true
-})
-exports.default = void 0
-require('core-js/stable')
-require('regenerator-runtime/runtime')
-var _delay = _interopRequireDefault(require('./delay'))
-var _queueManager = _interopRequireDefault(require('./queueManager'))
-function _interopRequireDefault (e) { return e && e.__esModule ? e : { default: e } }
-/**
- * Manage functions to run sequentially with delays.
- * @memberOf module:functionHelpers
- * @param {module:functionHelpers~queueManagerHandle} [queueManagerHandle=null]
- * @returns {module:functionHelpers~queueTimeoutHandle}
- */
-const queueTimeout = (queueManagerHandle = null) => {
-  const manager = queueManagerHandle || (0, _queueManager.default)()
-  manager.start()
-  return (fn, time = 0, ...args) => manager.push(() => (0, _delay.default)(time).resolver.then(() => fn(...args)))
-}
-var _default = exports.default = queueTimeout
+'use strict'
+
+Object.defineProperty(exports, '__esModule', {
+  value: true
+})
+exports.default = void 0
+require('core-js/stable')
+require('regenerator-runtime/runtime')
+var _delay = _interopRequireDefault(require('./delay'))
+var _queueManager = _interopRequireDefault(require('./queueManager'))
+function _interopRequireDefault (e) { return e && e.__esModule ? e : { default: e } }
+/**
+ * Manage functions to run sequentially with delays.
+ * @memberOf module:functionHelpers
+ * @param {module:functionHelpers~queueManagerHandle} [queueManagerHandle=null]
+ * @returns {module:functionHelpers~queueTimeoutHandle}
+ */
+const queueTimeout = (queueManagerHandle = null) => {
+  const manager = queueManagerHandle || (0, _queueManager.default)()
+  manager.start()
+  return (fn, time = 0, ...args) => manager.push(() => (0, _delay.default)(time).resolver.then(() => fn(...args)))
+}
+var _default = exports.default = queueTimeout

package/dist/helpers/functions/relevancyFilter.d.ts

@@ -1,36 +1,36 @@
-import 'core-js/stable';
-/**
- * An object having an integer valued property named 'relevance'.
- * @typedef {Object} relevanceObject
- * @memberOf module:functionHelpers
- * @property {Array|Object} source
- * @property {Array|Object} object
- * @property {number} relevance
- */
-export type relevanceObject = {
-    source: Array<any> | Object;
-    object: Array<any> | Object;
-    relevance: number;
-};
-/**
- * A map of relevanceObjects which can be manipulated to filter results.
- * @typedef {Array.<relevanceObject>} relevanceMap
- * @memberOf module:functionHelpers
- */
-export type relevanceMap = Array<relevanceObject>;
-type relevancyFilterOptions = {
-    mapLimit?: number;
-    relevancyRange?: number;
-};
-/**
- * Remove elements out of relevance range and update the max relevance.
- * @memberOf module:functionHelpers
- * @param {relevanceMap} map
- * @param {Object} [options={}]
- * @param {int} [options.mapLimit=1000]
- * @param {int} [options.relevancyRange=100]
- * @returns {relevanceMap}
- */
-declare const relevancyFilter: (map: relevanceMap, { mapLimit, relevancyRange }?: relevancyFilterOptions) => relevanceMap;
-export default relevancyFilter;
+import 'core-js/stable';
+/**
+ * An object having an integer valued property named 'relevance'.
+ * @typedef {Object} relevanceObject
+ * @memberOf module:functionHelpers
+ * @property {Array|Object} source
+ * @property {Array|Object} object
+ * @property {number} relevance
+ */
+export type relevanceObject = {
+    source: Array<any> | Object;
+    object: Array<any> | Object;
+    relevance: number;
+};
+/**
+ * A map of relevanceObjects which can be manipulated to filter results.
+ * @typedef {Array.<relevanceObject>} relevanceMap
+ * @memberOf module:functionHelpers
+ */
+export type relevanceMap = Array<relevanceObject>;
+type relevancyFilterOptions = {
+    mapLimit?: number;
+    relevancyRange?: number;
+};
+/**
+ * Remove elements out of relevance range and update the max relevance.
+ * @memberOf module:functionHelpers
+ * @param {relevanceMap} map
+ * @param {Object} [options={}]
+ * @param {number} [options.mapLimit=1000] - Only filter once the map exceeds this many entries.
+ * @param {number} [options.relevancyRange=100] - How many of the most-recent relevance values to keep.
+ * @returns {relevanceMap}
+ */
+declare const relevancyFilter: (map: relevanceMap, { mapLimit, relevancyRange }?: relevancyFilterOptions) => relevanceMap;
+export default relevancyFilter;
 //# sourceMappingURL=relevancyFilter.d.ts.map