rattail 1.0.13 → 1.0.14

package/lib/index.cjs

@@ -121,6 +121,7 @@ __export(src_exports, {
   merge: () => merge,
   mergeWith: () => mergeWith,
   minBy: () => minBy,
+  motion: () => motion,
   normalizeToArray: () => normalizeToArray,
   objectToString: () => objectToString,
   omit: () => omit,
@@ -1045,6 +1046,83 @@ function download(val, filename = "file") {
   document.body.removeChild(a);
 }
 
+// src/util/motion.ts
+function motion(options) {
+  const {
+    from,
+    to,
+    duration = 300,
+    frame = () => {
+    },
+    timingFunction = (value2) => value2,
+    onStateChange = () => {
+    }
+  } = options;
+  let state = "pending";
+  let value = from;
+  const distance = to - from;
+  let ticker = void 0;
+  let startTime = void 0;
+  let pausedTime = void 0;
+  let sleepTime = 0;
+  function start() {
+    if (state === "running" || state === "finished") {
+      return;
+    }
+    setState("running");
+    const now = performance.now();
+    startTime = startTime != null ? startTime : now;
+    sleepTime += pausedTime != null ? now - pausedTime : 0;
+    pausedTime = void 0;
+    tick();
+    function tick() {
+      ticker = requestAnimationFrame(() => {
+        const now2 = performance.now();
+        const executionTime = now2 - startTime - sleepTime;
+        const progress = clamp(executionTime / duration, 0, 1);
+        value = distance * timingFunction(progress) + from;
+        if (progress >= 1) {
+          setState("finished");
+          frame({ value: to, done: true });
+          return;
+        }
+        frame({ value, done: false });
+        tick();
+      });
+    }
+  }
+  function pause() {
+    if (state !== "running") {
+      return;
+    }
+    cancelAnimationFrame(ticker);
+    setState("paused");
+    pausedTime = performance.now();
+  }
+  function reset() {
+    cancelAnimationFrame(ticker);
+    setState("pending");
+    value = from;
+    ticker = void 0;
+    startTime = void 0;
+    pausedTime = void 0;
+    sleepTime = 0;
+  }
+  function getState() {
+    return state;
+  }
+  function setState(_state) {
+    state = _state;
+    onStateChange(_state);
+  }
+  return {
+    start,
+    pause,
+    reset,
+    getState
+  };
+}
+
 // src/function/call.ts
 function call(fn, ...args) {
   if (isArray(fn)) {
@@ -1459,6 +1537,7 @@ function ceil(val, precision = 0) {
   merge,
   mergeWith,
   minBy,
+  motion,
   normalizeToArray,
   objectToString,
   omit,

package/lib/index.d.cts

@@ -107,6 +107,26 @@ declare function tryParseJSON<T>(json: string): T | undefined;
 
 declare function download(val: string | Blob | File, filename?: string): void;
 
+interface MotionOptions {
+    from: number;
+    to: number;
+    duration?: number;
+    frame?: ({ value, done }: {
+        value: number;
+        done: boolean;
+    }) => void;
+    timingFunction?: (v: number) => number;
+    onStateChange?: (state: MotionState) => void;
+}
+type MotionState = 'running' | 'paused' | 'pending' | 'finished';
+interface Motion {
+    start: () => void;
+    pause: () => void;
+    reset: () => void;
+    getState: () => MotionState;
+}
+declare function motion(options: MotionOptions): Motion;
+
 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>;
@@ -270,4 +290,4 @@ declare function floor(val: number, precision?: number): number;
 
 declare function ceil(val: number, precision?: number): number;
 
-export { type BEM, type ClassName, type Classes, NOOP, type PromiseWithResolvers, type Storage, 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, 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, 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 };

package/lib/index.d.ts

@@ -107,6 +107,26 @@ declare function tryParseJSON<T>(json: string): T | undefined;
 
 declare function download(val: string | Blob | File, filename?: string): void;
 
+interface MotionOptions {
+    from: number;
+    to: number;
+    duration?: number;
+    frame?: ({ value, done }: {
+        value: number;
+        done: boolean;
+    }) => void;
+    timingFunction?: (v: number) => number;
+    onStateChange?: (state: MotionState) => void;
+}
+type MotionState = 'running' | 'paused' | 'pending' | 'finished';
+interface Motion {
+    start: () => void;
+    pause: () => void;
+    reset: () => void;
+    getState: () => MotionState;
+}
+declare function motion(options: MotionOptions): Motion;
+
 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>;
@@ -270,4 +290,4 @@ declare function floor(val: number, precision?: number): number;
 
 declare function ceil(val: number, precision?: number): number;
 
-export { type BEM, type ClassName, type Classes, NOOP, type PromiseWithResolvers, type Storage, 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, 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, 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 };

package/lib/index.global.js

@@ -122,6 +122,7 @@ var Rattail = (() => {
     merge: () => merge,
     mergeWith: () => mergeWith,
     minBy: () => minBy,
+    motion: () => motion,
     normalizeToArray: () => normalizeToArray,
     objectToString: () => objectToString,
     omit: () => omit,
@@ -1045,6 +1046,83 @@ var Rattail = (() => {
     document.body.removeChild(a);
   }
 
+  // src/util/motion.ts
+  function motion(options) {
+    const {
+      from,
+      to,
+      duration = 300,
+      frame = () => {
+      },
+      timingFunction = (value2) => value2,
+      onStateChange = () => {
+      }
+    } = options;
+    let state = "pending";
+    let value = from;
+    const distance = to - from;
+    let ticker = void 0;
+    let startTime = void 0;
+    let pausedTime = void 0;
+    let sleepTime = 0;
+    function start() {
+      if (state === "running" || state === "finished") {
+        return;
+      }
+      setState("running");
+      const now = performance.now();
+      startTime = startTime != null ? startTime : now;
+      sleepTime += pausedTime != null ? now - pausedTime : 0;
+      pausedTime = void 0;
+      tick();
+      function tick() {
+        ticker = requestAnimationFrame(() => {
+          const now2 = performance.now();
+          const executionTime = now2 - startTime - sleepTime;
+          const progress = clamp(executionTime / duration, 0, 1);
+          value = distance * timingFunction(progress) + from;
+          if (progress >= 1) {
+            setState("finished");
+            frame({ value: to, done: true });
+            return;
+          }
+          frame({ value, done: false });
+          tick();
+        });
+      }
+    }
+    function pause() {
+      if (state !== "running") {
+        return;
+      }
+      cancelAnimationFrame(ticker);
+      setState("paused");
+      pausedTime = performance.now();
+    }
+    function reset() {
+      cancelAnimationFrame(ticker);
+      setState("pending");
+      value = from;
+      ticker = void 0;
+      startTime = void 0;
+      pausedTime = void 0;
+      sleepTime = 0;
+    }
+    function getState() {
+      return state;
+    }
+    function setState(_state) {
+      state = _state;
+      onStateChange(_state);
+    }
+    return {
+      start,
+      pause,
+      reset,
+      getState
+    };
+  }
+
   // src/function/call.ts
   function call(fn, ...args) {
     if (isArray(fn)) {

package/lib/index.js

@@ -896,6 +896,83 @@ function download(val, filename = "file") {
   document.body.removeChild(a);
 }
 
+// src/util/motion.ts
+function motion(options) {
+  const {
+    from,
+    to,
+    duration = 300,
+    frame = () => {
+    },
+    timingFunction = (value2) => value2,
+    onStateChange = () => {
+    }
+  } = options;
+  let state = "pending";
+  let value = from;
+  const distance = to - from;
+  let ticker = void 0;
+  let startTime = void 0;
+  let pausedTime = void 0;
+  let sleepTime = 0;
+  function start() {
+    if (state === "running" || state === "finished") {
+      return;
+    }
+    setState("running");
+    const now = performance.now();
+    startTime = startTime != null ? startTime : now;
+    sleepTime += pausedTime != null ? now - pausedTime : 0;
+    pausedTime = void 0;
+    tick();
+    function tick() {
+      ticker = requestAnimationFrame(() => {
+        const now2 = performance.now();
+        const executionTime = now2 - startTime - sleepTime;
+        const progress = clamp(executionTime / duration, 0, 1);
+        value = distance * timingFunction(progress) + from;
+        if (progress >= 1) {
+          setState("finished");
+          frame({ value: to, done: true });
+          return;
+        }
+        frame({ value, done: false });
+        tick();
+      });
+    }
+  }
+  function pause() {
+    if (state !== "running") {
+      return;
+    }
+    cancelAnimationFrame(ticker);
+    setState("paused");
+    pausedTime = performance.now();
+  }
+  function reset() {
+    cancelAnimationFrame(ticker);
+    setState("pending");
+    value = from;
+    ticker = void 0;
+    startTime = void 0;
+    pausedTime = void 0;
+    sleepTime = 0;
+  }
+  function getState() {
+    return state;
+  }
+  function setState(_state) {
+    state = _state;
+    onStateChange(_state);
+  }
+  return {
+    start,
+    pause,
+    reset,
+    getState
+  };
+}
+
 // src/function/call.ts
 function call(fn, ...args) {
   if (isArray(fn)) {
@@ -1309,6 +1386,7 @@ export {
   merge,
   mergeWith,
   minBy,
+  motion,
   normalizeToArray,
   objectToString,
   omit,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rattail",
-  "version": "1.0.13",
+  "version": "1.0.14",
   "type": "module",
   "main": "lib/index.cjs",
   "module": "lib/index.js",