@spscommerce/utils 5.4.1 → 5.5.0-ie

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.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.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.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.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.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.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"}

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

@@ -0,0 +1,34 @@
+/**
+ * Functions for various operators, most useful in combination
+ * with functional programming tools like map, filter, and reduce.
+ */
+export var Op = {
+    // eslint-disable-next-line @typescript-eslint/restrict-plus-operands
+    add: function (a, b) { return a + b; },
+    and: function (a, b) { return a && b; },
+    band: function (a, b) { return a & b; },
+    bor: function (a, b) { return a | b; },
+    bxor: function (a, b) { return a ^ b; },
+    bnot: function (a) { return ~a; },
+    decr: function (a) { return a - 1; },
+    div: function (a, b) { return a / b; },
+    eq: function (a, b) { return a === b; },
+    exp: function (a, b) { return Math.pow(a, b); },
+    gt: function (a, b) { return a > b; },
+    gte: function (a, b) { return a >= b; },
+    incr: function (a) { return a + 1; },
+    lshift: function (a, b) { return a << b; },
+    lt: function (a, b) { return a < b; },
+    lte: function (a, b) { return a <= b; },
+    mul: function (a, b) { return a * b; },
+    neg: function (a) { return -a; },
+    neq: function (a, b) { return a !== b; },
+    not: function (a) { return !a; },
+    or: function (a, b) { return a || b; },
+    rem: function (a, b) { return a % b; },
+    rshift: function (a, b) { return a >> b; },
+    rshift_zf: function (a, b) { return a >>> b; },
+    sub: function (a, b) { return a - b; },
+    xor: function (a, b) { return (a || b) && !(a && b); },
+};
+//# sourceMappingURL=op.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"op.js","sourceRoot":"","sources":["../../../src/function/op.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,CAAC,IAAM,EAAE,GAAG;IAChB,qEAAqE;IACrE,GAAG,EAAE,UAAC,CAAC,EAAE,CAAC,IAAK,OAAA,CAAC,GAAG,CAAC,EAAL,CAAK;IAEpB,GAAG,EAAE,UAAC,CAAC,EAAE,CAAC,IAAK,OAAA,CAAC,IAAI,CAAC,EAAN,CAAM;IAErB,IAAI,EAAE,UAAC,CAAC,EAAE,CAAC,IAAK,OAAA,CAAC,GAAG,CAAC,EAAL,CAAK;IAErB,GAAG,EAAE,UAAC,CAAC,EAAE,CAAC,IAAK,OAAA,CAAC,GAAG,CAAC,EAAL,CAAK;IAEpB,IAAI,EAAE,UAAC,CAAC,EAAE,CAAC,IAAK,OAAA,CAAC,GAAG,CAAC,EAAL,CAAK;IAErB,IAAI,EAAE,UAAC,CAAC,IAAK,OAAA,CAAC,CAAC,EAAF,CAAE;IAEf,IAAI,EAAE,UAAC,CAAS,IAAK,OAAA,CAAC,GAAG,CAAC,EAAL,CAAK;IAE1B,GAAG,EAAE,UAAC,CAAS,EAAE,CAAS,IAAK,OAAA,CAAC,GAAG,CAAC,EAAL,CAAK;IAEpC,EAAE,EAAE,UAAC,CAAC,EAAE,CAAC,IAAK,OAAA,CAAC,KAAK,CAAC,EAAP,CAAO;IAErB,GAAG,EAAE,UAAC,CAAS,EAAE,CAAS,IAAK,OAAA,SAAA,CAAC,EAAI,CAAC,CAAA,EAAN,CAAM;IAErC,EAAE,EAAE,UAAC,CAAC,EAAE,CAAC,IAAK,OAAA,CAAC,GAAG,CAAC,EAAL,CAAK;IAEnB,GAAG,EAAE,UAAC,CAAC,EAAE,CAAC,IAAK,OAAA,CAAC,IAAI,CAAC,EAAN,CAAM;IAErB,IAAI,EAAE,UAAC,CAAS,IAAK,OAAA,CAAC,GAAG,CAAC,EAAL,CAAK;IAE1B,MAAM,EAAE,UAAC,CAAC,EAAE,CAAC,IAAK,OAAA,CAAC,IAAI,CAAC,EAAN,CAAM;IAExB,EAAE,EAAE,UAAC,CAAC,EAAE,CAAC,IAAK,OAAA,CAAC,GAAG,CAAC,EAAL,CAAK;IAEnB,GAAG,EAAE,UAAC,CAAC,EAAE,CAAC,IAAK,OAAA,CAAC,IAAI,CAAC,EAAN,CAAM;IAErB,GAAG,EAAE,UAAC,CAAS,EAAE,CAAS,IAAK,OAAA,CAAC,GAAG,CAAC,EAAL,CAAK;IAEpC,GAAG,EAAE,UAAC,CAAS,IAAK,OAAA,CAAC,CAAC,EAAF,CAAE;IAEtB,GAAG,EAAE,UAAC,CAAC,EAAE,CAAC,IAAK,OAAA,CAAC,KAAK,CAAC,EAAP,CAAO;IAEtB,GAAG,EAAE,UAAC,CAAC,IAAK,OAAA,CAAC,CAAC,EAAF,CAAE;IAEd,EAAE,EAAE,UAAC,CAAC,EAAE,CAAC,IAAK,OAAA,CAAC,IAAI,CAAC,EAAN,CAAM;IAEpB,GAAG,EAAE,UAAC,CAAS,EAAE,CAAS,IAAK,OAAA,CAAC,GAAG,CAAC,EAAL,CAAK;IAEpC,MAAM,EAAE,UAAC,CAAC,EAAE,CAAC,IAAK,OAAA,CAAC,IAAI,CAAC,EAAN,CAAM;IAExB,SAAS,EAAE,UAAC,CAAC,EAAE,CAAC,IAAK,OAAA,CAAC,KAAK,CAAC,EAAP,CAAO;IAE5B,GAAG,EAAE,UAAC,CAAS,EAAE,CAAS,IAAK,OAAA,CAAC,GAAG,CAAC,EAAL,CAAK;IAEpC,GAAG,EAAE,UAAC,CAAC,EAAE,CAAC,IAAK,OAAA,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,EAArB,CAAqB;CACrC,CAAC"}

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

@@ -0,0 +1,94 @@
+import { Op } from "./op";
+describe("Op", function () {
+    test("provides addition as a function", function () {
+        expect(Op.add(1, 3)).toBe(4);
+    });
+    test("provides Boolean AND as a function", function () {
+        expect(Op.and(true, true)).toBe(true);
+        expect(Op.and(true, false)).toBe(false);
+        expect(Op.and(false, true)).toBe(false);
+        expect(Op.and(false, false)).toBe(false);
+    });
+    test("provides bitwise AND as a function", function () {
+        expect(Op.band(5, 12)).toBe(4);
+    });
+    test("provides bitwise OR as a function", function () {
+        expect(Op.bor(5, 12)).toBe(13);
+    });
+    test("provides bitwise XOR as a function", function () {
+        expect(Op.bxor(5, 12)).toBe(9);
+    });
+    test("provides bitwise NOT as a function", function () {
+        expect(Op.bnot(5)).toBe(-6);
+    });
+    test("provides decrement as a function", function () {
+        expect(Op.decr(6)).toBe(5);
+    });
+    test("provides division as a function", function () {
+        expect(Op.div(5, 2)).toBe(2.5);
+    });
+    test("provides equality (triple equals) as a function", function () {
+        var a = 5;
+        var b = 5;
+        var c = "5";
+        expect(Op.eq(a, b)).toBe(true);
+        expect(Op.eq(b, c)).toBe(false);
+    });
+    test("provides exponentiation as a function", function () {
+        expect(Op.exp(2, 5)).toBe(32);
+    });
+    test("provides greater-than as a function", function () {
+        expect(Op.gt(7, 6)).toBe(true);
+    });
+    test("provides greater-than-or-equals as a function", function () {
+        expect(Op.gte(7, 6)).toBe(true);
+        expect(Op.gte(6, 6)).toBe(true);
+    });
+    test("provides increment as a function", function () {
+        expect(Op.incr(4)).toBe(5);
+    });
+    test("provides left shift as a function", function () {
+        expect(Op.lshift(10, 1)).toBe(20);
+        expect(Op.lshift(-10, 1)).toBe(-20);
+    });
+    test("provides less-than as a function", function () {
+        expect(Op.lt(6, 7)).toBe(true);
+    });
+    test("provides less-than-or-equals as a function", function () {
+        expect(Op.lte(6, 7)).toBe(true);
+        expect(Op.lte(6, 6)).toBe(true);
+    });
+    test("provides multiplication as a function", function () {
+        expect(Op.mul(12, 12)).toBe(144);
+    });
+    test("provides negation as a function", function () {
+        expect(Op.neg(3)).toBe(-3);
+    });
+    test("provides Boolean OR as a function", function () {
+        expect(Op.or(true, true)).toBe(true);
+        expect(Op.or(true, false)).toBe(true);
+        expect(Op.or(false, true)).toBe(true);
+        expect(Op.or(false, false)).toBe(false);
+    });
+    test("provides remainder as a function", function () {
+        expect(Op.rem(17, 7)).toBe(3);
+    });
+    test("provides right shift as a function", function () {
+        expect(Op.rshift(10, 1)).toBe(5);
+        expect(Op.rshift(-10, 1)).toBe(-5);
+    });
+    test("provides unsigned zero-fill right shift as a function", function () {
+        expect(Op.rshift_zf(10, 1)).toBe(5);
+        expect(Op.rshift_zf(-10, 1)).toBe(2147483643);
+    });
+    test("provides subtraction as a function", function () {
+        expect(Op.sub(9, 4)).toBe(5);
+    });
+    test("provides Boolean XOR as a function", function () {
+        expect(Op.xor(true, true)).toBe(false);
+        expect(Op.xor(true, false)).toBe(true);
+        expect(Op.xor(false, true)).toBe(true);
+        expect(Op.xor(false, false)).toBe(false);
+    });
+});
+//# sourceMappingURL=op.spec.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"op.spec.js","sourceRoot":"","sources":["../../../src/function/op.spec.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,MAAM,CAAC;AAE1B,QAAQ,CAAC,IAAI,EAAE;IACb,IAAI,CAAC,iCAAiC,EAAE;QACtC,MAAM,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAC/B,CAAC,CAAC,CAAC;IACH,IAAI,CAAC,oCAAoC,EAAE;QACzC,MAAM,CAAC,EAAE,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACtC,MAAM,CAAC,EAAE,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACxC,MAAM,CAAC,EAAE,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACxC,MAAM,CAAC,EAAE,CAAC,GAAG,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC3C,CAAC,CAAC,CAAC;IACH,IAAI,CAAC,oCAAoC,EAAE;QACzC,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,CAAM,EAAE,EAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAM,CAAC,CAAC;IAC/C,CAAC,CAAC,CAAC;IACH,IAAI,CAAC,mCAAmC,EAAE;QACxC,MAAM,CAAC,EAAE,CAAC,GAAG,CAAC,CAAM,EAAE,EAAM,CAAC,CAAC,CAAC,IAAI,CAAC,EAAM,CAAC,CAAC;IAC9C,CAAC,CAAC,CAAC;IACH,IAAI,CAAC,oCAAoC,EAAE;QACzC,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,CAAM,EAAE,EAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAM,CAAC,CAAC;IAC/C,CAAC,CAAC,CAAC;IACH,IAAI,CAAC,oCAAoC,EAAE;QACzC,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,CAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAK,CAAC,CAAC;IACvC,CAAC,CAAC,CAAC;IACH,IAAI,CAAC,kCAAkC,EAAE;QACvC,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAC7B,CAAC,CAAC,CAAC;IACH,IAAI,CAAC,iCAAiC,EAAE;QACtC,MAAM,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACjC,CAAC,CAAC,CAAC;IACH,IAAI,CAAC,iDAAiD,EAAE;QACtD,IAAM,CAAC,GAAG,CAAC,CAAC;QACZ,IAAM,CAAC,GAAG,CAAC,CAAC;QACZ,IAAM,CAAC,GAAG,GAAG,CAAC;QACd,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC/B,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAClC,CAAC,CAAC,CAAC;IACH,IAAI,CAAC,uCAAuC,EAAE;QAC5C,MAAM,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAChC,CAAC,CAAC,CAAC;IACH,IAAI,CAAC,qCAAqC,EAAE;QAC1C,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACjC,CAAC,CAAC,CAAC;IACH,IAAI,CAAC,+CAA+C,EAAE;QACpD,MAAM,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAChC,MAAM,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAClC,CAAC,CAAC,CAAC;IACH,IAAI,CAAC,kCAAkC,EAAE;QACvC,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAC7B,CAAC,CAAC,CAAC;IACH,IAAI,CAAC,mCAAmC,EAAE;QACxC,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,EAAM,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,EAAO,CAAC,CAAC;QAC3C,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,EAAM,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,EAAO,CAAC,CAAC;IAC/C,CAAC,CAAC,CAAC;IACH,IAAI,CAAC,kCAAkC,EAAE;QACvC,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACjC,CAAC,CAAC,CAAC;IACH,IAAI,CAAC,4CAA4C,EAAE;QACjD,MAAM,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAChC,MAAM,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAClC,CAAC,CAAC,CAAC;IACH,IAAI,CAAC,uCAAuC,EAAE;QAC5C,MAAM,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACnC,CAAC,CAAC,CAAC;IACH,IAAI,CAAC,iCAAiC,EAAE;QACtC,MAAM,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IAC7B,CAAC,CAAC,CAAC;IACH,IAAI,CAAC,mCAAmC,EAAE;QACxC,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACrC,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACtC,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACtC,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC1C,CAAC,CAAC,CAAC;IACH,IAAI,CAAC,kCAAkC,EAAE;QACvC,MAAM,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAChC,CAAC,CAAC,CAAC;IACH,IAAI,CAAC,oCAAoC,EAAE;QACzC,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,EAAM,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAK,CAAC,CAAC;QACzC,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,EAAM,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAK,CAAC,CAAC;IAC7C,CAAC,CAAC,CAAC;IACH,IAAI,CAAC,uDAAuD,EAAE;QAC5D,MAAM,CAAC,EAAE,CAAC,SAAS,CAAC,EAAM,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAK,CAAC,CAAC;QAC5C,MAAM,CAAC,EAAE,CAAC,SAAS,CAAC,CAAC,EAAM,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,UAAiC,CAAC,CAAC;IAC3E,CAAC,CAAC,CAAC;IACH,IAAI,CAAC,oCAAoC,EAAE;QACzC,MAAM,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAC/B,CAAC,CAAC,CAAC;IACH,IAAI,CAAC,oCAAoC,EAAE;QACzC,MAAM,CAAC,EAAE,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACvC,MAAM,CAAC,EAAE,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACvC,MAAM,CAAC,EAAE,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACvC,MAAM,CAAC,EAAE,CAAC,GAAG,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC3C,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/out-tsc/index.js

@@ -0,0 +1,10 @@
+export * from "./array/index";
+export * from "./classes/index";
+export * from "./data/index";
+export * from "./decorators/index";
+export * from "./function/index";
+export * from "./number/index";
+export * from "./object/index";
+export * from "./string/index";
+export * from "./typings";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,WAAW,CAAC"}

package/dist/out-tsc/number/constrain.js

@@ -0,0 +1,16 @@
+/**
+ * Constrains a number to the given range. If the number is below the
+ * low end of the range, the low end will be returned. If the number is
+ * above the top end of the range, the top end will be returned. Otherwise
+ * the number itself will be returned.
+ */
+export function constrain(n, range) {
+    if (!n || n < range[0]) {
+        return range[0];
+    }
+    if (n > range[1]) {
+        return range[1];
+    }
+    return n;
+}
+//# sourceMappingURL=constrain.js.map

package/dist/out-tsc/number/constrain.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constrain.js","sourceRoot":"","sources":["../../../src/number/constrain.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,UAAU,SAAS,CAAC,CAAS,EAAE,KAAuB;IAC1D,IAAI,CAAC,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,EAAE;QACtB,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC;KACjB;IACD,IAAI,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,EAAE;QAChB,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC;KACjB;IACD,OAAO,CAAC,CAAC;AACX,CAAC"}

package/dist/out-tsc/number/decimal-round.js

@@ -0,0 +1,19 @@
+/**
+ * Progressively rounds `num` to `decimalPlaces` places. This differs from other
+ * rounding methods out there such as lodash's, which are not progressive. For example,
+ * `(0.149).toFixed(1)` and lodash `_.round(0.149, 1)` both return `0.1`, but this
+ * function rounds `0.149` to `0.15` and then `0.15` to `0.2` and returns `0.2`.
+ */
+export function decimalRound(num, decimalPlaces) {
+    if (decimalPlaces === void 0) { decimalPlaces = 0; }
+    var integralAndFractionalSplit = String(num).split(".");
+    var allDecimalPlaces = integralAndFractionalSplit.length > 1
+        ? integralAndFractionalSplit[1].length
+        : 0;
+    var roundedNum = num;
+    for (var i = allDecimalPlaces - 1; i >= decimalPlaces; i -= 1) {
+        roundedNum = Number("".concat(Math.round(Number("".concat(roundedNum, "e").concat(i))), "e-").concat(i));
+    }
+    return roundedNum;
+}
+//# sourceMappingURL=decimal-round.js.map

package/dist/out-tsc/number/decimal-round.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"decimal-round.js","sourceRoot":"","sources":["../../../src/number/decimal-round.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CAAC,GAAW,EAAE,aAAiB;IAAjB,8BAAA,EAAA,iBAAiB;IACzD,IAAM,0BAA0B,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC1D,IAAM,gBAAgB,GAAG,0BAA0B,CAAC,MAAM,GAAG,CAAC;QAC5D,CAAC,CAAC,0BAA0B,CAAC,CAAC,CAAC,CAAC,MAAM;QACtC,CAAC,CAAC,CAAC,CAAC;IAEN,IAAI,UAAU,GAAG,GAAG,CAAC;IACrB,KAAK,IAAI,CAAC,GAAG,gBAAgB,GAAG,CAAC,EAAE,CAAC,IAAI,aAAa,EAAE,CAAC,IAAI,CAAC,EAAE;QAC7D,UAAU,GAAG,MAAM,CAAC,UAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,UAAG,UAAU,cAAI,CAAC,CAAE,CAAC,CAAC,eAAK,CAAC,CAAE,CAAC,CAAC;KAC1E;IAED,OAAO,UAAU,CAAC;AACpB,CAAC"}

package/dist/out-tsc/number/decimal-round.spec.js

@@ -0,0 +1,10 @@
+import { decimalRound } from "./decimal-round";
+describe("decimalRound", function () {
+    test("does decimal rounding", function () {
+        expect(decimalRound(1.49)).toEqual(2);
+    });
+    test("rounds to a given number of places", function () {
+        expect(decimalRound(0.0149, 2)).toEqual(0.02);
+    });
+});
+//# sourceMappingURL=decimal-round.spec.js.map

package/dist/out-tsc/number/decimal-round.spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"decimal-round.spec.js","sourceRoot":"","sources":["../../../src/number/decimal-round.spec.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAE/C,QAAQ,CAAC,cAAc,EAAE;IACvB,IAAI,CAAC,uBAAuB,EAAE;QAC5B,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;IACxC,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,oCAAoC,EAAE;QACzC,MAAM,CAAC,YAAY,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAChD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

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

@@ -0,0 +1,4 @@
+export * from "./constrain";
+export * from "./decimal-round";
+export * from "./to-file-size-string";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/number/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,uBAAuB,CAAC"}

package/dist/out-tsc/number/to-file-size-string.js

@@ -0,0 +1,24 @@
+import { decimalRound } from "./decimal-round";
+/**
+ * Converts a file size in bytes to a human-friendly string. For example,
+ * `toFileSizeString(2048)` will return `"2.00KB"`.
+ */
+export function toFileSizeString(n, precision) {
+    if (precision === void 0) { precision = 2; }
+    if (n > Number.MAX_SAFE_INTEGER) {
+        throw new Error("Number is greater than MAX_SAFE_INTEGER; "
+            + "toFileSizeString does not support orders of magnitude "
+            + "higher than petabytes for this reason until BigInt "
+            + "achieves broad browser support.");
+    }
+    var magnitude = Math.min(Math.floor(Math.log(n) / Math.log(1024)), 5);
+    var unit = ["B",
+        "KB",
+        "MB",
+        "GB",
+        "TB",
+        "PB"][magnitude];
+    var decimalPlaces = magnitude ? precision : 0;
+    return decimalRound(n / (Math.pow(1024, magnitude)), decimalPlaces).toFixed(decimalPlaces) + unit;
+}
+//# sourceMappingURL=to-file-size-string.js.map

package/dist/out-tsc/number/to-file-size-string.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"to-file-size-string.js","sourceRoot":"","sources":["../../../src/number/to-file-size-string.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAE/C;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,CAAS,EAAE,SAAa;IAAb,0BAAA,EAAA,aAAa;IACvD,IAAI,CAAC,GAAG,MAAM,CAAC,gBAAgB,EAAE;QAC/B,MAAM,IAAI,KAAK,CACb,2CAA2C;cAC/B,wDAAwD;cACxD,qDAAqD;cACrD,iCAAiC,CAC9C,CAAC;KACH;IACD,IAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACxE,IAAM,IAAI,GAAG,CAAC,GAAG;QACf,IAAI;QACJ,IAAI;QACJ,IAAI;QACJ,IAAI;QACJ,IAAI,CAAC,CAAC,SAAS,CAAC,CAAC;IACnB,IAAM,aAAa,GAAG,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;IAChD,OAAO,YAAY,CAAC,CAAC,GAAG,CAAC,SAAA,IAAI,EAAI,SAAS,CAAA,CAAC,EAAE,aAAa,CAAC,CAAC,OAAO,CAAC,aAAa,CAAC,GAAG,IAAI,CAAC;AAC5F,CAAC"}