si-funciona 2.3.3 → 2.4.0

package/dist/helpers/arrays/compareArrays.js

@@ -1,97 +1,97 @@
-'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.every.js')
-require('core-js/modules/esnext.iterator.map.js')
-require('core-js/modules/esnext.iterator.reduce.js')
-require('core-js/stable')
-var _isObject = _interopRequireDefault(require('../objects/isObject'))
-var _mergeArrays = _interopRequireDefault(require('./mergeArrays'))
-var _objectKeys = _interopRequireDefault(require('../objects/objectKeys'))
-function _interopRequireDefault (e) { return e && e.__esModule ? e : { default: e } }
-/**
- * Compare two Arrays and return the Object where the value for each property is as follows:
- * -1 to indicate val1 is less than val2
- * 0 to indicate both values are the equal
- * 1 to indicate val1 is greater than val2
- * The returned Object uses the element values as the property names
- * This functions works by first creating a concatenated array of all unique values. Then for each unique values,
- * convert to a string and use it as a new property name. Array filter each array checking if it has the unique value.
- * Use the lengths of these filtered arrays to compare. So if the first array has the value and the second one doesn't
- * the first length will be one or more and the second will be zero, if the both have the value then both will be one
- * or more.
- * @example
- * // example of input and resulting output
- * compareArrays(
- *   ['match1', 'firstMismatch1', 'match2', 'firstMismatch2', 'badMatch1'],
- *   ['match1', 'match2', 'secondMismatch1', 'badMatch1', 'badMatch1']
- * )
- * // unique array
- * ['match1', 'firstMismatch1', 'match2', 'firstMismatch2', 'badMatch1', 'secondMismatch1']
- * // result object
- * [
- *   {
- *     value: 'match1',
- *     keys: [[0], [0]],
- *     result: [0, 0]
- *   },
- *   {
- *     value: 'firstMismatch1',
- *     keys: [[1], []],
- *     result: [1, -1]
- *   },
- *   {
- *     value: 'match2',
- *     keys: [[2], [1]],
- *     result: [0, 0]
- *   },
- *   {
- *     value: 'firstMismatch2',
- *     keys: [[3], []],
- *     result: [1, -1]
- *   },
- *   {
- *     value: 'badMatch1',
- *     keys: [[4], [3, 4]],
- *     result: [0, 0]
- *   },
- *   {
- *     value: 'secondMismatch1',
- *     keys: [[], [2]],
- *     result: [-1, 1]
- *   }
- * ]
- *
- * @memberOf module:arrayHelpers
- * @param {...Array} arrays - The arrays to compare
- * @returns {Array.<module:arrayHelpers~compareArrayResult>}
- */
-const compareArrays = (...arrays) => (0, _mergeArrays.default)(...arrays).reduce((results, attr) => {
-  const attrType = typeof attr
-  const useArray = Array.isArray(attr)
-  const keys = arrays.map(array => array.reduce((results, current, key) => {
-    const currentType = typeof current
-    if (attrType !== currentType) {
-      return results
-    }
-    if (!(0, _isObject.default)(attr)) {
-      return current === attr ? [...results, key] : results
-    }
-    if (useArray !== Array.isArray(current)) {
-      return results
-    }
-    const compareKeys = useArray ? compareArrays(attr, current) : compareArrays((0, _objectKeys.default)(attr), (0, _objectKeys.default)(current))
-    return compareKeys.every(compare => compare.result.every(result => result === 0)) ? [...results, key] : results
-  }, []))
-  const arrayResults = keys.map(array => array.length ? 1 : -1)
-  return [...results, {
-    value: attr,
-    keys: keys,
-    result: arrayResults.every(result => result === 1) ? arrayResults.map(result => 0) : arrayResults
-  }]
-}, [])
-var _default = exports.default = compareArrays
+'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.every.js')
+require('core-js/modules/esnext.iterator.map.js')
+require('core-js/modules/esnext.iterator.reduce.js')
+require('core-js/stable')
+var _isObject = _interopRequireDefault(require('../objects/isObject'))
+var _mergeArrays = _interopRequireDefault(require('./mergeArrays'))
+var _objectKeys = _interopRequireDefault(require('../objects/objectKeys'))
+function _interopRequireDefault (e) { return e && e.__esModule ? e : { default: e } }
+/**
+ * Compare two Arrays and return the Object where the value for each property is as follows:
+ * -1 to indicate val1 is less than val2
+ * 0 to indicate both values are the equal
+ * 1 to indicate val1 is greater than val2
+ * The returned Object uses the element values as the property names
+ * This functions works by first creating a concatenated array of all unique values. Then for each unique values,
+ * convert to a string and use it as a new property name. Array filter each array checking if it has the unique value.
+ * Use the lengths of these filtered arrays to compare. So if the first array has the value and the second one doesn't
+ * the first length will be one or more and the second will be zero, if the both have the value then both will be one
+ * or more.
+ * @example
+ * // example of input and resulting output
+ * compareArrays(
+ *   ['match1', 'firstMismatch1', 'match2', 'firstMismatch2', 'badMatch1'],
+ *   ['match1', 'match2', 'secondMismatch1', 'badMatch1', 'badMatch1']
+ * )
+ * // unique array
+ * ['match1', 'firstMismatch1', 'match2', 'firstMismatch2', 'badMatch1', 'secondMismatch1']
+ * // result object
+ * [
+ *   {
+ *     value: 'match1',
+ *     keys: [[0], [0]],
+ *     result: [0, 0]
+ *   },
+ *   {
+ *     value: 'firstMismatch1',
+ *     keys: [[1], []],
+ *     result: [1, -1]
+ *   },
+ *   {
+ *     value: 'match2',
+ *     keys: [[2], [1]],
+ *     result: [0, 0]
+ *   },
+ *   {
+ *     value: 'firstMismatch2',
+ *     keys: [[3], []],
+ *     result: [1, -1]
+ *   },
+ *   {
+ *     value: 'badMatch1',
+ *     keys: [[4], [3, 4]],
+ *     result: [0, 0]
+ *   },
+ *   {
+ *     value: 'secondMismatch1',
+ *     keys: [[], [2]],
+ *     result: [-1, 1]
+ *   }
+ * ]
+ *
+ * @memberOf module:arrayHelpers
+ * @param {...Array} arrays - The arrays to compare
+ * @returns {Array.<module:arrayHelpers~compareArrayResult>}
+ */
+const compareArrays = (...arrays) => (0, _mergeArrays.default)(...arrays).reduce((results, attr) => {
+  const attrType = typeof attr
+  const useArray = Array.isArray(attr)
+  const keys = arrays.map(array => array.reduce((results, current, key) => {
+    const currentType = typeof current
+    if (attrType !== currentType) {
+      return results
+    }
+    if (!(0, _isObject.default)(attr)) {
+      return current === attr ? [...results, key] : results
+    }
+    if (useArray !== Array.isArray(current)) {
+      return results
+    }
+    const compareKeys = useArray ? compareArrays(attr, current) : compareArrays((0, _objectKeys.default)(attr), (0, _objectKeys.default)(current))
+    return compareKeys.every(compare => compare.result.every(result => result === 0)) ? [...results, key] : results
+  }, []))
+  const arrayResults = keys.map(array => array.length ? 1 : -1)
+  return [...results, {
+    value: attr,
+    keys: keys,
+    result: arrayResults.every(result => result === 1) ? arrayResults.map(result => 0) : arrayResults
+  }]
+}, [])
+var _default = exports.default = compareArrays

package/dist/helpers/arrays/mergeArrays.d.ts

@@ -1,10 +1,10 @@
-import 'core-js/stable';
-/**
- * Take multiple arrays and then filter all these into one unique array.
- * @memberOf module:arrayHelpers
- * @param {...Array} arrays - Provide multiple arrays to create one unique array
- * @returns {Array}
- */
-declare const mergeArrays: (...arrays: Array<Array<any>>) => Array<any>;
-export default mergeArrays;
+import 'core-js/stable';
+/**
+ * Take multiple arrays and then filter all these into one unique array.
+ * @memberOf module:arrayHelpers
+ * @param {...Array} arrays - Provide multiple arrays to create one unique array
+ * @returns {Array}
+ */
+declare const mergeArrays: (...arrays: Array<Array<any>>) => Array<any>;
+export default mergeArrays;
 //# sourceMappingURL=mergeArrays.d.ts.map

package/dist/helpers/arrays/mergeArrays.js

@@ -1,22 +1,22 @@
-'use strict'
-
-Object.defineProperty(exports, '__esModule', {
-  value: true
-})
-exports.default = void 0
-require('core-js/modules/es.array.includes.js')
-require('core-js/modules/esnext.iterator.constructor.js')
-require('core-js/modules/esnext.iterator.filter.js')
-require('core-js/modules/esnext.iterator.map.js')
-require('core-js/modules/esnext.iterator.reduce.js')
-require('core-js/stable')
-var _uniqueArray = _interopRequireDefault(require('./uniqueArray'))
-function _interopRequireDefault (e) { return e && e.__esModule ? e : { default: e } }
-/**
- * Take multiple arrays and then filter all these into one unique array.
- * @memberOf module:arrayHelpers
- * @param {...Array} arrays - Provide multiple arrays to create one unique array
- * @returns {Array}
- */
-const mergeArrays = (...arrays) => arrays.map(_uniqueArray.default).reduce((merged, arr) => [...merged, ...arr.filter(attr => !merged.includes(attr))], [])
-var _default = exports.default = mergeArrays
+'use strict'
+
+Object.defineProperty(exports, '__esModule', {
+  value: true
+})
+exports.default = void 0
+require('core-js/modules/es.array.includes.js')
+require('core-js/modules/esnext.iterator.constructor.js')
+require('core-js/modules/esnext.iterator.filter.js')
+require('core-js/modules/esnext.iterator.map.js')
+require('core-js/modules/esnext.iterator.reduce.js')
+require('core-js/stable')
+var _uniqueArray = _interopRequireDefault(require('./uniqueArray'))
+function _interopRequireDefault (e) { return e && e.__esModule ? e : { default: e } }
+/**
+ * Take multiple arrays and then filter all these into one unique array.
+ * @memberOf module:arrayHelpers
+ * @param {...Array} arrays - Provide multiple arrays to create one unique array
+ * @returns {Array}
+ */
+const mergeArrays = (...arrays) => arrays.map(_uniqueArray.default).reduce((merged, arr) => [...merged, ...arr.filter(attr => !merged.includes(attr))], [])
+var _default = exports.default = mergeArrays

package/dist/helpers/arrays/uniqueArray.d.ts

@@ -1,10 +1,10 @@
-import 'core-js/stable';
-/**
- * Remove duplicate values from an array. uniqueArray
- * @memberOf module:arrayHelpers
- * @param {Array} array - The array to make unique
- * @returns {Array}
- */
-declare const uniqueArray: (array: Array<any>) => Array<any>;
-export default uniqueArray;
+import 'core-js/stable';
+/**
+ * Remove duplicate values from an array. uniqueArray
+ * @memberOf module:arrayHelpers
+ * @param {Array} array - The array to make unique
+ * @returns {Array}
+ */
+declare const uniqueArray: (array: Array<any>) => Array<any>;
+export default uniqueArray;
 //# sourceMappingURL=uniqueArray.d.ts.map

package/dist/helpers/arrays/uniqueArray.js

@@ -1,17 +1,17 @@
-'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.filter.js')
-require('core-js/stable')
-/**
- * Remove duplicate values from an array. uniqueArray
- * @memberOf module:arrayHelpers
- * @param {Array} array - The array to make unique
- * @returns {Array}
- */
-const uniqueArray = array => array.filter((item, index) => array.indexOf(item) === index)
-var _default = exports.default = uniqueArray
+'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.filter.js')
+require('core-js/stable')
+/**
+ * Remove duplicate values from an array. uniqueArray
+ * @memberOf module:arrayHelpers
+ * @param {Array} array - The array to make unique
+ * @returns {Array}
+ */
+const uniqueArray = array => array.filter((item, index) => array.indexOf(item) === index)
+var _default = exports.default = uniqueArray

package/dist/helpers/arrays.d.ts

@@ -1,21 +1,22 @@
-/**
- * Some simple utility functions for generating arrays or performing work on arrays.
- * @file
- * @author Joshua Heagle <joshuaheagle@gmail.com>
- * @version 1.0.0
- * @module arrayHelpers
- * @memberOf module:siFunciona
- */
-import 'core-js/stable';
-import BasicQueue from './arrays/BasicQueue';
-declare const _default: {
-    addUniqueToArray: (item: any, array: Array<any>) => Array<any>;
-    BasicQueue: typeof BasicQueue;
-    buildArray: (item: any, length: number) => Array<any>;
-    buildArrayOfReferences: (item: any, length: number) => Array<any>;
-    compareArrays: (...arrays: Array<Array<any>>) => import("./arrays/compareArrays").compareArrayResultMap;
-    mergeArrays: (...arrays: Array<Array<any>>) => Array<any>;
-    uniqueArray: (array: Array<any>) => Array<any>;
-};
-export default _default;
+/**
+ * Utilities for building, merging, deduplicating and comparing arrays, plus a basic FIFO queue (BasicQueue) for
+ * use with functionHelpers' queueManager/queueTimeout.
+ * @file
+ * @author Joshua Heagle <joshuaheagle@gmail.com>
+ * @version 1.0.0
+ * @module arrayHelpers
+ * @memberOf module:siFunciona
+ */
+import 'core-js/stable';
+import BasicQueue from './arrays/BasicQueue';
+declare const _default: {
+    addUniqueToArray: (item: any, array: Array<any>) => Array<any>;
+    BasicQueue: typeof BasicQueue;
+    buildArray: (item: any, length: number) => Array<any>;
+    buildArrayOfReferences: (item: any, length: number) => Array<any>;
+    compareArrays: (...arrays: Array<Array<any>>) => import("./arrays/compareArrays").compareArrayResultMap;
+    mergeArrays: (...arrays: Array<Array<any>>) => Array<any>;
+    uniqueArray: (array: Array<any>) => Array<any>;
+};
+export default _default;
 //# sourceMappingURL=arrays.d.ts.map

package/dist/helpers/arrays.js

@@ -1,32 +1,33 @@
-'use strict'
-
-Object.defineProperty(exports, '__esModule', {
-  value: true
-})
-exports.default = void 0
-require('core-js/stable')
-var _addUniqueToArray = _interopRequireDefault(require('./arrays/addUniqueToArray'))
-var _BasicQueue = _interopRequireDefault(require('./arrays/BasicQueue'))
-var _buildArray = _interopRequireDefault(require('./arrays/buildArray'))
-var _buildArrayOfReferences = _interopRequireDefault(require('./arrays/buildArrayOfReferences'))
-var _compareArrays = _interopRequireDefault(require('./arrays/compareArrays'))
-var _mergeArrays = _interopRequireDefault(require('./arrays/mergeArrays'))
-var _uniqueArray = _interopRequireDefault(require('./arrays/uniqueArray'))
-function _interopRequireDefault (e) { return e && e.__esModule ? e : { default: e } }
-/**
- * Some simple utility functions for generating arrays or performing work on arrays.
- * @file
- * @author Joshua Heagle <joshuaheagle@gmail.com>
- * @version 1.0.0
- * @module arrayHelpers
- * @memberOf module:siFunciona
- */
-var _default = exports.default = {
-  addUniqueToArray: _addUniqueToArray.default,
-  BasicQueue: _BasicQueue.default,
-  buildArray: _buildArray.default,
-  buildArrayOfReferences: _buildArrayOfReferences.default,
-  compareArrays: _compareArrays.default,
-  mergeArrays: _mergeArrays.default,
-  uniqueArray: _uniqueArray.default
-}
+'use strict'
+
+Object.defineProperty(exports, '__esModule', {
+  value: true
+})
+exports.default = void 0
+require('core-js/stable')
+var _addUniqueToArray = _interopRequireDefault(require('./arrays/addUniqueToArray'))
+var _BasicQueue = _interopRequireDefault(require('./arrays/BasicQueue'))
+var _buildArray = _interopRequireDefault(require('./arrays/buildArray'))
+var _buildArrayOfReferences = _interopRequireDefault(require('./arrays/buildArrayOfReferences'))
+var _compareArrays = _interopRequireDefault(require('./arrays/compareArrays'))
+var _mergeArrays = _interopRequireDefault(require('./arrays/mergeArrays'))
+var _uniqueArray = _interopRequireDefault(require('./arrays/uniqueArray'))
+function _interopRequireDefault (e) { return e && e.__esModule ? e : { default: e } }
+/**
+ * Utilities for building, merging, deduplicating and comparing arrays, plus a basic FIFO queue (BasicQueue) for
+ * use with functionHelpers' queueManager/queueTimeout.
+ * @file
+ * @author Joshua Heagle <joshuaheagle@gmail.com>
+ * @version 1.0.0
+ * @module arrayHelpers
+ * @memberOf module:siFunciona
+ */
+var _default = exports.default = {
+  addUniqueToArray: _addUniqueToArray.default,
+  BasicQueue: _BasicQueue.default,
+  buildArray: _buildArray.default,
+  buildArrayOfReferences: _buildArrayOfReferences.default,
+  compareArrays: _compareArrays.default,
+  mergeArrays: _mergeArrays.default,
+  uniqueArray: _uniqueArray.default
+}

package/dist/helpers/descriptors/assignDescriptor.d.ts

@@ -1,12 +1,15 @@
-import 'core-js/stable';
-import { descriptor } from './samples/descriptor';
-/**
- * Apply one or more descriptors to an existing descriptor so that they represent a merged version of the descriptors.
- * @memberOf module:objectDescriptors
- * @param {module:objectDescriptors~descriptor} originalMap
- * @param  {...module:objectDescriptors~descriptor} descriptors
- * @returns {module:objectDescriptors~descriptor}
- */
-declare const assignDescriptor: (originalMap: descriptor, ...descriptors: Array<descriptor>) => descriptor;
-export default assignDescriptor;
+import 'core-js/stable';
+import { descriptor } from './samples/descriptor';
+/**
+ * Apply one or more descriptors to an existing descriptor so that they represent a merged version of the descriptors.
+ * Used to widen a descriptor as more differently-shaped objects are described into it (e.g. array elements of
+ * different types), rather than replacing it outright.
+ * @memberOf module:objectDescriptors
+ * @param {module:objectDescriptors~descriptor} originalMap - The base descriptor to merge onto (not mutated - a
+ * clone is merged and returned).
+ * @param  {...module:objectDescriptors~descriptor} descriptors - One or more further descriptors to merge in.
+ * @returns {module:objectDescriptors~descriptor} A new descriptor representing the merge of all of the above.
+ */
+declare const assignDescriptor: (originalMap: descriptor, ...descriptors: Array<descriptor>) => descriptor;
+export default assignDescriptor;
 //# sourceMappingURL=assignDescriptor.d.ts.map

package/dist/helpers/descriptors/assignDescriptor.js

@@ -1,55 +1,58 @@
-'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.every.js')
-require('core-js/modules/esnext.iterator.filter.js')
-require('core-js/modules/esnext.iterator.find.js')
-require('core-js/modules/esnext.iterator.for-each.js')
-require('core-js/modules/esnext.iterator.map.js')
-require('core-js/modules/esnext.iterator.reduce.js')
-require('core-js/stable')
-var _assignDescriptorDetail = _interopRequireDefault(require('./assignDescriptorDetail'))
-var _cloneDescriptor = _interopRequireDefault(require('./cloneDescriptor'))
-var _compareArrays = _interopRequireDefault(require('../arrays/compareArrays'))
-var _uniqueArray = _interopRequireDefault(require('../arrays/uniqueArray'))
-function _interopRequireDefault (e) { return e && e.__esModule ? e : { default: e } }
-/**
- * Apply one or more descriptors to an existing descriptor so that they represent a merged version of the descriptors.
- * @memberOf module:objectDescriptors
- * @param {module:objectDescriptors~descriptor} originalMap
- * @param  {...module:objectDescriptors~descriptor} descriptors
- * @returns {module:objectDescriptors~descriptor}
- */
-const assignDescriptor = (originalMap, ...descriptors) => descriptors.reduce((assignedDescriptor, descriptor) => {
-  const detailsDiff = (0, _compareArrays.default)(assignedDescriptor.keys, descriptor.keys)
-  detailsDiff.forEach(diff => {
-    const existingDetail = assignedDescriptor.details.find(detail => detail.key === diff.value)
-    const newDetail = descriptor.details.find(detail => detail.key === diff.value)
-    if (diff.result.every(result => result === 0)) {
-      assignedDescriptor.details[existingDetail.index] = (0, _assignDescriptorDetail.default)(existingDetail, newDetail)
-      return assignedDescriptor
-    }
-    const useDetail = diff.result[0] > 0 ? existingDetail : newDetail
-    if (!useDetail) {
-      assignedDescriptor.details[existingDetail.index].optional = true
-      return assignedDescriptor
-    }
-    const useIndex = diff.result[0] > 0 ? useDetail.index : assignedDescriptor.length
-    assignedDescriptor.details[useIndex] = Object.assign({}, useDetail, {
-      index: useIndex,
-      optional: true
-    })
-    assignedDescriptor.length = assignedDescriptor.length < assignedDescriptor.details.length ? assignedDescriptor.details.length : assignedDescriptor.length
-    return assignedDescriptor
-  })
-  assignedDescriptor.keys = (0, _uniqueArray.default)(assignedDescriptor.details.map(detail => detail.key))
-  assignedDescriptor.references = (0, _uniqueArray.default)(assignedDescriptor.details.filter(detail => detail.isReference).map(detail => detail.index))
-  assignedDescriptor.isArray = assignedDescriptor.length ? assignedDescriptor.details.every(detail => typeof detail.key === 'number') : assignedDescriptor.isArray
-  assignedDescriptor.complete = !assignedDescriptor.references.length || assignedDescriptor.complete || descriptor.complete
-  return assignedDescriptor
-}, (0, _cloneDescriptor.default)(originalMap))
-var _default = exports.default = assignDescriptor
+'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.every.js')
+require('core-js/modules/esnext.iterator.filter.js')
+require('core-js/modules/esnext.iterator.find.js')
+require('core-js/modules/esnext.iterator.for-each.js')
+require('core-js/modules/esnext.iterator.map.js')
+require('core-js/modules/esnext.iterator.reduce.js')
+require('core-js/stable')
+var _assignDescriptorDetail = _interopRequireDefault(require('./assignDescriptorDetail'))
+var _cloneDescriptor = _interopRequireDefault(require('./cloneDescriptor'))
+var _compareArrays = _interopRequireDefault(require('../arrays/compareArrays'))
+var _uniqueArray = _interopRequireDefault(require('../arrays/uniqueArray'))
+function _interopRequireDefault (e) { return e && e.__esModule ? e : { default: e } }
+/**
+ * Apply one or more descriptors to an existing descriptor so that they represent a merged version of the descriptors.
+ * Used to widen a descriptor as more differently-shaped objects are described into it (e.g. array elements of
+ * different types), rather than replacing it outright.
+ * @memberOf module:objectDescriptors
+ * @param {module:objectDescriptors~descriptor} originalMap - The base descriptor to merge onto (not mutated - a
+ * clone is merged and returned).
+ * @param  {...module:objectDescriptors~descriptor} descriptors - One or more further descriptors to merge in.
+ * @returns {module:objectDescriptors~descriptor} A new descriptor representing the merge of all of the above.
+ */
+const assignDescriptor = (originalMap, ...descriptors) => descriptors.reduce((assignedDescriptor, descriptor) => {
+  const detailsDiff = (0, _compareArrays.default)(assignedDescriptor.keys, descriptor.keys)
+  detailsDiff.forEach(diff => {
+    const existingDetail = assignedDescriptor.details.find(detail => detail.key === diff.value)
+    const newDetail = descriptor.details.find(detail => detail.key === diff.value)
+    if (diff.result.every(result => result === 0)) {
+      assignedDescriptor.details[existingDetail.index] = (0, _assignDescriptorDetail.default)(existingDetail, newDetail)
+      return assignedDescriptor
+    }
+    const useDetail = diff.result[0] > 0 ? existingDetail : newDetail
+    if (!useDetail) {
+      assignedDescriptor.details[existingDetail.index].optional = true
+      return assignedDescriptor
+    }
+    const useIndex = diff.result[0] > 0 ? useDetail.index : assignedDescriptor.length
+    assignedDescriptor.details[useIndex] = Object.assign({}, useDetail, {
+      index: useIndex,
+      optional: true
+    })
+    assignedDescriptor.length = assignedDescriptor.length < assignedDescriptor.details.length ? assignedDescriptor.details.length : assignedDescriptor.length
+    return assignedDescriptor
+  })
+  assignedDescriptor.keys = (0, _uniqueArray.default)(assignedDescriptor.details.map(detail => detail.key))
+  assignedDescriptor.references = (0, _uniqueArray.default)(assignedDescriptor.details.filter(detail => detail.isReference).map(detail => detail.index))
+  assignedDescriptor.isArray = assignedDescriptor.length ? assignedDescriptor.details.every(detail => typeof detail.key === 'number') : assignedDescriptor.isArray
+  assignedDescriptor.complete = !assignedDescriptor.references.length || assignedDescriptor.complete || descriptor.complete
+  return assignedDescriptor
+}, (0, _cloneDescriptor.default)(originalMap))
+var _default = exports.default = assignDescriptor

package/dist/helpers/descriptors/assignDescriptorDetail.d.ts

@@ -1,12 +1,15 @@
-import 'core-js/stable';
-import { descriptorDetail } from './samples/descriptorDetail';
-/**
- * Assign properties from other details onto an existing detail.
- * @memberOf module:objectDescriptors
- * @param {module:objectDescriptors~descriptorDetail} originalDetail
- * @param  {...module:objectDescriptors~descriptorDetail} details
- * @returns {module:objectDescriptors~descriptorDetail}
- */
-declare const assignDescriptorDetail: (originalDetail: descriptorDetail, ...details: Array<descriptorDetail>) => descriptorDetail;
-export default assignDescriptorDetail;
+import 'core-js/stable';
+import { descriptorDetail } from './samples/descriptorDetail';
+/**
+ * Assign properties from other details onto an existing detail, widening it (e.g. combining `type`/`value` arrays,
+ * OR-ing boolean flags like `nullable`/`optional`) rather than overwriting it - the per-property counterpart to
+ * {@link module:objectDescriptors.assignDescriptor}.
+ * @memberOf module:objectDescriptors
+ * @param {module:objectDescriptors~descriptorDetail} originalDetail - The base detail to merge onto (not mutated -
+ * a clone is merged and returned).
+ * @param  {...module:objectDescriptors~descriptorDetail} details - One or more further details to merge in.
+ * @returns {module:objectDescriptors~descriptorDetail} A new detail representing the merge of all of the above.
+ */
+declare const assignDescriptorDetail: (originalDetail: descriptorDetail, ...details: Array<descriptorDetail>) => descriptorDetail;
+export default assignDescriptorDetail;
 //# sourceMappingURL=assignDescriptorDetail.d.ts.map