{"version":3,"file":"index.js","sources":["../throttle.js","../debounce.js"],"sourcesContent":["/* eslint-disable no-undefined,no-param-reassign,no-shadow */\n\n/**\n * Throttle execution of a function. Especially useful for rate limiting\n * execution of handlers on events like resize and scroll.\n *\n * @param {number} delay -                  A zero-or-greater delay in milliseconds. For event callbacks, values around 100 or 250 (or even higher)\n *                                            are most useful.\n * @param {Function} callback -               A function to be executed after delay milliseconds. The `this` context and all arguments are passed through,\n *                                            as-is, to `callback` when the throttled-function is executed.\n * @param {object} [options] -              An object to configure options.\n * @param {boolean} [options.noTrailing] -   Optional, defaults to false. If noTrailing is true, callback will only execute every `delay` milliseconds\n *                                            while the throttled-function is being called. If noTrailing is false or unspecified, callback will be executed\n *                                            one final time after the last throttled-function call. (After the throttled-function has not been called for\n *                                            `delay` milliseconds, the internal counter is reset).\n * @param {boolean} [options.noLeading] -   Optional, defaults to false. If noLeading is false, the first throttled-function call will execute callback\n *                                            immediately. If noLeading is true, the first the callback execution will be skipped. It should be noted that\n *                                            callback will never executed if both noLeading = true and noTrailing = true.\n * @param {boolean} [options.debounceMode] - If `debounceMode` is true (at begin), schedule `clear` to execute after `delay` ms. If `debounceMode` is\n *                                            false (at end), schedule `callback` to execute after `delay` ms.\n *\n * @returns {Function} A new, throttled, function.\n */\nexport default function (delay, callback, options) {\n\tconst {\n\t\tnoTrailing = false,\n\t\tnoLeading = false,\n\t\tdebounceMode = undefined\n\t} = options || {};\n\t/*\n\t * After wrapper has stopped being called, this timeout ensures that\n\t * `callback` is executed at the proper times in `throttle` and `end`\n\t * debounce modes.\n\t */\n\tlet timeoutID;\n\tlet cancelled = false;\n\n\t// Keep track of the last time `callback` was executed.\n\tlet lastExec = 0;\n\n\t// Function to clear existing timeout\n\tfunction clearExistingTimeout() {\n\t\tif (timeoutID) {\n\t\t\tclearTimeout(timeoutID);\n\t\t}\n\t}\n\n\t// Function to cancel next exec\n\tfunction cancel(options) {\n\t\tconst { upcomingOnly = false } = options || {};\n\t\tclearExistingTimeout();\n\t\tcancelled = !upcomingOnly;\n\t}\n\n\t/*\n\t * The `wrapper` function encapsulates all of the throttling / debouncing\n\t * functionality and when executed will limit the rate at which `callback`\n\t * is executed.\n\t */\n\tfunction wrapper(...arguments_) {\n\t\tlet self = this;\n\t\tlet elapsed = Date.now() - lastExec;\n\n\t\tif (cancelled) {\n\t\t\treturn;\n\t\t}\n\n\t\t// Execute `callback` and update the `lastExec` timestamp.\n\t\tfunction exec() {\n\t\t\tlastExec = Date.now();\n\t\t\tcallback.apply(self, arguments_);\n\t\t}\n\n\t\t/*\n\t\t * If `debounceMode` is true (at begin) this is used to clear the flag\n\t\t * to allow future `callback` executions.\n\t\t */\n\t\tfunction clear() {\n\t\t\ttimeoutID = undefined;\n\t\t}\n\n\t\tif (!noLeading && debounceMode && !timeoutID) {\n\t\t\t/*\n\t\t\t * Since `wrapper` is being called for the first time and\n\t\t\t * `debounceMode` is true (at begin), execute `callback`\n\t\t\t * and noLeading != true.\n\t\t\t */\n\t\t\texec();\n\t\t}\n\n\t\tclearExistingTimeout();\n\n\t\tif (debounceMode === undefined && elapsed > delay) {\n\t\t\tif (noLeading) {\n\t\t\t\t/*\n\t\t\t\t * In throttle mode with noLeading, if `delay` time has\n\t\t\t\t * been exceeded, update `lastExec` and schedule `callback`\n\t\t\t\t * to execute after `delay` ms.\n\t\t\t\t */\n\t\t\t\tlastExec = Date.now();\n\t\t\t\tif (!noTrailing) {\n\t\t\t\t\ttimeoutID = setTimeout(debounceMode ? clear : exec, delay);\n\t\t\t\t}\n\t\t\t} else {\n\t\t\t\t/*\n\t\t\t\t * In throttle mode without noLeading, if `delay` time has been exceeded, execute\n\t\t\t\t * `callback`.\n\t\t\t\t */\n\t\t\t\texec();\n\t\t\t}\n\t\t} else if (noTrailing !== true) {\n\t\t\t/*\n\t\t\t * In trailing throttle mode, since `delay` time has not been\n\t\t\t * exceeded, schedule `callback` to execute `delay` ms after most\n\t\t\t * recent execution.\n\t\t\t *\n\t\t\t * If `debounceMode` is true (at begin), schedule `clear` to execute\n\t\t\t * after `delay` ms.\n\t\t\t *\n\t\t\t * If `debounceMode` is false (at end), schedule `callback` to\n\t\t\t * execute after `delay` ms.\n\t\t\t */\n\t\t\ttimeoutID = setTimeout(\n\t\t\t\tdebounceMode ? clear : exec,\n\t\t\t\tdebounceMode === undefined ? delay - elapsed : delay\n\t\t\t);\n\t\t}\n\t}\n\n\twrapper.cancel = cancel;\n\n\t// Return the wrapper function.\n\treturn wrapper;\n}\n","/* eslint-disable no-undefined */\n\nimport throttle from './throttle.js';\n\n/**\n * Debounce execution of a function. Debouncing, unlike throttling,\n * guarantees that a function is only executed a single time, either at the\n * very beginning of a series of calls, or at the very end.\n *\n * @param {number} delay -               A zero-or-greater delay in milliseconds. For event callbacks, values around 100 or 250 (or even higher) are most useful.\n * @param {Function} callback -          A function to be executed after delay milliseconds. The `this` context and all arguments are passed through, as-is,\n *                                        to `callback` when the debounced-function is executed.\n * @param {object} [options] -           An object to configure options.\n * @param {boolean} [options.atBegin] -  Optional, defaults to false. If atBegin is false or unspecified, callback will only be executed `delay` milliseconds\n *                                        after the last debounced-function call. If atBegin is true, callback will be executed only at the first debounced-function call.\n *                                        (After the throttled-function has not been called for `delay` milliseconds, the internal counter is reset).\n *\n * @returns {Function} A new, debounced function.\n */\nexport default function (delay, callback, options) {\n\tconst { atBegin = false } = options || {};\n\treturn throttle(delay, callback, { debounceMode: atBegin !== false });\n}\n"],"names":["delay","callback","options","noTrailing","noLeading","debounceMode","undefined","timeoutID","cancelled","lastExec","clearExistingTimeout","clearTimeout","cancel","upcomingOnly","wrapper","arguments_","self","elapsed","Date","now","exec","apply","clear","setTimeout","atBegin","throttle"],"mappings":"AAAA;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACe,mBAAUA,KAAV,EAAiBC,QAAjB,EAA2BC,OAA3B,EAAoC;AAClD,EAIIA,IAAAA,IAAAA,GAAAA,OAAO,IAAI,EAJf;AAAA,MAAA,eAAA,GAAA,IAAA,CACCC,UADD;AAAA,MACCA,UADD,gCACc,KADd,GAAA,eAAA;AAAA,MAAA,cAAA,GAAA,IAAA,CAECC,SAFD;AAAA,MAECA,SAFD,+BAEa,KAFb,GAAA,cAAA;AAAA,MAAA,iBAAA,GAAA,IAAA,CAGCC,YAHD;AAAA,MAGCA,YAHD,kCAGgBC,SAHhB,GAAA,iBAAA,CAAA;AAKA;AACD;AACA;AACA;AACA;;;AACC,EAAA,IAAIC,SAAJ,CAAA;AACA,EAAA,IAAIC,SAAS,GAAG,KAAhB,CAZkD;;AAelD,EAAA,IAAIC,QAAQ,GAAG,CAAf,CAfkD;;AAkBlD,EAAA,SAASC,oBAAT,GAAgC;AAC/B,IAAA,IAAIH,SAAJ,EAAe;AACdI,MAAAA,YAAY,CAACJ,SAAD,CAAZ,CAAA;AACA,KAAA;AACD,GAtBiD;;;AAyBlD,EAASK,SAAAA,MAAT,CAAgBV,OAAhB,EAAyB;AACxB,IAAiCA,IAAAA,KAAAA,GAAAA,OAAO,IAAI,EAA5C;AAAA,QAAA,kBAAA,GAAA,KAAA,CAAQW,YAAR;AAAA,QAAQA,YAAR,mCAAuB,KAAvB,GAAA,kBAAA,CAAA;;AACAH,IAAAA,oBAAoB,EAAA,CAAA;AACpBF,IAAAA,SAAS,GAAG,CAACK,YAAb,CAAA;AACA,GAAA;AAED;AACD;AACA;AACA;AACA;;;AACC,EAAA,SAASC,OAAT,GAAgC;AAAA,IAAA,KAAA,IAAA,IAAA,GAAA,SAAA,CAAA,MAAA,EAAZC,UAAY,GAAA,IAAA,KAAA,CAAA,IAAA,CAAA,EAAA,IAAA,GAAA,CAAA,EAAA,IAAA,GAAA,IAAA,EAAA,IAAA,EAAA,EAAA;AAAZA,MAAAA,UAAY,CAAA,IAAA,CAAA,GAAA,SAAA,CAAA,IAAA,CAAA,CAAA;AAAA,KAAA;;AAC/B,IAAIC,IAAAA,IAAI,GAAG,IAAX,CAAA;AACA,IAAA,IAAIC,OAAO,GAAGC,IAAI,CAACC,GAAL,KAAaV,QAA3B,CAAA;;AAEA,IAAA,IAAID,SAAJ,EAAe;AACd,MAAA,OAAA;AACA,KAN8B;;;AAS/B,IAAA,SAASY,IAAT,GAAgB;AACfX,MAAAA,QAAQ,GAAGS,IAAI,CAACC,GAAL,EAAX,CAAA;AACAlB,MAAAA,QAAQ,CAACoB,KAAT,CAAeL,IAAf,EAAqBD,UAArB,CAAA,CAAA;AACA,KAAA;AAED;AACF;AACA;AACA;;;AACE,IAAA,SAASO,KAAT,GAAiB;AAChBf,MAAAA,SAAS,GAAGD,SAAZ,CAAA;AACA,KAAA;;AAED,IAAA,IAAI,CAACF,SAAD,IAAcC,YAAd,IAA8B,CAACE,SAAnC,EAA8C;AAC7C;AACH;AACA;AACA;AACA;AACGa,MAAAA,IAAI,EAAA,CAAA;AACJ,KAAA;;AAEDV,IAAAA,oBAAoB,EAAA,CAAA;;AAEpB,IAAA,IAAIL,YAAY,KAAKC,SAAjB,IAA8BW,OAAO,GAAGjB,KAA5C,EAAmD;AAClD,MAAA,IAAII,SAAJ,EAAe;AACd;AACJ;AACA;AACA;AACA;AACIK,QAAAA,QAAQ,GAAGS,IAAI,CAACC,GAAL,EAAX,CAAA;;AACA,QAAI,IAAA,CAAChB,UAAL,EAAiB;AAChBI,UAAAA,SAAS,GAAGgB,UAAU,CAAClB,YAAY,GAAGiB,KAAH,GAAWF,IAAxB,EAA8BpB,KAA9B,CAAtB,CAAA;AACA,SAAA;AACD,OAVD,MAUO;AACN;AACJ;AACA;AACA;AACIoB,QAAAA,IAAI,EAAA,CAAA;AACJ,OAAA;AACD,KAlBD,MAkBO,IAAIjB,UAAU,KAAK,IAAnB,EAAyB;AAC/B;AACH;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACGI,MAAAA,SAAS,GAAGgB,UAAU,CACrBlB,YAAY,GAAGiB,KAAH,GAAWF,IADF,EAErBf,YAAY,KAAKC,SAAjB,GAA6BN,KAAK,GAAGiB,OAArC,GAA+CjB,KAF1B,CAAtB,CAAA;AAIA,KAAA;AACD,GAAA;;AAEDc,EAAAA,OAAO,CAACF,MAAR,GAAiBA,MAAjB,CA1GkD;;AA6GlD,EAAA,OAAOE,OAAP,CAAA;AACA;;ACrID;AAIA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AACe,mBAAUd,KAAV,EAAiBC,QAAjB,EAA2BC,OAA3B,EAAoC;AAClD,EAA4BA,IAAAA,IAAAA,GAAAA,OAAO,IAAI,EAAvC;AAAA,MAAA,YAAA,GAAA,IAAA,CAAQsB,OAAR;AAAA,MAAQA,OAAR,6BAAkB,KAAlB,GAAA,YAAA,CAAA;;AACA,EAAA,OAAOC,QAAQ,CAACzB,KAAD,EAAQC,QAAR,EAAkB;AAAEI,IAAAA,YAAY,EAAEmB,OAAO,KAAK,KAAA;AAA5B,GAAlB,CAAf,CAAA;AACA;;;;"}