@thednp/shorty 1.0.0

package/src/misc/tryWrapper.js

@@ -0,0 +1,11 @@
+/**
+ * Utility to wrap a callback in a try() catch(e)
+ *
+ * @param {Function} fn callback
+ * @param {string} origin callback context description
+ */
+export default function tryWrapper(fn, origin) {
+  try { fn(); } catch (e) {
+    throw TypeError(`${origin} ${e}`);
+  }
+}

package/src/misc/version.js

@@ -0,0 +1,9 @@
+// @ts-ignore
+import { version } from '../../package.json';
+
+/**
+ * A global namespace for library version.
+ * @type {string}
+ */
+const Version = version;
+export default Version;

package/src/selectors/closest.js

@@ -0,0 +1,16 @@
+/**
+ * Shortcut for `HTMLElement.closest` method which also works
+ * with children of `ShadowRoot`. The order of the parameters
+ * is intentional since they're both required.
+ *
+ * @see https://stackoverflow.com/q/54520554/803358
+ *
+ * @param {HTMLElement | Element} element Element to look into
+ * @param {string} selector the selector name
+ * @return {(HTMLElement | Element)?} the query result
+ */
+export default function closest(element, selector) {
+  return element ? (element.closest(selector)
+    // @ts-ignore -- break out of `ShadowRoot`
+    || closest(element.getRootNode().host, selector)) : null;
+}

package/src/selectors/documentAll.js

@@ -0,0 +1,8 @@
+import getElementsByTagName from './getElementsByTagName';
+
+/**
+ * An `HTMLCollection` with all document elements,
+ * which is the equivalent of `document.all`.
+ */
+const documentAll = getElementsByTagName('*');
+export default documentAll;

package/src/selectors/elementNodes.js

@@ -0,0 +1,5 @@
+/**
+ * A global array with `Element` | `HTMLElement`.
+ */
+const elementNodes = [Element, HTMLElement];
+export default elementNodes;

package/src/selectors/getCustomElements.js

@@ -0,0 +1,18 @@
+import documentAll from './documentAll';
+import isCustomElement from '../is/isCustomElement';
+import parentNodes from './parentNodes';
+import getElementsByTagName from './getElementsByTagName';
+
+/**
+ * Returns an `Array` of `Node` elements that are registered as
+ * `CustomElement`.
+ * @see https://stackoverflow.com/questions/27334365/how-to-get-list-of-registered-custom-elements
+ *
+ * @param {(HTMLElement | Element | Node | Document)=} parent parent to look into
+ * @returns {Array<HTMLElement | Element>} the query result
+ */
+export default function getCustomElements(parent) {
+  const collection = parent && parentNodes.some((x) => parent instanceof x)
+    ? getElementsByTagName('*', parent) : documentAll;
+  return [...collection].filter(isCustomElement);
+}

package/src/selectors/getElementById.js

@@ -0,0 +1,11 @@
+import getDocument from '../get/getDocument';
+
+/**
+ * Returns an `Element` that matches the id in the document.
+ *
+ * @param {string} id
+ * @returns {(HTMLElement | Element)?}
+ */
+export default function getElementById(id) {
+  return getDocument().getElementById(id);
+}

package/src/selectors/getElementsByClassName.js

@@ -0,0 +1,15 @@
+import getDocument from '../get/getDocument';
+
+/**
+ * Shortcut for `HTMLElement.getElementsByClassName` method. Some `Node` elements
+ * like `ShadowRoot` do not support `getElementsByClassName`.
+ *
+ * @param {string} selector the class name
+ * @param {(HTMLElement | Element | Document)=} parent optional Element to look into
+ * @return {HTMLCollectionOf<HTMLElement | Element>} the 'HTMLCollection'
+ */
+export default function getElementsByClassName(selector, parent) {
+  const method = 'getElementsByClassName';
+  const lookUp = parent && parent[method] ? parent : getDocument();
+  return lookUp[method](selector);
+}

package/src/selectors/getElementsByTagName.js

@@ -0,0 +1,15 @@
+import getDocument from '../get/getDocument';
+
+/**
+ * Shortcut for `HTMLElement.getElementsByTagName` method. Some `Node` elements
+ * like `ShadowRoot` do not support `getElementsByTagName`.
+ *
+ * @param {string} selector the tag name
+ * @param {(HTMLElement | Element | Document)=} parent optional Element to look into
+ * @return {HTMLCollectionOf<HTMLElement | Element>} the 'HTMLCollection'
+ */
+export default function getElementsByTagName(selector, parent) {
+  const method = 'getElementsByTagName';
+  const lookUp = parent && parent[method] ? parent : getDocument();
+  return lookUp[method](selector);
+}

package/src/selectors/matches.js

@@ -0,0 +1,10 @@
+/**
+ * Check if element matches a CSS selector.
+ *
+ * @param {HTMLElement | Element} target
+ * @param {string} selector
+ * @returns {boolean}
+ */
+export default function matches(target, selector) {
+  return target.matches(selector);
+}

package/src/selectors/matchesLegacy.js

@@ -0,0 +1,23 @@
+// @ts-nocheck
+const ElementProto = Element.prototype;
+const matchesFn = ElementProto.matches
+  || ElementProto.matchesSelector
+  || ElementProto.webkitMatchesSelector
+  || ElementProto.mozMatchesSelector
+  || ElementProto.msMatchesSelector
+  || ElementProto.oMatchesSelector
+  || function matchesNotSupported() {
+    return false;
+  };
+
+/**
+ * Check if element matches a CSS selector,
+ * supporting a range of legacy browsers.
+ *
+ * @param {HTMLElement | Element} target
+ * @param {string} selector
+ * @returns {boolean}
+ */
+export default function matches(target, selector) {
+  return matchesFn.call(target, selector);
+}

package/src/selectors/parentNodes.js

@@ -0,0 +1,5 @@
+/**
+ * A global array of possible `ParentNode`.
+ */
+const parentNodes = [Document, Element, HTMLElement];
+export default parentNodes;

package/src/selectors/querySelector.js

@@ -0,0 +1,15 @@
+import getDocument from '../get/getDocument';
+
+/**
+ * Utility to check if target is typeof `HTMLElement`, `Element`, `Node`
+ * or find one that matches a selector.
+ *
+ * @param {HTMLElement | Element | string} selector the input selector or target element
+ * @param {(HTMLElement | Element | Document)=} parent optional node to look into
+ * @return {(HTMLElement | Element)?} the `HTMLElement` or `querySelector` result
+ */
+export default function querySelector(selector, parent) {
+  const method = 'querySelector';
+  const lookUp = parent && parent[method] ? parent : getDocument();
+  return selector[method] ? selector : lookUp[method](selector);
+}

package/src/selectors/querySelectorAll.js

@@ -0,0 +1,14 @@
+import getDocument from '../get/getDocument';
+
+/**
+ * A shortcut for `(document|Element).querySelectorAll`.
+ *
+ * @param {string} selector the input selector
+ * @param {(HTMLElement | Element | Document | Node)=} parent optional node to look into
+ * @return {NodeListOf<HTMLElement | Element>} the query result
+ */
+export default function querySelectorAll(selector, parent) {
+  const method = 'querySelectorAll';
+  const lookUp = parent && parent[method] ? parent : getDocument();
+  return lookUp[method](selector);
+}

package/src/strings/DOMContentLoadedEvent.js

@@ -0,0 +1,6 @@
+/**
+ * A global namespace for `DOMContentLoaded` event.
+ * @type {string}
+ */
+const DOMContentLoadedEvent = 'DOMContentLoaded';
+export default DOMContentLoadedEvent;

package/src/strings/DOMMouseScrollEvent.js

@@ -0,0 +1,6 @@
+/**
+ * A global namespace for `DOMMouseScroll` event.
+ * @type {string}
+ */
+const DOMMouseScrollEvent = 'DOMMouseScroll';
+export default DOMMouseScrollEvent;

package/src/strings/abortEvent.js

@@ -0,0 +1,6 @@
+/**
+ * A global namespace for `abort` event.
+ * @type {string}
+ */
+const abortEvent = 'abort';
+export default abortEvent;

package/src/strings/addEventListener.js

@@ -0,0 +1,6 @@
+/**
+ * A global namespace for 'addEventListener' string.
+ * @type {string}
+ */
+const addEventListener = 'addEventListener';
+export default addEventListener;

package/src/strings/animationDelay.js

@@ -0,0 +1,6 @@
+/**
+ * A global namespace for 'animationDelay' string.
+ * @type {string}
+ */
+const animationDelay = 'animationDelay';
+export default animationDelay;

package/src/strings/animationDelayLegacy.js

@@ -0,0 +1,8 @@
+import documentHead from '../blocks/documentHead';
+
+/**
+ * A global namespace for 'animationDelay' string.
+ * @type {string}
+ */
+const animationDelay = 'webkitAnimation' in documentHead.style ? 'webkitAnimationDelay' : 'animationDelay';
+export default animationDelay;

package/src/strings/animationDuration.js

@@ -0,0 +1,6 @@
+/**
+ * A global namespace for 'animationDuration' string.
+ * @type {string}
+ */
+const animationDuration = 'animationDuration';
+export default animationDuration;

package/src/strings/animationDurationLegacy.js

@@ -0,0 +1,8 @@
+import documentHead from '../blocks/documentHead';
+
+/**
+ * A global namespace for 'animationDuration' string.
+ * @type {string}
+ */
+const animationDuration = 'webkitAnimation' in documentHead.style ? 'webkitAnimationDuration' : 'animationDuration';
+export default animationDuration;

package/src/strings/animationEndEvent.js

@@ -0,0 +1,6 @@
+/**
+ * A global namespace for 'animationend' string.
+ * @type {string}
+ */
+const animationEndEvent = 'animationend';
+export default animationEndEvent;

package/src/strings/animationEndEventLegacy.js

@@ -0,0 +1,8 @@
+import documentHead from '../blocks/documentHead';
+
+/**
+ * A global namespace for 'animationend' string.
+ * @type {string}
+ */
+const animationEndEvent = 'webkitAnimation' in documentHead.style ? 'webkitAnimationEnd' : 'animationend';
+export default animationEndEvent;

package/src/strings/animationName.js

@@ -0,0 +1,6 @@
+/**
+ * A global namespace for 'animationName' string.
+ * @type {string}
+ */
+const animationName = 'animationName';
+export default animationName;

package/src/strings/animationNameLegacy.js

@@ -0,0 +1,8 @@
+import documentHead from '../blocks/documentHead';
+
+/**
+ * A global namespace for 'animationName' string.
+ * @type {string}
+ */
+const animationName = 'webkitAnimation' in documentHead.style ? 'webkitAnimationName' : 'animationName';
+export default animationName;

package/src/strings/ariaChecked.js

@@ -0,0 +1,6 @@
+/**
+ * A global namespace for aria-checked.
+ * @type {string}
+ */
+const ariaChecked = 'aria-checked';
+export default ariaChecked;

package/src/strings/ariaDescribedBy.js

@@ -0,0 +1,6 @@
+/**
+ * A global namespace for aria-describedby.
+ * @type {string}
+ */
+const ariaDescribedBy = 'aria-describedby';
+export default ariaDescribedBy;

package/src/strings/ariaDescription.js

@@ -0,0 +1,6 @@
+/**
+ * A global namespace for aria-description.
+ * @type {string}
+ */
+const ariaDescription = 'aria-description';
+export default ariaDescription;

package/src/strings/ariaExpanded.js

@@ -0,0 +1,6 @@
+/**
+ * A global namespace for aria-expanded.
+ * @type {string}
+ */
+const ariaExpanded = 'aria-expanded';
+export default ariaExpanded;

package/src/strings/ariaHasPopup.js

@@ -0,0 +1,6 @@
+/**
+ * A global namespace for aria-haspopup.
+ * @type {string}
+ */
+const ariaHasPopup = 'aria-haspopup';
+export default ariaHasPopup;

package/src/strings/ariaHidden.js

@@ -0,0 +1,6 @@
+/**
+ * A global namespace for aria-hidden.
+ * @type {string}
+ */
+const ariaHidden = 'aria-hidden';
+export default ariaHidden;

package/src/strings/ariaLabel.js

@@ -0,0 +1,6 @@
+/**
+ * A global namespace for aria-label.
+ * @type {string}
+ */
+const ariaLabel = 'aria-label';
+export default ariaLabel;

package/src/strings/ariaLabelledBy.js

@@ -0,0 +1,6 @@
+/**
+ * A global namespace for aria-labelledby.
+ * @type {string}
+ */
+const ariaLabelledBy = 'aria-labelledby';
+export default ariaLabelledBy;

package/src/strings/ariaModal.js

@@ -0,0 +1,6 @@
+/**
+ * A global namespace for aria-modal.
+ * @type {string}
+ */
+const ariaModal = 'aria-modal';
+export default ariaModal;

package/src/strings/ariaPressed.js

@@ -0,0 +1,6 @@
+/**
+ * A global namespace for aria-pressed.
+ * @type {string}
+ */
+const ariaPressed = 'aria-pressed';
+export default ariaPressed;

package/src/strings/ariaSelected.js

@@ -0,0 +1,6 @@
+/**
+ * A global namespace for aria-selected.
+ * @type {string}
+ */
+const ariaSelected = 'aria-selected';
+export default ariaSelected;

package/src/strings/ariaValueMax.js

@@ -0,0 +1,6 @@
+/**
+ * A global namespace for aria-valuemax.
+ * @type {string}
+ */
+const ariaValueMax = 'aria-valuemax';
+export default ariaValueMax;

package/src/strings/ariaValueMin.js

@@ -0,0 +1,6 @@
+/**
+ * A global namespace for aria-valuemin.
+ * @type {string}
+ */
+const ariaValueMin = 'aria-valuemin';
+export default ariaValueMin;

package/src/strings/ariaValueNow.js

@@ -0,0 +1,6 @@
+/**
+ * A global namespace for aria-valuenow.
+ * @type {string}
+ */
+const ariaValueNow = 'aria-valuenow';
+export default ariaValueNow;

package/src/strings/ariaValueText.js

@@ -0,0 +1,6 @@
+/**
+ * A global namespace for aria-valuetext.
+ * @type {string}
+ */
+const ariaValueText = 'aria-valuetext';
+export default ariaValueText;

package/src/strings/beforeunloadEvent.js

@@ -0,0 +1,6 @@
+/**
+ * A global namespace for `beforeunload` event.
+ * @type {string}
+ */
+const beforeunloadEvent = 'beforeunload';
+export default beforeunloadEvent;

package/src/strings/bezierEasings.js

@@ -0,0 +1,33 @@
+/**
+ * A global namespace for predefined
+ * CSS3 'cubic-bezier()' easing functions.
+ * @type {Record<string, string>}
+ */
+const bezierEasings = {
+  linear: 'linear',
+  easingSinusoidalIn: 'cubic-bezier(0.47,0,0.745,0.715)',
+  easingSinusoidalOut: 'cubic-bezier(0.39,0.575,0.565,1)',
+  easingSinusoidalInOut: 'cubic-bezier(0.445,0.05,0.55,0.95)',
+  easingQuadraticIn: 'cubic-bezier(0.550,0.085,0.680,0.530)',
+  easingQuadraticOut: 'cubic-bezier(0.250,0.460,0.450,0.940)',
+  easingQuadraticInOut: 'cubic-bezier(0.455,0.030,0.515,0.955)',
+  easingCubicIn: 'cubic-bezier(0.55,0.055,0.675,0.19)',
+  easingCubicOut: 'cubic-bezier(0.215,0.61,0.355,1)',
+  easingCubicInOut: 'cubic-bezier(0.645,0.045,0.355,1)',
+  easingQuarticIn: 'cubic-bezier(0.895,0.03,0.685,0.22)',
+  easingQuarticOut: 'cubic-bezier(0.165,0.84,0.44,1)',
+  easingQuarticInOut: 'cubic-bezier(0.77,0,0.175,1)',
+  easingQuinticIn: 'cubic-bezier(0.755,0.05,0.855,0.06)',
+  easingQuinticOut: 'cubic-bezier(0.23,1,0.32,1)',
+  easingQuinticInOut: 'cubic-bezier(0.86,0,0.07,1)',
+  easingExponentialIn: 'cubic-bezier(0.95,0.05,0.795,0.035)',
+  easingExponentialOut: 'cubic-bezier(0.19,1,0.22,1)',
+  easingExponentialInOut: 'cubic-bezier(1,0,0,1)',
+  easingCircularIn: 'cubic-bezier(0.6,0.04,0.98,0.335)',
+  easingCircularOut: 'cubic-bezier(0.075,0.82,0.165,1)',
+  easingCircularInOut: 'cubic-bezier(0.785,0.135,0.15,0.86)',
+  easingBackIn: 'cubic-bezier(0.6,-0.28,0.735,0.045)',
+  easingBackOut: 'cubic-bezier(0.175,0.885,0.32,1.275)',
+  easingBackInOut: 'cubic-bezier(0.68,-0.55,0.265,1.55)',
+};
+export default bezierEasings;

package/src/strings/blurEvent.js

@@ -0,0 +1,6 @@
+/**
+ * A global namespace for `blur` event.
+ * @type {string}
+ */
+const blurEvent = 'blur';
+export default blurEvent;

package/src/strings/changeEvent.js

@@ -0,0 +1,6 @@
+/**
+ * A global namespace for `change` event.
+ * @type {string}
+ */
+const changeEvent = 'change';
+export default changeEvent;

package/src/strings/contextmenuEvent.js

@@ -0,0 +1,6 @@
+/**
+ * A global namespace for `contextmenu` event.
+ * @type {string}
+ */
+const contextmenuEvent = 'contextmenu';
+export default contextmenuEvent;

package/src/strings/errorEvent.js

@@ -0,0 +1,6 @@
+/**
+ * A global namespace for `error` event.
+ * @type {string}
+ */
+const errorEvent = 'error';
+export default errorEvent;

package/src/strings/focusEvent.js

@@ -0,0 +1,6 @@
+/**
+ * A global namespace for `focus` event.
+ * @type {string}
+ */
+const focusEvent = 'focus';
+export default focusEvent;

package/src/strings/focusEvents.js

@@ -0,0 +1,6 @@
+/**
+ * A global namespace for focus event names.
+ * @type {{in: string, out: string}}
+ */
+const focusEvents = { in: 'focusin', out: 'focusout' };
+export default focusEvents;

package/src/strings/focusinEvent.js

@@ -0,0 +1,6 @@
+/**
+ * A global namespace for `focusin` event.
+ * @type {string}
+ */
+const focusinEvent = 'focusin';
+export default focusinEvent;

package/src/strings/focusoutEvent.js

@@ -0,0 +1,6 @@
+/**
+ * A global namespace for `focusout` event.
+ * @type {string}
+ */
+const focusoutEvent = 'focusout';
+export default focusoutEvent;

package/src/strings/gesturechangeEvent.js

@@ -0,0 +1,6 @@
+/**
+ * A global namespace for `gesturechange` event.
+ * @type {string}
+ */
+const gesturechangeEvent = 'gesturechange';
+export default gesturechangeEvent;

package/src/strings/gestureendEvent.js

@@ -0,0 +1,6 @@
+/**
+ * A global namespace for `gestureend` event.
+ * @type {string}
+ */
+const gestureendEvent = 'gestureend';
+export default gestureendEvent;

package/src/strings/gesturestartEvent.js

@@ -0,0 +1,6 @@
+/**
+ * A global namespace for `gesturestart` event.
+ * @type {string}
+ */
+const gesturestartEvent = 'gesturestart';
+export default gesturestartEvent;

package/src/strings/keyAlt.js

@@ -0,0 +1,7 @@
+/**
+ * A global namespace for `Alt` key.
+ * @type {string} e.which = 18
+ */
+const keyAlt = 'Alt';
+
+export default keyAlt;

package/src/strings/keyArrowDown.js

@@ -0,0 +1,7 @@
+/**
+ * A global namespace for `ArrowDown` key.
+ * @type {string} e.which = 40 equivalent
+ */
+const keyArrowDown = 'ArrowDown';
+
+export default keyArrowDown;

package/src/strings/keyArrowLeft.js

@@ -0,0 +1,7 @@
+/**
+ * A global namespace for `ArrowLeft` key.
+ * @type {string} e.which = 37 equivalent
+ */
+const keyArrowLeft = 'ArrowLeft';
+
+export default keyArrowLeft;

package/src/strings/keyArrowRight.js

@@ -0,0 +1,7 @@
+/**
+ * A global namespace for `ArrowRight` key.
+ * @type {string} e.which = 39 equivalent
+ */
+const keyArrowRight = 'ArrowRight';
+
+export default keyArrowRight;

package/src/strings/keyArrowUp.js

@@ -0,0 +1,7 @@
+/**
+ * A global namespace for `ArrowUp` key.
+ * @type {string} e.which = 38 equivalent
+ */
+const keyArrowUp = 'ArrowUp';
+
+export default keyArrowUp;

package/src/strings/keyBackspace.js

@@ -0,0 +1,7 @@
+/**
+ * A global namespace for `Backspace` key.
+ * @type {string} e.which === 8 equivalent
+ */
+const keyBackspace = 'Backspace';
+
+export default keyBackspace;

package/src/strings/keyCapsLock.js

@@ -0,0 +1,7 @@
+/**
+ * A global namespace for `CapsLock` key.
+ * @type {string} e.which = 20 equivalent
+ */
+const keyCapsLock = 'CapsLock';
+
+export default keyCapsLock;

package/src/strings/keyControl.js

@@ -0,0 +1,7 @@
+/**
+ * A global namespace for `Control` key.
+ * @type {string} e.which = 17
+ */
+const keyControl = 'Control';
+
+export default keyControl;

package/src/strings/keyDelete.js

@@ -0,0 +1,7 @@
+/**
+ * A global namespace for `Delete` key.
+ * @type {string} e.which = 46 equivalent
+ */
+const keyDelete = 'Delete';
+
+export default keyDelete;

package/src/strings/keyEnter.js

@@ -0,0 +1,7 @@
+/**
+ * A global namespace for `Enter` key.
+ * @type {string} e.which = 13 equivalent
+ */
+const keyEnter = 'Enter';
+
+export default keyEnter;