@blackbyte/sugar 1.0.0-beta.13 → 1.0.0-beta.16

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

@@ -17,5 +17,6 @@ import whenRemoved from './whenRemoved.js';
 import whenScriptLoaded from './whenScriptLoaded.js';
 import whenStylesheetsReady from './whenStylesheetsReady.js';
 import whenTransitionEnd from './whenTransitionEnd.js';
+import whenVideoReady from './whenVideoReady.js';
 import whenVisible from './whenVisible.js';
-export { when as __when, whenAnimationEnd as __whenAnimationEnd, whenAttribute as __whenAttribute, whenBackgroundImageLoaded as __whenBackgroundImageLoaded, whenDomReady as __whenDomReady, whenEntersViewport as __whenEntersViewport, whenEventListener as __whenEventListener, whenIframeReady as __whenIframeReady, whenImageLoaded as __whenImageLoaded, whenImagesLoaded as __whenImagesLoaded, whenInteract as __whenInteract, whenInViewport as __whenInViewport, whenLinkLoaded as __whenLinkLoaded, whenNearViewport as __whenNearViewport, whenOutOfViewport as __whenOutOfViewport, whenRemoved as __whenRemoved, whenScriptLoaded as __whenScriptLoaded, whenStylesheetsReady as __whenStylesheetsReady, whenTransitionEnd as __whenTransitionEnd, whenVisible as __whenVisible, when, whenAnimationEnd, whenAttribute, whenBackgroundImageLoaded, whenDomReady, whenEntersViewport, whenEventListener, whenIframeReady, whenImageLoaded, whenImagesLoaded, whenInteract, whenInViewport, whenLinkLoaded, whenNearViewport, whenOutOfViewport, whenRemoved, whenScriptLoaded, whenStylesheetsReady, whenTransitionEnd, WhenTriggers, whenVisible, };
+export { when as __when, whenAnimationEnd as __whenAnimationEnd, whenAttribute as __whenAttribute, whenBackgroundImageLoaded as __whenBackgroundImageLoaded, whenDomReady as __whenDomReady, whenEntersViewport as __whenEntersViewport, whenEventListener as __whenEventListener, whenIframeReady as __whenIframeReady, whenImageLoaded as __whenImageLoaded, whenImagesLoaded as __whenImagesLoaded, whenInteract as __whenInteract, whenInViewport as __whenInViewport, whenLinkLoaded as __whenLinkLoaded, whenNearViewport as __whenNearViewport, whenOutOfViewport as __whenOutOfViewport, whenRemoved as __whenRemoved, whenScriptLoaded as __whenScriptLoaded, whenStylesheetsReady as __whenStylesheetsReady, whenTransitionEnd as __whenTransitionEnd, whenVideoReady as __whenVideoReady, whenVisible as __whenVisible, when, whenAnimationEnd, whenAttribute, whenBackgroundImageLoaded, whenDomReady, whenEntersViewport, whenEventListener, whenIframeReady, whenImageLoaded, whenImagesLoaded, whenInteract, whenInViewport, whenLinkLoaded, whenNearViewport, whenOutOfViewport, whenRemoved, whenScriptLoaded, whenStylesheetsReady, whenTransitionEnd, WhenTriggers, whenVideoReady, whenVisible, };

package/dist/js/dom/when/_exports.js

@@ -17,6 +17,7 @@ import whenRemoved from './whenRemoved.js';
 import whenScriptLoaded from './whenScriptLoaded.js';
 import whenStylesheetsReady from './whenStylesheetsReady.js';
 import whenTransitionEnd from './whenTransitionEnd.js';
+import whenVideoReady from './whenVideoReady.js';
 import whenVisible from './whenVisible.js';
-export { when as __when, whenAnimationEnd as __whenAnimationEnd, whenAttribute as __whenAttribute, whenBackgroundImageLoaded as __whenBackgroundImageLoaded, whenDomReady as __whenDomReady, whenEntersViewport as __whenEntersViewport, whenEventListener as __whenEventListener, whenIframeReady as __whenIframeReady, whenImageLoaded as __whenImageLoaded, whenImagesLoaded as __whenImagesLoaded, whenInteract as __whenInteract, whenInViewport as __whenInViewport, whenLinkLoaded as __whenLinkLoaded, whenNearViewport as __whenNearViewport, whenOutOfViewport as __whenOutOfViewport, whenRemoved as __whenRemoved, whenScriptLoaded as __whenScriptLoaded, whenStylesheetsReady as __whenStylesheetsReady, whenTransitionEnd as __whenTransitionEnd, whenVisible as __whenVisible, when, whenAnimationEnd, whenAttribute, whenBackgroundImageLoaded, whenDomReady, whenEntersViewport, whenEventListener, whenIframeReady, whenImageLoaded, whenImagesLoaded, whenInteract, whenInViewport, whenLinkLoaded, whenNearViewport, whenOutOfViewport, whenRemoved, whenScriptLoaded, whenStylesheetsReady, whenTransitionEnd, WhenTriggers, whenVisible, };
+export { when as __when, whenAnimationEnd as __whenAnimationEnd, whenAttribute as __whenAttribute, whenBackgroundImageLoaded as __whenBackgroundImageLoaded, whenDomReady as __whenDomReady, whenEntersViewport as __whenEntersViewport, whenEventListener as __whenEventListener, whenIframeReady as __whenIframeReady, whenImageLoaded as __whenImageLoaded, whenImagesLoaded as __whenImagesLoaded, whenInteract as __whenInteract, whenInViewport as __whenInViewport, whenLinkLoaded as __whenLinkLoaded, whenNearViewport as __whenNearViewport, whenOutOfViewport as __whenOutOfViewport, whenRemoved as __whenRemoved, whenScriptLoaded as __whenScriptLoaded, whenStylesheetsReady as __whenStylesheetsReady, whenTransitionEnd as __whenTransitionEnd, whenVideoReady as __whenVideoReady, whenVisible as __whenVisible, when, whenAnimationEnd, whenAttribute, whenBackgroundImageLoaded, whenDomReady, whenEntersViewport, whenEventListener, whenIframeReady, whenImageLoaded, whenImagesLoaded, whenInteract, whenInViewport, whenLinkLoaded, whenNearViewport, whenOutOfViewport, whenRemoved, whenScriptLoaded, whenStylesheetsReady, whenTransitionEnd, WhenTriggers, whenVideoReady, whenVisible, };
 //# sourceMappingURL=_exports.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"_exports.js","sourceRoot":"","sources":["../../../../src/js/dom/when/_exports.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,EAAE,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,gBAAgB,MAAM,uBAAuB,CAAC;AACrD,OAAO,aAAa,MAAM,oBAAoB,CAAC;AAC/C,OAAO,yBAAyB,MAAM,gCAAgC,CAAC;AACvE,OAAO,YAAY,MAAM,mBAAmB,CAAC;AAC7C,OAAO,kBAAkB,MAAM,yBAAyB,CAAC;AACzD,OAAO,iBAAiB,MAAM,wBAAwB,CAAC;AACvD,OAAO,eAAe,MAAM,sBAAsB,CAAC;AACnD,OAAO,eAAe,MAAM,sBAAsB,CAAC;AACnD,OAAO,gBAAgB,MAAM,uBAAuB,CAAC;AACrD,OAAO,cAAc,MAAM,qBAAqB,CAAC;AACjD,OAAO,YAAY,MAAM,mBAAmB,CAAC;AAC7C,OAAO,cAAc,MAAM,qBAAqB,CAAC;AACjD,OAAO,gBAAgB,MAAM,uBAAuB,CAAC;AACrD,OAAO,iBAAiB,MAAM,wBAAwB,CAAC;AACvD,OAAO,WAAW,MAAM,kBAAkB,CAAC;AAC3C,OAAO,gBAAgB,MAAM,uBAAuB,CAAC;AACrD,OAAO,oBAAoB,MAAM,2BAA2B,CAAC;AAC7D,OAAO,iBAAiB,MAAM,wBAAwB,CAAC;AACvD,OAAO,WAAW,MAAM,kBAAkB,CAAC;AAC3C,OAAO,EACL,IAAI,IAAI,MAAM,EACd,gBAAgB,IAAI,kBAAkB,EACtC,aAAa,IAAI,eAAe,EAChC,yBAAyB,IAAI,2BAA2B,EACxD,YAAY,IAAI,cAAc,EAC9B,kBAAkB,IAAI,oBAAoB,EAC1C,iBAAiB,IAAI,mBAAmB,EACxC,eAAe,IAAI,iBAAiB,EACpC,eAAe,IAAI,iBAAiB,EACpC,gBAAgB,IAAI,kBAAkB,EACtC,YAAY,IAAI,cAAc,EAC9B,cAAc,IAAI,gBAAgB,EAClC,cAAc,IAAI,gBAAgB,EAClC,gBAAgB,IAAI,kBAAkB,EACtC,iBAAiB,IAAI,mBAAmB,EACxC,WAAW,IAAI,aAAa,EAC5B,gBAAgB,IAAI,kBAAkB,EACtC,oBAAoB,IAAI,sBAAsB,EAC9C,iBAAiB,IAAI,mBAAmB,EACxC,WAAW,IAAI,aAAa,EAC5B,IAAI,EACJ,gBAAgB,EAChB,aAAa,EACb,yBAAyB,EACzB,YAAY,EACZ,kBAAkB,EAClB,iBAAiB,EACjB,eAAe,EACf,eAAe,EACf,gBAAgB,EAChB,YAAY,EACZ,cAAc,EACd,cAAc,EACd,gBAAgB,EAChB,iBAAiB,EACjB,WAAW,EACX,gBAAgB,EAChB,oBAAoB,EACpB,iBAAiB,EACjB,YAAY,EACZ,WAAW,GACZ,CAAC"}
+{"version":3,"file":"_exports.js","sourceRoot":"","sources":["../../../../src/js/dom/when/_exports.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,EAAE,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,gBAAgB,MAAM,uBAAuB,CAAC;AACrD,OAAO,aAAa,MAAM,oBAAoB,CAAC;AAC/C,OAAO,yBAAyB,MAAM,gCAAgC,CAAC;AACvE,OAAO,YAAY,MAAM,mBAAmB,CAAC;AAC7C,OAAO,kBAAkB,MAAM,yBAAyB,CAAC;AACzD,OAAO,iBAAiB,MAAM,wBAAwB,CAAC;AACvD,OAAO,eAAe,MAAM,sBAAsB,CAAC;AACnD,OAAO,eAAe,MAAM,sBAAsB,CAAC;AACnD,OAAO,gBAAgB,MAAM,uBAAuB,CAAC;AACrD,OAAO,cAAc,MAAM,qBAAqB,CAAC;AACjD,OAAO,YAAY,MAAM,mBAAmB,CAAC;AAC7C,OAAO,cAAc,MAAM,qBAAqB,CAAC;AACjD,OAAO,gBAAgB,MAAM,uBAAuB,CAAC;AACrD,OAAO,iBAAiB,MAAM,wBAAwB,CAAC;AACvD,OAAO,WAAW,MAAM,kBAAkB,CAAC;AAC3C,OAAO,gBAAgB,MAAM,uBAAuB,CAAC;AACrD,OAAO,oBAAoB,MAAM,2BAA2B,CAAC;AAC7D,OAAO,iBAAiB,MAAM,wBAAwB,CAAC;AACvD,OAAO,cAAc,MAAM,qBAAqB,CAAC;AACjD,OAAO,WAAW,MAAM,kBAAkB,CAAC;AAC3C,OAAO,EACL,IAAI,IAAI,MAAM,EACd,gBAAgB,IAAI,kBAAkB,EACtC,aAAa,IAAI,eAAe,EAChC,yBAAyB,IAAI,2BAA2B,EACxD,YAAY,IAAI,cAAc,EAC9B,kBAAkB,IAAI,oBAAoB,EAC1C,iBAAiB,IAAI,mBAAmB,EACxC,eAAe,IAAI,iBAAiB,EACpC,eAAe,IAAI,iBAAiB,EACpC,gBAAgB,IAAI,kBAAkB,EACtC,YAAY,IAAI,cAAc,EAC9B,cAAc,IAAI,gBAAgB,EAClC,cAAc,IAAI,gBAAgB,EAClC,gBAAgB,IAAI,kBAAkB,EACtC,iBAAiB,IAAI,mBAAmB,EACxC,WAAW,IAAI,aAAa,EAC5B,gBAAgB,IAAI,kBAAkB,EACtC,oBAAoB,IAAI,sBAAsB,EAC9C,iBAAiB,IAAI,mBAAmB,EACxC,cAAc,IAAI,gBAAgB,EAClC,WAAW,IAAI,aAAa,EAC5B,IAAI,EACJ,gBAAgB,EAChB,aAAa,EACb,yBAAyB,EACzB,YAAY,EACZ,kBAAkB,EAClB,iBAAiB,EACjB,eAAe,EACf,eAAe,EACf,gBAAgB,EAChB,YAAY,EACZ,cAAc,EACd,cAAc,EACd,gBAAgB,EAChB,iBAAiB,EACjB,WAAW,EACX,gBAAgB,EAChB,oBAAoB,EACpB,iBAAiB,EACjB,YAAY,EACZ,cAAc,EACd,WAAW,GACZ,CAAC"}

package/dist/js/dom/when/whenVideoReady.d.ts

@@ -0,0 +1,32 @@
+/**
+ * @name            whenVideoReady
+ * @namespace       js.dom.when
+ * @type            Function
+ * @platform        js
+ * @status          stable
+ *
+ * Wait until the passed video is ready to play.
+ * It checks if the video metadata has been loaded, and if not it waits for the `loadedmetadata` event.
+ *
+ * @feature         Promise based API
+ *
+ * @param 		{HTMLVideoElement} 			$video  		The video to check the ready state
+ * @return 		{Promise} 								    The promise that will be resolved when the video is ready to play
+ *
+ * @snippet         whenVideoReady($1)
+ * whenVideoReady($1).then(\$video => {
+ *   $2
+ * });
+ *
+ * @todo      tests
+ *
+ * @example  	js
+ * import { whenVideoReady } from '@blackbyte/sugar/dom'
+ * whenVideoReady($myCoolHTMLVideoElement).then(($video) => {
+ *   // do something when the video is ready to play
+ * });
+ *
+ * @since           1.0.0
+ * @author         Olivier Bossel <olivier.bossel@gmail.com> (https://blackbyte.space)
+ */
+export default function whenVideoReady($video: HTMLVideoElement): Promise<HTMLVideoElement>;

package/dist/js/dom/when/whenVideoReady.js

@@ -0,0 +1,44 @@
+/**
+ * @name            whenVideoReady
+ * @namespace       js.dom.when
+ * @type            Function
+ * @platform        js
+ * @status          stable
+ *
+ * Wait until the passed video is ready to play.
+ * It checks if the video metadata has been loaded, and if not it waits for the `loadedmetadata` event.
+ *
+ * @feature         Promise based API
+ *
+ * @param 		{HTMLVideoElement} 			$video  		The video to check the ready state
+ * @return 		{Promise} 								    The promise that will be resolved when the video is ready to play
+ *
+ * @snippet         whenVideoReady($1)
+ * whenVideoReady($1).then(\$video => {
+ *   $2
+ * });
+ *
+ * @todo      tests
+ *
+ * @example  	js
+ * import { whenVideoReady } from '@blackbyte/sugar/dom'
+ * whenVideoReady($myCoolHTMLVideoElement).then(($video) => {
+ *   // do something when the video is ready to play
+ * });
+ *
+ * @since           1.0.0
+ * @author         Olivier Bossel <olivier.bossel@gmail.com> (https://blackbyte.space)
+ */
+export default function whenVideoReady($video) {
+    return new Promise((resolve) => {
+        if ($video.duration > 0) {
+            resolve($video);
+        }
+        else {
+            $video.addEventListener('loadedmetadata', () => {
+                resolve($video);
+            });
+        }
+    });
+}
+//# sourceMappingURL=whenVideoReady.js.map

package/dist/js/dom/when/whenVideoReady.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"whenVideoReady.js","sourceRoot":"","sources":["../../../../src/js/dom/when/whenVideoReady.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,MAAM,CAAC,OAAO,UAAU,cAAc,CACpC,MAAwB;IAExB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,IAAI,MAAM,CAAC,QAAQ,GAAG,CAAC,EAAE,CAAC;YACxB,OAAO,CAAC,MAAM,CAAC,CAAC;QAClB,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,gBAAgB,CAAC,gBAAgB,EAAE,GAAG,EAAE;gBAC7C,OAAO,CAAC,MAAM,CAAC,CAAC;YAClB,CAAC,CAAC,CAAC;QACL,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/shared/extension/commonMediaFileExtensions.d.ts

@@ -7,7 +7,8 @@ import { type TCommonFileExtensionsSettings } from './commonFileExtensions.js';
  * @platform        js
  * @status          stable
  *
- * This function allows you to get an array of common media file extensions with or without the dot
+ * This function allows you to get an array of common media file extensions with or without the dot.
+ * This includes image, video and audio file extensions.
  *
  * @param       {TCommonFileExtensionsSettings}           [settings={}]         Settings to customize the function behavior
  * @return      {Array<String>}                           The array of extensions

package/dist/shared/extension/commonMediaFileExtensions.js

@@ -10,7 +10,8 @@ import commonVideoFileExtensions from './commonVideoFileExtensions.js';
  * @platform        js
  * @status          stable
  *
- * This function allows you to get an array of common media file extensions with or without the dot
+ * This function allows you to get an array of common media file extensions with or without the dot.
+ * This includes image, video and audio file extensions.
  *
  * @param       {TCommonFileExtensionsSettings}           [settings={}]         Settings to customize the function behavior
  * @return      {Array<String>}                           The array of extensions

package/dist/shared/extension/commonMediaFileExtensions.js.map

@@ -1 +1 @@
-{"version":3,"file":"commonMediaFileExtensions.js","sourceRoot":"","sources":["../../../src/shared/extension/commonMediaFileExtensions.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,oBAAoB,CAAC;AACxC,OAAO,yBAAyB,MAAM,gCAAgC,CAAC;AAEvE,OAAO,yBAAyB,MAAM,gCAAgC,CAAC;AACvE,OAAO,yBAAyB,MAAM,gCAAgC,CAAC;AAEvE;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,CAAC,OAAO,UAAU,yBAAyB,CAC/C,WAAmD,EAAE;IAErD,MAAM,aAAa,mBACjB,GAAG,EAAE,KAAK,EACV,OAAO,EAAE,EAAE,EACX,QAAQ,EAAE,KAAK,IACZ,QAAQ,CACZ,CAAC;IACF,OAAO,MAAM,CAAC;QACZ,GAAG,yBAAyB,CAAC,aAAa,CAAC;QAC3C,GAAG,yBAAyB,CAAC,aAAa,CAAC;QAC3C,GAAG,yBAAyB,CAAC,aAAa,CAAC;KAC5C,CAAC;SACC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,aAAa,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;SACrD,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,GAAG,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;AACzD,CAAC"}
+{"version":3,"file":"commonMediaFileExtensions.js","sourceRoot":"","sources":["../../../src/shared/extension/commonMediaFileExtensions.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,oBAAoB,CAAC;AACxC,OAAO,yBAAyB,MAAM,gCAAgC,CAAC;AAEvE,OAAO,yBAAyB,MAAM,gCAAgC,CAAC;AACvE,OAAO,yBAAyB,MAAM,gCAAgC,CAAC;AAEvE;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,CAAC,OAAO,UAAU,yBAAyB,CAC/C,WAAmD,EAAE;IAErD,MAAM,aAAa,mBACjB,GAAG,EAAE,KAAK,EACV,OAAO,EAAE,EAAE,EACX,QAAQ,EAAE,KAAK,IACZ,QAAQ,CACZ,CAAC;IACF,OAAO,MAAM,CAAC;QACZ,GAAG,yBAAyB,CAAC,aAAa,CAAC;QAC3C,GAAG,yBAAyB,CAAC,aAAa,CAAC;QAC3C,GAAG,yBAAyB,CAAC,aAAa,CAAC;KAC5C,CAAC;SACC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,aAAa,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;SACrD,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,GAAG,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;AACzD,CAAC"}

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

@@ -1,24 +1,24 @@
 import camelCaseProps from './camelCaseProps.js';
+import cleanDeep from './cleanDeep.js';
 import clone from './clone.js';
+import cloneInstance from './cloneInstance.js';
 import decycle from './decycle.js';
-import cleanDeep from './cleanDeep.js';
-import filterDeep from './filterDeep.js';
-import unflatten from './unflatten.js';
-import mapDeep from './mapDeep.js';
-import mergeDeep from './mergeDeep.js';
-import proxyDeep from './proxyDeep.js';
-import findDeep from './findDeep.js';
 import deleteProperty from './deleteProperty.js';
 import diff from './diff.js';
 import ensurePropertyExists from './ensurePropertyExists.js';
+import filterDeep from './filterDeep.js';
 import filterObject from './filterObject.js';
+import findDeep from './findDeep.js';
 import flatten from './flatten.js';
 import get from './get.js';
 import getGlob from './getGlob.js';
 import getKeyByValue from './getKeyByValue.js';
 import map from './map.js';
+import mapDeep from './mapDeep.js';
+import mergeDeep from './mergeDeep.js';
 import objectHash from './objectHash.js';
 import propertyProxy from './propertyProxy.js';
+import proxyDeep from './proxyDeep.js';
 import remove from './remove.js';
 import set from './set.js';
 import sort from './sort.js';
@@ -26,4 +26,5 @@ import sortDeep from './sortDeep.js';
 import toJson from './toJson.js';
 import toPlainObject from './toPlainObject.js';
 import toQueryString from './toQueryString.js';
-export { camelCaseProps as __camelCaseProps, clone as __clone, decycle as __decycle, cleanDeep as __cleanDeep, cleanDeep as __deepClean, filterDeep as __filterDeep, filterDeep as __deepFilter, unflatten as __unflatten, unflatten as __deepize, mapDeep as __deepMap, mapDeep as __mapDeep, mergeDeep as __mergeDeep, mergeDeep as __deepMerge, proxyDeep as __proxyDeep, proxyDeep as __deepProxy, findDeep as __findDeep, findDeep as __deepSearch, deleteProperty as __deleteProperty, diff as __diff, ensurePropertyExists as __ensurePropertyExists, filterObject as __filterObject, flatten as __flatten, get as __get, getGlob as __getGlob, getKeyByValue as __getKeyByValue, map as __map, objectHash as __objectHash, propertyProxy as __propertyProxy, remove as __remove, set as __set, sort as __sort, sortDeep as __sortDeep, toJson as __toJson, toPlainObject as __toPlainObject, toQueryString as __toQueryString, camelCaseProps, clone, decycle, cleanDeep, cleanDeep as deepClean, filterDeep, filterDeep as deepFilter, unflatten, unflatten as deepize, mapDeep, mapDeep as deepMap, mergeDeep, mergeDeep as deepMerge, proxyDeep, proxyDeep as deepProxy, findDeep, findDeep as deepSearch, deleteProperty, diff, ensurePropertyExists, filterObject, flatten, get, getGlob, getKeyByValue, map, objectHash, propertyProxy, remove, set, sort, sortDeep, toJson, toPlainObject, toQueryString, };
+import unflatten from './unflatten.js';
+export { camelCaseProps as __camelCaseProps, cleanDeep as __cleanDeep, clone as __clone, cloneInstance as __cloneInstance, decycle as __decycle, cleanDeep as __deepClean, filterDeep as __deepFilter, unflatten as __deepize, mapDeep as __deepMap, mergeDeep as __deepMerge, proxyDeep as __deepProxy, findDeep as __deepSearch, deleteProperty as __deleteProperty, diff as __diff, ensurePropertyExists as __ensurePropertyExists, filterDeep as __filterDeep, filterObject as __filterObject, findDeep as __findDeep, flatten as __flatten, get as __get, getGlob as __getGlob, getKeyByValue as __getKeyByValue, map as __map, mapDeep as __mapDeep, mergeDeep as __mergeDeep, objectHash as __objectHash, propertyProxy as __propertyProxy, proxyDeep as __proxyDeep, remove as __remove, set as __set, sort as __sort, sortDeep as __sortDeep, toJson as __toJson, toPlainObject as __toPlainObject, toQueryString as __toQueryString, unflatten as __unflatten, camelCaseProps, cleanDeep, clone, cloneInstance, decycle, cleanDeep as deepClean, filterDeep as deepFilter, unflatten as deepize, mapDeep as deepMap, mergeDeep as deepMerge, proxyDeep as deepProxy, findDeep as deepSearch, deleteProperty, diff, ensurePropertyExists, filterDeep, filterObject, findDeep, flatten, get, getGlob, getKeyByValue, map, mapDeep, mergeDeep, objectHash, propertyProxy, proxyDeep, remove, set, sort, sortDeep, toJson, toPlainObject, toQueryString, unflatten, };

package/dist/shared/object/_exports.js

@@ -1,24 +1,24 @@
 import camelCaseProps from './camelCaseProps.js';
+import cleanDeep from './cleanDeep.js';
 import clone from './clone.js';
+import cloneInstance from './cloneInstance.js';
 import decycle from './decycle.js';
-import cleanDeep from './cleanDeep.js';
-import filterDeep from './filterDeep.js';
-import unflatten from './unflatten.js';
-import mapDeep from './mapDeep.js';
-import mergeDeep from './mergeDeep.js';
-import proxyDeep from './proxyDeep.js';
-import findDeep from './findDeep.js';
 import deleteProperty from './deleteProperty.js';
 import diff from './diff.js';
 import ensurePropertyExists from './ensurePropertyExists.js';
+import filterDeep from './filterDeep.js';
 import filterObject from './filterObject.js';
+import findDeep from './findDeep.js';
 import flatten from './flatten.js';
 import get from './get.js';
 import getGlob from './getGlob.js';
 import getKeyByValue from './getKeyByValue.js';
 import map from './map.js';
+import mapDeep from './mapDeep.js';
+import mergeDeep from './mergeDeep.js';
 import objectHash from './objectHash.js';
 import propertyProxy from './propertyProxy.js';
+import proxyDeep from './proxyDeep.js';
 import remove from './remove.js';
 import set from './set.js';
 import sort from './sort.js';
@@ -26,5 +26,6 @@ import sortDeep from './sortDeep.js';
 import toJson from './toJson.js';
 import toPlainObject from './toPlainObject.js';
 import toQueryString from './toQueryString.js';
-export { camelCaseProps as __camelCaseProps, clone as __clone, decycle as __decycle, cleanDeep as __cleanDeep, cleanDeep as __deepClean, filterDeep as __filterDeep, filterDeep as __deepFilter, unflatten as __unflatten, unflatten as __deepize, mapDeep as __deepMap, mapDeep as __mapDeep, mergeDeep as __mergeDeep, mergeDeep as __deepMerge, proxyDeep as __proxyDeep, proxyDeep as __deepProxy, findDeep as __findDeep, findDeep as __deepSearch, deleteProperty as __deleteProperty, diff as __diff, ensurePropertyExists as __ensurePropertyExists, filterObject as __filterObject, flatten as __flatten, get as __get, getGlob as __getGlob, getKeyByValue as __getKeyByValue, map as __map, objectHash as __objectHash, propertyProxy as __propertyProxy, remove as __remove, set as __set, sort as __sort, sortDeep as __sortDeep, toJson as __toJson, toPlainObject as __toPlainObject, toQueryString as __toQueryString, camelCaseProps, clone, decycle, cleanDeep, cleanDeep as deepClean, filterDeep, filterDeep as deepFilter, unflatten, unflatten as deepize, mapDeep, mapDeep as deepMap, mergeDeep, mergeDeep as deepMerge, proxyDeep, proxyDeep as deepProxy, findDeep, findDeep as deepSearch, deleteProperty, diff, ensurePropertyExists, filterObject, flatten, get, getGlob, getKeyByValue, map, objectHash, propertyProxy, remove, set, sort, sortDeep, toJson, toPlainObject, toQueryString, };
+import unflatten from './unflatten.js';
+export { camelCaseProps as __camelCaseProps, cleanDeep as __cleanDeep, clone as __clone, cloneInstance as __cloneInstance, decycle as __decycle, cleanDeep as __deepClean, filterDeep as __deepFilter, unflatten as __deepize, mapDeep as __deepMap, mergeDeep as __deepMerge, proxyDeep as __deepProxy, findDeep as __deepSearch, deleteProperty as __deleteProperty, diff as __diff, ensurePropertyExists as __ensurePropertyExists, filterDeep as __filterDeep, filterObject as __filterObject, findDeep as __findDeep, flatten as __flatten, get as __get, getGlob as __getGlob, getKeyByValue as __getKeyByValue, map as __map, mapDeep as __mapDeep, mergeDeep as __mergeDeep, objectHash as __objectHash, propertyProxy as __propertyProxy, proxyDeep as __proxyDeep, remove as __remove, set as __set, sort as __sort, sortDeep as __sortDeep, toJson as __toJson, toPlainObject as __toPlainObject, toQueryString as __toQueryString, unflatten as __unflatten, camelCaseProps, cleanDeep, clone, cloneInstance, decycle, cleanDeep as deepClean, filterDeep as deepFilter, unflatten as deepize, mapDeep as deepMap, mergeDeep as deepMerge, proxyDeep as deepProxy, findDeep as deepSearch, deleteProperty, diff, ensurePropertyExists, filterDeep, filterObject, findDeep, flatten, get, getGlob, getKeyByValue, map, mapDeep, mergeDeep, objectHash, propertyProxy, proxyDeep, remove, set, sort, sortDeep, toJson, toPlainObject, toQueryString, unflatten, };
 //# sourceMappingURL=_exports.js.map

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

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

package/dist/shared/object/cloneInstance.d.ts

@@ -0,0 +1,26 @@
+/**
+ * @name                cloneInstance
+ * @namespace           shared.object
+ * @type                Function
+ * @platform            js
+ * @platform            node
+ * @status              stable
+ *
+ * This function allows you to clone an object instance.
+ *
+ * @param       {Object}        instance        The object instance to clone
+ * @return      {Object}                      The cloned object
+ *
+ * @todo      tests
+ *
+ * @snippet         cloneInstance($1)
+ *
+ * @example       js
+ * import { cloneInstance } from '@blackbyte/sugar/object';
+ * const myInstance = new MyClass();
+ * const myInstanceClone = cloneInstance(myInstance);
+ *
+ * @since           1.0.0
+ * @author         Olivier Bossel <olivier.bossel@gmail.com> (https://blackbyte.space)
+ */
+export default function cloneInstance<T = any>(instance: T): T;

package/dist/shared/object/cloneInstance.js

@@ -0,0 +1,29 @@
+/**
+ * @name                cloneInstance
+ * @namespace           shared.object
+ * @type                Function
+ * @platform            js
+ * @platform            node
+ * @status              stable
+ *
+ * This function allows you to clone an object instance.
+ *
+ * @param       {Object}        instance        The object instance to clone
+ * @return      {Object}                      The cloned object
+ *
+ * @todo      tests
+ *
+ * @snippet         cloneInstance($1)
+ *
+ * @example       js
+ * import { cloneInstance } from '@blackbyte/sugar/object';
+ * const myInstance = new MyClass();
+ * const myInstanceClone = cloneInstance(myInstance);
+ *
+ * @since           1.0.0
+ * @author         Olivier Bossel <olivier.bossel@gmail.com> (https://blackbyte.space)
+ */
+export default function cloneInstance(instance) {
+    return Object.assign(Object.create(Object.getPrototypeOf(instance)), instance);
+}
+//# sourceMappingURL=cloneInstance.js.map

package/dist/shared/object/cloneInstance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cloneInstance.js","sourceRoot":"","sources":["../../../src/shared/object/cloneInstance.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,CAAC,OAAO,UAAU,aAAa,CAAU,QAAW;IACxD,OAAO,MAAM,CAAC,MAAM,CAClB,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC,EAC9C,QAAQ,CACT,CAAC;AACJ,CAAC"}

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

@@ -1,5 +1,6 @@
+import getYoutubeVideoIdFromUrl from './getYoutubeVideoIdFromUrl.js';
 import gravatarUrl from './gravatarUrl.js';
 import parseSchema from './parseSchema.js';
 import queryStringToObject from './queryStringToObject.js';
 import urlFromString from './urlFromString.js';
-export { gravatarUrl, parseSchema, queryStringToObject, urlFromString, gravatarUrl as __gravatarUrl, parseSchema as __parseSchema, queryStringToObject as __queryStringToObject, urlFromString as __urlFromString, };
+export { getYoutubeVideoIdFromUrl as __getYoutubeVideoIdFromUrl, gravatarUrl as __gravatarUrl, parseSchema as __parseSchema, queryStringToObject as __queryStringToObject, urlFromString as __urlFromString, getYoutubeVideoIdFromUrl, gravatarUrl, parseSchema, queryStringToObject, urlFromString, };

package/dist/shared/url/_exports.js

@@ -1,6 +1,7 @@
+import getYoutubeVideoIdFromUrl from './getYoutubeVideoIdFromUrl.js';
 import gravatarUrl from './gravatarUrl.js';
 import parseSchema from './parseSchema.js';
 import queryStringToObject from './queryStringToObject.js';
 import urlFromString from './urlFromString.js';
-export { gravatarUrl, parseSchema, queryStringToObject, urlFromString, gravatarUrl as __gravatarUrl, parseSchema as __parseSchema, queryStringToObject as __queryStringToObject, urlFromString as __urlFromString, };
+export { getYoutubeVideoIdFromUrl as __getYoutubeVideoIdFromUrl, gravatarUrl as __gravatarUrl, parseSchema as __parseSchema, queryStringToObject as __queryStringToObject, urlFromString as __urlFromString, getYoutubeVideoIdFromUrl, gravatarUrl, parseSchema, queryStringToObject, urlFromString, };
 //# sourceMappingURL=_exports.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"_exports.js","sourceRoot":"","sources":["../../../src/shared/url/_exports.ts"],"names":[],"mappings":"AAAA,OAAO,WAAW,MAAM,kBAAkB,CAAC;AAC3C,OAAO,WAAW,MAAM,kBAAkB,CAAC;AAC3C,OAAO,mBAAmB,MAAM,0BAA0B,CAAC;AAC3D,OAAO,aAAa,MAAM,oBAAoB,CAAC;AAE/C,OAAO,EACL,WAAW,EACX,WAAW,EACX,mBAAmB,EACnB,aAAa,EACb,WAAW,IAAI,aAAa,EAC5B,WAAW,IAAI,aAAa,EAC5B,mBAAmB,IAAI,qBAAqB,EAC5C,aAAa,IAAI,eAAe,GACjC,CAAC"}
+{"version":3,"file":"_exports.js","sourceRoot":"","sources":["../../../src/shared/url/_exports.ts"],"names":[],"mappings":"AAAA,OAAO,wBAAwB,MAAM,+BAA+B,CAAC;AACrE,OAAO,WAAW,MAAM,kBAAkB,CAAC;AAC3C,OAAO,WAAW,MAAM,kBAAkB,CAAC;AAC3C,OAAO,mBAAmB,MAAM,0BAA0B,CAAC;AAC3D,OAAO,aAAa,MAAM,oBAAoB,CAAC;AAE/C,OAAO,EACL,wBAAwB,IAAI,0BAA0B,EACtD,WAAW,IAAI,aAAa,EAC5B,WAAW,IAAI,aAAa,EAC5B,mBAAmB,IAAI,qBAAqB,EAC5C,aAAa,IAAI,eAAe,EAChC,wBAAwB,EACxB,WAAW,EACX,WAAW,EACX,mBAAmB,EACnB,aAAa,GACd,CAAC"}

package/dist/shared/url/getYoutubeVideoIdFromUrl.d.ts

@@ -0,0 +1,26 @@
+/**
+ * @name                getYoutubeVideoIdFromUrl
+ * @namespace           shared.url
+ * @type                Function
+ * @platform            js
+ * @platform            node
+ * @status              stable
+ *
+ * Return a YouTube video ID extracted from the given URL
+ *
+ * @param           {String}            url               The YouTube video URL
+ * @return          {String|null}                      The extracted video ID or null if not found
+ *
+ * @todo            tests
+ *
+ * @snippet         getYoutubeVideoIdFromUrl($1)
+ *
+ * @example       js
+ * import { getYoutubeVideoIdFromUrl } from '@blackbyte/sugar/url';
+ * getYoutubeVideoIdFromUrl('https://www.youtube.com/watch?v=dQw4w9WgXcQ'); // dQw4w9WgXcQ
+ *
+ * @see             https://stackoverflow.com/questions/3452546/how-do-i-get-the-youtube-video-id-from-a-url
+ * @since           1.0.0
+ * @author          Olivier Bossel <olivier.bossel@gmail.com> (https://blackbyte.space)
+ */
+export default function getYoutubeVideoIdFromUrl(url: string): string | null;

package/dist/shared/url/getYoutubeVideoIdFromUrl.js

@@ -0,0 +1,31 @@
+/**
+ * @name                getYoutubeVideoIdFromUrl
+ * @namespace           shared.url
+ * @type                Function
+ * @platform            js
+ * @platform            node
+ * @status              stable
+ *
+ * Return a YouTube video ID extracted from the given URL
+ *
+ * @param           {String}            url               The YouTube video URL
+ * @return          {String|null}                      The extracted video ID or null if not found
+ *
+ * @todo            tests
+ *
+ * @snippet         getYoutubeVideoIdFromUrl($1)
+ *
+ * @example       js
+ * import { getYoutubeVideoIdFromUrl } from '@blackbyte/sugar/url';
+ * getYoutubeVideoIdFromUrl('https://www.youtube.com/watch?v=dQw4w9WgXcQ'); // dQw4w9WgXcQ
+ *
+ * @see             https://stackoverflow.com/questions/3452546/how-do-i-get-the-youtube-video-id-from-a-url
+ * @since           1.0.0
+ * @author          Olivier Bossel <olivier.bossel@gmail.com> (https://blackbyte.space)
+ */
+export default function getYoutubeVideoIdFromUrl(url) {
+    var regExp = /^.*((youtu.be\/)|(v\/)|(\/u\/\w\/)|(embed\/)|(watch\?))\??v?=?([^#&?]*).*/;
+    var match = url.match(regExp);
+    return match && match[7].length == 11 ? match[7] : null;
+}
+//# sourceMappingURL=getYoutubeVideoIdFromUrl.js.map

package/dist/shared/url/getYoutubeVideoIdFromUrl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getYoutubeVideoIdFromUrl.js","sourceRoot":"","sources":["../../../src/shared/url/getYoutubeVideoIdFromUrl.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,CAAC,OAAO,UAAU,wBAAwB,CAAC,GAAW;IAC1D,IAAI,MAAM,GACR,2EAA2E,CAAC;IAC9E,IAAI,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAC9B,OAAO,KAAK,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AAC1D,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.13",
+  "version": "1.0.0-beta.16",
   "keywords": [
     "javascript",
     "typescript",