@hairy/utils 1.46.0 → 1.47.0

package/dist/index.cjs

@@ -163,6 +163,7 @@ __export(index_exports, {
   selectImages: () => selectImages,
   sentenceCase: () => sentenceCase,
   set: () => set_default,
+  shortenId: () => shortenId,
   showOpenFilePicker: () => showOpenFilePicker,
   showOpenImagePicker: () => showOpenImagePicker,
   size: () => size,
@@ -3705,34 +3706,42 @@ function pipe(...fns) {
 pipe.promise = pPipe;
 
 // src/util/proxy.ts
-function proxy(initObject) {
-  initObject && Reflect.set(initObject, "proxyUpdated", true);
-  let target = initObject || { proxyUpdated: false };
-  const proxy2 = new Proxy({}, {
+function proxy(initObject, initExtend, options) {
+  initObject && Reflect.set(initObject, "__proxy_updated", true);
+  let target = initObject || { __proxy_updated: false };
+  const extended = initExtend || {};
+  const proxy2 = {
+    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;
+    },
+    strictMessage: options?.strictMessage || "Proxy not updated. Call object.proxy.update() to update the proxy."
+  };
+  const proxyed = new Proxy({}, {
     get: (_, p) => {
       if (p === "proxy")
-        return { update, original };
-      if (!Reflect.get(target, "proxyUpdated"))
-        throw new Error(`Proxy not updated. Call object.proxy.update() to update the proxy.`);
+        return proxy2;
+      if (p in extended)
+        return Reflect.get(extended, p);
+      if (!Reflect.get(target, "__proxy_updated"))
+        throw new Error(proxy2.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;
     }
   });
-  function update(object) {
-    if (!object) {
-      target = void 0;
-      return;
-    }
-    Reflect.set(object, "proxyUpdated", true);
-    target = object;
-  }
-  function original() {
-    return Reflect.get(target, "proxyUpdated") ? target : void 0;
-  }
-  return proxy2;
+  return proxyed;
 }
 
 // src/util/random.ts
@@ -3965,6 +3974,11 @@ function formatNumeric(value = "0", options) {
 function cover(value, mode, symbol = "*") {
   return value.slice(0, mode[0]) + symbol.repeat(mode[1]) + value.slice(-mode[2]);
 }
+function shortenId(value, startWith = 6, endWith = 4) {
+  if (!value)
+    return "";
+  return `${value.slice(0, startWith)}...${value.slice(-endWith)}`;
+}
 function slash(str) {
   return str.replace(/\\/g, "/");
 }
@@ -4145,6 +4159,7 @@ function unindent(str) {
   selectImages,
   sentenceCase,
   set,
+  shortenId,
   showOpenFilePicker,
   showOpenImagePicker,
   size,

package/dist/index.d.ts

@@ -334,6 +334,17 @@ declare function formatNumeric(value?: Numberish, options?: FormatNumericOptions
  * @param symbol
  */
 declare function cover(value: string, mode: [number, number, number], symbol?: string): string;
+/**
+ * Shortens an identifier string by showing only the beginning and end portions,
+ * with ellipsis in the middle. Suitable for various types of identifiers like
+ * IPFS CID, transaction hashes, EVM addresses, user IDs, etc.
+ *
+ * @param value - The identifier string to shorten
+ * @param startWith - Number of characters to show at the start (default: 6)
+ * @param endWith - Number of characters to show at the end (default: 6)
+ * @returns Shortened identifier string with ellipsis, or empty string if id is null/undefined
+ */
+declare function shortenId(value: string | null | undefined, startWith?: number, endWith?: number): string;
 /**
  * Replace backslash to slash
  *
@@ -626,12 +637,12 @@ declare namespace pipe {
     var promise: typeof pPipe;
 }
 
-type Proxyed<T extends object> = T & {
+type Proxyed<T extends object, E extends object = {}> = T & {
     proxy: {
         update: (object?: T) => void;
-        original: () => T | undefined;
+        source: T | undefined;
     };
-};
+} & E;
 /**
  * Creates a proxy object that updates the original object when the proxy is updated.
  * @param initObject - The initial object to proxy.
@@ -642,21 +653,23 @@ type Proxyed<T extends object> = T & {
  * const obj = proxy({ name: 'John' })
  * console.log(obj.name) // John
  *
- * proxy.update({ name: 'Jane' })
+ * 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.
  *
- * proxy.original(obj2) // undefined
+ * obj2.proxy.source // undefined
  * obj2.update({ name: 'John' })
  *
  * // get the original object
- * proxy.original(obj2) // { name: 'John' }
+ * obj2.proxy.source // { name: 'John' }
  * ```
  */
-declare function proxy<T extends object>(initObject?: T): Proxyed<T>;
+declare function proxy<T extends object, E extends object = {}>(initObject?: T, initExtend?: E, options?: {
+    strictMessage?: string;
+}): Proxyed<T, E>;
 
 /**
  * Get a random item from an array.
@@ -806,4 +819,4 @@ declare function unwrap<T extends object>(value: T | (() => T)): T;
 declare function whenever<T, C extends (value: Exclude<T, null | undefined>) => any>(value: T, callback: C): ReturnType<C> | undefined;
 declare function call<T extends Fn$1<any>>(fn: T, ...args: Parameters<T>): ReturnType<T>;
 
-export { type AnyFn, type ArgumentsType, type Arrayable, type Assign, type Awaitable, BIG_INTS, Bignumber, type BooleanLike, type BrowserNativeObject, type ConstructorType, DEFAULT_BIGNUM_CONFIG, type DecimalOptions, type DeepKeyof, type DeepMap, type DeepMerge, type DeepPartial, type DeepReadonly, type DeepReplace, type DeepRequired, Deferred, type Delimiter, type Dimension, type DynamicObject, type ElementOf, type Fn$1 as Fn, type FormatGroupOptions, type FormatNumericOptions, type IfAny, type IsAny, type Key, type Looper, type MergeInsertions, type NonUndefined, type Noop, type Nullable, type NumberObject, type Numberish, type Numeric, type NumericObject, type OmitBy, type OpenFilePickerOptions, type OpenImagePickerOptions, type Option, type Overwrite, type PickBy, type PromiseFn, type PromiseType, type Promisify, type Proxyed, type ReaderType, type StringObject, type SymbolObject, arange, average, bignumber, call, camelCase, capitalCase, compose, constantCase, cover, decimal, delay, dialsPhone, divide, dotCase, downloadBlobFile, downloadNetworkFile, downloadUrlFile, ensurePrefix, ensureSuffix, formatNumeric, formdataToObject, gt, gte, integer, isAndroid, isBrowser, isChrome, isEdge, isFF, isFormData, isIE, isIE11, isIE9, isIOS, isMobile, isPhantomJS, isTruthy, isWeex, isWindow, kebabCase, loop, lt, lte, multiply, noCase, nonnanable, noop, numberify, numberish, objectToFormdata, off, on, openFilePicker, openImagePicker, parseNumeric, pascalCase, pascalSnakeCase, pathCase, percentage, pipe, plus, proxy, randomItem, randomNumber, randomString, readFileReader, redirectTo, riposte, select, selectImages, sentenceCase, showOpenFilePicker, showOpenImagePicker, size, slash, snakeCase, stringify, template, to, toArray, trainCase, tryParseJson, unindent, unit, unwrap, whenever, zeroRemove, zerofill };
+export { type AnyFn, type ArgumentsType, type Arrayable, type Assign, type Awaitable, BIG_INTS, Bignumber, type BooleanLike, type BrowserNativeObject, type ConstructorType, DEFAULT_BIGNUM_CONFIG, type DecimalOptions, type DeepKeyof, type DeepMap, type DeepMerge, type DeepPartial, type DeepReadonly, type DeepReplace, type DeepRequired, Deferred, type Delimiter, type Dimension, type DynamicObject, type ElementOf, type Fn$1 as Fn, type FormatGroupOptions, type FormatNumericOptions, type IfAny, type IsAny, type Key, type Looper, type MergeInsertions, type NonUndefined, type Noop, type Nullable, type NumberObject, type Numberish, type Numeric, type NumericObject, type OmitBy, type OpenFilePickerOptions, type OpenImagePickerOptions, type Option, type Overwrite, type PickBy, type PromiseFn, type PromiseType, type Promisify, type Proxyed, type ReaderType, type StringObject, type SymbolObject, arange, average, bignumber, call, camelCase, capitalCase, compose, constantCase, cover, decimal, delay, dialsPhone, divide, dotCase, downloadBlobFile, downloadNetworkFile, downloadUrlFile, ensurePrefix, ensureSuffix, formatNumeric, formdataToObject, gt, gte, integer, isAndroid, isBrowser, isChrome, isEdge, isFF, isFormData, isIE, isIE11, isIE9, isIOS, isMobile, isPhantomJS, isTruthy, isWeex, isWindow, kebabCase, loop, lt, lte, multiply, noCase, nonnanable, noop, numberify, numberish, objectToFormdata, off, on, openFilePicker, openImagePicker, parseNumeric, pascalCase, pascalSnakeCase, pathCase, percentage, pipe, plus, proxy, randomItem, randomNumber, randomString, readFileReader, redirectTo, riposte, select, selectImages, sentenceCase, shortenId, showOpenFilePicker, showOpenImagePicker, size, slash, snakeCase, stringify, template, to, toArray, trainCase, tryParseJson, unindent, unit, unwrap, whenever, zeroRemove, zerofill };

package/dist/index.global.js

@@ -4858,34 +4858,42 @@
   pipe.promise = pPipe;
 
   // src/util/proxy.ts
-  function proxy(initObject) {
-    initObject && Reflect.set(initObject, "proxyUpdated", true);
-    let target = initObject || { proxyUpdated: false };
-    const proxy2 = new Proxy({}, {
+  function proxy(initObject, initExtend, options) {
+    initObject && Reflect.set(initObject, "__proxy_updated", true);
+    let target = initObject || { __proxy_updated: false };
+    const extended = initExtend || {};
+    const proxy2 = {
+      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;
+      },
+      strictMessage: options?.strictMessage || "Proxy not updated. Call object.proxy.update() to update the proxy."
+    };
+    const proxyed = new Proxy({}, {
       get: (_, p) => {
         if (p === "proxy")
-          return { update, original };
-        if (!Reflect.get(target, "proxyUpdated"))
-          throw new Error(`Proxy not updated. Call object.proxy.update() to update the proxy.`);
+          return proxy2;
+        if (p in extended)
+          return Reflect.get(extended, p);
+        if (!Reflect.get(target, "__proxy_updated"))
+          throw new Error(proxy2.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;
       }
     });
-    function update(object) {
-      if (!object) {
-        target = void 0;
-        return;
-      }
-      Reflect.set(object, "proxyUpdated", true);
-      target = object;
-    }
-    function original() {
-      return Reflect.get(target, "proxyUpdated") ? target : void 0;
-    }
-    return proxy2;
+    return proxyed;
   }
 
   // src/util/random.ts
@@ -5118,6 +5126,11 @@
   function cover(value, mode, symbol = "*") {
     return value.slice(0, mode[0]) + symbol.repeat(mode[1]) + value.slice(-mode[2]);
   }
+  function shortenId(value, startWith = 6, endWith = 4) {
+    if (!value)
+      return "";
+    return `${value.slice(0, startWith)}...${value.slice(-endWith)}`;
+  }
   function slash(str) {
     return str.replace(/\\/g, "/");
   }

package/dist/index.js

@@ -3515,34 +3515,42 @@ function pipe(...fns) {
 pipe.promise = pPipe;
 
 // src/util/proxy.ts
-function proxy(initObject) {
-  initObject && Reflect.set(initObject, "proxyUpdated", true);
-  let target = initObject || { proxyUpdated: false };
-  const proxy2 = new Proxy({}, {
+function proxy(initObject, initExtend, options) {
+  initObject && Reflect.set(initObject, "__proxy_updated", true);
+  let target = initObject || { __proxy_updated: false };
+  const extended = initExtend || {};
+  const proxy2 = {
+    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;
+    },
+    strictMessage: options?.strictMessage || "Proxy not updated. Call object.proxy.update() to update the proxy."
+  };
+  const proxyed = new Proxy({}, {
     get: (_, p) => {
       if (p === "proxy")
-        return { update, original };
-      if (!Reflect.get(target, "proxyUpdated"))
-        throw new Error(`Proxy not updated. Call object.proxy.update() to update the proxy.`);
+        return proxy2;
+      if (p in extended)
+        return Reflect.get(extended, p);
+      if (!Reflect.get(target, "__proxy_updated"))
+        throw new Error(proxy2.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;
     }
   });
-  function update(object) {
-    if (!object) {
-      target = void 0;
-      return;
-    }
-    Reflect.set(object, "proxyUpdated", true);
-    target = object;
-  }
-  function original() {
-    return Reflect.get(target, "proxyUpdated") ? target : void 0;
-  }
-  return proxy2;
+  return proxyed;
 }
 
 // src/util/random.ts
@@ -3775,6 +3783,11 @@ function formatNumeric(value = "0", options) {
 function cover(value, mode, symbol = "*") {
   return value.slice(0, mode[0]) + symbol.repeat(mode[1]) + value.slice(-mode[2]);
 }
+function shortenId(value, startWith = 6, endWith = 4) {
+  if (!value)
+    return "";
+  return `${value.slice(0, startWith)}...${value.slice(-endWith)}`;
+}
 function slash(str) {
   return str.replace(/\\/g, "/");
 }
@@ -3954,6 +3967,7 @@ export {
   selectImages,
   sentenceCase,
   set_default as set,
+  shortenId,
   showOpenFilePicker,
   showOpenImagePicker,
   size,

package/package.json

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