@hyperfrontend/list-utils 0.0.4 → 0.0.5

package/bundle/index.iife.js

@@ -1,24 +1,6 @@
 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 _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.
      *
@@ -27,7 +9,6 @@ var HyperfrontendListUtils = (function (exports) {
      *
      * @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.
@@ -38,29 +19,6 @@ var HyperfrontendListUtils = (function (exports) {
      */
     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';
-        const nativeDataType = typeof target;
-        if (nativeDataType === 'object') {
-            if (isArray(target))
-                return 'array';
-            for (const registeredClass of registeredClasses) {
-                if (target instanceof registeredClass)
-                    return registeredClass.name;
-            }
-        }
-        return nativeDataType;
-    };
-
     /**
      * Safe copies of Error built-ins via factory functions.
      *
@@ -72,7 +30,6 @@ var HyperfrontendListUtils = (function (exports) {
      *
      * @module @hyperfrontend/immutable-api-utils/built-in-copy/error
      */
-    // Capture references at module initialization time
     const _Error = globalThis.Error;
     const _Reflect$1 = globalThis.Reflect;
     /**
@@ -82,21 +39,69 @@ var HyperfrontendListUtils = (function (exports) {
      * @param message - Optional error message.
      * @param options - Optional error options.
      * @returns A new Error instance.
+     *
+     * @example Creating Error instances
+     * ```typescript
+     * const error = createError('Operation failed')
+     * // With cause for error chaining
+     * const wrapped = createError('Request failed', { cause: originalError })
+     * ```
      */
     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.
+     * 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
+     */
+    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 = [];
+
+    /**
+     * 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.
+     *
+     * @example Determining data types
+     * ```typescript
+     * getType([1, 2]) // 'array'
+     * getType({ a: 1 }) // 'object'
+     * getType(null) // 'null'
+     * ```
+     */
+    const getType = (target) => {
+        if (target === null)
+            return 'null';
+        const nativeDataType = typeof target;
+        if (nativeDataType === 'object') {
+            if (isArray(target))
+                return 'array';
+            for (const registeredClass of registeredClasses) {
+                if (target instanceof registeredClass)
+                    return registeredClass.name;
+            }
+        }
+        return nativeDataType;
+    };
+
+    /**
+     * Safe Set factory for protected set construction.
+     *
      * @module @hyperfrontend/immutable-api-utils/built-in-copy/set
      */
-    // Capture references at module initialization time
+    /* eslint-disable workspace/lib-require-jsdoc-example */
     const _Set = globalThis.Set;
     const _Reflect = globalThis.Reflect;
     /**
@@ -113,6 +118,17 @@ var HyperfrontendListUtils = (function (exports) {
      *
      * @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.
+     * @example Creating and using FIFO queue
+     * ```typescript
+     * interface Task { id: number; name: string }
+     * const queue = createFifoList<Task>()
+     *
+     * queue.push({ id: 1, name: 'first' })
+     * queue.push({ id: 2, name: 'second' })
+     *
+     * queue.pull() // => { id: 1, name: 'first' }
+     * queue.pull() // => { id: 2, name: 'second' }
+     * ```
      */
     function createFifoList() {
         const list = createSet();
@@ -158,6 +174,17 @@ var HyperfrontendListUtils = (function (exports) {
      *
      * @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.
+     * @example Creating and using LIFO stack
+     * ```typescript
+     * interface HistoryEntry { url: string; timestamp: number }
+     * const history = createLifoList<HistoryEntry>()
+     *
+     * history.push({ url: '/home', timestamp: 1 })
+     * history.push({ url: '/about', timestamp: 2 })
+     *
+     * history.pull() // => { url: '/about', timestamp: 2 }
+     * history.pull() // => { url: '/home', timestamp: 1 }
+     * ```
      */
     function createLifoList() {
         const list = createSet();
@@ -205,6 +232,14 @@ var HyperfrontendListUtils = (function (exports) {
      * @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
+     * @example Generating number ranges
+     * ```typescript
+     * createRange(1, 5)
+     * // => [1, 2, 3, 4, 5]
+     *
+     * createRange(3, 3)
+     * // => [3]
+     * ```
      */
     function createRange(start, end) {
         const range = [];
@@ -219,6 +254,16 @@ var HyperfrontendListUtils = (function (exports) {
      *
      * @param values - The array of string values to cycle through
      * @returns A ValuePicker instance with current and next methods
+     * @example Cycling through values
+     * ```typescript
+     * const colorPicker = createValuePicker(['red', 'green', 'blue'])
+     *
+     * colorPicker.current() // => 'red'
+     * colorPicker.next()    // => 'red' (first call initializes)
+     * colorPicker.next()    // => 'green'
+     * colorPicker.next()    // => 'blue'
+     * colorPicker.next()    // => 'red' (cycles back)
+     * ```
      */
     function createValuePicker(values) {
         if (!values || !values.length) {
@@ -252,7 +297,22 @@ var HyperfrontendListUtils = (function (exports) {
         };
     }
 
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    /* eslint-disable @typescript-eslint/no-explicit-any */
+    /**
+     * Retrieves the final key from a Map by converting keys to an array.
+     *
+     * @param map - The Map to extract the last key from
+     * @returns The key that was inserted last, or undefined if map is empty
+     * @example Getting last key from Map
+     * ```typescript
+     * const userRoles = new Map<string, string>()
+     * userRoles.set('alice', 'admin')
+     * userRoles.set('bob', 'editor')
+     * userRoles.set('charlie', 'viewer')
+     *
+     * getLastKeyInMap(userRoles) // => 'charlie'
+     * ```
+     */
     const getLastKeyInMap = (map) => {
         const items = [...map.keys()];
         return items[items.length - 1];
@@ -263,6 +323,11 @@ var HyperfrontendListUtils = (function (exports) {
      *
      * @param values - The array of strings to filter
      * @returns A new array containing only non-empty strings with content
+     * @example Filtering empty strings
+     * ```typescript
+     * nonEmptyStrings(['hello', '', '  ', 'world', null as unknown as string])
+     * // => ['hello', 'world']
+     * ```
      */
     function nonEmptyStrings(values) {
         return values.filter((value) => ![undefined, null, ''].includes(value) && value.trim() !== '');
@@ -273,6 +338,11 @@ var HyperfrontendListUtils = (function (exports) {
      *
      * @param values - The array of strings to deduplicate
      * @returns A new array containing only unique strings
+     * @example Deduplicating strings
+     * ```typescript
+     * uniqueStrings(['apple', 'banana', 'apple', 'cherry', 'banana'])
+     * // => ['apple', 'banana', 'cherry']
+     * ```
      */
     function uniqueStrings(values) {
         return from(createSet(values));
@@ -289,4 +359,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,l=(e,t)=>i.construct(o,[e,t]),s=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 s({push:t=>{if("object"!==u(t))throw l("A fifo list only non-primitive values");if(e.has(t))throw l("Cannot a item that already exists");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 s({push:t=>{if("object"!==u(t))throw l("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 l("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,24 +4,6 @@
     (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 _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.
      *
@@ -30,7 +12,6 @@
      *
      * @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.
@@ -41,29 +22,6 @@
      */
     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';
-        const nativeDataType = typeof target;
-        if (nativeDataType === 'object') {
-            if (isArray(target))
-                return 'array';
-            for (const registeredClass of registeredClasses) {
-                if (target instanceof registeredClass)
-                    return registeredClass.name;
-            }
-        }
-        return nativeDataType;
-    };
-
     /**
      * Safe copies of Error built-ins via factory functions.
      *
@@ -75,7 +33,6 @@
      *
      * @module @hyperfrontend/immutable-api-utils/built-in-copy/error
      */
-    // Capture references at module initialization time
     const _Error = globalThis.Error;
     const _Reflect$1 = globalThis.Reflect;
     /**
@@ -85,21 +42,69 @@
      * @param message - Optional error message.
      * @param options - Optional error options.
      * @returns A new Error instance.
+     *
+     * @example Creating Error instances
+     * ```typescript
+     * const error = createError('Operation failed')
+     * // With cause for error chaining
+     * const wrapped = createError('Request failed', { cause: originalError })
+     * ```
      */
     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.
+     * 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
+     */
+    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 = [];
+
+    /**
+     * 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.
+     *
+     * @example Determining data types
+     * ```typescript
+     * getType([1, 2]) // 'array'
+     * getType({ a: 1 }) // 'object'
+     * getType(null) // 'null'
+     * ```
+     */
+    const getType = (target) => {
+        if (target === null)
+            return 'null';
+        const nativeDataType = typeof target;
+        if (nativeDataType === 'object') {
+            if (isArray(target))
+                return 'array';
+            for (const registeredClass of registeredClasses) {
+                if (target instanceof registeredClass)
+                    return registeredClass.name;
+            }
+        }
+        return nativeDataType;
+    };
+
+    /**
+     * Safe Set factory for protected set construction.
+     *
      * @module @hyperfrontend/immutable-api-utils/built-in-copy/set
      */
-    // Capture references at module initialization time
+    /* eslint-disable workspace/lib-require-jsdoc-example */
     const _Set = globalThis.Set;
     const _Reflect = globalThis.Reflect;
     /**
@@ -116,6 +121,17 @@
      *
      * @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.
+     * @example Creating and using FIFO queue
+     * ```typescript
+     * interface Task { id: number; name: string }
+     * const queue = createFifoList<Task>()
+     *
+     * queue.push({ id: 1, name: 'first' })
+     * queue.push({ id: 2, name: 'second' })
+     *
+     * queue.pull() // => { id: 1, name: 'first' }
+     * queue.pull() // => { id: 2, name: 'second' }
+     * ```
      */
     function createFifoList() {
         const list = createSet();
@@ -161,6 +177,17 @@
      *
      * @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.
+     * @example Creating and using LIFO stack
+     * ```typescript
+     * interface HistoryEntry { url: string; timestamp: number }
+     * const history = createLifoList<HistoryEntry>()
+     *
+     * history.push({ url: '/home', timestamp: 1 })
+     * history.push({ url: '/about', timestamp: 2 })
+     *
+     * history.pull() // => { url: '/about', timestamp: 2 }
+     * history.pull() // => { url: '/home', timestamp: 1 }
+     * ```
      */
     function createLifoList() {
         const list = createSet();
@@ -208,6 +235,14 @@
      * @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
+     * @example Generating number ranges
+     * ```typescript
+     * createRange(1, 5)
+     * // => [1, 2, 3, 4, 5]
+     *
+     * createRange(3, 3)
+     * // => [3]
+     * ```
      */
     function createRange(start, end) {
         const range = [];
@@ -222,6 +257,16 @@
      *
      * @param values - The array of string values to cycle through
      * @returns A ValuePicker instance with current and next methods
+     * @example Cycling through values
+     * ```typescript
+     * const colorPicker = createValuePicker(['red', 'green', 'blue'])
+     *
+     * colorPicker.current() // => 'red'
+     * colorPicker.next()    // => 'red' (first call initializes)
+     * colorPicker.next()    // => 'green'
+     * colorPicker.next()    // => 'blue'
+     * colorPicker.next()    // => 'red' (cycles back)
+     * ```
      */
     function createValuePicker(values) {
         if (!values || !values.length) {
@@ -255,7 +300,22 @@
         };
     }
 
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    /* eslint-disable @typescript-eslint/no-explicit-any */
+    /**
+     * Retrieves the final key from a Map by converting keys to an array.
+     *
+     * @param map - The Map to extract the last key from
+     * @returns The key that was inserted last, or undefined if map is empty
+     * @example Getting last key from Map
+     * ```typescript
+     * const userRoles = new Map<string, string>()
+     * userRoles.set('alice', 'admin')
+     * userRoles.set('bob', 'editor')
+     * userRoles.set('charlie', 'viewer')
+     *
+     * getLastKeyInMap(userRoles) // => 'charlie'
+     * ```
+     */
     const getLastKeyInMap = (map) => {
         const items = [...map.keys()];
         return items[items.length - 1];
@@ -266,6 +326,11 @@
      *
      * @param values - The array of strings to filter
      * @returns A new array containing only non-empty strings with content
+     * @example Filtering empty strings
+     * ```typescript
+     * nonEmptyStrings(['hello', '', '  ', 'world', null as unknown as string])
+     * // => ['hello', 'world']
+     * ```
      */
     function nonEmptyStrings(values) {
         return values.filter((value) => ![undefined, null, ''].includes(value) && value.trim() !== '');
@@ -276,6 +341,11 @@
      *
      * @param values - The array of strings to deduplicate
      * @returns A new array containing only unique strings
+     * @example Deduplicating strings
+     * ```typescript
+     * uniqueStrings(['apple', 'banana', 'apple', 'cherry', 'banana'])
+     * // => ['apple', 'banana', 'cherry']
+     * ```
      */
     function uniqueStrings(values) {
         return from(createSet(values));
@@ -290,4 +360,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 non-primitive values");if(e.has(t))throw s("Cannot a item that already exists");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))}});