@nejs/basic-extensions 1.6.0 → 1.7.0

package/dist/cjs/newClasses/refmap.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"refmap.js","sourceRoot":"","sources":["../../../src/newClasses/refmap.js"],"names":[],"mappings":"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"}

package/dist/cjs/newClasses/refset.d.ts

@@ -0,0 +1,186 @@
+/**
+ * RefSet class extends the standard Set object to manage a collection of
+ * WeakRef objects. It provides additional functionality such as objectification
+ * of values and various utility methods.
+ *
+ * Unlike standard Sets or Arrays, RefSet stores weak references to objects,
+ * allowing them to be garbage-collected if there are no other references to
+ * them. This behavior is different from Arrays and standard Sets, which
+ * maintain strong references to their elements.
+ *
+ * @extends Set
+ */
+export class RefSet extends Set<any> {
+    constructor(values?: readonly any[] | null | undefined);
+    constructor(iterable?: Iterable<any> | null | undefined);
+    /**
+     * Method to control whether the RefSet should objectify its values. When
+     * objectifying, primitive values (number, string, boolean, bigint) are
+     * converted to their respective object types, which allows them to be used as
+     * WeakRef targets.
+     *
+     * @param {boolean} setObjectification - Flag to enable or disable
+     * objectification.
+     * @returns {RefSet} - The current RefSet instance to allow method chaining.
+     */
+    objectifying(setObjectification?: boolean): RefSet;
+    /**
+     * Setting this value to true, will cause all added values to the Set to
+     * be analyzed for validity as a candidate to be wrapped in a `WeakRef`
+     * object. If true, and if possible, the object will be turned into an
+     * `Object` variant first. This will also enable less rigid variable
+     * comparison in the `.has()` method (i.e. `==` instead of `===`).
+     *
+     * @param {boolean} value - The new state to set for objectifyValues.
+     */
+    set objectifyValues(value: boolean);
+    /**
+     * Returns the state indicating whether or not `RefSet` will attempt to
+     * convert non-valid primitives into targets that are valid input for
+     * new `WeakRef` object instances. If this value is `false` then no
+     * *objectification* will occur.
+     *
+     * @returns {boolean} The current state of objectifyValues.
+     */
+    get objectifyValues(): boolean;
+    /**
+     * Overrides the add method of Set. Adds a value to the RefSet, converting it
+     * to a WeakRef. Throws an error if the value is not a valid WeakRef target
+     * (e.g., null, undefined, or a registered symbol). If `objectifyValues` is
+     * enabled, an attempt to convert primitives to their object variants will be
+     * made. These are numbers, strings, boolean values and big integers.
+     *
+     * @param {*} value - The value to be added to the RefSet.
+     * @throws {TypeError} If the value is not a valid WeakRef target.
+     */
+    add(value: any): void;
+    /**
+     * Adds multiple values to the RefSet. The supplied `values` should be
+     * iterable and truthy. This function defers to `.add()` for its logic so
+     * each value from the supplied collection of values will also be subject
+     * to the criteria of that function.
+     *
+     * @param {Iterable} values - An iterable of values to add to the RefSet.
+     * @throws {TypeError} If the supplied values are falsey or non-iterable.
+     */
+    addAll(values: Iterable<any>): void;
+    /**
+     * Removes all elements from the RefSet that have been garbage collected
+     * (i.e., their WeakRef no longer points to an object).
+     *
+     * @returns {RefSet} - The current RefSet instance to allow method chaining.
+     */
+    clean(): RefSet;
+    /**
+     * Executes a provided function once for each value in the RefSet. The callback
+     * function receives the dereferenced value, the value again (as RefSet doesn't
+     * use keys), and the RefSet itself. This method provides a way to iterate over
+     * and apply operations to the values stored in the RefSet, taking into account
+     * that they are weak references and may have been garbage-collected.
+     *
+     * @param {Function} forEachFn - Function to execute for each element. It
+     * takes three arguments: element, element (again, as RefSet has no key), and
+     * the RefSet itself.
+     * @param {*} thisArg - Value to use as `this` when executing `forEachFn`.
+     */
+    entries(): any[][];
+    /**
+     * Iterate over the items in the set and pass them to the supplied
+     * function ala `Array.prototype.forEach`. Note however, there are no
+     * indexes on Sets and as such, the index parameter of the callback
+     * will always be `NaN`. Subsequently the `array` or third parameter
+     * will receive the set instance rather than an array.
+     *
+     * @param {function} forEachFn the function to use for each element in
+     * the set.
+     * @param {object} thisArg the `this` argument to be applied to each
+     * invocation of the `forEachFn` callback. Note, this value is unable
+     * to be applied if the `forEachFn` is a big arrow function
+     */
+    forEach(forEachFn: Function, thisArg: object): void;
+    /**
+     * Returns an iterator for the values in the RefSet. Each value is
+     * dereferenced from its WeakRef before being returned. This method allows
+     * iterating over he set's values, similar to how one would iterate over
+     * values in a standard Set or Array, but with the understanding that the
+     * values are weakly referenced and may no longer exist (in which case
+     * they are skipped).
+     *
+     * @returns {Iterator} An iterator for the values.
+     */
+    values(): Iterator<any, any, undefined>;
+    /**
+     * Returns an iterator for the keys of the RefSet. In RefSet, keys and
+     * values are identical, so this method behaves the same as `values()`. It
+     * provides compatibility with the standard Set interface and allows use in
+     * contexts where keys are expected, despite RefSet not differentiating
+     * between keys and values.
+     *
+     * @returns {Iterator} An iterator for the keys.
+     */
+    keys(): Iterator<any, any, undefined>;
+    /**
+     * Checks if the RefSet contains a value that is equal to the specified
+     * value. This method is used primarily in objectified RefSets to determine
+     * the presence of a value, taking into account objectification. It differs
+     * from the `has` method in that it's tailored for sets that have
+     * transformed their primitive values into objects, whereas `has` is more
+     * general-purpose.
+     *
+     * @param {*} value - The value to search for in the RefSet.
+     * @returns {boolean} - True if the RefSet contains the value, false otherwise.
+     */
+    contains(value: any): boolean;
+    /**
+     * Creates a new array with all elements that pass the test implemented by
+     * the provided function. This method iterates over each element,
+     * dereferences it, and applies the filter function. Unlike Array `filter`,
+     * the callback receives the dereferenced value and not an index or array,
+     * reflecting the non-indexed nature of RefSet. Useful for selectively
+     * creating arrays from the set based on certain conditions, especially when
+     * dealing with weak references.
+     *
+     * @param {Function} filterFn - Function to test each element of the RefSet.
+     * The function receives the dereferenced value.
+     * @param {*} thisArg - Value to use as `this` when executing `filterFn`.
+     * @returns {Array} - A new array with the elements that pass the test.
+     */
+    filter(filterFn: Function, thisArg: any): any[];
+    /**
+     * Returns the value of the first element in the RefSet that satisfies the
+     * provided testing function. Similar to Array `find`, this method iterates
+     * over the RefSet, dereferencing each value and applying the testing
+     * function. The non-indexed nature of RefSet is considered, as the
+     * callback does not receive an index. This method is useful for finding a
+     * specific element based on a condition.
+     *
+     * @param {*} thisArg - Value to use as this when executing findFn.
+     * @returns {*} - The value of the first element in the RefSet that satisfies
+     * the testing function, or undefined if none found.
+     * @returns {any} the dereferenced value if found, or undefined otherwise
+     */
+    find(findFn: any, thisArg: any): any;
+    /**
+     * Creates a new array or `RefSet` with the results of calling a provided
+     * function on every element in the calling `RefSet`. This method dereferences
+     * each value, applies the `mapFn`, and collects the results. If `toRefSet` is
+     * `true`, a new `RefSet` is returned; otherwise, an array. This method
+     * differs from `Array.map` in handling weak references and the potential to
+     * return a new `RefSet` instead of an array.
+     *
+     * @param {Function} mapFn - Function that produces an element of the new
+     * array or `RefSet`, taking three arguments.
+     * @param {*} thisArg - Value to use as this when executing mapFn.
+     * @param {boolean} toRefSet - Determines if the output should be a new
+     * `RefSet` (`true`) or an array (`false`).
+     * @param {boolean} mirrorObjectification - If `true` and `toRefSet` is
+     * `true`, the new `RefSet` mirrors the objectification setting of the
+     * original.
+     * @returns {Array|RefSet} - A new array or `RefSet` with each element being
+     * the result of the `mapFn`.
+     */
+    map(mapFn: Function, thisArg: any, toRefSet: boolean, mirrorObjectification: boolean): any[] | RefSet;
+    #private;
+}
+export const RefSetExtensions: Extension;
+import { Extension } from '@nejs/extension';

package/dist/cjs/{refset.js → newClasses/refset.js}

@@ -12,7 +12,7 @@ var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (
 };
 var _RefSet_instances, _RefSet_objectifyValues, _RefSet_validWeakRefTarget;
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.RefSetExtensions = void 0;
+exports.RefSetExtensions = exports.RefSet = void 0;
 const extension_1 = require("@nejs/extension");
 /**
  * RefSet class extends the standard Set object to manage a collection of
@@ -163,11 +163,24 @@ class RefSet extends Set {
      * @param {*} thisArg - Value to use as `this` when executing `forEachFn`.
      */
     entries() {
-        const refEntries = super.entries();
+        const refEntries = Array.from(super.entries());
         return refEntries
             .map(([_, ref]) => [ref.deref(), ref.deref()])
             .filter(([_, value]) => !!value);
     }
+    /**
+     * Iterate over the items in the set and pass them to the supplied
+     * function ala `Array.prototype.forEach`. Note however, there are no
+     * indexes on Sets and as such, the index parameter of the callback
+     * will always be `NaN`. Subsequently the `array` or third parameter
+     * will receive the set instance rather than an array.
+     *
+     * @param {function} forEachFn the function to use for each element in
+     * the set.
+     * @param {object} thisArg the `this` argument to be applied to each
+     * invocation of the `forEachFn` callback. Note, this value is unable
+     * to be applied if the `forEachFn` is a big arrow function
+     */
     forEach(forEachFn, thisArg) {
         const set = this;
         super.forEach(function (ref) {
@@ -290,7 +303,7 @@ class RefSet extends Set {
      * @param {*} thisArg - Value to use as this when executing findFn.
      * @returns {*} - The value of the first element in the RefSet that satisfies
      * the testing function, or undefined if none found.
-     * @returns
+     * @returns {any} the dereferenced value if found, or undefined otherwise
      */
     find(findFn, thisArg) {
         for (const value of this) {
@@ -366,9 +379,11 @@ class RefSet extends Set {
         return this.constructor.name;
     }
 }
+exports.RefSet = RefSet;
 _RefSet_validWeakRefTarget = function _RefSet_validWeakRefTarget(value) {
     return !((typeof value === 'symbol' && Symbol.keyFor(value) === undefined) ||
         (typeof value !== 'object' && typeof value !== 'symbol') ||
         (value === null || value === undefined));
 };
 exports.RefSetExtensions = new extension_1.Extension(RefSet);
+//# sourceMappingURL=refset.js.map

package/dist/cjs/newClasses/refset.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"refset.js","sourceRoot":"","sources":["../../../src/newClasses/refset.js"],"names":[],"mappings":"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"}

package/dist/cjs/objectextensions.d.ts

@@ -1,10 +1,11 @@
 /**
- * `ObjectExtensions` is a patch for the JavaScript built-in `Object` class. It
- * adds utility methods to the `Object` class without modifying the global namespace
- * directly. This patch includes methods for key validation, object type checking,
- * and retrieving the string tag of an object. These methods are useful for
- * enhancing the capabilities of the standard `Object` class with additional
- * utility functions.
+ * `ObjectExtensions` is a patch for the JavaScript built-in `Object` class.
+ * It adds utility methods to the `Object` class without modifying the global
+ * namespace directly. This patch includes methods for key validation, object
+ * type checking, and retrieving the string tag of an object. These methods
+ * are useful for enhancing the capabilities of the standard `Object` class
+ * with additional utility functions.
  */
 export const ObjectExtensions: Patch;
+export const ObjectPrototypeExtensions: Patch;
 import { Patch } from '@nejs/extension';

package/dist/cjs/objectextensions.js

@@ -1,16 +1,27 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ObjectExtensions = void 0;
+exports.ObjectPrototypeExtensions = exports.ObjectExtensions = void 0;
 const extension_1 = require("@nejs/extension");
 /**
- * `ObjectExtensions` is a patch for the JavaScript built-in `Object` class. It
- * adds utility methods to the `Object` class without modifying the global namespace
- * directly. This patch includes methods for key validation, object type checking,
- * and retrieving the string tag of an object. These methods are useful for
- * enhancing the capabilities of the standard `Object` class with additional
- * utility functions.
+ * `ObjectExtensions` is a patch for the JavaScript built-in `Object` class.
+ * It adds utility methods to the `Object` class without modifying the global
+ * namespace directly. This patch includes methods for key validation, object
+ * type checking, and retrieving the string tag of an object. These methods
+ * are useful for enhancing the capabilities of the standard `Object` class
+ * with additional utility functions.
  */
 exports.ObjectExtensions = new extension_1.Patch(Object, {
+    /**
+     * The function checks if a value is either `undefined` or `null`.
+     *
+     * @param {any} value - The parameter "value" is a variable that can hold
+     * any value.
+     * @returns {boolean} `true` if the value is either `undefined` or `null`,
+     * and `false` otherwise.
+     */
+    isNullDefined(value) {
+        return value === undefined || value === null;
+    },
     /**
      * Checks to see if the supplied `value` is both an object, and has the
      * appropriate symbol defined.
@@ -23,18 +34,25 @@ exports.ObjectExtensions = new extension_1.Patch(Object, {
         return Object.isObject(value) && Reflect.has(value, Symbol.toStringTag);
     },
     /**
-     * Retrieves the string tag of an object. The string tag is a representation of
-     * the object's type, as defined by its `Object.prototype.toString` method. This
-     * utility method is helpful for getting a more descriptive type of an object than
-     * what is returned by the `typeof` operator, especially for custom objects.
+     * Retrieves the string tag of an object. The string tag is a representation
+     * of the object's type, as defined by its `Object.prototype.toString`
+     * method. This utility method is helpful for getting a more descriptive
+     * type of an object than what is returned by the `typeof` operator,
+     * especially for custom objects.
      *
      * @param {*} value - The object whose string tag is to be retrieved.
+     * @param {boolean} strict - if this is set to true, undefined will be
+     * returned whenever a supplied object does not have a
+     * `Symbol.toStringTag` defined, period. if false, the default,
      * @returns {string} - The string tag of the object, indicating its type.
      */
-    getStringTag(value) {
+    getStringTag(value, strict = false) {
         if (Object.hasStringTag(value)) {
             return value[Symbol.toStringTag];
         }
+        if (strict) {
+            return undefined;
+        }
         if (value && (typeof value === 'function')) {
             return value.name;
         }
@@ -52,13 +70,13 @@ exports.ObjectExtensions = new extension_1.Patch(Object, {
      *
      * @param {any} value - The value whose type is to be determined.
      * @param {object} [owner=globalThis] - The object in which to look up the
-     * constructor corresponding to the string tag. Defaults to `globalThis`, which
-     * covers global constructors like `Array`, `Object`, etc.
-     * @returns {Function|object|null|undefined} - Returns the constructor or type
-     * of the value based on its string tag. For 'Null' and 'Undefined', it returns
-     * `null` and `undefined`, respectively. For other types, it returns the
-     * corresponding constructor (e.g., `Array` for arrays) if available in the
-     * `owner` object.
+     * constructor corresponding to the string tag. Defaults to `globalThis`,
+     * which covers global constructors like `Array`, `Object`, etc.
+     * @returns {Function|object|null|undefined} - Returns the constructor or
+     * type of the value based on its string tag. For 'Null' and 'Undefined',
+     * it returns `null` and `undefined`, respectively. For other types, it
+     * returns the corresponding constructor (e.g., `Array` for arrays) if
+     * available in the `owner` object.
      */
     getType(value, owner = globalThis) {
         const stringTag = Object.getStringTag(value);
@@ -70,13 +88,14 @@ exports.ObjectExtensions = new extension_1.Patch(Object, {
         }
     },
     /**
-     * Determines if the provided value is an object. This method checks whether the
-     * value is an instance of `Object` or if its type is 'object'. It's a utility
-     * method for type-checking, ensuring that a value is an object before performing
-     * operations that are specific to objects.
+     * Determines if the provided value is an object. This method checks whether
+     * the value is an instance of `Object` or if its type is 'object'. It's a
+     * utility method for type-checking, ensuring that a value is an object
+     * before performing operations that are specific to objects.
      *
      * @param {*} value - The value to be checked.
-     * @returns {boolean} - Returns `true` if the value is an object, otherwise `false`.
+     * @returns {boolean} - Returns `true` if the value is an object,
+     * otherwise `false`.
      */
     isObject(value) {
         return value && (value instanceof Object || typeof value === 'object');
@@ -108,13 +127,14 @@ exports.ObjectExtensions = new extension_1.Patch(Object, {
         }
     },
     /**
-     * Checks if the given value is a valid key for an object. In JavaScript, a valid
-     * key can be either a string or a symbol. This method is useful for validating
-     * object keys before using them in operations like setting or getting object properties.
+     * Checks if the given value is a valid key for an object. In JavaScript, a
+     * valid key can be either a string or a symbol. This method is useful for
+     * validating object keys before using them in operations like setting or
+     * getting object properties.
      *
      * @param {*} value - The value to be checked.
-     * @returns {boolean} - Returns `true` if the value is a valid object key (string or symbol),
-     *                      otherwise `false`.
+     * @returns {boolean} - Returns `true` if the value is a valid object key
+     * (string or symbol), otherwise `false`.
      */
     isValidKey(value) {
         return (typeof value === 'string' || typeof value === 'symbol');
@@ -126,33 +146,55 @@ exports.ObjectExtensions = new extension_1.Patch(Object, {
      * @param {object} object the object to pare down
      * @param {Array<string|symbol>} keys the keys that should appear in the
      * final reduced object
-     * @param {boolean} [bindAccessors = true] if this value is true
-     * then any accessors from the source object will continue to have their
-     * `this` value bound to the source. If the getter or setter on that object
-     * is defined using an arrow function, this will not work as intended.
-     * @returns {object} an object containing only the keys and symbols specified
-     * in the `keys` parameter.
+     * @param {boolean} [bindAccessors = true] if this value is true then any
+     * accessors from the source object will continue to have their `this`
+     * value bound to the source. If the getter or setter on that object is
+     * defined using an arrow function, this will not work as intended.
+     * @returns {object} an object containing only the keys and symbols
+     * specified in the `keys` parameter.
      */
     stripTo(object, keys, bindAccessors = true) {
+        if (!object || typeof object !== 'object') {
+            throw new TypeError('Object.stripTo requires an object to strip. Received', object);
+        }
         const result = {};
         if (!Array.isArray(keys)) {
             return result;
         }
         for (let key of keys) {
             if (Reflect.has(object, key)) {
-                const descriptor = Object.getOwnPropertyDescriptor(object, key);
-                if (Reflect.has(descriptor, 'get') || Reflect.has(descriptor, 'set')) {
+                const originalDescriptor = Object.getOwnPropertyDescriptor(object, key);
+                const descriptor = { ...originalDescriptor };
+                if (typeof descriptor.get === 'function' ||
+                    typeof descriptor.set === 'function') {
                     if (bindAccessors) {
-                        descriptor.get = descriptor?.get?.bind(object);
-                        descriptor.set = descriptor?.set?.bind(object);
+                        descriptor.get = descriptor.get?.bind(object);
+                        descriptor.set = descriptor.set?.bind(object);
                     }
-                    Object.defineProperty(result, descriptor);
-                }
-                else {
-                    Object.defineProperty(result, descriptor);
                 }
+                Object.defineProperty(result, key, descriptor);
             }
         }
         return result;
     },
 });
+exports.ObjectPrototypeExtensions = new extension_1.Patch(Object.prototype, {
+    /**
+     * Strips an object down to only the keys specified. Optionally, any
+     * accessors can be made to retain their context on the source object.
+     * This is a passthrough to the static {@link Object.stripTo} function
+     *
+     * @param {Array<string|symbol>} keys the keys that should appear in the
+     * final reduced object
+     * @param {boolean} [bindAccessors = true] if this value is true then any
+     * accessors from the source object will continue to have their `this`
+     * value bound to the source. If the getter or setter on that object is
+     * defined using an arrow function, this will not work as intended.
+     * @returns {object} an object containing only the keys and symbols
+     * specified in the `keys` parameter.
+     */
+    stripTo(keys, bindAccessors = true) {
+        return Object.stripTo(this, keys, bindAccessors);
+    }
+});
+//# sourceMappingURL=objectextensions.js.map

package/dist/cjs/objectextensions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"objectextensions.js","sourceRoot":"","sources":["../../src/objectextensions.js"],"names":[],"mappings":"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"}

package/dist/cjs/reflectextensions.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.ReflectExtensions = void 0;
 const extension_1 = require("@nejs/extension");
 const objectextensions_js_1 = require("./objectextensions.js");
+const { isObject } = objectextensions_js_1.ObjectExtensions.patches;
 /**
  * The `ReflectExtensions` class is a patch applied to the built-in JavaScript
  * `Reflect` object. It extends `Reflect` with additional utility methods that
@@ -31,23 +32,25 @@ exports.ReflectExtensions = new extension_1.Patch(Reflect, {
             .map(key => Reflect.has(object, key))
             .every(has => has));
     },
+    /**
+     * Fetches all descriptors of an object, including those mapped to a
+     * symbol descriptor value.
+     *
+     * @param {object} object the object from whose descriptors need to be
+     * retrieved.
+     * @returns {object} with keys mapped to object descriptors
+     * @throws {TypeError} if the supplied `object` is null or not an object
+     * a TypeError exception will be thrown
+     */
     ownDescriptors(object) {
-        const result = {};
-        const revertOnDone = () => revertOnDone.doIt ? objectextensions_js_1.ObjectExtensions.revert() : '';
-        revertOnDone.doIt = false;
-        if (!Object.isObject) {
-            revertOnDone.doIt = true;
-            objectextensions_js_1.ObjectExtensions.apply();
-        }
-        if (!Object.isObject(object)) {
-            revertOnDone();
-            return {};
+        if (!isObject(object)) {
+            throw new TypeError('The supplied object must be non-null and an object');
         }
+        const result = {};
         const keys = Reflect.ownKeys(object);
         for (const key of keys) {
             result[key] = Object.getOwnPropertyDescriptor(key);
         }
-        revertOnDone();
         return result;
     },
     /**
@@ -62,7 +65,7 @@ exports.ReflectExtensions = new extension_1.Patch(Reflect, {
      * at least one of the keys provided as arguments exists in the given object.
      */
     hasSome(object, ...keys) {
-        return Object.isObject(object) && (keys.flat(Infinity)
+        return isObject(object) && (keys.flat(Infinity)
             .map(key => Reflect.has(object, key))
             .some(has => has));
     },
@@ -105,3 +108,4 @@ exports.ReflectExtensions = new extension_1.Patch(Reflect, {
         return Reflect.entries.map(([, value]) => value);
     }
 });
+//# sourceMappingURL=reflectextensions.js.map

package/dist/cjs/reflectextensions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reflectextensions.js","sourceRoot":"","sources":["../../src/reflectextensions.js"],"names":[],"mappings":";;;AAAA,+CAAuC;AACvC,+DAAwD;AAExD,MAAM,EAAE,QAAQ,EAAE,GAAG,sCAAgB,CAAC,OAAO,CAAA;AAE7C;;;;;;;;;;;GAWG;AACU,QAAA,iBAAiB,GAAG,IAAI,iBAAK,CAAC,OAAO,EAAE;IAClD;;;;;;;;;OASG;IACH,MAAM,CAAC,MAAM,EAAE,GAAG,IAAI;QACpB,OAAO,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC;aACnD,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;aACpC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,CACnB,CAAA;IACH,CAAC;IAED;;;;;;;;;OASG;IACH,cAAc,CAAC,MAAM;QACnB,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;YACtB,MAAM,IAAI,SAAS,CAAC,oDAAoD,CAAC,CAAA;QAC3E,CAAC;QAED,MAAM,MAAM,GAAG,EAAE,CAAA;QAEjB,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAA;QAEpC,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;YACvB,MAAM,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,wBAAwB,CAAC,GAAG,CAAC,CAAA;QACpD,CAAC;QAED,OAAO,MAAM,CAAA;IACf,CAAC;IAED;;;;;;;;;;OAUG;IACH,OAAO,CAAC,MAAM,EAAE,GAAG,IAAI;QACrB,OAAO,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC;aAC5C,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;aACpC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,CAClB,CAAA;IACH,CAAC;IAED;;;;;;;;;;;;OAYG;IACH,OAAO,CAAC,MAAM;QACZ,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;YAAC,OAAO,EAAE,CAAA;QAAC,CAAC;QAExD,OAAO,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YACxC,GAAG,EAAE,MAAM,CAAC,wBAAwB,CAAC,MAAM,EAAE,GAAG,CAAC;SAClD,CAAC,CAAA;IACJ,CAAC;IAED;;;;;;;;;;;;;OAaG;IACH,MAAM,CAAC,MAAM;QACX,OAAO,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAC,KAAK,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAA;IACjD,CAAC;CACF,CAAC,CAAA"}

package/dist/cjs/stringextensions.js

@@ -25,3 +25,4 @@ exports.StringExtensions = new extension_1.Patch(String, {
         return false;
     },
 });
+//# sourceMappingURL=stringextensions.js.map

package/dist/cjs/stringextensions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stringextensions.js","sourceRoot":"","sources":["../../src/stringextensions.js"],"names":[],"mappings":";;;AAAA,+CAAwC;AAExC;;;;;;;GAOG;AACU,QAAA,gBAAgB,GAAG,IAAI,iBAAK,CAAC,MAAM,EAAE;IAChD;;;;;;OAMG;IACH,QAAQ,CAAC,KAAK;QACZ,IAAI,KAAK,IAAI,CAAC,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,YAAY,MAAM,CAAC,EAAE,CAAC;YACpE,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,CAAA;QACzB,CAAC;QACD,OAAO,KAAK,CAAA;IACd,CAAC;CACF,CAAC,CAAC"}

package/dist/cjs/symbolextensions.js

@@ -59,9 +59,11 @@ exports.SymbolExtensions = new extension_1.Patch(Symbol, {
      * spec static symbols (`toStringTag`, `iterator`, etc...), and any symbols
      * created by passing a value directly to the `Symbol` function, such as
      * `Symbol('name')`
-     * @returns
+     * @returns true if the `value` in question is both a `symbol` and has
+     * returns `undefined` if passed to `Symbol.keyFor`
      */
     isNonRegistered(value, allowOnlySymbols = false) {
         return !Symbol.isRegistered(value, allowOnlySymbols);
     },
 });
+//# sourceMappingURL=symbolextensions.js.map

package/dist/cjs/symbolextensions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"symbolextensions.js","sourceRoot":"","sources":["../../src/symbolextensions.js"],"names":[],"mappings":";;;AAAA,+CAAwC;AAExC;;;;;;;GAOG;AACU,QAAA,gBAAgB,GAAG,IAAI,iBAAK,CAAC,MAAM,EAAE;IAChD;;;;;;OAMG;IACH,QAAQ,CAAC,KAAK;QACZ,OAAO,KAAK,IAAI,CAAC,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC;IAC9C,CAAC;IAED;;;;;;;;;;;;;OAaG;IACH,YAAY,CAAC,KAAK,EAAE,gBAAgB,GAAG,KAAK;QAC1C,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;YAC5B,IAAI,gBAAgB,EAAE,CAAC;gBACrB,MAAM,IAAI,SAAS,CAAC,mDAAmD,CAAC,CAAA;YAC1E,CAAC;YACD,OAAO,KAAK,CAAA;QACd,CAAC;QAED,OAAO,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,SAAS,CAAA;IAC3C,CAAC;IAED;;;;;;;;;;;;;;;;;OAiBG;IACH,eAAe,CAAC,KAAK,EAAE,gBAAgB,GAAG,KAAK;QAC7C,OAAO,CAAC,MAAM,CAAC,YAAY,CAAC,KAAK,EAAE,gBAAgB,CAAC,CAAA;IACtD,CAAC;CACF,CAAC,CAAC"}

package/dist/cjs/weakrefextensions.js

@@ -16,3 +16,4 @@ exports.WeakRefExtensions = new extension_1.Patch(WeakRef, {
             (value === null || value === undefined));
     },
 });
+//# sourceMappingURL=weakrefextensions.js.map

package/dist/cjs/weakrefextensions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"weakrefextensions.js","sourceRoot":"","sources":["../../src/weakrefextensions.js"],"names":[],"mappings":";;;AAAA,+CAAuC;AAE1B,QAAA,iBAAiB,GAAG,IAAI,iBAAK,CAAC,OAAO,EAAE;IAClD;;;;;;OAMG;IACH,gBAAgB,CAAC,KAAK;QACpB,OAAO,CAAC,CACN,CAAC,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,SAAS,CAAC;YACjE,CAAC,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,KAAK,KAAK,QAAQ,CAAC;YACxD,CAAC,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,CAAC,CACxC,CAAA;IACH,CAAC;CACF,CAAC,CAAA"}

package/dist/mjs/arrayextensions.js

@@ -65,3 +65,4 @@ export const ArrayPrototypeExtensions = new Patch(Array.prototype, {
         return this[this.length - 1];
     },
 });
+//# sourceMappingURL=arrayextensions.js.map

package/dist/mjs/arrayextensions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"arrayextensions.js","sourceRoot":"","sources":["../../src/arrayextensions.js"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAA;AAEvC;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,IAAI,KAAK,CAAC,KAAK,CAAC,SAAS,EAAE;IACjE;;;;;;;;OAQG;IACH,QAAQ,CAAC,KAAK;QACZ,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,KAAK,KAAK,CAAC,CAAA;IAC9C,CAAC;IAED;;;;;;;;OAQG;IACH,SAAS,CAAC,MAAM;QACd,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,EAAE,CAAA;QAC9B,MAAM,KAAK,GAAG,CAAC,CAAA;QAEf,KAAK,IAAI,KAAK,IAAI,OAAO,EAAE,CAAC;YAC1B,IAAI,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;gBACzB,OAAO,KAAK,CAAA;YACd,CAAC;QACH,CAAC;QAED,OAAO,SAAS,CAAA;IAClB,CAAC;IAED;;;;;;;;OAQG;IACH,IAAI,KAAK;QACP,OAAO,IAAI,CAAC,CAAC,CAAC,CAAC;IACjB,CAAC;IAED;;;;;;;;;OASG;IACH,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAC/B,CAAC;CAEF,CAAC,CAAA"}

package/dist/mjs/functionextensions.js

@@ -84,3 +84,4 @@ export const FunctionExtensions = new Patch(Function, {
             !Reflect.has(value, 'prototype'));
     },
 });
+//# sourceMappingURL=functionextensions.js.map

package/dist/mjs/functionextensions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"functionextensions.js","sourceRoot":"","sources":["../../src/functionextensions.js"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAA;AAEvC;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,IAAI,KAAK,CAAC,QAAQ,EAAE;IACpD;;;;;;;;;OASG;IACH,OAAO,CAAC,KAAK;QACX,OAAO,KAAK,YAAY,QAAQ,IAAI,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAA;IACtE,CAAC;IAED;;;;;;;;OAQG;IACH,UAAU,CAAC,KAAK;QACd,OAAO,KAAK,YAAY,QAAQ,CAAC;IACnC,CAAC;IAED;;;;;;;;;OASG;IACH,OAAO,CAAC,KAAK;QACX,MAAM,SAAS,GAAG,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;QAC1E,OAAO,CACL,KAAK,YAAY,QAAQ;YACzB,SAAS,CAAC,QAAQ,CAAC,OAAO,CAAC,CAC5B,CAAA;IACH,CAAC;IAED;;;;;;;;;OASG;IACH,UAAU,CAAC,KAAK;QACd,OAAO,CACL,KAAK,YAAY,QAAQ;YACzB,MAAM,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC;YAC5B,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC;YAClC,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,WAAW,CAAC,CACjC,CAAC;IACJ,CAAC;IAED;;;;;;;;;;;;OAYG;IACH,OAAO,CAAC,KAAK;QACX,OAAO,CACL,KAAK,YAAY,QAAQ;YACzB,MAAM,CAAC,KAAK,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC;YACjC,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,WAAW,CAAC,CACjC,CAAA;IACH,CAAC;CACF,CAAC,CAAA"}

package/dist/mjs/globals.js

@@ -1,6 +1,6 @@
 import { Patch } from '@nejs/extension';
 import { FunctionExtensions } from './functionextensions.js';
-const { isClass, isFunction } = FunctionExtensions.patchEntries.isClass.computed;
+const { isClass, isFunction } = FunctionExtensions.patches;
 const CustomInspect = Symbol.for('nodejs.util.inspect.custom');
 export const GlobalFunctionsAndProps = new Patch(globalThis, {
     /**
@@ -160,3 +160,4 @@ export const GlobalFunctionsAndProps = new Patch(globalThis, {
         return options;
     },
 });
+//# sourceMappingURL=globals.js.map