@hyperfrontend/list-utils 0.0.1

package/bundle/index.umd.js

@@ -0,0 +1,211 @@
+(function (global, factory) {
+    typeof exports === 'object' && typeof module !== 'undefined' ? factory(exports) :
+    typeof define === 'function' && define.amd ? define(['exports'], factory) :
+    (global = typeof globalThis !== 'undefined' ? globalThis : global || self, factory(global.HyperfrontendListUtils = {}));
+})(this, (function (exports) { 'use strict';
+
+    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.
+     */
+    const getType = (target) => {
+        if (target === null)
+            return 'null';
+        const nativeDataType = typeof target;
+        if (nativeDataType === 'object') {
+            if (Array.isArray(target))
+                return 'array';
+            for (const registeredClass of registeredClasses) {
+                if (target instanceof registeredClass)
+                    return registeredClass.name;
+            }
+        }
+        return nativeDataType;
+    };
+
+    /**
+     * 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 = new Set();
+        const push = (item) => {
+            if (getType(item) !== 'object') {
+                throw new Error('A fifo list only non-primitive values');
+            }
+            if (list.has(item)) {
+                throw new Error('Cannot a item that already exists');
+            }
+            list.add(item);
+        };
+        const pull = () => {
+            const value = list.values().next().value;
+            list.delete(value);
+            return value;
+        };
+        const map = (callback) => {
+            return Array.from(list.values()).map(callback);
+        };
+        const forEach = (callback) => {
+            list.forEach(callback);
+        };
+        const remove = (item) => list.delete(item);
+        const has = (item) => list.has(item);
+        const size = () => list.size;
+        const clear = () => list.clear();
+        const result = {
+            push,
+            pull,
+            map,
+            forEach,
+            remove,
+            has,
+            size,
+            clear,
+        };
+        return Object.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 = new Set();
+        const push = (item) => {
+            if (getType(item) !== 'object') {
+                throw new Error('A lifo list only supports non-primitive values');
+            }
+            list.add(item);
+        };
+        const pull = () => {
+            const lastItem = Array.from(list).pop();
+            if (lastItem) {
+                list.delete(lastItem);
+            }
+            return lastItem;
+        };
+        const map = (callback) => {
+            return Array.from(list).map(callback);
+        };
+        const forEach = (callback) => {
+            list.forEach(callback);
+        };
+        const remove = (item) => list.delete(item);
+        const has = (item) => list.has(item);
+        const size = () => list.size;
+        const clear = () => {
+            list.clear();
+        };
+        const result = {
+            push,
+            pull,
+            map,
+            forEach,
+            remove,
+            has,
+            size,
+            clear,
+        };
+        return Object.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) {
+            range.push(i);
+        }
+        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 new Error('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();
+            index = ++index < values.length ? index : 0;
+            return values[index];
+        }
+        return {
+            current: current,
+            next: next,
+        };
+    }
+
+    // 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 Array.from(new Set(values));
+    }
+
+    exports.createFifoList = createFifoList;
+    exports.createLifoList = createLifoList;
+    exports.createRange = createRange;
+    exports.createValuePicker = createValuePicker;
+    exports.getLastKeyInMap = getLastKeyInMap;
+    exports.nonEmptyStrings = nonEmptyStrings;
+    exports.uniqueStrings = uniqueStrings;
+
+}));
+//# sourceMappingURL=index.umd.js.map

package/bundle/index.umd.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.umd.js","sources":["../../../../../../../../../../libs/utils/data/src/shared/consts.ts","../../../../../../../../../../libs/utils/data/src/get-type.ts","../../../../../../../../../../libs/utils/list/src/create-fifo-list.ts","../../../../../../../../../../libs/utils/list/src/create-lifo-list.ts","../../../../../../../../../../libs/utils/list/src/create-range.ts","../../../../../../../../../../libs/utils/list/src/create-value-picker.ts","../../../../../../../../../../libs/utils/list/src/get-last-key-in-map.ts","../../../../../../../../../../libs/utils/list/src/non-empty-strings.ts","../../../../../../../../../../libs/utils/list/src/unique-strings.ts"],"sourcesContent":[null,null,null,null,null,null,null,null,null],"names":[],"mappings":";;;;;;IAGO,MAAM,iBAAiB,GAAmB,EAAE;;ICAnD;;;;;;;IAOG;IACI,MAAM,OAAO,GAAG,CAA8B,MAAe,KAAO;QACzE,IAAI,MAAM,KAAK,IAAI;IAAE,QAAA,OAAU,MAAM;IACrC,IAAA,MAAM,cAAc,GAAG,OAAO,MAAM;IACpC,IAAA,IAAI,cAAc,KAAK,QAAQ,EAAE;IAC/B,QAAA,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;IAAE,YAAA,OAAU,OAAO;IAC5C,QAAA,KAAK,MAAM,eAAe,IAAI,iBAAiB,EAAE;gBAC/C,IAAI,MAAM,YAAY,eAAe;oBAAE,OAAU,eAAe,CAAC,IAAI;YACvE;QACF;IACA,IAAA,OAAU,cAAc;IAC1B,CAAC;;ICRD;;;;;IAKG;aACa,cAAc,GAAA;IAC5B,IAAA,MAAM,IAAI,GAAW,IAAI,GAAG,EAAE;IAE9B,IAAA,MAAM,IAAI,GAAG,CAAC,IAAO,KAAU;IAC7B,QAAA,IAAI,OAAO,CAAC,IAAI,CAAC,KAAK,QAAQ,EAAE;IAC9B,YAAA,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC;YAC1D;IACA,QAAA,IAAI,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE;IAClB,YAAA,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC;YACtD;IACA,QAAA,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC;IAChB,IAAA,CAAC;QAED,MAAM,IAAI,GAAG,MAAQ;YACnB,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK;IACxC,QAAA,IAAI,CAAC,MAAM,CAAI,KAAK,CAAC;IACrB,QAAA,OAAU,KAAK;IACjB,IAAA,CAAC;IAED,IAAA,MAAM,GAAG,GAAG,CAAI,QAAwB,KAAS;IAC/C,QAAA,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC;IAChD,IAAA,CAAC;IAED,IAAA,MAAM,OAAO,GAAG,CAAC,QAA2B,KAAU;IACpD,QAAA,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC;IACxB,IAAA,CAAC;IAED,IAAA,MAAM,MAAM,GAAG,CAAC,IAAO,KAAc,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC;IAEtD,IAAA,MAAM,GAAG,GAAG,CAAC,IAAO,KAAc,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC;QAEhD,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI;QAE5B,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,KAAK,EAAE;IAEhC,IAAA,MAAM,MAAM,GAAgB;YAC1B,IAAI;YACJ,IAAI;YACJ,GAAG;YACH,OAAO;YACP,MAAM;YACN,GAAG;YACH,IAAI;YACJ,KAAK;SACN;IAED,IAAA,OAAO,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC;IAC9B;;ICrDA;;;;;IAKG;aACa,cAAc,GAAA;IAC5B,IAAA,MAAM,IAAI,GAAW,IAAI,GAAG,EAAE;IAE9B,IAAA,MAAM,IAAI,GAAG,CAAC,IAAO,KAAU;IAC7B,QAAA,IAAI,OAAO,CAAC,IAAI,CAAC,KAAK,QAAQ,EAAE;IAC9B,YAAA,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC;YACnE;IACA,QAAA,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC;IAChB,IAAA,CAAC;QAED,MAAM,IAAI,GAAG,MAAoB;YAC/B,MAAM,QAAQ,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE;YACvC,IAAI,QAAQ,EAAE;IACZ,YAAA,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC;YACvB;IACA,QAAA,OAAO,QAAQ;IACjB,IAAA,CAAC;IAED,IAAA,MAAM,GAAG,GAAG,CAAI,QAAwB,KAAS;YAC/C,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC;IACvC,IAAA,CAAC;IAED,IAAA,MAAM,OAAO,GAAG,CAAC,QAA2B,KAAU;IACpD,QAAA,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC;IACxB,IAAA,CAAC;IAED,IAAA,MAAM,MAAM,GAAG,CAAC,IAAO,KAAc,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC;IAEtD,IAAA,MAAM,GAAG,GAAG,CAAC,IAAO,KAAc,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC;QAEhD,MAAM,IAAI,GAAG,MAAc,IAAI,CAAC,IAAI;QAEpC,MAAM,KAAK,GAAG,MAAW;YACvB,IAAI,CAAC,KAAK,EAAE;IACd,IAAA,CAAC;IAED,IAAA,MAAM,MAAM,GAAgB;YAC1B,IAAI;YACJ,IAAI;YACJ,GAAG;YACH,OAAO;YACP,MAAM;YACN,GAAG;YACH,IAAI;YACJ,KAAK;SACN;IAED,IAAA,OAAO,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC;IAC9B;;ICnEA;;;;;;IAMG;IACG,SAAU,WAAW,CAAC,KAAa,EAAE,GAAW,EAAA;QACpD,MAAM,KAAK,GAAa,EAAE;IAC1B,IAAA,KAAK,IAAI,CAAC,GAAG,KAAK,EAAE,CAAC,IAAI,GAAG,EAAE,CAAC,IAAI,CAAC,EAAE;IACpC,QAAA,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;QACf;IACA,IAAA,OAAO,KAAK;IACd;;ICRA;;;;;IAKG;IACG,SAAU,iBAAiB,CAAC,MAAgB,EAAA;QAChD,IAAI,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE;IAC7B,QAAA,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC;QAC7D;IACA,IAAA,IAAI,KAAK,GAAG,EAAE;IACd;;;;IAIG;IACH,IAAA,SAAS,OAAO,GAAA;YACd,IAAI,KAAK,GAAG,CAAC;gBAAE,KAAK,GAAG,CAAC;IACxB,QAAA,OAAO,MAAM,CAAC,KAAK,CAAC;QACtB;IACA;;;;IAIG;IACH,IAAA,SAAS,IAAI,GAAA;YACX,IAAI,KAAK,GAAG,CAAC;gBAAE,OAAO,OAAO,EAAE;IAC/B,QAAA,KAAK,GAAG,EAAE,KAAK,GAAG,MAAM,CAAC,MAAM,GAAG,KAAK,GAAG,CAAC;IAC3C,QAAA,OAAO,MAAM,CAAC,KAAK,CAAC;QACtB;QACA,OAAO;IACL,QAAA,OAAO,EAAE,OAAO;IAChB,QAAA,IAAI,EAAE,IAAI;SACX;IACH;;ICvCA;AACO,UAAM,eAAe,GAAG,CAAU,GAAgB,KAAO;QAC9D,MAAM,KAAK,GAAG,CAAC,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;QAC7B,OAAO,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAM;IACrC;;ICJA;;;;;IAKG;IACG,SAAU,eAAe,CAAC,MAAgB,EAAA;IAC9C,IAAA,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,SAAS,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC;IAChG;;ICRA;;;;;IAKG;IACG,SAAU,aAAa,CAAC,MAAgB,EAAA;QAC5C,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC;IACpC;;;;;;;;;;;;;;"}

package/bundle/index.umd.min.js

@@ -0,0 +1,2 @@
+!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=[],r=e=>{if(null===e)return"null";const r=typeof e;if("object"===r){if(Array.isArray(e))return"array";for(const r of t)if(e instanceof r)return r.name}return r};e.createFifoList=function(){const e=new Set,t={push:t=>{if("object"!==r(t))throw new Error("A fifo list only non-primitive values");if(e.has(t))throw new Error("Cannot a item that already exists");e.add(t)},pull:()=>{const t=e.values().next().value;return e.delete(t),t},map:t=>Array.from(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()};return Object.freeze(t)},e.createLifoList=function(){const e=new Set,t={push:t=>{if("object"!==r(t))throw new Error("A lifo list only supports non-primitive values");e.add(t)},pull:()=>{const t=Array.from(e).pop();return t&&e.delete(t),t},map:t=>Array.from(e).map(t),forEach:t=>{e.forEach(t)},remove:t=>e.delete(t),has:t=>e.has(t),size:()=>e.size,clear:()=>{e.clear()}};return Object.freeze(t)},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 new Error("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 Array.from(new Set(e))}});
+//# sourceMappingURL=index.umd.min.js.map

package/bundle/index.umd.min.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.umd.min.js","sources":["../../../../../../../../../../libs/utils/data/src/shared/consts.ts","../../../../../../../../../../libs/utils/data/src/get-type.ts","../../../../../../../../../../libs/utils/list/src/create-fifo-list.ts","../../../../../../../../../../libs/utils/list/src/create-lifo-list.ts","../../../../../../../../../../libs/utils/list/src/create-range.ts","../../../../../../../../../../libs/utils/list/src/create-value-picker.ts","../../../../../../../../../../libs/utils/list/src/get-last-key-in-map.ts","../../../../../../../../../../libs/utils/list/src/non-empty-strings.ts","../../../../../../../../../../libs/utils/list/src/unique-strings.ts"],"sourcesContent":[null,null,null,null,null,null,null,null,null],"names":["registeredClasses","getType","target","nativeDataType","Array","isArray","registeredClass","name","list","Set","result","push","item","Error","has","add","pull","value","values","next","delete","map","callback","from","forEach","remove","size","clear","Object","freeze","lastItem","pop","start","end","range","i","length","index","current","items","keys","filter","undefined","includes","trim"],"mappings":"6PAGO,MAAMA,EAAoC,GCQpCC,EAAwCC,IACnD,GAAe,OAAXA,EAAiB,MAAU,OAC/B,MAAMC,SAAwBD,EAC9B,GAAuB,WAAnBC,EAA6B,CAC/B,GAAIC,MAAMC,QAAQH,GAAS,MAAU,QACrC,IAAK,MAAMI,KAAmBN,EAC5B,GAAIE,aAAkBI,EAAiB,OAAUA,EAAgBC,IAErE,CACA,OAAUJ,+BCAV,MAAMK,EAAe,IAAIC,IAkCnBC,EAAsB,CAC1BC,KAjCYC,IACZ,GAAsB,WAAlBX,EAAQW,GACV,MAAM,IAAIC,MAAM,yCAElB,GAAIL,EAAKM,IAAIF,GACX,MAAM,IAAIC,MAAM,qCAElBL,EAAKO,IAAIH,IA2BTI,KAxBW,KACX,MAAMC,EAAQT,EAAKU,SAASC,OAAOF,MAEnC,OADAT,EAAKY,OAAUH,GACLA,GAsBVI,IAnBcC,GACPlB,MAAMmB,KAAKf,EAAKU,UAAUG,IAAIC,GAmBrCE,QAhBeF,IACfd,EAAKgB,QAAQF,IAgBbG,OAbcb,GAAqBJ,EAAKY,OAAOR,GAc/CE,IAZWF,GAAqBJ,EAAKM,IAAIF,GAazCc,KAXW,IAAMlB,EAAKkB,KAYtBC,MAVY,IAAMnB,EAAKmB,SAazB,OAAOC,OAAOC,OAAOnB,EACvB,8BC9CE,MAAMF,EAAe,IAAIC,IAmCnBC,EAAsB,CAC1BC,KAlCYC,IACZ,GAAsB,WAAlBX,EAAQW,GACV,MAAM,IAAIC,MAAM,kDAElBL,EAAKO,IAAIH,IA+BTI,KA5BW,KACX,MAAMc,EAAW1B,MAAMmB,KAAKf,GAAMuB,MAIlC,OAHID,GACFtB,EAAKY,OAAOU,GAEPA,GAwBPT,IArBcC,GACPlB,MAAMmB,KAAKf,GAAMa,IAAIC,GAqB5BE,QAlBeF,IACfd,EAAKgB,QAAQF,IAkBbG,OAfcb,GAAqBJ,EAAKY,OAAOR,GAgB/CE,IAdWF,GAAqBJ,EAAKM,IAAIF,GAezCc,KAbW,IAAclB,EAAKkB,KAc9BC,MAZY,KACZnB,EAAKmB,UAcP,OAAOC,OAAOC,OAAOnB,EACvB,gBC5DM,SAAsBsB,EAAeC,GACzC,MAAMC,EAAkB,GACxB,IAAK,IAAIC,EAAIH,EAAOG,GAAKF,EAAKE,GAAK,EACjCD,EAAMvB,KAAKwB,GAEb,OAAOD,CACT,sBCFM,SAA4BhB,GAChC,IAAKA,IAAWA,EAAOkB,OACrB,MAAM,IAAIvB,MAAM,4CAElB,IAAIwB,GAAQ,EAMZ,SAASC,IAEP,OADID,EAAQ,IAAGA,EAAQ,GAChBnB,EAAOmB,EAChB,CAWA,MAAO,CACLC,QAASA,EACTnB,KAPF,WACE,OAAIkB,EAAQ,EAAUC,KACtBD,IAAUA,EAAQnB,EAAOkB,OAASC,EAAQ,EACnCnB,EAAOmB,GAChB,EAKF,oBCtCyChB,IACvC,MAAMkB,EAAQ,IAAIlB,EAAImB,QACtB,OAAOD,EAAMA,EAAMH,OAAS,sBCGxB,SAA0BlB,GAC9B,OAAOA,EAAOuB,OAAQxB,IAAW,MAACyB,EAAW,KAAM,IAAIC,SAAS1B,IAA2B,KAAjBA,EAAM2B,OAClF,kBCFM,SAAwB1B,GAC5B,OAAOd,MAAMmB,KAAK,IAAId,IAAIS,GAC5B"}

package/create-fifo-list.d.ts

@@ -0,0 +1,18 @@
+export interface FifoList<T extends object> {
+    push(item: T): void;
+    pull(): T;
+    map<U>(callback: (item: T) => U): U[];
+    forEach(callback: (item: T) => void): void;
+    remove(item: T): boolean;
+    has(item: T): boolean;
+    size(): number;
+    clear(): void;
+}
+/**
+ * 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.
+ */
+export declare function createFifoList<T extends object>(): FifoList<T>;
+//# sourceMappingURL=create-fifo-list.d.ts.map

package/create-fifo-list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-fifo-list.d.ts","sourceRoot":"","sources":["../../../../libs/utils/list/src/create-fifo-list.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,QAAQ,CAAC,CAAC,SAAS,MAAM;IACxC,IAAI,CAAC,IAAI,EAAE,CAAC,GAAG,IAAI,CAAA;IACnB,IAAI,IAAI,CAAC,CAAA;IACT,GAAG,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAA;IACrC,OAAO,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,IAAI,GAAG,IAAI,CAAA;IAC1C,MAAM,CAAC,IAAI,EAAE,CAAC,GAAG,OAAO,CAAA;IACxB,GAAG,CAAC,IAAI,EAAE,CAAC,GAAG,OAAO,CAAA;IACrB,IAAI,IAAI,MAAM,CAAA;IACd,KAAK,IAAI,IAAI,CAAA;CACd;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,CAAC,SAAS,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,CA+C9D"}

package/create-lifo-list.d.ts

@@ -0,0 +1,18 @@
+export interface LifoList<T extends object> {
+    push(item: T): void;
+    pull(): T | undefined;
+    map<U>(callback: (item: T) => U): U[];
+    forEach(callback: (item: T) => void): void;
+    remove(item: T): boolean;
+    has(item: T): boolean;
+    size(): number;
+    clear(): void;
+}
+/**
+ * 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.
+ */
+export declare function createLifoList<T extends object>(): LifoList<T>;
+//# sourceMappingURL=create-lifo-list.d.ts.map

package/create-lifo-list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-lifo-list.d.ts","sourceRoot":"","sources":["../../../../libs/utils/list/src/create-lifo-list.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,QAAQ,CAAC,CAAC,SAAS,MAAM;IACxC,IAAI,CAAC,IAAI,EAAE,CAAC,GAAG,IAAI,CAAA;IACnB,IAAI,IAAI,CAAC,GAAG,SAAS,CAAA;IACrB,GAAG,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAA;IACrC,OAAO,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,IAAI,GAAG,IAAI,CAAA;IAC1C,MAAM,CAAC,IAAI,EAAE,CAAC,GAAG,OAAO,CAAA;IACxB,GAAG,CAAC,IAAI,EAAE,CAAC,GAAG,OAAO,CAAA;IACrB,IAAI,IAAI,MAAM,CAAA;IACd,KAAK,IAAI,IAAI,CAAA;CACd;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,CAAC,SAAS,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,CAgD9D"}

package/create-range.d.ts

@@ -0,0 +1,9 @@
+/**
+ * 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
+ */
+export declare function createRange(start: number, end: number): number[];
+//# sourceMappingURL=create-range.d.ts.map

package/create-range.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-range.d.ts","sourceRoot":"","sources":["../../../../libs/utils/list/src/create-range.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAMhE"}

package/create-value-picker.d.ts

@@ -0,0 +1,12 @@
+export interface ValuePicker {
+    current: () => string;
+    next: () => string;
+}
+/**
+ * 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
+ */
+export declare function createValuePicker(values: string[]): ValuePicker;
+//# sourceMappingURL=create-value-picker.d.ts.map

package/create-value-picker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-value-picker.d.ts","sourceRoot":"","sources":["../../../../libs/utils/list/src/create-value-picker.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,MAAM,CAAA;IACrB,IAAI,EAAE,MAAM,MAAM,CAAA;CACnB;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,WAAW,CA4B/D"}

package/get-last-key-in-map.d.ts

@@ -0,0 +1,2 @@
+export declare const getLastKeyInMap: <K = any>(map: Map<K, any>) => K;
+//# sourceMappingURL=get-last-key-in-map.d.ts.map

package/get-last-key-in-map.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-last-key-in-map.d.ts","sourceRoot":"","sources":["../../../../libs/utils/list/src/get-last-key-in-map.ts"],"names":[],"mappings":"AACA,eAAO,MAAM,eAAe,GAAI,CAAC,GAAG,GAAG,EAAE,KAAK,GAAG,CAAC,CAAC,EAAE,GAAG,CAAC,KAAG,CAG3D,CAAA"}

package/index.cjs.js

@@ -0,0 +1,182 @@
+'use strict';
+
+var dataUtils = require('@hyperfrontend/data-utils');
+
+/**
+ * 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 = new Set();
+    const push = (item) => {
+        if (dataUtils.getType(item) !== 'object') {
+            throw new Error('A fifo list only non-primitive values');
+        }
+        if (list.has(item)) {
+            throw new Error('Cannot a item that already exists');
+        }
+        list.add(item);
+    };
+    const pull = () => {
+        const value = list.values().next().value;
+        list.delete(value);
+        return value;
+    };
+    const map = (callback) => {
+        return Array.from(list.values()).map(callback);
+    };
+    const forEach = (callback) => {
+        list.forEach(callback);
+    };
+    const remove = (item) => list.delete(item);
+    const has = (item) => list.has(item);
+    const size = () => list.size;
+    const clear = () => list.clear();
+    const result = {
+        push,
+        pull,
+        map,
+        forEach,
+        remove,
+        has,
+        size,
+        clear,
+    };
+    return Object.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 = new Set();
+    const push = (item) => {
+        if (dataUtils.getType(item) !== 'object') {
+            throw new Error('A lifo list only supports non-primitive values');
+        }
+        list.add(item);
+    };
+    const pull = () => {
+        const lastItem = Array.from(list).pop();
+        if (lastItem) {
+            list.delete(lastItem);
+        }
+        return lastItem;
+    };
+    const map = (callback) => {
+        return Array.from(list).map(callback);
+    };
+    const forEach = (callback) => {
+        list.forEach(callback);
+    };
+    const remove = (item) => list.delete(item);
+    const has = (item) => list.has(item);
+    const size = () => list.size;
+    const clear = () => {
+        list.clear();
+    };
+    const result = {
+        push,
+        pull,
+        map,
+        forEach,
+        remove,
+        has,
+        size,
+        clear,
+    };
+    return Object.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) {
+        range.push(i);
+    }
+    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 new Error('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();
+        index = ++index < values.length ? index : 0;
+        return values[index];
+    }
+    return {
+        current: current,
+        next: next,
+    };
+}
+
+// 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 Array.from(new Set(values));
+}
+
+exports.createFifoList = createFifoList;
+exports.createLifoList = createLifoList;
+exports.createRange = createRange;
+exports.createValuePicker = createValuePicker;
+exports.getLastKeyInMap = getLastKeyInMap;
+exports.nonEmptyStrings = nonEmptyStrings;
+exports.uniqueStrings = uniqueStrings;
+//# sourceMappingURL=index.cjs.js.map

package/index.cjs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs.js","sources":["../../../../libs/utils/list/src/create-fifo-list.ts","../../../../libs/utils/list/src/create-lifo-list.ts","../../../../libs/utils/list/src/create-range.ts","../../../../libs/utils/list/src/create-value-picker.ts","../../../../libs/utils/list/src/get-last-key-in-map.ts","../../../../libs/utils/list/src/non-empty-strings.ts","../../../../libs/utils/list/src/unique-strings.ts"],"sourcesContent":[null,null,null,null,null,null,null],"names":["getType"],"mappings":"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"}

package/index.d.ts

@@ -0,0 +1,8 @@
+export * from './create-fifo-list';
+export * from './create-lifo-list';
+export * from './create-range';
+export * from './create-value-picker';
+export * from './get-last-key-in-map';
+export * from './non-empty-strings';
+export * from './unique-strings';
+//# sourceMappingURL=index.d.ts.map

package/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../libs/utils/list/src/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAA;AAClC,cAAc,oBAAoB,CAAA;AAClC,cAAc,gBAAgB,CAAA;AAC9B,cAAc,uBAAuB,CAAA;AACrC,cAAc,uBAAuB,CAAA;AACrC,cAAc,qBAAqB,CAAA;AACnC,cAAc,kBAAkB,CAAA"}