rattail 1.0.19 → 1.0.20

package/lib/index.cjs

@@ -71,6 +71,7 @@ __export(src_exports, {
   differenceWith: () => differenceWith,
   doubleRaf: () => doubleRaf,
   download: () => download,
+  duration: () => duration,
   ensurePrefix: () => ensurePrefix,
   ensureSuffix: () => ensureSuffix,
   find: () => find,
@@ -785,6 +786,7 @@ __export(util_exports, {
   createStorage: () => createStorage,
   doubleRaf: () => doubleRaf,
   download: () => download,
+  duration: () => duration,
   getAllParentScroller: () => getAllParentScroller,
   getParentScroller: () => getParentScroller,
   getRect: () => getRect,
@@ -1099,7 +1101,7 @@ function motion(options) {
   const {
     from,
     to,
-    duration = 300,
+    duration: duration2 = 300,
     frame = () => {
     },
     timingFunction = (value2) => value2,
@@ -1127,7 +1129,7 @@ function motion(options) {
       ticker = requestAnimationFrame(() => {
         const now2 = performance.now();
         const executionTime = now2 - startTime - sleepTime;
-        const progress = clamp(executionTime / duration, 0, 1);
+        const progress = clamp(executionTime / duration2, 0, 1);
         value = distance * timingFunction(progress) + from;
         if (progress >= 1) {
           setState("finished");
@@ -1171,6 +1173,58 @@ function motion(options) {
   };
 }
 
+// src/util/duration.ts
+function duration() {
+  const ctx = {
+    value: 0,
+    years,
+    months,
+    weeks,
+    days,
+    hours,
+    minutes,
+    seconds,
+    milliseconds,
+    valueOf
+  };
+  function years(value) {
+    ctx.value += value * 365 * 24 * 60 * 60 * 1e3;
+    return ctx;
+  }
+  function months(value) {
+    ctx.value += value * 30 * 24 * 60 * 60 * 1e3;
+    return ctx;
+  }
+  function weeks(value) {
+    ctx.value += value * 7 * 24 * 60 * 60 * 1e3;
+    return ctx;
+  }
+  function days(value) {
+    ctx.value += value * 24 * 60 * 60 * 1e3;
+    return ctx;
+  }
+  function hours(value) {
+    ctx.value += value * 60 * 60 * 1e3;
+    return ctx;
+  }
+  function minutes(value) {
+    ctx.value += value * 60 * 1e3;
+    return ctx;
+  }
+  function seconds(value) {
+    ctx.value += value * 1e3;
+    return ctx;
+  }
+  function milliseconds(value) {
+    ctx.value += value;
+    return ctx;
+  }
+  function valueOf(options = { milliseconds: true }) {
+    return options.milliseconds ? ctx.value : ctx.value / 1e3;
+  }
+  return ctx;
+}
+
 // src/util/index.ts
 __reExport(util_exports, require("mitt"));
 var import_mitt = __toESM(require("mitt"), 1);
@@ -1525,6 +1579,7 @@ function ceil(val, precision = 0) {
   differenceWith,
   doubleRaf,
   download,
+  duration,
   ensurePrefix,
   ensureSuffix,
   find,

package/lib/index.d.cts

@@ -130,6 +130,21 @@ 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?: {
+        milliseconds: boolean;
+    }) => number;
+};
+
 declare function call<P extends any[], R>(fn?: ((...arg: P) => R) | ((...arg: P) => R)[] | null, ...args: P): R | R[] | undefined;
 
 declare function once<F extends (...args: any[]) => any>(fn: F): (this: unknown, ...args: Parameters<F>) => ReturnType<F>;
@@ -295,4 +310,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, 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 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 };

package/lib/index.d.ts

@@ -130,6 +130,21 @@ 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?: {
+        milliseconds: boolean;
+    }) => number;
+};
+
 declare function call<P extends any[], R>(fn?: ((...arg: P) => R) | ((...arg: P) => R)[] | null, ...args: P): R | R[] | undefined;
 
 declare function once<F extends (...args: any[]) => any>(fn: F): (this: unknown, ...args: Parameters<F>) => ReturnType<F>;
@@ -295,4 +310,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, 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 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 };

package/lib/index.global.js

@@ -61,6 +61,7 @@ var Rattail = (() => {
     differenceWith: () => differenceWith,
     doubleRaf: () => doubleRaf,
     download: () => download,
+    duration: () => duration,
     ensurePrefix: () => ensurePrefix,
     ensureSuffix: () => ensureSuffix,
     find: () => find,
@@ -1060,7 +1061,7 @@ var Rattail = (() => {
     const {
       from,
       to,
-      duration = 300,
+      duration: duration2 = 300,
       frame = () => {
       },
       timingFunction = (value2) => value2,
@@ -1088,7 +1089,7 @@ var Rattail = (() => {
         ticker = requestAnimationFrame(() => {
           const now2 = performance.now();
           const executionTime = now2 - startTime - sleepTime;
-          const progress = clamp(executionTime / duration, 0, 1);
+          const progress = clamp(executionTime / duration2, 0, 1);
           value = distance * timingFunction(progress) + from;
           if (progress >= 1) {
             setState("finished");
@@ -1132,6 +1133,58 @@ var Rattail = (() => {
     };
   }
 
+  // src/util/duration.ts
+  function duration() {
+    const ctx = {
+      value: 0,
+      years,
+      months,
+      weeks,
+      days,
+      hours,
+      minutes,
+      seconds,
+      milliseconds,
+      valueOf
+    };
+    function years(value) {
+      ctx.value += value * 365 * 24 * 60 * 60 * 1e3;
+      return ctx;
+    }
+    function months(value) {
+      ctx.value += value * 30 * 24 * 60 * 60 * 1e3;
+      return ctx;
+    }
+    function weeks(value) {
+      ctx.value += value * 7 * 24 * 60 * 60 * 1e3;
+      return ctx;
+    }
+    function days(value) {
+      ctx.value += value * 24 * 60 * 60 * 1e3;
+      return ctx;
+    }
+    function hours(value) {
+      ctx.value += value * 60 * 60 * 1e3;
+      return ctx;
+    }
+    function minutes(value) {
+      ctx.value += value * 60 * 1e3;
+      return ctx;
+    }
+    function seconds(value) {
+      ctx.value += value * 1e3;
+      return ctx;
+    }
+    function milliseconds(value) {
+      ctx.value += value;
+      return ctx;
+    }
+    function valueOf(options = { milliseconds: true }) {
+      return options.milliseconds ? ctx.value : ctx.value / 1e3;
+    }
+    return ctx;
+  }
+
   // node_modules/.pnpm/mitt@3.0.1/node_modules/mitt/dist/mitt.mjs
   function mitt_default(n) {
     return { all: n = n || /* @__PURE__ */ new Map(), on: function(t, e) {

package/lib/index.js

@@ -59,6 +59,7 @@ __export(src_exports, {
   differenceWith: () => differenceWith,
   doubleRaf: () => doubleRaf,
   download: () => download,
+  duration: () => duration,
   ensurePrefix: () => ensurePrefix,
   ensureSuffix: () => ensureSuffix,
   find: () => find,
@@ -772,6 +773,7 @@ __export(util_exports, {
   createStorage: () => createStorage,
   doubleRaf: () => doubleRaf,
   download: () => download,
+  duration: () => duration,
   getAllParentScroller: () => getAllParentScroller,
   getParentScroller: () => getParentScroller,
   getRect: () => getRect,
@@ -1086,7 +1088,7 @@ function motion(options) {
   const {
     from,
     to,
-    duration = 300,
+    duration: duration2 = 300,
     frame = () => {
     },
     timingFunction = (value2) => value2,
@@ -1114,7 +1116,7 @@ function motion(options) {
       ticker = requestAnimationFrame(() => {
         const now2 = performance.now();
         const executionTime = now2 - startTime - sleepTime;
-        const progress = clamp(executionTime / duration, 0, 1);
+        const progress = clamp(executionTime / duration2, 0, 1);
         value = distance * timingFunction(progress) + from;
         if (progress >= 1) {
           setState("finished");
@@ -1158,6 +1160,58 @@ function motion(options) {
   };
 }
 
+// src/util/duration.ts
+function duration() {
+  const ctx = {
+    value: 0,
+    years,
+    months,
+    weeks,
+    days,
+    hours,
+    minutes,
+    seconds,
+    milliseconds,
+    valueOf
+  };
+  function years(value) {
+    ctx.value += value * 365 * 24 * 60 * 60 * 1e3;
+    return ctx;
+  }
+  function months(value) {
+    ctx.value += value * 30 * 24 * 60 * 60 * 1e3;
+    return ctx;
+  }
+  function weeks(value) {
+    ctx.value += value * 7 * 24 * 60 * 60 * 1e3;
+    return ctx;
+  }
+  function days(value) {
+    ctx.value += value * 24 * 60 * 60 * 1e3;
+    return ctx;
+  }
+  function hours(value) {
+    ctx.value += value * 60 * 60 * 1e3;
+    return ctx;
+  }
+  function minutes(value) {
+    ctx.value += value * 60 * 1e3;
+    return ctx;
+  }
+  function seconds(value) {
+    ctx.value += value * 1e3;
+    return ctx;
+  }
+  function milliseconds(value) {
+    ctx.value += value;
+    return ctx;
+  }
+  function valueOf(options = { milliseconds: true }) {
+    return options.milliseconds ? ctx.value : ctx.value / 1e3;
+  }
+  return ctx;
+}
+
 // src/util/index.ts
 __reExport(util_exports, mitt_star);
 import * as mitt_star from "mitt";
@@ -1512,6 +1566,7 @@ export {
   differenceWith,
   doubleRaf,
   download,
+  duration,
   ensurePrefix,
   ensureSuffix,
   find,

package/package.json

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