rattail 1.0.21 → 1.0.23

package/lib/index.cjs

@@ -158,6 +158,7 @@ __export(src_exports, {
   round: () => round,
   sample: () => sample,
   sessionStorage: () => sessionStorage,
+  set: () => set,
   shuffle: () => shuffle,
   slash: () => slash,
   sum: () => sum,
@@ -776,6 +777,27 @@ function promiseWithResolvers() {
   return { promise, resolve, reject };
 }
 
+// src/object/set.ts
+function set(object, path, value) {
+  if (!isObject(object)) {
+    return;
+  }
+  const keys = [...path];
+  if (keys.length === 0) {
+    return;
+  }
+  let target = object;
+  while (keys.length > 1) {
+    const key3 = keys.shift();
+    const nextKey = keys[0];
+    if (!isObject(target[key3])) {
+      target[key3] = isNumber(nextKey) ? [] : {};
+    }
+    target = target[key3];
+  }
+  target[keys[0]] = value;
+}
+
 // src/util/index.ts
 var util_exports = {};
 __export(util_exports, {
@@ -1666,6 +1688,7 @@ function ceil(val, precision = 0) {
   round,
   sample,
   sessionStorage,
+  set,
   shuffle,
   slash,
   sum,

package/lib/index.d.cts

@@ -58,6 +58,8 @@ type PromiseWithResolvers<T> = {
 };
 declare function promiseWithResolvers<T>(): PromiseWithResolvers<T>;
 
+declare function set<T extends object | any[]>(object: T, path: (string | number)[], value: any): void;
+
 declare function cancelAnimationFrame(handle: number): void;
 
 type ClassName = string | undefined | null;
@@ -130,20 +132,20 @@ interface Motion {
 }
 declare function motion(options: MotionOptions): Motion;
 
-declare function duration(): {
-    value: number;
-    years: (value: number) => any;
-    months: (value: number) => any;
-    weeks: (value: number) => any;
-    days: (value: number) => any;
-    hours: (value: number) => any;
-    minutes: (value: number) => any;
-    seconds: (value: number) => any;
-    milliseconds: (value: number) => any;
-    valueOf: (options?: {
+interface DurationContext {
+    years(value: number): this;
+    months(value: number): this;
+    weeks(value: number): this;
+    days(value: number): this;
+    hours(value: number): this;
+    minutes(value: number): this;
+    seconds(value: number): this;
+    milliseconds(value: number): this;
+    valueOf(options?: {
         milliseconds: boolean;
-    }) => number;
-};
+    }): number;
+}
+declare function duration(): DurationContext;
 
 declare function call<P extends any[], R>(fn?: ((...arg: P) => R) | ((...arg: P) => R)[] | null, ...args: P): R | R[] | undefined;
 
@@ -310,4 +312,4 @@ declare function floor(val: number, precision?: number): number;
 
 declare function ceil(val: number, precision?: number): number;
 
-export { type BEM, type ClassName, type Classes, type Motion, type MotionOptions, type MotionState, NOOP, type PromiseWithResolvers, type Storage, assert, at, baseRound, call, camelize, cancelAnimationFrame, ceil, chunk, clamp, clampArrayRange, classes, cloneDeep, cloneDeepWith, copyText, createNamespaceFn, createStorage, debounce, delay, difference, differenceWith, doubleRaf, download, duration, ensurePrefix, ensureSuffix, find, floor, genNumberKey, genStringKey, getAllParentScroller, getGlobalThis, getParentScroller, getRect, getScrollLeft, getScrollTop, getStyle, groupBy, hasOwn, inBrowser, inMobile, inViewport, intersection, intersectionWith, isArray, isArrayBuffer, isBlob, isBoolean, isDOMException, isDataView, isDate, isEmpty, isEmptyPlainObject, isEqual, isEqualWith, isError, isFile, isFunction, isMap, isNonEmptyArray, isNullish, isNumber, isNumeric, isObject, isPlainObject, isPrimitive, isPromise, isRegExp, isSet, isString, isSymbol, isTruthy, isTypedArray, isWeakMap, isWeakSet, isWindow, kebabCase, localStorage, lowerFirst, mapObject, maxBy, mean, meanBy, merge, mergeWith, minBy, motion, normalizeToArray, objectToString, omit, omitBy, once, pascalCase, pick, pickBy, prettyJSONObject, preventDefault, promiseWithResolvers, raf, randomColor, randomNumber, randomString, removeArrayBlank, removeArrayEmpty, removeItem, requestAnimationFrame, round, sample, sessionStorage, shuffle, slash, sum, sumBy, sumHash, supportTouch, throttle, times, toArrayBuffer, toDataURL, toNumber, toRawType, toText, toTypeString, toggleItem, tryParseJSON, uniq, uniqBy, upperFirst, xor, xorWith };
+export { type BEM, type ClassName, type Classes, type DurationContext, type Motion, type MotionOptions, type MotionState, NOOP, type PromiseWithResolvers, type Storage, assert, at, baseRound, call, camelize, cancelAnimationFrame, ceil, chunk, clamp, clampArrayRange, classes, cloneDeep, cloneDeepWith, copyText, createNamespaceFn, createStorage, debounce, delay, difference, differenceWith, doubleRaf, download, duration, ensurePrefix, ensureSuffix, find, floor, genNumberKey, genStringKey, getAllParentScroller, getGlobalThis, getParentScroller, getRect, getScrollLeft, getScrollTop, getStyle, groupBy, hasOwn, inBrowser, inMobile, inViewport, intersection, intersectionWith, isArray, isArrayBuffer, isBlob, isBoolean, isDOMException, isDataView, isDate, isEmpty, isEmptyPlainObject, isEqual, isEqualWith, isError, isFile, isFunction, isMap, isNonEmptyArray, isNullish, isNumber, isNumeric, isObject, isPlainObject, isPrimitive, isPromise, isRegExp, isSet, isString, isSymbol, isTruthy, isTypedArray, isWeakMap, isWeakSet, isWindow, kebabCase, localStorage, lowerFirst, mapObject, maxBy, mean, meanBy, merge, mergeWith, minBy, motion, normalizeToArray, objectToString, omit, omitBy, once, pascalCase, pick, pickBy, prettyJSONObject, preventDefault, promiseWithResolvers, raf, randomColor, randomNumber, randomString, removeArrayBlank, removeArrayEmpty, removeItem, requestAnimationFrame, round, sample, sessionStorage, set, shuffle, slash, sum, sumBy, sumHash, supportTouch, throttle, times, toArrayBuffer, toDataURL, toNumber, toRawType, toText, toTypeString, toggleItem, tryParseJSON, uniq, uniqBy, upperFirst, xor, xorWith };

package/lib/index.d.ts

@@ -58,6 +58,8 @@ type PromiseWithResolvers<T> = {
 };
 declare function promiseWithResolvers<T>(): PromiseWithResolvers<T>;
 
+declare function set<T extends object | any[]>(object: T, path: (string | number)[], value: any): void;
+
 declare function cancelAnimationFrame(handle: number): void;
 
 type ClassName = string | undefined | null;
@@ -130,20 +132,20 @@ interface Motion {
 }
 declare function motion(options: MotionOptions): Motion;
 
-declare function duration(): {
-    value: number;
-    years: (value: number) => any;
-    months: (value: number) => any;
-    weeks: (value: number) => any;
-    days: (value: number) => any;
-    hours: (value: number) => any;
-    minutes: (value: number) => any;
-    seconds: (value: number) => any;
-    milliseconds: (value: number) => any;
-    valueOf: (options?: {
+interface DurationContext {
+    years(value: number): this;
+    months(value: number): this;
+    weeks(value: number): this;
+    days(value: number): this;
+    hours(value: number): this;
+    minutes(value: number): this;
+    seconds(value: number): this;
+    milliseconds(value: number): this;
+    valueOf(options?: {
         milliseconds: boolean;
-    }) => number;
-};
+    }): number;
+}
+declare function duration(): DurationContext;
 
 declare function call<P extends any[], R>(fn?: ((...arg: P) => R) | ((...arg: P) => R)[] | null, ...args: P): R | R[] | undefined;
 
@@ -310,4 +312,4 @@ declare function floor(val: number, precision?: number): number;
 
 declare function ceil(val: number, precision?: number): number;
 
-export { type BEM, type ClassName, type Classes, type Motion, type MotionOptions, type MotionState, NOOP, type PromiseWithResolvers, type Storage, assert, at, baseRound, call, camelize, cancelAnimationFrame, ceil, chunk, clamp, clampArrayRange, classes, cloneDeep, cloneDeepWith, copyText, createNamespaceFn, createStorage, debounce, delay, difference, differenceWith, doubleRaf, download, duration, ensurePrefix, ensureSuffix, find, floor, genNumberKey, genStringKey, getAllParentScroller, getGlobalThis, getParentScroller, getRect, getScrollLeft, getScrollTop, getStyle, groupBy, hasOwn, inBrowser, inMobile, inViewport, intersection, intersectionWith, isArray, isArrayBuffer, isBlob, isBoolean, isDOMException, isDataView, isDate, isEmpty, isEmptyPlainObject, isEqual, isEqualWith, isError, isFile, isFunction, isMap, isNonEmptyArray, isNullish, isNumber, isNumeric, isObject, isPlainObject, isPrimitive, isPromise, isRegExp, isSet, isString, isSymbol, isTruthy, isTypedArray, isWeakMap, isWeakSet, isWindow, kebabCase, localStorage, lowerFirst, mapObject, maxBy, mean, meanBy, merge, mergeWith, minBy, motion, normalizeToArray, objectToString, omit, omitBy, once, pascalCase, pick, pickBy, prettyJSONObject, preventDefault, promiseWithResolvers, raf, randomColor, randomNumber, randomString, removeArrayBlank, removeArrayEmpty, removeItem, requestAnimationFrame, round, sample, sessionStorage, shuffle, slash, sum, sumBy, sumHash, supportTouch, throttle, times, toArrayBuffer, toDataURL, toNumber, toRawType, toText, toTypeString, toggleItem, tryParseJSON, uniq, uniqBy, upperFirst, xor, xorWith };
+export { type BEM, type ClassName, type Classes, type DurationContext, type Motion, type MotionOptions, type MotionState, NOOP, type PromiseWithResolvers, type Storage, assert, at, baseRound, call, camelize, cancelAnimationFrame, ceil, chunk, clamp, clampArrayRange, classes, cloneDeep, cloneDeepWith, copyText, createNamespaceFn, createStorage, debounce, delay, difference, differenceWith, doubleRaf, download, duration, ensurePrefix, ensureSuffix, find, floor, genNumberKey, genStringKey, getAllParentScroller, getGlobalThis, getParentScroller, getRect, getScrollLeft, getScrollTop, getStyle, groupBy, hasOwn, inBrowser, inMobile, inViewport, intersection, intersectionWith, isArray, isArrayBuffer, isBlob, isBoolean, isDOMException, isDataView, isDate, isEmpty, isEmptyPlainObject, isEqual, isEqualWith, isError, isFile, isFunction, isMap, isNonEmptyArray, isNullish, isNumber, isNumeric, isObject, isPlainObject, isPrimitive, isPromise, isRegExp, isSet, isString, isSymbol, isTruthy, isTypedArray, isWeakMap, isWeakSet, isWindow, kebabCase, localStorage, lowerFirst, mapObject, maxBy, mean, meanBy, merge, mergeWith, minBy, motion, normalizeToArray, objectToString, omit, omitBy, once, pascalCase, pick, pickBy, prettyJSONObject, preventDefault, promiseWithResolvers, raf, randomColor, randomNumber, randomString, removeArrayBlank, removeArrayEmpty, removeItem, requestAnimationFrame, round, sample, sessionStorage, set, shuffle, slash, sum, sumBy, sumHash, supportTouch, throttle, times, toArrayBuffer, toDataURL, toNumber, toRawType, toText, toTypeString, toggleItem, tryParseJSON, uniq, uniqBy, upperFirst, xor, xorWith };

package/lib/index.global.js

@@ -148,6 +148,7 @@ var Rattail = (() => {
     round: () => round,
     sample: () => sample,
     sessionStorage: () => sessionStorage,
+    set: () => set,
     shuffle: () => shuffle,
     slash: () => slash,
     sum: () => sum,
@@ -765,6 +766,27 @@ var Rattail = (() => {
     return { promise, resolve, reject };
   }
 
+  // src/object/set.ts
+  function set(object, path, value) {
+    if (!isObject(object)) {
+      return;
+    }
+    const keys = [...path];
+    if (keys.length === 0) {
+      return;
+    }
+    let target = object;
+    while (keys.length > 1) {
+      const key3 = keys.shift();
+      const nextKey = keys[0];
+      if (!isObject(target[key3])) {
+        target[key3] = isNumber(nextKey) ? [] : {};
+      }
+      target = target[key3];
+    }
+    target[keys[0]] = value;
+  }
+
   // src/util/cancelAnimationFrame.ts
   function cancelAnimationFrame(handle) {
     const globalThis2 = getGlobalThis();

package/lib/index.js

@@ -146,6 +146,7 @@ __export(src_exports, {
   round: () => round,
   sample: () => sample,
   sessionStorage: () => sessionStorage,
+  set: () => set,
   shuffle: () => shuffle,
   slash: () => slash,
   sum: () => sum,
@@ -763,6 +764,27 @@ function promiseWithResolvers() {
   return { promise, resolve, reject };
 }
 
+// src/object/set.ts
+function set(object, path, value) {
+  if (!isObject(object)) {
+    return;
+  }
+  const keys = [...path];
+  if (keys.length === 0) {
+    return;
+  }
+  let target = object;
+  while (keys.length > 1) {
+    const key3 = keys.shift();
+    const nextKey = keys[0];
+    if (!isObject(target[key3])) {
+      target[key3] = isNumber(nextKey) ? [] : {};
+    }
+    target = target[key3];
+  }
+  target[keys[0]] = value;
+}
+
 // src/util/index.ts
 var util_exports = {};
 __export(util_exports, {
@@ -1653,6 +1675,7 @@ export {
   round,
   sample,
   sessionStorage,
+  set,
   shuffle,
   slash,
   sum,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rattail",
-  "version": "1.0.21",
+  "version": "1.0.23",
   "description": "A utilities library for front-end developers, lightweight and ts-friendly",
   "keywords": [
     "utilities library",