si-funciona 2.3.2 → 2.3.4

package/dist/helpers/descriptors/compareDescriptor.js

@@ -1,32 +1,33 @@
-'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.every.js')
-require('core-js/modules/esnext.iterator.find.js')
-require('core-js/modules/esnext.iterator.some.js')
-require('core-js/modules/web.dom-collections.iterator.js')
-require('core-js/stable')
-/**
- * Check if two descriptors are the same or similar in that they have similar keys and the associated types are the same.
- * @memberOf module:objectDescriptors
- * @param {module:objectDescriptors~descriptor} descriptor1
- * @param {module:objectDescriptors~descriptor} descriptor2
- * @returns {boolean}
- */
-const compareDescriptor = (descriptor1, descriptor2) => {
-  if (descriptor1.isArray !== descriptor2.isArray) {
-    return false
-  }
-  if (descriptor1.length === 0 || descriptor2.length === 0) {
-    return descriptor1.length === descriptor2.length
-  }
-  const smallerDescriptor = descriptor1.length <= descriptor2.length ? descriptor1 : descriptor2
-  const largerDescriptor = descriptor2.length >= descriptor1.length ? descriptor2 : descriptor1
-  return smallerDescriptor.keys.every(key => largerDescriptor.keys.includes(key)) ? smallerDescriptor.details.every(detail => detail.type.some(type => largerDescriptor.details.find(foundDetail => foundDetail.key === detail.key).type.includes(type))) : false
-}
-var _default = exports.default = compareDescriptor
+'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.every.js')
+require('core-js/modules/esnext.iterator.find.js')
+require('core-js/modules/esnext.iterator.some.js')
+require('core-js/stable')
+/**
+ * Check if two descriptors are the same or similar, in that the smaller one's keys are all present in the larger
+ * one and their types line up - used to detect when a newly-described value actually matches a descriptor already
+ * in the map, so it can be pointed at instead of creating a duplicate.
+ * @memberOf module:objectDescriptors
+ * @param {module:objectDescriptors~descriptor} descriptor1 - The first descriptor to compare.
+ * @param {module:objectDescriptors~descriptor} descriptor2 - The second descriptor to compare.
+ * @returns {boolean} True if the descriptors describe a compatible shape.
+ */
+const compareDescriptor = (descriptor1, descriptor2) => {
+  if (descriptor1.isArray !== descriptor2.isArray) {
+    return false
+  }
+  if (descriptor1.length === 0 || descriptor2.length === 0) {
+    return descriptor1.length === descriptor2.length
+  }
+  const smallerDescriptor = descriptor1.length <= descriptor2.length ? descriptor1 : descriptor2
+  const largerDescriptor = descriptor2.length >= descriptor1.length ? descriptor2 : descriptor1
+  return smallerDescriptor.keys.every(key => largerDescriptor.keys.includes(key)) ? smallerDescriptor.details.every(detail => detail.type.some(type => largerDescriptor.details.find(foundDetail => foundDetail.key === detail.key).type.includes(type))) : false
+}
+var _default = exports.default = compareDescriptor

package/dist/helpers/descriptors/compareDescriptor.min.js

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:!0}),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.every.js"),require("core-js/modules/esnext.iterator.find.js"),require("core-js/modules/esnext.iterator.some.js"),require("core-js/modules/web.dom-collections.iterator.js"),require("core-js/stable");const compareDescriptor=(e,r)=>{if(e.isArray!==r.isArray)return!1;if(0===e.length||0===r.length)return e.length===r.length;const s=e.length<=r.length?e:r,t=r.length>=e.length?r:e;return!!s.keys.every((e=>t.keys.includes(e)))&&s.details.every((e=>e.type.some((r=>t.details.find((r=>r.key===e.key)).type.includes(r)))))};var _default=exports.default=compareDescriptor;
+"use strict";Object.defineProperty(exports,"__esModule",{value:!0}),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.every.js"),require("core-js/modules/esnext.iterator.find.js"),require("core-js/modules/esnext.iterator.some.js"),require("core-js/stable");const compareDescriptor=(e,r)=>{if(e.isArray!==r.isArray)return!1;if(0===e.length||0===r.length)return e.length===r.length;const s=e.length<=r.length?e:r,t=r.length>=e.length?r:e;return!!s.keys.every((e=>t.keys.includes(e)))&&s.details.every((e=>e.type.some((r=>t.details.find((r=>r.key===e.key)).type.includes(r)))))};var _default=exports.default=compareDescriptor;

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

@@ -1,13 +1,16 @@
-import 'core-js/stable';
-import { descriptor } from './samples/descriptor';
-export type describeableObject = Array<any> | {
-    [k: number | string]: any;
-};
-/**
- * Trace an object and return the descriptor which defines the object's structure and attributes.
- * @memberOf module:objectDescriptors
- * @param {Object} object
- * @returns {module:objectDescriptors~descriptor}
- */
-declare const describeObject: (object: describeableObject) => descriptor;
-export default describeObject;
+import 'core-js/stable';
+import { descriptor } from './samples/descriptor';
+export type describeableObject = Array<any> | {
+    [k: number | string]: any;
+};
+/**
+ * Trace a single object or array (not its nested objects/arrays - see
+ * {@link module:objectDescriptors.describeObjectMap} for that) and return the descriptor which defines its own
+ * structure and attributes.
+ * @memberOf module:objectDescriptors
+ * @param {Object|Array} object - The object or array to describe.
+ * @returns {module:objectDescriptors~descriptor}
+ */
+declare const describeObject: (object: describeableObject) => descriptor;
+export default describeObject;
+//# sourceMappingURL=describeObject.d.ts.map

package/dist/helpers/descriptors/describeObject.js

@@ -1,51 +1,53 @@
-'use strict'
-
-Object.defineProperty(exports, '__esModule', {
-  value: true
-})
-exports.default = void 0
-require('core-js/stable')
-var _assignDescriptorDetail = _interopRequireDefault(require('./assignDescriptorDetail'))
-var _describeObjectDetail = _interopRequireDefault(require('./describeObjectDetail'))
-var _objectKeys = _interopRequireDefault(require('../objects/objectKeys'))
-function _interopRequireDefault (e) { return e && e.__esModule ? e : { default: e } }
-/**
- * Trace an object and return the descriptor which defines the object's structure and attributes.
- * @memberOf module:objectDescriptors
- * @param {Object} object
- * @returns {module:objectDescriptors~descriptor}
- */
-const describeObject = object => {
-  const descriptor = {
-    index: 0,
-    details: [],
-    length: 0,
-    keys: [],
-    references: [],
-    isArray: false,
-    complete: false
-  }
-  const keys = (0, _objectKeys.default)(object)
-  for (let i = 0; i < keys.length; ++i) {
-    const key = keys[i]
-    // @ts-ignore
-    const newDetail = (0, _describeObjectDetail.default)(object[key], key, descriptor.length++)
-    if (typeof key === 'number' && descriptor.details.length) {
-      descriptor.details[0] = (0, _assignDescriptorDetail.default)(descriptor.details[0], newDetail)
-      descriptor.keys = [0]
-      if (newDetail.isReference) {
-        descriptor.references = [0]
-      }
-      continue
-    }
-    descriptor.details.push(newDetail)
-    descriptor.keys.push(newDetail.key)
-    if (newDetail.isReference) {
-      descriptor.references.push(newDetail.index)
-    }
-  }
-  descriptor.isArray = Array.isArray(object)
-  descriptor.complete = !descriptor.references.length
-  return descriptor
-}
-var _default = exports.default = describeObject
+'use strict'
+
+Object.defineProperty(exports, '__esModule', {
+  value: true
+})
+exports.default = void 0
+require('core-js/stable')
+var _assignDescriptorDetail = _interopRequireDefault(require('./assignDescriptorDetail'))
+var _describeObjectDetail = _interopRequireDefault(require('./describeObjectDetail'))
+var _objectKeys = _interopRequireDefault(require('../objects/objectKeys'))
+function _interopRequireDefault (e) { return e && e.__esModule ? e : { default: e } }
+/**
+ * Trace a single object or array (not its nested objects/arrays - see
+ * {@link module:objectDescriptors.describeObjectMap} for that) and return the descriptor which defines its own
+ * structure and attributes.
+ * @memberOf module:objectDescriptors
+ * @param {Object|Array} object - The object or array to describe.
+ * @returns {module:objectDescriptors~descriptor}
+ */
+const describeObject = object => {
+  const descriptor = {
+    index: 0,
+    details: [],
+    length: 0,
+    keys: [],
+    references: [],
+    isArray: false,
+    complete: false
+  }
+  const keys = (0, _objectKeys.default)(object)
+  for (let i = 0; i < keys.length; ++i) {
+    const key = keys[i]
+    // @ts-ignore
+    const newDetail = (0, _describeObjectDetail.default)(object[key], key, descriptor.length++)
+    if (typeof key === 'number' && descriptor.details.length) {
+      descriptor.details[0] = (0, _assignDescriptorDetail.default)(descriptor.details[0], newDetail)
+      descriptor.keys = [0]
+      if (newDetail.isReference) {
+        descriptor.references = [0]
+      }
+      continue
+    }
+    descriptor.details.push(newDetail)
+    descriptor.keys.push(newDetail.key)
+    if (newDetail.isReference) {
+      descriptor.references.push(newDetail.index)
+    }
+  }
+  descriptor.isArray = Array.isArray(object)
+  descriptor.complete = !descriptor.references.length
+  return descriptor
+}
+var _default = exports.default = describeObject

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

@@ -1,12 +1,15 @@
-import 'core-js/stable';
-import { descriptorDetail } from './samples/descriptorDetail';
-/**
- * Trace an object's attribute and provide details about it.
- * @memberOf module:objectDescriptors
- * @param {*} value
- * @param {string|number} [key=0]
- * @param {number} [index=0]
- * @returns {module:objectDescriptors~descriptorDetail}
- */
-declare const describeObjectDetail: (value: any, key?: number | string, index?: number) => descriptorDetail;
-export default describeObjectDetail;
+import 'core-js/stable';
+import { descriptorDetail } from './samples/descriptorDetail';
+/**
+ * Trace a single property's value and produce the descriptorDetail describing it (type, nullability, whether it
+ * references a nested object/array, etc.) - the per-property building block used by
+ * {@link module:objectDescriptors.describeObject}.
+ * @memberOf module:objectDescriptors
+ * @param {*} value - The property's value to describe.
+ * @param {string|number} [key=0] - The property name (or array index) this value belongs to.
+ * @param {number} [index=0] - This detail's intended position within its parent descriptor's `details` array.
+ * @returns {module:objectDescriptors~descriptorDetail}
+ */
+declare const describeObjectDetail: (value: any, key?: number | string, index?: number) => descriptorDetail;
+export default describeObjectDetail;
+//# sourceMappingURL=describeObjectDetail.d.ts.map

package/dist/helpers/descriptors/describeObjectDetail.js

@@ -1,38 +1,38 @@
-'use strict'
-
-Object.defineProperty(exports, '__esModule', {
-  value: true
-})
-exports.default = void 0
-require('core-js/stable')
-var _emptyObject = _interopRequireDefault(require('../objects/emptyObject'))
-var _isCloneable = _interopRequireDefault(require('../objects/isCloneable'))
-var _isInstanceObject = _interopRequireDefault(require('../objects/isInstanceObject'))
-function _interopRequireDefault (e) { return e && e.__esModule ? e : { default: e } }
-/**
- * Trace an object's attribute and provide details about it.
- * @memberOf module:objectDescriptors
- * @param {*} value
- * @param {string|number} [key=0]
- * @param {number} [index=0]
- * @returns {module:objectDescriptors~descriptorDetail}
- */
-const describeObjectDetail = function (value) {
-  const key = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : 0
-  const index = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : 0
-  const type = typeof value
-  return {
-    index: index,
-    key: key,
-    type: [type],
-    value: [value],
-    nullable: value === null,
-    optional: false,
-    circular: false,
-    isReference: (0, _isCloneable.default)(value) && !(0, _emptyObject.default)(value),
-    isInstance: (0, _isInstanceObject.default)(value),
-    arrayReference: null,
-    objectReference: null
-  }
-}
-var _default = exports.default = describeObjectDetail
+'use strict'
+
+Object.defineProperty(exports, '__esModule', {
+  value: true
+})
+exports.default = void 0
+require('core-js/stable')
+var _emptyObject = _interopRequireDefault(require('../objects/emptyObject'))
+var _isCloneable = _interopRequireDefault(require('../objects/isCloneable'))
+var _isInstanceObject = _interopRequireDefault(require('../objects/isInstanceObject'))
+function _interopRequireDefault (e) { return e && e.__esModule ? e : { default: e } }
+/**
+ * Trace a single property's value and produce the descriptorDetail describing it (type, nullability, whether it
+ * references a nested object/array, etc.) - the per-property building block used by
+ * {@link module:objectDescriptors.describeObject}.
+ * @memberOf module:objectDescriptors
+ * @param {*} value - The property's value to describe.
+ * @param {string|number} [key=0] - The property name (or array index) this value belongs to.
+ * @param {number} [index=0] - This detail's intended position within its parent descriptor's `details` array.
+ * @returns {module:objectDescriptors~descriptorDetail}
+ */
+const describeObjectDetail = (value, key = 0, index = 0) => {
+  const type = typeof value
+  return {
+    index: index,
+    key: key,
+    type: [type],
+    value: [value],
+    nullable: value === null,
+    optional: false,
+    circular: false,
+    isReference: (0, _isCloneable.default)(value) && !(0, _emptyObject.default)(value),
+    isInstance: (0, _isInstanceObject.default)(value),
+    arrayReference: null,
+    objectReference: null
+  }
+}
+var _default = exports.default = describeObjectDetail

package/dist/helpers/descriptors/describeObjectDetail.min.js

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:!0}),exports.default=void 0,require("core-js/stable");var _emptyObject=_interopRequireDefault(require("../objects/emptyObject")),_isCloneable=_interopRequireDefault(require("../objects/isCloneable")),_isInstanceObject=_interopRequireDefault(require("../objects/isInstanceObject"));function _interopRequireDefault(e){return e&&e.__esModule?e:{default:e}}const describeObjectDetail=function(e){return{index:arguments.length>2&&void 0!==arguments[2]?arguments[2]:0,key:arguments.length>1&&void 0!==arguments[1]?arguments[1]:0,type:[typeof e],value:[e],nullable:null===e,optional:!1,circular:!1,isReference:(0,_isCloneable.default)(e)&&!(0,_emptyObject.default)(e),isInstance:(0,_isInstanceObject.default)(e),arrayReference:null,objectReference:null}};var _default=exports.default=describeObjectDetail;
+"use strict";Object.defineProperty(exports,"__esModule",{value:!0}),exports.default=void 0,require("core-js/stable");var _emptyObject=_interopRequireDefault(require("../objects/emptyObject")),_isCloneable=_interopRequireDefault(require("../objects/isCloneable")),_isInstanceObject=_interopRequireDefault(require("../objects/isInstanceObject"));function _interopRequireDefault(e){return e&&e.__esModule?e:{default:e}}const describeObjectDetail=(e,t=0,r=0)=>({index:r,key:t,type:[typeof e],value:[e],nullable:null===e,optional:!1,circular:!1,isReference:(0,_isCloneable.default)(e)&&!(0,_emptyObject.default)(e),isInstance:(0,_isInstanceObject.default)(e),arrayReference:null,objectReference:null});var _default=exports.default=describeObjectDetail;

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

@@ -1,20 +1,37 @@
-import 'core-js/stable';
-import { describeableObject } from './describeObject';
-import { descriptorMap } from './samples/descriptorMap';
-type describeObjectMapOptions = {
-    mapLimit?: number;
-    depthLimit?: number;
-    keepValues?: boolean;
-};
-/**
- * Trace out the entire object including nested objects.
- * @memberOf module:objectDescriptors
- * @param {Object|Array} object
- * @param {Object} [options={}]
- * @param {number} [options.mapLimit=1000000000]
- * @param {number} [options.depthLimit=-1]
- * @param {boolean} [options.keepValues=false]
- * @returns {module:objectDescriptors~descriptorMap}
- */
-declare const describeObjectMap: (object: describeableObject, { mapLimit, depthLimit, keepValues }?: describeObjectMapOptions) => descriptorMap;
-export default describeObjectMap;
+import 'core-js/stable';
+import { describeableObject } from './describeObject';
+import { descriptorMap } from './samples/descriptorMap';
+type describeObjectMapOptions = {
+    mapLimit?: number;
+    depthLimit?: number;
+    keepValues?: boolean;
+};
+/**
+ * Trace out the entire object including nested objects, producing a flat descriptorMap - see the
+ * {@link module:objectDescriptors} module description for what a descriptor represents and why it's flat. This is
+ * the main entry point into this module: start here to describe a real object/array before comparing, merging, or
+ * inspecting its structure with the other functions in this module.
+ * @example
+ * describeObjectMap({ name: 'example', tags: ['a', 'b'] })
+ * // [
+ * //   { index: 0, details: [...], length: 2, keys: ['name', 'tags'], references: [1], isArray: false, complete: true },
+ * //   { index: 1, details: [...], length: 2, keys: [0], references: [], isArray: true, complete: true }
+ * // ]
+ * // descriptorMap[0] describes the top-level object; its 'tags' property is a reference (references: [1]) to
+ * // descriptorMap[1], which separately describes that nested array. descriptorMap[1]'s own `length` (2) reflects
+ * // the array's actual length, but `keys` has only one entry (0) since both elements share the same type
+ * // ('string') and are described together by a single, representative descriptorDetail.
+ * @memberOf module:objectDescriptors
+ * @param {Object|Array} object - The real object or array to describe.
+ * @param {Object} [options={}]
+ * @param {number} [options.mapLimit=1000000000] - Stop describing further nested references once the map reaches
+ * this many descriptors - a safety limit for extremely large or deeply-referenced structures.
+ * @param {number} [options.depthLimit=-1] - How many levels of nested objects/arrays to describe; `-1` means no
+ * limit, `0` describes only the top level, etc.
+ * @param {boolean} [options.keepValues=false] - By default, each detail's actual values are cleared once its
+ * descriptor is complete (to save memory) - set true to keep them.
+ * @returns {module:objectDescriptors~descriptorMap}
+ */
+declare const describeObjectMap: (object: describeableObject, { mapLimit, depthLimit, keepValues }?: describeObjectMapOptions) => descriptorMap;
+export default describeObjectMap;
+//# sourceMappingURL=describeObjectMap.d.ts.map

package/dist/helpers/descriptors/describeObjectMap.js

@@ -1,97 +1,108 @@
-'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.find.js')
-require('core-js/modules/esnext.iterator.for-each.js')
-require('core-js/stable')
-var _assignDescriptor = _interopRequireDefault(require('./assignDescriptor'))
-var _checkClearValues = _interopRequireDefault(require('./checkClearValues'))
-var _checkDescriptorComplete = _interopRequireDefault(require('./checkDescriptorComplete'))
-var _compareDescriptor = _interopRequireDefault(require('./compareDescriptor'))
-var _describeObject = _interopRequireDefault(require('./describeObject'))
-var _nextReference = _interopRequireDefault(require('./nextReference'))
-var _sameDescriptor = _interopRequireDefault(require('./sameDescriptor'))
-function _interopRequireDefault (e) { return e && e.__esModule ? e : { default: e } }
-/**
- * Trace out the entire object including nested objects.
- * @memberOf module:objectDescriptors
- * @param {Object|Array} object
- * @param {Object} [options={}]
- * @param {number} [options.mapLimit=1000000000]
- * @param {number} [options.depthLimit=-1]
- * @param {boolean} [options.keepValues=false]
- * @returns {module:objectDescriptors~descriptorMap}
- */
-const describeObjectMap = function (object) {
-  const _ref = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {}
-  const _ref$mapLimit = _ref.mapLimit
-  const mapLimit = _ref$mapLimit === void 0 ? 1000000000 : _ref$mapLimit
-  const _ref$depthLimit = _ref.depthLimit
-  const depthLimit = _ref$depthLimit === void 0 ? -1 : _ref$depthLimit
-  const _ref$keepValues = _ref.keepValues
-  const keepValues = _ref$keepValues === void 0 ? false : _ref$keepValues
-  const descriptorMap = [(0, _describeObject.default)(object)]
-  descriptorMap[0].index = 0
-  const describeReferences = function (descriptor, currentDetail) {
-    let limit = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : -1
-    const returnCallback = arguments.length > 3 && arguments[3] !== undefined ? arguments[3] : returnMap => returnMap
-    let index = descriptorMap.length
-    const nextRef = currentDetail ? (0, _nextReference.default)(descriptor, currentDetail.index) : undefined
-    const nextDetail = typeof nextRef !== 'undefined' ? descriptor.details[nextRef] : null
-    if (currentDetail) {
-      const vals = descriptor.isArray ? currentDetail.value : [currentDetail.value[currentDetail.value.length - 1]]
-      vals.forEach(val => {
-        var _a, _b
-        const tempDescriptor = (0, _describeObject.default)(val)
-        const existingDescriptorIndex = descriptorMap.findIndex(existingDescriptor => (0, _compareDescriptor.default)(tempDescriptor, existingDescriptor))
-        if (existingDescriptorIndex >= 0) {
-          index = existingDescriptorIndex
-          if (tempDescriptor.length && (0, _sameDescriptor.default)(tempDescriptor, descriptorMap[existingDescriptorIndex])) {
-            currentDetail.circular = true
-            descriptor.details[currentDetail.index] = currentDetail
-          }
-        }
-        if (index >= mapLimit) {
-          return descriptorMap
-        }
-        if (limit === 0) {
-          return descriptorMap
-        }
-        if (tempDescriptor.isArray) {
-          index = (_a = currentDetail.arrayReference) !== null && _a !== void 0 ? _a : index
-          descriptor.details[currentDetail.index].arrayReference = index
-        } else {
-          index = (_b = currentDetail.objectReference) !== null && _b !== void 0 ? _b : index
-          descriptor.details[currentDetail.index].objectReference = index
-        }
-        tempDescriptor.index = index
-        if (existingDescriptorIndex < 0) {
-          descriptorMap[index] = descriptorMap[index] ? (0, _assignDescriptor.default)(descriptorMap[index], tempDescriptor) : tempDescriptor
-        }
-        descriptorMap[descriptor.index] = (0, _assignDescriptor.default)(descriptorMap[descriptor.index], descriptor)
-        currentDetail = descriptorMap[descriptor.index].details.find(detail => detail.key === currentDetail.key)
-        if (!currentDetail.circular) {
-          const newReference = (0, _nextReference.default)(tempDescriptor, -1)
-          const newDetail = typeof newReference !== 'undefined' ? tempDescriptor.details[newReference] : null
-          return describeReferences(tempDescriptor, newDetail, --limit, returnMap => describeReferences(descriptor, nextDetail, --limit))
-        }
-      })
-    }
-    descriptorMap[descriptor.index] = (0, _assignDescriptor.default)(descriptorMap[descriptor.index], (0, _checkDescriptorComplete.default)(descriptor))
-    descriptorMap[descriptor.index] = (0, _checkClearValues.default)(descriptorMap[descriptor.index], keepValues)
-    return nextDetail ? describeReferences(descriptor, nextDetail, --limit) : returnCallback(descriptorMap)
-  }
-  const descriptor = descriptorMap[0]
-  const currentReference = (0, _nextReference.default)(descriptor, -1)
-  if (typeof currentReference === 'undefined') {
-    descriptorMap[0] = (0, _assignDescriptor.default)(descriptorMap[0], (0, _checkDescriptorComplete.default)(descriptor))
-    descriptorMap[0] = (0, _checkClearValues.default)(descriptorMap[0], keepValues)
-    return descriptorMap
-  }
-  return describeReferences(descriptor, descriptor.details[currentReference], depthLimit)
-}
-var _default = exports.default = describeObjectMap
+'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.find.js')
+require('core-js/modules/esnext.iterator.for-each.js')
+require('core-js/stable')
+var _assignDescriptor = _interopRequireDefault(require('./assignDescriptor'))
+var _checkClearValues = _interopRequireDefault(require('./checkClearValues'))
+var _checkDescriptorComplete = _interopRequireDefault(require('./checkDescriptorComplete'))
+var _compareDescriptor = _interopRequireDefault(require('./compareDescriptor'))
+var _describeObject = _interopRequireDefault(require('./describeObject'))
+var _nextReference = _interopRequireDefault(require('./nextReference'))
+var _sameDescriptor = _interopRequireDefault(require('./sameDescriptor'))
+function _interopRequireDefault (e) { return e && e.__esModule ? e : { default: e } }
+/**
+ * Trace out the entire object including nested objects, producing a flat descriptorMap - see the
+ * {@link module:objectDescriptors} module description for what a descriptor represents and why it's flat. This is
+ * the main entry point into this module: start here to describe a real object/array before comparing, merging, or
+ * inspecting its structure with the other functions in this module.
+ * @example
+ * describeObjectMap({ name: 'example', tags: ['a', 'b'] })
+ * // [
+ * //   { index: 0, details: [...], length: 2, keys: ['name', 'tags'], references: [1], isArray: false, complete: true },
+ * //   { index: 1, details: [...], length: 2, keys: [0], references: [], isArray: true, complete: true }
+ * // ]
+ * // descriptorMap[0] describes the top-level object; its 'tags' property is a reference (references: [1]) to
+ * // descriptorMap[1], which separately describes that nested array. descriptorMap[1]'s own `length` (2) reflects
+ * // the array's actual length, but `keys` has only one entry (0) since both elements share the same type
+ * // ('string') and are described together by a single, representative descriptorDetail.
+ * @memberOf module:objectDescriptors
+ * @param {Object|Array} object - The real object or array to describe.
+ * @param {Object} [options={}]
+ * @param {number} [options.mapLimit=1000000000] - Stop describing further nested references once the map reaches
+ * this many descriptors - a safety limit for extremely large or deeply-referenced structures.
+ * @param {number} [options.depthLimit=-1] - How many levels of nested objects/arrays to describe; `-1` means no
+ * limit, `0` describes only the top level, etc.
+ * @param {boolean} [options.keepValues=false] - By default, each detail's actual values are cleared once its
+ * descriptor is complete (to save memory) - set true to keep them.
+ * @returns {module:objectDescriptors~descriptorMap}
+ */
+const describeObjectMap = (object, {
+  mapLimit = 1000000000,
+  depthLimit = -1,
+  keepValues = false
+} = {}) => {
+  const descriptorMap = [(0, _describeObject.default)(object)]
+  descriptorMap[0].index = 0
+  const describeReferences = (descriptor, currentDetail, limit = -1, returnCallback = returnMap => returnMap) => {
+    let index = descriptorMap.length
+    const nextRef = currentDetail ? (0, _nextReference.default)(descriptor, currentDetail.index) : undefined
+    const nextDetail = typeof nextRef !== 'undefined' ? descriptor.details[nextRef] : null
+    if (currentDetail) {
+      const vals = descriptor.isArray ? currentDetail.value : [currentDetail.value[currentDetail.value.length - 1]]
+      vals.forEach(val => {
+        var _a, _b
+        const tempDescriptor = (0, _describeObject.default)(val)
+        const existingDescriptorIndex = descriptorMap.findIndex(existingDescriptor => (0, _compareDescriptor.default)(tempDescriptor, existingDescriptor))
+        if (existingDescriptorIndex >= 0) {
+          index = existingDescriptorIndex
+          if (tempDescriptor.length && (0, _sameDescriptor.default)(tempDescriptor, descriptorMap[existingDescriptorIndex])) {
+            currentDetail.circular = true
+            descriptor.details[currentDetail.index] = currentDetail
+          }
+        }
+        if (index >= mapLimit) {
+          return descriptorMap
+        }
+        if (limit === 0) {
+          return descriptorMap
+        }
+        if (tempDescriptor.isArray) {
+          index = (_a = currentDetail.arrayReference) !== null && _a !== void 0 ? _a : index
+          descriptor.details[currentDetail.index].arrayReference = index
+        } else {
+          index = (_b = currentDetail.objectReference) !== null && _b !== void 0 ? _b : index
+          descriptor.details[currentDetail.index].objectReference = index
+        }
+        tempDescriptor.index = index
+        if (existingDescriptorIndex < 0) {
+          descriptorMap[index] = descriptorMap[index] ? (0, _assignDescriptor.default)(descriptorMap[index], tempDescriptor) : tempDescriptor
+        }
+        descriptorMap[descriptor.index] = (0, _assignDescriptor.default)(descriptorMap[descriptor.index], descriptor)
+        currentDetail = descriptorMap[descriptor.index].details.find(detail => detail.key === currentDetail.key)
+        if (!currentDetail.circular) {
+          const newReference = (0, _nextReference.default)(tempDescriptor, -1)
+          const newDetail = typeof newReference !== 'undefined' ? tempDescriptor.details[newReference] : null
+          return describeReferences(tempDescriptor, newDetail, --limit, returnMap => describeReferences(descriptor, nextDetail, --limit))
+        }
+      })
+    }
+    descriptorMap[descriptor.index] = (0, _assignDescriptor.default)(descriptorMap[descriptor.index], (0, _checkDescriptorComplete.default)(descriptor))
+    descriptorMap[descriptor.index] = (0, _checkClearValues.default)(descriptorMap[descriptor.index], keepValues)
+    return nextDetail ? describeReferences(descriptor, nextDetail, --limit) : returnCallback(descriptorMap)
+  }
+  const descriptor = descriptorMap[0]
+  const currentReference = (0, _nextReference.default)(descriptor, -1)
+  if (typeof currentReference === 'undefined') {
+    descriptorMap[0] = (0, _assignDescriptor.default)(descriptorMap[0], (0, _checkDescriptorComplete.default)(descriptor))
+    descriptorMap[0] = (0, _checkClearValues.default)(descriptorMap[0], keepValues)
+    return descriptorMap
+  }
+  return describeReferences(descriptor, descriptor.details[currentReference], depthLimit)
+}
+var _default = exports.default = describeObjectMap

package/dist/helpers/descriptors/describeObjectMap.min.js

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:!0}),exports.default=void 0,require("core-js/modules/esnext.iterator.constructor.js"),require("core-js/modules/esnext.iterator.find.js"),require("core-js/modules/esnext.iterator.for-each.js"),require("core-js/stable");var _assignDescriptor=_interopRequireDefault(require("./assignDescriptor")),_checkClearValues=_interopRequireDefault(require("./checkClearValues")),_checkDescriptorComplete=_interopRequireDefault(require("./checkDescriptorComplete")),_compareDescriptor=_interopRequireDefault(require("./compareDescriptor")),_describeObject=_interopRequireDefault(require("./describeObject")),_nextReference=_interopRequireDefault(require("./nextReference")),_sameDescriptor=_interopRequireDefault(require("./sameDescriptor"));function _interopRequireDefault(e){return e&&e.__esModule?e:{default:e}}const describeObjectMap=function(e){let r=arguments.length>1&&void 0!==arguments[1]?arguments[1]:{},t=r.mapLimit,i=void 0===t?1e9:t,c=r.depthLimit,a=void 0===c?-1:c,s=r.keepValues,n=void 0!==s&&s;const u=[(0,_describeObject.default)(e)];u[0].index=0;const l=function(e,r){let t=arguments.length>2&&void 0!==arguments[2]?arguments[2]:-1,c=arguments.length>3&&void 0!==arguments[3]?arguments[3]:e=>e,a=u.length;const s=r?(0,_nextReference.default)(e,r.index):void 0,o=void 0!==s?e.details[s]:null;if(r){(e.isArray?r.value:[r.value[r.value.length-1]]).forEach((c=>{var s,n;const d=(0,_describeObject.default)(c),f=u.findIndex((e=>(0,_compareDescriptor.default)(d,e)));if(f>=0&&(a=f,d.length&&(0,_sameDescriptor.default)(d,u[f])&&(r.circular=!0,e.details[r.index]=r)),a>=i)return u;if(0===t)return u;if(d.isArray?(a=null!==(s=r.arrayReference)&&void 0!==s?s:a,e.details[r.index].arrayReference=a):(a=null!==(n=r.objectReference)&&void 0!==n?n:a,e.details[r.index].objectReference=a),d.index=a,f<0&&(u[a]=u[a]?(0,_assignDescriptor.default)(u[a],d):d),u[e.index]=(0,_assignDescriptor.default)(u[e.index],e),!(r=u[e.index].details.find((e=>e.key===r.key))).circular){const r=(0,_nextReference.default)(d,-1),i=void 0!==r?d.details[r]:null;return l(d,i,--t,(r=>l(e,o,--t)))}}))}return u[e.index]=(0,_assignDescriptor.default)(u[e.index],(0,_checkDescriptorComplete.default)(e)),u[e.index]=(0,_checkClearValues.default)(u[e.index],n),o?l(e,o,--t):c(u)},o=u[0],d=(0,_nextReference.default)(o,-1);return void 0===d?(u[0]=(0,_assignDescriptor.default)(u[0],(0,_checkDescriptorComplete.default)(o)),u[0]=(0,_checkClearValues.default)(u[0],n),u):l(o,o.details[d],a)};var _default=exports.default=describeObjectMap;
+"use strict";Object.defineProperty(exports,"__esModule",{value:!0}),exports.default=void 0,require("core-js/modules/esnext.iterator.constructor.js"),require("core-js/modules/esnext.iterator.find.js"),require("core-js/modules/esnext.iterator.for-each.js"),require("core-js/stable");var _assignDescriptor=_interopRequireDefault(require("./assignDescriptor")),_checkClearValues=_interopRequireDefault(require("./checkClearValues")),_checkDescriptorComplete=_interopRequireDefault(require("./checkDescriptorComplete")),_compareDescriptor=_interopRequireDefault(require("./compareDescriptor")),_describeObject=_interopRequireDefault(require("./describeObject")),_nextReference=_interopRequireDefault(require("./nextReference")),_sameDescriptor=_interopRequireDefault(require("./sameDescriptor"));function _interopRequireDefault(e){return e&&e.__esModule?e:{default:e}}const describeObjectMap=(e,{mapLimit:r=1e9,depthLimit:t=-1,keepValues:i=!1}={})=>{const a=[(0,_describeObject.default)(e)];a[0].index=0;const c=(e,t,s=-1,u=e=>e)=>{let l=a.length;const n=t?(0,_nextReference.default)(e,t.index):void 0,o=void 0!==n?e.details[n]:null;if(t){(e.isArray?t.value:[t.value[t.value.length-1]]).forEach((i=>{var u,n;const d=(0,_describeObject.default)(i),f=a.findIndex((e=>(0,_compareDescriptor.default)(d,e)));if(f>=0&&(l=f,d.length&&(0,_sameDescriptor.default)(d,a[f])&&(t.circular=!0,e.details[t.index]=t)),l>=r)return a;if(0===s)return a;if(d.isArray?(l=null!==(u=t.arrayReference)&&void 0!==u?u:l,e.details[t.index].arrayReference=l):(l=null!==(n=t.objectReference)&&void 0!==n?n:l,e.details[t.index].objectReference=l),d.index=l,f<0&&(a[l]=a[l]?(0,_assignDescriptor.default)(a[l],d):d),a[e.index]=(0,_assignDescriptor.default)(a[e.index],e),!(t=a[e.index].details.find((e=>e.key===t.key))).circular){const r=(0,_nextReference.default)(d,-1),t=void 0!==r?d.details[r]:null;return c(d,t,--s,(r=>c(e,o,--s)))}}))}return a[e.index]=(0,_assignDescriptor.default)(a[e.index],(0,_checkDescriptorComplete.default)(e)),a[e.index]=(0,_checkClearValues.default)(a[e.index],i),o?c(e,o,--s):u(a)},s=a[0],u=(0,_nextReference.default)(s,-1);return void 0===u?(a[0]=(0,_assignDescriptor.default)(a[0],(0,_checkDescriptorComplete.default)(s)),a[0]=(0,_checkClearValues.default)(a[0],i),a):c(s,s.details[u],t)};var _default=exports.default=describeObjectMap;