@lowentry/utils 1.17.1 → 1.19.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lowentry/utils",
-  "version": "1.17.1",
+  "version": "1.19.1",
   "private": false,
   "type": "module",
   "main": "./index.js",
@@ -20,7 +20,7 @@
   "scripts": {
     "build": "npm exec -- rollup -c",
     "prepublishOnly": "rm -r src && mv dist/* ./ && rm -r dist",
-    "test": "npx tsc && jest"
+    "test": "npx tsc && vitest run"
   },
   "dependencies": {
     "@babel/runtime": "*",
@@ -37,20 +37,21 @@
     "@babel/plugin-transform-runtime": "^7.24.7",
     "@babel/preset-env": "^7.24.7",
     "@babel/preset-react": "^7.24.7",
+    "@microsoft/api-extractor": "^7.52.8",
+    "@rollup/plugin-babel": "^6.0.4",
     "@rollup/plugin-commonjs": "^26.0.1",
     "@rollup/plugin-node-resolve": "^15.2.3",
     "@rollup/plugin-url": "^8.0.2",
     "autoprefixer": "^10.4.19",
     "cssnano": "^7.0.2",
     "fs-extra": "^11.2.0",
-    "jest": "^30.0.3",
     "less": "^4.2.0",
     "rollup": "^2.79.1",
-    "rollup-plugin-babel": "^4.4.0",
+    "rollup-plugin-execute": "^1.1.1",
     "rollup-plugin-peer-deps-external": "^2.2.4",
     "rollup-plugin-postcss": "^4.0.2",
     "sass": "^1.77.5",
-    "ts-jest": "^29.4.0",
-    "typescript": "^5.8.3"
+    "typescript": "^5.8.3",
+    "vitest": "^3.2.4"
   }
 }

package/src/LeUtils.js

@@ -593,7 +593,7 @@ export const LeUtils = {
 	 *
 	 * @param {*} elements
 	 * @param {boolean} [optionalSkipHasOwnPropertyCheck]
-	 * @returns {Generator<*, void, *>}
+	 * @yields {[key:*, value:*]}
 	 */
 	eachIterator:
 		function* (elements, optionalSkipHasOwnPropertyCheck = false)

package/src/classes/LinkedList.js

@@ -0,0 +1,145 @@
+class LinkedListNode
+{
+	/** @type {*} */
+	value;
+	
+	/** @type {LinkedListNode|null} */
+	next = null;
+	
+	/** @type {LinkedListNode|null} */
+	previous = null;
+	
+	/**
+	 * @param {*} value
+	 */
+	constructor(value)
+	{
+		this.value = value;
+	}
+}
+
+export class LinkedList
+{
+	/** @type {LinkedListNode|null} */
+	#head = null;
+	
+	/** @type {LinkedListNode|null} */
+	#tail = null;
+	
+	/** @type {number} */
+	#size = 0;
+	
+	constructor()
+	{
+	}
+	
+	/**
+	 * Returns the number of elements in the list.
+	 *
+	 * @returns {number}
+	 */
+	get size()
+	{
+		return this.#size;
+	}
+	
+	/**
+	 * Adds a new value to the beginning of the list.
+	 *
+	 * @param {*} value
+	 */
+	unshift(value)
+	{
+		const newNode = new LinkedListNode(value);
+		if(this.#head === null)
+		{
+			this.#head = newNode;
+			this.#tail = newNode;
+		}
+		else
+		{
+			newNode.next = this.#head;
+			this.#head.previous = newNode;
+			this.#head = newNode;
+		}
+		this.#size++;
+	}
+	
+	/**
+	 * Adds a new value to the end of the list.
+	 *
+	 * @param {*} value
+	 */
+	push(value)
+	{
+		const newNode = new LinkedListNode(value);
+		if(this.#tail === null)
+		{
+			this.#head = newNode;
+			this.#tail = newNode;
+		}
+		else
+		{
+			newNode.previous = this.#tail;
+			this.#tail.next = newNode;
+			this.#tail = newNode;
+		}
+		this.#size++;
+	}
+	
+	/**
+	 * Removes the first value from the list and returns it.
+	 *
+	 * @returns {*|undefined}
+	 */
+	shift()
+	{
+		if(this.#head === null)
+		{
+			return undefined;
+		}
+		
+		const value = this.#head.value;
+		this.#head = this.#head.next;
+		
+		if(this.#head !== null)
+		{
+			this.#head.previous = null;
+		}
+		else
+		{
+			this.#tail = null;
+		}
+		
+		this.#size--;
+		return value;
+	}
+	
+	/**
+	 * Removes the last value from the list and returns it.
+	 *
+	 * @returns {*|undefined}
+	 */
+	pop()
+	{
+		if(this.#tail === null)
+		{
+			return undefined;
+		}
+		
+		const value = this.#tail.value;
+		this.#tail = this.#tail.previous;
+		
+		if(this.#tail !== null)
+		{
+			this.#tail.next = null;
+		}
+		else
+		{
+			this.#head = null;
+		}
+		
+		this.#size--;
+		return value;
+	}
+}

package/src/classes/SerializableMap.js

@@ -0,0 +1,17 @@
+/**
+ * SerializableMap class extends the native Map to provide a JSON representation.
+ *
+ * This class can only have string keys, as JSON does not support non-string keys.
+ */
+export class SerializableMap extends Map
+{
+	/**
+	 * Returns a JSON representation of the map.
+	 *
+	 * @returns {object}
+	 */
+	toJSON()
+	{
+		return Object.fromEntries(this);
+	}
+}

package/src/index.js

@@ -1,2 +1,4 @@
 export {LeUtils} from './LeUtils.js';
 export {ISSET, IS_ARRAY, ARRAY, IS_OBJECT, OBJECT, STRING, STRING_ANY, INT, INT_ANY, FLOAT, FLOAT_ANY, INT_LAX, INT_LAX_ANY, FLOAT_LAX, FLOAT_LAX_ANY} from './LeTypes.js';
+export {LinkedList} from './classes/LinkedList.js';
+export {SerializableMap} from './classes/SerializableMap.js';

package/tests/each.test.js

@@ -1,4 +1,4 @@
-import {describe, test, expect, jest} from '@jest/globals';
+import {describe, test, expect} from 'vitest';
 import {LeUtils} from '../src/index.js';
 
 const wait = ms => LeUtils.promiseTimeout(ms ?? 100);
@@ -433,7 +433,6 @@ describe('LeUtils.supportsEach() custom forEach object and function', () =>
 
 describe('LeUtils.eachAsync() heavy parallel', () =>
 {
-	jest.setTimeout(10000);
 	test('processes 100 items with concurrency 20', async () =>
 	{
 		const size = 100;
@@ -453,7 +452,7 @@ describe('LeUtils.eachAsync() heavy parallel', () =>
 		);
 		expect(max.length).toBe(size);
 		expect(Math.max(...max)).toBeLessThanOrEqual(20);
-	});
+	}, 10000);
 	test('serial path matches sequential order with strings', async () =>
 	{
 		const seen = [];
@@ -639,7 +638,6 @@ describe('LeUtils.getEmptySimplifiedCollection() extra', () =>
 
 describe('LeUtils.eachAsync() stress 1000 items', () =>
 {
-	jest.setTimeout(20000);
 	test('parallel 200 completes', async () =>
 	{
 		const N = 1000;
@@ -651,7 +649,7 @@ describe('LeUtils.eachAsync() stress 1000 items', () =>
 			await wait();
 		}, 200);
 		expect(count).toBe(N);
-	});
+	}, 20000);
 	test('early false stops further enqueues', async () =>
 	{
 		const list = [...Array(50).keys()];

package/tests/sort.test.js

@@ -1,4 +1,4 @@
-import {describe, test, expect, jest} from '@jest/globals';
+import {describe, test, expect} from 'vitest';
 import {LeUtils} from '../src/index.js';
 
 const wait = ms => LeUtils.promiseTimeout(ms ?? 100);

package/tsconfig.d.ts

@@ -1,3 +1 @@
-interface Window {
-  [key: string]: any;
-}
+/// <reference lib="esnext" />

package/tsconfig.json

@@ -3,7 +3,6 @@
     "allowJs": true,
     "checkJs": true,
     "strict": true,
-    "noEmit": true,
     "noImplicitAny": false,
     "noImplicitThis": false,
     "alwaysStrict": true,
@@ -15,7 +14,14 @@
     "module": "esnext",
     "moduleResolution": "node",
     "skipLibCheck": true,
-    "types": []
+    "types": [],
+    "noEmit": false,
+    "declaration": true,
+    "declarationMap": false,
+    "outDir": "./build",
+    "removeComments": false,
+    "stripInternal": true,
+    "emitDeclarationOnly": true
   },
   "include": [
     "tsconfig.d.ts",
@@ -23,5 +29,11 @@
   ],
   "exclude": [
     "node_modules"
-  ]
+  ],
+  "typeAcquisition": {
+    "include": [
+      "react",
+      "react-dom"
+    ]
+  }
 }

package/jest.config.mjs

@@ -1,10 +0,0 @@
-export default {
-	preset:              'ts-jest/presets/js-with-ts-esm',
-	globals:             {
-		extensionsToTreatAsEsm:['.ts', '.js', '.mjs', '.mjsx'],
-	},
-	transform:           {
-		'^.+\\.[tj]sx?$|^.+\\.mjsx?$':['ts-jest', {useESM:true}],
-	},
-	moduleFileExtensions:['ts', 'tsx', 'js', 'jsx', 'mjs', 'mjsx', 'json', 'node'],
-};