@studiometa/js-toolkit 2.11.2 → 3.0.0-alpha.1

package/utils/string/withoutLeadingCharactersRecursive.js.map

@@ -2,6 +2,6 @@
   "version": 3,
   "sources": ["../../../packages/js-toolkit/utils/string/withoutLeadingCharactersRecursive.ts"],
   "sourcesContent": ["import withoutLeadingCharacters from './withoutLeadingCharacters.js';\n\n/**\n * Remove the given characters to the start of the given string recursively.\n *\n * @param   {string} string     The string to modify.\n * @param   {string} characters The characters to add to the start.\n * @returns {string}\n */\nexport default function withoutLeadingCharactersRecursive(\n  string: string,\n  characters: string,\n): string {\n  let str = withoutLeadingCharacters(string, characters);\n  const regex = new RegExp(`^${characters}`);\n\n  while (regex.test(str)) {\n    str = withoutLeadingCharacters(str, characters);\n  }\n\n  return str;\n}\n"],
-  "mappings": "AAAA,OAAO,8BAA8B;AAStB,SAAR,kCACL,QACA,YACQ;AACR,MAAI,MAAM,yBAAyB,QAAQ,UAAU;AACrD,QAAM,QAAQ,IAAI,OAAO,IAAI,YAAY;AAEzC,SAAO,MAAM,KAAK,GAAG,GAAG;AACtB,UAAM,yBAAyB,KAAK,UAAU;AAAA,EAChD;AAEA,SAAO;AACT;",
+  "mappings": "AAAA,OAAO,8BAA8B;AAStB,SAAR,kCACL,QACA,YACQ;AACR,MAAI,MAAM,yBAAyB,QAAQ,UAAU;AACrD,QAAM,QAAQ,IAAI,OAAO,IAAI,UAAU,EAAE;AAEzC,SAAO,MAAM,KAAK,GAAG,GAAG;AACtB,UAAM,yBAAyB,KAAK,UAAU;AAAA,EAChD;AAEA,SAAO;AACT;",
   "names": []
 }

package/utils/string/withoutTrailingCharacters.js.map

@@ -2,6 +2,6 @@
   "version": 3,
   "sources": ["../../../packages/js-toolkit/utils/string/withoutTrailingCharacters.ts"],
   "sourcesContent": ["/**\n * Remove the given characters from the end of the given string.\n *\n * @param   {string} string     The string to modify.\n * @param   {string} characters The characters to remove from the end.\n * @returns {string}\n */\nexport default function withoutTrailingCharacters(string: string, characters: string): string {\n  return string.replace(new RegExp(`${characters}$`), '');\n}\n"],
-  "mappings": "AAOe,SAAR,0BAA2C,QAAgB,YAA4B;AAC5F,SAAO,OAAO,QAAQ,IAAI,OAAO,GAAG,aAAa,GAAG,EAAE;AACxD;",
+  "mappings": "AAOe,SAAR,0BAA2C,QAAgB,YAA4B;AAC5F,SAAO,OAAO,QAAQ,IAAI,OAAO,GAAG,UAAU,GAAG,GAAG,EAAE;AACxD;",
   "names": []
 }

package/utils/string/withoutTrailingCharactersRecursive.js.map

@@ -2,6 +2,6 @@
   "version": 3,
   "sources": ["../../../packages/js-toolkit/utils/string/withoutTrailingCharactersRecursive.ts"],
   "sourcesContent": ["import withoutTrailingCharacters from './withoutTrailingCharacters.js';\n\n/**\n * Remove the given characters to the start of the given string recursively.\n *\n * @param   {string} string     The string to modify.\n * @param   {string} characters The characters to add to the start.\n * @returns {string}\n */\nexport default function withoutTrailingCharactersRecursive(\n  string: string,\n  characters: string,\n): string {\n  let str = withoutTrailingCharacters(string, characters);\n  const regex = new RegExp(`${characters}$`);\n\n  while (regex.test(str)) {\n    str = withoutTrailingCharacters(str, characters);\n  }\n\n  return str;\n}\n"],
-  "mappings": "AAAA,OAAO,+BAA+B;AASvB,SAAR,mCACL,QACA,YACQ;AACR,MAAI,MAAM,0BAA0B,QAAQ,UAAU;AACtD,QAAM,QAAQ,IAAI,OAAO,GAAG,aAAa;AAEzC,SAAO,MAAM,KAAK,GAAG,GAAG;AACtB,UAAM,0BAA0B,KAAK,UAAU;AAAA,EACjD;AAEA,SAAO;AACT;",
+  "mappings": "AAAA,OAAO,+BAA+B;AASvB,SAAR,mCACL,QACA,YACQ;AACR,MAAI,MAAM,0BAA0B,QAAQ,UAAU;AACtD,QAAM,QAAQ,IAAI,OAAO,GAAG,UAAU,GAAG;AAEzC,SAAO,MAAM,KAAK,GAAG,GAAG;AACtB,UAAM,0BAA0B,KAAK,UAAU;AAAA,EACjD;AAEA,SAAO;AACT;",
   "names": []
 }

package/utils/{focusTrap.d.ts → trapFocus.d.ts}

@@ -8,16 +8,8 @@ export declare function saveActiveElement(): void;
  * @param {HTMLElement} element The element in which to trap the tabulations.
  * @param {KeyboardEvent} event The keydown or keyup event.
  */
-export declare function trap(element: HTMLElement, event: KeyboardEvent): void;
+export declare function trapFocus(element: HTMLElement, event: KeyboardEvent): void;
 /**
  * Untrap the tab navigation.
  */
-export declare function untrap(): void;
-/**
- * Use a trap/untrap tabs logic.
- */
-export default function useFocusTrap(): {
-    trap: typeof trap;
-    untrap: typeof untrap;
-    saveActiveElement: typeof saveActiveElement;
-};
+export declare function untrapFocus(): void;

package/utils/{focusTrap.js → trapFocus.js}

@@ -17,7 +17,7 @@ let focusedBefore;
 function saveActiveElement() {
   focusedBefore = document.activeElement;
 }
-function trap(element, event) {
+function trapFocus(element, event) {
   if (event.keyCode !== keyCodes.TAB) {
     return;
   }
@@ -43,19 +43,15 @@ function trap(element, event) {
     event.preventDefault();
   }
 }
-function untrap() {
+function untrapFocus() {
   if (focusedBefore && isFunction(focusedBefore.focus)) {
     focusedBefore.focus();
     focusedBefore = null;
   }
 }
-function useFocusTrap() {
-  return { trap, untrap, saveActiveElement };
-}
 export {
-  useFocusTrap as default,
   saveActiveElement,
-  trap,
-  untrap
+  trapFocus,
+  untrapFocus
 };
-//# sourceMappingURL=focusTrap.js.map
+//# sourceMappingURL=trapFocus.js.map

package/utils/trapFocus.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../packages/js-toolkit/utils/trapFocus.ts"],
+  "sourcesContent": ["import keyCodes from './keyCodes.js';\nimport { isFunction } from './is.js';\n\nconst FOCUSABLE_ELEMENTS = [\n  'a[href]:not([tabindex^=\"-\"]):not([inert])',\n  'area[href]:not([tabindex^=\"-\"]):not([inert])',\n  'input:not([disabled]):not([inert])',\n  'select:not([disabled]):not([inert])',\n  'textarea:not([disabled]):not([inert])',\n  'button:not([disabled]):not([inert])',\n  'iframe:not([tabindex^=\"-\"]):not([inert])',\n  'audio:not([tabindex^=\"-\"]):not([inert])',\n  'video:not([tabindex^=\"-\"]):not([inert])',\n  '[contenteditable]:not([tabindex^=\"-\"]):not([inert])',\n  '[tabindex]:not([tabindex^=\"-\"]):not([inert])',\n];\n\nlet focusedBefore;\n\n/**\n * Save the current active element.\n */\nexport function saveActiveElement() {\n  focusedBefore = document.activeElement;\n}\n\n/**\n * Trap tab navigation inside the given element.\n *\n * @param {HTMLElement} element The element in which to trap the tabulations.\n * @param {KeyboardEvent} event The keydown or keyup event.\n */\nexport function trapFocus(element: HTMLElement, event: KeyboardEvent) {\n  if (event.keyCode !== keyCodes.TAB) {\n    return;\n  }\n\n  // Save the previous focused element\n  if (!focusedBefore) {\n    focusedBefore = document.activeElement;\n  }\n\n  const focusableChildren: HTMLElement[] = Array.from(\n    element.querySelectorAll(FOCUSABLE_ELEMENTS.join(', ')),\n  ) as HTMLElement[];\n  const focusedItemIndex =\n    document.activeElement instanceof HTMLElement\n      ? focusableChildren.indexOf(document.activeElement)\n      : -1;\n\n  if (!focusableChildren.length) {\n    return;\n  }\n\n  if (focusedItemIndex < 0) {\n    focusableChildren[0].focus();\n    event.preventDefault();\n  }\n\n  // If the SHIFT key is being pressed while tabbing (moving backwards) and\n  // the currently focused item is the first one, move the focus to the last\n  // focusable item from the dialog element\n  if (event.shiftKey && focusedItemIndex === 0) {\n    focusableChildren.at(-1).focus();\n    event.preventDefault();\n  }\n\n  // If the SHIFT key is not being pressed (moving forwards) and the currently\n  // focused item is the last one, move the focus to the first focusable item\n  // from the dialog element\n  else if (!event.shiftKey && focusedItemIndex === focusableChildren.length - 1) {\n    focusableChildren[0].focus();\n    event.preventDefault();\n  }\n}\n\n/**\n * Untrap the tab navigation.\n */\nexport function untrapFocus() {\n  if (focusedBefore && isFunction(focusedBefore.focus)) {\n    focusedBefore.focus();\n    focusedBefore = null;\n  }\n}\n"],
+  "mappings": "AAAA,OAAO,cAAc;AACrB,SAAS,kBAAkB;AAE3B,MAAM,qBAAqB;AAAA,EACzB;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAEA,IAAI;AAKG,SAAS,oBAAoB;AAClC,kBAAgB,SAAS;AAC3B;AAQO,SAAS,UAAU,SAAsB,OAAsB;AACpE,MAAI,MAAM,YAAY,SAAS,KAAK;AAClC;AAAA,EACF;AAGA,MAAI,CAAC,eAAe;AAClB,oBAAgB,SAAS;AAAA,EAC3B;AAEA,QAAM,oBAAmC,MAAM;AAAA,IAC7C,QAAQ,iBAAiB,mBAAmB,KAAK,IAAI,CAAC;AAAA,EACxD;AACA,QAAM,mBACJ,SAAS,yBAAyB,cAC9B,kBAAkB,QAAQ,SAAS,aAAa,IAChD;AAEN,MAAI,CAAC,kBAAkB,QAAQ;AAC7B;AAAA,EACF;AAEA,MAAI,mBAAmB,GAAG;AACxB,sBAAkB,CAAC,EAAE,MAAM;AAC3B,UAAM,eAAe;AAAA,EACvB;AAKA,MAAI,MAAM,YAAY,qBAAqB,GAAG;AAC5C,sBAAkB,GAAG,EAAE,EAAE,MAAM;AAC/B,UAAM,eAAe;AAAA,EACvB,WAKS,CAAC,MAAM,YAAY,qBAAqB,kBAAkB,SAAS,GAAG;AAC7E,sBAAkB,CAAC,EAAE,MAAM;AAC3B,UAAM,eAAe;AAAA,EACvB;AACF;AAKO,SAAS,cAAc;AAC5B,MAAI,iBAAiB,WAAW,cAAc,KAAK,GAAG;AACpD,kBAAc,MAAM;AACpB,oBAAgB;AAAA,EAClB;AACF;",
+  "names": []
+}

package/utils/tween.d.ts

@@ -1,12 +1,67 @@
 import type { EasingFunction } from './math/createEases.js';
 export type BezierCurve = [number, number, number, number];
+/**
+ * Controls for a tween.
+ */
+export interface Tween {
+    /**
+     * Start the tween from the beginning.
+     */
+    start: () => void;
+    /**
+     * Finish the tween and set its state to the end.
+     */
+    finish: () => void;
+    /**
+     * Pause the tween.
+     */
+    pause: () => void;
+    /**
+     * Start the tween from the current paused progress.
+     */
+    play: () => void;
+    /**
+     * Set and get the tween's progress.
+     */
+    progress: (progress?: number) => number;
+}
 export interface TweenOptions {
+    /**
+     * The duration, in seconds.
+     * Defaults to `1`.
+     */
     duration?: number;
+    /**
+     * The delay, in seconds.
+     * Defaults to `0`.
+     */
+    delay?: number;
+    /**
+     * The easing function or bezier curve to use.
+     * Defaults to a linear easing function.
+     */
     easing?: EasingFunction | BezierCurve;
+    /**
+     * The smooth factor. Setting this option to `true` or a `number` will disable the `duration` option.
+     */
+    smooth?: true | number;
+    /**
+     * The precision for when to consider the tween finished.
+     * Defaults to `0.0001`.
+     */
     precision?: number;
-    onStart?: () => void;
-    onProgress?: (progress: number, easedProgress: number) => void;
-    onFinish?: (progress: number, easedProgress: number) => void;
+    /**
+     * A callback executed on start.
+     */
+    onStart?: (progress: number) => void;
+    /**
+     * A callback executed each time the progress is updated.
+     */
+    onProgress?: (progress: number) => void;
+    /**
+     * A callback executed when the tween is finished.
+     */
+    onFinish?: (progress: number) => void;
 }
 /**
  * Normalize a easing function with default fallbacks.
@@ -15,10 +70,4 @@ export declare function normalizeEase(ease: EasingFunction | BezierCurve): Easin
 /**
  * Tween from 0 to 1.
  */
-export declare function tween(callback: (progress: number) => unknown, options?: TweenOptions): {
-    start: () => void;
-    finish: () => number;
-    pause: () => void;
-    play: () => void;
-    progress: (newProgress: number) => number;
-};
+export declare function tween(callback: (progress: number) => unknown, options?: TweenOptions): Tween;

package/utils/tween.js

@@ -1,6 +1,6 @@
 import { cubicBezier } from "@motionone/easing";
-import { lerp, map, clamp01 } from "./math/index.js";
-import { isDefined, isArray } from "./is.js";
+import { lerp, map, clamp01, damp, inertiaFinalValue } from "./math/index.js";
+import { isDefined, isArray, isNumber } from "./is.js";
 import { noop, noopValue as linear } from "./noop.js";
 import useRaf from "../services/raf.js";
 let id = 0;
@@ -18,12 +18,16 @@ function tween(callback, options = {}) {
   const raf = useRaf();
   let progressValue = 0;
   let easedProgress = 0;
+  const isSmooth = isDefined(options.smooth) && (isNumber(options.smooth) || options.smooth);
+  const smoothFactor = isNumber(options.smooth) ? options.smooth : 0.1;
   const precision = options.precision ?? DEFAULT_PROGRESS_PRECISION;
   const ease = normalizeEase(options.easing);
+  let delay = options.delay ?? 0;
+  delay *= 1e3;
   let duration = options.duration ?? 1;
   duration *= 1e3;
-  let startTime = performance.now();
-  let endTime = startTime + duration;
+  let startTime = getStartTime();
+  let endTime = getEndTime(startTime);
   const key = `tw-${id}`;
   id += 1;
   const { onStart = noop, onProgress = noop, onFinish = noop } = options;
@@ -33,34 +37,36 @@ function tween(callback, options = {}) {
     raf.remove(key);
   }
   function progress(newProgress) {
-    if (typeof newProgress === "undefined") {
+    if (!isDefined(newProgress)) {
       return easedProgress;
     }
     progressValue = newProgress;
-    easedProgress = ease(progressValue);
+    easedProgress = isSmooth ? damp(progressValue, easedProgress, smoothFactor, precision) : ease(progressValue);
     if (Math.abs(1 - easedProgress) < precision) {
       progressValue = 1;
       easedProgress = 1;
     }
     callback(easedProgress);
-    onProgress(progressValue, easedProgress);
+    onProgress(easedProgress);
     if (easedProgress === 1) {
       pause();
-      requestAnimationFrame(() => onFinish(progressValue, easedProgress));
+      requestAnimationFrame(() => onFinish(easedProgress));
     }
-    return progressValue;
+    return easedProgress;
   }
   function tick(props) {
-    if (!isRunning) {
-      raf.remove(key);
-      return;
-    }
     progress(clamp01(map(props.time, startTime, endTime, 0, 1)));
   }
+  function getStartTime() {
+    return performance.now() + delay;
+  }
+  function getEndTime(time) {
+    return isSmooth ? inertiaFinalValue(time, 1) : time + duration;
+  }
   function start() {
-    onStart();
-    startTime = performance.now();
-    endTime = startTime + duration;
+    onStart(0);
+    startTime = getStartTime();
+    endTime = getEndTime(startTime);
     progressValue = 0;
     easedProgress = 0;
     isRunning = true;
@@ -70,8 +76,8 @@ function tween(callback, options = {}) {
     if (isRunning) {
       return;
     }
-    startTime = performance.now() - lerp(0, duration, progressValue);
-    endTime = startTime + duration;
+    startTime = getStartTime() - lerp(0, duration, progressValue);
+    endTime = getEndTime(startTime);
     isRunning = true;
     raf.add(key, tick);
   }

package/utils/tween.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../packages/js-toolkit/utils/tween.ts"],
-  "sourcesContent": ["import { cubicBezier } from '@motionone/easing';\nimport { lerp, map, clamp01 } from './math/index.js';\nimport { isDefined, isArray } from './is.js';\nimport { noop, noopValue as linear } from './noop.js';\nimport useRaf from '../services/raf.js';\nimport type { EasingFunction } from './math/createEases.js';\n\nlet id = 0;\nconst DEFAULT_PROGRESS_PRECISION = 0.0001;\n\nexport type BezierCurve = [number, number, number, number];\n\nexport interface TweenOptions {\n  duration?: number;\n  easing?: EasingFunction | BezierCurve;\n  precision?: number;\n  onStart?: () => void;\n  onProgress?: (progress: number, easedProgress: number) => void;\n  onFinish?: (progress: number, easedProgress: number) => void;\n}\n\n/**\n * Normalize a easing function with default fallbacks.\n */\nexport function normalizeEase(ease: EasingFunction | BezierCurve): EasingFunction {\n  if (!isDefined(ease)) {\n    return linear;\n  }\n\n  if (isArray(ease)) {\n    return cubicBezier(...ease);\n  }\n\n  return ease;\n}\n\n/**\n * Tween from 0 to 1.\n */\nexport function tween(callback: (progress: number) => unknown, options: TweenOptions = {}) {\n  const raf = useRaf();\n\n  let progressValue = 0;\n  let easedProgress = 0;\n\n  const precision = options.precision ?? DEFAULT_PROGRESS_PRECISION;\n  const ease = normalizeEase(options.easing);\n  let duration = options.duration ?? 1;\n  duration *= 1000;\n\n  let startTime = performance.now();\n  let endTime = startTime + duration;\n\n  const key = `tw-${id}`;\n  id += 1;\n\n  const { onStart = noop, onProgress = noop, onFinish = noop } = options;\n  let isRunning = false;\n\n  /**\n   * Pause the animation.\n   */\n  function pause() {\n    isRunning = false;\n    raf.remove(key);\n  }\n\n  /**\n   * Set the progress value.\n   */\n  function progress(newProgress: number) {\n    if (typeof newProgress === 'undefined') {\n      return easedProgress;\n    }\n\n    progressValue = newProgress;\n    easedProgress = ease(progressValue);\n\n    // Stop when reaching precision\n    if (Math.abs(1 - easedProgress) < precision) {\n      progressValue = 1;\n      easedProgress = 1;\n    }\n\n    callback(easedProgress);\n    onProgress(progressValue, easedProgress);\n\n    if (easedProgress === 1) {\n      pause();\n      requestAnimationFrame(() => onFinish(progressValue, easedProgress));\n    }\n\n    return progressValue;\n  }\n\n  /**\n   * Loop for rendering the animation.\n   */\n  function tick(props: { time: number }) {\n    if (!isRunning) {\n      raf.remove(key);\n      return;\n    }\n\n    progress(clamp01(map(props.time, startTime, endTime, 0, 1)));\n  }\n\n  /**\n   * Play the animation.\n   */\n  function start() {\n    onStart();\n    startTime = performance.now();\n    endTime = startTime + duration;\n    progressValue = 0;\n    easedProgress = 0;\n    isRunning = true;\n\n    raf.add(key, tick);\n  }\n\n  /**\n   * Play a paused animation.\n   */\n  function play() {\n    if (isRunning) {\n      return;\n    }\n\n    startTime = performance.now() - lerp(0, duration, progressValue);\n    endTime = startTime + duration;\n    isRunning = true;\n\n    raf.add(key, tick);\n  }\n\n  return {\n    start,\n    finish: () => progress(1),\n    pause,\n    play,\n    progress,\n  };\n}\n"],
-  "mappings": "AAAA,SAAS,mBAAmB;AAC5B,SAAS,MAAM,KAAK,eAAe;AACnC,SAAS,WAAW,eAAe;AACnC,SAAS,MAAM,aAAa,cAAc;AAC1C,OAAO,YAAY;AAGnB,IAAI,KAAK;AACT,MAAM,6BAA6B;AAgB5B,SAAS,cAAc,MAAoD;AAChF,MAAI,CAAC,UAAU,IAAI,GAAG;AACpB,WAAO;AAAA,EACT;AAEA,MAAI,QAAQ,IAAI,GAAG;AACjB,WAAO,YAAY,GAAG,IAAI;AAAA,EAC5B;AAEA,SAAO;AACT;AAKO,SAAS,MAAM,UAAyC,UAAwB,CAAC,GAAG;AACzF,QAAM,MAAM,OAAO;AAEnB,MAAI,gBAAgB;AACpB,MAAI,gBAAgB;AAEpB,QAAM,YAAY,QAAQ,aAAa;AACvC,QAAM,OAAO,cAAc,QAAQ,MAAM;AACzC,MAAI,WAAW,QAAQ,YAAY;AACnC,cAAY;AAEZ,MAAI,YAAY,YAAY,IAAI;AAChC,MAAI,UAAU,YAAY;AAE1B,QAAM,MAAM,MAAM;AAClB,QAAM;AAEN,QAAM,EAAE,UAAU,MAAM,aAAa,MAAM,WAAW,KAAK,IAAI;AAC/D,MAAI,YAAY;AAKhB,WAAS,QAAQ;AACf,gBAAY;AACZ,QAAI,OAAO,GAAG;AAAA,EAChB;AAKA,WAAS,SAAS,aAAqB;AACrC,QAAI,OAAO,gBAAgB,aAAa;AACtC,aAAO;AAAA,IACT;AAEA,oBAAgB;AAChB,oBAAgB,KAAK,aAAa;AAGlC,QAAI,KAAK,IAAI,IAAI,aAAa,IAAI,WAAW;AAC3C,sBAAgB;AAChB,sBAAgB;AAAA,IAClB;AAEA,aAAS,aAAa;AACtB,eAAW,eAAe,aAAa;AAEvC,QAAI,kBAAkB,GAAG;AACvB,YAAM;AACN,4BAAsB,MAAM,SAAS,eAAe,aAAa,CAAC;AAAA,IACpE;AAEA,WAAO;AAAA,EACT;AAKA,WAAS,KAAK,OAAyB;AACrC,QAAI,CAAC,WAAW;AACd,UAAI,OAAO,GAAG;AACd;AAAA,IACF;AAEA,aAAS,QAAQ,IAAI,MAAM,MAAM,WAAW,SAAS,GAAG,CAAC,CAAC,CAAC;AAAA,EAC7D;AAKA,WAAS,QAAQ;AACf,YAAQ;AACR,gBAAY,YAAY,IAAI;AAC5B,cAAU,YAAY;AACtB,oBAAgB;AAChB,oBAAgB;AAChB,gBAAY;AAEZ,QAAI,IAAI,KAAK,IAAI;AAAA,EACnB;AAKA,WAAS,OAAO;AACd,QAAI,WAAW;AACb;AAAA,IACF;AAEA,gBAAY,YAAY,IAAI,IAAI,KAAK,GAAG,UAAU,aAAa;AAC/D,cAAU,YAAY;AACtB,gBAAY;AAEZ,QAAI,IAAI,KAAK,IAAI;AAAA,EACnB;AAEA,SAAO;AAAA,IACL;AAAA,IACA,QAAQ,MAAM,SAAS,CAAC;AAAA,IACxB;AAAA,IACA;AAAA,IACA;AAAA,EACF;AACF;",
+  "sourcesContent": ["import { cubicBezier } from '@motionone/easing';\nimport { lerp, map, clamp01, damp, inertiaFinalValue } from './math/index.js';\nimport { isDefined, isArray, isNumber } from './is.js';\nimport { noop, noopValue as linear } from './noop.js';\nimport useRaf from '../services/raf.js';\nimport type { EasingFunction } from './math/createEases.js';\n\nlet id = 0;\nconst DEFAULT_PROGRESS_PRECISION = 0.0001;\n\nexport type BezierCurve = [number, number, number, number];\n\n/**\n * Controls for a tween.\n */\nexport interface Tween {\n  /**\n   * Start the tween from the beginning.\n   */\n  start: () => void;\n  /**\n   * Finish the tween and set its state to the end.\n   */\n  finish: () => void;\n  /**\n   * Pause the tween.\n   */\n  pause: () => void;\n  /**\n   * Start the tween from the current paused progress.\n   */\n  play: () => void;\n  /**\n   * Set and get the tween's progress.\n   */\n  progress: (progress?: number) => number;\n}\n\nexport interface TweenOptions {\n  /**\n   * The duration, in seconds.\n   * Defaults to `1`.\n   */\n  duration?: number;\n  /**\n   * The delay, in seconds.\n   * Defaults to `0`.\n   */\n  delay?: number;\n  /**\n   * The easing function or bezier curve to use.\n   * Defaults to a linear easing function.\n   */\n  easing?: EasingFunction | BezierCurve;\n  /**\n   * The smooth factor. Setting this option to `true` or a `number` will disable the `duration` option.\n   */\n  smooth?: true | number;\n  /**\n   * The precision for when to consider the tween finished.\n   * Defaults to `0.0001`.\n   */\n  precision?: number;\n  /**\n   * A callback executed on start.\n   */\n  onStart?: (progress: number) => void;\n  /**\n   * A callback executed each time the progress is updated.\n   */\n  onProgress?: (progress: number) => void;\n  /**\n   * A callback executed when the tween is finished.\n   */\n  onFinish?: (progress: number) => void;\n}\n\n/**\n * Normalize a easing function with default fallbacks.\n */\nexport function normalizeEase(ease: EasingFunction | BezierCurve): EasingFunction {\n  if (!isDefined(ease)) {\n    return linear;\n  }\n\n  if (isArray(ease)) {\n    return cubicBezier(...ease);\n  }\n\n  return ease;\n}\n\n/**\n * Tween from 0 to 1.\n */\nexport function tween(callback: (progress: number) => unknown, options: TweenOptions = {}): Tween {\n  const raf = useRaf();\n\n  let progressValue = 0;\n  let easedProgress = 0;\n\n  const isSmooth = isDefined(options.smooth) && (isNumber(options.smooth) || options.smooth);\n  const smoothFactor = isNumber(options.smooth) ? options.smooth : 0.1;\n  const precision = options.precision ?? DEFAULT_PROGRESS_PRECISION;\n  const ease = normalizeEase(options.easing);\n\n  let delay = options.delay ?? 0;\n  delay *= 1000;\n  let duration = options.duration ?? 1;\n  duration *= 1000;\n\n  /* eslint-disable @typescript-eslint/no-use-before-define */\n  let startTime = getStartTime();\n  let endTime = getEndTime(startTime);\n  /* eslint-enable @typescript-eslint/no-use-before-define */\n\n  const key = `tw-${id}`;\n  id += 1;\n\n  const { onStart = noop, onProgress = noop, onFinish = noop } = options;\n  let isRunning = false;\n\n  /**\n   * Pause the animation.\n   */\n  function pause() {\n    isRunning = false;\n    raf.remove(key);\n  }\n\n  /**\n   * Set the progress value.\n   */\n  function progress(newProgress: number) {\n    if (!isDefined(newProgress)) {\n      return easedProgress;\n    }\n\n    progressValue = newProgress;\n    easedProgress = isSmooth\n      ? damp(progressValue, easedProgress, smoothFactor, precision)\n      : ease(progressValue);\n\n    // Stop when reaching precision\n    if (Math.abs(1 - easedProgress) < precision) {\n      progressValue = 1;\n      easedProgress = 1;\n    }\n\n    callback(easedProgress);\n    onProgress(easedProgress);\n\n    if (easedProgress === 1) {\n      pause();\n      requestAnimationFrame(() => onFinish(easedProgress));\n    }\n\n    return easedProgress;\n  }\n\n  /**\n   * Loop for rendering the animation.\n   */\n  function tick(props: { time: number }) {\n    progress(clamp01(map(props.time, startTime, endTime, 0, 1)));\n  }\n\n  function getStartTime() {\n    return performance.now() + delay;\n  }\n\n  function getEndTime(time: number) {\n    return isSmooth ? inertiaFinalValue(time, 1) : time + duration;\n  }\n\n  /**\n   * Play the animation.\n   */\n  function start() {\n    onStart(0);\n    startTime = getStartTime();\n    endTime = getEndTime(startTime);\n    progressValue = 0;\n    easedProgress = 0;\n    isRunning = true;\n\n    raf.add(key, tick);\n  }\n\n  /**\n   * Play a paused animation.\n   */\n  function play() {\n    if (isRunning) {\n      return;\n    }\n\n    startTime = getStartTime() - lerp(0, duration, progressValue);\n    endTime = getEndTime(startTime);\n    isRunning = true;\n\n    raf.add(key, tick);\n  }\n\n  return {\n    start,\n    finish: () => progress(1),\n    pause,\n    play,\n    progress,\n  };\n}\n"],
+  "mappings": "AAAA,SAAS,mBAAmB;AAC5B,SAAS,MAAM,KAAK,SAAS,MAAM,yBAAyB;AAC5D,SAAS,WAAW,SAAS,gBAAgB;AAC7C,SAAS,MAAM,aAAa,cAAc;AAC1C,OAAO,YAAY;AAGnB,IAAI,KAAK;AACT,MAAM,6BAA6B;AAwE5B,SAAS,cAAc,MAAoD;AAChF,MAAI,CAAC,UAAU,IAAI,GAAG;AACpB,WAAO;AAAA,EACT;AAEA,MAAI,QAAQ,IAAI,GAAG;AACjB,WAAO,YAAY,GAAG,IAAI;AAAA,EAC5B;AAEA,SAAO;AACT;AAKO,SAAS,MAAM,UAAyC,UAAwB,CAAC,GAAU;AAChG,QAAM,MAAM,OAAO;AAEnB,MAAI,gBAAgB;AACpB,MAAI,gBAAgB;AAEpB,QAAM,WAAW,UAAU,QAAQ,MAAM,MAAM,SAAS,QAAQ,MAAM,KAAK,QAAQ;AACnF,QAAM,eAAe,SAAS,QAAQ,MAAM,IAAI,QAAQ,SAAS;AACjE,QAAM,YAAY,QAAQ,aAAa;AACvC,QAAM,OAAO,cAAc,QAAQ,MAAM;AAEzC,MAAI,QAAQ,QAAQ,SAAS;AAC7B,WAAS;AACT,MAAI,WAAW,QAAQ,YAAY;AACnC,cAAY;AAGZ,MAAI,YAAY,aAAa;AAC7B,MAAI,UAAU,WAAW,SAAS;AAGlC,QAAM,MAAM,MAAM,EAAE;AACpB,QAAM;AAEN,QAAM,EAAE,UAAU,MAAM,aAAa,MAAM,WAAW,KAAK,IAAI;AAC/D,MAAI,YAAY;AAKhB,WAAS,QAAQ;AACf,gBAAY;AACZ,QAAI,OAAO,GAAG;AAAA,EAChB;AAKA,WAAS,SAAS,aAAqB;AACrC,QAAI,CAAC,UAAU,WAAW,GAAG;AAC3B,aAAO;AAAA,IACT;AAEA,oBAAgB;AAChB,oBAAgB,WACZ,KAAK,eAAe,eAAe,cAAc,SAAS,IAC1D,KAAK,aAAa;AAGtB,QAAI,KAAK,IAAI,IAAI,aAAa,IAAI,WAAW;AAC3C,sBAAgB;AAChB,sBAAgB;AAAA,IAClB;AAEA,aAAS,aAAa;AACtB,eAAW,aAAa;AAExB,QAAI,kBAAkB,GAAG;AACvB,YAAM;AACN,4BAAsB,MAAM,SAAS,aAAa,CAAC;AAAA,IACrD;AAEA,WAAO;AAAA,EACT;AAKA,WAAS,KAAK,OAAyB;AACrC,aAAS,QAAQ,IAAI,MAAM,MAAM,WAAW,SAAS,GAAG,CAAC,CAAC,CAAC;AAAA,EAC7D;AAEA,WAAS,eAAe;AACtB,WAAO,YAAY,IAAI,IAAI;AAAA,EAC7B;AAEA,WAAS,WAAW,MAAc;AAChC,WAAO,WAAW,kBAAkB,MAAM,CAAC,IAAI,OAAO;AAAA,EACxD;AAKA,WAAS,QAAQ;AACf,YAAQ,CAAC;AACT,gBAAY,aAAa;AACzB,cAAU,WAAW,SAAS;AAC9B,oBAAgB;AAChB,oBAAgB;AAChB,gBAAY;AAEZ,QAAI,IAAI,KAAK,IAAI;AAAA,EACnB;AAKA,WAAS,OAAO;AACd,QAAI,WAAW;AACb;AAAA,IACF;AAEA,gBAAY,aAAa,IAAI,KAAK,GAAG,UAAU,aAAa;AAC5D,cAAU,WAAW,SAAS;AAC9B,gBAAY;AAEZ,QAAI,IAAI,KAAK,IAAI;AAAA,EACnB;AAEA,SAAO;AAAA,IACL;AAAA,IACA,QAAQ,MAAM,SAAS,CAAC;AAAA,IACxB;AAAA,IACA;AAAA,IACA;AAAA,EACF;AACF;",
   "names": []
 }

package/Base/Base.cjs

@@ -1,325 +0,0 @@
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-var __publicField = (obj, key, value) => {
-  __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
-  return value;
-};
-
-// packages/js-toolkit/Base/Base.ts
-var Base_exports = {};
-__export(Base_exports, {
-  Base: () => Base
-});
-module.exports = __toCommonJS(Base_exports);
-var import_utils = require("./utils.cjs");
-var import_managers = require("./managers/index.cjs");
-var import_utils2 = require("../utils/index.cjs");
-var id = 0;
-function createAndTestManagers(instance) {
-  [
-    {
-      prop: "__options",
-      constructorName: "OptionsManager",
-      constructor: import_managers.OptionsManager
-    },
-    {
-      prop: "__services",
-      constructorName: "ServicesManager",
-      constructor: import_managers.ServicesManager
-    },
-    {
-      prop: "__events",
-      constructorName: "EventsManager",
-      constructor: import_managers.EventsManager
-    },
-    {
-      prop: "__refs",
-      constructorName: "RefsManager",
-      constructor: import_managers.RefsManager
-    },
-    {
-      prop: "__children",
-      constructorName: "ChildrenManager",
-      constructor: import_managers.ChildrenManager
-    }
-  ].forEach(({ prop, constructorName, constructor }) => {
-    instance[prop] = new instance.__managers[constructorName](instance);
-    if (import_utils2.isDev && !(instance[prop] instanceof constructor)) {
-      throw new Error(
-        `The \`$managers.${constructorName}\` must extend the \`${constructorName}\` class.`
-      );
-    }
-  });
-}
-var Base = class extends EventTarget {
-  $parent = null;
-  $id;
-  $el;
-  $isMounted = false;
-  __eventHandlers = /* @__PURE__ */ new Map();
-  get $root() {
-    if (!this.$parent) {
-      return this;
-    }
-    let parent = this.$parent;
-    let root = this.$parent;
-    while (parent) {
-      if (!parent.$parent) {
-        root = parent;
-      }
-      parent = parent.$parent;
-    }
-    return root;
-  }
-  get __config() {
-    let proto = Object.getPrototypeOf(this);
-    let { config } = proto.constructor;
-    while (proto.constructor.config && proto.constructor.$isBase) {
-      config = { ...proto.constructor.config, ...config };
-      if (proto.constructor.config.options) {
-        config.options = { ...proto.constructor.config.options, ...config.options };
-      }
-      if (proto.constructor.config.emits && config.emits) {
-        config.emits = [...proto.constructor.config.emits, ...config.emits];
-      }
-      proto = Object.getPrototypeOf(proto);
-    }
-    config.options = config.options ?? {};
-    config.refs = config.refs ?? [];
-    config.components = config.components ?? {};
-    return config;
-  }
-  __services;
-  get $services() {
-    return this.__services;
-  }
-  __refs;
-  get $refs() {
-    return this.__refs;
-  }
-  __options;
-  get $options() {
-    return this.__options;
-  }
-  __children;
-  get $children() {
-    return this.__children;
-  }
-  __events;
-  get $log() {
-    return this.__options.log ? window.console.log.bind(window, `[${this.__config.name}]`) : import_utils2.noop;
-  }
-  get $warn() {
-    return this.__options.log ? window.console.warn.bind(window, `[${this.__config.name}]`) : import_utils2.noop;
-  }
-  get __debug() {
-    return import_utils2.isDev && this.__options.debug ? window.console.log.bind(window, `[debug] [${this.$id}]`) : import_utils2.noop;
-  }
-  get __managers() {
-    return {
-      ChildrenManager: import_managers.ChildrenManager,
-      EventsManager: import_managers.EventsManager,
-      OptionsManager: import_managers.OptionsManager,
-      RefsManager: import_managers.RefsManager,
-      ServicesManager: import_managers.ServicesManager
-    };
-  }
-  __callMethod(method, ...args) {
-    if (import_utils2.isDev) {
-      this.__debug("callMethod", method, ...args);
-    }
-    this.$emit(method, ...args);
-    if (!(0, import_utils2.isFunction)(this[method])) {
-      return null;
-    }
-    if (import_utils2.isDev) {
-      this.__debug(method, this, ...args);
-    }
-    return this[method].call(this, ...args);
-  }
-  __hasEvent(event) {
-    const eventHandlers = this.__eventHandlers.get(event);
-    return eventHandlers && eventHandlers.size > 0;
-  }
-  constructor(element) {
-    super();
-    if (!element) {
-      if (import_utils2.isDev) {
-        throw new Error("The root element must be defined.");
-      }
-      return;
-    }
-    const { __config } = this;
-    if (__config.name === "Base") {
-      if (import_utils2.isDev) {
-        throw new Error("The `config.name` property is required.");
-      }
-      return;
-    }
-    this.$id = `${__config.name}-${id}`;
-    id += 1;
-    this.$el = element;
-    if (!this.$el.__base__) {
-      this.$el.__base__ = /* @__PURE__ */ new WeakMap();
-    }
-    this.$el.__base__.set(this.__ctor, this);
-    createAndTestManagers(this);
-    if (import_utils2.isDev) {
-      this.__debug("constructor", this);
-    }
-  }
-  $mount() {
-    if (this.$isMounted) {
-      return this;
-    }
-    this.$emit("before-mounted");
-    if (import_utils2.isDev) {
-      this.__debug("$mount");
-    }
-    [
-      () => this.$children.registerAll(),
-      () => this.$refs.registerAll(),
-      () => this.__events.bindRootElement(),
-      () => this.$services.enableAll(),
-      () => this.$children.mountAll(),
-      () => {
-        this.$isMounted = true;
-      },
-      () => this.__callMethod("mounted")
-    ].forEach(import_utils.addToQueue);
-    return this;
-  }
-  $update() {
-    if (import_utils2.isDev) {
-      this.__debug("$update");
-    }
-    [
-      () => this.$refs.unregisterAll(),
-      () => this.$services.disableAll(),
-      () => this.$children.registerAll(),
-      () => this.$refs.registerAll(),
-      () => this.$services.enableAll(),
-      () => this.$children.updateAll(),
-      () => this.__callMethod("updated")
-    ].forEach(import_utils.addToQueue);
-    return this;
-  }
-  $destroy() {
-    if (!this.$isMounted) {
-      return this;
-    }
-    if (import_utils2.isDev) {
-      this.__debug("$destroy");
-    }
-    [
-      () => {
-        this.$isMounted = false;
-      },
-      () => this.__events.unbindRootElement(),
-      () => this.$refs.unregisterAll(),
-      () => this.$services.disableAll(),
-      () => this.$children.destroyAll(),
-      () => this.__callMethod("destroyed")
-    ].forEach(import_utils.addToQueue);
-    return this;
-  }
-  $terminate() {
-    if (import_utils2.isDev) {
-      this.__debug("$terminate");
-    }
-    [
-      () => this.$destroy(),
-      () => this.__callMethod("terminated"),
-      () => this.$el.__base__.set(this.__ctor, "terminated")
-    ].forEach(import_utils.addToQueue);
-  }
-  __addEmits(event) {
-    const ctor = this.__ctor;
-    if ((0, import_utils2.isArray)(ctor.config.emits)) {
-      ctor.config.emits.push(event);
-    } else {
-      ctor.config.emits = [event];
-    }
-  }
-  __removeEmits(event) {
-    const ctor = this.__ctor;
-    const index = ctor.config.emits.indexOf(event);
-    ctor.config.emits.splice(index, 1);
-  }
-  get __ctor() {
-    return this.constructor;
-  }
-  $on(event, listener, options) {
-    if (import_utils2.isDev) {
-      this.__debug("$on", event, listener, options);
-    }
-    let set = this.__eventHandlers.get(event);
-    if (!set) {
-      set = /* @__PURE__ */ new Set();
-      this.__eventHandlers.set(event, set);
-    }
-    set.add(listener);
-    const target = (0, import_utils.getEventTarget)(this, event, this.__config);
-    target.addEventListener(event, listener, options);
-    return () => {
-      this.$off(event, listener, options);
-    };
-  }
-  $off(event, listener, options) {
-    if (import_utils2.isDev) {
-      this.__debug("$off", event, listener);
-    }
-    this.__eventHandlers.get(event).delete(listener);
-    const target = (0, import_utils.getEventTarget)(this, event, this.__config);
-    target.removeEventListener(event, listener, options);
-  }
-  $emit(event, ...args) {
-    if (import_utils2.isDev) {
-      this.__debug("$emit", event, args);
-    }
-    this.dispatchEvent(new CustomEvent(event, { detail: args }));
-  }
-  static $factory(nameOrSelector) {
-    if (import_utils2.isDev && !nameOrSelector) {
-      throw new Error(
-        "The $factory method requires a component\u2019s name or selector to be specified."
-      );
-    }
-    return (0, import_utils.getComponentElements)(nameOrSelector).map((el) => new this(el).$mount());
-  }
-};
-__publicField(Base, "$isBase", true);
-__publicField(Base, "config", {
-  name: "Base",
-  emits: [
-    "before-mounted",
-    "mounted",
-    "updated",
-    "destroyed",
-    "terminated",
-    "ticked",
-    "scrolled",
-    "resized",
-    "moved",
-    "loaded",
-    "keyed"
-  ]
-});
-if (module.exports.default) module.exports = module.exports.default;
-//# sourceMappingURL=Base.cjs.map