es-toolkit 1.52.0-dev.2139 → 1.52.0-dev.2141

package/dist/util/queue.mjs

@@ -0,0 +1,141 @@
+import _classPrivateFieldInitSpec from "../_virtual/_@oxc-project_runtime@0.155.0/helpers/esm/classPrivateFieldInitSpec.mjs";
+import _classPrivateFieldGet2 from "../_virtual/_@oxc-project_runtime@0.155.0/helpers/esm/classPrivateFieldGet2.mjs";
+import _classPrivateFieldSet2 from "../_virtual/_@oxc-project_runtime@0.155.0/helpers/esm/classPrivateFieldSet2.mjs";
+// src/util/queue.ts
+let _Symbol$iterator;
+var _head = /* @__PURE__ */ new WeakMap();
+var _tail = /* @__PURE__ */ new WeakMap();
+var _size = /* @__PURE__ */ new WeakMap();
+_Symbol$iterator = Symbol.iterator;
+/**
+* A first-in, first-out (FIFO) queue backed by a linked list.
+*
+* Unlike `Array.prototype.shift`, which takes linear time, `dequeue` takes constant time,
+* so it stays fast no matter how many items are in the queue.
+*
+* The queue is iterable, so you can loop over its items from front to back with `for...of`
+* or spread it into an array. Iterating does not remove items from the queue.
+*
+* @template T - The type of items in the queue.
+*
+* @example
+* const queue = new Queue<string>();
+*
+* queue.enqueue('a');
+* queue.enqueue('b');
+*
+* console.log(queue.size); // 2
+* console.log([...queue]); // ['a', 'b']
+*
+* console.log(queue.dequeue()); // 'a'
+* console.log(queue.dequeue()); // 'b'
+* console.log(queue.dequeue()); // undefined
+*/
+var Queue = class {
+	constructor() {
+		_classPrivateFieldInitSpec(this, _head, void 0);
+		_classPrivateFieldInitSpec(this, _tail, void 0);
+		_classPrivateFieldInitSpec(this, _size, 0);
+	}
+	/**
+	* The number of items in the queue.
+	*
+	* @example
+	* const queue = new Queue<number>();
+	* queue.enqueue(1);
+	* console.log(queue.size); // 1
+	*/
+	get size() {
+		return _classPrivateFieldGet2(_size, this);
+	}
+	/**
+	* Adds an item to the back of the queue.
+	*
+	* @param value - The item to add.
+	*
+	* @example
+	* const queue = new Queue<number>();
+	* queue.enqueue(1);
+	* queue.enqueue(2);
+	* console.log([...queue]); // [1, 2]
+	*/
+	enqueue(value) {
+		var _this$size;
+		const node = {
+			value,
+			next: void 0
+		};
+		if (_classPrivateFieldGet2(_tail, this) === void 0) _classPrivateFieldSet2(_head, this, node);
+		else _classPrivateFieldGet2(_tail, this).next = node;
+		_classPrivateFieldSet2(_tail, this, node);
+		_classPrivateFieldSet2(_size, this, (_this$size = _classPrivateFieldGet2(_size, this), _this$size++, _this$size));
+	}
+	/**
+	* Removes and returns the item at the front of the queue.
+	*
+	* @returns The removed item, or `undefined` if the queue is empty.
+	*
+	* @example
+	* const queue = new Queue<number>();
+	* queue.enqueue(1);
+	* console.log(queue.dequeue()); // 1
+	* console.log(queue.dequeue()); // undefined
+	*/
+	dequeue() {
+		var _this$size3;
+		const node = _classPrivateFieldGet2(_head, this);
+		if (node === void 0) return;
+		_classPrivateFieldSet2(_head, this, node.next);
+		if (_classPrivateFieldGet2(_head, this) === void 0) _classPrivateFieldSet2(_tail, this, void 0);
+		_classPrivateFieldSet2(_size, this, (_this$size3 = _classPrivateFieldGet2(_size, this), _this$size3--, _this$size3));
+		return node.value;
+	}
+	/**
+	* Returns the item at the front of the queue without removing it.
+	*
+	* @returns The item at the front, or `undefined` if the queue is empty.
+	*
+	* @example
+	* const queue = new Queue<number>();
+	* queue.enqueue(1);
+	* console.log(queue.peek()); // 1
+	* console.log(queue.size); // 1
+	*/
+	peek() {
+		var _classPrivateFieldGet2$1;
+		return (_classPrivateFieldGet2$1 = _classPrivateFieldGet2(_head, this)) === null || _classPrivateFieldGet2$1 === void 0 ? void 0 : _classPrivateFieldGet2$1.value;
+	}
+	/**
+	* Removes all items from the queue.
+	*
+	* @example
+	* const queue = new Queue<number>();
+	* queue.enqueue(1);
+	* queue.clear();
+	* console.log(queue.size); // 0
+	*/
+	clear() {
+		_classPrivateFieldSet2(_head, this, void 0);
+		_classPrivateFieldSet2(_tail, this, void 0);
+		_classPrivateFieldSet2(_size, this, 0);
+	}
+	/**
+	* Returns an iterator over the items in the queue from front to back, without removing them.
+	*
+	* @returns An iterator over the items.
+	*
+	* @example
+	* const queue = new Queue<number>();
+	* queue.enqueue(1);
+	* queue.enqueue(2);
+	* console.log([...queue]); // [1, 2]
+	*/
+	*[_Symbol$iterator]() {
+		let node = _classPrivateFieldGet2(_head, this);
+		while (node !== void 0) {
+			yield node.value;
+			node = node.next;
+		}
+	}
+};
+export { Queue };

package/dist/util/serialize/compareValues.js

@@ -1,5 +1,5 @@
 const require_serialize = require("./serialize.js");
-//#region src/util/serialize/compareValues.ts
+// src/util/serialize/compareValues.ts
 /**
 * Compares two values for sorting `Set` values and `Map` keys.
 *
@@ -19,5 +19,4 @@ function compareValues(a, b, refs) {
 	if (serializedA === serializedB) return 0;
 	return serializedA < serializedB ? -1 : 1;
 }
-//#endregion
 exports.compareValues = compareValues;

package/dist/util/serialize/compareValues.mjs

@@ -1,5 +1,5 @@
 import { serializeValue } from "./serialize.mjs";
-//#region src/util/serialize/compareValues.ts
+// src/util/serialize/compareValues.ts
 /**
 * Compares two values for sorting `Set` values and `Map` keys.
 *
@@ -19,5 +19,4 @@ function compareValues(a, b, refs) {
 	if (serializedA === serializedB) return 0;
 	return serializedA < serializedB ? -1 : 1;
 }
-//#endregion
 export { compareValues };

package/dist/util/serialize/serialize.d.mts

@@ -1,4 +1,3 @@
-//#region src/util/serialize/serialize.d.ts
 /**
  * Serializes any value into a stable string.
  *
@@ -30,7 +29,7 @@
  * obj.self = obj;
  * serialize(obj); // "{'self':#ref0}"
  */
-declare function serialize(value: unknown): string;
+export declare function serialize(value: unknown): string;
 /**
  * Serializes a value with a shared circular reference context.
  *
@@ -40,5 +39,4 @@ declare function serialize(value: unknown): string;
  * @returns The serialized string.
  */
 declare function serializeValue(value: unknown, refs: Map<object, string>): string;
-//#endregion
-export { serialize };
+export {};

package/dist/util/serialize/serialize.d.ts

@@ -1,4 +1,3 @@
-//#region src/util/serialize/serialize.d.ts
 /**
  * Serializes any value into a stable string.
  *
@@ -30,7 +29,7 @@
  * obj.self = obj;
  * serialize(obj); // "{'self':#ref0}"
  */
-declare function serialize(value: unknown): string;
+export declare function serialize(value: unknown): string;
 /**
  * Serializes a value with a shared circular reference context.
  *
@@ -40,5 +39,4 @@ declare function serialize(value: unknown): string;
  * @returns The serialized string.
  */
 declare function serializeValue(value: unknown, refs: Map<object, string>): string;
-//#endregion
-export { serialize };
+export {};

package/dist/util/serialize/serialize.js

@@ -4,7 +4,7 @@ const require_serializeNumber = require("./serializeNumber.js");
 const require_serializeString = require("./serializeString.js");
 const require_serializeObject = require("./serializeObject.js");
 const require_serializeSymbol = require("./serializeSymbol.js");
-//#region src/util/serialize/serialize.ts
+// src/util/serialize/serialize.ts
 /**
 * Serializes any value into a stable string.
 *
@@ -59,6 +59,5 @@ function serializeValue(value, refs) {
 		case "undefined": return "undefined";
 	}
 }
-//#endregion
 exports.serialize = serialize;
 exports.serializeValue = serializeValue;

package/dist/util/serialize/serialize.mjs

@@ -4,7 +4,7 @@ import { serializeNumber } from "./serializeNumber.mjs";
 import { serializeString } from "./serializeString.mjs";
 import { serializeObject } from "./serializeObject.mjs";
 import { serializeSymbol } from "./serializeSymbol.mjs";
-//#region src/util/serialize/serialize.ts
+// src/util/serialize/serialize.ts
 /**
 * Serializes any value into a stable string.
 *
@@ -59,5 +59,4 @@ function serializeValue(value, refs) {
 		case "undefined": return "undefined";
 	}
 }
-//#endregion
 export { serialize, serializeValue };

package/dist/util/serialize/serializeBigInt.js

@@ -1,4 +1,4 @@
-//#region src/util/serialize/serializeBigInt.ts
+// src/util/serialize/serializeBigInt.ts
 /**
 * Serializes a bigint into a string with an `n` suffix, like a bigint literal.
 *
@@ -11,5 +11,4 @@
 function serializeBigInt(value) {
 	return `${value}n`;
 }
-//#endregion
 exports.serializeBigInt = serializeBigInt;

package/dist/util/serialize/serializeBigInt.mjs

@@ -1,4 +1,4 @@
-//#region src/util/serialize/serializeBigInt.ts
+// src/util/serialize/serializeBigInt.ts
 /**
 * Serializes a bigint into a string with an `n` suffix, like a bigint literal.
 *
@@ -11,5 +11,4 @@
 function serializeBigInt(value) {
 	return `${value}n`;
 }
-//#endregion
 export { serializeBigInt };

package/dist/util/serialize/serializeFunction.js

@@ -1,4 +1,4 @@
-//#region src/util/serialize/serializeFunction.ts
+// src/util/serialize/serializeFunction.ts
 /**
 * Serializes a function into a string of the form `name:source`.
 *
@@ -22,5 +22,4 @@ function serializeFunction(value) {
 	if (source.endsWith("[native code] }")) return `${value.name}:[native]`;
 	return `${value.name}:${source.replace(/\s*\n\s*/g, "")}`;
 }
-//#endregion
 exports.serializeFunction = serializeFunction;

package/dist/util/serialize/serializeFunction.mjs

@@ -1,4 +1,4 @@
-//#region src/util/serialize/serializeFunction.ts
+// src/util/serialize/serializeFunction.ts
 /**
 * Serializes a function into a string of the form `name:source`.
 *
@@ -22,5 +22,4 @@ function serializeFunction(value) {
 	if (source.endsWith("[native code] }")) return `${value.name}:[native]`;
 	return `${value.name}:${source.replace(/\s*\n\s*/g, "")}`;
 }
-//#endregion
 export { serializeFunction };

package/dist/util/serialize/serializeNumber.js

@@ -1,4 +1,4 @@
-//#region src/util/serialize/serializeNumber.ts
+// src/util/serialize/serializeNumber.ts
 /**
 * Serializes a number into a string.
 *
@@ -17,5 +17,4 @@
 function serializeNumber(value) {
 	return String(value);
 }
-//#endregion
 exports.serializeNumber = serializeNumber;

package/dist/util/serialize/serializeNumber.mjs

@@ -1,4 +1,4 @@
-//#region src/util/serialize/serializeNumber.ts
+// src/util/serialize/serializeNumber.ts
 /**
 * Serializes a number into a string.
 *
@@ -17,5 +17,4 @@
 function serializeNumber(value) {
 	return String(value);
 }
-//#endregion
 export { serializeNumber };

package/dist/util/serialize/serializeObject.js

@@ -10,7 +10,7 @@ const require_compareValues = require("./compareValues.js");
 const require_serializeString = require("./serializeString.js");
 const require_serializePlainObject = require("./serializePlainObject.js");
 const require_serialize = require("./serialize.js");
-//#region src/util/serialize/serializeObject.ts
+// src/util/serialize/serializeObject.ts
 /**
 * Serializes an object, handling circular references and repeated references.
 *
@@ -81,5 +81,4 @@ function serializeClassInstance(value, refs) {
 	}
 	return name + require_serializePlainObject.serializePlainObject(value, refs);
 }
-//#endregion
 exports.serializeObject = serializeObject;

package/dist/util/serialize/serializeObject.mjs

@@ -10,7 +10,7 @@ import { compareValues } from "./compareValues.mjs";
 import { serializeString } from "./serializeString.mjs";
 import { serializePlainObject } from "./serializePlainObject.mjs";
 import { serializeValue } from "./serialize.mjs";
-//#region src/util/serialize/serializeObject.ts
+// src/util/serialize/serializeObject.ts
 /**
 * Serializes an object, handling circular references and repeated references.
 *
@@ -81,5 +81,4 @@ function serializeClassInstance(value, refs) {
 	}
 	return name + serializePlainObject(value, refs);
 }
-//#endregion
 export { serializeObject };

package/dist/util/serialize/serializePlainObject.js

@@ -1,6 +1,6 @@
 const require_serializeString = require("./serializeString.js");
 const require_serialize = require("./serialize.js");
-//#region src/util/serialize/serializePlainObject.ts
+// src/util/serialize/serializePlainObject.ts
 /**
 * Serializes the own enumerable string-keyed properties of an object
 * into a `{'key':value}` string.
@@ -27,5 +27,4 @@ function serializePlainObject(object, refs) {
 	}
 	return result + "}";
 }
-//#endregion
 exports.serializePlainObject = serializePlainObject;

package/dist/util/serialize/serializePlainObject.mjs

@@ -1,6 +1,6 @@
 import { serializeString } from "./serializeString.mjs";
 import { serializeValue } from "./serialize.mjs";
-//#region src/util/serialize/serializePlainObject.ts
+// src/util/serialize/serializePlainObject.ts
 /**
 * Serializes the own enumerable string-keyed properties of an object
 * into a `{'key':value}` string.
@@ -27,5 +27,4 @@ function serializePlainObject(object, refs) {
 	}
 	return result + "}";
 }
-//#endregion
 export { serializePlainObject };

package/dist/util/serialize/serializeString.js

@@ -1,4 +1,4 @@
-//#region src/util/serialize/serializeString.ts
+// src/util/serialize/serializeString.ts
 /**
 * Serializes a string into a single-quoted string literal.
 *
@@ -14,5 +14,4 @@
 function serializeString(value) {
 	return `'${value}'`;
 }
-//#endregion
 exports.serializeString = serializeString;

package/dist/util/serialize/serializeString.mjs

@@ -1,4 +1,4 @@
-//#region src/util/serialize/serializeString.ts
+// src/util/serialize/serializeString.ts
 /**
 * Serializes a string into a single-quoted string literal.
 *
@@ -14,5 +14,4 @@
 function serializeString(value) {
 	return `'${value}'`;
 }
-//#endregion
 export { serializeString };

package/dist/util/serialize/serializeSymbol.js

@@ -1,5 +1,5 @@
 const require_serializeString = require("./serializeString.js");
-//#region src/util/serialize/serializeSymbol.ts
+// src/util/serialize/serializeSymbol.ts
 /**
 * Serializes a symbol into a string using its description.
 *
@@ -19,5 +19,4 @@ const require_serializeString = require("./serializeString.js");
 function serializeSymbol(value) {
 	return value.description === void 0 ? "Symbol()" : `Symbol(${require_serializeString.serializeString(value.description)})`;
 }
-//#endregion
 exports.serializeSymbol = serializeSymbol;

package/dist/util/serialize/serializeSymbol.mjs

@@ -1,5 +1,5 @@
 import { serializeString } from "./serializeString.mjs";
-//#region src/util/serialize/serializeSymbol.ts
+// src/util/serialize/serializeSymbol.ts
 /**
 * Serializes a symbol into a string using its description.
 *
@@ -19,5 +19,4 @@ import { serializeString } from "./serializeString.mjs";
 function serializeSymbol(value) {
 	return value.description === void 0 ? "Symbol()" : `Symbol(${serializeString(value.description)})`;
 }
-//#endregion
 export { serializeSymbol };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "es-toolkit",
-  "version": "1.52.0-dev.2139+ab7f2d6f",
+  "version": "1.52.0-dev.2141+5b8e3632",
   "description": "A state-of-the-art, high-performance JavaScript utility library with a small bundle size and strong type annotations.",
   "homepage": "https://es-toolkit.dev",
   "bugs": "https://github.com/toss/es-toolkit/issues",
@@ -323,7 +323,7 @@
     "prettier": "^3.2.5",
     "prettier-plugin-sort-re-exports": "^0.1.0",
     "tar": "^6",
-    "tsdown": "^0.22.0",
+    "tsdown": "^0.23.1",
     "tslib": "^2.6.3",
     "tsx": "^4.19.0",
     "typescript": "^5.8.2",