collect-your-stuff 1.1.0 → 1.1.2

package/dist/collections/arrayable/Arrayable.js

@@ -1,195 +1,196 @@
-'use strict'
-
-Object.defineProperty(exports, '__esModule', {
-  value: true
-})
-exports.default = void 0
-var _ArrayElement = _interopRequireDefault(require('./ArrayElement'))
-var _ArrayIterator = _interopRequireDefault(require('../../recipes/ArrayIterator'))
-function _interopRequireDefault (obj) { return obj && obj.__esModule ? obj : { default: obj } }
-/**
- * @file arrayable list.
- * @author Joshua Heagle <joshuaheagle@gmail.com>
- * @version 1.1.0
- * @memberOf module:collect-your-stuff
- */
-
-/**
- * Arrayable represents a collection stored as an array.
- */
-class Arrayable {
-  /**
-   * Create the new Arrayable instance, configure the Arrayable class.
-   */
-  constructor () {
-    this.classType = Arrayable
-    this.innerList = []
-    this.initialized = false
-    this.initialized = false
-  }
-
-  /**
-   * Initialize the inner list, should only run once.
-   * @param {Array<ArrayElement>} initialList Give the array of elements to start in this Arrayable.
-   * @return {Arrayable}
-   */
-  initialize (initialList) {
-    if (this.initialized) {
-      console.warn('Attempt to initialize non-empty list.')
-      return this
-    }
-    this.initialized = true
-    this.innerList = initialList
-    return this
-  }
-
-  /**
-   * Retrieve a copy of the innerList used.
-   * @returns {Array<ArrayElement>}
-   */
-  get list () {
-    return this.innerList
-  }
-
-  /**
-   * Retrieve the first Element from the Arrayable
-   * @returns {ArrayElement}
-   */
-  get first () {
-    return this.innerList[0]
-  }
-
-  /**
-   * Retrieve the last Element from the Arrayable
-   * @returns {ArrayElement}
-   */
-  get last () {
-    return this.innerList[this.length - 1]
-  }
-
-  /**
-   * Return the length of the list.
-   * @returns {number}
-   */
-  get length () {
-    return this.innerList.length
-  }
-
-  /**
-   * Insert a new node (or data) after a node.
-   * @param {ArrayElement|*} node The existing node as reference
-   * @param {ArrayElement|*} newNode The new node to go after the existing node
-   * @returns {Arrayable}
-   */
-  insertAfter (node, newNode) {
-    const insertAt = this.innerList.indexOf(node)
-    this.innerList.splice(insertAt + 1, 0, node.classType.make(newNode))
-    return this
-  }
-
-  /**
-   * Insert a new node (or data) before a node.
-   * @param {ArrayElement|*} node The existing node as reference
-   * @param {ArrayElement|*} newNode The new node to go before the existing node
-   * @returns {Arrayable}
-   */
-  insertBefore (node, newNode) {
-    const insertAt = this.innerList.indexOf(node)
-    this.innerList.splice(insertAt, 0, node.classType.make(newNode))
-    return this
-  }
-
-  /**
-   * Add a node (or data) after the given (or last) node in the list.
-   * @param {ArrayElement|*} node The new node to add to the end of the list
-   * @param {ArrayElement} after The existing last node
-   * @returns {Arrayable}
-   */
-  append (node) {
-    const after = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : this.last
-    return this.insertAfter(after, node)
-  }
-
-  /**
-   * Add a node (or data) before the given (or first) node in the list.
-   * @param {ArrayElement|*} node The new node to add to the start of the list
-   * @param {ArrayElement} before The existing first node
-   * @returns {Arrayable}
-   */
-  prepend (node) {
-    const before = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : this.first
-    return this.insertBefore(before, node)
-  }
-
-  /**
-   * Remove an element from this arrayable.
-   * @param {ArrayElement} node The node we wish to remove (and it will be returned after removal)
-   * @return {ArrayElement}
-   */
-  remove (node) {
-    const deleteAt = this.innerList.indexOf(node)
-    this.innerList.splice(deleteAt, 1)
-    return node
-  }
-
-  /**
-   * Retrieve an ArrayElement item from this list by numeric index, otherwise return null.
-   * @param {number} index The integer number for retrieving a node by position.
-   * @return {ArrayElement|null}
-   */
-  item (index) {
-    if (index >= this.length) {
-      // index is beyond array limit
-      return null
-    }
-    if (index >= 0) {
-      // use the positive index at nth position from the beginning of the array
-      return this.innerList[index]
-    }
-    const calculatedIndex = this.length + index
-    if (calculatedIndex < 0) {
-      // negative index is beyond array limit (minus direction)
-      return null
-    }
-    // Return the item at nth position from the end of the array
-    return this.innerList[calculatedIndex]
-  }
-
-  /**
-   * Be able to run forEach on this Arrayable to iterate over the elements.
-   * @param {forEachCallback} callback The function to call for-each element
-   * @param {Arrayable} thisArg Optional, 'this' reference
-   * @returns {Arrayable}
-   */
-  forEach (callback) {
-    const thisArg = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : this
-    for (let i = 0; i < thisArg.length; ++i) {
-      callback(thisArg.item(i), i, thisArg)
-    }
-    return thisArg
-  }
-
-  /**
-   * Be able to iterate over this class.
-   * @returns {Iterator}
-   */
-  [Symbol.iterator] () {
-    const index = 0
-    return new _ArrayIterator.default(this.innerList, index)
-  }
-}
-/**
- * Convert an array to an Arrayable.
- * @param {Array} values An array of values which will be converted to elements in this arrayable
- * @param {IsElement} [elementClass=ArrayElement] The class to use for each element
- * @param {IsArrayable<ArrayElement>} [classType=Arrayable] Provide the type of IsArrayable to use.
- * @returns {Arrayable}
- */
-Arrayable.fromArray = function () {
-  const values = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : []
-  const elementClass = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : _ArrayElement.default
-  const classType = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : Arrayable
-  const list = new classType()
-  return list.initialize(elementClass.fromArray(values).head)
-}
-var _default = exports.default = Arrayable
+'use strict'
+
+Object.defineProperty(exports, '__esModule', {
+  value: true
+})
+exports.default = void 0
+var _ArrayElement = _interopRequireDefault(require('./ArrayElement'))
+var _ArrayIterator = _interopRequireDefault(require('../../recipes/ArrayIterator'))
+function _interopRequireDefault (obj) { return obj && obj.__esModule ? obj : { default: obj } }
+/**
+ * @file arrayable list.
+ * @author Joshua Heagle <joshuaheagle@gmail.com>
+ * @version 1.1.0
+ * @memberOf module:collect-your-stuff
+ */
+
+/**
+ * Arrayable represents a collection stored as an array.
+ */
+class Arrayable {
+  /**
+   * Create the new Arrayable instance, configure the Arrayable class.
+   */
+  constructor () {
+    const elementClass = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : _ArrayElement.default
+    this.classType = Arrayable
+    this.innerList = []
+    this.initialized = false
+    this.elementClass = elementClass
+  }
+
+  /**
+   * Initialize the inner list, should only run once.
+   * @param {Array<ArrayElement>} initialList Give the array of elements to start in this Arrayable.
+   * @return {Arrayable}
+   */
+  initialize (initialList) {
+    if (this.initialized) {
+      console.warn('Attempt to initialize non-empty list.')
+      return this
+    }
+    this.initialized = true
+    this.innerList = initialList
+    return this
+  }
+
+  /**
+   * Retrieve a copy of the innerList used.
+   * @returns {Array<ArrayElement>}
+   */
+  get list () {
+    return this.innerList
+  }
+
+  /**
+   * Retrieve the first Element from the Arrayable
+   * @returns {ArrayElement}
+   */
+  get first () {
+    return this.innerList[0]
+  }
+
+  /**
+   * Retrieve the last Element from the Arrayable
+   * @returns {ArrayElement}
+   */
+  get last () {
+    return this.innerList[this.length - 1]
+  }
+
+  /**
+   * Return the length of the list.
+   * @returns {number}
+   */
+  get length () {
+    return this.innerList.length
+  }
+
+  /**
+   * Insert a new node (or data) after a node.
+   * @param {ArrayElement|*} node The existing node as reference
+   * @param {ArrayElement|*} newNode The new node to go after the existing node
+   * @returns {Arrayable}
+   */
+  insertAfter (node, newNode) {
+    const insertAt = this.innerList.indexOf(node)
+    this.innerList.splice(insertAt + 1, 0, this.elementClass.make(newNode))
+    return this
+  }
+
+  /**
+   * Insert a new node (or data) before a node.
+   * @param {ArrayElement|*} node The existing node as reference
+   * @param {ArrayElement|*} newNode The new node to go before the existing node
+   * @returns {Arrayable}
+   */
+  insertBefore (node, newNode) {
+    const insertAt = this.innerList.indexOf(node)
+    this.innerList.splice(insertAt, 0, this.elementClass.make(newNode))
+    return this
+  }
+
+  /**
+   * Add a node (or data) after the given (or last) node in the list.
+   * @param {ArrayElement|*} node The new node to add to the end of the list
+   * @param {ArrayElement} after The existing last node
+   * @returns {Arrayable}
+   */
+  append (node) {
+    const after = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : this.last
+    return this.insertAfter(after, node)
+  }
+
+  /**
+   * Add a node (or data) before the given (or first) node in the list.
+   * @param {ArrayElement|*} node The new node to add to the start of the list
+   * @param {ArrayElement} before The existing first node
+   * @returns {Arrayable}
+   */
+  prepend (node) {
+    const before = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : this.first
+    return this.insertBefore(before, node)
+  }
+
+  /**
+   * Remove an element from this arrayable.
+   * @param {ArrayElement} node The node we wish to remove (and it will be returned after removal)
+   * @return {ArrayElement}
+   */
+  remove (node) {
+    const deleteAt = this.innerList.indexOf(node)
+    this.innerList.splice(deleteAt, 1)
+    return node
+  }
+
+  /**
+   * Retrieve an ArrayElement item from this list by numeric index, otherwise return null.
+   * @param {number} index The integer number for retrieving a node by position.
+   * @return {ArrayElement|null}
+   */
+  item (index) {
+    if (index >= this.length) {
+      // index is beyond array limit
+      return null
+    }
+    if (index >= 0) {
+      // use the positive index at nth position from the beginning of the array
+      return this.innerList[index]
+    }
+    const calculatedIndex = this.length + index
+    if (calculatedIndex < 0) {
+      // negative index is beyond array limit (minus direction)
+      return null
+    }
+    // Return the item at nth position from the end of the array
+    return this.innerList[calculatedIndex]
+  }
+
+  /**
+   * Be able to run forEach on this Arrayable to iterate over the elements.
+   * @param {forEachCallback} callback The function to call for-each element
+   * @param {Arrayable} thisArg Optional, 'this' reference
+   * @returns {Arrayable}
+   */
+  forEach (callback) {
+    const thisArg = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : this
+    for (let i = 0; i < thisArg.length; ++i) {
+      callback(thisArg.item(i), i, thisArg)
+    }
+    return thisArg
+  }
+
+  /**
+   * Be able to iterate over this class.
+   * @returns {Iterator}
+   */
+  [Symbol.iterator] () {
+    const index = 0
+    return new _ArrayIterator.default(this.innerList, index)
+  }
+}
+/**
+ * Convert an array to an Arrayable.
+ * @param {Array} values An array of values which will be converted to elements in this arrayable
+ * @param {IsElement} [elementClass=ArrayElement] The class to use for each element
+ * @param {IsArrayable<ArrayElement>} [classType=Arrayable] Provide the type of IsArrayable to use.
+ * @returns {Arrayable}
+ */
+Arrayable.fromArray = function () {
+  const values = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : []
+  const elementClass = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : _ArrayElement.default
+  const classType = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : Arrayable
+  const list = new classType(elementClass)
+  return list.initialize(elementClass.fromArray(values).head)
+}
+var _default = exports.default = Arrayable

package/dist/collections/arrayable/Arrayable.min.js

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:!0}),exports.default=void 0;var _ArrayElement=_interopRequireDefault(require("./ArrayElement")),_ArrayIterator=_interopRequireDefault(require("../../recipes/ArrayIterator"));function _interopRequireDefault(t){return t&&t.__esModule?t:{default:t}}class Arrayable{constructor(){this.classType=Arrayable,this.innerList=[],this.initialized=!1,this.initialized=!1}initialize(t){return this.initialized?(console.warn("Attempt to initialize non-empty list."),this):(this.initialized=!0,this.innerList=t,this)}get list(){return this.innerList}get first(){return this.innerList[0]}get last(){return this.innerList[this.length-1]}get length(){return this.innerList.length}insertAfter(t,e){const i=this.innerList.indexOf(t);return this.innerList.splice(i+1,0,t.classType.make(e)),this}insertBefore(t,e){const i=this.innerList.indexOf(t);return this.innerList.splice(i,0,t.classType.make(e)),this}append(t){let e=arguments.length>1&&void 0!==arguments[1]?arguments[1]:this.last;return this.insertAfter(e,t)}prepend(t){let e=arguments.length>1&&void 0!==arguments[1]?arguments[1]:this.first;return this.insertBefore(e,t)}remove(t){const e=this.innerList.indexOf(t);return this.innerList.splice(e,1),t}item(t){if(t>=this.length)return null;if(t>=0)return this.innerList[t];const e=this.length+t;return e<0?null:this.innerList[e]}forEach(t){let e=arguments.length>1&&void 0!==arguments[1]?arguments[1]:this;for(let i=0;i<e.length;++i)t(e.item(i),i,e);return e}[Symbol.iterator](){return new _ArrayIterator.default(this.innerList,0)}}Arrayable.fromArray=function(){let t=arguments.length>0&&void 0!==arguments[0]?arguments[0]:[],e=arguments.length>1&&void 0!==arguments[1]?arguments[1]:_ArrayElement.default;return(new(arguments.length>2&&void 0!==arguments[2]?arguments[2]:Arrayable)).initialize(e.fromArray(t).head)};var _default=exports.default=Arrayable;
+"use strict";Object.defineProperty(exports,"__esModule",{value:!0}),exports.default=void 0;var _ArrayElement=_interopRequireDefault(require("./ArrayElement")),_ArrayIterator=_interopRequireDefault(require("../../recipes/ArrayIterator"));function _interopRequireDefault(e){return e&&e.__esModule?e:{default:e}}class Arrayable{constructor(){let e=arguments.length>0&&void 0!==arguments[0]?arguments[0]:_ArrayElement.default;this.classType=Arrayable,this.innerList=[],this.initialized=!1,this.elementClass=e}initialize(e){return this.initialized?(console.warn("Attempt to initialize non-empty list."),this):(this.initialized=!0,this.innerList=e,this)}get list(){return this.innerList}get first(){return this.innerList[0]}get last(){return this.innerList[this.length-1]}get length(){return this.innerList.length}insertAfter(e,t){const i=this.innerList.indexOf(e);return this.innerList.splice(i+1,0,this.elementClass.make(t)),this}insertBefore(e,t){const i=this.innerList.indexOf(e);return this.innerList.splice(i,0,this.elementClass.make(t)),this}append(e){let t=arguments.length>1&&void 0!==arguments[1]?arguments[1]:this.last;return this.insertAfter(t,e)}prepend(e){let t=arguments.length>1&&void 0!==arguments[1]?arguments[1]:this.first;return this.insertBefore(t,e)}remove(e){const t=this.innerList.indexOf(e);return this.innerList.splice(t,1),e}item(e){if(e>=this.length)return null;if(e>=0)return this.innerList[e];const t=this.length+e;return t<0?null:this.innerList[t]}forEach(e){let t=arguments.length>1&&void 0!==arguments[1]?arguments[1]:this;for(let i=0;i<t.length;++i)e(t.item(i),i,t);return t}[Symbol.iterator](){return new _ArrayIterator.default(this.innerList,0)}}Arrayable.fromArray=function(){let e=arguments.length>0&&void 0!==arguments[0]?arguments[0]:[],t=arguments.length>1&&void 0!==arguments[1]?arguments[1]:_ArrayElement.default;return new(arguments.length>2&&void 0!==arguments[2]?arguments[2]:Arrayable)(t).initialize(t.fromArray(e).head)};var _default=exports.default=Arrayable;

package/dist/collections/doubly-linked-list/DoubleLinker.d.ts

@@ -1,47 +1,47 @@
-/**
- * @file doubly linked list item.
- * @author Joshua Heagle <joshuaheagle@gmail.com>
- * @version 1.1.0
- * @memberOf module:collect-your-stuff
- */
-import IsDoubleLinker from '../../recipes/IsDoubleLinker';
-/**
- * DoubleLinker represents a node in a DoublyLinkedList which is chained by next and prev.
- * @extends Linker
- */
-declare class DoubleLinker implements IsDoubleLinker {
-    readonly classType: typeof DoubleLinker;
-    data: any;
-    next: DoubleLinker | null;
-    prev: DoubleLinker | null;
-    /**
-     * Create the new DoubleLinker instance, provide the data and optionally the next and prev references.
-     * @param {Object} [nodeData={}]
-     * @param {*} [nodeData.data=null] The data to be stored in this linker
-     * @param {DoubleLinker|null} [nodeData.next=null] The reference to the next linker if any
-     * @param {DoubleLinker|null} [nodeData.prev=null] The reference to the previous linker if any
-     */
-    constructor({ data, next, prev }?: {
-        data?: any;
-        next?: DoubleLinker | null;
-        prev?: DoubleLinker | null;
-    });
-    /**
-     * Make a new DoubleLinker from the data given if it is not already a valid Linker.
-     * @param {DoubleLinker|*} linker Return a valid Linker instance from given data, or even an already valid one.
-     * @param {IsDoubleLinker} [classType=DoubleLinker] Provide the type of IsDoubleLinker to use.
-     * @return {DoubleLinker}
-     */
-    static make: (linker: DoubleLinker | any, classType?: any) => IsDoubleLinker | any;
-    /**
-     * Convert an array into DoubleLinker instances, return the head and tail DoubleLinkers.
-     * @param {Array} [values=[]] Provide an array of data that will be converted to a chain of linkers.
-     * @param {IsDoubleLinker} [classType=DoubleLinker] Provide the type of IsDoubleLinker to use.
-     * @returns {{head: DoubleLinker, tail: DoubleLinker}}
-     */
-    static fromArray: (values?: Array<any>, classType?: any) => {
-        head: DoubleLinker | any;
-        tail: DoubleLinker | any;
-    };
-}
-export default DoubleLinker;
+/**
+ * @file doubly linked list item.
+ * @author Joshua Heagle <joshuaheagle@gmail.com>
+ * @version 1.1.0
+ * @memberOf module:collect-your-stuff
+ */
+import IsDoubleLinker from '../../recipes/IsDoubleLinker';
+/**
+ * DoubleLinker represents a node in a DoublyLinkedList which is chained by next and prev.
+ * @extends Linker
+ */
+declare class DoubleLinker implements IsDoubleLinker {
+    readonly classType: typeof DoubleLinker;
+    data: any;
+    next: DoubleLinker | null;
+    prev: DoubleLinker | null;
+    /**
+     * Create the new DoubleLinker instance, provide the data and optionally the next and prev references.
+     * @param {Object} [nodeData={}]
+     * @param {*} [nodeData.data=null] The data to be stored in this linker
+     * @param {DoubleLinker|null} [nodeData.next=null] The reference to the next linker if any
+     * @param {DoubleLinker|null} [nodeData.prev=null] The reference to the previous linker if any
+     */
+    constructor({ data, next, prev }?: {
+        data?: any;
+        next?: DoubleLinker | null;
+        prev?: DoubleLinker | null;
+    });
+    /**
+     * Make a new DoubleLinker from the data given if it is not already a valid Linker.
+     * @param {DoubleLinker|*} linker Return a valid Linker instance from given data, or even an already valid one.
+     * @param {IsDoubleLinker} [classType=DoubleLinker] Provide the type of IsDoubleLinker to use.
+     * @return {DoubleLinker}
+     */
+    static make: (linker: DoubleLinker | any, classType?: any) => IsDoubleLinker | any;
+    /**
+     * Convert an array into DoubleLinker instances, return the head and tail DoubleLinkers.
+     * @param {Array} [values=[]] Provide an array of data that will be converted to a chain of linkers.
+     * @param {IsDoubleLinker} [classType=DoubleLinker] Provide the type of IsDoubleLinker to use.
+     * @returns {{head: DoubleLinker, tail: DoubleLinker}}
+     */
+    static fromArray: (values?: Array<any>, classType?: any) => {
+        head: DoubleLinker | any;
+        tail: DoubleLinker | any;
+    };
+}
+export default DoubleLinker;