@nejs/basic-extensions 2.21.0 → 2.22.6

package/dist/mjs/classes/property.js

@@ -1,280 +0,0 @@
-import { Extension } from '@nejs/extension';
-export class Property {
-    constructor(key, descriptor) {
-        if (key.startsWith(':'))
-            key = Symbol.for(key.slice(1));
-        if (typeof key !== 'string' && typeof key !== 'symbol') {
-            throw new TypeError('Key or symbol or :symbol must be supplied!');
-        }
-        this.key = key;
-        if (!Property.is.descriptor(descriptor)) {
-            this.descriptor = {
-                value: descriptor,
-                writable: true,
-                configurable: true,
-                enumerable: true,
-            };
-        }
-        else {
-            this.descriptor = descriptor;
-        }
-    }
-    apply(toObject, asKey) {
-        if (!toObject || !['object', 'function'].some(k => k == typeof toObject))
-            return;
-        return Object.defineProperty(toObject, asKey ?? this.key, this.descriptor);
-    }
-    get descriptor() {
-        const baseline = { configurable: true, enumerable: false };
-        const result = {
-            enumerable: this.meta.enumerable,
-            configurable: this.meta.configurable,
-        };
-        if (this.is.accessor) {
-            result.get = this.meta.accessor.get;
-            result.set = this.meta.accessor.set;
-        }
-        else {
-            result.value = this.meta.data.value;
-            result.writable = this.meta.data.writable;
-        }
-        return Object.defineProperties(result, {
-            make: {
-                ...baseline,
-                get() {
-                    const self = this;
-                    return {
-                        get enumerable() { self.enumerable = true; return self; },
-                        get hidden() { self.enumerable = false; return self; },
-                        get writable() { self.writable = true; return self; },
-                        get readonly() { self.writable = false; return self; },
-                        get configurable() { self.configurable = true; return self; },
-                        get immutable() { self.configurable = false; return self; },
-                    };
-                }
-            },
-            is: {
-                ...baseline,
-                get() {
-                    const self = this;
-                    return {
-                        get accessor() { return self.is.accssor; },
-                        get data() { return self.is.data; }
-                    };
-                }
-            },
-        });
-    }
-    set descriptor(descriptor) {
-        const { is } = this.constructor;
-        if (!is.descriptor(descriptor))
-            return;
-        this.meta.configurable = descriptor.configurable ?? true;
-        this.meta.enumerable = descriptor.enumerable ?? true;
-        if (Reflect.has(descriptor, 'get') || Reflect.has(descriptor, 'set')) {
-            const { get, set } = descriptor;
-            if (get !== undefined)
-                this.meta.accessor.get = get;
-            if (set !== undefined)
-                this.meta.accessor.set = set;
-        }
-        else {
-            const { value, writable } = descriptor;
-            this.meta.data.value = value;
-            this.meta.data.writable = writable ?? true;
-        }
-    }
-    get is() {
-        const self = this;
-        return {
-            get accessor() {
-                return !!(self.meta.accessor.get ||
-                    self.meta.accessor.set);
-            },
-            get data() {
-                return !!!this.accessor;
-            },
-        };
-    }
-    toString(colors = false, { key, descriptor } = {}) {
-        const bold = s => colors ? `\x1b[1m${s}\x1b[22m` : s;
-        const dim = s => colors ? `\x1b[2m${s}\x1b[22m` : s;
-        const red = s => colors ? `\x1b[31m${s}\x1b[39m` : s;
-        const green = s => colors ? `\x1b[32m${s}\x1b[39m` : s;
-        const blue = s => colors ? `\x1b[34m${s}\x1b[39m` : s;
-        if (!key)
-            ({ key } = this);
-        if (!descriptor || !Property.is.descriptor(descriptor))
-            ({ descriptor } = this);
-        const buffer = [`${bold(key)} { `];
-        const keyPresent = (object) => (key) => Reflect.has(object, key);
-        const eqeq = (value, compare = (a, b) => a === b) => (element) => compare(element, value);
-        if (['get', 'set'].some(keyPresent(descriptor))) {
-            if (descriptor.get) {
-                buffer.push(blue('getter'));
-                if (descriptor.set) {
-                    buffer.push(bold('|'));
-                }
-            }
-            if (descriptor.set) {
-                buffer.push(blue('setter'));
-            }
-        }
-        else {
-            buffer.push(green('value'));
-            buffer.push(bold('|'));
-            buffer.push(descriptor.writable ? green('writable') : red('readonly'));
-        }
-        buffer.push(' ');
-        buffer.push(descriptor.configurable ? green('mutable') : red('immuatable'));
-        buffer.push(' ');
-        buffer.push(descriptor.enumerable ? green('visible') : red('hidden'));
-        buffer.push(' }');
-        return buffer.join('');
-    }
-    [Symbol.for('nodejs.util.inspect.custom')](depth, options, inspect) {
-        return this.toString(true);
-    }
-    /**
-     * Creates an accessor property with customizable getter and setter functions.
-     *
-     * This method offers flexible ways to define accessor properties, including
-     * support for storage-based getters and setters. It can handle various input
-     * formats, making it versatile for different use cases.
-     *
-     * @param {string} name - The name of the accessor property.
-     * @param {Object} accessors - Object containing getter and/or setter functions.
-     * @param {Function} [accessors.get] - Getter function for the property.
-     * @param {Function} [accessors.set] - Setter function for the property.
-     * @param {Object} [accessors.prototype] - Prototype object for getter/setter.
-     * @param {Object} [options] - Additional options for the accessor property.
-     * @param {boolean} [options.configurable=true] - Whether property is configurable.
-     * @param {boolean} [options.enumerable=true] - Whether property is enumerable.
-     * @param {Object} [options.storage] - Storage object for getter/setter closures.
-     * @returns {Property} A new Property instance representing the accessor.
-     * @throws {TypeError} If no name, getter, or setter is provided.
-     *
-     * @example
-     * // Basic usage
-     * Property.accessor('color', {
-     *   get() { return this._color; },
-     *   set(value) { this._color = value; }
-     * });
-     *
-     * @example
-     * // Using storage
-     * Property.accessor('keyword', {
-     *   get(storage) { return () => storage.keyword; },
-     *   set(storage) { return (value) => { storage.keyword = value; } }
-     * }, { storage: { keyword: 'initial' } });
-     *
-     * @example
-     * // Using named getter function
-     * Property.accessor('color', function get() { return 'red' })
-     *
-     * @example
-     * // Using prototype
-     * const ColorAccessors = {
-     *   red: { get() { return this._red; } }
-     * };
-     * Property.accessor('red', ColorAccessors.red);
-     */
-    static accessor(name, { get, set, prototype }, { configurable, enumerable, storage } = {}) {
-        if (!get && !set && prototype) {
-            const constructor = prototype?.constructor;
-            if (constructor?.name === 'get') {
-                get = constructor;
-            }
-            else if (constructor?.name === 'set') {
-                set = constructor;
-            }
-        }
-        if (get && storage && get.length == 1) {
-            get = get(storage);
-        }
-        if (set && storage && set.length == 1) {
-            set = set(storage);
-        }
-        if (!name && !get && !set)
-            throw new TypeError('Cannot create accessor');
-        configurable ??= true;
-        enumerable ??= true;
-        return new Property(name, { get, set, configurable, enumerable });
-    }
-    static data(name, value, { writable, configurable, enumerable } = {}) {
-        if (!name)
-            throw new TypeError('Cannot create data property without name');
-        writable ??= true;
-        configurable ??= true;
-        enumerable ??= true;
-        return new Property(name, { value, writable, configurable, enumerable });
-    }
-    static from(object, name) {
-        const descriptor = Object.getOwnPropertyDescriptor(object, name);
-        return new Property(name, descriptor);
-    }
-    static get is() {
-        return {
-            object(value) {
-                return value && ['object', 'function'].some(k => k == typeof value);
-            },
-            descriptor(object) {
-                if (!Property.is.object(object)) {
-                    return false;
-                }
-                const present = element => Reflect.has(object, element);
-                const props = {
-                    base: ['configurable', 'enumerable'],
-                    data: ['writable', 'value'],
-                    accessor: ['get', 'set'],
-                };
-                if (Object.getOwnPropertyNames(object).length > 4)
-                    return false;
-                if (props.data.some(present) && props.accessor.some(present))
-                    return false;
-                if (props.base.some(present))
-                    return true;
-                if (props.data.some(present))
-                    return true;
-                if (props.accessor.some(present))
-                    return true;
-                return false;
-            }
-        };
-    }
-    static {
-        const storage = Object.assign(Object.create(null), {
-            key: undefined,
-            meta: {
-                enumerable: true,
-                configurable: true,
-                accessor: {
-                    get: undefined,
-                    set: undefined
-                },
-                data: {
-                    value: undefined,
-                    writable: true
-                },
-            },
-        });
-        basic_accessor(this.prototype, 'key', storage.key, storage);
-        basic_accessor(this.prototype, 'meta', storage.meta, storage);
-    }
-}
-export const PropertyExtensions = new Extension(Property);
-function basic_accessor(prototype, key, initialValue, storage = {}) {
-    storage[key] = initialValue;
-    Object.defineProperty(prototype, key, {
-        get() {
-            return storage[key];
-        },
-        set(value) {
-            storage[key] = value;
-        },
-        enumerable: true,
-        configurable: true,
-    });
-    return Object.getOwnPropertyDescriptor(prototype, key);
-}
-//# sourceMappingURL=property.js.map

package/dist/mjs/classes/property.js.map

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

package/dist/mjs/classes/refmap.d.ts

@@ -1,238 +0,0 @@
-/**
- * RefMap class extends the standard Map object to manage a collection of
- * WeakRef values mapped to strong keys. It provides additional functionality
- * such as objectification of values and various utility methods.
- *
- * Unlike standard Maps or Objects, RefMap stores weak references to objects,
- * allowing them to be garbage-collected if there are no other references to
- * them. This behavior is different from Maps and standard Objects, which
- * maintain strong references to their elements.
- *
- * @extends Map
- */
-export class RefMap extends Map<any, any> {
-    constructor(...args: any[]);
-    /**
-     * Method to control whether the RefMap 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 {RefMap} - The current RefMap instance to allow method chaining.
-     */
-    objectifying(setObjectification?: boolean): RefMap;
-    /**
-     * Setting this value to true, will cause all set values to the Map 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.
-     *
-     * @param {boolean} value - The new state to set for objectifyValues.
-     */
-    set objectifyValues(value: boolean);
-    /**
-     * Returns the state indicating whether or not `RefMap` 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;
-    /**
-     * The function converts a JavaScript Map object into a regular JavaScript
-     * object, handling invalid keys by converting them to strings.
-     *
-     * @returns {object} an object; keys that are not either a `String` or a
-     * `Symbol` will be converted to a string.
-     */
-    asObject(): object;
-    /**
-     * The `get` function retrieves a value from a map and returns it, or returns a
-     * default value if the value is null or undefined. The actual retrieved value
-     * is a dereferenced `WeakRef`. If the result is `undefined` and this is not the
-     * expected response, it is likely the value has been garbage collected.
-     *
-     * @param {any} key - The key parameter is the key of the value you want to
-     * retrieve from the data structure.
-     * @param {any} defaultValue - The `defaultValue` parameter is the value that
-     * will be returned if the key does not exist in the map or if the value
-     * associated with the key has been garbage collected (i.e., it no longer
-     * exists).
-     * @returns The method is returning the value associated with the given key.
-     * If the value is not found or if it has been garbage collected (deref()
-     * returns null), then the defaultValue is returned.
-     */
-    get(key: any, defaultValue: any): any;
-    /**
-     * Overrides the set method of `Map`. Adds a value to the `RefMap`,
-     * 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 {@link objectifyValues} is enabled, an attempt to convert
-     * primitives to their object variants will be made. These are `numbers`,
-     * `strings`, `boolean` values and `bigint`s.
-     *
-     * @param {*} key - The `key` to be set on the `RefMap`
-     * @param {*} value - The value to be associated with the `key`
-     * @throws {TypeError} If the value is not a valid WeakRef target.
-     */
-    set(key: any, value: any): void;
-    /**
-     * Sets multiple values at a single time. The format is an array of array
-     * or rather an array of {@link Object.entries} (for example,
-     * `[[key1,value1], [key2,value2]]`). For each entry pair, if the length
-     * is not 2, either missing a key or value, it will be skipped.
-     *
-     * @param {Iterable} values - An iterable of values to add to the RefMap.
-     * @throws {TypeError} If the supplied values are falsey or non-iterable.
-     * @returns {RepMap} returns `this` to allow for chaining
-     */
-    setAll(entries: any): RepMap;
-    /**
-     * Removes all elements from the RefMap that have been garbage collected
-     * (i.e., their WeakRef no longer points to an object).
-     *
-     * @returns {RefMap} - The current RefMap instance to allow method chaining.
-     */
-    clean(): RefMap;
-    /**
-     * Executes a provided function once for each value in the RefMap. The callback
-     * function receives the dereferenced value, the value again (as RefMap doesn't
-     * use keys), and the RefMap itself. This method provides a way to iterate over
-     * and apply operations to the values stored in the RefMap, 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 RefMap has no key), and
-     * the RefMap itself.
-     * @param {*} thisArg - Value to use as `this` when executing `forEachFn`.
-     */
-    entries(): Iterator;
-    /**
-     * Iterate over the items in the map and pass them to the supplied
-     * function ala `Map.prototype.forEach`. Note however, there are no
-     * indexes on Maps and as such, the index parameter of the callback
-     * will always be the value's key. Subsequently the `array` or third
-     * parameter will receive the map 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 RefMap. 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 Map 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;
-    /**
-     * Determines whether an element with the specified value exists in the
-     * `RefMap`. For non-objectified sets, this method checks if the dereferenced
-     * values of the map include the specified value.
-     *
-     * For objectified sets, strict is set to false which uses loose
-     * equality to allow for things like `Object(5)` to equal `5`. This is important
-     * because otherwise primitives could not be weakly referenced. In the grand
-     * scheme of things, this is only useful if the objectified value is the
-     * one being referenced.
-     *
-     * @param {*} value - The value to check for presence in the RefMap.
-     * @param {boolean} strict - if `true`, the default, then the supplied value
-     * is hard compared to the dereferenced value (`===`). If `false`, then a
-     * loose comparison is used (`==`)
-     * @returns {boolean} - True if an element with the specified value exists
-     * in the RefMap, false otherwise.
-     */
-    hasValue(value: any, strict?: boolean): boolean;
-    /**
-     * The `filter` function filters the entries of a `RefMap` object based on
-     * a given filter function. The dereferenced entries of the values of the map
-     * will be passed to the function rather than a `WeakRef` itself.
-     *
-     * A new resulting entry set will be generated and a new `RefMap` will be made
-     * from these entries and returned. Note that this function never returns
-     * `null`
-     *
-     * @param {function} filterFn - The `filterFn` parameter is a function that
-     * will be used to filter the entries in the `RefMap`. It will be called with
-     * three arguments: the value of the current entry, the key of the current
-     * entry, and the `RefMap` itself. The function should return `true`
-     * @param {object} thisArg - The `thisArg` parameter is an optional argument
-     * that specifies the value to be used as `this` when executing the
-     * `filterFn` function. It allows you to explicitly set the context in which
-     * the `filterFn` function is called. If `thisArg` is not provided, `this
-     * @returns {array} The `filter` method is returning an array of filtered map
-     * entries
-     */
-    filter(filterFn: Function, thisArg: object): array;
-    /**
-     * The `find` function iterates over a map and calls a given function on
-     * each value, returning the first value for which the function returns
-     * a truthy value.
-     *
-     * The function signature of `findFn` is
-     * ```
-     * function findFn(value, key, map)
-     * ```
-     * 'value' is passed to findFn up to two times; first with the `WeakRef`
-     * value, second with the result of {@link WeakRef.deref}. If `findFn`
-     * returns true for either of these the dereferenced value will be
-     * returned from the call to {@link RefMap.find}.
-     * `key` represents the key object that the value is mapped to.
-     * `map` is simply a reference to `this` map.
-     *
-     * @param findFn - `findFn` is a function that will be called for each
-     * element in the map. It takes three arguments: `ref`, `key`, and `map`;
-     * where `ref` is the value of the current element in the map, `key` is
-     * the key of the current element, and `map` is a reference to the instance
-     * being searched.
-     * @param thisArg - The `thisArg` parameter is the value to be used as
-     * the `this` value when executing the `findFn` function. It allows you
-     * to specify the context in which the `findFn` function should be called.
-     * @returns the first dereferenced value that satisfies the condition
-     * specified by the `findFn` function. If no value satisfies the condition,
-     * it returns `null`.
-     */
-    find(findFn: any, thisArg: any): any;
-    /**
-     * Creates a new array or `RefMap` with the results of calling a provided
-     * function on every element in the calling `RefMap`. This method dereferences
-     * each value, applies the `mapFn`, and collects the results. If `toRefMap` is
-     * `true`, a new `RefMap` is returned; otherwise, an array. This method
-     * differs from `Array.map` in handling weak references and the potential to
-     * return a new `RefMap` instead of an array.
-     *
-     * @param {Function} mapFn - Function that produces an element of the new
-     * array or `RefMap`, taking three arguments.
-     * @param {*} thisArg - Value to use as this when executing mapFn.
-     * @param {boolean} toRefMap - Determines if the output should be a new
-     * `RefMap` (`true`) or an array (`false`).
-     * @param {boolean} mirrorObjectification - If `true` and `toRefMap` is
-     * `true`, the new `RefMap` mirrors the objectification setting of the
-     * original.
-     * @returns {Array|RefMap} - A new array or `RefMap` with each element being
-     * the result of the `mapFn`.
-     */
-    map(mapFn: Function, thisArg: any, toRefMap: boolean, mirrorObjectification: boolean): any[] | RefMap;
-    /**
-     * The function returns an iterator that iterates over the entries of an object,
-     * dereferencing any weak references.
-     *
-     * @returns {Iterator} A new iterator object is being returned.
-     */
-    [Symbol.iterator](): Iterator;
-    #private;
-}
-export const RefMapExtensions: Extension;
-import { Iterator } from './iterable.js';
-import { Extension } from '@nejs/extension';