@blackbyte/sugar 1.0.0-beta.1

package/dist/js/keyboard/hotkey.js

@@ -0,0 +1,119 @@
+/**
+ * @name 		            hotkey
+ * @namespace           js.keyboard
+ * @type                Function
+ * @platform            js
+ * @status              stable
+ *
+ * This function allows you to register a hotkey on the passed element.
+ * You can specify the hotkey using the following syntax:
+ * - ctrl+a
+ * - shift+ctrl+a
+ * - a
+ * This function take care of avoiding to call your callback when the active element
+ * is an input, a textarea or an editable content with the "contenteditable" attribute,
+ * unless:
+ * - the "meta" or "ctrl" key is used in the hotkey.
+ * - the pressed key is the "escape" key.
+ *
+ *
+ * @param       {String|String[]}         key             The key(s) to listen for
+ * @param       {Function}                callback        The callback to call when the hotkey is pressed
+ * @param       {THotkeySettings}         [settings={}]   Some settings to configure your hotkey
+ * @return      {THotkeyApi}                              An object with a cancel method that you can call to cancel the hotkey
+ *
+ * @setting    {HTMLElement}       [ctx=document.body]       The context in which to listen for the hotkey
+ * @setting    {Boolean}           [preventDefault=true]    Specify if you want to prevent the default behavior of the hotkey
+ *
+ * @todo      tests
+ *
+ * @snippet         hotkey($1, () => {
+ *      $2
+ * });
+ *
+ * @example    js
+ * import { hotkey } from '@blackbyte/sugar/keyboard'
+ * const hotkeyApi = hotkey('ctrl+a', (e) => {
+ *  console.log('Hotkey pressed');
+ * });
+ *
+ * // if you want to cancel the hotkey
+ * hotkeyApi.cancel();
+ *
+ * @since       1.0.0
+ * @author    Olivier Bossel <olivier.bossel@gmail.com> (https://blackbyte.space)
+ */
+export default function hotkey(key, callback, settings) {
+    const finalSettings = Object.assign({ ctx: document.body, preventDefault: true }, (settings !== null && settings !== void 0 ? settings : {}));
+    // multiple keys
+    if (Array.isArray(key)) {
+        const hotkeyApis = key.map((k) => {
+            return hotkey(k, callback, settings);
+        });
+        return {
+            cancel: () => {
+                hotkeyApis.forEach((api) => {
+                    api.cancel();
+                });
+            },
+        };
+    }
+    const keys = key.split('+').map((k) => {
+        if (k === 'command' || k === 'cmd') {
+            return 'meta';
+        }
+        if (k === 'escape' || k === 'esc') {
+            return 'Escape';
+        }
+        return k;
+    }), finalKey = keys[keys.length - 1];
+    const specialKeys = ['shift', 'ctrl', 'alt', 'meta'];
+    const isMultipleSpecialKeys = keys.filter((k) => specialKeys.includes(k)).length > 1;
+    const _handler = (e) => {
+        // handle the active element.
+        // if it is an input, textarea, etc... and the hotkey does not
+        // include the meta key, then return
+        const $activeElement = document.activeElement;
+        if (($activeElement === null || $activeElement === void 0 ? void 0 : $activeElement.tagName) === 'INPUT' ||
+            ($activeElement === null || $activeElement === void 0 ? void 0 : $activeElement.tagName) === 'TEXTAREA' ||
+            ($activeElement === null || $activeElement === void 0 ? void 0 : $activeElement.hasAttribute('contenteditable'))) {
+            if (!keys.includes('meta') &&
+                !keys.includes('ctrl') &&
+                finalKey !== 'Escape') {
+                return;
+            }
+        }
+        // handle the final key
+        if (e.key !== finalKey) {
+            return;
+        }
+        // handle the other keys (ctrl, shift, etc...)
+        let multipleSpecialKeys = [e.shiftKey, e.ctrlKey, e.altKey, e.metaKey].filter((k) => k).length >
+            1, hasSpecialKeys = e.shiftKey || e.ctrlKey || e.altKey || e.metaKey;
+        if (keys.length > 1 && !hasSpecialKeys) {
+            return;
+        }
+        if (isMultipleSpecialKeys && !multipleSpecialKeys) {
+            return;
+        }
+        if ((e.ctrlKey && !keys.includes('ctrl')) ||
+            (e.metaKey && !keys.includes('meta')) ||
+            (e.altKey && !keys.includes('alt')) ||
+            (e.shiftKey && !keys.includes('shift'))) {
+            return;
+        }
+        // prevent default if needed
+        if (finalSettings.preventDefault) {
+            e.preventDefault();
+        }
+        // call the callback
+        callback(e);
+    };
+    finalSettings.ctx.addEventListener('keydown', _handler);
+    return {
+        cancel: () => {
+            finalSettings.ctx.removeEventListener('keydown', _handler);
+        },
+    };
+}
+//# sourceMappingURL=hotkey.js.map

package/dist/js/keyboard/hotkey.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hotkey.js","sourceRoot":"","sources":["../../../src/js/keyboard/hotkey.ts"],"names":[],"mappings":"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"}

package/dist/js/scroll/_exports.d.ts

@@ -0,0 +1,3 @@
+import scrollSpy from './scrollSpy.js';
+import scrollTo from './scrollTo.js';
+export { scrollSpy as __scrollSpy, scrollTo as __scrollTo, scrollSpy, scrollTo, };

package/dist/js/scroll/_exports.js

@@ -0,0 +1,4 @@
+import scrollSpy from './scrollSpy.js';
+import scrollTo from './scrollTo.js';
+export { scrollSpy as __scrollSpy, scrollTo as __scrollTo, scrollSpy, scrollTo, };
+//# sourceMappingURL=_exports.js.map

package/dist/js/scroll/_exports.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"_exports.js","sourceRoot":"","sources":["../../../src/js/scroll/_exports.ts"],"names":[],"mappings":"AAAA,OAAO,SAAS,MAAM,gBAAgB,CAAC;AACvC,OAAO,QAAQ,MAAM,eAAe,CAAC;AAErC,OAAO,EACL,SAAS,IAAI,WAAW,EACxB,QAAQ,IAAI,UAAU,EACtB,SAAS,EACT,QAAQ,GACT,CAAC"}

package/dist/js/scroll/onScrollEnd.d.ts

@@ -0,0 +1,43 @@
+/**
+ * @name            onScrollEnd
+ * @namespace       js.dom.scroll
+ * @type            Function
+ * @platform        js
+ * @status          stable
+ * @async
+ *
+ * This function simply listen for scroll on the passed element and call the passed callback
+ * when reaching the end of it.
+ *
+ * @param       {HTMLElement}           $elm        The element to listen on
+ * @param       {Function}              callback        The function to call when scroll end is detected
+ * @param       {TOnScrollEndSettings}      [settings={}]       Some settings like offset, etc...
+ *
+ * @setting         {Number}        [offset=20]             An offset to detect earlier the end of the scroll
+ * @setting         {boolean}       [once=false]            true if you want to detect the scroll end just once
+ * @setting         {number}        [times=-1]              Specify a number of times to detect the scroll end
+ *
+ * @todo      tests
+ *
+ * @snippet         __onScrollEnd($1, $2)
+ * __onScrollEnd($1, () => {
+ *      $2
+ * });
+ *
+ * @example         js
+ * import { __onScrollEnd } from '@blackbyte/sugar/scroll';
+ * __onScrollEnd($elm, () => {
+ *      // do something
+ * }, {
+ *    offset: 50
+ * });
+ *
+ * @since       1.0.0
+ * @author         Olivier Bossel <olivier.bossel@gmail.com> (https://blackbyte.space)
+ */
+export type TOnScrollEndSettings = {
+    offset: number;
+    once: boolean;
+    times: number;
+};
+export default function __onScrollEnd($elm: any, callback: Function, settings?: TOnScrollEndSettings): void;

package/dist/js/scroll/onScrollEnd.js

@@ -0,0 +1,49 @@
+export default function __onScrollEnd($elm, callback, settings) {
+    const finalSettings = Object.assign({ offset: 20, once: false, times: -1 }, (settings !== null && settings !== void 0 ? settings : {}));
+    let isBody = false;
+    let $scrollListenedElm = $elm;
+    let $scrollHeightElm = $elm;
+    if ($elm === window.document.body) {
+        isBody = true;
+        $scrollListenedElm = document;
+        $scrollHeightElm = window.document.body;
+    }
+    else if ($elm === window.document) {
+        isBody = true;
+        $elm = window.document.body;
+        $scrollHeightElm = window.document.body;
+    }
+    let active = true, count = 0;
+    const internalCallback = (e) => {
+        let fullHeight, viewportHeight, scrollTop;
+        if (isBody) {
+            viewportHeight = window.innerHeight;
+            scrollTop = $scrollHeightElm.scrollTop;
+            fullHeight = Math.max(window.document.body.scrollHeight, window.document.documentElement.scrollHeight, window.document.body.offsetHeight, window.document.documentElement.offsetHeight, window.document.body.clientHeight, window.document.documentElement.clientHeight);
+        }
+        else {
+            viewportHeight = $scrollHeightElm.offsetHeight;
+            scrollTop = $scrollHeightElm.scrollTop;
+            fullHeight = $scrollHeightElm.scrollHeight;
+        }
+        if (active &&
+            scrollTop + viewportHeight >= fullHeight - finalSettings.offset) {
+            callback();
+            count++;
+            if (finalSettings.once) {
+                $scrollListenedElm.removeEventListener('scroll', internalCallback);
+                active = false;
+            }
+            else if (finalSettings.times > 0 && count >= finalSettings.times) {
+                $scrollListenedElm.removeEventListener('scroll', internalCallback);
+                active = false;
+            }
+        }
+        else if ($scrollHeightElm.offsetHeight + $scrollHeightElm.scrollTop <
+            $scrollHeightElm.scrollHeight - finalSettings.offset) {
+            active = true;
+        }
+    };
+    $scrollListenedElm.addEventListener('scroll', internalCallback);
+}
+//# sourceMappingURL=onScrollEnd.js.map

package/dist/js/scroll/onScrollEnd.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"onScrollEnd.js","sourceRoot":"","sources":["../../../src/js/scroll/onScrollEnd.ts"],"names":[],"mappings":"AA2CA,MAAM,CAAC,OAAO,UAAU,aAAa,CACnC,IAAS,EACT,QAAkB,EAClB,QAA+B;IAE/B,MAAM,aAAa,mBACjB,MAAM,EAAE,EAAE,EACV,IAAI,EAAE,KAAK,EACX,KAAK,EAAE,CAAC,CAAC,IACN,CAAC,QAAQ,aAAR,QAAQ,cAAR,QAAQ,GAAI,EAAE,CAAC,CACpB,CAAC;IAEF,IAAI,MAAM,GAAG,KAAK,CAAC;IAEnB,IAAI,kBAAkB,GAAG,IAAI,CAAC;IAC9B,IAAI,gBAAgB,GAAG,IAAI,CAAC;IAC5B,IAAI,IAAI,KAAK,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;QAClC,MAAM,GAAG,IAAI,CAAC;QACd,kBAAkB,GAAG,QAAQ,CAAC;QAC9B,gBAAgB,GAAG,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC;IAC1C,CAAC;SAAM,IAAI,IAAI,KAAK,MAAM,CAAC,QAAQ,EAAE,CAAC;QACpC,MAAM,GAAG,IAAI,CAAC;QACd,IAAI,GAAG,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC;QAC5B,gBAAgB,GAAG,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC;IAC1C,CAAC;IAED,IAAI,MAAM,GAAG,IAAI,EACf,KAAK,GAAG,CAAC,CAAC;IAEZ,MAAM,gBAAgB,GAAG,CAAC,CAAC,EAAE,EAAE;QAC7B,IAAI,UAAU,EAAE,cAAc,EAAE,SAAS,CAAC;QAC1C,IAAI,MAAM,EAAE,CAAC;YACX,cAAc,GAAG,MAAM,CAAC,WAAW,CAAC;YACpC,SAAS,GAAG,gBAAgB,CAAC,SAAS,CAAC;YACvC,UAAU,GAAG,IAAI,CAAC,GAAG,CACnB,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,YAAY,EACjC,MAAM,CAAC,QAAQ,CAAC,eAAe,CAAC,YAAY,EAC5C,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,YAAY,EACjC,MAAM,CAAC,QAAQ,CAAC,eAAe,CAAC,YAAY,EAC5C,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,YAAY,EACjC,MAAM,CAAC,QAAQ,CAAC,eAAe,CAAC,YAAY,CAC7C,CAAC;QACJ,CAAC;aAAM,CAAC;YACN,cAAc,GAAG,gBAAgB,CAAC,YAAY,CAAC;YAC/C,SAAS,GAAG,gBAAgB,CAAC,SAAS,CAAC;YACvC,UAAU,GAAG,gBAAgB,CAAC,YAAY,CAAC;QAC7C,CAAC;QAED,IACE,MAAM;YACN,SAAS,GAAG,cAAc,IAAI,UAAU,GAAG,aAAa,CAAC,MAAM,EAC/D,CAAC;YACD,QAAQ,EAAE,CAAC;YACX,KAAK,EAAE,CAAC;YACR,IAAI,aAAa,CAAC,IAAI,EAAE,CAAC;gBACvB,kBAAkB,CAAC,mBAAmB,CAAC,QAAQ,EAAE,gBAAgB,CAAC,CAAC;gBACnE,MAAM,GAAG,KAAK,CAAC;YACjB,CAAC;iBAAM,IAAI,aAAa,CAAC,KAAK,GAAG,CAAC,IAAI,KAAK,IAAI,aAAa,CAAC,KAAK,EAAE,CAAC;gBACnE,kBAAkB,CAAC,mBAAmB,CAAC,QAAQ,EAAE,gBAAgB,CAAC,CAAC;gBACnE,MAAM,GAAG,KAAK,CAAC;YACjB,CAAC;QACH,CAAC;aAAM,IACL,gBAAgB,CAAC,YAAY,GAAG,gBAAgB,CAAC,SAAS;YAC1D,gBAAgB,CAAC,YAAY,GAAG,aAAa,CAAC,MAAM,EACpD,CAAC;YACD,MAAM,GAAG,IAAI,CAAC;QAChB,CAAC;IACH,CAAC,CAAC;IAEF,kBAAkB,CAAC,gBAAgB,CAAC,QAAQ,EAAE,gBAAgB,CAAC,CAAC;AAClE,CAAC"}

package/dist/js/scroll/scrollSpy.d.ts

@@ -0,0 +1,29 @@
+/**
+ * @name            scrollSpy
+ * @namespace       js.scroll
+ * @type            Function
+ * @platform        js
+ * @status          stable
+ *
+ * This function allows you to add/remove automatically the `-active` class on
+ * some passed links that have a `href` attribute that points to an element on the page.
+ *
+ * @param           {TScrollSpySettings}          [settings={}]         The settings you want to override
+ *
+ * @setting        {number}        [offset=window.innerHeight/2]        The offset you want before adding the classes
+ * @setting        {string}        [activeClass=-active]                The class name you want to add/remove
+ *
+ * @snippet          scrollSpy($1);
+ *
+ * @example         js
+ * import { scrollSpy } from '@blackbyte/sugar/scroll';
+ * scrollSpy($myLinks);
+ *
+ * @since       1.0.0
+ * @author         Olivier Bossel <olivier.bossel@gmail.com> (https://blackbyte.space)
+ */
+export type TScrollSpySettings = {
+    offset?: number;
+    activeClass?: string;
+};
+export default function scrollSpy($links: NodeListOf<HTMLAnchorElement>, settings?: TScrollSpySettings): void;

package/dist/js/scroll/scrollSpy.js

@@ -0,0 +1,29 @@
+export default function scrollSpy($links, settings) {
+    const finalSettings = Object.assign({ offset: window.innerHeight / 2, activeClass: '-active' }, (settings !== null && settings !== void 0 ? settings : {}));
+    const reversedLinks = Array.from($links).reverse(), targets = new WeakMap();
+    for (let [i, $link] of reversedLinks.entries()) {
+        const $elm = document.querySelector($link.getAttribute('href'));
+        targets.set($link, $elm);
+    }
+    function handleScroll() {
+        let found = false;
+        for (let [i, $link] of reversedLinks.entries()) {
+            const $target = targets.get($link), bound = $target.getBoundingClientRect();
+            if (found) {
+                $link.classList.remove(finalSettings.activeClass);
+                continue;
+            }
+            if (bound.top <= finalSettings.offset) {
+                $link.classList.add(finalSettings.activeClass);
+                found = true;
+            }
+            else {
+                $link.classList.remove(finalSettings.activeClass);
+            }
+        }
+    }
+    document.addEventListener('scroll', () => {
+        handleScroll();
+    });
+}
+//# sourceMappingURL=scrollSpy.js.map

package/dist/js/scroll/scrollSpy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scrollSpy.js","sourceRoot":"","sources":["../../../src/js/scroll/scrollSpy.ts"],"names":[],"mappings":"AA6BA,MAAM,CAAC,OAAO,UAAU,SAAS,CAC/B,MAAqC,EACrC,QAA6B;IAE7B,MAAM,aAAa,mBACjB,MAAM,EAAE,MAAM,CAAC,WAAW,GAAG,CAAC,EAC9B,WAAW,EAAE,SAAS,IACnB,CAAC,QAAQ,aAAR,QAAQ,cAAR,QAAQ,GAAI,EAAE,CAAC,CACpB,CAAC;IAEF,MAAM,aAAa,GAAG,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAChD,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;IAE1B,KAAK,IAAI,CAAC,CAAC,EAAE,KAAK,CAAC,IAAI,aAAa,CAAC,OAAO,EAAE,EAAE,CAAC;QAC/C,MAAM,IAAI,GAAG,QAAQ,CAAC,aAAa,CAAC,KAAK,CAAC,YAAY,CAAC,MAAM,CAAW,CAAC,CAAC;QAC1E,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,IAAmB,CAAC,CAAC;IAC1C,CAAC;IAED,SAAS,YAAY;QACnB,IAAI,KAAK,GAAG,KAAK,CAAC;QAClB,KAAK,IAAI,CAAC,CAAC,EAAE,KAAK,CAAC,IAAI,aAAa,CAAC,OAAO,EAAE,EAAE,CAAC;YAC/C,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,EAChC,KAAK,GAAG,OAAO,CAAC,qBAAqB,EAAE,CAAC;YAE1C,IAAI,KAAK,EAAE,CAAC;gBACV,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC,aAAa,CAAC,WAAW,CAAC,CAAC;gBAClD,SAAS;YACX,CAAC;YAED,IAAI,KAAK,CAAC,GAAG,IAAI,aAAa,CAAC,MAAM,EAAE,CAAC;gBACtC,KAAK,CAAC,SAAS,CAAC,GAAG,CAAC,aAAa,CAAC,WAAW,CAAC,CAAC;gBAC/C,KAAK,GAAG,IAAI,CAAC;YACf,CAAC;iBAAM,CAAC;gBACN,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC,aAAa,CAAC,WAAW,CAAC,CAAC;YACpD,CAAC;QACH,CAAC;IACH,CAAC;IAED,QAAQ,CAAC,gBAAgB,CAAC,QAAQ,EAAE,GAAG,EAAE;QACvC,YAAY,EAAE,CAAC;IACjB,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/js/scroll/scrollTo.d.ts

@@ -0,0 +1,57 @@
+/**
+ * @name                scrollTo
+ * @namespace           js.dom.scroll
+ * @type                Function
+ * @platform            js
+ * @status              beta
+ * @async
+ *
+ * Function that let you make a smooth page scroll to a specific element in the page
+ *
+ * @feature       Promise based API
+ * @feature       Tweak the scroll behavior like duration, easing, etc...
+ *
+ * @param 		{HTMLElement} 				target 			The element to scroll to
+ * @param       {IScrollToSettings}     [settings={}]       Some settings to tweak the scroll behavior
+ * @return      {Promise}           A promise resolved once the scroll has ended
+ *
+ * @setting     {HTMLElement} 				[$elm=window] 			      The element to scroll
+ * @setting 		{Number} 					    [duration=1000] 		      The animation duration
+ * @setting 		{Function} 					  [easing=easeInOutQuad] 	  An easing Function
+ * @setting     {Number}              [offsetX=0]               An offset to apply on the X axis
+ * @setting     {Number}              [offsetY=0]               An offset to apply on the Y axis
+ * @setting 		{String} 					    [align='start'] 			    The destination align (start, center, end)
+ * @setting 		{String} 					    [justify='start'] 			  The destination justify (start, center, end)
+ * @setting 		{Boolean} 					  [force=false] 			      Force the scroll even if the user is scrolling
+ * @setting 		{Function} 					  [onFinish=null] 		      A callback to call when the animation if finished
+ *
+ * @snippet         __scrollTo($1)
+ *
+ * @todo      interface
+ * @todo      doc
+ * @todo      tests
+ *
+ * @example 	js
+ * import { __scrollTop } from '@coffeekraken/sugar/dom'
+ * import { easeInOutQuad } from '@coffeekraken/sugar/easing'
+ * __scrollTo(myCoolHTMLElement);
+ *
+ * @since           2.0.0
+ * @author         Olivier Bossel <olivier.bossel@gmail.com> (https://blackbyte.space)
+ */
+export interface IScrollToSettings {
+    $elm: HTMLElement | typeof window | typeof document;
+    duration: number;
+    easing: Function;
+    offsetX: number;
+    offsetY: number;
+    align: 'start' | 'center' | 'end';
+    justify: 'start' | 'center' | 'end';
+    force: boolean;
+    onFinish?: Function;
+}
+declare function __scrollTo(target: HTMLElement | 'top' | 'bottom' | 'left' | 'right', settings?: Partial<IScrollToSettings>): Promise<any>;
+declare namespace __scrollTo {
+    var step: () => void;
+}
+export default __scrollTo;

package/dist/js/scroll/scrollTo.js

@@ -0,0 +1,169 @@
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+// @ts-nocheck
+import easeInOutQuad from '../../shared/easing/easeInOutQuad.js';
+import isUserScrolling from '../is/isUserScrolling.js';
+export default function __scrollTo(target, settings = {}) {
+    return new Promise((resolve, reject) => __awaiter(this, void 0, void 0, function* () {
+        var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l;
+        const finalSettings = Object.assign({ $elm: window, duration: 500, easing: easeInOutQuad, offsetX: 0, offsetY: 0, align: 'start', justify: 'start', force: false }, settings);
+        // remap element if needed
+        if (finalSettings.$elm === document.body)
+            finalSettings.$elm = window;
+        if (finalSettings.$elm === document)
+            finalSettings.$elm = window;
+        if (finalSettings.$elm === document.querySelector('html'))
+            finalSettings.$elm = window;
+        const $scrollElm = finalSettings.$elm === window ? document.body : finalSettings.$elm;
+        let elmHeight = finalSettings.$elm === window
+            ? window.innerHeight
+            : finalSettings.$elm.offsetHeight;
+        let elmWidth = finalSettings.$elm === window
+            ? window.innerWidth
+            : finalSettings.$elm.offsetWidth;
+        let elmTop = finalSettings.$elm === window
+            ? 0
+            : (_a = finalSettings.$elm) === null || _a === void 0 ? void 0 : _a.getBoundingClientRect().top;
+        let elmLeft = finalSettings.$elm === window
+            ? 0
+            : (_b = finalSettings.$elm) === null || _b === void 0 ? void 0 : _b.getBoundingClientRect().left;
+        let maxScrollY = $scrollElm.scrollHeight - elmHeight;
+        let maxScrollX = $scrollElm.scrollWidth - elmWidth;
+        const currentY = finalSettings.$elm === window
+            ? window.pageYOffset
+            : (_c = finalSettings.$elm) === null || _c === void 0 ? void 0 : _c.scrollTop;
+        const currentX = finalSettings.$elm === window
+            ? window.pageXOffset
+            : (_d = finalSettings.$elm) === null || _d === void 0 ? void 0 : _d.scrollLeft;
+        // handle paddings
+        if (finalSettings.$elm !== window) {
+            const computedScrollStyles = window.getComputedStyle(finalSettings.$elm);
+            maxScrollY += parseInt(computedScrollStyles.paddingTop);
+            maxScrollY += parseInt(computedScrollStyles.paddingBottom);
+            maxScrollX += parseInt(computedScrollStyles.paddingLeft);
+            maxScrollX += parseInt(computedScrollStyles.paddingRight);
+        }
+        let targetY = currentY, targetX = currentX;
+        let targetBounds;
+        try {
+            if (window.getComputedStyle(target).display === 'none') {
+                target.style.display = 'block';
+            }
+            targetBounds = target.getBoundingClientRect();
+            target.style.display = null;
+        }
+        catch (e) {
+            targetBounds = {
+                top: 0,
+                left: 0,
+                right: 0,
+                bottom: 0,
+            };
+        }
+        const offsetY = (_e = finalSettings.offsetY) !== null && _e !== void 0 ? _e : 0;
+        const offsetX = (_f = finalSettings.offsetX) !== null && _f !== void 0 ? _f : 0;
+        if (target === 'top') {
+            targetY = 0;
+        }
+        else if (target === 'bottom') {
+            targetY =
+                (_h = (_g = finalSettings.$elm) === null || _g === void 0 ? void 0 : _g.scrollHeight) !== null && _h !== void 0 ? _h : document.documentElement.scrollHeight;
+        }
+        if (target === 'left') {
+            targetX = 0;
+        }
+        else if (target === 'right') {
+            targetY =
+                (_k = (_j = finalSettings.$elm) === null || _j === void 0 ? void 0 : _j.scrollWidth) !== null && _k !== void 0 ? _k : document.documentElement.scrollWidth;
+        }
+        // y
+        if (finalSettings.align === 'center') {
+            targetY += targetBounds.top + targetBounds.height / 2;
+            targetY -= elmHeight / 2;
+            targetY -= offsetY;
+        }
+        else if (finalSettings.align === 'end') {
+            targetY += targetBounds.bottom;
+            targetY -= elmHeight;
+            targetY += offsetY;
+        }
+        else {
+            // start, undefined
+            targetY += targetBounds.top;
+            targetY -= offsetY;
+        }
+        targetY = Math.max(Math.min(maxScrollY, targetY), 0);
+        const deltaY = targetY - currentY - elmTop;
+        // x
+        if (finalSettings.justify === 'center') {
+            targetX += targetBounds.left + targetBounds.width / 2;
+            targetX -= elmWidth / 2;
+            targetX -= offsetX;
+        }
+        else if (finalSettings.justify === 'end') {
+            targetX += targetBounds.right;
+            targetX -= elmWidth;
+            targetX += offsetX;
+        }
+        else {
+            // start, undefined
+            targetX += targetBounds.left;
+            targetX -= offsetX;
+        }
+        targetX = Math.max(Math.min(maxScrollX, targetX), 0);
+        const deltaX = targetX - currentX - elmLeft;
+        // element position
+        if ((_l = finalSettings.$elm) === null || _l === void 0 ? void 0 : _l.getBoundingClientRect) {
+            const elmBounds = finalSettings.$elm.getBoundingClientRect();
+            targetY -= elmBounds.top;
+            targetX -= elmBounds.left;
+        }
+        const obj = {
+            targetY,
+            targetX,
+            deltaY,
+            deltaX,
+            currentY,
+            currentX,
+            duration: finalSettings.duration,
+            easing: finalSettings.easing,
+            force: finalSettings.force,
+            $elm: finalSettings.$elm,
+            onFinish() {
+                finalSettings.onFinish && finalSettings.onFinish();
+                resolve();
+            },
+            startTime: Date.now(),
+            step: __scrollTo.step,
+        };
+    }));
+}
+__scrollTo.step = function () {
+    // Calculate how much time has passed
+    const t = Math.min((Date.now() - this.startTime) / this.duration, 1);
+    let $scrollElm = this.$elm;
+    if (this.$elm === document.body || this.$elm === document) {
+        $scrollElm = window;
+    }
+    // Scroll window amount determined by easing
+    const x = this.targetX - (1 - this.easing(t)) * this.deltaX;
+    const y = this.targetY - (1 - this.easing(t)) * this.deltaY;
+    $scrollElm.scrollTo(x, y);
+    if (!this.force && isUserScrolling(this.$elm))
+        return;
+    // Continue animation as long as duration hasn't surpassed
+    if (t !== 1) {
+    }
+    else {
+        if (this.onFinish)
+            this.onFinish();
+    }
+};
+//# sourceMappingURL=scrollTo.js.map

package/dist/js/scroll/scrollTo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scrollTo.js","sourceRoot":"","sources":["../../../src/js/scroll/scrollTo.ts"],"names":[],"mappings":"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"}

package/dist/js/string/_exports.d.ts

@@ -0,0 +1,3 @@
+import uniqid from './uniqid.js';
+export * from '../../shared/string/_exports.js';
+export { uniqid as __uniqid, uniqid };

package/dist/js/string/_exports.js

@@ -0,0 +1,4 @@
+import uniqid from './uniqid.js';
+export * from '../../shared/string/_exports.js';
+export { uniqid as __uniqid, uniqid };
+//# sourceMappingURL=_exports.js.map

package/dist/js/string/_exports.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"_exports.js","sourceRoot":"","sources":["../../../src/js/string/_exports.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,aAAa,CAAC;AAEjC,cAAc,iCAAiC,CAAC;AAChD,OAAO,EAAE,MAAM,IAAI,QAAQ,EAAE,MAAM,EAAE,CAAC"}

package/dist/js/string/uniqid.d.ts

@@ -0,0 +1,25 @@
+import { v4 as uuidv4 } from 'uuid';
+/**
+ * @name            uniqid
+ * @namespace       js.string
+ * @type            Function
+ * @platform        js
+ * @status          stable
+ * @async
+ *
+ * This function simply returns you a unique id
+ *
+ * @return          {String}            A uniqid
+ *
+ * @todo      tests
+ *
+ * @snippet         uniqid()
+ *
+ * @example         js
+ * import { uniqid } from '@blackbyte/sugar/string';
+ * const id = uniqid();
+ *
+ * @since       1.0.0
+ * @author         Olivier Bossel <olivier.bossel@gmail.com> (https://blackbyte.space)
+ */
+export default uuidv4;

package/dist/js/string/uniqid.js

@@ -0,0 +1,26 @@
+import { v4 as uuidv4 } from 'uuid';
+/**
+ * @name            uniqid
+ * @namespace       js.string
+ * @type            Function
+ * @platform        js
+ * @status          stable
+ * @async
+ *
+ * This function simply returns you a unique id
+ *
+ * @return          {String}            A uniqid
+ *
+ * @todo      tests
+ *
+ * @snippet         uniqid()
+ *
+ * @example         js
+ * import { uniqid } from '@blackbyte/sugar/string';
+ * const id = uniqid();
+ *
+ * @since       1.0.0
+ * @author         Olivier Bossel <olivier.bossel@gmail.com> (https://blackbyte.space)
+ */
+export default uuidv4;
+//# sourceMappingURL=uniqid.js.map

package/dist/js/string/uniqid.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"uniqid.js","sourceRoot":"","sources":["../../../src/js/string/uniqid.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,IAAI,MAAM,EAAE,MAAM,MAAM,CAAC;AAEpC;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,eAAe,MAAM,CAAC"}

package/dist/js/theme/_exports.d.ts

@@ -0,0 +1,4 @@
+import getTheme from './getTheme.js';
+import restoreTheme from './restoreTheme.js';
+import setTheme from './setTheme.js';
+export { getTheme as __getTheme, restoreTheme as __restoreTheme, setTheme as __setTheme, getTheme, restoreTheme, setTheme, };

package/dist/js/theme/_exports.js

@@ -0,0 +1,5 @@
+import getTheme from './getTheme.js';
+import restoreTheme from './restoreTheme.js';
+import setTheme from './setTheme.js';
+export { getTheme as __getTheme, restoreTheme as __restoreTheme, setTheme as __setTheme, getTheme, restoreTheme, setTheme, };
+//# sourceMappingURL=_exports.js.map

package/dist/js/theme/_exports.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"_exports.js","sourceRoot":"","sources":["../../../src/js/theme/_exports.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,MAAM,eAAe,CAAC;AACrC,OAAO,YAAY,MAAM,mBAAmB,CAAC;AAC7C,OAAO,QAAQ,MAAM,eAAe,CAAC;AAErC,OAAO,EACL,QAAQ,IAAI,UAAU,EACtB,YAAY,IAAI,cAAc,EAC9B,QAAQ,IAAI,UAAU,EACtB,QAAQ,EACR,YAAY,EACZ,QAAQ,GACT,CAAC"}