@blackbyte/sugar 1.0.0-beta.3 → 1.0.0-beta.5

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

@@ -1,5 +1,6 @@
+import copyElement from './copyElement.js';
 import copyFile from './copyFile.js';
 import copyText from './copyText.js';
 import readFile from './readFile.js';
 import readText from './readText.js';
-export { copyFile as __copyFile, copyText as __copyText, readFile as __readFile, readText as __readText, copyFile, copyText, readFile, readText, };
+export { copyElement as __copyElement, copyFile as __copyFile, copyText as __copyText, readFile as __readFile, readText as __readText, copyElement, copyFile, copyText, readFile, readText, };

package/dist/js/clipboard/_exports.js

@@ -1,6 +1,7 @@
+import copyElement from './copyElement.js';
 import copyFile from './copyFile.js';
 import copyText from './copyText.js';
 import readFile from './readFile.js';
 import readText from './readText.js';
-export { copyFile as __copyFile, copyText as __copyText, readFile as __readFile, readText as __readText, copyFile, copyText, readFile, readText, };
+export { copyElement as __copyElement, copyFile as __copyFile, copyText as __copyText, readFile as __readFile, readText as __readText, copyElement, copyFile, copyText, readFile, readText, };
 //# sourceMappingURL=_exports.js.map

package/dist/js/clipboard/_exports.js.map

@@ -1 +1 @@
-{"version":3,"file":"_exports.js","sourceRoot":"","sources":["../../../src/js/clipboard/_exports.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,MAAM,eAAe,CAAC;AACrC,OAAO,QAAQ,MAAM,eAAe,CAAC;AACrC,OAAO,QAAQ,MAAM,eAAe,CAAC;AACrC,OAAO,QAAQ,MAAM,eAAe,CAAC;AACrC,OAAO,EACL,QAAQ,IAAI,UAAU,EACtB,QAAQ,IAAI,UAAU,EACtB,QAAQ,IAAI,UAAU,EACtB,QAAQ,IAAI,UAAU,EACtB,QAAQ,EACR,QAAQ,EACR,QAAQ,EACR,QAAQ,GACT,CAAC"}
+{"version":3,"file":"_exports.js","sourceRoot":"","sources":["../../../src/js/clipboard/_exports.ts"],"names":[],"mappings":"AAAA,OAAO,WAAW,MAAM,kBAAkB,CAAC;AAC3C,OAAO,QAAQ,MAAM,eAAe,CAAC;AACrC,OAAO,QAAQ,MAAM,eAAe,CAAC;AACrC,OAAO,QAAQ,MAAM,eAAe,CAAC;AACrC,OAAO,QAAQ,MAAM,eAAe,CAAC;AACrC,OAAO,EACL,WAAW,IAAI,aAAa,EAC5B,QAAQ,IAAI,UAAU,EACtB,QAAQ,IAAI,UAAU,EACtB,QAAQ,IAAI,UAAU,EACtB,QAAQ,IAAI,UAAU,EACtB,WAAW,EACX,QAAQ,EACR,QAAQ,EACR,QAAQ,EACR,QAAQ,GACT,CAAC"}

package/dist/js/clipboard/copyElement.d.ts

@@ -0,0 +1,24 @@
+/**
+ * @name                copyElement
+ * @namespace           js.clipboard
+ * @type                Function
+ * @platform            js
+ * @async
+ * @status              stable
+ *
+ * This function allows you to copy to the clipboard the passed dom node element with his style
+ *
+ * @param       {HTMLElement}            $elm            The dom node element to copy to the clipboard
+ *
+ * @todo     tests
+ *
+ * @snippet         copyElement($1)
+ *
+ * @example         js
+ * import { copyElement } from '@blackbyte/sugar/clipboard';
+ * copyElement($elm);
+ *
+ * @since           1.0.0
+ * @author         Olivier Bossel <olivier.bossel@gmail.com> (https://blackbyte.space)
+ */
+export default function copyElement($elm: HTMLElement): void;

package/dist/js/clipboard/copyElement.js

@@ -0,0 +1,43 @@
+// @ts-nocheck
+/**
+ * @name                copyElement
+ * @namespace           js.clipboard
+ * @type                Function
+ * @platform            js
+ * @async
+ * @status              stable
+ *
+ * This function allows you to copy to the clipboard the passed dom node element with his style
+ *
+ * @param       {HTMLElement}            $elm            The dom node element to copy to the clipboard
+ *
+ * @todo     tests
+ *
+ * @snippet         copyElement($1)
+ *
+ * @example         js
+ * import { copyElement } from '@blackbyte/sugar/clipboard';
+ * copyElement($elm);
+ *
+ * @since           1.0.0
+ * @author         Olivier Bossel <olivier.bossel@gmail.com> (https://blackbyte.space)
+ */
+export default function copyElement($elm) {
+    let range;
+    let selection;
+    if (document.body.createTextRange) {
+        range = document.body.createTextRange();
+        range.moveToElement($elm);
+        range.select();
+    }
+    else if (window.getSelection) {
+        selection = window.getSelection();
+        range = document.createRange();
+        range.selectNodeContents($elm);
+        selection.removeAllRanges();
+        selection.addRange(range);
+    }
+    document.execCommand('copy');
+    window.getSelection().removeAllRanges();
+}
+//# sourceMappingURL=copyElement.js.map

package/dist/js/clipboard/copyElement.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"copyElement.js","sourceRoot":"","sources":["../../../src/js/clipboard/copyElement.ts"],"names":[],"mappings":"AAAA,cAAc;AAEd;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,CAAC,OAAO,UAAU,WAAW,CAAC,IAAiB;IACnD,IAAI,KAAK,CAAC;IACV,IAAI,SAAS,CAAC;IAEd,IAAI,QAAQ,CAAC,IAAI,CAAC,eAAe,EAAE,CAAC;QAClC,KAAK,GAAG,QAAQ,CAAC,IAAI,CAAC,eAAe,EAAE,CAAC;QACxC,KAAK,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;QAC1B,KAAK,CAAC,MAAM,EAAE,CAAC;IACjB,CAAC;SAAM,IAAI,MAAM,CAAC,YAAY,EAAE,CAAC;QAC/B,SAAS,GAAG,MAAM,CAAC,YAAY,EAAE,CAAC;QAClC,KAAK,GAAG,QAAQ,CAAC,WAAW,EAAE,CAAC;QAC/B,KAAK,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC;QAC/B,SAAS,CAAC,eAAe,EAAE,CAAC;QAC5B,SAAS,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC5B,CAAC;IAED,QAAQ,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;IAC7B,MAAM,CAAC,YAAY,EAAE,CAAC,eAAe,EAAE,CAAC;AAC1C,CAAC"}

package/dist/js/clipboard/copyFile.d.ts

@@ -13,7 +13,7 @@
  *
  * @todo     tests
  *
- * @snippet         __copyFile($1)
+ * @snippet         copyFile($1)
  *
  * @example         js
  * import { copyFile } from '@blackbyte/sugar/clipboard';

package/dist/js/clipboard/copyFile.js

@@ -22,7 +22,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
  *
  * @todo     tests
  *
- * @snippet         __copyFile($1)
+ * @snippet         copyFile($1)
  *
  * @example         js
  * import { copyFile } from '@blackbyte/sugar/clipboard';

package/dist/js/clipboard/copyText.d.ts

@@ -13,7 +13,7 @@
  *
  * @todo     tests
  *
- * @snippet         __copy($1)
+ * @snippet         copyText($1)
  *
  * @example         js
  * import { copyText } from '@blackbyte/sugar/clipboard';

package/dist/js/clipboard/copyText.js

@@ -13,7 +13,7 @@
  *
  * @todo     tests
  *
- * @snippet         __copy($1)
+ * @snippet         copyText($1)
  *
  * @example         js
  * import { copyText } from '@blackbyte/sugar/clipboard';

package/dist/js/clipboard/readFile.d.ts

@@ -12,7 +12,7 @@
  *
  * @todo     tests
  *
- * @snippet         __readFile($1)
+ * @snippet         readFile($1)
  *
  * @example         js
  * import { readFile } from '@blackbyte/sugar/clipboard';

package/dist/js/clipboard/readFile.js

@@ -21,7 +21,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
  *
  * @todo     tests
  *
- * @snippet         __readFile($1)
+ * @snippet         readFile($1)
  *
  * @example         js
  * import { readFile } from '@blackbyte/sugar/clipboard';

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

@@ -1,3 +1,4 @@
+import { distanceFromElementTopToViewportTop } from '../_exports.js';
 const _viewportEventsInited = new WeakMap();
 export default function viewportEvents($elm, settings) {
     let observer, status = 'out';
@@ -16,6 +17,17 @@ export default function viewportEvents($elm, settings) {
             if (status === 'in') {
                 return;
             }
+            const distanceToTop = distanceFromElementTopToViewportTop($elm);
+            if (distanceToTop < window.innerHeight * 0.5) {
+                $elm.dispatchEvent(new CustomEvent('viewport.enter.above', {
+                    bubbles: true,
+                }));
+            }
+            else {
+                $elm.dispatchEvent(new CustomEvent('viewport.enter.below', {
+                    bubbles: true,
+                }));
+            }
             status = 'in';
             $elm.dispatchEvent(new CustomEvent('viewport.enter', {
                 bubbles: true,
@@ -31,6 +43,17 @@ export default function viewportEvents($elm, settings) {
             if (status === 'out') {
                 return;
             }
+            const distanceToTop = distanceFromElementTopToViewportTop($elm);
+            if (distanceToTop < window.innerHeight * 0.5) {
+                $elm.dispatchEvent(new CustomEvent('viewport.leave.above', {
+                    bubbles: true,
+                }));
+            }
+            else {
+                $elm.dispatchEvent(new CustomEvent('viewport.leave.below', {
+                    bubbles: true,
+                }));
+            }
             status = 'out';
             $elm.dispatchEvent(new CustomEvent('viewport.leave', {
                 bubbles: true,

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

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

package/dist/js/feature/sectionClasses.d.ts

@@ -6,8 +6,12 @@
  * @status          stable
  *
  *
- * This feature allows you to add some classes on your sections when they are in the viewport, near the viewport, etc...
+ * This feature allows you to add some classes on your sections when they are in the viewport, near the viewport, above, etc...
  * 1. `-in-viewport`: Added when the section is in the viewport
+ * 2. `-from-above`: Added when the section enters the viewport from above
+ * 3. `-from-below`: Added when the section enters the viewport from below
+ * 4. `-above-viewport`: Added when the section is above the viewport
+ * 5. `-below-viewport`: Added when the section is below the viewport
  *
  * @param           {TSectionClassesSettings}          [settings={}]           The settings you want to override
  *
@@ -25,6 +29,11 @@
  */
 export type TSectionClassesSettings = {
     inClass: string;
+    fromAboveClass: string;
+    fromBelowClass: string;
+    aboveClass: string;
+    belowClass: string;
     offset: number;
+    once?: boolean;
 };
 export default function sectionClasses(settings?: Partial<TSectionClassesSettings>): void;

package/dist/js/feature/sectionClasses.js

@@ -6,8 +6,12 @@
  * @status          stable
  *
  *
- * This feature allows you to add some classes on your sections when they are in the viewport, near the viewport, etc...
+ * This feature allows you to add some classes on your sections when they are in the viewport, near the viewport, above, etc...
  * 1. `-in-viewport`: Added when the section is in the viewport
+ * 2. `-from-above`: Added when the section enters the viewport from above
+ * 3. `-from-below`: Added when the section enters the viewport from below
+ * 4. `-above-viewport`: Added when the section is above the viewport
+ * 5. `-below-viewport`: Added when the section is below the viewport
  *
  * @param           {TSectionClassesSettings}          [settings={}]           The settings you want to override
  *
@@ -25,20 +29,53 @@
  */
 import { querySelectorLive, viewportEvents } from '@blackbyte/sugar/dom';
 export default function sectionClasses(settings) {
-    const finalSettings = Object.assign({ inClass: '-in-viewport', offset: 25 }, settings);
+    const finalSettings = Object.assign({ inClass: '-in-viewport', fromAboveClass: '-from-above', fromBelowClass: '-from-below', aboveClass: '-above-viewport', belowClass: '-below-viewport', offset: 25 }, settings);
     querySelectorLive('section', ($section) => {
         // listen for enter/leave viewport
         viewportEvents($section, {
             offset: finalSettings.offset,
+            once: finalSettings.once,
         });
-        $section.addEventListener('viewport.enter', () => {
+        const enterHandler = () => {
             // add the inClass on the section
             $section.classList.add(finalSettings.inClass);
-        });
-        $section.addEventListener('viewport.leave', () => {
+            // remove above/below classes
+            $section.classList.remove(finalSettings.aboveClass);
+            $section.classList.remove(finalSettings.belowClass);
+            // stop if "once" setting is enabled
+            if (finalSettings.once) {
+                $section.removeEventListener('viewport.enter', enterHandler);
+                $section.removeEventListener('viewport.leave', leaveHandler);
+                $section.removeEventListener('viewport.enter.above', enterAboveHandler);
+                $section.removeEventListener('viewport.enter.below', enterBelowHandler);
+            }
+        };
+        const leaveHandler = () => {
             // remove the inClass on the section
             $section.classList.remove(finalSettings.inClass);
-        });
+            $section.classList.remove(finalSettings.fromAboveClass);
+            $section.classList.remove(finalSettings.fromBelowClass);
+        };
+        const enterBelowHandler = () => {
+            $section.classList.add(finalSettings.fromBelowClass);
+        };
+        const enterAboveHandler = () => {
+            // add the inClass on the section
+            $section.classList.add(finalSettings.fromAboveClass);
+        };
+        const leaveAboveHandler = () => {
+            // remove the inClass on the section
+            $section.classList.add(finalSettings.aboveClass);
+        };
+        const leaveBelowHandler = () => {
+            $section.classList.add(finalSettings.belowClass);
+        };
+        $section.addEventListener('viewport.enter.above', enterAboveHandler);
+        $section.addEventListener('viewport.enter.below', enterBelowHandler);
+        $section.addEventListener('viewport.leave.above', leaveAboveHandler);
+        $section.addEventListener('viewport.leave.below', leaveBelowHandler);
+        $section.addEventListener('viewport.enter', enterHandler);
+        $section.addEventListener('viewport.leave', leaveHandler);
     });
 }
 //# sourceMappingURL=sectionClasses.js.map

package/dist/js/feature/sectionClasses.js.map

@@ -1 +1 @@
-{"version":3,"file":"sectionClasses.js","sourceRoot":"","sources":["../../../src/js/feature/sectionClasses.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAOzE,MAAM,CAAC,OAAO,UAAU,cAAc,CACpC,QAA2C;IAE3C,MAAM,aAAa,mBACjB,OAAO,EAAE,cAAc,EACvB,MAAM,EAAE,EAAE,IACP,QAAQ,CACZ,CAAC;IAEF,iBAAiB,CAAC,SAAS,EAAE,CAAC,QAAQ,EAAE,EAAE;QACxC,kCAAkC;QAClC,cAAc,CAAC,QAAQ,EAAE;YACvB,MAAM,EAAE,aAAa,CAAC,MAAM;SAC7B,CAAC,CAAC;QACH,QAAQ,CAAC,gBAAgB,CAAC,gBAAgB,EAAE,GAAG,EAAE;YAC/C,iCAAiC;YACjC,QAAQ,CAAC,SAAS,CAAC,GAAG,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;QAChD,CAAC,CAAC,CAAC;QACH,QAAQ,CAAC,gBAAgB,CAAC,gBAAgB,EAAE,GAAG,EAAE;YAC/C,oCAAoC;YACpC,QAAQ,CAAC,SAAS,CAAC,MAAM,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;QACnD,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"sectionClasses.js","sourceRoot":"","sources":["../../../src/js/feature/sectionClasses.ts"],"names":[],"mappings":"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"}

package/dist/shared/currency/currencyStringToObject.d.ts

@@ -7,12 +7,11 @@
  * @status            stable
  *
  * This function take a currency string like "120 USD" and convert it to an object
- * like:
- * {
- *    "amount": 120,
- *    "code": "USD",
- *    "symbol": "$"
- * }
+ * containing these properties:
+ *
+ * - `amount`: 120,
+ * - `code`: USD,
+ * - `symbol`: $
  *
  * @param       {String}            currency            The currency string to convert
  * @return      {TCurrencyToObject}                     The currency object
@@ -23,9 +22,9 @@
  * import { currencyStringToObject } from '@blackbyte/sugar/currency';
  * currencyStringToObject('120 $');
  * {
- *   "amount": 120,
- *   "code": "USD",
- *   "symbol": "$"
+ *   amount: 120,
+ *   code: 'USD',
+ *   symbol: '$'
  * }
  *
  * @see       https://www.npmjs.com/package/currency-symbol-map

package/dist/shared/currency/currencyStringToObject.js.map

@@ -1 +1 @@
-{"version":3,"file":"currencyStringToObject.js","sourceRoot":"","sources":["../../../src/shared/currency/currencyStringToObject.ts"],"names":[],"mappings":"AAAA,OAAO,iBAAiB,MAAM,qBAAqB,CAAC;AA2CpD,MAAM,CAAC,OAAO,UAAU,sBAAsB,CAC5C,QAAgB;;IAEhB,iBAAiB;IACjB,MAAM,MAAM,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC;IAEpC,yBAAyB;IACzB,MAAM,YAAY,GAAW,QAAQ,CAAC,OAAO,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAEzE,aAAa;IACb,MAAM,SAAS,GAAG,iBAAiB,CAAC,iBAAwB,CAAC;IAE7D,kCAAkC;IAClC,IAAI,IAAI,GAAG,EAAE,EACX,MAAM,GAAG,EAAE,CAAC;IACd,IAAI,SAAS,CAAC,YAAY,CAAC,EAAE,CAAC;QAC5B,IAAI,GAAG,YAAY,CAAC;QACpB,MAAM,GAAG,SAAS,CAAC,YAAY,CAAC,CAAC;IACnC,CAAC;SAAM,CAAC;QACN,IAAI;YACF,MAAA,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,YAAY,CAAC,mCACrE,EAAE,CAAC;QACL,MAAM,GAAG,YAAY,CAAC;IACxB,CAAC;IAED,OAAO;QACL,MAAM,EAAE,MAAM;QACd,IAAI;QACJ,MAAM;KACP,CAAC;AACJ,CAAC"}
+{"version":3,"file":"currencyStringToObject.js","sourceRoot":"","sources":["../../../src/shared/currency/currencyStringToObject.ts"],"names":[],"mappings":"AAAA,OAAO,iBAAiB,MAAM,qBAAqB,CAAC;AA0CpD,MAAM,CAAC,OAAO,UAAU,sBAAsB,CAC5C,QAAgB;;IAEhB,iBAAiB;IACjB,MAAM,MAAM,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC;IAEpC,yBAAyB;IACzB,MAAM,YAAY,GAAW,QAAQ,CAAC,OAAO,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAEzE,aAAa;IACb,MAAM,SAAS,GAAG,iBAAiB,CAAC,iBAAwB,CAAC;IAE7D,kCAAkC;IAClC,IAAI,IAAI,GAAG,EAAE,EACX,MAAM,GAAG,EAAE,CAAC;IACd,IAAI,SAAS,CAAC,YAAY,CAAC,EAAE,CAAC;QAC5B,IAAI,GAAG,YAAY,CAAC;QACpB,MAAM,GAAG,SAAS,CAAC,YAAY,CAAC,CAAC;IACnC,CAAC;SAAM,CAAC;QACN,IAAI;YACF,MAAA,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,YAAY,CAAC,mCACrE,EAAE,CAAC;QACL,MAAM,GAAG,YAAY,CAAC;IACxB,CAAC;IAED,OAAO;QACL,MAAM,EAAE,MAAM;QACd,IAAI;QACJ,MAAM;KACP,CAAC;AACJ,CAAC"}

package/dist/shared/datetime/_exports.d.ts

@@ -1,7 +1,10 @@
+import diffBetweenDates from './diffBetweenDates.js';
 import formatDuration from './formatDuration.js';
+import parseDate from './parseDate.js';
 import sleep from './sleep.js';
 import timeAgo from './timeAgo.js';
+import toYyyyMmDd from './toYyyyMmDd.js';
 import utcTime from './utcTime.js';
 import wait from './wait.js';
 export * from './convertTime.js';
-export { formatDuration as __formatDuration, sleep as __sleep, timeAgo as __timeAgo, utcTime as __utcTime, wait as __wait, formatDuration, sleep, timeAgo, utcTime, wait, };
+export { diffBetweenDates as __diffBetweenDates, formatDuration as __formatDuration, parseDate as __parseDate, sleep as __sleep, timeAgo as __timeAgo, toYyyyMmDd as __toYyyyMmDd, utcTime as __utcTime, wait as __wait, diffBetweenDates, formatDuration, parseDate, sleep, timeAgo, toYyyyMmDd, utcTime, wait, };

package/dist/shared/datetime/_exports.js

@@ -1,8 +1,11 @@
+import diffBetweenDates from './diffBetweenDates.js';
 import formatDuration from './formatDuration.js';
+import parseDate from './parseDate.js';
 import sleep from './sleep.js';
 import timeAgo from './timeAgo.js';
+import toYyyyMmDd from './toYyyyMmDd.js';
 import utcTime from './utcTime.js';
 import wait from './wait.js';
 export * from './convertTime.js';
-export { formatDuration as __formatDuration, sleep as __sleep, timeAgo as __timeAgo, utcTime as __utcTime, wait as __wait, formatDuration, sleep, timeAgo, utcTime, wait, };
+export { diffBetweenDates as __diffBetweenDates, formatDuration as __formatDuration, parseDate as __parseDate, sleep as __sleep, timeAgo as __timeAgo, toYyyyMmDd as __toYyyyMmDd, utcTime as __utcTime, wait as __wait, diffBetweenDates, formatDuration, parseDate, sleep, timeAgo, toYyyyMmDd, utcTime, wait, };
 //# sourceMappingURL=_exports.js.map

package/dist/shared/datetime/_exports.js.map

@@ -1 +1 @@
-{"version":3,"file":"_exports.js","sourceRoot":"","sources":["../../../src/shared/datetime/_exports.ts"],"names":[],"mappings":"AAAA,OAAO,cAAc,MAAM,qBAAqB,CAAC;AACjD,OAAO,KAAK,MAAM,YAAY,CAAC;AAC/B,OAAO,OAAO,MAAM,cAAc,CAAC;AACnC,OAAO,OAAO,MAAM,cAAc,CAAC;AACnC,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,cAAc,kBAAkB,CAAC;AACjC,OAAO,EACL,cAAc,IAAI,gBAAgB,EAClC,KAAK,IAAI,OAAO,EAChB,OAAO,IAAI,SAAS,EACpB,OAAO,IAAI,SAAS,EACpB,IAAI,IAAI,MAAM,EACd,cAAc,EACd,KAAK,EACL,OAAO,EACP,OAAO,EACP,IAAI,GACL,CAAC"}
+{"version":3,"file":"_exports.js","sourceRoot":"","sources":["../../../src/shared/datetime/_exports.ts"],"names":[],"mappings":"AAAA,OAAO,gBAAgB,MAAM,uBAAuB,CAAC;AACrD,OAAO,cAAc,MAAM,qBAAqB,CAAC;AACjD,OAAO,SAAS,MAAM,gBAAgB,CAAC;AACvC,OAAO,KAAK,MAAM,YAAY,CAAC;AAC/B,OAAO,OAAO,MAAM,cAAc,CAAC;AACnC,OAAO,UAAU,MAAM,iBAAiB,CAAC;AACzC,OAAO,OAAO,MAAM,cAAc,CAAC;AACnC,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,cAAc,kBAAkB,CAAC;AACjC,OAAO,EACL,gBAAgB,IAAI,kBAAkB,EACtC,cAAc,IAAI,gBAAgB,EAClC,SAAS,IAAI,WAAW,EACxB,KAAK,IAAI,OAAO,EAChB,OAAO,IAAI,SAAS,EACpB,UAAU,IAAI,YAAY,EAC1B,OAAO,IAAI,SAAS,EACpB,IAAI,IAAI,MAAM,EACd,gBAAgB,EAChB,cAAc,EACd,SAAS,EACT,KAAK,EACL,OAAO,EACP,UAAU,EACV,OAAO,EACP,IAAI,GACL,CAAC"}

package/dist/shared/datetime/diffBetweenDates.d.ts

@@ -0,0 +1,39 @@
+/**
+ * @name                                diffBetweenDates
+ * @namespace                           shared.datetime
+ * @type                                Function
+ * @platform                            js
+ * @platform                            node
+ * @status                              stable
+ *
+ * This function allows you to get the difference between two date strings.
+ * It will returns you an object with the difference represented with these properties (years, months, days, hours, minutes, seconds).
+ * Under the hood, it make uses of the wonderful [Luxon](https://moment.github.io/luxon) library.
+ *
+ * @param           {String}                            date                    The date string to parse
+ * @param           {TDiffBetweenDatesSettings}         [settings={}]           Some settings to configure your parsing
+ * @return          {Date}                                                      The `Date` instance representing your date string
+ *
+ * @setting         {String}        [format='']                                 If you know the format of your date string, you can pass it here. This will make the parsing faster and more reliable. See [Luxon documentation](https://moment.github.io/luxon/#/parsing?id=table-of-tokens) for the list of supported tokens.
+ *
+ * @snippet         diffBetweenDates($1, $2, $3)
+ *
+ * @example           js
+ * import { diffBetweenDates } from '@blackbyte/sugar/datetime';
+ * diffBetweenDates('1945-10-12', '2025-10-15');
+ *
+ * @see             https://moment.github.io/luxon
+ * @since           1.0.0
+ * @author          Olivier Bossel <olivier.bossel@gmail.com> (https://blackbyte.space)
+ */
+export type TDiffBetweenDatesSettings = {
+    format: string;
+};
+export default function diffBetweenDates(date1: string | Date, date2: string | Date, settings?: Partial<TDiffBetweenDatesSettings>): {
+    years?: number;
+    months?: number;
+    days?: number;
+    hours?: number;
+    minutes?: number;
+    seconds?: number;
+} | null;

package/dist/shared/datetime/diffBetweenDates.js

@@ -0,0 +1,25 @@
+import { DateTime } from 'luxon';
+import parseDate from './parseDate.js';
+export default function diffBetweenDates(date1, date2, settings) {
+    const finalSettings = Object.assign({ format: '' }, (settings !== null && settings !== void 0 ? settings : {}));
+    // prse the passed date
+    const jsDate1 = parseDate(date1, finalSettings);
+    const jsDate2 = parseDate(date2, finalSettings);
+    if (!jsDate1 || !jsDate2) {
+        return null;
+    }
+    const luxonDate1 = DateTime.fromJSDate(jsDate1);
+    const luxonDate2 = DateTime.fromJSDate(jsDate2);
+    const diff = luxonDate2
+        .diff(luxonDate1, [
+        'years',
+        'months',
+        'days',
+        'hours',
+        'minutes',
+        'seconds',
+    ])
+        .toObject();
+    return diff;
+}
+//# sourceMappingURL=diffBetweenDates.js.map

package/dist/shared/datetime/diffBetweenDates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diffBetweenDates.js","sourceRoot":"","sources":["../../../src/shared/datetime/diffBetweenDates.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AACjC,OAAO,SAAS,MAAM,gBAAgB,CAAC;AAmCvC,MAAM,CAAC,OAAO,UAAU,gBAAgB,CACtC,KAAoB,EACpB,KAAoB,EACpB,QAA6C;IAS7C,MAAM,aAAa,mBACjB,MAAM,EAAE,EAAE,IACP,CAAC,QAAQ,aAAR,QAAQ,cAAR,QAAQ,GAAI,EAAE,CAAC,CACpB,CAAC;IAEF,uBAAuB;IACvB,MAAM,OAAO,GAAG,SAAS,CAAC,KAAK,EAAE,aAAa,CAAC,CAAC;IAChD,MAAM,OAAO,GAAG,SAAS,CAAC,KAAK,EAAE,aAAa,CAAC,CAAC;IAEhD,IAAI,CAAC,OAAO,IAAI,CAAC,OAAO,EAAE,CAAC;QACzB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,UAAU,GAAG,QAAQ,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;IAChD,MAAM,UAAU,GAAG,QAAQ,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;IAEhD,MAAM,IAAI,GAAG,UAAU;SACpB,IAAI,CAAC,UAAU,EAAE;QAChB,OAAO;QACP,QAAQ;QACR,MAAM;QACN,OAAO;QACP,SAAS;QACT,SAAS;KACV,CAAC;SACD,QAAQ,EAAE,CAAC;IAEd,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/shared/datetime/parseDate.d.ts

@@ -0,0 +1,38 @@
+/**
+ * @name                                parseDate
+ * @namespace                           shared.datetime
+ * @type                                Function
+ * @platform                            js
+ * @platform                            node
+ * @status                              stable
+ *
+ * This function allows you to parse a date string. It will returns the `Date` instance for this date.
+ * Under the hood, it make uses of the wonderful [Luxon](https://moment.github.io/luxon) library.
+ * Make sure to use the library if you need more control over your dates.
+ * Luxon support these date formats:
+ *
+ * - ISO 8601
+ * - RFC2822
+ * - HTTP (header)
+ *
+ * @param           {String}                    date                    The date string to parse
+ * @param           {TParseDateSettings}        [settings={}]           Some settings to configure your parsing
+ * @return          {Date}                                              The `Date` instance representing your date string
+ *
+ * @setting         {String}        [format='']                         If you know the format of your date string, you can pass it here. This will make the parsing faster and more reliable. See [Luxon documentation](https://moment.github.io/luxon/#/parsing?id=table-of-tokens) for the list of supported tokens.
+ *
+ * @snippet         parseDate($1, $2)
+ *
+ * @example           js
+ * import { parseDate } from '@blackbyte/sugar/datetime';
+ * parseDate('2025-10-12');
+ * parseDate('2024-10-15T10:30:00Z');
+ *
+ * @see             https://moment.github.io/luxon
+ * @since           1.0.0
+ * @author          Olivier Bossel <olivier.bossel@gmail.com> (https://blackbyte.space)
+ */
+export type TParseDateSettings = {
+    format: string;
+};
+export default function parseDate(date: string | Date, settings?: Partial<TParseDateSettings>): Date | null;

package/dist/shared/datetime/parseDate.js

@@ -0,0 +1,34 @@
+import { DateTime } from 'luxon';
+export default function parseDate(date, settings) {
+    const finalSettings = Object.assign({ format: '' }, (settings !== null && settings !== void 0 ? settings : {}));
+    let luxonDate;
+    // if it is already a date, we just return it
+    if (date instanceof Date) {
+        return date;
+    }
+    // if a format is passed, we check this.
+    // if it's invalid, we return null
+    if (finalSettings.format) {
+        luxonDate = DateTime.fromFormat(date, finalSettings.format);
+    }
+    if (luxonDate === null || luxonDate === void 0 ? void 0 : luxonDate.invalid) {
+        return null;
+    }
+    // otherwise we try to parse the date string
+    // using all the format supported by luxon
+    luxonDate = DateTime.fromISO(date);
+    if (!(luxonDate === null || luxonDate === void 0 ? void 0 : luxonDate.invalid)) {
+        return luxonDate.toJSDate();
+    }
+    luxonDate = DateTime.fromRFC2822(date);
+    if (!(luxonDate === null || luxonDate === void 0 ? void 0 : luxonDate.invalid)) {
+        return luxonDate.toJSDate();
+    }
+    luxonDate = DateTime.fromHTTP(date);
+    if (!(luxonDate === null || luxonDate === void 0 ? void 0 : luxonDate.invalid)) {
+        return luxonDate.toJSDate();
+    }
+    // nothing worked...
+    return null;
+}
+//# sourceMappingURL=parseDate.js.map

package/dist/shared/datetime/parseDate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parseDate.js","sourceRoot":"","sources":["../../../src/shared/datetime/parseDate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAyCjC,MAAM,CAAC,OAAO,UAAU,SAAS,CAC/B,IAAmB,EACnB,QAAsC;IAEtC,MAAM,aAAa,mBACjB,MAAM,EAAE,EAAE,IACP,CAAC,QAAQ,aAAR,QAAQ,cAAR,QAAQ,GAAI,EAAE,CAAC,CACpB,CAAC;IACF,IAAI,SAAS,CAAC;IAEd,6CAA6C;IAC7C,IAAI,IAAI,YAAY,IAAI,EAAE,CAAC;QACzB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,wCAAwC;IACxC,kCAAkC;IAClC,IAAI,aAAa,CAAC,MAAM,EAAE,CAAC;QACzB,SAAS,GAAG,QAAQ,CAAC,UAAU,CAAC,IAAI,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAC9D,CAAC;IACD,IAAI,SAAS,aAAT,SAAS,uBAAT,SAAS,CAAE,OAAO,EAAE,CAAC;QACvB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,4CAA4C;IAC5C,0CAA0C;IAC1C,SAAS,GAAG,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACnC,IAAI,CAAC,CAAA,SAAS,aAAT,SAAS,uBAAT,SAAS,CAAE,OAAO,CAAA,EAAE,CAAC;QACxB,OAAO,SAAS,CAAC,QAAQ,EAAE,CAAC;IAC9B,CAAC;IAED,SAAS,GAAG,QAAQ,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;IACvC,IAAI,CAAC,CAAA,SAAS,aAAT,SAAS,uBAAT,SAAS,CAAE,OAAO,CAAA,EAAE,CAAC;QACxB,OAAO,SAAS,CAAC,QAAQ,EAAE,CAAC;IAC9B,CAAC;IAED,SAAS,GAAG,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IACpC,IAAI,CAAC,CAAA,SAAS,aAAT,SAAS,uBAAT,SAAS,CAAE,OAAO,CAAA,EAAE,CAAC;QACxB,OAAO,SAAS,CAAC,QAAQ,EAAE,CAAC;IAC9B,CAAC;IAED,oBAAoB;IACpB,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/shared/datetime/toYyyyMmDd.d.ts

@@ -0,0 +1,34 @@
+/**
+ * @name                                toYyyyMmDd
+ * @namespace                           shared.datetime
+ * @type                                Function
+ * @platform                            js
+ * @platform                            node
+ * @status                              stable
+ *
+ * This function allows you to pass any date string or Date instance and get back this
+ * one formatted as `YYYY-MM-DD`.
+ * This format is useful when you need to store dates in a database, set a date input value, etc...
+ * Under the hood, it make uses of the wonderful [Luxon](https://moment.github.io/luxon) library.
+ *
+ * @param           {String}                            date                    The date (string) to convert to `YYYY-MM-DD`
+ * @param           {TtoYyyyMmDdSettings}               [settings={}]           Some settings to configure your parsing
+ * @return          {String}                                                    The date formatted as `YYYY-MM-DD`
+ *
+ * @setting         {String}        [format='']                                 If you know the format of your date string, you can pass it here. This will make the parsing faster and more reliable. See [Luxon documentation](https://moment.github.io/luxon/#/parsing?id=table-of-tokens) for the list of supported tokens.
+ *
+ * @snippet         toYyyyMmDd($1, $2, $3)
+ *
+ * @example           js
+ * import { toYyyyMmDd } from '@blackbyte/sugar/datetime';
+ * toYyyyMmDd('2025-10-15T14:30:00+02:00'); // '2025-10-15'
+ *
+ * @see             https://moment.github.io/luxon
+ * @since           1.0.0
+ * @author          Olivier Bossel <olivier.bossel@gmail.com> (https://blackbyte.space)
+ */
+export type TtoYyyyMmDdSettings = {
+    format: string;
+    separator: string;
+};
+export default function toYyyyMmDd(date: string | Date, settings?: Partial<TtoYyyyMmDdSettings>): string | null;

package/dist/shared/datetime/toYyyyMmDd.js

@@ -0,0 +1,19 @@
+import parseDate from './parseDate.js';
+export default function toYyyyMmDd(date, settings) {
+    const finalSettings = Object.assign({ format: '', separator: '-' }, (settings !== null && settings !== void 0 ? settings : {}));
+    if (typeof date === 'string' && date.match(/^\d{4}-\d{2}-\d{2}$/)) {
+        // already in the correct format
+        return date;
+    }
+    // prse the passed date
+    const jsDate = parseDate(date, finalSettings);
+    if (!jsDate) {
+        return null;
+    }
+    const dateStr = jsDate
+        .toISOString()
+        .split('T')[0]
+        .replace('-', finalSettings.separator);
+    return dateStr;
+}
+//# sourceMappingURL=toYyyyMmDd.js.map

package/dist/shared/datetime/toYyyyMmDd.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"toYyyyMmDd.js","sourceRoot":"","sources":["../../../src/shared/datetime/toYyyyMmDd.ts"],"names":[],"mappings":"AAAA,OAAO,SAAS,MAAM,gBAAgB,CAAC;AAqCvC,MAAM,CAAC,OAAO,UAAU,UAAU,CAChC,IAAmB,EACnB,QAAuC;IAEvC,MAAM,aAAa,mBACjB,MAAM,EAAE,EAAE,EACV,SAAS,EAAE,GAAG,IACX,CAAC,QAAQ,aAAR,QAAQ,cAAR,QAAQ,GAAI,EAAE,CAAC,CACpB,CAAC;IAEF,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,KAAK,CAAC,qBAAqB,CAAC,EAAE,CAAC;QAClE,gCAAgC;QAChC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,uBAAuB;IACvB,MAAM,MAAM,GAAG,SAAS,CAAC,IAAI,EAAE,aAAa,CAAC,CAAC;IAC9C,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,OAAO,GAAG,MAAM;SACnB,WAAW,EAAE;SACb,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;SACb,OAAO,CAAC,GAAG,EAAE,aAAa,CAAC,SAAS,CAAC,CAAC;IACzC,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@blackbyte/sugar",
   "description": "The toolkit that you missed... like a sugar in your coffee!",
-  "version": "1.0.0-beta.3",
+  "version": "1.0.0-beta.5",
   "keywords": [
     "javascript",
     "typescript",
@@ -203,6 +203,7 @@
   },
   "dependencies": {
     "@faker-js/faker": "^8.4.1",
+    "@types/luxon": "^3.7.1",
     "aggregation": "^1.2.7",
     "atob": "^2.1.2",
     "blueimp-md5": "^2.19.0",
@@ -238,6 +239,7 @@
     "json-cyclic": "^1.0.2",
     "lodash.clone": "^4.5.0",
     "lodash.clonedeep": "^4.5.0",
+    "luxon": "^3.7.2",
     "mark.js": "^8.11.1",
     "memoizee": "^0.4.15",
     "micromatch": "^4.0.5",