@hyperfrontend/list-utils 0.1.0 → 0.1.1

package/CHANGELOG.md

@@ -2,6 +2,12 @@
 
 All notable changes to this project will be documented in this file.
 
+## [0.1.1](https://github.com/AndrewRedican/hyperfrontend/compare/29dc54d58c2b3c8b8dd35f7c546ebc6cd9191f6e...adf0a4f77dece2be855e7ab88185a4fe84e7b16b) - 2026-09-14
+
+### Bug Fixes
+
+- accept arrays, functions and class instances in fifo and lifo lists
+
 ## [0.1.0](https://github.com/AndrewRedican/hyperfrontend/compare/5f116abb8ba6355dfb283fa03b7481e5eb029480...cc16961a470190848f71a7cce41f7377bc4511a4) - 2026-08-25
 
 ### Breaking Changes

package/README.md

@@ -1,4 +1,8 @@
-# @hyperfrontend/list-utils
+<p align="center">
+  <a href="https://www.hyperfrontend.dev/docs/libraries/utils/list/">
+    <img width="640" height="180" src="https://www.hyperfrontend.dev/media/banner-list-utils/banner.gif" alt="@hyperfrontend/list-utils">
+  </a>
+</p>
 
 <p align="center">
   <a href="https://github.com/AndrewRedican/hyperfrontend/actions/workflows/ci-lib-list-utils.yml">
@@ -33,6 +37,12 @@
   <img src="https://img.shields.io/badge/tree%20shakeable-%E2%9C%93-success?style=flat-square" alt="Tree Shakeable">
 </p>
 
+<p align="center">
+  <a href="https://www.hyperfrontend.dev/docs/libraries/utils/list/">
+    <img width="640" height="360" src="https://www.hyperfrontend.dev/media/list-utils-order/hero.gif" alt="A tube open at both ends and a cup open only at the top, with the same three numbered discs dropped into each; three pulls take the discs out, the tube from its bottom and the cup from its top, and the exit rows read 1 2 3 under the tube and 3 2 1 beside the cup">
+  </a>
+</p>
+
 Purpose-built collection utilities for queue management, filtering, and iteration patterns.
 
 • 👉 See [**documentation**](https://www.hyperfrontend.dev/docs/libraries/utils/list/)
@@ -46,16 +56,16 @@ The library enforces immutability through frozen interfaces while maintaining hi
 
 ### Key Features
 
-- **FIFO and LIFO queues** with type-safe object tracking
-- **Value picker** for cyclical iteration (ideal for round-robin patterns)
-- **String sanitization** utilities (dedupe, trim, filter empty)
-- **Range generation** for loop-free number sequences
-- **Map utilities** for common Map operations
+- **[FIFO and LIFO queues](https://www.hyperfrontend.dev/docs/libraries/utils/list/#api-createFifoList)** with type-safe object tracking
+- **[Value picker](https://www.hyperfrontend.dev/docs/libraries/utils/list/#api-createValuePicker)** for cyclical iteration (ideal for round-robin patterns)
+- **[String sanitization](https://www.hyperfrontend.dev/docs/libraries/utils/list/#api-uniqueStrings)** utilities (dedupe, trim, filter empty)
+- **[Range generation](https://www.hyperfrontend.dev/docs/libraries/utils/list/#api-createRange)** for loop-free number sequences
+- **[Map utilities](https://www.hyperfrontend.dev/docs/libraries/utils/list/#api-getLastKeyInMap)** for common Map operations
 - **Zero dependencies** - Self-contained implementation with no third-party runtime dependencies
 
 ### Architecture Highlights
 
-Queue implementations return frozen objects to prevent external mutation while using native `Set` internally for optimal performance. Object-only restriction on queues prevents reference comparison issues with primitives.
+Both queue kinds hold object references only: pushing a primitive throws at runtime, not just at compile time. Membership is reference identity, so two structurally identical objects are two separate entries, and `has()` and `remove()` need the same reference you pushed.
 
 ## Why Use @hyperfrontend/list-utils?
 
@@ -99,40 +109,28 @@ colorPicker.next() // 'blue'
 colorPicker.next() // 'green'
 colorPicker.next() // 'red' (cycles back)
 
-// String sanitization
+// String sanitization: blanks are dropped, survivors keep their original padding
 const userInputs = ['  hello  ', '', 'world', null, 'hello', '   ', 'world']
-const cleaned = uniqueStrings(nonEmptyStrings(userInputs)) // ['hello', 'world']
+const cleaned = uniqueStrings(nonEmptyStrings(userInputs)) // ['  hello  ', 'world', 'hello']
 ```
 
 ## API Overview
 
-### Queue Management
+Two ordered collections plus a few standalone helpers; the collections are the place to start. [`createFifoList`](https://www.hyperfrontend.dev/docs/libraries/utils/list/#api-createFifoList) and [`createLifoList`](https://www.hyperfrontend.dev/docs/libraries/utils/list/#api-createLifoList) each take no arguments, are generic over an object type, and return a frozen instance with the same fixed method surface: [`push`](https://www.hyperfrontend.dev/docs/libraries/utils/list/#api-FifoList), [`pull`](https://www.hyperfrontend.dev/docs/libraries/utils/list/#api-FifoList), [`map`](https://www.hyperfrontend.dev/docs/libraries/utils/list/#api-FifoList), [`forEach`](https://www.hyperfrontend.dev/docs/libraries/utils/list/#api-FifoList), [`remove`](https://www.hyperfrontend.dev/docs/libraries/utils/list/#api-FifoList), [`has`](https://www.hyperfrontend.dev/docs/libraries/utils/list/#api-FifoList), [`size`](https://www.hyperfrontend.dev/docs/libraries/utils/list/#api-FifoList) and [`clear`](https://www.hyperfrontend.dev/docs/libraries/utils/list/#api-FifoList). Choosing one factory over the other decides which end `pull()` reads from and nothing else about the surrounding code. They diverge on one point, deliberately: pushing an item a FIFO list already holds throws, surfacing a queue that would otherwise take the same job twice, whereas a LIFO list ignores the duplicate and leaves the item where it already was.
 
-- **`createFifoList<T>()`** - First-in-first-out queue with reference uniqueness
-- **`createLifoList<T>()`** - Last-in-first-out stack with reference uniqueness
+Both are backed by a `Set` of the references you pushed, which has two consequences to know before reaching for either. A primitive is rejected at runtime, not only by the type parameter. And membership is reference identity, so two structurally identical objects are two entries, and `has()` and `remove()` want back the exact reference you handed over.
 
-### Iteration Utilities
+The helpers are independent of the lists and of each other. [`createValuePicker`](https://www.hyperfrontend.dev/docs/libraries/utils/list/#api-createValuePicker) wraps a non-empty string array in a `current()` and `next()` pair that cycles forever, while [`createRange`](https://www.hyperfrontend.dev/docs/libraries/utils/list/#api-createRange) returns an inclusive run of numbers. For string arrays, [`nonEmptyStrings`](https://www.hyperfrontend.dev/docs/libraries/utils/list/#api-nonEmptyStrings) drops null, undefined, empty and whitespace-only entries but returns the survivors exactly as they arrived: it tests `value.trim()`, it does not trim, so padded values come through padded and [`uniqueStrings`](https://www.hyperfrontend.dev/docs/libraries/utils/list/#api-uniqueStrings) then dedupes on exact string equality, which leaves `'  hello  '` and `'hello'` as two distinct results. The last helper, [`getLastKeyInMap`](https://www.hyperfrontend.dev/docs/libraries/utils/list/#api-getLastKeyInMap), reads the most recently inserted key of a `Map`.
 
-- **`createValuePicker(values)`** - Cyclical iterator for round-robin patterns
-- **`createRange(start, end)`** - Generate number arrays without loops
-
-### String Utilities
-
-- **`nonEmptyStrings(values)`** - Filter null/undefined/empty/whitespace strings
-- **`uniqueStrings(values)`** - Remove duplicates while preserving order
-
-### Map Helpers
-
-- **`getLastKeyInMap(map)`** - Retrieve the last inserted key from a Map
+Every signature, type parameter and thrown error is in the [API reference](https://www.hyperfrontend.dev/docs/libraries/utils/list/#api-reference).
 
 ## Compatibility
 
-| Platform                      | Support |
-| ----------------------------- | :-----: |
-| Browser                       |   ✅    |
-| Node.js                       |   ✅    |
-| Web Workers                   |   ✅    |
-| Deno, Bun, Cloudflare Workers |   ✅    |
+<p align="center">
+  <a href="https://www.hyperfrontend.dev/docs/libraries/utils/list/#compatibility">
+    <img width="640" height="150" src="https://www.hyperfrontend.dev/media/runtimes-list-utils/runtimes.png" alt="Runs in Node.js 18 or later, evergreen browsers and web workers">
+  </a>
+</p>
 
 ### Output Formats
 
@@ -157,7 +155,7 @@ const cleaned = uniqueStrings(nonEmptyStrings(userInputs)) // ['hello', 'world']
 </script>
 ```
 
-**Global variable:** `HyperfrontendListUtils`
+**Global variable:** [`HyperfrontendListUtils`](https://www.hyperfrontend.dev/docs/libraries/utils/list/)
 
 ## Part of hyperfrontend
 

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

@@ -1,7 +1,5 @@
 'use strict';
 
 const _Array = globalThis.Array;
-const isArray = _Array.isArray;
 const from = _Array.from;
 exports.from = from;
-exports.isArray = isArray;

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

@@ -1,5 +1,4 @@
 const _Array = globalThis.Array;
-const isArray = _Array.isArray;
 const from = _Array.from;
 
-export { from, isArray };
+export { from };

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

@@ -2,6 +2,4 @@
 
 const _Object = globalThis.Object;
 const freeze = _Object.freeze;
-const keys = _Object.keys;
 exports.freeze = freeze;
-exports.keys = keys;

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

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

package/bundle/index.iife.js

@@ -2,7 +2,6 @@ var HyperfrontendListUtils = (function (exports) {
     'use strict';
 
     const _Array = globalThis.Array;
-    const isArray = _Array.isArray;
     const from = _Array.from;
 
     const _Error = globalThis.Error;
@@ -12,31 +11,15 @@ var HyperfrontendListUtils = (function (exports) {
     const _Object = globalThis.Object;
     const freeze = _Object.freeze;
 
-    const registeredClasses = [];
-
-    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;
-    };
-
     const _Set = globalThis.Set;
     const _Reflect = globalThis.Reflect;
     const createSet = (iterable) => _Reflect.construct(_Set, iterable ? [iterable] : []);
 
+    const isNonPrimitive$1 = (value) => (typeof value === 'object' && value !== null) || typeof value === 'function';
     function createFifoList() {
         const list = createSet();
         const push = (item) => {
-            if (getType(item) !== 'object') {
+            if (!isNonPrimitive$1(item)) {
                 throw createError('A fifo list only supports non-primitive values');
             }
             if (list.has(item)) {
@@ -72,10 +55,11 @@ var HyperfrontendListUtils = (function (exports) {
         return freeze(result);
     }
 
+    const isNonPrimitive = (value) => (typeof value === 'object' && value !== null) || typeof value === 'function';
     function createLifoList() {
         const list = createSet();
         const push = (item) => {
-            if (getType(item) !== 'object') {
+            if (!isNonPrimitive(item)) {
                 throw createError('A lifo list only supports non-primitive values');
             }
             list.add(item);

package/bundle/index.iife.min.js

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

package/bundle/index.umd.js

@@ -5,7 +5,6 @@
 })(this, (function (exports) { 'use strict';
 
     const _Array = globalThis.Array;
-    const isArray = _Array.isArray;
     const from = _Array.from;
 
     const _Error = globalThis.Error;
@@ -15,31 +14,15 @@
     const _Object = globalThis.Object;
     const freeze = _Object.freeze;
 
-    const registeredClasses = [];
-
-    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;
-    };
-
     const _Set = globalThis.Set;
     const _Reflect = globalThis.Reflect;
     const createSet = (iterable) => _Reflect.construct(_Set, iterable ? [iterable] : []);
 
+    const isNonPrimitive$1 = (value) => (typeof value === 'object' && value !== null) || typeof value === 'function';
     function createFifoList() {
         const list = createSet();
         const push = (item) => {
-            if (getType(item) !== 'object') {
+            if (!isNonPrimitive$1(item)) {
                 throw createError('A fifo list only supports non-primitive values');
             }
             if (list.has(item)) {
@@ -75,10 +58,11 @@
         return freeze(result);
     }
 
+    const isNonPrimitive = (value) => (typeof value === 'object' && value !== null) || typeof value === 'function';
     function createLifoList() {
         const list = createSet();
         const push = (item) => {
-            if (getType(item) !== 'object') {
+            if (!isNonPrimitive(item)) {
                 throw createError('A lifo list only supports non-primitive values');
             }
             list.add(item);

package/bundle/index.umd.min.js

@@ -1 +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.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))}});
+!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.from,n=globalThis.Error,o=globalThis.Reflect,r=(e,t)=>o.construct(n,[e,t]),i=globalThis.Object.freeze,l=globalThis.Set,s=globalThis.Reflect,u=e=>s.construct(l,e?[e]:[]);e.createFifoList=function(){const e=u();return i({push:t=>{if(("object"!=typeof(n=t)||null===n)&&"function"!=typeof n)throw r("A fifo list only supports non-primitive values");var n;if(e.has(t))throw r("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:n=>t(e.values()).map(n),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=u();return i({push:t=>{if(("object"!=typeof(n=t)||null===n)&&"function"!=typeof n)throw r("A lifo list only supports non-primitive values");var n;e.add(t)},pull:()=>{const n=t(e).pop();return n&&e.delete(n),n},map:n=>t(e).map(n),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 o=e;o<=t;o+=1)n.push(o);return n},e.createValuePicker=function(e){if(!e||!e.length)throw r("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 t(u(e))}});

package/index.cjs.js

@@ -1,11 +1,17 @@
 'use strict';
 
-const index_cjs_js$2 = require('./_dependencies/@hyperfrontend/data-utils/index.cjs.js');
-const index_cjs_js$4 = require('./_dependencies/@hyperfrontend/immutable-api-utils/built-in-copy/array/index.cjs.js');
-const index_cjs_js$3 = require('./_dependencies/@hyperfrontend/immutable-api-utils/built-in-copy/error/index.cjs.js');
+const index_cjs_js$3 = require('./_dependencies/@hyperfrontend/immutable-api-utils/built-in-copy/array/index.cjs.js');
+const index_cjs_js$2 = require('./_dependencies/@hyperfrontend/immutable-api-utils/built-in-copy/error/index.cjs.js');
 const index_cjs_js$1 = require('./_dependencies/@hyperfrontend/immutable-api-utils/built-in-copy/object/index.cjs.js');
 const index_cjs_js = require('./_dependencies/@hyperfrontend/immutable-api-utils/built-in-copy/set/index.cjs.js');
 
+/**
+ * Reports whether a value is a non-primitive, the only kind of value these lists accept.
+ *
+ * @param value - The value a caller tried to push.
+ * @returns True when the value is a non-null object or a function.
+ */
+const isNonPrimitive$1 = (value) => (typeof value === 'object' && value !== null) || typeof value === 'function';
 /**
  * Creates a FIFO (First-In-First-Out) list.
  *
@@ -29,11 +35,11 @@ const index_cjs_js = require('./_dependencies/@hyperfrontend/immutable-api-utils
 function createFifoList() {
     const list = index_cjs_js.createSet();
     const push = (item) => {
-        if (index_cjs_js$2.getType(item) !== 'object') {
-            throw index_cjs_js$3.createError('A fifo list only supports non-primitive values');
+        if (!isNonPrimitive$1(item)) {
+            throw index_cjs_js$2.createError('A fifo list only supports non-primitive values');
         }
         if (list.has(item)) {
-            throw index_cjs_js$3.createError('Cannot push an item that already exists in the list');
+            throw index_cjs_js$2.createError('Cannot push an item that already exists in the list');
         }
         list.add(item);
     };
@@ -43,7 +49,7 @@ function createFifoList() {
         return value;
     };
     const map = (callback) => {
-        return index_cjs_js$4.from(list.values()).map(callback);
+        return index_cjs_js$3.from(list.values()).map(callback);
     };
     const forEach = (callback) => {
         list.forEach(callback);
@@ -65,6 +71,13 @@ function createFifoList() {
     return index_cjs_js$1.freeze(result);
 }
 
+/**
+ * Reports whether a value is a non-primitive, the only kind of value these lists accept.
+ *
+ * @param value - The value a caller tried to push.
+ * @returns True when the value is a non-null object or a function.
+ */
+const isNonPrimitive = (value) => (typeof value === 'object' && value !== null) || typeof value === 'function';
 /**
  * Creates a LIFO (Last-In-First-Out) list.
  *
@@ -85,20 +98,20 @@ function createFifoList() {
 function createLifoList() {
     const list = index_cjs_js.createSet();
     const push = (item) => {
-        if (index_cjs_js$2.getType(item) !== 'object') {
-            throw index_cjs_js$3.createError('A lifo list only supports non-primitive values');
+        if (!isNonPrimitive(item)) {
+            throw index_cjs_js$2.createError('A lifo list only supports non-primitive values');
         }
         list.add(item);
     };
     const pull = () => {
-        const lastItem = index_cjs_js$4.from(list).pop();
+        const lastItem = index_cjs_js$3.from(list).pop();
         if (lastItem) {
             list.delete(lastItem);
         }
         return lastItem;
     };
     const map = (callback) => {
-        return index_cjs_js$4.from(list).map(callback);
+        return index_cjs_js$3.from(list).map(callback);
     };
     const forEach = (callback) => {
         list.forEach(callback);
@@ -163,7 +176,7 @@ function createRange(start, end) {
  */
 function createValuePicker(values) {
     if (!values || !values.length) {
-        throw index_cjs_js$3.createError('Expected values not to be an empty list.');
+        throw index_cjs_js$2.createError('Expected values not to be an empty list.');
     }
     let index = -1;
     /**
@@ -241,7 +254,7 @@ function nonEmptyStrings(values) {
  * ```
  */
 function uniqueStrings(values) {
-    return index_cjs_js$4.from(index_cjs_js.createSet(values));
+    return index_cjs_js$3.from(index_cjs_js.createSet(values));
 }
 
 exports.createFifoList = createFifoList;

package/index.esm.js

@@ -1,9 +1,15 @@
-import { getType } from './_dependencies/@hyperfrontend/data-utils/index.esm.js';
 import { from } from './_dependencies/@hyperfrontend/immutable-api-utils/built-in-copy/array/index.esm.js';
 import { createError } from './_dependencies/@hyperfrontend/immutable-api-utils/built-in-copy/error/index.esm.js';
 import { freeze } from './_dependencies/@hyperfrontend/immutable-api-utils/built-in-copy/object/index.esm.js';
 import { createSet } from './_dependencies/@hyperfrontend/immutable-api-utils/built-in-copy/set/index.esm.js';
 
+/**
+ * Reports whether a value is a non-primitive, the only kind of value these lists accept.
+ *
+ * @param value - The value a caller tried to push.
+ * @returns True when the value is a non-null object or a function.
+ */
+const isNonPrimitive$1 = (value) => (typeof value === 'object' && value !== null) || typeof value === 'function';
 /**
  * Creates a FIFO (First-In-First-Out) list.
  *
@@ -27,7 +33,7 @@ import { createSet } from './_dependencies/@hyperfrontend/immutable-api-utils/bu
 function createFifoList() {
     const list = createSet();
     const push = (item) => {
-        if (getType(item) !== 'object') {
+        if (!isNonPrimitive$1(item)) {
             throw createError('A fifo list only supports non-primitive values');
         }
         if (list.has(item)) {
@@ -63,6 +69,13 @@ function createFifoList() {
     return freeze(result);
 }
 
+/**
+ * Reports whether a value is a non-primitive, the only kind of value these lists accept.
+ *
+ * @param value - The value a caller tried to push.
+ * @returns True when the value is a non-null object or a function.
+ */
+const isNonPrimitive = (value) => (typeof value === 'object' && value !== null) || typeof value === 'function';
 /**
  * Creates a LIFO (Last-In-First-Out) list.
  *
@@ -83,7 +96,7 @@ function createFifoList() {
 function createLifoList() {
     const list = createSet();
     const push = (item) => {
-        if (getType(item) !== 'object') {
+        if (!isNonPrimitive(item)) {
             throw createError('A lifo list only supports non-primitive values');
         }
         list.add(item);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hyperfrontend/list-utils",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Purpose-built collection utilities for queue management, filtering, and iteration patterns.",
   "license": "MIT",
   "sideEffects": false,

package/_dependencies/@hyperfrontend/data-utils/index.cjs.js

@@ -1,214 +0,0 @@
-'use strict';
-
-const { isArray } = require('../immutable-api-utils/built-in-copy/array/index.cjs.js');
-const { createError } = require('../immutable-api-utils/built-in-copy/error/index.cjs.js');
-const { freeze, keys: keys$1 } = require('../immutable-api-utils/built-in-copy/object/index.cjs.js');
-const { createMap } = require('../immutable-api-utils/built-in-copy/map/index.cjs.js');
-const { createDate } = require('../immutable-api-utils/built-in-copy/date/index.cjs.js');
-const { random, round } = require('../immutable-api-utils/built-in-copy/math/index.cjs.js');
-
-const isMarker = (text) => {
-    if (typeof text !== 'string' || !text.startsWith('__$'))
-        return false;
-    return /^__\$[0-9]+$/.test(text);
-};
-
-const registeredClasses = [];
-const registeredIterableClasses = [
-    {
-        classRef: Array,
-        instantiate: () => [],
-        getKeys: (target) => {
-            const keysArray = keys$1(target);
-            if (getConfig().detectCircularReferences) {
-                return keysArray.filter((key) => !isMarker(key));
-            }
-            return keysArray;
-        },
-        read: (target, key) => target[key],
-        write: (target, value, key) => (target[key] = value),
-        remove: (target, value) => target.splice(value, 1),
-    },
-    {
-        classRef: Object,
-        instantiate: () => ({}),
-        getKeys: (target) => {
-            const keysArray = keys$1(target);
-            if (getConfig().detectCircularReferences) {
-                return keysArray.filter((key) => !isMarker(key));
-            }
-            return keysArray;
-        },
-        read: (target, key) => target[key],
-        write: (target, value, key) => (target[key] = value),
-        remove: (target, value) => delete target[value],
-    },
-];
-let samePositionOfOwnProperties = false;
-let detectCircularReferences = false;
-const getConfig = () => ({
-    samePositionOfOwnProperties,
-    detectCircularReferences,
-});
-
-const getKeysFromIterable = (target, dataType) => {
-    if (dataType === 'array')
-        dataType = Array.name;
-    if (dataType === 'object')
-        dataType = Object.name;
-    const iterableClass = registeredIterableClasses.find(({ classRef }) => dataType === classRef.name);
-    if (iterableClass === undefined)
-        return [];
-    return iterableClass.getKeys(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;
-};
-
-const getIterableTypes = () => registeredIterableClasses.map(({ classRef }) => {
-    const name = classRef.name;
-    if (name === Object.name)
-        return 'object';
-    if (name === Array.name)
-        return 'array';
-    return name;
-});
-
-const isIterableType = (dataType) => getIterableTypes().includes(dataType);
-
-const isIterable = (target) => isIterableType(getType(target));
-
-const marker = () => {
-    const randomValue = round(random() * 10000000000000);
-    const sequential = createDate().getTime();
-    const unique = `${randomValue}${sequential}`;
-    const prefix = `__$`;
-    return `${prefix}${unique}`;
-};
-
-const referenceStack = () => {
-    const records = createMap();
-    const flag = marker();
-    const exists = (ref) => (isIterable(ref) ? flag in ref && records.has(ref[flag]) : false);
-    const add = (ref) => {
-        if (!isIterable(ref) || exists(ref))
-            return;
-        ref[flag] = Symbol();
-        records.set(ref[flag], [flag, ref, records.size]);
-    };
-    const lastSeen = (ref) => {
-        if (!isIterable(ref))
-            return null;
-        const record = records.get(ref[flag]);
-        return record ? record[2] - records.size : null;
-    };
-    const clear = () => (records.forEach(([key, ref]) => {
-        delete ref[key];
-    }),
-        records.clear());
-    return {
-        add: (ref) => add(ref),
-        exists: (ref) => exists(ref),
-        lastSeen: (ref) => lastSeen(ref),
-        clear: () => clear(),
-        get size() {
-            return records.size;
-        },
-    };
-};
-
-const errorMessage = (thing, type) => `Expected ${thing} to be ${type}.`;
-const nextIterationDetails = (path, key, value) => ({
-    nextPath: [...path, key],
-    nextValue: value[key],
-});
-const circularDependencyTraversal = (condition, callback, config, key, path, value, parent, state, stack, root = false) => {
-    if (stack.exists(value))
-        return state;
-    const ok = condition(config, key, value, path, parent);
-    if (config.exitEarly)
-        return state;
-    if (ok)
-        callback(key, value, path, state, parent);
-    stack.add(value);
-    const type = getType(value);
-    if (!isIterableType(type))
-        return state;
-    const keys = getKeysFromIterable(value, type);
-    keys.forEach((key) => {
-        const { nextPath, nextValue } = nextIterationDetails(path, key, value);
-        circularDependencyTraversal(condition, callback, config, key, nextPath, nextValue, value, state, stack);
-    });
-    if (root)
-        stack.clear();
-    return state;
-};
-const nonCircularDependencyTraversal = (condition, callback, config, key, path, value, parent, state) => {
-    const ok = condition(config, key, value, path, parent);
-    if (config.exitEarly)
-        return state;
-    if (ok)
-        callback(key, value, path, state, parent);
-    const type = getType(value);
-    if (!isIterableType(type))
-        return state;
-    const keys = getKeysFromIterable(value, type);
-    keys.forEach((key) => {
-        const { nextPath, nextValue } = nextIterationDetails(path, key, value);
-        nonCircularDependencyTraversal(condition, callback, config, key, nextPath, nextValue, value, state);
-    });
-    return state;
-};
-const traversal = (target, condition, callback, options, state) => {
-    if (typeof callback !== 'function')
-        throw createError(errorMessage('callback', 'a function'));
-    if (!(typeof options === 'object' && !isArray(options)))
-        throw createError(errorMessage('options', 'an object'));
-    if (!isArray(options.depth))
-        throw createError(errorMessage('options.depth', 'an array'));
-    const [startDepth, maxDepth] = options.depth;
-    if (startDepth !== void 0 && typeof startDepth !== 'number')
-        throw createError(errorMessage('options.depth.0', 'a number'));
-    if (maxDepth !== void 0) {
-        const maxDepthType = typeof maxDepth;
-        if (!['number', 'string'].includes(maxDepthType))
-            throw createError(errorMessage('options.depth.1', 'a number or a string'));
-        if (maxDepthType === 'string' && maxDepth !== '*')
-            throw createError("Only valid string value in options.depth.1 is '*'.");
-    }
-    const config = {
-        depth: freeze([options.depth[0] ?? 0, options.depth[1] ?? '*']),
-        exitEarly: false,
-    };
-    const initialArgs = [condition, callback, config, '', [], target, void 0, state];
-    if (getConfig().detectCircularReferences)
-        return circularDependencyTraversal(...initialArgs, referenceStack(), true);
-    return nonCircularDependencyTraversal(...initialArgs);
-};
-const createTraversal = (condition) => (target, callback, options, state) => traversal(target, condition, callback, options ?? { depth: [0, '*'] }, state ?? {});
-const condition = (config, key, value, path) => !(path.length < config.depth[0] || config.depth[1] < path.length);
-const traverseBetweenDepthRange = createTraversal(condition);
-exports.createTraversal = createTraversal;
-exports.getConfig = getConfig;
-exports.getIterableTypes = getIterableTypes;
-exports.getKeysFromIterable = getKeysFromIterable;
-exports.getType = getType;
-exports.isIterable = isIterable;
-exports.isIterableType = isIterableType;
-exports.isMarker = isMarker;
-exports.marker = marker;
-exports.referenceStack = referenceStack;
-exports.registeredClasses = registeredClasses;
-exports.registeredIterableClasses = registeredIterableClasses;

package/_dependencies/@hyperfrontend/data-utils/index.esm.js

@@ -1,202 +0,0 @@
-import { isArray } from '../immutable-api-utils/built-in-copy/array/index.esm.js';
-import { createError } from '../immutable-api-utils/built-in-copy/error/index.esm.js';
-import { keys, freeze } from '../immutable-api-utils/built-in-copy/object/index.esm.js';
-import { createMap } from '../immutable-api-utils/built-in-copy/map/index.esm.js';
-import { createDate } from '../immutable-api-utils/built-in-copy/date/index.esm.js';
-import { round, random } from '../immutable-api-utils/built-in-copy/math/index.esm.js';
-
-const isMarker = (text) => {
-    if (typeof text !== 'string' || !text.startsWith('__$'))
-        return false;
-    return /^__\$[0-9]+$/.test(text);
-};
-
-const registeredClasses = [];
-const registeredIterableClasses = [
-    {
-        classRef: Array,
-        instantiate: () => [],
-        getKeys: (target) => {
-            const keysArray = keys(target);
-            if (getConfig().detectCircularReferences) {
-                return keysArray.filter((key) => !isMarker(key));
-            }
-            return keysArray;
-        },
-        read: (target, key) => target[key],
-        write: (target, value, key) => (target[key] = value),
-        remove: (target, value) => target.splice(value, 1),
-    },
-    {
-        classRef: Object,
-        instantiate: () => ({}),
-        getKeys: (target) => {
-            const keysArray = keys(target);
-            if (getConfig().detectCircularReferences) {
-                return keysArray.filter((key) => !isMarker(key));
-            }
-            return keysArray;
-        },
-        read: (target, key) => target[key],
-        write: (target, value, key) => (target[key] = value),
-        remove: (target, value) => delete target[value],
-    },
-];
-let samePositionOfOwnProperties = false;
-let detectCircularReferences = false;
-const getConfig = () => ({
-    samePositionOfOwnProperties,
-    detectCircularReferences,
-});
-
-const getKeysFromIterable = (target, dataType) => {
-    if (dataType === 'array')
-        dataType = Array.name;
-    if (dataType === 'object')
-        dataType = Object.name;
-    const iterableClass = registeredIterableClasses.find(({ classRef }) => dataType === classRef.name);
-    if (iterableClass === undefined)
-        return [];
-    return iterableClass.getKeys(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;
-};
-
-const getIterableTypes = () => registeredIterableClasses.map(({ classRef }) => {
-    const name = classRef.name;
-    if (name === Object.name)
-        return 'object';
-    if (name === Array.name)
-        return 'array';
-    return name;
-});
-
-const isIterableType = (dataType) => getIterableTypes().includes(dataType);
-
-const isIterable = (target) => isIterableType(getType(target));
-
-const marker = () => {
-    const randomValue = round(random() * 10000000000000);
-    const sequential = createDate().getTime();
-    const unique = `${randomValue}${sequential}`;
-    const prefix = `__$`;
-    return `${prefix}${unique}`;
-};
-
-const referenceStack = () => {
-    const records = createMap();
-    const flag = marker();
-    const exists = (ref) => (isIterable(ref) ? flag in ref && records.has(ref[flag]) : false);
-    const add = (ref) => {
-        if (!isIterable(ref) || exists(ref))
-            return;
-        ref[flag] = Symbol();
-        records.set(ref[flag], [flag, ref, records.size]);
-    };
-    const lastSeen = (ref) => {
-        if (!isIterable(ref))
-            return null;
-        const record = records.get(ref[flag]);
-        return record ? record[2] - records.size : null;
-    };
-    const clear = () => (records.forEach(([key, ref]) => {
-        delete ref[key];
-    }),
-        records.clear());
-    return {
-        add: (ref) => add(ref),
-        exists: (ref) => exists(ref),
-        lastSeen: (ref) => lastSeen(ref),
-        clear: () => clear(),
-        get size() {
-            return records.size;
-        },
-    };
-};
-
-const errorMessage = (thing, type) => `Expected ${thing} to be ${type}.`;
-const nextIterationDetails = (path, key, value) => ({
-    nextPath: [...path, key],
-    nextValue: value[key],
-});
-const circularDependencyTraversal = (condition, callback, config, key, path, value, parent, state, stack, root = false) => {
-    if (stack.exists(value))
-        return state;
-    const ok = condition(config, key, value, path, parent);
-    if (config.exitEarly)
-        return state;
-    if (ok)
-        callback(key, value, path, state, parent);
-    stack.add(value);
-    const type = getType(value);
-    if (!isIterableType(type))
-        return state;
-    const keys = getKeysFromIterable(value, type);
-    keys.forEach((key) => {
-        const { nextPath, nextValue } = nextIterationDetails(path, key, value);
-        circularDependencyTraversal(condition, callback, config, key, nextPath, nextValue, value, state, stack);
-    });
-    if (root)
-        stack.clear();
-    return state;
-};
-const nonCircularDependencyTraversal = (condition, callback, config, key, path, value, parent, state) => {
-    const ok = condition(config, key, value, path, parent);
-    if (config.exitEarly)
-        return state;
-    if (ok)
-        callback(key, value, path, state, parent);
-    const type = getType(value);
-    if (!isIterableType(type))
-        return state;
-    const keys = getKeysFromIterable(value, type);
-    keys.forEach((key) => {
-        const { nextPath, nextValue } = nextIterationDetails(path, key, value);
-        nonCircularDependencyTraversal(condition, callback, config, key, nextPath, nextValue, value, state);
-    });
-    return state;
-};
-const traversal = (target, condition, callback, options, state) => {
-    if (typeof callback !== 'function')
-        throw createError(errorMessage('callback', 'a function'));
-    if (!(typeof options === 'object' && !isArray(options)))
-        throw createError(errorMessage('options', 'an object'));
-    if (!isArray(options.depth))
-        throw createError(errorMessage('options.depth', 'an array'));
-    const [startDepth, maxDepth] = options.depth;
-    if (startDepth !== void 0 && typeof startDepth !== 'number')
-        throw createError(errorMessage('options.depth.0', 'a number'));
-    if (maxDepth !== void 0) {
-        const maxDepthType = typeof maxDepth;
-        if (!['number', 'string'].includes(maxDepthType))
-            throw createError(errorMessage('options.depth.1', 'a number or a string'));
-        if (maxDepthType === 'string' && maxDepth !== '*')
-            throw createError("Only valid string value in options.depth.1 is '*'.");
-    }
-    const config = {
-        depth: freeze([options.depth[0] ?? 0, options.depth[1] ?? '*']),
-        exitEarly: false,
-    };
-    const initialArgs = [condition, callback, config, '', [], target, void 0, state];
-    if (getConfig().detectCircularReferences)
-        return circularDependencyTraversal(...initialArgs, referenceStack(), true);
-    return nonCircularDependencyTraversal(...initialArgs);
-};
-const createTraversal = (condition) => (target, callback, options, state) => traversal(target, condition, callback, options ?? { depth: [0, '*'] }, state ?? {});
-const condition = (config, key, value, path) => !(path.length < config.depth[0] || config.depth[1] < path.length);
-const traverseBetweenDepthRange = createTraversal(condition);
-
-export { createTraversal, getConfig, getIterableTypes, getKeysFromIterable, getType, isIterable, isIterableType, isMarker, marker, referenceStack, registeredClasses, registeredIterableClasses };

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

@@ -1,8 +0,0 @@
-'use strict';
-
-const _Date = globalThis.Date;
-const _Reflect = globalThis.Reflect;
-function createDate(...args) {
-    return _Reflect.construct(_Date, args);
-}
-exports.createDate = createDate;

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

@@ -1,7 +0,0 @@
-const _Date = globalThis.Date;
-const _Reflect = globalThis.Reflect;
-function createDate(...args) {
-    return _Reflect.construct(_Date, args);
-}
-
-export { createDate };

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

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

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

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

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

@@ -1,7 +0,0 @@
-'use strict';
-
-const _Math = globalThis.Math;
-const round = _Math.round;
-const random = _Math.random;
-exports.random = random;
-exports.round = round;

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

@@ -1,5 +0,0 @@
-const _Math = globalThis.Math;
-const round = _Math.round;
-const random = _Math.random;
-
-export { random, round };