@blackbyte/sugar 1.0.0-beta.1

package/dist/js/dom/css/reloadStylesheets.d.ts

@@ -0,0 +1,26 @@
+/**
+ * @name            reloadStylesheets
+ * @namespace       js.dom.css
+ * @type            Function
+ * @platform        js
+ * @status          stable
+ *
+ * This function just loop on each "link" tags that point to some css files
+ * and reload them by adding a "queryString" with the timestamp in it
+ * to prevent caching
+ *
+ * @param       {HTMLElement}           [$root=document]            The root element in which to reload the stylesheets
+ *
+ * @snippet         reloadStylesheets()
+ *
+ * @example         js
+ * import { __reloeadStylesheets } from '@blackbyte/sugar/dom';
+ * reloadStylesheets();
+ *
+ * @since       1.0.0
+ * @author    Olivier Bossel <olivier.bossel@gmail.com> (https://blackbyte.space)
+ */
+export type TReloadStylesheetsSettings = {
+    $root: HTMLElement | Document;
+};
+export default function reloadStylesheets(settings?: Partial<TReloadStylesheetsSettings>): void;

package/dist/js/dom/css/reloadStylesheets.js

@@ -0,0 +1,26 @@
+import uniqid from '../../string/uniqid.js';
+export default function reloadStylesheets(settings) {
+    var _a;
+    const finalSettings = Object.assign({ $root: document }, (settings !== null && settings !== void 0 ? settings : {}));
+    // loop on all stylesheetgs link and add the timestamp in
+    Array.from((_a = finalSettings.$root.querySelectorAll('link[rel=stylesheet]')) !== null && _a !== void 0 ? _a : []).forEach(($link) => {
+        var _a;
+        const id = (_a = $link.id) !== null && _a !== void 0 ? _a : uniqid();
+        // clone the link element
+        const $newLink = $link.cloneNode();
+        $newLink.href = $link.href.replace(/\?.*|$/, '?' + Date.now());
+        // listen when fully loaded
+        $newLink.addEventListener('load', (e) => {
+            var _a;
+            // remove old css's
+            Array.from((_a = finalSettings.$root.querySelectorAll(`link[id="${id}"]`)) !== null && _a !== void 0 ? _a : []).forEach(($remove) => {
+                if ($remove === $newLink)
+                    return;
+                $remove.remove();
+            });
+        });
+        // add the new link after the one to reload
+        $link.after($newLink);
+    });
+}
+//# sourceMappingURL=reloadStylesheets.js.map

package/dist/js/dom/css/reloadStylesheets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reloadStylesheets.js","sourceRoot":"","sources":["../../../../src/js/dom/css/reloadStylesheets.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,wBAAwB,CAAC;AA6B5C,MAAM,CAAC,OAAO,UAAU,iBAAiB,CACvC,QAA8C;;IAE9C,MAAM,aAAa,mBACjB,KAAK,EAAE,QAAQ,IACZ,CAAC,QAAQ,aAAR,QAAQ,cAAR,QAAQ,GAAI,EAAE,CAAC,CACpB,CAAC;IACF,yDAAyD;IACzD,KAAK,CAAC,IAAI,CACR,MAAA,aAAa,CAAC,KAAK,CAAC,gBAAgB,CAAC,sBAAsB,CAAC,mCAAI,EAAE,CACnE,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE;;QAClB,MAAM,EAAE,GAAG,MAAA,KAAK,CAAC,EAAE,mCAAI,MAAM,EAAE,CAAC;QAEhC,yBAAyB;QACzB,MAAM,QAAQ,GAAoB,KAAK,CAAC,SAAS,EAAE,CAAC;QACpD,QAAQ,CAAC,IAAI,GAAqB,KAAM,CAAC,IAAI,CAAC,OAAO,CACnD,QAAQ,EACR,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CACjB,CAAC;QACF,2BAA2B;QAC3B,QAAQ,CAAC,gBAAgB,CAAC,MAAM,EAAE,CAAC,CAAC,EAAE,EAAE;;YACtC,mBAAmB;YACnB,KAAK,CAAC,IAAI,CACR,MAAA,aAAa,CAAC,KAAK,CAAC,gBAAgB,CAAC,YAAY,EAAE,IAAI,CAAC,mCAAI,EAAE,CAC/D,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;gBACpB,IAAI,OAAO,KAAK,QAAQ;oBAAE,OAAO;gBACjC,OAAO,CAAC,MAAM,EAAE,CAAC;YACnB,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;QACH,2CAA2C;QAC3C,KAAK,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IACxB,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/js/dom/css/stylesheetToString.d.ts

@@ -0,0 +1,24 @@
+/**
+ * @name                stylesheetToString
+ * @namespace           js.dom.css
+ * @type                Function
+ * @platform            js
+ * @status              stable
+ *
+ * This function take a StyleSheet instance and convert it to a simple string
+ *
+ * @todo        tests
+ *
+ * @param       {StyleSheet|StyleSheetList}        stalesheet      The StyleSheet instance to convert
+ * @return      {String}                            The css string
+ *
+ * @snippet         stylesheetToString($1)
+ *
+ * @example         js
+ * import { stylesheetToString } from '@blackbyte/sugar/css';
+ * stylesheetToString(document.stylesheets); // => body { ... }
+ *
+ * @since       1.0.0
+ * @author    Olivier Bossel <olivier.bossel@gmail.com> (https://blackbyte.space)
+ */
+export default function stylesheetToString(stylesheet: StyleSheet | StyleSheetList): string;

package/dist/js/dom/css/stylesheetToString.js

@@ -0,0 +1,47 @@
+/**
+ * @name                stylesheetToString
+ * @namespace           js.dom.css
+ * @type                Function
+ * @platform            js
+ * @status              stable
+ *
+ * This function take a StyleSheet instance and convert it to a simple string
+ *
+ * @todo        tests
+ *
+ * @param       {StyleSheet|StyleSheetList}        stalesheet      The StyleSheet instance to convert
+ * @return      {String}                            The css string
+ *
+ * @snippet         stylesheetToString($1)
+ *
+ * @example         js
+ * import { stylesheetToString } from '@blackbyte/sugar/css';
+ * stylesheetToString(document.stylesheets); // => body { ... }
+ *
+ * @since       1.0.0
+ * @author    Olivier Bossel <olivier.bossel@gmail.com> (https://blackbyte.space)
+ */
+export default function stylesheetToString(
+// @ts-ignore
+stylesheet) {
+    let stack = [];
+    if (!(stylesheet instanceof StyleSheetList)) {
+        if (!Array.isArray(stylesheet))
+            stack.push(stylesheet);
+    }
+    else {
+        Object.keys(stylesheet).forEach((k) => {
+            stack.push(stylesheet[k]);
+        });
+    }
+    let str = ``;
+    stack.forEach((style) => {
+        str += style.cssRules
+            ? Array.from(style.cssRules)
+                .map((rule) => { var _a; return (_a = rule.cssText) !== null && _a !== void 0 ? _a : ''; })
+                .join('\n')
+            : '';
+    });
+    return str;
+}
+//# sourceMappingURL=stylesheetToString.js.map

package/dist/js/dom/css/stylesheetToString.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stylesheetToString.js","sourceRoot":"","sources":["../../../../src/js/dom/css/stylesheetToString.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,CAAC,OAAO,UAAU,kBAAkB;AACxC,aAAa;AACb,UAAuC;IAEvC,IAAI,KAAK,GAAU,EAAE,CAAC;IAEtB,IAAI,CAAC,CAAC,UAAU,YAAY,cAAc,CAAC,EAAE,CAAC;QAC5C,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC;YAAE,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACzD,CAAC;SAAM,CAAC;QACN,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE;YACpC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;QAC5B,CAAC,CAAC,CAAC;IACL,CAAC;IACD,IAAI,GAAG,GAAG,EAAE,CAAC;IACb,KAAK,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE;QACtB,GAAG,IAAI,KAAK,CAAC,QAAQ;YACnB,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC;iBACvB,GAAG,CAAC,CAAC,IAAS,EAAE,EAAE,WAAC,OAAA,MAAA,IAAI,CAAC,OAAO,mCAAI,EAAE,CAAA,EAAA,CAAC;iBACtC,IAAI,CAAC,IAAI,CAAC;YACf,CAAC,CAAC,EAAE,CAAC;IACT,CAAC,CAAC,CAAC;IACH,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/js/dom/distance/_exports.d.ts

@@ -0,0 +1,5 @@
+import distanceFromElementTopToViewportBottom from './distanceFromElementTopToViewportBottom.js';
+import distanceFromElementTopToViewportTop from './distanceFromElementTopToViewportTop.js';
+import scrollLeft from './scrollLeft.js';
+import scrollTop from './scrollTop.js';
+export { distanceFromElementTopToViewportBottom as __distanceFromElementTopToViewportBottom, distanceFromElementTopToViewportTop as __distanceFromElementTopToViewportTop, scrollLeft as __scrollLeft, scrollTop as __scrollTop, distanceFromElementTopToViewportBottom, distanceFromElementTopToViewportTop, scrollLeft, scrollTop, };

package/dist/js/dom/distance/_exports.js

@@ -0,0 +1,6 @@
+import distanceFromElementTopToViewportBottom from './distanceFromElementTopToViewportBottom.js';
+import distanceFromElementTopToViewportTop from './distanceFromElementTopToViewportTop.js';
+import scrollLeft from './scrollLeft.js';
+import scrollTop from './scrollTop.js';
+export { distanceFromElementTopToViewportBottom as __distanceFromElementTopToViewportBottom, distanceFromElementTopToViewportTop as __distanceFromElementTopToViewportTop, scrollLeft as __scrollLeft, scrollTop as __scrollTop, distanceFromElementTopToViewportBottom, distanceFromElementTopToViewportTop, scrollLeft, scrollTop, };
+//# sourceMappingURL=_exports.js.map

package/dist/js/dom/distance/_exports.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"_exports.js","sourceRoot":"","sources":["../../../../src/js/dom/distance/_exports.ts"],"names":[],"mappings":"AAAA,OAAO,sCAAsC,MAAM,6CAA6C,CAAC;AACjG,OAAO,mCAAmC,MAAM,0CAA0C,CAAC;AAC3F,OAAO,UAAU,MAAM,iBAAiB,CAAC;AACzC,OAAO,SAAS,MAAM,gBAAgB,CAAC;AACvC,OAAO,EACL,sCAAsC,IAAI,wCAAwC,EAClF,mCAAmC,IAAI,qCAAqC,EAC5E,UAAU,IAAI,YAAY,EAC1B,SAAS,IAAI,WAAW,EACxB,sCAAsC,EACtC,mCAAmC,EACnC,UAAU,EACV,SAAS,GACV,CAAC"}

package/dist/js/dom/distance/distanceFromElementTopToViewportBottom.d.ts

@@ -0,0 +1,23 @@
+/**
+ * @name            distanceFromElementTopToViewportBottom
+ * @namespace       js.dom.distance
+ * @type            Function
+ * @platform        js
+ * @status          stable
+ *
+ * This function take an element as parameter and returns you to distance it has
+ * from the element top to the viewport bottom in pixels
+ *
+ * @param       {HTMLElement}       elm             The element you want to get the distance from
+ * @return      {Number}                            The calculated distance
+ *
+ * @snippet         distanceFromElementTopToViewportBottom($1)
+ *
+ * @example         js
+ * import { distanceFromElementTopToViewportBottom } from '@blackbyte/sugar/dom';
+ * distanceFromElementTopToViewportBottom(myElement); // => 23
+ *
+ * @since       1.0.0
+ * @author    Olivier Bossel <olivier.bossel@gmail.com> (https://blackbyte.space)
+ */
+export default function distanceFromElementTopToViewportBottom(elm: HTMLElement): number;

package/dist/js/dom/distance/distanceFromElementTopToViewportBottom.js

@@ -0,0 +1,33 @@
+import __scrollTop from '../distance/scrollTop.js';
+import offsetFromViewport from '../offset/offsetFromViewport.js';
+/**
+ * @name            distanceFromElementTopToViewportBottom
+ * @namespace       js.dom.distance
+ * @type            Function
+ * @platform        js
+ * @status          stable
+ *
+ * This function take an element as parameter and returns you to distance it has
+ * from the element top to the viewport bottom in pixels
+ *
+ * @param       {HTMLElement}       elm             The element you want to get the distance from
+ * @return      {Number}                            The calculated distance
+ *
+ * @snippet         distanceFromElementTopToViewportBottom($1)
+ *
+ * @example         js
+ * import { distanceFromElementTopToViewportBottom } from '@blackbyte/sugar/dom';
+ * distanceFromElementTopToViewportBottom(myElement); // => 23
+ *
+ * @since       1.0.0
+ * @author    Olivier Bossel <olivier.bossel@gmail.com> (https://blackbyte.space)
+ */
+export default function distanceFromElementTopToViewportBottom(elm) {
+    const offsets = offsetFromViewport(elm);
+    const scrollTop = __scrollTop();
+    // @ts-ignore
+    const viewportHeight = window.innerHeight;
+    const distance = viewportHeight - offsets.top + scrollTop;
+    return distance;
+}
+//# sourceMappingURL=distanceFromElementTopToViewportBottom.js.map

package/dist/js/dom/distance/distanceFromElementTopToViewportBottom.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"distanceFromElementTopToViewportBottom.js","sourceRoot":"","sources":["../../../../src/js/dom/distance/distanceFromElementTopToViewportBottom.ts"],"names":[],"mappings":"AAAA,OAAO,WAAW,MAAM,0BAA0B,CAAC;AACnD,OAAO,kBAAkB,MAAM,iCAAiC,CAAC;AAEjE;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,CAAC,OAAO,UAAU,sCAAsC,CAC5D,GAAgB;IAEhB,MAAM,OAAO,GAAG,kBAAkB,CAAC,GAAG,CAAC,CAAC;IACxC,MAAM,SAAS,GAAG,WAAW,EAAE,CAAC;IAChC,aAAa;IACb,MAAM,cAAc,GAAG,MAAM,CAAC,WAAW,CAAC;IAC1C,MAAM,QAAQ,GAAG,cAAc,GAAG,OAAO,CAAC,GAAG,GAAG,SAAS,CAAC;IAC1D,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/js/dom/distance/distanceFromElementTopToViewportTop.d.ts

@@ -0,0 +1,23 @@
+/**
+ * @name            distanceFromElementTopToViewportTop
+ * @namespace       js.dom.distance
+ * @type            Function
+ * @platform        js
+ * @status          stable
+ *
+ * This function take an element as parameter and returns you to distance it has
+ * from the element top to the viewport top in pixels
+ *
+ * @param       {HTMLElement}       elm             The element you want to get the distance from
+ * @return      {Number}                            The calculated distance
+ *
+ * @snippet         distanceFromElementTopToViewportTop($1)
+ *
+ * @example         js
+ * import { distanceFromElementTopToViewportTop } from '@blackbyte/sugar/dom';
+ * distanceFromElementTopToViewportTop(myElement); // => 23
+ *
+ * @since       1.0.0
+ * @author    Olivier Bossel <olivier.bossel@gmail.com> (https://blackbyte.space)
+ */
+export default function distanceFromElementTopToViewportTop(elm: HTMLElement): number;

package/dist/js/dom/distance/distanceFromElementTopToViewportTop.js

@@ -0,0 +1,31 @@
+import __scrollTop from '../distance/scrollTop.js';
+import offsetFromViewport from '../offset/offsetFromViewport.js';
+/**
+ * @name            distanceFromElementTopToViewportTop
+ * @namespace       js.dom.distance
+ * @type            Function
+ * @platform        js
+ * @status          stable
+ *
+ * This function take an element as parameter and returns you to distance it has
+ * from the element top to the viewport top in pixels
+ *
+ * @param       {HTMLElement}       elm             The element you want to get the distance from
+ * @return      {Number}                            The calculated distance
+ *
+ * @snippet         distanceFromElementTopToViewportTop($1)
+ *
+ * @example         js
+ * import { distanceFromElementTopToViewportTop } from '@blackbyte/sugar/dom';
+ * distanceFromElementTopToViewportTop(myElement); // => 23
+ *
+ * @since       1.0.0
+ * @author    Olivier Bossel <olivier.bossel@gmail.com> (https://blackbyte.space)
+ */
+export default function distanceFromElementTopToViewportTop(elm) {
+    const offsets = offsetFromViewport(elm);
+    const scrollTop = __scrollTop();
+    // @ts-ignore
+    return offsets.top - scrollTop;
+}
+//# sourceMappingURL=distanceFromElementTopToViewportTop.js.map

package/dist/js/dom/distance/distanceFromElementTopToViewportTop.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"distanceFromElementTopToViewportTop.js","sourceRoot":"","sources":["../../../../src/js/dom/distance/distanceFromElementTopToViewportTop.ts"],"names":[],"mappings":"AAAA,OAAO,WAAW,MAAM,0BAA0B,CAAC;AACnD,OAAO,kBAAkB,MAAM,iCAAiC,CAAC;AAEjE;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,CAAC,OAAO,UAAU,mCAAmC,CACzD,GAAgB;IAEhB,MAAM,OAAO,GAAG,kBAAkB,CAAC,GAAG,CAAC,CAAC;IACxC,MAAM,SAAS,GAAG,WAAW,EAAE,CAAC;IAChC,aAAa;IACb,OAAO,OAAO,CAAC,GAAG,GAAG,SAAS,CAAC;AACjC,CAAC"}

package/dist/js/dom/distance/scrollLeft.d.ts

@@ -0,0 +1,21 @@
+/**
+ * @name            scrollLeft
+ * @namespace       js.dom.distance
+ * @type            Function
+ * @platform        js
+ * @status          stable
+ *
+ * Get the amount of scroll left
+ *
+ * @todo      tests
+ *
+ * @snippet         scrollLeft()
+ *
+ * @example    js
+ * import { scrollLeft } from '@blackbyte/sugar/dom'
+ * scrollLeft() // 40
+ *
+ * @since           1.0.0
+ * @author    Olivier Bossel <olivier.bossel@gmail.com> (https://olivier.bossel@gmail.com)
+ */
+export default function scrollLeft(): number;

package/dist/js/dom/distance/scrollLeft.js

@@ -0,0 +1,28 @@
+/**
+ * @name            scrollLeft
+ * @namespace       js.dom.distance
+ * @type            Function
+ * @platform        js
+ * @status          stable
+ *
+ * Get the amount of scroll left
+ *
+ * @todo      tests
+ *
+ * @snippet         scrollLeft()
+ *
+ * @example    js
+ * import { scrollLeft } from '@blackbyte/sugar/dom'
+ * scrollLeft() // 40
+ *
+ * @since           1.0.0
+ * @author    Olivier Bossel <olivier.bossel@gmail.com> (https://olivier.bossel@gmail.com)
+ */
+export default function scrollLeft() {
+    return (window.scrollX ||
+        window.pageXOffset ||
+        // @ts-ignore
+        document.scrollLeft ||
+        document.body.scrollLeft);
+}
+//# sourceMappingURL=scrollLeft.js.map

package/dist/js/dom/distance/scrollLeft.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scrollLeft.js","sourceRoot":"","sources":["../../../../src/js/dom/distance/scrollLeft.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,CAAC,OAAO,UAAU,UAAU;IAChC,OAAO,CACL,MAAM,CAAC,OAAO;QACd,MAAM,CAAC,WAAW;QAClB,aAAa;QACb,QAAQ,CAAC,UAAU;QACnB,QAAQ,CAAC,IAAI,CAAC,UAAU,CACzB,CAAC;AACJ,CAAC"}

package/dist/js/dom/distance/scrollTop.d.ts

@@ -0,0 +1,24 @@
+/**
+ * @name            scrollTop
+ * @namespace       js.dom.distance
+ * @type            Function
+ * @platform        js
+ * @status          stable
+ *
+ * Return the amount of scroll top that the user as made in the page
+ *
+ * @return      {Number}            The amount of scroll top that the user as made in the page
+ *
+ * @snippet         scrollTop()
+ *
+ * @todo      tests
+ *
+ * @example     js
+ * import { scrollTop } from '@blackbyte/sugar/dom';
+ * scrollTop();
+ *
+ * @since           1.0.0
+ * @author    Olivier Bossel <olivier.bossel@gmail.com> (https://blackbyte.space) (https://olivierbossel.com)
+ */
+declare function scrollTop(): number;
+export default scrollTop;

package/dist/js/dom/distance/scrollTop.js

@@ -0,0 +1,31 @@
+/**
+ * @name            scrollTop
+ * @namespace       js.dom.distance
+ * @type            Function
+ * @platform        js
+ * @status          stable
+ *
+ * Return the amount of scroll top that the user as made in the page
+ *
+ * @return      {Number}            The amount of scroll top that the user as made in the page
+ *
+ * @snippet         scrollTop()
+ *
+ * @todo      tests
+ *
+ * @example     js
+ * import { scrollTop } from '@blackbyte/sugar/dom';
+ * scrollTop();
+ *
+ * @since           1.0.0
+ * @author    Olivier Bossel <olivier.bossel@gmail.com> (https://blackbyte.space) (https://olivierbossel.com)
+ */
+function scrollTop() {
+    return (window.scrollY ||
+        window.pageYOffset ||
+        // @ts-ignore
+        document.scrollTop ||
+        document.body.scrollTop);
+}
+export default scrollTop;
+//# sourceMappingURL=scrollTop.js.map

package/dist/js/dom/distance/scrollTop.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scrollTop.js","sourceRoot":"","sources":["../../../../src/js/dom/distance/scrollTop.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,SAAS,SAAS;IAChB,OAAO,CACL,MAAM,CAAC,OAAO;QACd,MAAM,CAAC,WAAW;QAClB,aAAa;QACb,QAAQ,CAAC,SAAS;QAClB,QAAQ,CAAC,IAAI,CAAC,SAAS,CACxB,CAAC;AACJ,CAAC;AACD,eAAe,SAAS,CAAC"}

package/dist/js/dom/event/_exports.d.ts

@@ -0,0 +1,2 @@
+import viewportEvents from './viewportEvents.js';
+export { viewportEvents as __viewportEvents, viewportEvents };

package/dist/js/dom/event/_exports.js

@@ -0,0 +1,3 @@
+import viewportEvents from './viewportEvents.js';
+export { viewportEvents as __viewportEvents, viewportEvents };
+//# sourceMappingURL=_exports.js.map

package/dist/js/dom/event/_exports.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"_exports.js","sourceRoot":"","sources":["../../../../src/js/dom/event/_exports.ts"],"names":[],"mappings":"AAAA,OAAO,cAAc,MAAM,qBAAqB,CAAC;AACjD,OAAO,EAAE,cAAc,IAAI,gBAAgB,EAAE,cAAc,EAAE,CAAC"}

package/dist/js/dom/event/viewportEvents.d.ts

@@ -0,0 +1,48 @@
+/**
+ * @name            viewportEvents
+ * @namespace       js.dom.event
+ * @type            Function
+ * @platform        js
+ * @status          stable
+ * @async
+ *
+ * Monitor when the passed element enter or exit the viewport
+ *
+ * @param 		  {HTMLElement} 						$elm  		                        The element to monitor
+ * @param       {Partial<TViewportEventsSettings>}      [$settings={}]      Some settings to configure your detector
+ * @return 		  {HTMLElement} 		                                          The passed HTMLElement
+ *
+ * @setting         {String}        [offset=25]                 An offset to detect the enter/leave earlier or later
+ * @setting         {Boolean}       [once=false]                Specify if you want to event to be dispatched only once
+ *
+ * @event       viewport.enter               Dispatched when the passed element enter the viewport
+ * @event       viewport.leave               Dispatched when the passed element leave the viewport
+ *
+ * @snippet         viewportEvents($1)
+ * viewportEvents($1).addEventListener('viewport.enter', (e) => {
+ *      $2
+ * });
+ *
+ * @todo      tests
+ *
+ * @example  	js
+ * import { viewportEvents } from '@blackbyte/sugar/dom';
+ * viewportEvents($elm);
+ * $elm.addEventListener('viewport.enter', (e) => {
+ *      // do something on enter
+ * });
+ * $elm.addEventListener('viewport.leave', (e) => {
+ *      // do something on leave
+ * });
+ *
+ * @changelog       1.0.0
+ * Rename events from `viewport.in` / `viewport.out` to `viewport.enter` / `viewport.leave`
+ *
+ * @since           1.0.0
+ * @author         Olivier Bossel <olivier.bossel@gmail.com> (https://blackbyte.space)
+ */
+export type TViewportEventsSettings = {
+    offset: number | string;
+    once: boolean;
+};
+export default function viewportEvents($elm: HTMLElement, settings?: Partial<TViewportEventsSettings>): HTMLElement;

package/dist/js/dom/event/viewportEvents.js

@@ -0,0 +1,52 @@
+const _viewportEventsInited = new WeakMap();
+export default function viewportEvents($elm, settings) {
+    let observer, status = 'out';
+    if (_viewportEventsInited.has($elm)) {
+        return $elm;
+    }
+    _viewportEventsInited.set($elm, true);
+    const finalSettings = Object.assign({ offset: 25, once: false }, (settings !== null && settings !== void 0 ? settings : {}));
+    observer = new IntersectionObserver((entries, observer) => {
+        if (!entries.length)
+            return;
+        const entry = entries.pop();
+        if (!entry)
+            return;
+        if (entry.intersectionRatio > 0) {
+            if (status === 'in') {
+                return;
+            }
+            status = 'in';
+            $elm.dispatchEvent(new CustomEvent('viewport.enter', {
+                bubbles: true,
+            }));
+            $elm.dispatchEvent(new CustomEvent('viewport.in', {
+                bubbles: true,
+            }));
+            if (finalSettings === null || finalSettings === void 0 ? void 0 : finalSettings.once) {
+                observer.disconnect();
+            }
+        }
+        else {
+            if (status === 'out') {
+                return;
+            }
+            status = 'out';
+            $elm.dispatchEvent(new CustomEvent('viewport.leave', {
+                bubbles: true,
+            }));
+            $elm.dispatchEvent(new CustomEvent('viewport.out', {
+                bubbles: true,
+            }));
+        }
+    }, {
+        root: null, // viewport
+        rootMargin: typeof finalSettings.offset === 'string'
+            ? finalSettings.offset
+            : `${finalSettings.offset}px`,
+        threshold: [0, 0.1, 0.2, 0.3, 0.4, 0.5, 0.6, 0.7, 0.8, 0.9, 1],
+    });
+    observer.observe($elm);
+    return $elm;
+}
+//# sourceMappingURL=viewportEvents.js.map

package/dist/js/dom/event/viewportEvents.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"viewportEvents.js","sourceRoot":"","sources":["../../../../src/js/dom/event/viewportEvents.ts"],"names":[],"mappings":"AAgDA,MAAM,qBAAqB,GAAG,IAAI,OAAO,EAAE,CAAC;AAE5C,MAAM,CAAC,OAAO,UAAU,cAAc,CACpC,IAAiB,EACjB,QAA2C;IAE3C,IAAI,QAAQ,EACV,MAAM,GAAG,KAAK,CAAC;IAEjB,IAAI,qBAAqB,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;QACpC,OAAO,IAAI,CAAC;IACd,CAAC;IACD,qBAAqB,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAEtC,MAAM,aAAa,mBACjB,MAAM,EAAE,EAAE,EACV,IAAI,EAAE,KAAK,IACR,CAAC,QAAQ,aAAR,QAAQ,cAAR,QAAQ,GAAI,EAAE,CAAC,CACpB,CAAC;IAEF,QAAQ,GAAG,IAAI,oBAAoB,CACjC,CAAC,OAAO,EAAE,QAAQ,EAAE,EAAE;QACpB,IAAI,CAAC,OAAO,CAAC,MAAM;YAAE,OAAO;QAC5B,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;QAC5B,IAAI,CAAC,KAAK;YAAE,OAAO;QACnB,IAAI,KAAK,CAAC,iBAAiB,GAAG,CAAC,EAAE,CAAC;YAChC,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;gBACpB,OAAO;YACT,CAAC;YACD,MAAM,GAAG,IAAI,CAAC;YACd,IAAI,CAAC,aAAa,CAChB,IAAI,WAAW,CAAC,gBAAgB,EAAE;gBAChC,OAAO,EAAE,IAAI;aACd,CAAC,CACH,CAAC;YACF,IAAI,CAAC,aAAa,CAChB,IAAI,WAAW,CAAC,aAAa,EAAE;gBAC7B,OAAO,EAAE,IAAI;aACd,CAAC,CACH,CAAC;YACF,IAAI,aAAa,aAAb,aAAa,uBAAb,aAAa,CAAE,IAAI,EAAE,CAAC;gBACxB,QAAQ,CAAC,UAAU,EAAE,CAAC;YACxB,CAAC;QACH,CAAC;aAAM,CAAC;YACN,IAAI,MAAM,KAAK,KAAK,EAAE,CAAC;gBACrB,OAAO;YACT,CAAC;YACD,MAAM,GAAG,KAAK,CAAC;YACf,IAAI,CAAC,aAAa,CAChB,IAAI,WAAW,CAAC,gBAAgB,EAAE;gBAChC,OAAO,EAAE,IAAI;aACd,CAAC,CACH,CAAC;YACF,IAAI,CAAC,aAAa,CAChB,IAAI,WAAW,CAAC,cAAc,EAAE;gBAC9B,OAAO,EAAE,IAAI;aACd,CAAC,CACH,CAAC;QACJ,CAAC;IACH,CAAC,EACD;QACE,IAAI,EAAE,IAAI,EAAE,WAAW;QACvB,UAAU,EACR,OAAO,aAAa,CAAC,MAAM,KAAK,QAAQ;YACtC,CAAC,CAAC,aAAa,CAAC,MAAM;YACtB,CAAC,CAAC,GAAG,aAAa,CAAC,MAAM,IAAI;QACjC,SAAS,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC;KAC/D,CACF,CAAC;IAEF,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAEvB,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/js/dom/form/_exports.d.ts

@@ -0,0 +1,4 @@
+import disablePasswordManagerAttributes from './disablePasswordManagerAttributes.js';
+import getFormValues from './getFormValues.js';
+import generateIdFromForm from './generateIdFromForm.js';
+export { disablePasswordManagerAttributes as __disablePasswordManagerAttributes, getFormValues as __getFormValues, generateIdFromForm as __generateIdFromForm, disablePasswordManagerAttributes, getFormValues, generateIdFromForm, };

package/dist/js/dom/form/_exports.js

@@ -0,0 +1,5 @@
+import disablePasswordManagerAttributes from './disablePasswordManagerAttributes.js';
+import getFormValues from './getFormValues.js';
+import generateIdFromForm from './generateIdFromForm.js';
+export { disablePasswordManagerAttributes as __disablePasswordManagerAttributes, getFormValues as __getFormValues, generateIdFromForm as __generateIdFromForm, disablePasswordManagerAttributes, getFormValues, generateIdFromForm, };
+//# sourceMappingURL=_exports.js.map

package/dist/js/dom/form/_exports.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"_exports.js","sourceRoot":"","sources":["../../../../src/js/dom/form/_exports.ts"],"names":[],"mappings":"AAAA,OAAO,gCAAgC,MAAM,uCAAuC,CAAC;AACrF,OAAO,aAAa,MAAM,oBAAoB,CAAC;AAC/C,OAAO,kBAAkB,MAAM,yBAAyB,CAAC;AAEzD,OAAO,EACL,gCAAgC,IAAI,kCAAkC,EACtE,aAAa,IAAI,eAAe,EAChC,kBAAkB,IAAI,oBAAoB,EAC1C,gCAAgC,EAChC,aAAa,EACb,kBAAkB,GACnB,CAAC"}

package/dist/js/dom/form/disablePasswordManagerAttributes.d.ts

@@ -0,0 +1,29 @@
+/**
+ * @name            disablePasswordManagerAttributes
+ * @namespace       js.dom.form
+ * @type            Function
+ * @platform        js
+ * @status          stable
+ *
+ * This function return an object of attributes to apply on a form element to disable the password manager autocomplete feature.
+ * It support these password managers:
+ * - 1Password
+ * - LastPass
+ * - Bitwarden
+ * - Dashlane
+ * - Browser's built-in password manager
+ *
+ * @return      {Object}                          An object of attributes to apply on a form element to disable the password manager autocomplete feature.
+ *
+ * @todo      tests
+ *
+ * @snippet         disablePasswordManagerAttributes()
+ *
+ * @example  	js
+ * import { disablePasswordManagerAttributes } from '@blackbyte/sugar/dom'
+ * const attrs = disablePasswordManagerAttributes();
+ *
+ * @since           1.0.0
+ * @author         Olivier Bossel <olivier.bossel@gmail.com> (https://blackbyte.space)
+ */
+export default function disablePasswordManagerAttributes(): any;

package/dist/js/dom/form/disablePasswordManagerAttributes.js

@@ -0,0 +1,37 @@
+/**
+ * @name            disablePasswordManagerAttributes
+ * @namespace       js.dom.form
+ * @type            Function
+ * @platform        js
+ * @status          stable
+ *
+ * This function return an object of attributes to apply on a form element to disable the password manager autocomplete feature.
+ * It support these password managers:
+ * - 1Password
+ * - LastPass
+ * - Bitwarden
+ * - Dashlane
+ * - Browser's built-in password manager
+ *
+ * @return      {Object}                          An object of attributes to apply on a form element to disable the password manager autocomplete feature.
+ *
+ * @todo      tests
+ *
+ * @snippet         disablePasswordManagerAttributes()
+ *
+ * @example  	js
+ * import { disablePasswordManagerAttributes } from '@blackbyte/sugar/dom'
+ * const attrs = disablePasswordManagerAttributes();
+ *
+ * @since           1.0.0
+ * @author         Olivier Bossel <olivier.bossel@gmail.com> (https://blackbyte.space)
+ */
+export default function disablePasswordManagerAttributes() {
+    return {
+        'data-1p-ignore': true,
+        'data-lpignore': true,
+        'data-form-type': 'other',
+        'data-bwignore': true,
+    };
+}
+//# sourceMappingURL=disablePasswordManagerAttributes.js.map

package/dist/js/dom/form/disablePasswordManagerAttributes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"disablePasswordManagerAttributes.js","sourceRoot":"","sources":["../../../../src/js/dom/form/disablePasswordManagerAttributes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,CAAC,OAAO,UAAU,gCAAgC;IACtD,OAAO;QACL,gBAAgB,EAAE,IAAI;QACtB,eAAe,EAAE,IAAI;QACrB,gBAAgB,EAAE,OAAO;QACzB,eAAe,EAAE,IAAI;KACtB,CAAC;AACJ,CAAC"}

package/dist/js/dom/form/generateIdFromForm.d.ts

@@ -0,0 +1,30 @@
+/**
+ * @name            generateIdFromForm
+ * @namespace       js.dom.form
+ * @type            Function
+ * @platform        js
+ * @status          stable
+ * @async
+ *
+ * This function generate a uniqid based on the form element passed using these rules:
+ *
+ * 1. If the form has an action attribute, this will be used to generate the uniqid.
+ * 2. If not, the function will generate a uniqid based on the form attributes and named controls.
+ *
+ * Note that the named controlls will be sorted before generating the uniqid.
+ *
+ * @param           {HTMLFormElement}          $form           The form element to generate the uniqid from
+ * @return          {String}            A uniqid
+ *
+ * @todo      tests
+ *
+ * @snippet         generateIdFromForm()
+ *
+ * @example         js
+ * import { generateIdFromForm } from '@blackbyte/sugar/dom';
+ * const id = generateIdFromForm($myForm); // => a md5 hash id
+ *
+ * @since       1.0.0
+ * @author         Olivier Bossel <olivier.bossel@gmail.com> (https://blackbyte.space)
+ */
+export default function generateIdFromForm($form: HTMLFormElement): string;