@gsc-basic/utils 1.0.0 → 1.0.1

package/node_modules/resize-observer-polyfill/src/index.d.ts

@@ -0,0 +1,40 @@
+interface DOMRectReadOnly {
+    readonly x: number;
+    readonly y: number;
+    readonly width: number;
+    readonly height: number;
+    readonly top: number;
+    readonly right: number;
+    readonly bottom: number;
+    readonly left: number;
+}
+
+declare global {
+    interface ResizeObserverCallback {
+        (entries: ResizeObserverEntry[], observer: ResizeObserver): void
+    }
+
+    interface ResizeObserverEntry {
+        readonly target: Element;
+        readonly contentRect: DOMRectReadOnly;
+    }
+
+    interface ResizeObserver {
+        observe(target: Element): void;
+        unobserve(target: Element): void;
+        disconnect(): void;
+    }
+}
+
+declare var ResizeObserver: {
+    prototype: ResizeObserver;
+    new(callback: ResizeObserverCallback): ResizeObserver;
+}
+
+interface ResizeObserver {
+    observe(target: Element): void;
+    unobserve(target: Element): void;
+    disconnect(): void;
+}
+
+export default ResizeObserver;

package/node_modules/resize-observer-polyfill/src/index.js

@@ -0,0 +1,11 @@
+import ResizeObserverPolyfill from './ResizeObserver.js';
+import global from './shims/global.js';
+
+export default (() => {
+    // Export existing implementation if available.
+    if (typeof global.ResizeObserver !== 'undefined') {
+        return global.ResizeObserver;
+    }
+
+    return ResizeObserverPolyfill;
+})();

package/node_modules/resize-observer-polyfill/src/index.js.flow

@@ -0,0 +1,32 @@
+// @flow
+
+class DOMRectReadOnly {
+    +x: number;
+    +y: number;
+    +width: number;
+    +height: number;
+    +top: number;
+    +right: number;
+    +bottom: number;
+    +left: number;
+}
+
+class ResizeObserverEntry {
+    +target: Element;
+    +contentRect: DOMRectReadOnly;
+}
+
+type Entries = $ReadOnlyArray<ResizeObserverEntry>;
+
+type ResizeObserverCallback = {
+    (entries: Entries, observer: ResizeObserver): void
+};
+
+declare class ResizeObserver {
+    constructor(ResizeObserverCallback): ResizeObserver;
+    observe(target: Element): void;
+    unobserve(target: Element): void;
+    disconnect(): void;
+};
+
+declare export default typeof ResizeObserver;

package/node_modules/resize-observer-polyfill/src/shims/es6-collections.js

@@ -0,0 +1,115 @@
+/**
+ * A collection of shims that provide minimal functionality of the ES6 collections.
+ *
+ * These implementations are not meant to be used outside of the ResizeObserver
+ * modules as they cover only a limited range of use cases.
+ */
+/* eslint-disable require-jsdoc, valid-jsdoc */
+const MapShim = (() => {
+    if (typeof Map !== 'undefined') {
+        return Map;
+    }
+
+    /**
+     * Returns index in provided array that matches the specified key.
+     *
+     * @param {Array<Array>} arr
+     * @param {*} key
+     * @returns {number}
+     */
+    function getIndex(arr, key) {
+        let result = -1;
+
+        arr.some((entry, index) => {
+            if (entry[0] === key) {
+                result = index;
+
+                return true;
+            }
+
+            return false;
+        });
+
+        return result;
+    }
+
+    return class {
+        constructor() {
+            this.__entries__ = [];
+        }
+
+        /**
+         * @returns {boolean}
+         */
+        get size() {
+            return this.__entries__.length;
+        }
+
+        /**
+         * @param {*} key
+         * @returns {*}
+         */
+        get(key) {
+            const index = getIndex(this.__entries__, key);
+            const entry = this.__entries__[index];
+
+            return entry && entry[1];
+        }
+
+        /**
+         * @param {*} key
+         * @param {*} value
+         * @returns {void}
+         */
+        set(key, value) {
+            const index = getIndex(this.__entries__, key);
+
+            if (~index) {
+                this.__entries__[index][1] = value;
+            } else {
+                this.__entries__.push([key, value]);
+            }
+        }
+
+        /**
+         * @param {*} key
+         * @returns {void}
+         */
+        delete(key) {
+            const entries = this.__entries__;
+            const index = getIndex(entries, key);
+
+            if (~index) {
+                entries.splice(index, 1);
+            }
+        }
+
+        /**
+         * @param {*} key
+         * @returns {void}
+         */
+        has(key) {
+            return !!~getIndex(this.__entries__, key);
+        }
+
+        /**
+         * @returns {void}
+         */
+        clear() {
+            this.__entries__.splice(0);
+        }
+
+        /**
+         * @param {Function} callback
+         * @param {*} [ctx=null]
+         * @returns {void}
+         */
+        forEach(callback, ctx = null) {
+            for (const entry of this.__entries__) {
+                callback.call(ctx, entry[1], entry[0]);
+            }
+        }
+    };
+})();
+
+export {MapShim as Map};

package/node_modules/resize-observer-polyfill/src/shims/global.js

@@ -0,0 +1,17 @@
+// Returns global object of a current environment.
+export default (() => {
+    if (typeof global !== 'undefined' && global.Math === Math) {
+        return global;
+    }
+
+    if (typeof self !== 'undefined' && self.Math === Math) {
+        return self;
+    }
+
+    if (typeof window !== 'undefined' && window.Math === Math) {
+        return window;
+    }
+
+    // eslint-disable-next-line no-new-func
+    return Function('return this')();
+})();

package/node_modules/resize-observer-polyfill/src/shims/requestAnimationFrame.js

@@ -0,0 +1,18 @@
+import global from './global.js';
+
+/**
+ * A shim for the requestAnimationFrame which falls back to the setTimeout if
+ * first one is not supported.
+ *
+ * @returns {number} Requests' identifier.
+ */
+export default (() => {
+    if (typeof requestAnimationFrame === 'function') {
+        // It's required to use a bounded function because IE sometimes throws
+        // an "Invalid calling object" error if rAF is invoked without the global
+        // object on the left hand side.
+        return requestAnimationFrame.bind(global);
+    }
+
+    return callback => setTimeout(() => callback(Date.now()), 1000 / 60);
+})();

package/node_modules/resize-observer-polyfill/src/utils/defineConfigurable.js

@@ -0,0 +1,19 @@
+/**
+ * Defines non-writable/enumerable properties of the provided target object.
+ *
+ * @param {Object} target - Object for which to define properties.
+ * @param {Object} props - Properties to be defined.
+ * @returns {Object} Target object.
+ */
+export default (target, props) => {
+    for (const key of Object.keys(props)) {
+        Object.defineProperty(target, key, {
+            value: props[key],
+            enumerable: false,
+            writable: false,
+            configurable: true
+        });
+    }
+
+    return target;
+};

package/node_modules/resize-observer-polyfill/src/utils/geometry.js

@@ -0,0 +1,233 @@
+import defineConfigurable from './defineConfigurable.js';
+import getWindowOf from './getWindowOf.js';
+import isBrowser from './isBrowser.js';
+
+// Placeholder of an empty content rectangle.
+const emptyRect = createRectInit(0, 0, 0, 0);
+
+/**
+ * Converts provided string to a number.
+ *
+ * @param {number|string} value
+ * @returns {number}
+ */
+function toFloat(value) {
+    return parseFloat(value) || 0;
+}
+
+/**
+ * Extracts borders size from provided styles.
+ *
+ * @param {CSSStyleDeclaration} styles
+ * @param {...string} positions - Borders positions (top, right, ...)
+ * @returns {number}
+ */
+function getBordersSize(styles, ...positions) {
+    return positions.reduce((size, position) => {
+        const value = styles['border-' + position + '-width'];
+
+        return size + toFloat(value);
+    }, 0);
+}
+
+/**
+ * Extracts paddings sizes from provided styles.
+ *
+ * @param {CSSStyleDeclaration} styles
+ * @returns {Object} Paddings box.
+ */
+function getPaddings(styles) {
+    const positions = ['top', 'right', 'bottom', 'left'];
+    const paddings = {};
+
+    for (const position of positions) {
+        const value = styles['padding-' + position];
+
+        paddings[position] = toFloat(value);
+    }
+
+    return paddings;
+}
+
+/**
+ * Calculates content rectangle of provided SVG element.
+ *
+ * @param {SVGGraphicsElement} target - Element content rectangle of which needs
+ *      to be calculated.
+ * @returns {DOMRectInit}
+ */
+function getSVGContentRect(target) {
+    const bbox = target.getBBox();
+
+    return createRectInit(0, 0, bbox.width, bbox.height);
+}
+
+/**
+ * Calculates content rectangle of provided HTMLElement.
+ *
+ * @param {HTMLElement} target - Element for which to calculate the content rectangle.
+ * @returns {DOMRectInit}
+ */
+function getHTMLElementContentRect(target) {
+    // Client width & height properties can't be
+    // used exclusively as they provide rounded values.
+    const {clientWidth, clientHeight} = target;
+
+    // By this condition we can catch all non-replaced inline, hidden and
+    // detached elements. Though elements with width & height properties less
+    // than 0.5 will be discarded as well.
+    //
+    // Without it we would need to implement separate methods for each of
+    // those cases and it's not possible to perform a precise and performance
+    // effective test for hidden elements. E.g. even jQuery's ':visible' filter
+    // gives wrong results for elements with width & height less than 0.5.
+    if (!clientWidth && !clientHeight) {
+        return emptyRect;
+    }
+
+    const styles = getWindowOf(target).getComputedStyle(target);
+    const paddings = getPaddings(styles);
+    const horizPad = paddings.left + paddings.right;
+    const vertPad = paddings.top + paddings.bottom;
+
+    // Computed styles of width & height are being used because they are the
+    // only dimensions available to JS that contain non-rounded values. It could
+    // be possible to utilize the getBoundingClientRect if only it's data wasn't
+    // affected by CSS transformations let alone paddings, borders and scroll bars.
+    let width = toFloat(styles.width),
+        height = toFloat(styles.height);
+
+    // Width & height include paddings and borders when the 'border-box' box
+    // model is applied (except for IE).
+    if (styles.boxSizing === 'border-box') {
+        // Following conditions are required to handle Internet Explorer which
+        // doesn't include paddings and borders to computed CSS dimensions.
+        //
+        // We can say that if CSS dimensions + paddings are equal to the "client"
+        // properties then it's either IE, and thus we don't need to subtract
+        // anything, or an element merely doesn't have paddings/borders styles.
+        if (Math.round(width + horizPad) !== clientWidth) {
+            width -= getBordersSize(styles, 'left', 'right') + horizPad;
+        }
+
+        if (Math.round(height + vertPad) !== clientHeight) {
+            height -= getBordersSize(styles, 'top', 'bottom') + vertPad;
+        }
+    }
+
+    // Following steps can't be applied to the document's root element as its
+    // client[Width/Height] properties represent viewport area of the window.
+    // Besides, it's as well not necessary as the <html> itself neither has
+    // rendered scroll bars nor it can be clipped.
+    if (!isDocumentElement(target)) {
+        // In some browsers (only in Firefox, actually) CSS width & height
+        // include scroll bars size which can be removed at this step as scroll
+        // bars are the only difference between rounded dimensions + paddings
+        // and "client" properties, though that is not always true in Chrome.
+        const vertScrollbar = Math.round(width + horizPad) - clientWidth;
+        const horizScrollbar = Math.round(height + vertPad) - clientHeight;
+
+        // Chrome has a rather weird rounding of "client" properties.
+        // E.g. for an element with content width of 314.2px it sometimes gives
+        // the client width of 315px and for the width of 314.7px it may give
+        // 314px. And it doesn't happen all the time. So just ignore this delta
+        // as a non-relevant.
+        if (Math.abs(vertScrollbar) !== 1) {
+            width -= vertScrollbar;
+        }
+
+        if (Math.abs(horizScrollbar) !== 1) {
+            height -= horizScrollbar;
+        }
+    }
+
+    return createRectInit(paddings.left, paddings.top, width, height);
+}
+
+/**
+ * Checks whether provided element is an instance of the SVGGraphicsElement.
+ *
+ * @param {Element} target - Element to be checked.
+ * @returns {boolean}
+ */
+const isSVGGraphicsElement = (() => {
+    // Some browsers, namely IE and Edge, don't have the SVGGraphicsElement
+    // interface.
+    if (typeof SVGGraphicsElement !== 'undefined') {
+        return target => target instanceof getWindowOf(target).SVGGraphicsElement;
+    }
+
+    // If it's so, then check that element is at least an instance of the
+    // SVGElement and that it has the "getBBox" method.
+    // eslint-disable-next-line no-extra-parens
+    return target => (
+        target instanceof getWindowOf(target).SVGElement &&
+        typeof target.getBBox === 'function'
+    );
+})();
+
+/**
+ * Checks whether provided element is a document element (<html>).
+ *
+ * @param {Element} target - Element to be checked.
+ * @returns {boolean}
+ */
+function isDocumentElement(target) {
+    return target === getWindowOf(target).document.documentElement;
+}
+
+/**
+ * Calculates an appropriate content rectangle for provided html or svg element.
+ *
+ * @param {Element} target - Element content rectangle of which needs to be calculated.
+ * @returns {DOMRectInit}
+ */
+export function getContentRect(target) {
+    if (!isBrowser) {
+        return emptyRect;
+    }
+
+    if (isSVGGraphicsElement(target)) {
+        return getSVGContentRect(target);
+    }
+
+    return getHTMLElementContentRect(target);
+}
+
+/**
+ * Creates rectangle with an interface of the DOMRectReadOnly.
+ * Spec: https://drafts.fxtf.org/geometry/#domrectreadonly
+ *
+ * @param {DOMRectInit} rectInit - Object with rectangle's x/y coordinates and dimensions.
+ * @returns {DOMRectReadOnly}
+ */
+export function createReadOnlyRect({x, y, width, height}) {
+    // If DOMRectReadOnly is available use it as a prototype for the rectangle.
+    const Constr = typeof DOMRectReadOnly !== 'undefined' ? DOMRectReadOnly : Object;
+    const rect = Object.create(Constr.prototype);
+
+    // Rectangle's properties are not writable and non-enumerable.
+    defineConfigurable(rect, {
+        x, y, width, height,
+        top: y,
+        right: x + width,
+        bottom: height + y,
+        left: x
+    });
+
+    return rect;
+}
+
+/**
+ * Creates DOMRectInit object based on the provided dimensions and the x/y coordinates.
+ * Spec: https://drafts.fxtf.org/geometry/#dictdef-domrectinit
+ *
+ * @param {number} x - X coordinate.
+ * @param {number} y - Y coordinate.
+ * @param {number} width - Rectangle's width.
+ * @param {number} height - Rectangle's height.
+ * @returns {DOMRectInit}
+ */
+export function createRectInit(x, y, width, height) {
+    return {x, y, width, height};
+}

package/node_modules/resize-observer-polyfill/src/utils/getWindowOf.js

@@ -0,0 +1,18 @@
+import global from '../shims/global.js';
+
+/**
+ * Returns the global object associated with provided element.
+ *
+ * @param {Object} target
+ * @returns {Object}
+ */
+export default target => {
+    // Assume that the element is an instance of Node, which means that it
+    // has the "ownerDocument" property from which we can retrieve a
+    // corresponding global object.
+    const ownerGlobal = target && target.ownerDocument && target.ownerDocument.defaultView;
+
+    // Return the local global object if it's not possible extract one from
+    // provided element.
+    return ownerGlobal || global;
+};

package/node_modules/resize-observer-polyfill/src/utils/isBrowser.js

@@ -0,0 +1,4 @@
+/**
+ * Detects whether window and document objects are available in current environment.
+ */
+export default typeof window !== 'undefined' && typeof document !== 'undefined' && window.document === document;

package/node_modules/resize-observer-polyfill/src/utils/throttle.js

@@ -0,0 +1,78 @@
+import requestAnimationFrame from '../shims/requestAnimationFrame.js';
+
+// Defines minimum timeout before adding a trailing call.
+const trailingTimeout = 2;
+
+/**
+ * Creates a wrapper function which ensures that provided callback will be
+ * invoked only once during the specified delay period.
+ *
+ * @param {Function} callback - Function to be invoked after the delay period.
+ * @param {number} delay - Delay after which to invoke callback.
+ * @returns {Function}
+ */
+export default function (callback, delay) {
+    let leadingCall = false,
+        trailingCall = false,
+        lastCallTime = 0;
+
+    /**
+     * Invokes the original callback function and schedules new invocation if
+     * the "proxy" was called during current request.
+     *
+     * @returns {void}
+     */
+    function resolvePending() {
+        if (leadingCall) {
+            leadingCall = false;
+
+            callback();
+        }
+
+        if (trailingCall) {
+            proxy();
+        }
+    }
+
+    /**
+     * Callback invoked after the specified delay. It will further postpone
+     * invocation of the original function delegating it to the
+     * requestAnimationFrame.
+     *
+     * @returns {void}
+     */
+    function timeoutCallback() {
+        requestAnimationFrame(resolvePending);
+    }
+
+    /**
+     * Schedules invocation of the original function.
+     *
+     * @returns {void}
+     */
+    function proxy() {
+        const timeStamp = Date.now();
+
+        if (leadingCall) {
+            // Reject immediately following calls.
+            if (timeStamp - lastCallTime < trailingTimeout) {
+                return;
+            }
+
+            // Schedule new call to be in invoked when the pending one is resolved.
+            // This is important for "transitions" which never actually start
+            // immediately so there is a chance that we might miss one if change
+            // happens amids the pending invocation.
+            trailingCall = true;
+        } else {
+            leadingCall = true;
+            trailingCall = false;
+
+            setTimeout(timeoutCallback, delay);
+        }
+
+        lastCallTime = timeStamp;
+    }
+
+    return proxy;
+}