@aiszlab/relax 2.0.3 → 2.0.4

package/dist/decimal/index.d.ts

@@ -0,0 +1,4 @@
+/**
+ * @description divide
+ */
+export declare function divide(a: number, b: number): number;

package/dist/hooks/use-click-away.d.ts

@@ -1,8 +1,8 @@
-import { type MutableRefObject } from "react";
+import { type RefObject } from "react";
 import { type Containable } from "../dom";
 import type { Nullable, Arrayable } from "@aiszlab/relax/types";
 /**
  * @description
  * click away
  */
-export declare const useClickAway: (onClickAway: (event: MouseEvent) => void, target: Arrayable<MutableRefObject<Nullable<Containable>> | false>) => void;
+export declare const useClickAway: (onClickAway: (event: MouseEvent) => void, target: Arrayable<RefObject<Nullable<Containable>> | false>) => void;

package/dist/hooks/use-media-query.cjs

@@ -3,7 +3,7 @@
 var _slicedToArray = require('@babel/runtime/helpers/slicedToArray');
 var react = require('react');
 var toArray = require('../utils/to-array.cjs');
-var replace = require('../utils/replace.cjs');
+var replaceAt = require('../utils/replace/replace-at.cjs');
 
 var useMediaQuery = function useMediaQuery(query) {
   var _query = react.useMemo(function () {
@@ -21,7 +21,7 @@ var useMediaQuery = function useMediaQuery(query) {
     setValue = _useState2[1];
   var onMediaQueryChange = react.useCallback(function (event, index) {
     setValue(function (prev) {
-      return replace.replace(prev, event.matches, index);
+      return replaceAt.replaceAt(prev, index, event.matches);
     });
   }, []);
   react.useEffect(function () {

package/dist/hooks/use-media-query.mjs

@@ -1,7 +1,7 @@
 import _slicedToArray from '@babel/runtime/helpers/slicedToArray';
 import { useMemo, useState, useCallback, useEffect } from 'react';
 import { toArray } from '../utils/to-array.mjs';
-import { replace } from '../utils/replace.mjs';
+import { replaceAt } from '../utils/replace/replace-at.mjs';
 
 var useMediaQuery = function useMediaQuery(query) {
   var _query = useMemo(function () {
@@ -19,7 +19,7 @@ var useMediaQuery = function useMediaQuery(query) {
     setValue = _useState2[1];
   var onMediaQueryChange = useCallback(function (event, index) {
     setValue(function (prev) {
-      return replace(prev, event.matches, index);
+      return replaceAt(prev, index, event.matches);
     });
   }, []);
   useEffect(function () {

package/dist/index.cjs

@@ -71,7 +71,6 @@ var throttle = require('./utils/throttle.cjs');
 var clone = require('./utils/clone.cjs');
 var toggle = require('./utils/toggle.cjs');
 var taggedTemplateLiterals = require('./utils/tagged-template-literals.cjs');
-var replace = require('./utils/replace.cjs');
 var first = require('./utils/first.cjs');
 var last = require('./utils/last.cjs');
 var merge = require('./utils/merge.cjs');
@@ -79,6 +78,8 @@ var max = require('./utils/max.cjs');
 var min = require('./utils/min.cjs');
 var load = require('./utils/load.cjs');
 var at = require('./utils/at.cjs');
+var replace = require('./utils/replace/replace.cjs');
+var replaceAt = require('./utils/replace/replace-at.cjs');
 
 
 
@@ -153,7 +154,6 @@ exports.throttle = throttle.throttle;
 exports.clone = clone.clone;
 exports.toggle = toggle.toggle;
 exports.taggedTemplateLiterals = taggedTemplateLiterals.taggedTemplateLiterals;
-exports.replace = replace.replace;
 exports.first = first.first;
 exports.last = last.last;
 exports.merge = merge.merge;
@@ -161,3 +161,5 @@ exports.max = max.max;
 exports.min = min.min;
 exports.load = load.load;
 exports.at = at.at;
+exports.replace = replace.replace;
+exports.replaceAt = replaceAt.replaceAt;

package/dist/index.d.ts

@@ -81,7 +81,7 @@ export { throttle } from "./utils/throttle";
 export { clone } from "./utils/clone";
 export { toggle } from "./utils/toggle";
 export { taggedTemplateLiterals } from "./utils/tagged-template-literals";
-export { replace } from "./utils/replace";
+export { replace, replaceAt } from "./utils/replace";
 export { first } from "./utils/first";
 export { last } from "./utils/last";
 export { merge } from "./utils/merge";

package/dist/index.mjs

@@ -69,7 +69,6 @@ export { throttle } from './utils/throttle.mjs';
 export { clone } from './utils/clone.mjs';
 export { toggle } from './utils/toggle.mjs';
 export { taggedTemplateLiterals } from './utils/tagged-template-literals.mjs';
-export { replace } from './utils/replace.mjs';
 export { first } from './utils/first.mjs';
 export { last } from './utils/last.mjs';
 export { merge } from './utils/merge.mjs';
@@ -77,3 +76,5 @@ export { max } from './utils/max.mjs';
 export { min } from './utils/min.mjs';
 export { load } from './utils/load.mjs';
 export { at } from './utils/at.mjs';
+export { replace } from './utils/replace/replace.mjs';
+export { replaceAt } from './utils/replace/replace-at.mjs';

package/dist/is/is-deep-key.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Checks if a given key is a deep key.
+ *
+ * A deep key is a string that contains a dot (.) or square brackets with a property accessor.
+ *
+ * @param {PropertyKey} key - The key to check.
+ * @returns {boolean} - Returns true if the key is a deep key, otherwise false.
+ *
+ * Examples:
+ *
+ * isDeepKey('a.b') // true
+ * isDeepKey('a[b]') // true
+ * isDeepKey('a') // false
+ * isDeepKey(123) // false
+ * isDeepKey('a.b.c') // true
+ * isDeepKey('a[b][c]') // true
+ */
+export declare function isDeepKey(key: PropertyKey): boolean;

package/dist/is/is-key.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Checks if `value` is a property name and not a property path. (It's ok that the `value` is not in the keys of the `object`)
+ * @param {unknown} value The value to check.
+ * @param {unknown} object The object to query.
+ * @returns {boolean} Returns `true` if `value` is a property name, else `false`.
+ *
+ * @example
+ * isKey('a', { a: 1 });
+ * // => true
+ *
+ * isKey('a.b', { a: { b: 2 } });
+ * // => false
+ */
+export declare function isKey(value?: unknown, object?: unknown): value is PropertyKey;

package/dist/is/is-object.cjs

@@ -1,13 +1,34 @@
 'use strict';
 
 var _typeof = require('@babel/runtime/helpers/typeof');
+var isFunction = require('./is-function.cjs');
+var isNull = require('./is-null.cjs');
 
 /**
- * @description
- * is object
+ * Checks if the given value is an object. An object is a value that is
+ * not a primitive type (string, number, boolean, symbol, null, or undefined).
+ *
+ * This function tests whether the provided value is an object or not.
+ * It returns `true` if the value is an object, and `false` otherwise.
+ *
+ * This function can also serve as a type predicate in TypeScript, narrowing the type of the argument to an object value.
+ *
+ * @param {unknown} value - The value to check if it is an object.
+ * @returns {value is object} `true` if the value is an object, `false` otherwise.
+ *
+ * @example
+ * const value1 = {};
+ * const value2 = [1, 2, 3];
+ * const value3 = () => {};
+ * const value4 = null;
+ *
+ * console.log(isObject(value1)); // true
+ * console.log(isObject(value2)); // true
+ * console.log(isObject(value3)); // true
+ * console.log(isObject(value4)); // false
  */
-var isObject = function isObject(value) {
-  return !!value && _typeof(value) === "object";
-};
+function isObject(value) {
+  return !isNull.isNull(value) && (_typeof(value) === "object" || isFunction.isFunction(value));
+}
 
 exports.isObject = isObject;

package/dist/is/is-object.d.ts

@@ -1,6 +1,24 @@
 /**
- * @description
- * is object
+ * Checks if the given value is an object. An object is a value that is
+ * not a primitive type (string, number, boolean, symbol, null, or undefined).
+ *
+ * This function tests whether the provided value is an object or not.
+ * It returns `true` if the value is an object, and `false` otherwise.
+ *
+ * This function can also serve as a type predicate in TypeScript, narrowing the type of the argument to an object value.
+ *
+ * @param {unknown} value - The value to check if it is an object.
+ * @returns {value is object} `true` if the value is an object, `false` otherwise.
+ *
+ * @example
+ * const value1 = {};
+ * const value2 = [1, 2, 3];
+ * const value3 = () => {};
+ * const value4 = null;
+ *
+ * console.log(isObject(value1)); // true
+ * console.log(isObject(value2)); // true
+ * console.log(isObject(value3)); // true
+ * console.log(isObject(value4)); // false
  */
-declare const isObject: (value: unknown) => value is Object;
-export { isObject };
+export declare function isObject(value?: unknown): value is object;

package/dist/is/is-object.mjs

@@ -1,11 +1,32 @@
 import _typeof from '@babel/runtime/helpers/typeof';
+import { isFunction } from './is-function.mjs';
+import { isNull } from './is-null.mjs';
 
 /**
- * @description
- * is object
+ * Checks if the given value is an object. An object is a value that is
+ * not a primitive type (string, number, boolean, symbol, null, or undefined).
+ *
+ * This function tests whether the provided value is an object or not.
+ * It returns `true` if the value is an object, and `false` otherwise.
+ *
+ * This function can also serve as a type predicate in TypeScript, narrowing the type of the argument to an object value.
+ *
+ * @param {unknown} value - The value to check if it is an object.
+ * @returns {value is object} `true` if the value is an object, `false` otherwise.
+ *
+ * @example
+ * const value1 = {};
+ * const value2 = [1, 2, 3];
+ * const value3 = () => {};
+ * const value4 = null;
+ *
+ * console.log(isObject(value1)); // true
+ * console.log(isObject(value2)); // true
+ * console.log(isObject(value3)); // true
+ * console.log(isObject(value4)); // false
  */
-var isObject = function isObject(value) {
-  return !!value && _typeof(value) === "object";
-};
+function isObject(value) {
+  return !isNull(value) && (_typeof(value) === "object" || isFunction(value));
+}
 
 export { isObject };

package/dist/is/is-symbol.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Check whether a value is a symbol.
+ *
+ * This function can also serve as a type predicate in TypeScript, narrowing the type of the argument to `symbol`.
+ *
+ * @param {unknown} value The value to check.
+ * @returns {value is symbol} Returns `true` if `value` is a symbol, else `false`.
+ * @example
+ * isSymbol(Symbol.iterator);
+ * // => true
+ *
+ * isSymbol('abc');
+ * // => false
+ */
+export declare function isSymbol(value?: unknown): value is symbol;

package/dist/types/first.d.ts

@@ -1 +1 @@
-export type First<T, R = undefined> = T extends string ? string : T extends [infer D, ...Array<unknown>] ? D : T extends Array<infer S> ? S | undefined : R;
+export type First<T> = T extends null | undefined ? undefined : T extends string ? string : T extends [infer D, ...Array<any>] ? D : T extends Array<infer S> ? S | undefined : T;

package/dist/types/get.d.ts

@@ -0,0 +1,8 @@
+/**
+ * See the definition of `@types/lodash`.
+ */
+type GetIndexedField<T, K> = K extends keyof T ? T[K] : K extends `${number}` ? "length" extends keyof T ? number extends T["length"] ? number extends keyof T ? T[number] : undefined : undefined : undefined : undefined;
+type FieldWithPossiblyUndefined<T, Key> = Get<Exclude<T, undefined>, Key> | Extract<T, undefined>;
+type IndexedFieldWithPossiblyUndefined<T, Key> = GetIndexedField<Exclude<T, undefined>, Key> | Extract<T, undefined>;
+export type Get<T, P> = P extends `${infer Left}.${infer Right}` ? Left extends keyof Exclude<T, undefined> ? FieldWithPossiblyUndefined<Exclude<T, undefined>[Left], Right> | Extract<T, undefined> : Left extends `${infer FieldKey}[${infer IndexKey}]` ? FieldKey extends keyof T ? FieldWithPossiblyUndefined<IndexedFieldWithPossiblyUndefined<T[FieldKey], IndexKey>, Right> : undefined : undefined : P extends keyof T ? T[P] : P extends `${infer FieldKey}[${infer IndexKey}]` ? FieldKey extends keyof T ? IndexedFieldWithPossiblyUndefined<T[FieldKey], IndexKey> : undefined : IndexedFieldWithPossiblyUndefined<T, P>;
+export {};

package/dist/types/last.d.ts

@@ -1 +1 @@
-export type Last<T, R = undefined> = T extends [...Array<unknown>, infer D] ? D : T extends Array<infer S> ? S | undefined : R;
+export type Last<T> = T extends null | undefined ? undefined : T extends [...Array<unknown>, infer D] ? D : T extends Array<infer S> ? S | undefined : T;

package/dist/utils/at.cjs

@@ -2,15 +2,15 @@
 
 var isString = require('../is/is-string.cjs');
 
-function at(value, pos) {
+function at(value, index) {
   if (isString.isString(value)) {
-    return value.at(pos);
+    return value.at(index);
   }
-  // check can i use `at`
-  if (!!Array.prototype.at) {
-    return value.at(pos);
+  // @ts-expect-error Can i use `at`
+  if (Array.prototype.at) {
+    return value.at(index);
   }
-  return value[pos];
+  return value[index];
 }
 
 exports.at = at;

package/dist/utils/at.d.ts

@@ -2,6 +2,6 @@ import type { Partialable } from "../types";
 /**
  * @description for different browser or browser version, use good api to cover
  */
-declare function at(value: string, pos: number): string;
-declare function at<T>(value: Array<T>, pos: number): Partialable<T>;
+declare function at(value: string, index: number): string;
+declare function at<T>(value: Array<T>, index: number): Partialable<T>;
 export { at };

package/dist/utils/at.mjs

@@ -1,14 +1,14 @@
 import { isString } from '../is/is-string.mjs';
 
-function at(value, pos) {
+function at(value, index) {
   if (isString(value)) {
-    return value.at(pos);
+    return value.at(index);
   }
-  // check can i use `at`
-  if (!!Array.prototype.at) {
-    return value.at(pos);
+  // @ts-expect-error Can i use `at`
+  if (Array.prototype.at) {
+    return value.at(index);
   }
-  return value[pos];
+  return value[index];
 }
 
 export { at };

package/dist/utils/first.cjs

@@ -1,18 +1,14 @@
 'use strict';
 
-var toArray = require('./to-array.cjs');
 var at = require('./at.cjs');
-var isString = require('../is/is-string.cjs');
+var isVoid = require('../is/is-void.cjs');
 
-/**
- * @description
- * first element of array
- */
-var first = function first(value) {
-  if (isString.isString(value)) {
-    return value.at(0);
+function first(value) {
+  if (isVoid.isVoid(value)) {
+    return void 0;
   }
-  return at.at(toArray.toArray(value), 0);
-};
+  // @ts-expect-error `at` support types
+  return at.at(value, 0);
+}
 
 exports.first = first;

package/dist/utils/first.d.ts

@@ -1,6 +1,9 @@
 import { type First } from "@aiszlab/relax/types";
 /**
  * @description
- * first element of array
+ * first element
  */
-export declare const first: <T = unknown>(value: T) => First<T, T>;
+declare function first(value: undefined | null): undefined;
+declare function first(value: string): string;
+declare function first<T extends Array<unknown>>(value: T): First<T> | undefined;
+export { first };

package/dist/utils/first.mjs

@@ -1,16 +1,12 @@
-import { toArray } from './to-array.mjs';
 import { at } from './at.mjs';
-import { isString } from '../is/is-string.mjs';
+import { isVoid } from '../is/is-void.mjs';
 
-/**
- * @description
- * first element of array
- */
-var first = function first(value) {
-  if (isString(value)) {
-    return value.at(0);
+function first(value) {
+  if (isVoid(value)) {
+    return void 0;
   }
-  return at(toArray(value), 0);
-};
+  // @ts-expect-error `at` support types
+  return at(value, 0);
+}
 
 export { first };

package/dist/utils/get.d.ts

@@ -0,0 +1,244 @@
+import type { Get } from "../types/get";
+/**
+ * Retrieves the value at a given path from an object. If the resolved value is undefined, the defaultValue is returned instead.
+ *
+ * @template T - The type of the object.
+ * @template K - The type of the key in the object.
+ * @template D - The type of the default value.
+ *
+ * @param {T} object - The object to query.
+ * @param {K | [K]} path - The path of the property to get.
+ * @returns {T[K]} - Returns the resolved value.
+ */
+export declare function get<T extends object, K extends keyof T>(object: T, path: K | readonly [K]): T[K];
+/**
+ * Retrieves the value at a given path from an object. If the resolved value is undefined, the defaultValue is returned instead.
+ *
+ * @template T - The type of the object.
+ * @template K - The type of the key in the object.
+ *
+ * @param {T | null | undefined} object - The object to query.
+ * @param {K | [K]} path - The path of the property to get.
+ * @returns {T[K] | undefined} - Returns the resolved value.
+ */
+export declare function get<T extends object, K extends keyof T>(object: T | null | undefined, path: K | readonly [K]): T[K] | undefined;
+/**
+ * Retrieves the value at a given path from an object. If the resolved value is undefined, the defaultValue is returned instead.
+ *
+ * @template T - The type of the object.
+ * @template K - The type of the key in the object.
+ * @template D - The type of the default value.
+ *
+ * @param {T | null | undefined} object - The object to query.
+ * @param {K | [K]} path - The path of the property to get.
+ * @param {D} defaultValue - The value returned if the resolved value is undefined.
+ * @returns {Exclude<T[K], undefined> | D} - Returns the resolved value.
+ */
+export declare function get<T extends object, K extends keyof T, D>(object: T | null | undefined, path: K | readonly [K], defaultValue: D): Exclude<T[K], undefined> | D;
+/**
+ * Retrieves the value at a given path from an object. If the resolved value is undefined, the defaultValue is returned instead.
+ *
+ * @template T - The type of the object.
+ * @template K1 - The type of the first key in the object.
+ * @template K2 - The type of the second key in the object.
+ *
+ * @param {T} object - The object to query.
+ * @param {[K1, K2]} path - The path of the property to get.
+ * @returns {T[K1][K2]} - Returns the resolved value.
+ */
+export declare function get<T extends object, K1 extends keyof T, K2 extends keyof T[K1]>(object: T, path: readonly [K1, K2]): T[K1][K2];
+/**
+ * Retrieves the value at a given path from an object. If the resolved value is undefined, the defaultValue is returned instead.
+ *
+ * @template T - The type of the object.
+ * @template K1 - The type of the first key in the object.
+ * @template K2 - The type of the second key in the object.
+ *
+ * @param {T | null | undefined} object - The object to query.
+ * @param {[K1, K2]} path - The path of the property to get.
+ * @returns {T[K1][K2] | undefined} - Returns the resolved value.
+ */
+export declare function get<T extends object, K1 extends keyof T, K2 extends keyof T[K1]>(object: T | null | undefined, path: readonly [K1, K2]): T[K1][K2] | undefined;
+/**
+ * Retrieves the value at a given path from an object. If the resolved value is undefined, the defaultValue is returned instead.
+ *
+ * @template T - The type of the object.
+ * @template K1 - The type of the first key in the object.
+ * @template K2 - The type of the second key in the object.
+ * @template D - The type of the default value.
+ *
+ * @param {T | null | undefined} object - The object to query.
+ * @param {[K1, K2]} path - The path of the property to get.
+ * @param {D} defaultValue - The value returned if the resolved value is undefined.
+ * @returns {Exclude<T[K1][K2], undefined> | D} - Returns the resolved value.
+ */
+export declare function get<T extends object, K1 extends keyof T, K2 extends keyof T[K1], D>(object: T | null | undefined, path: readonly [K1, K2], defaultValue: D): Exclude<T[K1][K2], undefined> | D;
+/**
+ * Retrieves the value at a given path from an object. If the resolved value is undefined, the defaultValue is returned instead.
+ *
+ * @template T - The type of the object.
+ * @template K1 - The type of the first key in the object.
+ * @template K2 - The type of the second key in the object.
+ * @template K3 - The type of the third key in the object.
+ *
+ * @param {T} object - The object to query.
+ * @param {[K1, K2, K3]} path - The path of the property to get.
+ * @returns {T[K1][K2][K3]} - Returns the resolved value.
+ */
+export declare function get<T extends object, K1 extends keyof T, K2 extends keyof T[K1], K3 extends keyof T[K1][K2]>(object: T, path: readonly [K1, K2, K3]): T[K1][K2][K3];
+/**
+ * Retrieves the value at a given path from an object. If the resolved value is undefined, the defaultValue is returned instead.
+ *
+ * @template T - The type of the object.
+ * @template K1 - The type of the first key in the object.
+ * @template K2 - The type of the second key in the object.
+ * @template K3 - The type of the third key in the object.
+ *
+ * @param {T | null | undefined} object - The object to query.
+ * @param {[K1, K2, K3]} path - The path of the property to get.
+ * @returns {T[K1][K2][K3] | undefined} - Returns the resolved value.
+ */
+export declare function get<T extends object, K1 extends keyof T, K2 extends keyof T[K1], K3 extends keyof T[K1][K2]>(object: T | null | undefined, path: readonly [K1, K2, K3]): T[K1][K2][K3] | undefined;
+/**
+ * Retrieves the value at a given path from an object. If the resolved value is undefined, the defaultValue is returned instead.
+ *
+ * @template T - The type of the object.
+ * @template K1 - The type of the first key in the object.
+ * @template K2 - The type of the second key in the object.
+ * @template K3 - The type of the third key in the object.
+ * @template D - The type of the default value.
+ *
+ * @param {T | null | undefined} object - The object to query.
+ * @param {[K1, K2, K3]} path - The path of the property to get.
+ * @param {D} defaultValue - The value returned if the resolved value is undefined.
+ * @returns {Exclude<T[K1][K2][K3], undefined> | D} - Returns the resolved value.
+ */
+export declare function get<T extends object, K1 extends keyof T, K2 extends keyof T[K1], K3 extends keyof T[K1][K2], D>(object: T | null | undefined, path: readonly [K1, K2, K3], defaultValue: D): Exclude<T[K1][K2][K3], undefined> | D;
+/**
+ * Retrieves the value at a given path from an object. If the resolved value is undefined, the defaultValue is returned instead.
+ *
+ * @template T - The type of the object.
+ * @template K1 - The type of the first key in the object.
+ * @template K2 - The type of the second key in the object.
+ * @template K3 - The type of the third key in the object.
+ * @template K4 - The type of the fourth key in the object.
+ *
+ * @param {T} object - The object to query.
+ * @param {[K1, K2, K3, K4]} path - The path of the property to get.
+ * @returns {T[K1][K2][K3][K4]} - Returns the resolved value.
+ */
+export declare function get<T extends object, K1 extends keyof T, K2 extends keyof T[K1], K3 extends keyof T[K1][K2], K4 extends keyof T[K1][K2][K3]>(object: T, path: readonly [K1, K2, K3, K4]): T[K1][K2][K3][K4];
+/**
+ * Retrieves the value at a given path from an object. If the resolved value is undefined, the defaultValue is returned instead.
+ *
+ * @template T - The type of the object.
+ * @template K1 - The type of the first key in the object.
+ * @template K2 - The type of the second key in the object.
+ * @template K3 - The type of the third key in the object.
+ * @template K4 - The type of the fourth key in the object.
+ *
+ * @param {T | null | undefined} object - The object to query.
+ * @param {[K1, K2, K3, K4]} path - The path of the property to get.
+ * @returns {T[K1][K2][K3][K4] | undefined} - Returns the resolved value.
+ */
+export declare function get<T extends object, K1 extends keyof T, K2 extends keyof T[K1], K3 extends keyof T[K1][K2], K4 extends keyof T[K1][K2][K3]>(object: T | null | undefined, path: readonly [K1, K2, K3, K4]): T[K1][K2][K3][K4] | undefined;
+/**
+ * Retrieves the value at a given path from an object. If the resolved value is undefined, the defaultValue is returned instead.
+ *
+ * @template T - The type of the object.
+ * @template K1 - The type of the first key in the object.
+ * @template K2 - The type of the second key in the object.
+ * @template K3 - The type of the third key in the object.
+ * @template K4 - The type of the fourth key in the object.
+ * @template D - The type of the default value.
+ *
+ * @param {T | null | undefined} object - The object to query.
+ * @param {[K1, K2, K3, K4]} path - The path of the property to get.
+ * @param {D} defaultValue - The value returned if the resolved value is undefined.
+ * @returns {Exclude<T[K1][K2][K3][K4], undefined> | D} - Returns the resolved value.
+ */
+export declare function get<T extends object, K1 extends keyof T, K2 extends keyof T[K1], K3 extends keyof T[K1][K2], K4 extends keyof T[K1][K2][K3], D>(object: T | null | undefined, path: readonly [K1, K2, K3, K4], defaultValue: D): Exclude<T[K1][K2][K3][K4], undefined> | D;
+/**
+ * Retrieves the value at a given path from an object with numeric keys. If the resolved value is undefined, the defaultValue is returned instead.
+ *
+ * @template T - The type of the value.
+ *
+ * @param {Record<number, T>} object - The object to query.
+ * @param {number} path - The path of the property to get.
+ * @returns {T} - Returns the resolved value.
+ */
+export declare function get<T>(object: Record<number, T>, path: number): T;
+/**
+ * Retrieves the value at a given path from an object with numeric keys. If the resolved value is undefined, the defaultValue is returned instead.
+ *
+ * @template T - The type of the value.
+ *
+ * @param {Record<number, T> | null | undefined} object - The object to query.
+ * @param {number} path - The path of the property to get.
+ * @returns {T | undefined} - Returns the resolved value.
+ */
+export declare function get<T>(object: Record<number, T> | null | undefined, path: number): T | undefined;
+/**
+ * Retrieves the value at a given path from an object with numeric keys. If the resolved value is undefined, the defaultValue is returned instead.
+ *
+ * @template T - The type of the value.
+ * @template D - The type of the default value.
+ *
+ * @param {Record<number, T> | null | undefined} object - The object to query.
+ * @param {number} path - The path of the property to get.
+ * @param {D} defaultValue - The value returned if the resolved value is undefined.
+ * @returns {T | D} - Returns the resolved value.
+ */
+export declare function get<T, D>(object: Record<number, T> | null | undefined, path: number, defaultValue: D): T | D;
+/**
+ * Retrieves the value at a given path from a null or undefined object, returning the default value.
+ *
+ * @template D - The type of the default value.
+ *
+ * @param {null | undefined} object - The object to query.
+ * @param {PropertyKey} path - The path of the property to get.
+ * @param {D} defaultValue - The value returned if the resolved value is undefined.
+ * @returns {D} - Returns the default value.
+ */
+export declare function get<D>(object: null | undefined, path: PropertyKey, defaultValue: D): D;
+/**
+ * Retrieves the value at a given path from a null or undefined object, returning undefined.
+ *
+ * @param {null | undefined} object - The object to query.
+ * @param {PropertyKey} path - The path of the property to get.
+ * @returns {undefined} - Returns undefined.
+ */
+export declare function get(object: null | undefined, path: PropertyKey): undefined;
+/**
+ * Retrieves the value at a given path from a string-keyed object. If the resolved value is undefined, the defaultValue is returned instead.
+ *
+ * @template T - The type of the object.
+ * @template P - The type of the path.
+ *
+ * @param {T} data - The object to query.
+ * @param {P} path - The path of the property to get.
+ * @returns {string extends P ? any : Get<T, P>} - Returns the resolved value.
+ */
+export declare function get<T, P extends string>(data: T, path: P): string extends P ? any : Get<T, P>;
+/**
+ * Retrieves the value at a given path from a string-keyed object. If the resolved value is undefined, the defaultValue is returned instead.
+ *
+ * @template T - The type of the object.
+ * @template P - The type of the path.
+ * @template D - The type of the default value.
+ *
+ * @param {T} data - The object to query.
+ * @param {P} path - The path of the property to get.
+ * @param {D} defaultValue - The value returned if the resolved value is undefined.
+ * @returns {Exclude<Get<T, P>, null | undefined> | D} - Returns the resolved value.
+ */
+export declare function get<T, P extends string, D = Get<T, P>>(data: T, path: P, defaultValue: D): Exclude<Get<T, P>, null | undefined> | D;
+/**
+ * Retrieves the value at a given path from an object. If the resolved value is undefined, the defaultValue is returned instead.
+ *
+ * @param {unknown} object - The object to query.
+ * @param {PropertyKey | readonly PropertyKey[]} path - The path of the property to get.
+ * @param {unknown} [defaultValue] - The value returned if the resolved value is undefined.
+ * @returns {any} - Returns the resolved value.
+ */
+export declare function get(object: unknown, path: PropertyKey | readonly PropertyKey[], defaultValue?: unknown): any;

package/dist/utils/is-index.d.ts

@@ -0,0 +1 @@
+export declare function isIndex(value: PropertyKey, length?: number): boolean;

package/dist/utils/last.cjs

@@ -1,18 +1,14 @@
 'use strict';
 
-var toArray = require('./to-array.cjs');
-var isString = require('../is/is-string.cjs');
 var at = require('./at.cjs');
+var isVoid = require('../is/is-void.cjs');
 
-/**
- * @description
- * last element of array
- */
-var last = function last(value) {
-  if (isString.isString(value)) {
-    return value.at(-1);
+function last(value) {
+  if (isVoid.isVoid(value)) {
+    return void 0;
   }
-  return at.at(toArray.toArray(value), -1);
-};
+  // @ts-expect-error `at` support types
+  return at.at(value, -1);
+}
 
 exports.last = last;

package/dist/utils/last.d.ts

@@ -1,6 +1,9 @@
 import { type Last } from "@aiszlab/relax/types";
 /**
  * @description
- * last element of array
+ * last element
  */
-export declare const last: <T = unknown>(value: T) => Last<T, T>;
+declare function last(value: undefined | null): undefined;
+declare function last(value: string): string;
+declare function last<T extends Array<unknown>>(value: T): Last<T> | undefined;
+export { last };

package/dist/utils/last.mjs

@@ -1,16 +1,12 @@
-import { toArray } from './to-array.mjs';
-import { isString } from '../is/is-string.mjs';
 import { at } from './at.mjs';
+import { isVoid } from '../is/is-void.mjs';
 
-/**
- * @description
- * last element of array
- */
-var last = function last(value) {
-  if (isString(value)) {
-    return value.at(-1);
+function last(value) {
+  if (isVoid(value)) {
+    return void 0;
   }
-  return at(toArray(value), -1);
-};
+  // @ts-expect-error `at` support types
+  return at(value, -1);
+}
 
 export { last };

package/dist/utils/merge.d.ts

@@ -3,5 +3,5 @@
  * deep merge api
  * use unique values to avoid duplicate
  */
-declare const merge: <T>(values_0: T, ...values: unknown[]) => T;
+declare const merge: <T>(...values: [T, ...unknown[]]) => T;
 export { merge };

package/dist/utils/replace/index.d.ts

@@ -0,0 +1,3 @@
+import { replace } from "./replace";
+import { replaceAt } from "./replace-at";
+export { replace, replaceAt };

package/dist/utils/replace/replace-at.cjs

@@ -0,0 +1,12 @@
+'use strict';
+
+/**
+ * replace at
+ */
+function replaceAt(value, index, replaceValue) {
+  var _newValue = Array.from(value);
+  _newValue[index] = replaceValue;
+  return _newValue;
+}
+
+exports.replaceAt = replaceAt;

package/dist/utils/replace/replace-at.d.ts

@@ -0,0 +1,5 @@
+/**
+ * replace at
+ */
+declare function replaceAt<T>(value: Array<T>, index: number, replaceValue: T): T[];
+export { replaceAt };

package/dist/utils/replace/replace-at.mjs

@@ -0,0 +1,10 @@
+/**
+ * replace at
+ */
+function replaceAt(value, index, replaceValue) {
+  var _newValue = Array.from(value);
+  _newValue[index] = replaceValue;
+  return _newValue;
+}
+
+export { replaceAt };

package/dist/utils/replace/replace.cjs

@@ -0,0 +1,19 @@
+'use strict';
+
+var isString = require('../../is/is-string.cjs');
+
+function replace(value) {
+  for (var _len = arguments.length, args = new Array(_len > 1 ? _len - 1 : 0), _key = 1; _key < _len; _key++) {
+    args[_key - 1] = arguments[_key];
+  }
+  if (isString.isString(value)) {
+    return value.replace.apply(value, args);
+  }
+  var searchValue = args[0],
+    incoming = args[1];
+  return value.map(function (_v) {
+    return _v === searchValue ? incoming : _v;
+  });
+}
+
+exports.replace = replace;

package/dist/utils/{replace.d.ts → replace/replace.d.ts}

@@ -1,5 +1,5 @@
-type StringReplacing = [searchValue: string, incoming: string];
-type ArrayReplacing<T> = [incoming: Array<T> | T, start: number, end?: number];
+type StringReplacing = [searchValue: string, replaceValue: string];
+type ArrayReplacing<T> = [searchValue: T, replaceValue: T];
 /**
  * @description
  * string replace.

package/dist/utils/replace/replace.mjs

@@ -0,0 +1,17 @@
+import { isString } from '../../is/is-string.mjs';
+
+function replace(value) {
+  for (var _len = arguments.length, args = new Array(_len > 1 ? _len - 1 : 0), _key = 1; _key < _len; _key++) {
+    args[_key - 1] = arguments[_key];
+  }
+  if (isString(value)) {
+    return value.replace.apply(value, args);
+  }
+  var searchValue = args[0],
+    incoming = args[1];
+  return value.map(function (_v) {
+    return _v === searchValue ? incoming : _v;
+  });
+}
+
+export { replace };

package/dist/utils/set.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Sets the value at the specified path of the given object. If any part of the path does not exist, it will be created.
+ *
+ * @template T - The type of the object.
+ * @param {T} obj - The object to modify.
+ * @param {PropertyKey | PropertyKey[]} path - The path of the property to set.
+ * @param {unknown} value - The value to set.
+ * @returns {T} - The modified object.
+ *
+ * @example
+ * // Set a value in a nested object
+ * const obj = { a: { b: { c: 3 } } };
+ * set(obj, 'a.b.c', 4);
+ * console.log(obj.a.b.c); // 4
+ *
+ * @example
+ * // Set a value in an array
+ * const arr = [1, 2, 3];
+ * set(arr, 1, 4);
+ * console.log(arr[1]); // 4
+ *
+ * @example
+ * // Create non-existent path and set value
+ * const obj = {};
+ * set(obj, 'a.b.c', 4);
+ * console.log(obj); // { a: { b: { c: 4 } } }
+ */
+export declare function set<T extends object>(obj: T, path: PropertyKey | readonly PropertyKey[], value: unknown): T;

package/dist/utils/to-array.cjs

@@ -1,18 +1,19 @@
 'use strict';
 
-var isString = require('../is/is-string.cjs');
-var isUndefined = require('../is/is-undefined.cjs');
+var isArray = require('../is/is-array.cjs');
+var isVoid = require('../is/is-void.cjs');
 
-function toArray(value, splitter) {
-  // string branch
-  if (isString.isString(value)) {
-    if (isUndefined.isUndefined(splitter)) {
-      return [value];
-    }
-    return value.split(splitter);
+/**
+ * @description
+ * convert any type data to a array
+ */
+function toArray(value) {
+  // in `void` case, just return empty array
+  if (isVoid.isVoid(value)) {
+    return [];
   }
-  // array branch
-  if (Array.isArray(value)) {
+  // already is `Array`
+  if (isArray.isArray(value)) {
     return value;
   }
   return [value];

package/dist/utils/to-array.d.ts

@@ -1,8 +1,7 @@
-type Splitter = string | RegExp;
+type ToArrayReturn<T> = T extends null ? unknown[] : T extends undefined ? unknown : T extends Array<infer E> ? E[] : T[];
 /**
  * @description
  * convert any type data to a array
  */
-declare function toArray(value: string, splitter?: Splitter): string[];
-declare function toArray<T = unknown>(value: T): T extends Array<unknown> ? T : T[];
+declare function toArray<T extends unknown = unknown>(value: T): ToArrayReturn<T>;
 export { toArray };

package/dist/utils/to-array.mjs

@@ -1,16 +1,17 @@
-import { isString } from '../is/is-string.mjs';
-import { isUndefined } from '../is/is-undefined.mjs';
+import { isArray } from '../is/is-array.mjs';
+import { isVoid } from '../is/is-void.mjs';
 
-function toArray(value, splitter) {
-  // string branch
-  if (isString(value)) {
-    if (isUndefined(splitter)) {
-      return [value];
-    }
-    return value.split(splitter);
+/**
+ * @description
+ * convert any type data to a array
+ */
+function toArray(value) {
+  // in `void` case, just return empty array
+  if (isVoid(value)) {
+    return [];
   }
-  // array branch
-  if (Array.isArray(value)) {
+  // already is `Array`
+  if (isArray(value)) {
     return value;
   }
   return [value];

package/dist/utils/to-key.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Converts `value` to a string key if it's not a string or symbol.
+ *
+ * @private
+ * @param {unknown} value The value to inspect.
+ * @returns {string|symbol} Returns the key.
+ */
+export declare function toKey(value: unknown): string | symbol;

package/dist/utils/to-paths.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Converts a deep key string into an array of path segments.
+ *
+ * This function takes a string representing a deep key (e.g., 'a.b.c' or 'a[b][c]') and breaks it down into an array of strings, each representing a segment of the path.
+ *
+ * @param {string} deepKey - The deep key string to convert.
+ * @returns {string[]} An array of strings, each representing a segment of the path.
+ *
+ * Examples:
+ *
+ * toPath('a.b.c') // Returns ['a', 'b', 'c']
+ * toPath('a[b][c]') // Returns ['a', 'b', 'c']
+ * toPath('.a.b.c') // Returns ['', 'a', 'b', 'c']
+ * toPath('a["b.c"].d') // Returns ['a', 'b.c', 'd']
+ * toPath('') // Returns []
+ * toPath('.a[b].c.d[e]["f.g"].h') // Returns ['', 'a', 'b', 'c', 'd', 'e', 'f.g', 'h']
+ */
+export declare function toPaths(deepKey: string): string[];

package/dist/utils/update.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Updates the value at the specified path of the given object using an updater function.
+ * If any part of the path does not exist, it will be created.
+ *
+ * @template T - The type of the object.
+ * @param {T} target - The object to modify.
+ * @param {PropertyKey | PropertyKey[]} path - The path of the property to update.
+ * @param {(value: unknown) => unknown} updater - The function to produce the updated value.
+ * @returns {T} - The modified object.
+ */
+export declare function update<T extends object | null | undefined>(target: T, path: PropertyKey | readonly PropertyKey[], updater: (value: unknown) => unknown): T;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aiszlab/relax",
-  "version": "2.0.3",
+  "version": "2.0.4",
   "description": "react utils collection",
   "exports": {
     ".": {
@@ -20,35 +20,35 @@
     "./types": "./dist/types/index.d.ts"
   },
   "dependencies": {
-    "@babel/runtime": "^7.26.9",
-    "react-is": "^19.0.0",
-    "rxjs": "^7.8.1"
+    "@babel/runtime": "^7.27.0",
+    "react-is": "^19.1.0",
+    "rxjs": "^7.8.2"
   },
   "devDependencies": {
-    "@babel/core": "^7.26.9",
-    "@babel/plugin-transform-runtime": "^7.26.9",
+    "@babel/core": "^7.26.10",
+    "@babel/plugin-transform-runtime": "^7.26.10",
     "@babel/preset-env": "^7.26.9",
     "@babel/preset-react": "^7.26.3",
-    "@babel/preset-typescript": "^7.26.0",
+    "@babel/preset-typescript": "^7.27.0",
     "@jest/globals": "^29.7.0",
     "@rollup/plugin-babel": "^6.0.4",
-    "@rollup/plugin-node-resolve": "^16.0.0",
+    "@rollup/plugin-node-resolve": "^16.0.1",
     "@rollup/plugin-typescript": "^12.1.2",
-    "@testing-library/react": "^16.2.0",
+    "@testing-library/react": "^16.3.0",
     "@types/babel__core": "^7.20.5",
-    "@types/react": "^19.0.10",
-    "@types/react-dom": "^19.0.4",
+    "@types/react": "^19.1.2",
+    "@types/react-dom": "^19.1.2",
     "@types/react-is": "^19.0.0",
     "jest": "^29.7.0",
     "jest-environment-jsdom": "^29.7.0",
-    "react": "^19.0.0",
-    "react-dom": "^19.0.0",
-    "rollup": "^4.34.8",
-    "typescript": "5.7.3"
+    "react": "^19.1.0",
+    "react-dom": "^19.1.0",
+    "rollup": "^4.40.0",
+    "typescript": "5.8.3"
   },
   "peerDependencies": {
-    "react": "18",
-    "react-dom": "18"
+    "react": ">=18",
+    "react-dom": ">=18"
   },
   "files": [
     "dist/"

package/dist/utils/replace.cjs

@@ -1,23 +0,0 @@
-'use strict';
-
-var _toConsumableArray = require('@babel/runtime/helpers/toConsumableArray');
-var isString = require('../is/is-string.cjs');
-var toArray = require('./to-array.cjs');
-
-function replace(value) {
-  for (var _len = arguments.length, args = new Array(_len > 1 ? _len - 1 : 0), _key = 1; _key < _len; _key++) {
-    args[_key - 1] = arguments[_key];
-  }
-  if (isString.isString(value)) {
-    return value.replace.apply(value, args);
-  }
-  var incoming = args[0],
-    start = args[1],
-    end = args[2];
-  var _incomings = toArray.toArray(incoming);
-  var leading = value.slice(0, start);
-  var trailing = value.slice(end !== null && end !== void 0 ? end : start + _incomings.length);
-  return [].concat(_toConsumableArray(leading), _toConsumableArray(_incomings), _toConsumableArray(trailing));
-}
-
-exports.replace = replace;

package/dist/utils/replace.mjs

@@ -1,21 +0,0 @@
-import _toConsumableArray from '@babel/runtime/helpers/toConsumableArray';
-import { isString } from '../is/is-string.mjs';
-import { toArray } from './to-array.mjs';
-
-function replace(value) {
-  for (var _len = arguments.length, args = new Array(_len > 1 ? _len - 1 : 0), _key = 1; _key < _len; _key++) {
-    args[_key - 1] = arguments[_key];
-  }
-  if (isString(value)) {
-    return value.replace.apply(value, args);
-  }
-  var incoming = args[0],
-    start = args[1],
-    end = args[2];
-  var _incomings = toArray(incoming);
-  var leading = value.slice(0, start);
-  var trailing = value.slice(end !== null && end !== void 0 ? end : start + _incomings.length);
-  return [].concat(_toConsumableArray(leading), _toConsumableArray(_incomings), _toConsumableArray(trailing));
-}
-
-export { replace };