@hairy/utils 1.49.0 → 1.51.0

package/dist/index.mjs

@@ -6487,6 +6487,7 @@ const noop = () => {};
 * ```ts
 * const deferred = new Deferred()
 * deferred.resolve('value')
+* ```
 */
 var Deferred = class extends Promise {
 	resolve;
@@ -6518,11 +6519,88 @@ var Deferred = class extends Promise {
 * @example
 * ```ts
 * delay(1000).then(() => { console.log('1 second') })
+* ```
 */
 function delay(ms) {
 	return new Promise((resolve) => setTimeout(resolve, ms));
 }
 
+//#endregion
+//#region src/util/proxy.ts
+/**
+* Creates a proxy object that updates the original object when the proxy is updated.
+* @param initObject - The initial object to proxy.
+* @returns The proxy object.
+*
+* @example
+* ```ts
+* const obj = proxy({ name: 'John' })
+* console.log(obj.name) // John
+*
+* obj.proxy.update({ name: 'Jane' })
+* console.log(obj.name) // Jane
+*
+* const obj2 = proxy()
+*
+* obj2.any // Error: Proxy not updated. Call object.proxy.update() to update the proxy.
+*
+* obj2.proxy.source // undefined
+* obj2.update({ name: 'John' })
+*
+* // get the original object
+* obj2.proxy.source // { name: 'John' }
+* ```
+*/
+function proxy(initObject, initExtend, options) {
+	initObject && Reflect.set(initObject, "__proxy_updated", true);
+	let target = initObject || { __proxy_updated: false };
+	const extended = initExtend || {};
+	const proxy = {
+		update(object) {
+			if (!object) {
+				target = void 0;
+				return;
+			}
+			Reflect.set(object, "__proxy_updated", true);
+			target = object;
+		},
+		get source() {
+			return Reflect.get(target, "__proxy_updated") ? target : void 0;
+		},
+		get extend() {
+			return extended;
+		},
+		strictMessage: options?.strictMessage || "Proxy not updated. Call object.proxy.update() to update the proxy."
+	};
+	return new Proxy({}, {
+		get: (_, p) => {
+			if (p === "proxy") return proxy;
+			if (p in extended) return Reflect.get(extended, p);
+			if (!Reflect.get(target, "__proxy_updated")) throw new Error(proxy.strictMessage);
+			return typeof target?.[p] === "function" ? target?.[p].bind(target) : target?.[p];
+		},
+		set: (_, p, v) => {
+			if (p in extended) return Reflect.set(extended, p, v);
+			target[p] = v;
+			return true;
+		}
+	});
+}
+
+//#endregion
+//#region src/util/ghost.ts
+function ghost(strictMessage) {
+	const placeholder = proxy(void 0, {
+		enabled: false,
+		resolve
+	}, { strictMessage: strictMessage || "Object is not enabled. Call ghost.resolve(value) to enable the object." });
+	function resolve(value) {
+		placeholder.proxy.update(value);
+		placeholder.enabled = true;
+	}
+	return placeholder;
+}
+
 //#endregion
 //#region src/util/json.ts
 function tryParseJson(text) {
@@ -6604,68 +6682,6 @@ function pipe(...fns) {
 }
 pipe.promise = pPipe;
 
-//#endregion
-//#region src/util/proxy.ts
-/**
-* Creates a proxy object that updates the original object when the proxy is updated.
-* @param initObject - The initial object to proxy.
-* @returns The proxy object.
-*
-* @example
-* ```ts
-* const obj = proxy({ name: 'John' })
-* console.log(obj.name) // John
-*
-* obj.proxy.update({ name: 'Jane' })
-* console.log(obj.name) // Jane
-*
-* const obj2 = proxy()
-*
-* obj2.any // Error: Proxy not updated. Call object.proxy.update() to update the proxy.
-*
-* obj2.proxy.source // undefined
-* obj2.update({ name: 'John' })
-*
-* // get the original object
-* obj2.proxy.source // { name: 'John' }
-* ```
-*/
-function proxy(initObject, initExtend, options) {
-	initObject && Reflect.set(initObject, "__proxy_updated", true);
-	let target = initObject || { __proxy_updated: false };
-	const extended = initExtend || {};
-	const proxy = {
-		update(object) {
-			if (!object) {
-				target = void 0;
-				return;
-			}
-			Reflect.set(object, "__proxy_updated", true);
-			target = object;
-		},
-		get source() {
-			return Reflect.get(target, "__proxy_updated") ? target : void 0;
-		},
-		get extend() {
-			return extended;
-		},
-		strictMessage: options?.strictMessage || "Proxy not updated. Call object.proxy.update() to update the proxy."
-	};
-	return new Proxy({}, {
-		get: (_, p) => {
-			if (p === "proxy") return proxy;
-			if (p in extended) return Reflect.get(extended, p);
-			if (!Reflect.get(target, "__proxy_updated")) throw new Error(proxy.strictMessage);
-			return typeof target?.[p] === "function" ? target?.[p].bind(target) : target?.[p];
-		},
-		set: (_, p, v) => {
-			if (p in extended) return Reflect.set(extended, p, v);
-			target[p] = v;
-			return true;
-		}
-	});
-}
-
 //#endregion
 //#region src/util/random.ts
 /**
@@ -6675,6 +6691,7 @@ function proxy(initObject, initExtend, options) {
 * @example
 * ```ts
 * randomItem(['a', 'b', 'c']) // 'a' | 'b' | 'c'
+* ```
 */
 function randomItem(array) {
 	return array[Math.floor(Math.random() * array.length)];
@@ -6687,6 +6704,7 @@ function randomItem(array) {
 * @example
 * ```ts
 * randomNumber(0, 100) // 0-100
+* ```
 */
 function randomNumber(min, max) {
 	return Math.random() * (max - min) + min;
@@ -6702,6 +6720,7 @@ const urlAlphabet = "useandom-26T198340PX75pxJACKVERYMINDBUSHWOLF_GQZbfghjklqvwy
 * randomString() // 10 characters long
 * randomString(20) // 20 characters long
 * randomString(20, 'abcdefghijklmnopqrstuvwxyz') // 20 characters long
+* ```
 */
 function randomString(size = 10, chars = urlAlphabet) {
 	let id = "";
@@ -6775,6 +6794,7 @@ function numberish(value) {
 * ```ts
 * to(Promise.resolve('data')) // Promise<[null, 'data']>
 * to(Promise.reject(new Error('error'))) // Promise<[Error, undefined]>
+* ```
 */
 async function to(promise, error) {
 	return (isFunction(promise) ? promise() : promise).then((data) => [null, data]).catch((err) => {
@@ -6794,6 +6814,7 @@ async function to(promise, error) {
 * ```ts
 * toArray(arrorOrItemOrUndefined) // item[] | undefined
 * toArray(arrayOrItemOrUndefined, true) // item[]
+* ```
 */
 function toArray(value, required = false) {
 	if (!value) return required === false ? void 0 : [];
@@ -6862,6 +6883,7 @@ const riposte = select;
 * ```ts
 * unwrap({ name: 'John' }) // { name: 'John' }
 * unwrap(() => { return { name: 'John' } }) // { name: 'John' }
+* ```
 */
 function unwrap(value) {
 	return typeof value === "function" ? value() : value;
@@ -6874,6 +6896,7 @@ function unwrap(value) {
 * @example
 * ```ts
 * whenever(value, (value) => { return 'value' }) // value
+* ```
 */
 function whenever(value, callback) {
 	return value ? callback(value) : void 0;
@@ -7128,6 +7151,7 @@ const _reFullWs = /^\s*$/;
 *     b()
 *   }
 * `
+* ```
 */
 function unindent(str) {
 	const lines = (typeof str === "string" ? str : str[0]).split("\n");
@@ -7145,4 +7169,4 @@ function unindent(str) {
 }
 
 //#endregion
-export { BIG_INTS, Bignumber, DEFAULT_BIGNUM_CONFIG, Deferred, arange, average, bignumber, call, camelCase, capitalCase, chunk, clone, cloneDeep, cloneDeepWith, cloneWith, compose, concat, constantCase, cover, debounce, decimal, delay, dialsPhone, divide, dotCase, downloadBlobFile, downloadNetworkFile, downloadUrlFile, ensurePrefix, ensureSuffix, find, formatNumeric, formdataToObject, get, groupBy, gt, gte, integer, isAndroid, isArguments, isArray, isArrayBuffer, isArrayLike, isArrayLikeObject, isBoolean, isBrowser, isBuffer, isChrome, isDate, isEdge, isElement, isEmpty, isEqual, isEqualWith, isError, isFF, isFormData, isFunction, isIE, isIE11, isIE9, isIOS, isInteger, isMap, isMatch, isMatchWith, isMobile, isNaN, isNative, isNull$1 as isNull, isNumber, isObject, isObjectLike, isPhantomJS, isPlainObject, isRegExp as isRegexp, isSet, isString, isSymbol, isTruthy, isUndefined, isWeakMap, isWeakSet, isWeex, isWindow, join, kebabCase, keyBy, keys, loop, lt, lte, max, maxBy, merge, mergeWith, min, minBy, multiply, noCase, nonnanable, noop, numberify, numberish, objectToFormdata, off, omit, omitBy, on, once, openFilePicker, openImagePicker, parseNumeric, pascalCase, pascalSnakeCase, pathCase, percentage, pick, pickBy, pipe, plus, proxy, randomItem, randomNumber, randomString, range, readFileReader, redirectTo, riposte, select, selectImages, sentenceCase, set, shortenId, showOpenFilePicker, showOpenImagePicker, size, slash, snakeCase, stringify, template, to, toArray, trainCase, truncate, tryParseJson, unindent, uniq, uniqBy, uniqWith, unit, unwrap, values, whenever, zeroRemove, zerofill };
+export { BIG_INTS, Bignumber, DEFAULT_BIGNUM_CONFIG, Deferred, arange, average, bignumber, call, camelCase, capitalCase, chunk, clone, cloneDeep, cloneDeepWith, cloneWith, compose, concat, constantCase, cover, debounce, decimal, delay, dialsPhone, divide, dotCase, downloadBlobFile, downloadNetworkFile, downloadUrlFile, ensurePrefix, ensureSuffix, find, formatNumeric, formdataToObject, get, ghost, groupBy, gt, gte, integer, isAndroid, isArguments, isArray, isArrayBuffer, isArrayLike, isArrayLikeObject, isBoolean, isBrowser, isBuffer, isChrome, isDate, isEdge, isElement, isEmpty, isEqual, isEqualWith, isError, isFF, isFormData, isFunction, isIE, isIE11, isIE9, isIOS, isInteger, isMap, isMatch, isMatchWith, isMobile, isNaN, isNative, isNull$1 as isNull, isNumber, isObject, isObjectLike, isPhantomJS, isPlainObject, isRegExp as isRegexp, isSet, isString, isSymbol, isTruthy, isUndefined, isWeakMap, isWeakSet, isWeex, isWindow, join, kebabCase, keyBy, keys, loop, lt, lte, max, maxBy, merge, mergeWith, min, minBy, multiply, noCase, nonnanable, noop, numberify, numberish, objectToFormdata, off, omit, omitBy, on, once, openFilePicker, openImagePicker, parseNumeric, pascalCase, pascalSnakeCase, pathCase, percentage, pick, pickBy, pipe, plus, proxy, randomItem, randomNumber, randomString, range, readFileReader, redirectTo, riposte, select, selectImages, sentenceCase, set, shortenId, showOpenFilePicker, showOpenImagePicker, size, slash, snakeCase, stringify, template, to, toArray, trainCase, truncate, tryParseJson, unindent, uniq, uniqBy, uniqWith, unit, unwrap, values, whenever, zeroRemove, zerofill };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@hairy/utils",
   "type": "module",
-  "version": "1.49.0",
+  "version": "1.51.0",
   "description": "Library for anywhere",
   "author": "Hairyf <wwu710632@gmail.com>",
   "license": "MIT",