@hyperfrontend/list-utils 0.0.4 → 0.1.0

package/_dependencies/@hyperfrontend/immutable-api-utils/built-in-copy/object/index.esm.js

@@ -0,0 +1,5 @@
+const _Object = globalThis.Object;
+const freeze = _Object.freeze;
+const keys = _Object.keys;
+
+export { freeze, keys };

package/_dependencies/@hyperfrontend/immutable-api-utils/built-in-copy/set/index.cjs.js

@@ -0,0 +1,6 @@
+'use strict';
+
+const _Set = globalThis.Set;
+const _Reflect = globalThis.Reflect;
+const createSet = (iterable) => _Reflect.construct(_Set, iterable ? [iterable] : []);
+exports.createSet = createSet;

package/_dependencies/@hyperfrontend/immutable-api-utils/built-in-copy/set/index.esm.js

@@ -0,0 +1,5 @@
+const _Set = globalThis.Set;
+const _Reflect = globalThis.Reflect;
+const createSet = (iterable) => _Reflect.construct(_Set, iterable ? [iterable] : []);
+
+export { createSet };

package/bundle/index.iife.js

@@ -1,51 +1,19 @@
 var HyperfrontendListUtils = (function (exports) {
     'use strict';
 
-    /**
-     * Safe copies of Object built-in methods.
-     *
-     * These references are captured at module initialization time to protect against
-     * prototype pollution attacks. Import only what you need for tree-shaking.
-     *
-     * @module @hyperfrontend/immutable-api-utils/built-in-copy/object
-     */
-    // Capture references at module initialization time
+    const _Array = globalThis.Array;
+    const isArray = _Array.isArray;
+    const from = _Array.from;
+
+    const _Error = globalThis.Error;
+    const _Reflect$1 = globalThis.Reflect;
+    const createError = (message, options) => _Reflect$1.construct(_Error, [message, options]);
+
     const _Object = globalThis.Object;
-    /**
-     * (Safe copy) Prevents modification of existing property attributes and values,
-     * and prevents the addition of new properties.
-     */
     const freeze = _Object.freeze;
 
     const registeredClasses = [];
 
-    /**
-     * Safe copies of Array built-in static methods.
-     *
-     * These references are captured at module initialization time to protect against
-     * prototype pollution attacks. Import only what you need for tree-shaking.
-     *
-     * @module @hyperfrontend/immutable-api-utils/built-in-copy/array
-     */
-    // Capture references at module initialization time
-    const _Array = globalThis.Array;
-    /**
-     * (Safe copy) Determines whether the passed value is an Array.
-     */
-    const isArray = _Array.isArray;
-    /**
-     * (Safe copy) Creates an array from an array-like or iterable object.
-     */
-    const from = _Array.from;
-
-    /**
-     * Returns the data type of the target.
-     * Uses native `typeof` operator, however, makes distinction between `null`, `array`, and `object`.
-     * Also, when classes are registered via `registerClass`, it checks if objects are instance of any known registered class.
-     *
-     * @param target - The target to get the data type of.
-     * @returns The data type of the target.
-     */
     const getType = (target) => {
         if (target === null)
             return 'null';
@@ -61,67 +29,18 @@ var HyperfrontendListUtils = (function (exports) {
         return nativeDataType;
     };
 
-    /**
-     * Safe copies of Error built-ins via factory functions.
-     *
-     * Since constructors cannot be safely captured via Object.assign, this module
-     * provides factory functions that use Reflect.construct internally.
-     *
-     * These references are captured at module initialization time to protect against
-     * prototype pollution attacks. Import only what you need for tree-shaking.
-     *
-     * @module @hyperfrontend/immutable-api-utils/built-in-copy/error
-     */
-    // Capture references at module initialization time
-    const _Error = globalThis.Error;
-    const _Reflect$1 = globalThis.Reflect;
-    /**
-     * (Safe copy) Creates a new Error using the captured Error constructor.
-     * Use this instead of `new Error()`.
-     *
-     * @param message - Optional error message.
-     * @param options - Optional error options.
-     * @returns A new Error instance.
-     */
-    const createError = (message, options) => _Reflect$1.construct(_Error, [message, options]);
-
-    /**
-     * Safe copies of Set built-in via factory function.
-     *
-     * Since constructors cannot be safely captured via Object.assign, this module
-     * provides a factory function that uses Reflect.construct internally.
-     *
-     * These references are captured at module initialization time to protect against
-     * prototype pollution attacks. Import only what you need for tree-shaking.
-     *
-     * @module @hyperfrontend/immutable-api-utils/built-in-copy/set
-     */
-    // Capture references at module initialization time
     const _Set = globalThis.Set;
     const _Reflect = globalThis.Reflect;
-    /**
-     * (Safe copy) Creates a new Set using the captured Set constructor.
-     * Use this instead of `new Set()`.
-     *
-     * @param iterable - Optional iterable of values.
-     * @returns A new Set instance.
-     */
     const createSet = (iterable) => _Reflect.construct(_Set, iterable ? [iterable] : []);
 
-    /**
-     * Creates a FIFO (First-In-First-Out) list.
-     *
-     * @template T The type of elements in the list, must be an object.
-     * @returns {FifoList<T>} A FIFO list with methods to manipulate and query the list.
-     */
     function createFifoList() {
         const list = createSet();
         const push = (item) => {
             if (getType(item) !== 'object') {
-                throw createError('A fifo list only non-primitive values');
+                throw createError('A fifo list only supports non-primitive values');
             }
             if (list.has(item)) {
-                throw createError('Cannot a item that already exists');
+                throw createError('Cannot push an item that already exists in the list');
             }
             list.add(item);
         };
@@ -153,12 +72,6 @@ var HyperfrontendListUtils = (function (exports) {
         return freeze(result);
     }
 
-    /**
-     * Creates a LIFO (Last-In-First-Out) list.
-     *
-     * @template T The type of elements in the list, must be an object.
-     * @returns {LifoList<T>} A LIFO list with methods to manipulate and query the list.
-     */
     function createLifoList() {
         const list = createSet();
         const push = (item) => {
@@ -199,13 +112,6 @@ var HyperfrontendListUtils = (function (exports) {
         return freeze(result);
     }
 
-    /**
-     * Creates an array of numbers within a specified range (inclusive).
-     *
-     * @param start - The starting number of the range
-     * @param end - The ending number of the range (inclusive)
-     * @returns An array containing all numbers from start to end
-     */
     function createRange(start, end) {
         const range = [];
         for (let i = start; i <= end; i += 1) {
@@ -214,32 +120,16 @@ var HyperfrontendListUtils = (function (exports) {
         return range;
     }
 
-    /**
-     * Creates a value picker that cycles through a list of string values.
-     *
-     * @param values - The array of string values to cycle through
-     * @returns A ValuePicker instance with current and next methods
-     */
     function createValuePicker(values) {
         if (!values || !values.length) {
             throw createError('Expected values not to be an empty list.');
         }
         let index = -1;
-        /**
-         * Returns the current value without advancing the picker.
-         *
-         * @returns The current value in the list
-         */
         function current() {
             if (index < 0)
                 index = 0;
             return values[index];
         }
-        /**
-         * Advances to and returns the next value, cycling back to the start when reaching the end.
-         *
-         * @returns The next value in the list
-         */
         function next() {
             if (index < 0)
                 return current();
@@ -252,28 +142,15 @@ var HyperfrontendListUtils = (function (exports) {
         };
     }
 
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
     const getLastKeyInMap = (map) => {
         const items = [...map.keys()];
         return items[items.length - 1];
     };
 
-    /**
-     * Filters out empty, null, undefined, and whitespace-only strings from an array.
-     *
-     * @param values - The array of strings to filter
-     * @returns A new array containing only non-empty strings with content
-     */
     function nonEmptyStrings(values) {
         return values.filter((value) => ![undefined, null, ''].includes(value) && value.trim() !== '');
     }
 
-    /**
-     * Removes duplicate strings from an array, preserving insertion order.
-     *
-     * @param values - The array of strings to deduplicate
-     * @returns A new array containing only unique strings
-     */
     function uniqueStrings(values) {
         return from(createSet(values));
     }
@@ -289,4 +166,3 @@ var HyperfrontendListUtils = (function (exports) {
     return exports;
 
 })({});
-//# sourceMappingURL=index.iife.js.map

package/bundle/index.iife.min.js

@@ -1,2 +1 @@
-var HyperfrontendListUtils=function(e){"use strict";const t=globalThis.Object.freeze,r=[],n=globalThis.Array,o=n.isArray,i=n.from,l=e=>{if(null===e)return"null";const t=typeof e;if("object"===t){if(o(e))return"array";for(const t of r)if(e instanceof t)return t.name}return t},s=globalThis.Error,a=globalThis.Reflect,u=(e,t)=>a.construct(s,[e,t]),c=globalThis.Set,f=globalThis.Reflect,h=e=>f.construct(c,e?[e]:[]);return e.createFifoList=function(){const e=h();return t({push:t=>{if("object"!==l(t))throw u("A fifo list only non-primitive values");if(e.has(t))throw u("Cannot a item that already exists");e.add(t)},pull:()=>{const t=e.values().next().value;return e.delete(t),t},map:t=>i(e.values()).map(t),forEach:t=>{e.forEach(t)},remove:t=>e.delete(t),has:t=>e.has(t),size:()=>e.size,clear:()=>e.clear()})},e.createLifoList=function(){const e=h();return t({push:t=>{if("object"!==l(t))throw u("A lifo list only supports non-primitive values");e.add(t)},pull:()=>{const t=i(e).pop();return t&&e.delete(t),t},map:t=>i(e).map(t),forEach:t=>{e.forEach(t)},remove:t=>e.delete(t),has:t=>e.has(t),size:()=>e.size,clear:()=>{e.clear()}})},e.createRange=function(e,t){const r=[];for(let n=e;n<=t;n+=1)r.push(n);return r},e.createValuePicker=function(e){if(!e||!e.length)throw u("Expected values not to be an empty list.");let t=-1;function r(){return t<0&&(t=0),e[t]}return{current:r,next:function(){return t<0?r():(t=++t<e.length?t:0,e[t])}}},e.getLastKeyInMap=e=>{const t=[...e.keys()];return t[t.length-1]},e.nonEmptyStrings=function(e){return e.filter(e=>![void 0,null,""].includes(e)&&""!==e.trim())},e.uniqueStrings=function(e){return i(h(e))},e}({});
-//# sourceMappingURL=index.iife.min.js.map
+var HyperfrontendListUtils=function(e){"use strict";const t=globalThis.Array,r=t.isArray,n=t.from,o=globalThis.Error,i=globalThis.Reflect,s=(e,t)=>i.construct(o,[e,t]),l=globalThis.Object.freeze,a=[],u=e=>{if(null===e)return"null";const t=typeof e;if("object"===t){if(r(e))return"array";for(const t of a)if(e instanceof t)return t.name}return t},c=globalThis.Set,f=globalThis.Reflect,h=e=>f.construct(c,e?[e]:[]);return e.createFifoList=function(){const e=h();return l({push:t=>{if("object"!==u(t))throw s("A fifo list only supports non-primitive values");if(e.has(t))throw s("Cannot push an item that already exists in the list");e.add(t)},pull:()=>{const t=e.values().next().value;return e.delete(t),t},map:t=>n(e.values()).map(t),forEach:t=>{e.forEach(t)},remove:t=>e.delete(t),has:t=>e.has(t),size:()=>e.size,clear:()=>e.clear()})},e.createLifoList=function(){const e=h();return l({push:t=>{if("object"!==u(t))throw s("A lifo list only supports non-primitive values");e.add(t)},pull:()=>{const t=n(e).pop();return t&&e.delete(t),t},map:t=>n(e).map(t),forEach:t=>{e.forEach(t)},remove:t=>e.delete(t),has:t=>e.has(t),size:()=>e.size,clear:()=>{e.clear()}})},e.createRange=function(e,t){const r=[];for(let n=e;n<=t;n+=1)r.push(n);return r},e.createValuePicker=function(e){if(!e||!e.length)throw s("Expected values not to be an empty list.");let t=-1;function r(){return t<0&&(t=0),e[t]}return{current:r,next:function(){return t<0?r():(t=++t<e.length?t:0,e[t])}}},e.getLastKeyInMap=e=>{const t=[...e.keys()];return t[t.length-1]},e.nonEmptyStrings=function(e){return e.filter(e=>![void 0,null,""].includes(e)&&""!==e.trim())},e.uniqueStrings=function(e){return n(h(e))},e}({});

package/bundle/index.umd.js

@@ -4,51 +4,19 @@
     (global = typeof globalThis !== 'undefined' ? globalThis : global || self, factory(global.HyperfrontendListUtils = {}));
 })(this, (function (exports) { 'use strict';
 
-    /**
-     * Safe copies of Object built-in methods.
-     *
-     * These references are captured at module initialization time to protect against
-     * prototype pollution attacks. Import only what you need for tree-shaking.
-     *
-     * @module @hyperfrontend/immutable-api-utils/built-in-copy/object
-     */
-    // Capture references at module initialization time
+    const _Array = globalThis.Array;
+    const isArray = _Array.isArray;
+    const from = _Array.from;
+
+    const _Error = globalThis.Error;
+    const _Reflect$1 = globalThis.Reflect;
+    const createError = (message, options) => _Reflect$1.construct(_Error, [message, options]);
+
     const _Object = globalThis.Object;
-    /**
-     * (Safe copy) Prevents modification of existing property attributes and values,
-     * and prevents the addition of new properties.
-     */
     const freeze = _Object.freeze;
 
     const registeredClasses = [];
 
-    /**
-     * Safe copies of Array built-in static methods.
-     *
-     * These references are captured at module initialization time to protect against
-     * prototype pollution attacks. Import only what you need for tree-shaking.
-     *
-     * @module @hyperfrontend/immutable-api-utils/built-in-copy/array
-     */
-    // Capture references at module initialization time
-    const _Array = globalThis.Array;
-    /**
-     * (Safe copy) Determines whether the passed value is an Array.
-     */
-    const isArray = _Array.isArray;
-    /**
-     * (Safe copy) Creates an array from an array-like or iterable object.
-     */
-    const from = _Array.from;
-
-    /**
-     * Returns the data type of the target.
-     * Uses native `typeof` operator, however, makes distinction between `null`, `array`, and `object`.
-     * Also, when classes are registered via `registerClass`, it checks if objects are instance of any known registered class.
-     *
-     * @param target - The target to get the data type of.
-     * @returns The data type of the target.
-     */
     const getType = (target) => {
         if (target === null)
             return 'null';
@@ -64,67 +32,18 @@
         return nativeDataType;
     };
 
-    /**
-     * Safe copies of Error built-ins via factory functions.
-     *
-     * Since constructors cannot be safely captured via Object.assign, this module
-     * provides factory functions that use Reflect.construct internally.
-     *
-     * These references are captured at module initialization time to protect against
-     * prototype pollution attacks. Import only what you need for tree-shaking.
-     *
-     * @module @hyperfrontend/immutable-api-utils/built-in-copy/error
-     */
-    // Capture references at module initialization time
-    const _Error = globalThis.Error;
-    const _Reflect$1 = globalThis.Reflect;
-    /**
-     * (Safe copy) Creates a new Error using the captured Error constructor.
-     * Use this instead of `new Error()`.
-     *
-     * @param message - Optional error message.
-     * @param options - Optional error options.
-     * @returns A new Error instance.
-     */
-    const createError = (message, options) => _Reflect$1.construct(_Error, [message, options]);
-
-    /**
-     * Safe copies of Set built-in via factory function.
-     *
-     * Since constructors cannot be safely captured via Object.assign, this module
-     * provides a factory function that uses Reflect.construct internally.
-     *
-     * These references are captured at module initialization time to protect against
-     * prototype pollution attacks. Import only what you need for tree-shaking.
-     *
-     * @module @hyperfrontend/immutable-api-utils/built-in-copy/set
-     */
-    // Capture references at module initialization time
     const _Set = globalThis.Set;
     const _Reflect = globalThis.Reflect;
-    /**
-     * (Safe copy) Creates a new Set using the captured Set constructor.
-     * Use this instead of `new Set()`.
-     *
-     * @param iterable - Optional iterable of values.
-     * @returns A new Set instance.
-     */
     const createSet = (iterable) => _Reflect.construct(_Set, iterable ? [iterable] : []);
 
-    /**
-     * Creates a FIFO (First-In-First-Out) list.
-     *
-     * @template T The type of elements in the list, must be an object.
-     * @returns {FifoList<T>} A FIFO list with methods to manipulate and query the list.
-     */
     function createFifoList() {
         const list = createSet();
         const push = (item) => {
             if (getType(item) !== 'object') {
-                throw createError('A fifo list only non-primitive values');
+                throw createError('A fifo list only supports non-primitive values');
             }
             if (list.has(item)) {
-                throw createError('Cannot a item that already exists');
+                throw createError('Cannot push an item that already exists in the list');
             }
             list.add(item);
         };
@@ -156,12 +75,6 @@
         return freeze(result);
     }
 
-    /**
-     * Creates a LIFO (Last-In-First-Out) list.
-     *
-     * @template T The type of elements in the list, must be an object.
-     * @returns {LifoList<T>} A LIFO list with methods to manipulate and query the list.
-     */
     function createLifoList() {
         const list = createSet();
         const push = (item) => {
@@ -202,13 +115,6 @@
         return freeze(result);
     }
 
-    /**
-     * Creates an array of numbers within a specified range (inclusive).
-     *
-     * @param start - The starting number of the range
-     * @param end - The ending number of the range (inclusive)
-     * @returns An array containing all numbers from start to end
-     */
     function createRange(start, end) {
         const range = [];
         for (let i = start; i <= end; i += 1) {
@@ -217,32 +123,16 @@
         return range;
     }
 
-    /**
-     * Creates a value picker that cycles through a list of string values.
-     *
-     * @param values - The array of string values to cycle through
-     * @returns A ValuePicker instance with current and next methods
-     */
     function createValuePicker(values) {
         if (!values || !values.length) {
             throw createError('Expected values not to be an empty list.');
         }
         let index = -1;
-        /**
-         * Returns the current value without advancing the picker.
-         *
-         * @returns The current value in the list
-         */
         function current() {
             if (index < 0)
                 index = 0;
             return values[index];
         }
-        /**
-         * Advances to and returns the next value, cycling back to the start when reaching the end.
-         *
-         * @returns The next value in the list
-         */
         function next() {
             if (index < 0)
                 return current();
@@ -255,28 +145,15 @@
         };
     }
 
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
     const getLastKeyInMap = (map) => {
         const items = [...map.keys()];
         return items[items.length - 1];
     };
 
-    /**
-     * Filters out empty, null, undefined, and whitespace-only strings from an array.
-     *
-     * @param values - The array of strings to filter
-     * @returns A new array containing only non-empty strings with content
-     */
     function nonEmptyStrings(values) {
         return values.filter((value) => ![undefined, null, ''].includes(value) && value.trim() !== '');
     }
 
-    /**
-     * Removes duplicate strings from an array, preserving insertion order.
-     *
-     * @param values - The array of strings to deduplicate
-     * @returns A new array containing only unique strings
-     */
     function uniqueStrings(values) {
         return from(createSet(values));
     }
@@ -290,4 +167,3 @@
     exports.uniqueStrings = uniqueStrings;
 
 }));
-//# sourceMappingURL=index.umd.js.map

package/bundle/index.umd.min.js

@@ -1,2 +1 @@
-!function(e,t){"object"==typeof exports&&"undefined"!=typeof module?t(exports):"function"==typeof define&&define.amd?define(["exports"],t):t((e="undefined"!=typeof globalThis?globalThis:e||self).HyperfrontendListUtils={})}(this,function(e){"use strict";const t=globalThis.Object.freeze,n=[],r=globalThis.Array,o=r.isArray,i=r.from,s=e=>{if(null===e)return"null";const t=typeof e;if("object"===t){if(o(e))return"array";for(const t of n)if(e instanceof t)return t.name}return t},l=globalThis.Error,a=globalThis.Reflect,u=(e,t)=>a.construct(l,[e,t]),c=globalThis.Set,f=globalThis.Reflect,h=e=>f.construct(c,e?[e]:[]);e.createFifoList=function(){const e=h();return t({push:t=>{if("object"!==s(t))throw u("A fifo list only non-primitive values");if(e.has(t))throw u("Cannot a item that already exists");e.add(t)},pull:()=>{const t=e.values().next().value;return e.delete(t),t},map:t=>i(e.values()).map(t),forEach:t=>{e.forEach(t)},remove:t=>e.delete(t),has:t=>e.has(t),size:()=>e.size,clear:()=>e.clear()})},e.createLifoList=function(){const e=h();return t({push:t=>{if("object"!==s(t))throw u("A lifo list only supports non-primitive values");e.add(t)},pull:()=>{const t=i(e).pop();return t&&e.delete(t),t},map:t=>i(e).map(t),forEach:t=>{e.forEach(t)},remove:t=>e.delete(t),has:t=>e.has(t),size:()=>e.size,clear:()=>{e.clear()}})},e.createRange=function(e,t){const n=[];for(let r=e;r<=t;r+=1)n.push(r);return n},e.createValuePicker=function(e){if(!e||!e.length)throw u("Expected values not to be an empty list.");let t=-1;function n(){return t<0&&(t=0),e[t]}return{current:n,next:function(){return t<0?n():(t=++t<e.length?t:0,e[t])}}},e.getLastKeyInMap=e=>{const t=[...e.keys()];return t[t.length-1]},e.nonEmptyStrings=function(e){return e.filter(e=>![void 0,null,""].includes(e)&&""!==e.trim())},e.uniqueStrings=function(e){return i(h(e))}});
-//# sourceMappingURL=index.umd.min.js.map
+!function(e,t){"object"==typeof exports&&"undefined"!=typeof module?t(exports):"function"==typeof define&&define.amd?define(["exports"],t):t((e="undefined"!=typeof globalThis?globalThis:e||self).HyperfrontendListUtils={})}(this,function(e){"use strict";const t=globalThis.Array,n=t.isArray,r=t.from,o=globalThis.Error,i=globalThis.Reflect,s=(e,t)=>i.construct(o,[e,t]),l=globalThis.Object.freeze,a=[],u=e=>{if(null===e)return"null";const t=typeof e;if("object"===t){if(n(e))return"array";for(const t of a)if(e instanceof t)return t.name}return t},c=globalThis.Set,f=globalThis.Reflect,h=e=>f.construct(c,e?[e]:[]);e.createFifoList=function(){const e=h();return l({push:t=>{if("object"!==u(t))throw s("A fifo list only supports non-primitive values");if(e.has(t))throw s("Cannot push an item that already exists in the list");e.add(t)},pull:()=>{const t=e.values().next().value;return e.delete(t),t},map:t=>r(e.values()).map(t),forEach:t=>{e.forEach(t)},remove:t=>e.delete(t),has:t=>e.has(t),size:()=>e.size,clear:()=>e.clear()})},e.createLifoList=function(){const e=h();return l({push:t=>{if("object"!==u(t))throw s("A lifo list only supports non-primitive values");e.add(t)},pull:()=>{const t=r(e).pop();return t&&e.delete(t),t},map:t=>r(e).map(t),forEach:t=>{e.forEach(t)},remove:t=>e.delete(t),has:t=>e.has(t),size:()=>e.size,clear:()=>{e.clear()}})},e.createRange=function(e,t){const n=[];for(let r=e;r<=t;r+=1)n.push(r);return n},e.createValuePicker=function(e){if(!e||!e.length)throw s("Expected values not to be an empty list.");let t=-1;function n(){return t<0&&(t=0),e[t]}return{current:n,next:function(){return t<0?n():(t=++t<e.length?t:0,e[t])}}},e.getLastKeyInMap=e=>{const t=[...e.keys()];return t[t.length-1]},e.nonEmptyStrings=function(e){return e.filter(e=>![void 0,null,""].includes(e)&&""!==e.trim())},e.uniqueStrings=function(e){return r(h(e))}});