@barchart/portfolio-api-common 1.0.185 → 1.0.189

package/lib/processing/PositionContainer.js

@@ -248,7 +248,7 @@ module.exports = (() => {
 					addSummaryPrevious(this._summariesPrevious, summary, this._previousSummaryFrame, this._previousSummaryRanges);
 				});
 
-				const item = createPositionItem(position);
+				const item = createPositionItem.call(this, position);
 
 				addBarchartSymbol(this._symbols, item);
 				addDisplaySymbol(this._symbolsDisplay, item);
@@ -262,13 +262,13 @@ module.exports = (() => {
 					let groupTree;
 
 					if (parentTree.getChildren().length > 0) {
-						groupTree = parentTree.getChildren().findChild(childGroup => childGroup.key === levelKey) || null;
+						groupTree = parentTree.findChild(childGroup => childGroup.key === levelKey) || null;
 					} else {
 						groupTree = null;
 					}
 
 					if (groupTree !== null) {
-						groupTree.addItem(item);
+						groupTree.getValue().addItem(item);
 
 						createGroupOrInjectItem(groupTree, treeDefinition, array.dropLeft(levelDefinitions));
 					} else {

package/lib/processing/PositionGroup.js

@@ -60,7 +60,7 @@ module.exports = (() => {
 
 			this._excludedItems = [ ];
 			this._excludedItemMap = { };
-			this._consideredItems = this._items;
+			this._consideredItems = this._items.slice(0);
 
 			this._dataFormat = { };
 			this._dataActual = { };
@@ -149,75 +149,7 @@ module.exports = (() => {
 			this._dataFormat.portfolioType = null;
 
 			this._items.forEach((item) => {
-				const quoteBinding = item.registerQuoteChangeHandler((quote, sender) => {
-					if (this._single) {
-						const precision = sender.position.instrument.currency.precision;
-
-						this._dataActual.currentPrice = quote.lastPrice;
-						this._dataFormat.currentPrice = formatNumber(this._dataActual.currentPrice, precision);
-
-						this._dataActual.quoteLast = quote.previousPrice;
-						this._dataActual.quoteOpen = quote.openPrice;
-						this._dataActual.quoteHigh = quote.highPrice;
-						this._dataActual.quoteLow = quote.lowPrice;
-						this._dataActual.quoteChange = quote.priceChange;
-						this._dataActual.quoteChangePercent = quote.percentChange;
-						this._dataActual.quoteTime = quote.timeDisplay;
-						this._dataActual.quoteVolume = quote.volume;
-
-						this._dataFormat.quoteLast = formatNumber(this._dataActual.quoteLast , precision);
-						this._dataFormat.quoteOpen = formatNumber(this._dataActual.quoteOpen, precision);
-						this._dataFormat.quoteHigh = formatNumber(this._dataActual.quoteHigh, precision);
-						this._dataFormat.quoteLow = formatNumber(this._dataActual.quoteLow, precision);
-						this._dataFormat.quoteChange = formatNumber(this._dataActual.quoteChange, precision);
-						this._dataFormat.quoteChangePercent = formatPercent(new Decimal(this._dataActual.quoteChangePercent || 0), 2);
-						this._dataFormat.quoteTime = this._dataActual.quoteTime;
-						this._dataFormat.quoteVolume = formatNumber(this._dataActual.quoteVolume, 0);
-
-						const quoteChangePositive = quote.lastPriceDirection === 'up';
-						const quoteChangeNegative = quote.lastPriceDirection === 'down';
-
-						setTimeout(() => this._dataFormat.quoteChangeDirection = { up: quoteChangePositive, down: quoteChangeNegative }, 0);
-						this._dataFormat.quoteChangeNegative = quoteChangeNegative;
-					} else {
-						this._dataActual.currentPrice = null;
-						this._dataFormat.currentPrice = null;
-					}
-
-					calculatePriceData(this, this._container.getForexQuotes(), sender, false);
-				});
-
-				let newsBinding = Disposable.getEmpty();
-				let fundamentalBinding = Disposable.getEmpty();
-
-				if (this._single) {
-					newsBinding = item.registerNewsExistsChangeHandler((exists, sender) => {
-						this._dataActual.newsExists = exists;
-						this._dataFormat.newsExists = exists;
-					});
-
-					fundamentalBinding = item.registerFundamentalDataChangeHandler((data, sender) => {
-						this._dataFormat.fundamental = data;
-					});
-				}
-
-				this._disposeStack.push(quoteBinding);
-				this._disposeStack.push(newsBinding);
-				this._disposeStack.push(fundamentalBinding);
-
-				this._disposeStack.push(item.registerPositionItemDisposeHandler(() => {
-					quoteBinding.dispose();
-					newsBinding.dispose();
-					fundamentalBinding.dispose();
-
-					array.remove(this._items, i => i === item);
-					array.remove(this._excludedItems, i => i === item);
-					array.remove(this._consideredItems, i => i === item);
-
-					delete this._excludedItemMap[item.position.position];
-
-					this.refresh();
-				}));
+				bindItem.call(this, item);
 			});
 
 			this.refresh();
@@ -335,6 +267,10 @@ module.exports = (() => {
 		 * @param {PositionItem} item
 		 */
 		addItem(item) {
+			this._items.push(item);
+			this._consideredItems.push(item);
+
+			bindItem.call(this, item);
 
 			this.refresh();
 		}
@@ -468,6 +404,79 @@ module.exports = (() => {
 		}
 	}
 
+	function bindItem(item) {
+		const quoteBinding = item.registerQuoteChangeHandler((quote, sender) => {
+			if (this._single) {
+				const precision = sender.position.instrument.currency.precision;
+
+				this._dataActual.currentPrice = quote.lastPrice;
+				this._dataFormat.currentPrice = formatNumber(this._dataActual.currentPrice, precision);
+
+				this._dataActual.quoteLast = quote.previousPrice;
+				this._dataActual.quoteOpen = quote.openPrice;
+				this._dataActual.quoteHigh = quote.highPrice;
+				this._dataActual.quoteLow = quote.lowPrice;
+				this._dataActual.quoteChange = quote.priceChange;
+				this._dataActual.quoteChangePercent = quote.percentChange;
+				this._dataActual.quoteTime = quote.timeDisplay;
+				this._dataActual.quoteVolume = quote.volume;
+
+				this._dataFormat.quoteLast = formatNumber(this._dataActual.quoteLast , precision);
+				this._dataFormat.quoteOpen = formatNumber(this._dataActual.quoteOpen, precision);
+				this._dataFormat.quoteHigh = formatNumber(this._dataActual.quoteHigh, precision);
+				this._dataFormat.quoteLow = formatNumber(this._dataActual.quoteLow, precision);
+				this._dataFormat.quoteChange = formatNumber(this._dataActual.quoteChange, precision);
+				this._dataFormat.quoteChangePercent = formatPercent(new Decimal(this._dataActual.quoteChangePercent || 0), 2);
+				this._dataFormat.quoteTime = this._dataActual.quoteTime;
+				this._dataFormat.quoteVolume = formatNumber(this._dataActual.quoteVolume, 0);
+
+				const quoteChangePositive = quote.lastPriceDirection === 'up';
+				const quoteChangeNegative = quote.lastPriceDirection === 'down';
+
+				setTimeout(() => this._dataFormat.quoteChangeDirection = { up: quoteChangePositive, down: quoteChangeNegative }, 0);
+
+				this._dataFormat.quoteChangeNegative = is.number(this._dataActual.quoteChange) && this._dataActual.quoteChange < 0;
+			} else {
+				this._dataActual.currentPrice = null;
+				this._dataFormat.currentPrice = null;
+			}
+
+			calculatePriceData(this, this._container.getForexQuotes(), sender, false);
+		});
+
+		let newsBinding = Disposable.getEmpty();
+		let fundamentalBinding = Disposable.getEmpty();
+
+		if (this._single) {
+			newsBinding = item.registerNewsExistsChangeHandler((exists, sender) => {
+				this._dataActual.newsExists = exists;
+				this._dataFormat.newsExists = exists;
+			});
+
+			fundamentalBinding = item.registerFundamentalDataChangeHandler((data, sender) => {
+				this._dataFormat.fundamental = data;
+			});
+		}
+
+		this._disposeStack.push(quoteBinding);
+		this._disposeStack.push(newsBinding);
+		this._disposeStack.push(fundamentalBinding);
+
+		this._disposeStack.push(item.registerPositionItemDisposeHandler(() => {
+			quoteBinding.dispose();
+			newsBinding.dispose();
+			fundamentalBinding.dispose();
+
+			array.remove(this._items, i => i === item);
+			array.remove(this._excludedItems, i => i === item);
+			array.remove(this._consideredItems, i => i === item);
+
+			delete this._excludedItemMap[item.position.position];
+
+			this.refresh();
+		}));
+	}
+
 	function formatNumber(number, precision) {
 		if (is.number(number)) {
 			return formatter.numberToString(number, precision, ',', false);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@barchart/portfolio-api-common",
-  "version": "1.0.185",
+  "version": "1.0.189",
   "description": "Common classes used by the Portfolio system",
   "author": {
     "name": "Bryan Ingle",

package/test/SpecRunner.js

@@ -1,4 +1,4 @@
-(function(){function e(t,n,r){function s(o,u){if(!n[o]){if(!t[o]){var a=typeof require=="function"&&require;if(!u&&a)return a(o,!0);if(i)return i(o,!0);var f=new Error("Cannot find module '"+o+"'");throw f.code="MODULE_NOT_FOUND",f}var l=n[o]={exports:{}};t[o][0].call(l.exports,function(e){var n=t[o][1][e];return s(n?n:e)},l,l.exports,e,t,n,r)}return n[o].exports}var i=typeof require=="function"&&require;for(var o=0;o<r.length;o++)s(r[o]);return s}return e})()({1:[function(require,module,exports){
+(function(){function r(e,n,t){function o(i,f){if(!n[i]){if(!e[i]){var c="function"==typeof require&&require;if(!f&&c)return c(i,!0);if(u)return u(i,!0);var a=new Error("Cannot find module '"+i+"'");throw a.code="MODULE_NOT_FOUND",a}var p=n[i]={exports:{}};e[i][0].call(p.exports,function(r){var n=e[i][1][r];return o(n||r)},p,p.exports,r,e,n,t)}return n[i].exports}for(var u="function"==typeof require&&require,i=0;i<t.length;i++)o(t[i]);return o}return r})()({1:[function(require,module,exports){
 const assert = require('@barchart/common-js/lang/assert'),
 	Enum = require('@barchart/common-js/lang/Enum');
 
@@ -964,7 +964,7 @@ module.exports = (() => {
 					addSummaryPrevious(this._summariesPrevious, summary, this._previousSummaryFrame, this._previousSummaryRanges);
 				});
 
-				const item = createPositionItem(position);
+				const item = createPositionItem.call(this, position);
 
 				addBarchartSymbol(this._symbols, item);
 				addDisplaySymbol(this._symbolsDisplay, item);
@@ -978,13 +978,13 @@ module.exports = (() => {
 					let groupTree;
 
 					if (parentTree.getChildren().length > 0) {
-						groupTree = parentTree.getChildren().findChild(childGroup => childGroup.key === levelKey) || null;
+						groupTree = parentTree.findChild(childGroup => childGroup.key === levelKey) || null;
 					} else {
 						groupTree = null;
 					}
 
 					if (groupTree !== null) {
-						groupTree.addItem(item);
+						groupTree.getValue().addItem(item);
 
 						createGroupOrInjectItem(groupTree, treeDefinition, array.dropLeft(levelDefinitions));
 					} else {
@@ -1588,7 +1588,7 @@ module.exports = (() => {
 
 			this._excludedItems = [ ];
 			this._excludedItemMap = { };
-			this._consideredItems = this._items;
+			this._consideredItems = this._items.slice(0);
 
 			this._dataFormat = { };
 			this._dataActual = { };
@@ -1677,75 +1677,7 @@ module.exports = (() => {
 			this._dataFormat.portfolioType = null;
 
 			this._items.forEach((item) => {
-				const quoteBinding = item.registerQuoteChangeHandler((quote, sender) => {
-					if (this._single) {
-						const precision = sender.position.instrument.currency.precision;
-
-						this._dataActual.currentPrice = quote.lastPrice;
-						this._dataFormat.currentPrice = formatNumber(this._dataActual.currentPrice, precision);
-
-						this._dataActual.quoteLast = quote.previousPrice;
-						this._dataActual.quoteOpen = quote.openPrice;
-						this._dataActual.quoteHigh = quote.highPrice;
-						this._dataActual.quoteLow = quote.lowPrice;
-						this._dataActual.quoteChange = quote.priceChange;
-						this._dataActual.quoteChangePercent = quote.percentChange;
-						this._dataActual.quoteTime = quote.timeDisplay;
-						this._dataActual.quoteVolume = quote.volume;
-
-						this._dataFormat.quoteLast = formatNumber(this._dataActual.quoteLast , precision);
-						this._dataFormat.quoteOpen = formatNumber(this._dataActual.quoteOpen, precision);
-						this._dataFormat.quoteHigh = formatNumber(this._dataActual.quoteHigh, precision);
-						this._dataFormat.quoteLow = formatNumber(this._dataActual.quoteLow, precision);
-						this._dataFormat.quoteChange = formatNumber(this._dataActual.quoteChange, precision);
-						this._dataFormat.quoteChangePercent = formatPercent(new Decimal(this._dataActual.quoteChangePercent || 0), 2);
-						this._dataFormat.quoteTime = this._dataActual.quoteTime;
-						this._dataFormat.quoteVolume = formatNumber(this._dataActual.quoteVolume, 0);
-
-						const quoteChangePositive = quote.lastPriceDirection === 'up';
-						const quoteChangeNegative = quote.lastPriceDirection === 'down';
-
-						setTimeout(() => this._dataFormat.quoteChangeDirection = { up: quoteChangePositive, down: quoteChangeNegative }, 0);
-						this._dataFormat.quoteChangeNegative = quoteChangeNegative;
-					} else {
-						this._dataActual.currentPrice = null;
-						this._dataFormat.currentPrice = null;
-					}
-
-					calculatePriceData(this, this._container.getForexQuotes(), sender, false);
-				});
-
-				let newsBinding = Disposable.getEmpty();
-				let fundamentalBinding = Disposable.getEmpty();
-
-				if (this._single) {
-					newsBinding = item.registerNewsExistsChangeHandler((exists, sender) => {
-						this._dataActual.newsExists = exists;
-						this._dataFormat.newsExists = exists;
-					});
-
-					fundamentalBinding = item.registerFundamentalDataChangeHandler((data, sender) => {
-						this._dataFormat.fundamental = data;
-					});
-				}
-
-				this._disposeStack.push(quoteBinding);
-				this._disposeStack.push(newsBinding);
-				this._disposeStack.push(fundamentalBinding);
-
-				this._disposeStack.push(item.registerPositionItemDisposeHandler(() => {
-					quoteBinding.dispose();
-					newsBinding.dispose();
-					fundamentalBinding.dispose();
-
-					array.remove(this._items, i => i === item);
-					array.remove(this._excludedItems, i => i === item);
-					array.remove(this._consideredItems, i => i === item);
-
-					delete this._excludedItemMap[item.position.position];
-
-					this.refresh();
-				}));
+				bindItem.call(this, item);
 			});
 
 			this.refresh();
@@ -1863,6 +1795,10 @@ module.exports = (() => {
 		 * @param {PositionItem} item
 		 */
 		addItem(item) {
+			this._items.push(item);
+			this._consideredItems.push(item);
+
+			bindItem.call(this, item);
 
 			this.refresh();
 		}
@@ -1996,6 +1932,79 @@ module.exports = (() => {
 		}
 	}
 
+	function bindItem(item) {
+		const quoteBinding = item.registerQuoteChangeHandler((quote, sender) => {
+			if (this._single) {
+				const precision = sender.position.instrument.currency.precision;
+
+				this._dataActual.currentPrice = quote.lastPrice;
+				this._dataFormat.currentPrice = formatNumber(this._dataActual.currentPrice, precision);
+
+				this._dataActual.quoteLast = quote.previousPrice;
+				this._dataActual.quoteOpen = quote.openPrice;
+				this._dataActual.quoteHigh = quote.highPrice;
+				this._dataActual.quoteLow = quote.lowPrice;
+				this._dataActual.quoteChange = quote.priceChange;
+				this._dataActual.quoteChangePercent = quote.percentChange;
+				this._dataActual.quoteTime = quote.timeDisplay;
+				this._dataActual.quoteVolume = quote.volume;
+
+				this._dataFormat.quoteLast = formatNumber(this._dataActual.quoteLast , precision);
+				this._dataFormat.quoteOpen = formatNumber(this._dataActual.quoteOpen, precision);
+				this._dataFormat.quoteHigh = formatNumber(this._dataActual.quoteHigh, precision);
+				this._dataFormat.quoteLow = formatNumber(this._dataActual.quoteLow, precision);
+				this._dataFormat.quoteChange = formatNumber(this._dataActual.quoteChange, precision);
+				this._dataFormat.quoteChangePercent = formatPercent(new Decimal(this._dataActual.quoteChangePercent || 0), 2);
+				this._dataFormat.quoteTime = this._dataActual.quoteTime;
+				this._dataFormat.quoteVolume = formatNumber(this._dataActual.quoteVolume, 0);
+
+				const quoteChangePositive = quote.lastPriceDirection === 'up';
+				const quoteChangeNegative = quote.lastPriceDirection === 'down';
+
+				setTimeout(() => this._dataFormat.quoteChangeDirection = { up: quoteChangePositive, down: quoteChangeNegative }, 0);
+
+				this._dataFormat.quoteChangeNegative = is.number(this._dataActual.quoteChange) && this._dataActual.quoteChange < 0;
+			} else {
+				this._dataActual.currentPrice = null;
+				this._dataFormat.currentPrice = null;
+			}
+
+			calculatePriceData(this, this._container.getForexQuotes(), sender, false);
+		});
+
+		let newsBinding = Disposable.getEmpty();
+		let fundamentalBinding = Disposable.getEmpty();
+
+		if (this._single) {
+			newsBinding = item.registerNewsExistsChangeHandler((exists, sender) => {
+				this._dataActual.newsExists = exists;
+				this._dataFormat.newsExists = exists;
+			});
+
+			fundamentalBinding = item.registerFundamentalDataChangeHandler((data, sender) => {
+				this._dataFormat.fundamental = data;
+			});
+		}
+
+		this._disposeStack.push(quoteBinding);
+		this._disposeStack.push(newsBinding);
+		this._disposeStack.push(fundamentalBinding);
+
+		this._disposeStack.push(item.registerPositionItemDisposeHandler(() => {
+			quoteBinding.dispose();
+			newsBinding.dispose();
+			fundamentalBinding.dispose();
+
+			array.remove(this._items, i => i === item);
+			array.remove(this._excludedItems, i => i === item);
+			array.remove(this._consideredItems, i => i === item);
+
+			delete this._excludedItemMap[item.position.position];
+
+			this.refresh();
+		}));
+	}
+
 	function formatNumber(number, precision) {
 		if (is.number(number)) {
 			return formatter.numberToString(number, precision, ',', false);
@@ -3343,6 +3352,23 @@ module.exports = function () {
 				}
 			}
 
+			/**
+    * Removes the current node from the parent tree. Use on a root node
+    * has no effect.
+    *
+    * @public
+    */
+
+		}, {
+			key: 'sever',
+			value: function sever() {
+				if (this.getIsRoot()) {
+					return;
+				}
+
+				this.getParent().removeChild(this);
+			}
+
 			/**
     * Searches the children nodes for the first child node that matches the
     * predicate.
@@ -3869,7 +3895,7 @@ module.exports = function () {
 	var Currency = function (_Enum) {
 		_inherits(Currency, _Enum);
 
-		function Currency(code, description, precision) {
+		function Currency(code, description, precision, alternateDescription) {
 			_classCallCheck(this, Currency);
 
 			var _this = _possibleConstructorReturn(this, (Currency.__proto__ || Object.getPrototypeOf(Currency)).call(this, code, description));
@@ -3877,7 +3903,11 @@ module.exports = function () {
 			assert.argumentIsRequired(precision, 'precision', Number);
 			assert.argumentIsValid(precision, 'precision', is.integer, 'is an integer');
 
+			assert.argumentIsOptional(alternateDescription, 'alternateDescription', String);
+
 			_this._precision = precision;
+
+			_this._alternateDescription = alternateDescription || description;
 			return _this;
 		}
 
@@ -3900,6 +3930,19 @@ module.exports = function () {
 				return this._precision;
 			}
 
+			/**
+    * An alternate human-readable description.
+    *
+    * @public
+    * @returns {String}
+    */
+
+		}, {
+			key: 'alternateDescription',
+			get: function get() {
+				return this._alternateDescription;
+			}
+
 			/**
     * Given a code, returns the enumeration item.
     *
@@ -3957,9 +4000,9 @@ module.exports = function () {
 		return Currency;
 	}(Enum);
 
-	var cad = new Currency('CAD', 'Canadian Dollar', 2);
-	var eur = new Currency('EUR', 'Euro', 2);
-	var usd = new Currency('USD', 'US Dollar', 2);
+	var cad = new Currency('CAD', 'Canadian Dollar', 2, 'CAD$');
+	var eur = new Currency('EUR', 'Euro', 2, 'EUR');
+	var usd = new Currency('USD', 'US Dollar', 2, 'US$');
 
 	return Currency;
 }();
@@ -4720,6 +4763,20 @@ module.exports = function () {
 				return this._big.gt(getBig(other));
 			}
 
+			/**
+    * Returns true if the current instance is greater than or equal to the value.
+    *
+    * @public
+    * @param {Decimal|Number|String} other - The value to compare.
+    * @returns {Boolean}
+    */
+
+		}, {
+			key: 'getIsGreaterThanOrEqual',
+			value: function getIsGreaterThanOrEqual(other) {
+				return this._big.gte(getBig(other));
+			}
+
 			/**
     * Returns true if the current instance is less than the value.
     *
@@ -4734,6 +4791,20 @@ module.exports = function () {
 				return this._big.lt(getBig(other));
 			}
 
+			/**
+    * Returns true if the current instance is less than or equal to the value.
+    *
+    * @public
+    * @param {Decimal|Number|String} other - The value to compare.
+    * @returns {Boolean}
+    */
+
+		}, {
+			key: 'getIsLessThanOrEqual',
+			value: function getIsLessThanOrEqual(other) {
+				return this._big.lte(getBig(other));
+			}
+
 			/**
     * Returns true if the current instance is equal to the value.
     *
@@ -4933,9 +5004,9 @@ module.exports = function () {
 				assert.argumentIsRequired(a, 'a', Decimal, 'Decimal');
 				assert.argumentIsRequired(b, 'b', Decimal, 'Decimal');
 
-				if (a._big.gt(b)) {
+				if (a._big.gt(b._big)) {
 					return 1;
-				} else if (a._big.lt(b)) {
+				} else if (a._big.lt(b._big)) {
 					return -1;
 				} else {
 					return 0;
@@ -5396,12 +5467,10 @@ var _createClass = function () { function defineProperties(target, props) { for
 function _classCallCheck(instance, Constructor) { if (!(instance instanceof Constructor)) { throw new TypeError("Cannot call a class as a function"); } }
 
 var assert = require('./assert'),
-    is = require('./is'),
     memoize = require('./memoize');
 
 var Currency = require('./Currency'),
-    Decimal = require('./Decimal'),
-    Enum = require('./Enum');
+    Decimal = require('./Decimal');
 
 module.exports = function () {
 	'use strict';
@@ -5581,12 +5650,7 @@ module.exports = function () {
 				assert.argumentIsRequired(amount, 'amount', Decimal, 'Decimal');
 				assert.argumentIsRequired(currency, 'currency', Currency, 'Currency');
 				assert.argumentIsRequired(desiredCurrency, 'desiredCurrency', Currency, 'Currency');
-
-				for (var _len = arguments.length, rates = Array(_len > 3 ? _len - 3 : 0), _key = 3; _key < _len; _key++) {
-					rates[_key - 3] = arguments[_key];
-				}
-
-				assert.argumentIsArray(rates, 'rates', Rate, 'Rate');
+				//assert.argumentIsArray(rates, 'rates', Rate, 'Rate');
 
 				var converted = void 0;
 
@@ -5596,6 +5660,10 @@ module.exports = function () {
 					var numerator = desiredCurrency;
 					var denominator = currency;
 
+					for (var _len = arguments.length, rates = Array(_len > 3 ? _len - 3 : 0), _key = 3; _key < _len; _key++) {
+						rates[_key - 3] = arguments[_key];
+					}
+
 					var rate = rates.find(function (r) {
 						return r.numerator === numerator && r.denominator === denominator || r.numerator === denominator && r.denominator === numerator;
 					});
@@ -5646,7 +5714,7 @@ module.exports = function () {
 	return Rate;
 }();
 
-},{"./Currency":15,"./Decimal":17,"./Enum":19,"./assert":22,"./is":24,"./memoize":25}],21:[function(require,module,exports){
+},{"./Currency":15,"./Decimal":17,"./assert":22,"./memoize":25}],21:[function(require,module,exports){
 'use strict';
 
 var assert = require('./assert'),
@@ -6023,6 +6091,26 @@ module.exports = function () {
 			});
 
 			return returnRef;
+		},
+
+
+		/**
+   * Removes the first item from an array which matches a predicate.
+   *
+   * @static
+   * @public
+   * @param {Array} a
+   * @param {Function} predicate
+   */
+		remove: function remove(a, predicate) {
+			assert.argumentIsArray(a, 'a');
+			assert.argumentIsRequired(predicate, 'predicate', Function);
+
+			var index = a.findIndex(predicate);
+
+			if (!(index < 0)) {
+				a.splice(index, 1);
+			}
 		}
 	};
 }();