@spscommerce/utils 5.0.2 → 5.2.2-ie

package/dist/out-tsc/decorators/simple-metadata-decorator-applicator.js

@@ -0,0 +1,80 @@
+var __assign = (this && this.__assign) || function () {
+    __assign = Object.assign || function(t) {
+        for (var s, i = 1, n = arguments.length; i < n; i++) {
+            s = arguments[i];
+            for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p))
+                t[p] = s[p];
+        }
+        return t;
+    };
+    return __assign.apply(this, arguments);
+};
+var __values = (this && this.__values) || function(o) {
+    var s = typeof Symbol === "function" && Symbol.iterator, m = s && o[s], i = 0;
+    if (m) return m.call(o);
+    if (o && typeof o.length === "number") return {
+        next: function () {
+            if (o && i >= o.length) o = void 0;
+            return { value: o && o[i++], done: !o };
+        }
+    };
+    throw new TypeError(s ? "Object is not iterable." : "Symbol.iterator is not defined.");
+};
+/**
+ * This would be simpler to understand as a factory that returns a decorator function,
+ *  but TypeScript AoT compliation doesn't allow that. This lets you create a decorator
+ *  that takes in a metadata object as an argument and assigns its values along with
+ *  default values to the decorated method. The decorator will look like a standard
+ *  decorator but calling this method and returning the result is the only thing it
+ *  needs to do.
+ */
+export function simpleMetadataDecoratorApplicator(metadata, defaults, target, key, descriptor) {
+    var updatedDescriptor = descriptor || Object.getOwnPropertyDescriptor(target, key);
+    var getter = updatedDescriptor.get;
+    var value = updatedDescriptor.value;
+    updatedDescriptor.get = function get() {
+        var e_1, _a;
+        // I don't remember why I did this "this" alias & want to ensure we don't break anything...
+        // eslint-disable-next-line @typescript-eslint/no-this-alias
+        var self = this;
+        var fn = value || getter.call(this);
+        var boundFn = fn.bind(this);
+        var updatedMetadata = __assign(__assign({}, defaults), metadata);
+        var _loop_1 = function (prop) {
+            if (typeof metadata[prop] === "function") {
+                Object.defineProperty(boundFn, prop, {
+                    get: function () {
+                        return updatedMetadata[prop](self);
+                    },
+                });
+            }
+            else {
+                boundFn[prop] = updatedMetadata[prop];
+            }
+        };
+        try {
+            for (var _b = __values(Object.keys(defaults)), _c = _b.next(); !_c.done; _c = _b.next()) {
+                var prop = _c.value;
+                _loop_1(prop);
+            }
+        }
+        catch (e_1_1) { e_1 = { error: e_1_1 }; }
+        finally {
+            try {
+                if (_c && !_c.done && (_a = _b.return)) _a.call(_b);
+            }
+            finally { if (e_1) throw e_1.error; }
+        }
+        Object.defineProperty(this, key, {
+            writable: true,
+            configurable: true,
+            enumerable: updatedDescriptor.enumerable,
+            value: boundFn,
+        });
+        return boundFn;
+    };
+    delete updatedDescriptor.value;
+    delete updatedDescriptor.writable;
+    return updatedDescriptor;
+}
+//# sourceMappingURL=simple-metadata-decorator-applicator.js.map

package/dist/out-tsc/decorators/simple-metadata-decorator-applicator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"simple-metadata-decorator-applicator.js","sourceRoot":"","sources":["../../../src/decorators/simple-metadata-decorator-applicator.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;AAIA;;;;;;;GAOG;AACH,MAAM,UAAU,iCAAiC,CAC/C,QAAoB,EACpB,QAAW,EACX,MAAW,EACX,GAAgB,EAChB,UAAsC;IAEtC,IAAM,iBAAiB,GAAG,UAAU,IAAI,MAAM,CAAC,wBAAwB,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACrF,IAAM,MAAM,GAAG,iBAAiB,CAAC,GAAG,CAAC;IAC7B,IAAA,KAAK,GAAK,iBAAiB,MAAtB,CAAuB;IAEpC,iBAAiB,CAAC,GAAG,GAAG,SAAS,GAAG;;QAClC,2FAA2F;QAC3F,4DAA4D;QAC5D,IAAM,IAAI,GAAG,IAAI,CAAC;QAClB,IAAM,EAAE,GAAG,KAAK,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACtC,IAAM,OAAO,GAAG,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAE9B,IAAM,eAAe,yBAAQ,QAAQ,GAAK,QAAQ,CAAE,CAAC;gCAE1C,IAAI;YACb,IAAI,OAAO,QAAQ,CAAC,IAAI,CAAC,KAAK,UAAU,EAAE;gBACxC,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,IAAI,EAAE;oBACnC,GAAG;wBACD,OAAO,eAAe,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC;oBACrC,CAAC;iBACF,CAAC,CAAC;aACJ;iBAAM;gBACL,OAAO,CAAC,IAAI,CAAC,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;aACvC;;;YATH,KAAmB,IAAA,KAAA,SAAA,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA,gBAAA;gBAAnC,IAAM,IAAI,WAAA;wBAAJ,IAAI;aAUd;;;;;;;;;QAED,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,GAAG,EAAE;YAC/B,QAAQ,EAAE,IAAI;YACd,YAAY,EAAE,IAAI;YAClB,UAAU,EAAE,iBAAiB,CAAC,UAAU;YACxC,KAAK,EAAE,OAAO;SACf,CAAC,CAAC;QACH,OAAO,OAAO,CAAC;IACjB,CAAC,CAAC;IAEF,OAAO,iBAAiB,CAAC,KAAK,CAAC;IAC/B,OAAO,iBAAiB,CAAC,QAAQ,CAAC;IAElC,OAAO,iBAAiB,CAAC;AAC3B,CAAC"}

package/dist/out-tsc/decorators/tick-delay.d.ts

@@ -0,0 +1,6 @@
+interface FunctionPropertyDescriptor extends PropertyDescriptor {
+    value: (...args: unknown[]) => unknown;
+}
+/** Method decorator that configures the method to always run the tick after it's invoked */
+export declare function tickDelay(target: any, propertyKey: string, descriptor: FunctionPropertyDescriptor): FunctionPropertyDescriptor;
+export {};

package/dist/out-tsc/decorators/tick-delay.js

@@ -0,0 +1,31 @@
+var __assign = (this && this.__assign) || function () {
+    __assign = Object.assign || function(t) {
+        for (var s, i = 1, n = arguments.length; i < n; i++) {
+            s = arguments[i];
+            for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p))
+                t[p] = s[p];
+        }
+        return t;
+    };
+    return __assign.apply(this, arguments);
+};
+/** Method decorator that configures the method to always run the tick after it's invoked */
+export function tickDelay(target, propertyKey, descriptor) {
+    var originalDescriptorCopy = __assign({}, descriptor);
+    originalDescriptorCopy.get = function get() {
+        /*
+         * Make a new copy each time; if you don't then every instance after the first
+         * one of the class containing the decorated method will break.
+         */
+        var newDescriptor = __assign({}, originalDescriptorCopy);
+        var boundFn = originalDescriptorCopy.value.bind(this);
+        newDescriptor.value = function () { return setTimeout(boundFn, 0); };
+        Object.defineProperty(this, propertyKey, newDescriptor);
+        return newDescriptor.value;
+    };
+    originalDescriptorCopy.configurable = true;
+    delete originalDescriptorCopy.writable;
+    delete originalDescriptorCopy.value;
+    return originalDescriptorCopy;
+}
+//# sourceMappingURL=tick-delay.js.map

package/dist/out-tsc/decorators/tick-delay.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tick-delay.js","sourceRoot":"","sources":["../../../src/decorators/tick-delay.ts"],"names":[],"mappings":";;;;;;;;;;;AAIA,4FAA4F;AAC5F,MAAM,UAAU,SAAS,CACvB,MAAW,EACX,WAAmB,EACnB,UAAsC;IAEtC,IAAM,sBAAsB,gBAAoC,UAAU,CAAE,CAAC;IAC7E,sBAAsB,CAAC,GAAG,GAAG,SAAS,GAAG;QACvC;;;WAGG;QACH,IAAM,aAAa,gBAAQ,sBAAsB,CAAE,CAAC;QACpD,IAAM,OAAO,GAAoC,sBAAsB,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACzF,aAAa,CAAC,KAAK,GAAG,cAAM,OAAA,UAAU,CAAC,OAAO,EAAE,CAAC,CAAC,EAAtB,CAAsB,CAAC;QACnD,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,WAAW,EAAE,aAAa,CAAC,CAAC;QACxD,OAAO,aAAa,CAAC,KAAK,CAAC;IAC7B,CAAC,CAAC;IACF,sBAAsB,CAAC,YAAY,GAAG,IAAI,CAAC;IAC3C,OAAO,sBAAsB,CAAC,QAAQ,CAAC;IACvC,OAAO,sBAAsB,CAAC,KAAK,CAAC;IACpC,OAAO,sBAAsB,CAAC;AAChC,CAAC"}

package/dist/out-tsc/function/debounce.d.ts

@@ -0,0 +1,9 @@
+import type { Eventually } from "../typings";
+import type { DelayedFunction } from "./delayed-function.interface";
+/**
+ * Takes in a function and returns a new function that debounces it.
+ * The returned function returns an observable that can be subscribed to
+ * if you need to have something happen when the debounced function
+ * finally gets called and returns a value.
+ */
+export declare function debounce<T>(functionToDebounce: (...args: any[]) => Eventually<T>, milliseconds: number, thisArg?: any): DelayedFunction<Promise<T>>;

package/dist/out-tsc/function/debounce.js

@@ -0,0 +1,102 @@
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __generator = (this && this.__generator) || function (thisArg, body) {
+    var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g;
+    return g = { next: verb(0), "throw": verb(1), "return": verb(2) }, typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
+    function verb(n) { return function (v) { return step([n, v]); }; }
+    function step(op) {
+        if (f) throw new TypeError("Generator is already executing.");
+        while (_) try {
+            if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
+            if (y = 0, t) op = [op[0] & 2, t.value];
+            switch (op[0]) {
+                case 0: case 1: t = op; break;
+                case 4: _.label++; return { value: op[1], done: false };
+                case 5: _.label++; y = op[1]; op = [0]; continue;
+                case 7: op = _.ops.pop(); _.trys.pop(); continue;
+                default:
+                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
+                    if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
+                    if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
+                    if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
+                    if (t[2]) _.ops.pop();
+                    _.trys.pop(); continue;
+            }
+            op = body.call(thisArg, _);
+        } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
+        if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
+    }
+};
+/**
+ * If the function is set to be called, cancel the
+ * timeout that would call it. Reset id & pending to defaults.
+ *
+ * @returns - Whether an invocation was actually canceled or not.
+ */
+function resetDebouncedFn() {
+    this.pending = false;
+    if (typeof this.id === "number") {
+        clearTimeout(this.id);
+        delete this.id;
+        return true;
+    }
+    return false;
+}
+/**
+ * Takes in a function and returns a new function that debounces it.
+ * The returned function returns an observable that can be subscribed to
+ * if you need to have something happen when the debounced function
+ * finally gets called and returns a value.
+ */
+export function debounce(functionToDebounce, milliseconds, thisArg) {
+    var debFn = function debouncedFn() {
+        var args = [];
+        for (var _i = 0; _i < arguments.length; _i++) {
+            args[_i] = arguments[_i];
+        }
+        return new Promise(function (resolve, reject) {
+            debFn.reset();
+            debFn.pending = true;
+            function executor() {
+                var _this = this;
+                void (function () { return __awaiter(_this, void 0, void 0, function () {
+                    var output, err_1;
+                    return __generator(this, function (_a) {
+                        switch (_a.label) {
+                            case 0:
+                                _a.trys.push([0, 3, 4, 5]);
+                                output = functionToDebounce.apply(thisArg || this, args);
+                                if (!(output instanceof Promise)) return [3 /*break*/, 2];
+                                return [4 /*yield*/, output];
+                            case 1:
+                                output = _a.sent();
+                                _a.label = 2;
+                            case 2:
+                                resolve(output);
+                                return [3 /*break*/, 5];
+                            case 3:
+                                err_1 = _a.sent();
+                                reject(err_1);
+                                return [3 /*break*/, 5];
+                            case 4:
+                                debFn.reset();
+                                return [7 /*endfinally*/];
+                            case 5: return [2 /*return*/];
+                        }
+                    });
+                }); })();
+            }
+            debFn.id = window.setTimeout(executor, milliseconds);
+        });
+    };
+    debFn.reset = resetDebouncedFn.bind(debFn);
+    return debFn;
+}
+//# sourceMappingURL=debounce.js.map

package/dist/out-tsc/function/debounce.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"debounce.js","sourceRoot":"","sources":["../../../src/function/debounce.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAIA;;;;;GAKG;AACH,SAAS,gBAAgB;IACvB,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC;IACrB,IAAI,OAAO,IAAI,CAAC,EAAE,KAAK,QAAQ,EAAE;QAC/B,YAAY,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACtB,OAAO,IAAI,CAAC,EAAE,CAAC;QACf,OAAO,IAAI,CAAC;KACb;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,QAAQ,CACtB,kBAAqD,EACrD,YAAoB,EACpB,OAAa;IAEb,IAAM,KAAK,GAAyB,SAAS,WAAW;QAAC,cAAc;aAAd,UAAc,EAAd,qBAAc,EAAd,IAAc;YAAd,yBAAc;;QACrE,OAAO,IAAI,OAAO,CAAC,UAAC,OAAO,EAAE,MAAM;YACjC,KAAK,CAAC,KAAK,EAAE,CAAC;YACd,KAAK,CAAC,OAAO,GAAG,IAAI,CAAC;YAErB,SAAS,QAAQ;gBAAjB,iBAcC;gBAbC,KAAK,CAAC;;;;;;gCAEE,MAAM,GAAG,kBAAkB,CAAC,KAAK,CAAC,OAAO,IAAI,IAAI,EAAE,IAAI,CAAC,CAAC;qCACzD,CAAA,MAAM,YAAY,OAAO,CAAA,EAAzB,wBAAyB;gCAClB,qBAAM,MAAM,EAAA;;gCAArB,MAAM,GAAG,SAAY,CAAC;;;gCAExB,OAAO,CAAC,MAAM,CAAC,CAAC;;;;gCAEhB,MAAM,CAAC,KAAG,CAAC,CAAC;;;gCAEZ,KAAK,CAAC,KAAK,EAAE,CAAC;;;;;qBAEjB,CAAC,EAAE,CAAC;YACP,CAAC;YAED,KAAK,CAAC,EAAE,GAAG,MAAM,CAAC,UAAU,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC;QACvD,CAAC,CAAC,CAAC;IACL,CAAC,CAAC;IAEF,KAAK,CAAC,KAAK,GAAG,gBAAgB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAE3C,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/out-tsc/function/debounce.spec.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/out-tsc/function/debounce.spec.js

@@ -0,0 +1,150 @@
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __generator = (this && this.__generator) || function (thisArg, body) {
+    var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g;
+    return g = { next: verb(0), "throw": verb(1), "return": verb(2) }, typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
+    function verb(n) { return function (v) { return step([n, v]); }; }
+    function step(op) {
+        if (f) throw new TypeError("Generator is already executing.");
+        while (_) try {
+            if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
+            if (y = 0, t) op = [op[0] & 2, t.value];
+            switch (op[0]) {
+                case 0: case 1: t = op; break;
+                case 4: _.label++; return { value: op[1], done: false };
+                case 5: _.label++; y = op[1]; op = [0]; continue;
+                case 7: op = _.ops.pop(); _.trys.pop(); continue;
+                default:
+                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
+                    if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
+                    if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
+                    if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
+                    if (t[2]) _.ops.pop();
+                    _.trys.pop(); continue;
+            }
+            op = body.call(thisArg, _);
+        } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
+        if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
+    }
+};
+var __read = (this && this.__read) || function (o, n) {
+    var m = typeof Symbol === "function" && o[Symbol.iterator];
+    if (!m) return o;
+    var i = m.call(o), r, ar = [], e;
+    try {
+        while ((n === void 0 || n-- > 0) && !(r = i.next()).done) ar.push(r.value);
+    }
+    catch (error) { e = { error: error }; }
+    finally {
+        try {
+            if (r && !r.done && (m = i["return"])) m.call(i);
+        }
+        finally { if (e) throw e.error; }
+    }
+    return ar;
+};
+var __spreadArray = (this && this.__spreadArray) || function (to, from, pack) {
+    if (pack || arguments.length === 2) for (var i = 0, l = from.length, ar; i < l; i++) {
+        if (ar || !(i in from)) {
+            if (!ar) ar = Array.prototype.slice.call(from, 0, i);
+            ar[i] = from[i];
+        }
+    }
+    return to.concat(ar || Array.prototype.slice.call(from));
+};
+import { debounce } from "./debounce";
+function flushPromises() {
+    return new Promise(function (resolve) {
+        // eslint-disable-next-line no-undef
+        setImmediate(resolve);
+    });
+}
+function testDebounce(fn, callback, args, result) {
+    return __awaiter(this, void 0, void 0, function () {
+        function fnAndCallbackHaveNotBeenCalled() {
+            expect(fn).not.toHaveBeenCalled();
+            expect(callback).not.toHaveBeenCalled();
+        }
+        var debounced;
+        var _a;
+        return __generator(this, function (_b) {
+            switch (_b.label) {
+                case 0:
+                    debounced = debounce(fn, 1000);
+                    void debounced.apply(void 0, __spreadArray([], __read(args), false)).then(callback);
+                    fnAndCallbackHaveNotBeenCalled();
+                    jest.advanceTimersByTime(999);
+                    fnAndCallbackHaveNotBeenCalled();
+                    void debounced.apply(void 0, __spreadArray([], __read(args), false)).then(callback);
+                    jest.advanceTimersByTime(1);
+                    fnAndCallbackHaveNotBeenCalled();
+                    jest.advanceTimersByTime(998);
+                    fnAndCallbackHaveNotBeenCalled();
+                    jest.advanceTimersByTime(1);
+                    return [4 /*yield*/, flushPromises()];
+                case 1:
+                    _b.sent();
+                    (_a = expect(fn)).toHaveBeenCalledWith.apply(_a, __spreadArray([], __read(args), false));
+                    expect(callback).toHaveBeenCalledWith(result);
+                    return [2 /*return*/];
+            }
+        });
+    });
+}
+describe("debounce", function () {
+    beforeEach(function () {
+        jest.useFakeTimers();
+    });
+    afterAll(function () {
+        jest.useRealTimers();
+    });
+    test("returns a new, debounced version of the function", function () { return __awaiter(void 0, void 0, void 0, function () {
+        var expectedArguments, fn, callback;
+        return __generator(this, function (_a) {
+            switch (_a.label) {
+                case 0:
+                    expectedArguments = 2;
+                    fn = jest.fn(function () { return expectedArguments; });
+                    callback = jest.fn(function (arg) { return arg; });
+                    return [4 /*yield*/, testDebounce(fn, callback, [1, "foo"], expectedArguments)];
+                case 1:
+                    _a.sent();
+                    return [2 /*return*/];
+            }
+        });
+    }); });
+    test("works with a function that returns a Promise", function () { return __awaiter(void 0, void 0, void 0, function () {
+        var result, fn, callback;
+        return __generator(this, function (_a) {
+            switch (_a.label) {
+                case 0:
+                    result = 2;
+                    fn = jest.fn(function () { return Promise.resolve(result); });
+                    callback = jest.fn(function (arg) { return arg; });
+                    return [4 /*yield*/, testDebounce(fn, callback, [], 2)];
+                case 1:
+                    _a.sent();
+                    return [2 /*return*/];
+            }
+        });
+    }); });
+    test("is cancelable with reset()", function () {
+        var fn = jest.fn(function () { return 2; });
+        var callback = jest.fn();
+        var debounced = debounce(fn, 1000);
+        void debounced().then(callback);
+        jest.advanceTimersByTime(999);
+        debounced.reset();
+        jest.advanceTimersByTime(1);
+        expect(fn).not.toHaveBeenCalled();
+        expect(callback).not.toHaveBeenCalled();
+    });
+});
+//# sourceMappingURL=debounce.spec.js.map

package/dist/out-tsc/function/debounce.spec.js.map

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

package/dist/out-tsc/function/debounced-function.interface.d.ts

@@ -0,0 +1,10 @@
+import type { DelayedFunction } from "./delayed-function.interface";
+/** docs:ignore */
+export interface DebouncedFunction<T> extends DelayedFunction<Promise<T>> {
+    (...args: any[]): Promise<T>;
+    _promise?: Promise<T>;
+    _promiseCallbacks?: {
+        resolve: any;
+        reject: any;
+    };
+}

package/dist/out-tsc/function/debounced-function.interface.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=debounced-function.interface.js.map

package/dist/out-tsc/function/debounced-function.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"debounced-function.interface.js","sourceRoot":"","sources":["../../../src/function/debounced-function.interface.ts"],"names":[],"mappings":""}

package/dist/out-tsc/function/delayed-function.interface.d.ts

@@ -0,0 +1,10 @@
+/**
+ * A function or method that has been passed to `debounce` or
+ * `lockToAnimationFrames`.
+ */
+export interface DelayedFunction<T> {
+    (...args: any[]): T;
+    pending?: boolean;
+    reset?: () => boolean;
+    id?: number;
+}

package/dist/out-tsc/function/delayed-function.interface.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=delayed-function.interface.js.map

package/dist/out-tsc/function/delayed-function.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"delayed-function.interface.js","sourceRoot":"","sources":["../../../src/function/delayed-function.interface.ts"],"names":[],"mappings":""}

package/dist/out-tsc/function/index.d.ts

@@ -0,0 +1,6 @@
+export * from "./debounce";
+export * from "./debounced-function.interface";
+export * from "./delayed-function.interface";
+export * from "./lock-to-animation-frames";
+export * from "./on-next-tick";
+export * from "./op";

package/dist/out-tsc/function/index.js

@@ -0,0 +1,7 @@
+export * from "./debounce";
+export * from "./debounced-function.interface";
+export * from "./delayed-function.interface";
+export * from "./lock-to-animation-frames";
+export * from "./on-next-tick";
+export * from "./op";
+//# sourceMappingURL=index.js.map

package/dist/out-tsc/function/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/function/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,gCAAgC,CAAC;AAC/C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,gBAAgB,CAAC;AAC/B,cAAc,MAAM,CAAC"}

package/dist/out-tsc/function/lock-to-animation-frames.d.ts

@@ -0,0 +1,7 @@
+import type { DelayedFunction } from "./delayed-function.interface";
+/**
+ * Return a new function to replace the passed in one which ensures that
+ * the given function will run only in `requestAnimationFrame()` and at
+ * most once per frame.
+ */
+export declare function lockToAnimationFrames(functionToLock: () => any, thisArg?: any): DelayedFunction<any>;

package/dist/out-tsc/function/lock-to-animation-frames.js

@@ -0,0 +1,43 @@
+/**
+ * If the function is set to be called, cancel the
+ * timeout that would call it. Reset id & pending to defaults.
+ *
+ * @returns - Whether an invocation was actually canceled or not.
+ */
+function resetLockedFn() {
+    this.pending = false;
+    if (typeof this.id === "number") {
+        window.cancelAnimationFrame(this.id);
+        delete this.id;
+        return true;
+    }
+    return false;
+}
+/**
+ * Return a new function to replace the passed in one which ensures that
+ * the given function will run only in `requestAnimationFrame()` and at
+ * most once per frame.
+ */
+export function lockToAnimationFrames(functionToLock, thisArg) {
+    var lockFn = function lockedFn() {
+        var _this = this;
+        var args = [];
+        for (var _i = 0; _i < arguments.length; _i++) {
+            args[_i] = arguments[_i];
+        }
+        if (lockFn.pending) {
+            lockFn.reset();
+        }
+        lockFn.id = window.requestAnimationFrame(function () {
+            if (functionToLock) {
+                functionToLock.apply(thisArg || _this, args);
+            }
+            lockFn.reset();
+        });
+        lockFn.pending = true;
+    };
+    lockFn.pending = false;
+    lockFn.reset = resetLockedFn.bind(lockFn);
+    return lockFn;
+}
+//# sourceMappingURL=lock-to-animation-frames.js.map

package/dist/out-tsc/function/lock-to-animation-frames.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lock-to-animation-frames.js","sourceRoot":"","sources":["../../../src/function/lock-to-animation-frames.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,SAAS,aAAa;IACpB,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC;IACrB,IAAI,OAAO,IAAI,CAAC,EAAE,KAAK,QAAQ,EAAE;QAC/B,MAAM,CAAC,oBAAoB,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACrC,OAAO,IAAI,CAAC,EAAE,CAAC;QACf,OAAO,IAAI,CAAC;KACb;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,qBAAqB,CACnC,cAAyB,EACzB,OAAa;IAEb,IAAM,MAAM,GAAyB,SAAS,QAAQ;QAAjB,iBAYpC;QAZsD,cAAO;aAAP,UAAO,EAAP,qBAAO,EAAP,IAAO;YAAP,yBAAO;;QAC5D,IAAI,MAAM,CAAC,OAAO,EAAE;YAClB,MAAM,CAAC,KAAK,EAAE,CAAC;SAChB;QACD,MAAM,CAAC,EAAE,GAAG,MAAM,CAAC,qBAAqB,CAAC;YACvC,IAAI,cAAc,EAAE;gBAClB,cAAc,CAAC,KAAK,CAAC,OAAO,IAAI,KAAI,EAAE,IAAI,CAAC,CAAC;aAC7C;YAED,MAAM,CAAC,KAAK,EAAE,CAAC;QACjB,CAAC,CAAC,CAAC;QACH,MAAM,CAAC,OAAO,GAAG,IAAI,CAAC;IACxB,CAAC,CAAC;IAEF,MAAM,CAAC,OAAO,GAAG,KAAK,CAAC;IACvB,MAAM,CAAC,KAAK,GAAG,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAE1C,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/out-tsc/function/lock-to-animation-frames.spec.js

@@ -0,0 +1,53 @@
+// TODO: This was written for Jasmine, needs to be updated for Jest
+/*
+ * import createRAFStub from "raf-stub";
+ * import { lockToAnimationFrames } from "./lock-to-animation-frames";
+ */
+describe("lockToAnimationFrames", function () {
+    /*
+     * let rAFStub; let f; let
+     *   locked;
+     */
+    beforeEach(function () {
+        /*
+         * rAFStub = createRAFStub();
+         * spyOn(window, "requestAnimationFrame").and.callFake(rAFStub.add);
+         * spyOn(window, "cancelAnimationFrame").and.callFake(rAFStub.remove);
+         * f = jasmine.createSpy();
+         * locked = lockToAnimationFrames(f);
+         */
+    });
+    test("returns a function that runs the passed in function only in RAF", function () {
+        /*
+         * locked();
+         * expect(f).not.toHaveBeenCalled();
+         * rAFStub.step();
+         * expect(f).toHaveBeenCalled();
+         */
+    });
+    test("allows the function to run at most once per frame", function () {
+        /*
+         * locked();
+         * locked();
+         * locked();
+         * locked();
+         * locked();
+         * locked();
+         * locked();
+         * locked();
+         */
+        /*
+         * rAFStub.step();
+         * expect(f).toHaveBeenCalledTimes(1);
+         */
+    });
+    test("is cancelable with reset()", function () {
+        /*
+         * locked();
+         * locked.reset();
+         * rAFStub.step();
+         * expect(f).not.toHaveBeenCalled();
+         */
+    });
+});
+//# sourceMappingURL=lock-to-animation-frames.spec.js.map

package/dist/out-tsc/function/lock-to-animation-frames.spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lock-to-animation-frames.spec.js","sourceRoot":"","sources":["../../../src/function/lock-to-animation-frames.spec.ts"],"names":[],"mappings":"AAAA,mEAAmE;AAEnE;;;GAGG;AAEH,QAAQ,CAAC,uBAAuB,EAAE;IAChC;;;OAGG;IAEH,UAAU,CAAC;QACT;;;;;;WAMG;IACL,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,iEAAiE,EAAE;QACtE;;;;;WAKG;IACL,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,mDAAmD,EAAE;QACxD;;;;;;;;;WASG;QAEH;;;WAGG;IACL,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,4BAA4B,EAAE;QACjC;;;;;WAKG;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/out-tsc/function/on-next-tick.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Enqueues the given function to run on the next "tick" of the JS event
+ * loop cycle. If you ever encounter the "value changed after it was
+ * checked" error in Angular when trying to assign a value of a
+ * component class, performing that assignment on the next tick, i.e. when
+ * all of Angular's current cycle is finished, will resolve that error.
+ */
+export declare function onNextTick(fn: (...args: unknown[]) => unknown, thisArg?: any): void;

package/dist/out-tsc/function/on-next-tick.js

@@ -0,0 +1,12 @@
+/**
+ * Enqueues the given function to run on the next "tick" of the JS event
+ * loop cycle. If you ever encounter the "value changed after it was
+ * checked" error in Angular when trying to assign a value of a
+ * component class, performing that assignment on the next tick, i.e. when
+ * all of Angular's current cycle is finished, will resolve that error.
+ */
+export function onNextTick(fn, thisArg) {
+    var boundFn = thisArg ? fn.bind(thisArg) : fn;
+    setTimeout(boundFn, 0);
+}
+//# sourceMappingURL=on-next-tick.js.map

package/dist/out-tsc/function/on-next-tick.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"on-next-tick.js","sourceRoot":"","sources":["../../../src/function/on-next-tick.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,UAAU,UAAU,CAAC,EAAmC,EAAE,OAAa;IAC3E,IAAM,OAAO,GAAoC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACjF,UAAU,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;AACzB,CAAC"}

package/dist/out-tsc/function/on-next-tick.spec.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/out-tsc/function/on-next-tick.spec.js

@@ -0,0 +1,13 @@
+import { onNextTick } from "./on-next-tick";
+describe("onNextTick", function () {
+    test("does a thing?", function (done) {
+        var fn = jest.fn();
+        onNextTick(fn);
+        expect(fn).not.toHaveBeenCalled();
+        onNextTick(function () {
+            expect(fn).toHaveBeenCalled();
+            done();
+        });
+    });
+});
+//# sourceMappingURL=on-next-tick.spec.js.map

package/dist/out-tsc/function/on-next-tick.spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"on-next-tick.spec.js","sourceRoot":"","sources":["../../../src/function/on-next-tick.spec.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAE5C,QAAQ,CAAC,YAAY,EAAE;IACrB,IAAI,CAAC,eAAe,EAAE,UAAC,IAAI;QACzB,IAAM,EAAE,GAAG,IAAI,CAAC,EAAE,EAAE,CAAC;QACrB,UAAU,CAAC,EAAE,CAAC,CAAC;QACf,MAAM,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,gBAAgB,EAAE,CAAC;QAClC,UAAU,CAAC;YACT,MAAM,CAAC,EAAE,CAAC,CAAC,gBAAgB,EAAE,CAAC;YAC9B,IAAI,EAAE,CAAC;QACT,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}