@vinicunca/perkakas 1.8.0 → 1.12.0

package/dist/funnel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"funnel.js","names":["burstTimeoutId: ReturnType<typeof setTimeout> | undefined","intervalTimeoutId: ReturnType<typeof setTimeout> | undefined","preparedData: R | undefined","burstStartTimestamp: number | undefined"],"sources":["../src/funnel.ts"],"sourcesContent":["import type { RequireAtLeastOne } from 'type-fest';\n\n/**\n * We use the value provided by the reducer to also determine if a call\n * was done during a timeout period. This means that even when no reducer\n * is provided, we still need a dummy reducer that would return something\n * other than `undefined`. It is safe to cast this to R (which might be\n * anything) because the callback would never use it as it would be typed\n * as a zero-args function.\n */\nconst VOID_REDUCER_SYMBOL = Symbol('funnel/voidReducer');\nconst voidReducer = <R>(): R => VOID_REDUCER_SYMBOL as R;\n\ntype FunnelOptions<Args extends RestArguments, R> = {\n  readonly reducer?: (accumulator: R | undefined, ...params: Args) => R;\n} & FunnelTimingOptions;\n\n/**\n * Not all combinations of timing options are valid, there are dependencies\n * between them to ensure users can't configure the funnel in a way which would\n * cause it to never trigger.\n */\ntype FunnelTimingOptions\n  = | ({ readonly triggerAt?: 'end' } & (\n      | ({ readonly minGapMs: number } & RequireAtLeastOne<{\n        readonly minQuietPeriodMs: number;\n        readonly maxBurstDurationMs: number;\n      }>)\n      | {\n        readonly minQuietPeriodMs?: number;\n        readonly maxBurstDurationMs?: number;\n        readonly minGapMs?: never;\n      }\n    ))\n    | {\n      readonly triggerAt: 'start' | 'both';\n      readonly minQuietPeriodMs?: number;\n      readonly maxBurstDurationMs?: number;\n      readonly minGapMs?: number;\n    };\n\n// eslint-disable-next-line ts/no-explicit-any -- TypeScript has some quirks with generic function types, and works best with `any` and not `unknown`. This follows the typing of built-in utilities like `ReturnType` and `Parameters`.\ntype RestArguments = Array<any>;\n\ninterface Funnel<Args extends RestArguments = []> {\n  /**\n   * Call the function. This might result in the `execute` function being called\n   * now or later, depending on it's configuration and it's current state.\n   *\n   * @param args - The args are defined by the `reducer` function.\n   */\n\n  readonly call: (...args: Args) => void;\n\n  /**\n   * Resets the funnel to it's initial state. Any calls made since the last\n   * invocation will be discarded.\n   */\n  readonly cancel: () => void;\n\n  /**\n   * Triggers an invocation regardless of the current state of the funnel.\n   * Like any other invocation, The funnel will also be reset to it's initial\n   * state afterwards.\n   */\n  readonly flush: () => void;\n\n  /**\n   * The funnel is in it's initial state (there are no active timeouts).\n   */\n  readonly isIdle: boolean;\n}\n\n/**\n * Creates a funnel that controls the timing and execution of `callback`. Its\n * main purpose is to manage multiple consecutive (usually fast-paced) calls,\n * reshaping them according to a defined batching strategy and timing policy.\n * This is useful when handling uncontrolled call rates, such as DOM events or\n * network traffic. It can implement strategies like debouncing, throttling,\n * batching, and more.\n *\n * An optional `reducer` function can be provided to allow passing data to the\n * callback via calls to `call` (otherwise the signature of `call` takes no\n * arguments).\n *\n * Typing is inferred from `callback`s param, and from the rest params that\n * the optional `reducer` function accepts. Use **explicit** types for these\n * to ensure that everything _else_ is well-typed.\n *\n * Notice that this function constructs a funnel **object**, and does **not**\n * execute anything when called. The returned object should be used to execute\n * the funnel via the its `call` method.\n *\n * - Debouncing: use `minQuietPeriodMs` and any `triggerAt`.\n * - Throttling: use `minGapMs` and `triggerAt: \"start\"` or `\"both\"`.\n * - Batching: See the reference implementation in [`funnel.reference-batch.test.ts`](https://github.com/vinicunca/perkakas/blob/main/src/funnel.reference-batch.test.ts).\n *\n * @param callback - The main function that would be invoked periodically based\n * on `options`. The function would take the latest result of the `reducer`; if\n * no calls where made since the last time it was invoked it will not be\n * invoked. (If a return value is needed, it should be passed via a reference or\n * via closure to the outer scope of the funnel).\n * @param options - An object that defines when `execute` should be invoked,\n * relative to the calls of `call`. An empty/missing options object is\n * equivalent to setting `minQuietPeriodMs` to `0`.\n * @param options.reducer - Combines the arguments passed to `call` with the\n * value computed on the previous call (or `undefined` on the first time). The\n * goal of the function is to extract and summarize the data needed for\n * `callback`. It should be fast and simple as it is called often and should\n * defer heavy operations to the `execute` function. If the final value\n * is `undefined`, `callback` will not be called.\n * @param options.triggerAt - At what \"edges\" of the funnel's burst window\n * would `execute` invoke:\n * - `start` - the function will be invoked immediately (within the  **same**\n * execution frame!), and any subsequent calls would be ignored until the funnel\n * is idle again. During this period `reducer` will also not be called.\n * - `end` - the function will **not** be invoked initially but the timer will\n * be started. Any calls during this time would be passed to the reducer, and\n * when the timers are done, the reduced result would trigger an invocation.\n * - `both` - the function will be invoked immediately, and then the funnel\n * would behave as if it was in the 'end' state. @default 'end'.\n * @param options.minQuietPeriodMs - The burst timer prevents subsequent calls\n * in short succession to cause excessive invocations (aka \"debounce\"). This\n * duration represents the **minimum** amount of time that needs to pass\n * between calls (the \"quiet\" part) in order for the subsequent call to **not**\n * be considered part of the burst. In other words, as long as calls are faster\n * than this, they are considered part of the burst and the burst is extended.\n * @param options.maxBurstDurationMs - Bursts are extended every time a call is\n * made within the burst period. This means that the burst period could be\n * extended indefinitely. To prevent such cases, a maximum burst duration could\n * be defined. When `minQuietPeriodMs` is not defined and this option is, they\n * will both share the same value.\n * @param options.minGapMs - A minimum duration between calls of `execute`.\n * This is maintained regardless of the shape of the burst and is ensured even\n * if the `maxBurstDurationMs` is reached before it. (aka \"throttle\").\n * @returns A funnel with a `call` function that is used to trigger invocations.\n * In addition to it the funnel also comes with the following functions and\n * properties:\n * - `cancel` - Resets the funnel to it's initial state, discarding the current\n * `reducer` result without calling `execute` on it.\n * - `flush` - Triggers an invocation even if there are active timeouts, and\n * then resets the funnel to it's initial state.\n * - `isIdle` - Checks if there are any active timeouts.\n * @signature\n *   P.funnel(callback, options);\n * @example\n *   const debouncer = P.funnel(\n *     () => {\n *       console.log(\"Callback executed!\");\n *     },\n *     { minQuietPeriodMs: 100 },\n *   );\n *   debouncer.call();\n *   debouncer.call();\n *\n *   const throttle = P.funnel(\n *     () => {\n *       console.log(\"Callback executed!\");\n *     },\n *     { minGapMs: 100, triggerAt: \"start\" },\n *   );\n *   throttle.call();\n *   throttle.call();\n * @category Function\n */\nexport function funnel<Args extends RestArguments = [], R = never>(\n  callback: (data: R) => void,\n  {\n    triggerAt = 'end',\n    minQuietPeriodMs,\n    maxBurstDurationMs,\n    minGapMs,\n    reducer = voidReducer,\n  }: FunnelOptions<Args, R>,\n): Funnel<Args> {\n  /**\n   * We manage execution via 2 timeouts, one to track bursts of calls, and one\n   * to track the interval between invocations. Together we refer to the period\n   * where any of these are active as a \"cool-down period\".\n   */\n  let burstTimeoutId: ReturnType<typeof setTimeout> | undefined;\n  let intervalTimeoutId: ReturnType<typeof setTimeout> | undefined;\n\n  /**\n   * Until invoked, all calls are reduced into a single value that would be sent\n   * to the executor on invocation.\n   */\n  let preparedData: R | undefined;\n\n  /**\n   * In order to be able to limit the total size of the burst (when\n   * `maxBurstDurationMs` is used) we need to track when the burst started.\n   */\n  let burstStartTimestamp: number | undefined;\n\n  function invoke(): void {\n    const param = preparedData;\n    if (param === undefined) {\n      // There were no calls during both cool-down periods.\n      return;\n    }\n\n    // Make sure the args aren't accidentally used again\n    preparedData = undefined;\n\n    // eslint-disable-next-line sonar/different-types-comparison\n    if (param === VOID_REDUCER_SYMBOL) {\n      // @ts-expect-error [ts2554] -- R is typed as `never` because we hide the\n      // symbol that `voidReducer` returns; there's no way to make TypeScript\n      // aware of this.\n      callback();\n    } else {\n      callback(param);\n    }\n\n    if (minGapMs !== undefined) {\n      intervalTimeoutId = setTimeout(handleIntervalEnd, minGapMs);\n    }\n  }\n\n  function handleIntervalEnd(): void {\n    /**\n     * When called via a timeout the timeout is already cleared, but when called\n     * via `flush` we need to manually clear it.\n     */\n    clearTimeout(intervalTimeoutId);\n    intervalTimeoutId = undefined;\n\n    if (burstTimeoutId !== undefined) {\n      /**\n       * As long as one of the timeouts is active we don't invoke the function.\n       * Each timeout's end event handler has a call to invoke, so we are\n       * guaranteed to invoke the function eventually.\n       */\n      return;\n    }\n\n    invoke();\n  };\n\n  function handleBurstEnd(): void {\n    /**\n     * When called via a timeout the timeout is already cleared, but when called\n     * via `flush` we need to manually clear it.\n     */\n    clearTimeout(burstTimeoutId);\n    burstTimeoutId = undefined;\n    burstStartTimestamp = undefined;\n\n    if (intervalTimeoutId !== undefined) {\n      /**\n       * As long as one of the timeouts is active we don't invoke the function.\n       * Each timeout's end event handler has a call to invoke, so we are\n       * guaranteed to invoke the function eventually.\n       */\n      return;\n    }\n\n    invoke();\n  };\n\n  return {\n    call: (...args) => {\n      /**\n       * We act based on the initial state of the timeouts before the call is\n       * handled and causes the timeouts to change.\n       */\n      const wasIdle = burstTimeoutId === undefined && intervalTimeoutId === undefined;\n\n      if (triggerAt !== 'start' || wasIdle) {\n        preparedData = reducer(preparedData, ...args);\n      }\n\n      if (burstTimeoutId === undefined && !wasIdle) {\n        /**\n         * We are not in an active burst period but in an interval period. We\n         * don't start a new burst window until the next invoke.\n         */\n        return;\n      }\n\n      if (\n        minQuietPeriodMs !== undefined\n        || maxBurstDurationMs !== undefined\n        || minGapMs === undefined\n      ) {\n        /**\n         * The timeout tracking the burst period needs to be reset every time\n         * another call is made so that it waits the full cool-down duration\n         * before it is released.\n         */\n        clearTimeout(burstTimeoutId);\n\n        const now = Date.now();\n\n        burstStartTimestamp ??= now;\n\n        const burstRemainingMs\n          = maxBurstDurationMs === undefined\n            ? (minQuietPeriodMs ?? 0)\n            : Math.min(\n                minQuietPeriodMs ?? maxBurstDurationMs,\n                /**\n                 * We need to account for the time already spent so that we\n                 * don't wait longer than the maxDelay.\n                 */\n                maxBurstDurationMs - (now - burstStartTimestamp),\n              );\n\n        burstTimeoutId = setTimeout(handleBurstEnd, burstRemainingMs);\n      }\n\n      if (triggerAt !== 'end' && wasIdle) {\n        invoke();\n      }\n    },\n\n    cancel: () => {\n      clearTimeout(burstTimeoutId);\n      burstTimeoutId = undefined;\n      burstStartTimestamp = undefined;\n\n      clearTimeout(intervalTimeoutId);\n      intervalTimeoutId = undefined;\n\n      preparedData = undefined;\n    },\n\n    flush: () => {\n      handleBurstEnd();\n      handleIntervalEnd();\n    },\n\n    get isIdle() {\n      return burstTimeoutId === undefined && intervalTimeoutId === undefined;\n    },\n  };\n}\n"],"mappings":"AAUA,MAAM,EAAsB,OAAO,qBAAqB,CAClD,MAA0B,EA0JhC,SAAgB,EACd,EACA,CACE,YAAY,MACZ,mBACA,qBACA,WACA,UAAU,GAEE,CAMd,IAAIA,EACAC,EAMAC,EAMAC,EAEJ,SAAS,GAAe,CACtB,IAAM,EAAQ,EACV,IAAU,IAAA,KAMd,EAAe,IAAA,GAGX,IAAU,EAIZ,GAAU,CAEV,EAAS,EAAM,CAGb,IAAa,IAAA,KACf,EAAoB,WAAW,EAAmB,EAAS,GAI/D,SAAS,GAA0B,CAKjC,aAAa,EAAkB,CAC/B,EAAoB,IAAA,GAEhB,IAAmB,IAAA,IASvB,GAAQ,CAGV,SAAS,GAAuB,CAK9B,aAAa,EAAe,CAC5B,EAAiB,IAAA,GACjB,EAAsB,IAAA,GAElB,IAAsB,IAAA,IAS1B,GAAQ,CAGV,MAAO,CACL,MAAO,GAAG,IAAS,CAKjB,IAAM,EAAU,IAAmB,IAAA,IAAa,IAAsB,IAAA,GAEtE,IAAI,IAAc,SAAW,KAC3B,EAAe,EAAQ,EAAc,GAAG,EAAK,EAG3C,MAAmB,IAAA,IAAa,CAAC,GAQrC,IACE,IAAqB,IAAA,IAClB,IAAuB,IAAA,IACvB,IAAa,IAAA,GAChB,CAMA,aAAa,EAAe,CAE5B,IAAM,EAAM,KAAK,KAAK,CAEtB,IAAwB,EAExB,IAAM,EACF,IAAuB,IAAA,GACpB,GAAoB,EACrB,KAAK,IACH,GAAoB,EAKpB,GAAsB,EAAM,GAC7B,CAEP,EAAiB,WAAW,EAAgB,EAAiB,CAG3D,IAAc,OAAS,GACzB,GAAQ,GAIZ,WAAc,CACZ,aAAa,EAAe,CAC5B,EAAiB,IAAA,GACjB,EAAsB,IAAA,GAEtB,aAAa,EAAkB,CAC/B,EAAoB,IAAA,GAEpB,EAAe,IAAA,IAGjB,UAAa,CACX,GAAgB,CAChB,GAAmB,EAGrB,IAAI,QAAS,CACX,OAAO,IAAmB,IAAA,IAAa,IAAsB,IAAA,IAEhE"}

package/dist/funnel.lodash-debounce-with-cached-value.test.cjs

@@ -1 +1 @@
-const e=require(`./dist-gvJoKj_M.cjs`),t=require(`./constant-BuIJ9GIn.cjs`),n=require(`./funnel-CL-QFpGk.cjs`),r=require(`./identity-BAryUWbs.cjs`),i=require(`./sleep-1rGV3wAg.cjs`);function a(e,t=0,{leading:r=!1,trailing:i=!0,maxWait:a}={}){let o,{call:s,flush:c,cancel:l}=n.funnel(t=>{!r&&!i||(o=e(...t))},{reducer:(e,...t)=>t,minQuietPeriodMs:t,...a!==void 0&&{maxBurstDurationMs:a},...i?r?{triggerAt:`both`}:{triggerAt:`end`}:{triggerAt:`start`}});return Object.assign((...e)=>(s(...e),o),{flush:()=>(c(),o),cancel:l})}const o=16;e.describe(`https://github.com/lodash/lodash/blob/4.17.21/test/test.js#L4187`,()=>{e.it(`should debounce a function`,async()=>{let t=e.vi.fn(r.identity()),n=a(t,16);e.globalExpect(n(`a`)).toBeUndefined(),e.globalExpect(n(`b`)).toBeUndefined(),e.globalExpect(n(`c`)).toBeUndefined(),e.globalExpect(t).toHaveBeenCalledTimes(0),await i.sleep(64),e.globalExpect(t).toHaveBeenCalledTimes(1),e.globalExpect(n(`d`)).toBe(`c`),e.globalExpect(n(`e`)).toBe(`c`),e.globalExpect(n(`f`)).toBe(`c`),e.globalExpect(t).toHaveBeenCalledTimes(1),await i.sleep(64),e.globalExpect(t).toHaveBeenCalledTimes(2)}),e.it("subsequent debounced calls return the last `func` result",async()=>{let t=a(r.identity(),16);t(`a`),await i.sleep(32),e.globalExpect(t(`b`)).not.toBe(`b`),await i.sleep(32),e.globalExpect(t(`c`)).not.toBe(`c`)}),e.it("subsequent leading debounced calls return the last `func` result",async()=>{let t=a(r.identity(),16,{leading:!0,trailing:!1});e.globalExpect(t(`a`)).toBe(`a`),e.globalExpect(t(`b`)).toBe(`a`),await i.sleep(32),e.globalExpect(t(`c`)).toBe(`c`),e.globalExpect(t(`d`)).toBe(`c`)}),e.it("should invoke the trailing call with the correct arguments and `this` binding",async()=>{let n={},r=e.vi.fn(t.constant(!1)),o=a(r,16,{maxWait:32});for(;o(n,`a`)??!0;)await i.sleep(0);await i.sleep(32),e.globalExpect(r).toHaveBeenCalledTimes(2),e.globalExpect(r).toHaveBeenLastCalledWith(n,`a`)})}),e.describe(`https://github.com/lodash/lodash/blob/4.17.21/test/test.js#L23038`,()=>{e.it("should reset `lastCalled` after cancelling",async()=>{let t=0,n=a(()=>(t+=1,t),16,{leading:!0});e.globalExpect(n()).toBe(1),n.cancel(),e.globalExpect(n()).toBe(2),n(),await i.sleep(32),e.globalExpect(t).toBe(3)}),e.it(`should support flushing delayed calls`,async()=>{let t=0,n=a(()=>(t+=1,t),16,{leading:!1});n(),e.globalExpect(n.flush()).toBe(1),await i.sleep(32),e.globalExpect(t).toBe(1)}),e.it("should noop `cancel` and `flush` when nothing is queued",async()=>{let n=e.vi.fn(t.constant(`hello`)),r=a(n,16);r.cancel(),e.globalExpect(r.flush()).toBeUndefined(),await i.sleep(32),e.globalExpect(n).toHaveBeenCalledTimes(0)})}),e.describe(`features not tested by Lodash`,()=>{e.it(`does nothing when neither leading nor trailing are enabled`,async()=>{let t=a(r.identity(),16,{leading:!1,trailing:!1});e.globalExpect(t(`hello`)).toBeUndefined(),e.globalExpect(t(`world`)).toBeUndefined(),await i.sleep(64),e.globalExpect(t(`goodbye`)).toBeUndefined()})});
+const e=require(`./dist-CiyBKPT6.cjs`),t=require(`./constant.cjs`),n=require(`./funnel.cjs`),r=require(`./identity.cjs`),i=require(`./sleep.cjs`);function a(e,t=0,{leading:r=!1,trailing:i=!0,maxWait:a}={}){let o,{call:s,flush:c,cancel:l}=n.funnel(t=>{!r&&!i||(o=e(...t))},{reducer:(e,...t)=>t,minQuietPeriodMs:t,...a!==void 0&&{maxBurstDurationMs:a},...i?r?{triggerAt:`both`}:{triggerAt:`end`}:{triggerAt:`start`}});return Object.assign((...e)=>(s(...e),o),{flush:()=>(c(),o),cancel:l})}const o=16;e.i(`https://github.com/lodash/lodash/blob/4.17.21/test/test.js#L4187`,()=>{e.a(`should debounce a function`,async()=>{let t=e.r.fn(r.identity()),n=a(t,16);e.n(n(`a`)).toBeUndefined(),e.n(n(`b`)).toBeUndefined(),e.n(n(`c`)).toBeUndefined(),e.n(t).toHaveBeenCalledTimes(0),await i.sleep(64),e.n(t).toHaveBeenCalledTimes(1),e.n(n(`d`)).toBe(`c`),e.n(n(`e`)).toBe(`c`),e.n(n(`f`)).toBe(`c`),e.n(t).toHaveBeenCalledTimes(1),await i.sleep(64),e.n(t).toHaveBeenCalledTimes(2)}),e.a("subsequent debounced calls return the last `func` result",async()=>{let t=a(r.identity(),16);t(`a`),await i.sleep(32),e.n(t(`b`)).not.toBe(`b`),await i.sleep(32),e.n(t(`c`)).not.toBe(`c`)}),e.a("subsequent leading debounced calls return the last `func` result",async()=>{let t=a(r.identity(),16,{leading:!0,trailing:!1});e.n(t(`a`)).toBe(`a`),e.n(t(`b`)).toBe(`a`),await i.sleep(32),e.n(t(`c`)).toBe(`c`),e.n(t(`d`)).toBe(`c`)}),e.a("should invoke the trailing call with the correct arguments and `this` binding",async()=>{let n={},r=e.r.fn(t.constant(!1)),o=a(r,16,{maxWait:32});for(;o(n,`a`)??!0;)await i.sleep(0);await i.sleep(32),e.n(r).toHaveBeenCalledTimes(2),e.n(r).toHaveBeenLastCalledWith(n,`a`)})}),e.i(`https://github.com/lodash/lodash/blob/4.17.21/test/test.js#L23038`,()=>{e.a("should reset `lastCalled` after cancelling",async()=>{let t=0,n=a(()=>(t+=1,t),16,{leading:!0});e.n(n()).toBe(1),n.cancel(),e.n(n()).toBe(2),n(),await i.sleep(32),e.n(t).toBe(3)}),e.a(`should support flushing delayed calls`,async()=>{let t=0,n=a(()=>(t+=1,t),16,{leading:!1});n(),e.n(n.flush()).toBe(1),await i.sleep(32),e.n(t).toBe(1)}),e.a("should noop `cancel` and `flush` when nothing is queued",async()=>{let n=e.r.fn(t.constant(`hello`)),r=a(n,16);r.cancel(),e.n(r.flush()).toBeUndefined(),await i.sleep(32),e.n(n).toHaveBeenCalledTimes(0)})}),e.i(`features not tested by Lodash`,()=>{e.a(`does nothing when neither leading nor trailing are enabled`,async()=>{let t=a(r.identity(),16,{leading:!1,trailing:!1});e.n(t(`hello`)).toBeUndefined(),e.n(t(`world`)).toBeUndefined(),await i.sleep(64),e.n(t(`goodbye`)).toBeUndefined()})});

package/dist/funnel.lodash-debounce-with-cached-value.test.js

@@ -1,2 +1,2 @@
-import{describe as e,globalExpect as t,it as n,vi as r}from"./dist-BQGZfjDS.js";import{constant as i}from"./constant-DrpDXHc7.js";import{funnel as a}from"./funnel-CEbURcmp.js";import{identity as o}from"./identity-D7NWGnLw.js";import{sleep as s}from"./sleep-DvzRMgY-.js";function c(e,t=0,{leading:n=!1,trailing:r=!0,maxWait:i}={}){let o,{call:s,flush:c,cancel:l}=a(t=>{!n&&!r||(o=e(...t))},{reducer:(e,...t)=>t,minQuietPeriodMs:t,...i!==void 0&&{maxBurstDurationMs:i},...r?n?{triggerAt:`both`}:{triggerAt:`end`}:{triggerAt:`start`}});return Object.assign((...e)=>(s(...e),o),{flush:()=>(c(),o),cancel:l})}e(`https://github.com/lodash/lodash/blob/4.17.21/test/test.js#L4187`,()=>{n(`should debounce a function`,async()=>{let e=r.fn(o()),n=c(e,16);t(n(`a`)).toBeUndefined(),t(n(`b`)).toBeUndefined(),t(n(`c`)).toBeUndefined(),t(e).toHaveBeenCalledTimes(0),await s(64),t(e).toHaveBeenCalledTimes(1),t(n(`d`)).toBe(`c`),t(n(`e`)).toBe(`c`),t(n(`f`)).toBe(`c`),t(e).toHaveBeenCalledTimes(1),await s(64),t(e).toHaveBeenCalledTimes(2)}),n("subsequent debounced calls return the last `func` result",async()=>{let e=c(o(),16);e(`a`),await s(32),t(e(`b`)).not.toBe(`b`),await s(32),t(e(`c`)).not.toBe(`c`)}),n("subsequent leading debounced calls return the last `func` result",async()=>{let e=c(o(),16,{leading:!0,trailing:!1});t(e(`a`)).toBe(`a`),t(e(`b`)).toBe(`a`),await s(32),t(e(`c`)).toBe(`c`),t(e(`d`)).toBe(`c`)}),n("should invoke the trailing call with the correct arguments and `this` binding",async()=>{let e={},n=r.fn(i(!1)),a=c(n,16,{maxWait:32});for(;a(e,`a`)??!0;)await s(0);await s(32),t(n).toHaveBeenCalledTimes(2),t(n).toHaveBeenLastCalledWith(e,`a`)})}),e(`https://github.com/lodash/lodash/blob/4.17.21/test/test.js#L23038`,()=>{n("should reset `lastCalled` after cancelling",async()=>{let e=0,n=c(()=>(e+=1,e),16,{leading:!0});t(n()).toBe(1),n.cancel(),t(n()).toBe(2),n(),await s(32),t(e).toBe(3)}),n(`should support flushing delayed calls`,async()=>{let e=0,n=c(()=>(e+=1,e),16,{leading:!1});n(),t(n.flush()).toBe(1),await s(32),t(e).toBe(1)}),n("should noop `cancel` and `flush` when nothing is queued",async()=>{let e=r.fn(i(`hello`)),n=c(e,16);n.cancel(),t(n.flush()).toBeUndefined(),await s(32),t(e).toHaveBeenCalledTimes(0)})}),e(`features not tested by Lodash`,()=>{n(`does nothing when neither leading nor trailing are enabled`,async()=>{let e=c(o(),16,{leading:!1,trailing:!1});t(e(`hello`)).toBeUndefined(),t(e(`world`)).toBeUndefined(),await s(64),t(e(`goodbye`)).toBeUndefined()})});
+import{a as e,i as t,n,r}from"./dist-CUT1dnRU.js";import{constant as i}from"./constant.js";import{funnel as a}from"./funnel.js";import{identity as o}from"./identity.js";import{sleep as s}from"./sleep.js";function c(e,t=0,{leading:n=!1,trailing:r=!0,maxWait:i}={}){let o,{call:s,flush:c,cancel:l}=a(t=>{!n&&!r||(o=e(...t))},{reducer:(e,...t)=>t,minQuietPeriodMs:t,...i!==void 0&&{maxBurstDurationMs:i},...r?n?{triggerAt:`both`}:{triggerAt:`end`}:{triggerAt:`start`}});return Object.assign((...e)=>(s(...e),o),{flush:()=>(c(),o),cancel:l})}t(`https://github.com/lodash/lodash/blob/4.17.21/test/test.js#L4187`,()=>{e(`should debounce a function`,async()=>{let e=r.fn(o()),t=c(e,16);n(t(`a`)).toBeUndefined(),n(t(`b`)).toBeUndefined(),n(t(`c`)).toBeUndefined(),n(e).toHaveBeenCalledTimes(0),await s(64),n(e).toHaveBeenCalledTimes(1),n(t(`d`)).toBe(`c`),n(t(`e`)).toBe(`c`),n(t(`f`)).toBe(`c`),n(e).toHaveBeenCalledTimes(1),await s(64),n(e).toHaveBeenCalledTimes(2)}),e("subsequent debounced calls return the last `func` result",async()=>{let e=c(o(),16);e(`a`),await s(32),n(e(`b`)).not.toBe(`b`),await s(32),n(e(`c`)).not.toBe(`c`)}),e("subsequent leading debounced calls return the last `func` result",async()=>{let e=c(o(),16,{leading:!0,trailing:!1});n(e(`a`)).toBe(`a`),n(e(`b`)).toBe(`a`),await s(32),n(e(`c`)).toBe(`c`),n(e(`d`)).toBe(`c`)}),e("should invoke the trailing call with the correct arguments and `this` binding",async()=>{let e={},t=r.fn(i(!1)),a=c(t,16,{maxWait:32});for(;a(e,`a`)??!0;)await s(0);await s(32),n(t).toHaveBeenCalledTimes(2),n(t).toHaveBeenLastCalledWith(e,`a`)})}),t(`https://github.com/lodash/lodash/blob/4.17.21/test/test.js#L23038`,()=>{e("should reset `lastCalled` after cancelling",async()=>{let e=0,t=c(()=>(e+=1,e),16,{leading:!0});n(t()).toBe(1),t.cancel(),n(t()).toBe(2),t(),await s(32),n(e).toBe(3)}),e(`should support flushing delayed calls`,async()=>{let e=0,t=c(()=>(e+=1,e),16,{leading:!1});t(),n(t.flush()).toBe(1),await s(32),n(e).toBe(1)}),e("should noop `cancel` and `flush` when nothing is queued",async()=>{let e=r.fn(i(`hello`)),t=c(e,16);t.cancel(),n(t.flush()).toBeUndefined(),await s(32),n(e).toHaveBeenCalledTimes(0)})}),t(`features not tested by Lodash`,()=>{e(`does nothing when neither leading nor trailing are enabled`,async()=>{let e=c(o(),16,{leading:!1,trailing:!1});n(e(`hello`)).toBeUndefined(),n(e(`world`)).toBeUndefined(),await s(64),n(e(`goodbye`)).toBeUndefined()})});
 //# sourceMappingURL=funnel.lodash-debounce-with-cached-value.test.js.map

package/dist/funnel.lodash-debounce-with-cached-value.test.js.map

@@ -1 +1 @@
-{"version":3,"file":"funnel.lodash-debounce-with-cached-value.test.js","names":["cachedValue: ReturnType<F> | undefined"],"sources":["../src/funnel.lodash-debounce-with-cached-value.test.ts"],"sourcesContent":["/* eslint-disable no-nested-ternary */\n/* eslint-disable antfu/consistent-list-newline */\n/* eslint-disable ts/explicit-function-return-type, ts/no-explicit-any --\n * These aren't useful for a reference implementation for a legacy library!\n */\n\nimport { describe, expect, it, vi } from 'vitest';\nimport { constant } from './constant';\nimport { funnel } from './funnel';\nimport { identity } from './identity';\nimport { sleep } from './sleep';\n\n/**\n * A reference implementation of the Lodash `debounce` function using the\n * The `funnel` function. While migrating from Lodash you can copy this\n * function as-is into your codebase and use it as a drop-in replacement; but\n * we recommend eventually inlining the call to `funnel` so you can adjust the\n * function to your specific needs.\n *\n * This is a more complex implementation which respects Lodash capability to\n * track the return value of the callback function. In most cases you are more\n * likely to prefer the simpler reference implementation `debounce` which can\n * be found in the other test file.\n *\n * The following tests in this file are based on the Lodash tests for debounce.\n * They have been adapted to work with our testing framework, have been fixed\n * or expanded slightly were it felt necessary, and have been modernized for\n * better readability. The names of the test cases have been preserved to ease\n * comparing them to the original tests. Tests that are unrelated to the cache\n * capability have been removed to avoid duplication with the other test file.\n *\n * Note that this means that whenever Lodash offered a concrete spec, we made\n * sure our reference implementation respects it, but there might be untested\n * use-cases that would have differing runtime behaviors.\n *\n * @see Lodash Documentation: https://lodash.com/docs/4.17.15#debounce\n * @see Lodash Implementation: https://github.com/lodash/lodash/blob/4.17.21/lodash.js#L10372\n * @see Lodash Tests: https://github.com/lodash/lodash/blob/4.17.21/test/test.js#L4187\n * @see Lodash Typing: https://github.com/DefinitelyTyped/DefinitelyTyped/blob/master/types/lodash/common/function.d.ts#L374\n */\nfunction debounceWithCachedValue<F extends (...args: any) => any>(\n  func: F,\n  wait = 0,\n  {\n    leading = false,\n    trailing = true,\n    maxWait,\n  }: {\n    readonly leading?: boolean;\n    readonly trailing?: boolean;\n    readonly maxWait?: number;\n  } = {}) {\n  let cachedValue: ReturnType<F> | undefined;\n\n  const { call, flush, cancel } = funnel(\n    (args: Parameters<F>) => {\n      if (!leading && !trailing) {\n        /**\n         * In Lodash you can disable both the trailing and leading edges of the\n         * debounce window, effectively causing the function to never be\n         * invoked. Our's uses the invokedAt enum exactly to prevent such a\n         * situation; so to simulate Lodash we need to only pass the callback\n         * when at least one of them is enabled.\n         */\n        return;\n      }\n\n      /**\n       * Funnel provides more control over the args, but lodash simply passes\n       * them through, to replicate this behavior we need to spread the args\n       * array maintained via the reducer below.\n       * Also, every time the function is invoked the cached value is updated.\n       */\n      cachedValue = func(...args) as ReturnType<F>;\n    },\n    {\n      /**\n       * Debounce stores the latest args it was called with for the next\n       * invocation of the callback.\n       */\n      reducer: (_, ...args: Parameters<F>) => args,\n      minQuietPeriodMs: wait,\n      ...(maxWait !== undefined && { maxBurstDurationMs: maxWait }),\n      ...(trailing\n        ? leading\n          ? { triggerAt: 'both' }\n          : { triggerAt: 'end' }\n        : { triggerAt: 'start' }),\n    },\n  );\n\n  /**\n   * Lodash uses a legacy JS-isms to attach helper functions to the main\n   * callback of `debounce`. In our function we return a proper object where the\n   * callback is one of the available properties. Here we destructure and then\n   * reconstruct the object to fit the Lodash API.\n   */\n  return Object.assign(\n    (...args: Parameters<F>) => {\n      call(...args);\n      return cachedValue;\n    },\n    {\n      flush: () => {\n        flush();\n        return cachedValue;\n      },\n\n      cancel,\n    },\n  );\n}\n\n/**\n * We need some non-trivial duration to use in all our tests, to abstract the\n * actual chosen value we use this UnitOfTime (UT) constant. As long as it is a\n * positive integer, the actual value doesn't matter (but the larger it is,\n * the longer the tests would take to run); the value used by Lodash is 32.\n * The number is in milliseconds.\n */\nconst UT = 16;\n\ndescribe('https://github.com/lodash/lodash/blob/4.17.21/test/test.js#L4187', () => {\n  it('should debounce a function', async () => {\n    const mockFn = vi.fn<(x: string) => string>(identity());\n    const debounced = debounceWithCachedValue(mockFn, UT);\n\n    expect(debounced('a')).toBeUndefined();\n    expect(debounced('b')).toBeUndefined();\n    expect(debounced('c')).toBeUndefined();\n    expect(mockFn).toHaveBeenCalledTimes(0);\n\n    await sleep(4 * UT);\n\n    expect(mockFn).toHaveBeenCalledTimes(1);\n    expect(debounced('d')).toBe('c');\n    expect(debounced('e')).toBe('c');\n    expect(debounced('f')).toBe('c');\n    expect(mockFn).toHaveBeenCalledTimes(1);\n\n    await sleep(4 * UT);\n\n    expect(mockFn).toHaveBeenCalledTimes(2);\n  });\n\n  it('subsequent debounced calls return the last `func` result', async () => {\n    const debounced = debounceWithCachedValue(identity(), UT);\n    debounced('a');\n    await sleep(2 * UT);\n\n    expect(debounced('b')).not.toBe('b');\n\n    await sleep(2 * UT);\n\n    expect(debounced('c')).not.toBe('c');\n  });\n\n  it('subsequent leading debounced calls return the last `func` result', async () => {\n    const debounced = debounceWithCachedValue(identity(), UT, {\n      leading: true,\n      trailing: false,\n    });\n\n    expect(debounced('a')).toBe('a');\n    expect(debounced('b')).toBe('a');\n\n    await sleep(2 * UT);\n\n    expect(debounced('c')).toBe('c');\n    expect(debounced('d')).toBe('c');\n  });\n\n  it('should invoke the trailing call with the correct arguments and `this` binding', async () => {\n    const DATA = {};\n    const mockFn = vi.fn<(a: object, b: string) => boolean>(constant(false));\n\n    /**\n     * In Lodash the test uses both `leading` and `trailing` timing options\n     * for this test, but it only works because the `leading` option in Lodash\n     * runs within the same execution frame as the call to the debouncer; the\n     * Lodash test also passes when the `leading` option is removed. For our\n     * implementation the \"leading\" option is delayed to the next execution\n     * frame, which, when used together with `maxWait` would cause the debouncer\n     * to see a \"quiet window\" and trigger an additional invocation of the\n     * mockFn, and the test to fail.\n     */\n    const debounced = debounceWithCachedValue(mockFn, UT, { maxWait: 2 * UT });\n\n    while (debounced(DATA, 'a') ?? true) {\n      // eslint-disable-next-line no-await-in-loop -- We sleep to yield execution so that the timeouts in the debouncer have a chance to run.\n      await sleep(0);\n    }\n    await sleep(2 * UT);\n\n    expect(mockFn).toHaveBeenCalledTimes(2);\n    expect(mockFn).toHaveBeenLastCalledWith(DATA, 'a');\n  });\n});\n\ndescribe('https://github.com/lodash/lodash/blob/4.17.21/test/test.js#L23038', () => {\n  it('should reset `lastCalled` after cancelling', async () => {\n    let callCount = 0;\n    const debounced = debounceWithCachedValue(\n      () => {\n        callCount += 1;\n        return callCount;\n      },\n      UT,\n      { leading: true },\n    );\n\n    expect(debounced()).toBe(1);\n\n    debounced.cancel();\n\n    expect(debounced()).toBe(2);\n\n    debounced();\n    await sleep(2 * UT);\n\n    expect(callCount).toBe(3);\n  });\n\n  it('should support flushing delayed calls', async () => {\n    let callCount = 0;\n    const debounced = debounceWithCachedValue(\n      () => {\n        callCount += 1;\n        return callCount;\n      },\n      UT,\n      { leading: false },\n    );\n    debounced();\n\n    expect(debounced.flush()).toBe(1);\n\n    await sleep(2 * UT);\n\n    expect(callCount).toBe(1);\n  });\n\n  it('should noop `cancel` and `flush` when nothing is queued', async () => {\n    const mockFn = vi.fn<() => string>(constant('hello'));\n    const debounced = debounceWithCachedValue(mockFn, UT);\n    debounced.cancel();\n\n    expect(debounced.flush()).toBeUndefined();\n\n    await sleep(2 * UT);\n\n    expect(mockFn).toHaveBeenCalledTimes(0);\n  });\n});\n\ndescribe('features not tested by Lodash', () => {\n  it('does nothing when neither leading nor trailing are enabled', async () => {\n    const debounced = debounceWithCachedValue(identity(), UT, {\n      leading: false,\n      trailing: false,\n    });\n\n    expect(debounced('hello')).toBeUndefined();\n    expect(debounced('world')).toBeUndefined();\n\n    await sleep(4 * UT);\n\n    expect(debounced('goodbye')).toBeUndefined();\n  });\n});\n"],"mappings":"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"}
+{"version":3,"file":"funnel.lodash-debounce-with-cached-value.test.js","names":["cachedValue: ReturnType<F> | undefined"],"sources":["../src/funnel.lodash-debounce-with-cached-value.test.ts"],"sourcesContent":["/* eslint-disable no-nested-ternary */\n/* eslint-disable antfu/consistent-list-newline */\n/* eslint-disable ts/explicit-function-return-type, ts/no-explicit-any --\n * These aren't useful for a reference implementation for a legacy library!\n */\n\nimport { describe, expect, it, vi } from 'vitest';\nimport { constant } from './constant';\nimport { funnel } from './funnel';\nimport { identity } from './identity';\nimport { sleep } from './sleep';\n\n/**\n * A reference implementation of the Lodash `debounce` function using the\n * The `funnel` function. While migrating from Lodash you can copy this\n * function as-is into your codebase and use it as a drop-in replacement; but\n * we recommend eventually inlining the call to `funnel` so you can adjust the\n * function to your specific needs.\n *\n * This is a more complex implementation which respects Lodash capability to\n * track the return value of the callback function. In most cases you are more\n * likely to prefer the simpler reference implementation `debounce` which can\n * be found in the other test file.\n *\n * The following tests in this file are based on the Lodash tests for debounce.\n * They have been adapted to work with our testing framework, have been fixed\n * or expanded slightly were it felt necessary, and have been modernized for\n * better readability. The names of the test cases have been preserved to ease\n * comparing them to the original tests. Tests that are unrelated to the cache\n * capability have been removed to avoid duplication with the other test file.\n *\n * Note that this means that whenever Lodash offered a concrete spec, we made\n * sure our reference implementation respects it, but there might be untested\n * use-cases that would have differing runtime behaviors.\n *\n * @see Lodash Documentation: https://lodash.com/docs/4.17.15#debounce\n * @see Lodash Implementation: https://github.com/lodash/lodash/blob/4.17.21/lodash.js#L10372\n * @see Lodash Tests: https://github.com/lodash/lodash/blob/4.17.21/test/test.js#L4187\n * @see Lodash Typing: https://github.com/DefinitelyTyped/DefinitelyTyped/blob/master/types/lodash/common/function.d.ts#L374\n */\nfunction debounceWithCachedValue<F extends (...args: any) => any>(\n  func: F,\n  wait = 0,\n  {\n    leading = false,\n    trailing = true,\n    maxWait,\n  }: {\n    readonly leading?: boolean;\n    readonly trailing?: boolean;\n    readonly maxWait?: number;\n  } = {}) {\n  let cachedValue: ReturnType<F> | undefined;\n\n  const { call, flush, cancel } = funnel(\n    (args: Parameters<F>) => {\n      if (!leading && !trailing) {\n        /**\n         * In Lodash you can disable both the trailing and leading edges of the\n         * debounce window, effectively causing the function to never be\n         * invoked. Our's uses the invokedAt enum exactly to prevent such a\n         * situation; so to simulate Lodash we need to only pass the callback\n         * when at least one of them is enabled.\n         */\n        return;\n      }\n\n      /**\n       * Funnel provides more control over the args, but lodash simply passes\n       * them through, to replicate this behavior we need to spread the args\n       * array maintained via the reducer below.\n       * Also, every time the function is invoked the cached value is updated.\n       */\n      cachedValue = func(...args) as ReturnType<F>;\n    },\n    {\n      /**\n       * Debounce stores the latest args it was called with for the next\n       * invocation of the callback.\n       */\n      reducer: (_, ...args: Parameters<F>) => args,\n      minQuietPeriodMs: wait,\n      ...(maxWait !== undefined && { maxBurstDurationMs: maxWait }),\n      ...(trailing\n        ? leading\n          ? { triggerAt: 'both' }\n          : { triggerAt: 'end' }\n        : { triggerAt: 'start' }),\n    },\n  );\n\n  /**\n   * Lodash uses a legacy JS-isms to attach helper functions to the main\n   * callback of `debounce`. In our function we return a proper object where the\n   * callback is one of the available properties. Here we destructure and then\n   * reconstruct the object to fit the Lodash API.\n   */\n  return Object.assign(\n    (...args: Parameters<F>) => {\n      call(...args);\n      return cachedValue;\n    },\n    {\n      flush: () => {\n        flush();\n        return cachedValue;\n      },\n\n      cancel,\n    },\n  );\n}\n\n/**\n * We need some non-trivial duration to use in all our tests, to abstract the\n * actual chosen value we use this UnitOfTime (UT) constant. As long as it is a\n * positive integer, the actual value doesn't matter (but the larger it is,\n * the longer the tests would take to run); the value used by Lodash is 32.\n * The number is in milliseconds.\n */\nconst UT = 16;\n\ndescribe('https://github.com/lodash/lodash/blob/4.17.21/test/test.js#L4187', () => {\n  it('should debounce a function', async () => {\n    const mockFn = vi.fn<(x: string) => string>(identity());\n    const debounced = debounceWithCachedValue(mockFn, UT);\n\n    expect(debounced('a')).toBeUndefined();\n    expect(debounced('b')).toBeUndefined();\n    expect(debounced('c')).toBeUndefined();\n    expect(mockFn).toHaveBeenCalledTimes(0);\n\n    await sleep(4 * UT);\n\n    expect(mockFn).toHaveBeenCalledTimes(1);\n    expect(debounced('d')).toBe('c');\n    expect(debounced('e')).toBe('c');\n    expect(debounced('f')).toBe('c');\n    expect(mockFn).toHaveBeenCalledTimes(1);\n\n    await sleep(4 * UT);\n\n    expect(mockFn).toHaveBeenCalledTimes(2);\n  });\n\n  it('subsequent debounced calls return the last `func` result', async () => {\n    const debounced = debounceWithCachedValue(identity(), UT);\n    debounced('a');\n    await sleep(2 * UT);\n\n    expect(debounced('b')).not.toBe('b');\n\n    await sleep(2 * UT);\n\n    expect(debounced('c')).not.toBe('c');\n  });\n\n  it('subsequent leading debounced calls return the last `func` result', async () => {\n    const debounced = debounceWithCachedValue(identity(), UT, {\n      leading: true,\n      trailing: false,\n    });\n\n    expect(debounced('a')).toBe('a');\n    expect(debounced('b')).toBe('a');\n\n    await sleep(2 * UT);\n\n    expect(debounced('c')).toBe('c');\n    expect(debounced('d')).toBe('c');\n  });\n\n  it('should invoke the trailing call with the correct arguments and `this` binding', async () => {\n    const DATA = {};\n    const mockFn = vi.fn<(a: object, b: string) => boolean>(constant(false));\n\n    /**\n     * In Lodash the test uses both `leading` and `trailing` timing options\n     * for this test, but it only works because the `leading` option in Lodash\n     * runs within the same execution frame as the call to the debouncer; the\n     * Lodash test also passes when the `leading` option is removed. For our\n     * implementation the \"leading\" option is delayed to the next execution\n     * frame, which, when used together with `maxWait` would cause the debouncer\n     * to see a \"quiet window\" and trigger an additional invocation of the\n     * mockFn, and the test to fail.\n     */\n    const debounced = debounceWithCachedValue(mockFn, UT, { maxWait: 2 * UT });\n\n    while (debounced(DATA, 'a') ?? true) {\n      // eslint-disable-next-line no-await-in-loop -- We sleep to yield execution so that the timeouts in the debouncer have a chance to run.\n      await sleep(0);\n    }\n    await sleep(2 * UT);\n\n    expect(mockFn).toHaveBeenCalledTimes(2);\n    expect(mockFn).toHaveBeenLastCalledWith(DATA, 'a');\n  });\n});\n\ndescribe('https://github.com/lodash/lodash/blob/4.17.21/test/test.js#L23038', () => {\n  it('should reset `lastCalled` after cancelling', async () => {\n    let callCount = 0;\n    const debounced = debounceWithCachedValue(\n      () => {\n        callCount += 1;\n        return callCount;\n      },\n      UT,\n      { leading: true },\n    );\n\n    expect(debounced()).toBe(1);\n\n    debounced.cancel();\n\n    expect(debounced()).toBe(2);\n\n    debounced();\n    await sleep(2 * UT);\n\n    expect(callCount).toBe(3);\n  });\n\n  it('should support flushing delayed calls', async () => {\n    let callCount = 0;\n    const debounced = debounceWithCachedValue(\n      () => {\n        callCount += 1;\n        return callCount;\n      },\n      UT,\n      { leading: false },\n    );\n    debounced();\n\n    expect(debounced.flush()).toBe(1);\n\n    await sleep(2 * UT);\n\n    expect(callCount).toBe(1);\n  });\n\n  it('should noop `cancel` and `flush` when nothing is queued', async () => {\n    const mockFn = vi.fn<() => string>(constant('hello'));\n    const debounced = debounceWithCachedValue(mockFn, UT);\n    debounced.cancel();\n\n    expect(debounced.flush()).toBeUndefined();\n\n    await sleep(2 * UT);\n\n    expect(mockFn).toHaveBeenCalledTimes(0);\n  });\n});\n\ndescribe('features not tested by Lodash', () => {\n  it('does nothing when neither leading nor trailing are enabled', async () => {\n    const debounced = debounceWithCachedValue(identity(), UT, {\n      leading: false,\n      trailing: false,\n    });\n\n    expect(debounced('hello')).toBeUndefined();\n    expect(debounced('world')).toBeUndefined();\n\n    await sleep(4 * UT);\n\n    expect(debounced('goodbye')).toBeUndefined();\n  });\n});\n"],"mappings":"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"}

package/dist/funnel.lodash-debounce.test.cjs

@@ -1 +1 @@
-const e=require(`./dist-gvJoKj_M.cjs`),t=require(`./funnel-CL-QFpGk.cjs`),n=require(`./sleep-1rGV3wAg.cjs`);function r(e,n=0,{leading:r=!1,trailing:i=!0,maxWait:a}={}){let{call:o,isIdle:s,...c}=t.funnel(t=>{!i&&!r||e(...t)},{reducer:(e,...t)=>t,minQuietPeriodMs:n,...a!==void 0&&{maxBurstDurationMs:a},...i?r?{triggerAt:`both`}:{triggerAt:`end`}:{triggerAt:`start`}});return Object.assign(o,c)}const i=16;e.describe(`https://github.com/lodash/lodash/blob/4.17.21/test/test.js#L4187`,()=>{e.it(`should debounce a function`,async()=>{let t=e.vi.fn(),i=r(t,16);i(`a`),i(`b`),i(`c`),e.globalExpect(t).toHaveBeenCalledTimes(0),await n.sleep(64),e.globalExpect(t).toHaveBeenCalledExactlyOnceWith(`c`),i(`d`),i(`e`),i(`f`),e.globalExpect(t).toHaveBeenCalledTimes(1),await n.sleep(64),e.globalExpect(t).toHaveBeenCalledTimes(2)}),e.it("should not immediately call `func` when `wait` is `0`",async()=>{let t=e.vi.fn(),n=r(t,0);n(),n(),e.globalExpect(t).toHaveBeenCalledTimes(0),await a(),e.globalExpect(t).toHaveBeenCalledTimes(1)}),e.it(`should apply default options`,async()=>{let t=e.vi.fn();r(t,16,{})(),e.globalExpect(t).toHaveBeenCalledTimes(0),await n.sleep(32),e.globalExpect(t).toHaveBeenCalledTimes(1)}),e.it("should support a `leading` option",async()=>{let t=e.vi.fn(),i=e.vi.fn(),a=r(t,16,{leading:!0,trailing:!1}),o=r(i,16,{leading:!0,trailing:!0});a(),e.globalExpect(t).toHaveBeenCalledTimes(1),o(),o(),e.globalExpect(i).toHaveBeenCalledTimes(1),await n.sleep(32),e.globalExpect(t).toHaveBeenCalledTimes(1),e.globalExpect(i).toHaveBeenCalledTimes(2),a(),e.globalExpect(t).toHaveBeenCalledTimes(2)}),e.it("should support a `trailing` option",async()=>{let t=e.vi.fn(),i=e.vi.fn(),a=r(t,16,{trailing:!0}),o=r(i,16,{trailing:!1});a(),e.globalExpect(t).toHaveBeenCalledTimes(0),o(),e.globalExpect(i).toHaveBeenCalledTimes(0),await n.sleep(32),e.globalExpect(t).toHaveBeenCalledTimes(1),e.globalExpect(i).toHaveBeenCalledTimes(0)}),e.it("should support a `maxWait` option",async()=>{let t=e.vi.fn(),i=r(t,16,{maxWait:32});i(),i(),e.globalExpect(t).toHaveBeenCalledTimes(0),await n.sleep(64),e.globalExpect(t).toHaveBeenCalledTimes(1),i(),i(),e.globalExpect(t).toHaveBeenCalledTimes(1),await n.sleep(64),e.globalExpect(t).toHaveBeenCalledTimes(2)}),e.it("should support `maxWait` in a tight loop",async()=>{let t=e.vi.fn(),n=e.vi.fn(),i=r(t,32,{maxWait:64}),o=r(n,48),s=Date.now()+160;for(;Date.now()<s;)i(),o();e.globalExpect(n).toHaveBeenCalledTimes(0),e.globalExpect(t).toHaveBeenCalledTimes(0),await a(),e.globalExpect(n).toHaveBeenCalledTimes(0),e.globalExpect(t).toHaveBeenCalledTimes(1)}),e.it("should queue a trailing call for subsequent debounced calls after `maxWait`",async()=>{let t=e.vi.fn(),i=r(t,96,{maxWait:96});i(),await n.sleep(5.5*16),i(),await n.sleep(.5*16),i(),await n.sleep(.5*16),i(),await n.sleep(9.5*16),e.globalExpect(t).toHaveBeenCalledTimes(2)}),e.it("should cancel `maxDelayed` when `delayed` is invoked",async()=>{let t=e.vi.fn(),i=r(t,16,{maxWait:32});i(),await n.sleep(64),i(),e.globalExpect(t).toHaveBeenCalledTimes(1),await n.sleep(32),e.globalExpect(t).toHaveBeenCalledTimes(2)}),e.it("should invoke the trailing call with the correct arguments and `this` binding",async()=>{let t=e.vi.fn(),i={},o=r(t,16,{leading:!0,maxWait:32});for(;t.mock.calls.length<2;)o(i,`a`),await a();await n.sleep(32),e.globalExpect(t).toHaveBeenCalledTimes(2),e.globalExpect(t).toHaveBeenLastCalledWith(i,`a`)})}),e.describe(`https://github.com/lodash/lodash/blob/4.17.21/test/test.js#L23038`,()=>{e.it("should use a default `wait` of `0`",async()=>{let t=e.vi.fn(),i=r(t);i(),await n.sleep(16),i(),e.globalExpect(t).toHaveBeenCalledTimes(1)}),e.it(`supports recursive calls`,async()=>{let t=[],i=[`a`,`b`,`c`],a=r(e=>{t.push(e);let n=i.shift();n!==void 0&&a(n)},16);a(i.shift()),e.globalExpect(t).toStrictEqual([]),await n.sleep(128),e.globalExpect(t).toStrictEqual([`a`,`b`,`c`])}),e.it(`should support cancelling delayed calls`,async()=>{let t=e.vi.fn(),i=r(t,16,{leading:!1});i(),i.cancel(),await n.sleep(32),e.globalExpect(t).toHaveBeenCalledTimes(0)}),e.it("should reset `lastCalled` after cancelling",async()=>{let t=e.vi.fn(),i=r(t,16,{leading:!0});i(),e.globalExpect(t).toHaveBeenCalledTimes(1),i.cancel(),i(),e.globalExpect(t).toHaveBeenCalledTimes(2),i(),await n.sleep(32),e.globalExpect(t).toHaveBeenCalledTimes(3)}),e.it(`should support flushing delayed calls`,async()=>{let t=e.vi.fn(),i=r(t,16,{leading:!1});i(),i.flush(),e.globalExpect(t).toHaveBeenCalledTimes(1),await n.sleep(32),e.globalExpect(t).toHaveBeenCalledTimes(1)}),e.it("should noop `cancel` and `flush` when nothing is queued",async()=>{let t=e.vi.fn(),i=r(t,16);i.cancel(),i.flush(),e.globalExpect(t).toHaveBeenCalledTimes(0),await n.sleep(32),e.globalExpect(t).toHaveBeenCalledTimes(0)})});async function a(){return await n.sleep(0)}
+const e=require(`./dist-CiyBKPT6.cjs`),t=require(`./funnel.cjs`),n=require(`./sleep.cjs`);function r(e,n=0,{leading:r=!1,trailing:i=!0,maxWait:a}={}){let{call:o,isIdle:s,...c}=t.funnel(t=>{!i&&!r||e(...t)},{reducer:(e,...t)=>t,minQuietPeriodMs:n,...a!==void 0&&{maxBurstDurationMs:a},...i?r?{triggerAt:`both`}:{triggerAt:`end`}:{triggerAt:`start`}});return Object.assign(o,c)}const i=16;e.i(`https://github.com/lodash/lodash/blob/4.17.21/test/test.js#L4187`,()=>{e.a(`should debounce a function`,async()=>{let t=e.r.fn(),i=r(t,16);i(`a`),i(`b`),i(`c`),e.n(t).toHaveBeenCalledTimes(0),await n.sleep(64),e.n(t).toHaveBeenCalledExactlyOnceWith(`c`),i(`d`),i(`e`),i(`f`),e.n(t).toHaveBeenCalledTimes(1),await n.sleep(64),e.n(t).toHaveBeenCalledTimes(2)}),e.a("should not immediately call `func` when `wait` is `0`",async()=>{let t=e.r.fn(),n=r(t,0);n(),n(),e.n(t).toHaveBeenCalledTimes(0),await a(),e.n(t).toHaveBeenCalledTimes(1)}),e.a(`should apply default options`,async()=>{let t=e.r.fn();r(t,16,{})(),e.n(t).toHaveBeenCalledTimes(0),await n.sleep(32),e.n(t).toHaveBeenCalledTimes(1)}),e.a("should support a `leading` option",async()=>{let t=e.r.fn(),i=e.r.fn(),a=r(t,16,{leading:!0,trailing:!1}),o=r(i,16,{leading:!0,trailing:!0});a(),e.n(t).toHaveBeenCalledTimes(1),o(),o(),e.n(i).toHaveBeenCalledTimes(1),await n.sleep(32),e.n(t).toHaveBeenCalledTimes(1),e.n(i).toHaveBeenCalledTimes(2),a(),e.n(t).toHaveBeenCalledTimes(2)}),e.a("should support a `trailing` option",async()=>{let t=e.r.fn(),i=e.r.fn(),a=r(t,16,{trailing:!0}),o=r(i,16,{trailing:!1});a(),e.n(t).toHaveBeenCalledTimes(0),o(),e.n(i).toHaveBeenCalledTimes(0),await n.sleep(32),e.n(t).toHaveBeenCalledTimes(1),e.n(i).toHaveBeenCalledTimes(0)}),e.a("should support a `maxWait` option",async()=>{let t=e.r.fn(),i=r(t,16,{maxWait:32});i(),i(),e.n(t).toHaveBeenCalledTimes(0),await n.sleep(64),e.n(t).toHaveBeenCalledTimes(1),i(),i(),e.n(t).toHaveBeenCalledTimes(1),await n.sleep(64),e.n(t).toHaveBeenCalledTimes(2)}),e.a("should support `maxWait` in a tight loop",async()=>{let t=e.r.fn(),n=e.r.fn(),i=r(t,32,{maxWait:64}),o=r(n,48),s=Date.now()+160;for(;Date.now()<s;)i(),o();e.n(n).toHaveBeenCalledTimes(0),e.n(t).toHaveBeenCalledTimes(0),await a(),e.n(n).toHaveBeenCalledTimes(0),e.n(t).toHaveBeenCalledTimes(1)}),e.a("should queue a trailing call for subsequent debounced calls after `maxWait`",async()=>{let t=e.r.fn(),i=r(t,96,{maxWait:96});i(),await n.sleep(5.5*16),i(),await n.sleep(.5*16),i(),await n.sleep(.5*16),i(),await n.sleep(9.5*16),e.n(t).toHaveBeenCalledTimes(2)}),e.a("should cancel `maxDelayed` when `delayed` is invoked",async()=>{let t=e.r.fn(),i=r(t,16,{maxWait:32});i(),await n.sleep(64),i(),e.n(t).toHaveBeenCalledTimes(1),await n.sleep(32),e.n(t).toHaveBeenCalledTimes(2)}),e.a("should invoke the trailing call with the correct arguments and `this` binding",async()=>{let t=e.r.fn(),i={},o=r(t,16,{leading:!0,maxWait:32});for(;t.mock.calls.length<2;)o(i,`a`),await a();await n.sleep(32),e.n(t).toHaveBeenCalledTimes(2),e.n(t).toHaveBeenLastCalledWith(i,`a`)})}),e.i(`https://github.com/lodash/lodash/blob/4.17.21/test/test.js#L23038`,()=>{e.a("should use a default `wait` of `0`",async()=>{let t=e.r.fn(),i=r(t);i(),await n.sleep(16),i(),e.n(t).toHaveBeenCalledTimes(1)}),e.a(`supports recursive calls`,async()=>{let t=[],i=[`a`,`b`,`c`],a=r(e=>{t.push(e);let n=i.shift();n!==void 0&&a(n)},16);a(i.shift()),e.n(t).toStrictEqual([]),await n.sleep(128),e.n(t).toStrictEqual([`a`,`b`,`c`])}),e.a(`should support cancelling delayed calls`,async()=>{let t=e.r.fn(),i=r(t,16,{leading:!1});i(),i.cancel(),await n.sleep(32),e.n(t).toHaveBeenCalledTimes(0)}),e.a("should reset `lastCalled` after cancelling",async()=>{let t=e.r.fn(),i=r(t,16,{leading:!0});i(),e.n(t).toHaveBeenCalledTimes(1),i.cancel(),i(),e.n(t).toHaveBeenCalledTimes(2),i(),await n.sleep(32),e.n(t).toHaveBeenCalledTimes(3)}),e.a(`should support flushing delayed calls`,async()=>{let t=e.r.fn(),i=r(t,16,{leading:!1});i(),i.flush(),e.n(t).toHaveBeenCalledTimes(1),await n.sleep(32),e.n(t).toHaveBeenCalledTimes(1)}),e.a("should noop `cancel` and `flush` when nothing is queued",async()=>{let t=e.r.fn(),i=r(t,16);i.cancel(),i.flush(),e.n(t).toHaveBeenCalledTimes(0),await n.sleep(32),e.n(t).toHaveBeenCalledTimes(0)})});async function a(){return await n.sleep(0)}

package/dist/funnel.lodash-debounce.test.js

@@ -1,2 +1,2 @@
-import{describe as e,globalExpect as t,it as n,vi as r}from"./dist-BQGZfjDS.js";import{funnel as i}from"./funnel-CEbURcmp.js";import{sleep as a}from"./sleep-DvzRMgY-.js";function o(e,t=0,{leading:n=!1,trailing:r=!0,maxWait:a}={}){let{call:o,isIdle:s,...c}=i(t=>{!r&&!n||e(...t)},{reducer:(e,...t)=>t,minQuietPeriodMs:t,...a!==void 0&&{maxBurstDurationMs:a},...r?n?{triggerAt:`both`}:{triggerAt:`end`}:{triggerAt:`start`}});return Object.assign(o,c)}e(`https://github.com/lodash/lodash/blob/4.17.21/test/test.js#L4187`,()=>{n(`should debounce a function`,async()=>{let e=r.fn(),n=o(e,16);n(`a`),n(`b`),n(`c`),t(e).toHaveBeenCalledTimes(0),await a(64),t(e).toHaveBeenCalledExactlyOnceWith(`c`),n(`d`),n(`e`),n(`f`),t(e).toHaveBeenCalledTimes(1),await a(64),t(e).toHaveBeenCalledTimes(2)}),n("should not immediately call `func` when `wait` is `0`",async()=>{let e=r.fn(),n=o(e,0);n(),n(),t(e).toHaveBeenCalledTimes(0),await s(),t(e).toHaveBeenCalledTimes(1)}),n(`should apply default options`,async()=>{let e=r.fn();o(e,16,{})(),t(e).toHaveBeenCalledTimes(0),await a(32),t(e).toHaveBeenCalledTimes(1)}),n("should support a `leading` option",async()=>{let e=r.fn(),n=r.fn(),i=o(e,16,{leading:!0,trailing:!1}),s=o(n,16,{leading:!0,trailing:!0});i(),t(e).toHaveBeenCalledTimes(1),s(),s(),t(n).toHaveBeenCalledTimes(1),await a(32),t(e).toHaveBeenCalledTimes(1),t(n).toHaveBeenCalledTimes(2),i(),t(e).toHaveBeenCalledTimes(2)}),n("should support a `trailing` option",async()=>{let e=r.fn(),n=r.fn(),i=o(e,16,{trailing:!0}),s=o(n,16,{trailing:!1});i(),t(e).toHaveBeenCalledTimes(0),s(),t(n).toHaveBeenCalledTimes(0),await a(32),t(e).toHaveBeenCalledTimes(1),t(n).toHaveBeenCalledTimes(0)}),n("should support a `maxWait` option",async()=>{let e=r.fn(),n=o(e,16,{maxWait:32});n(),n(),t(e).toHaveBeenCalledTimes(0),await a(64),t(e).toHaveBeenCalledTimes(1),n(),n(),t(e).toHaveBeenCalledTimes(1),await a(64),t(e).toHaveBeenCalledTimes(2)}),n("should support `maxWait` in a tight loop",async()=>{let e=r.fn(),n=r.fn(),i=o(e,32,{maxWait:64}),a=o(n,48),c=Date.now()+160;for(;Date.now()<c;)i(),a();t(n).toHaveBeenCalledTimes(0),t(e).toHaveBeenCalledTimes(0),await s(),t(n).toHaveBeenCalledTimes(0),t(e).toHaveBeenCalledTimes(1)}),n("should queue a trailing call for subsequent debounced calls after `maxWait`",async()=>{let e=r.fn(),n=o(e,96,{maxWait:96});n(),await a(5.5*16),n(),await a(.5*16),n(),await a(.5*16),n(),await a(9.5*16),t(e).toHaveBeenCalledTimes(2)}),n("should cancel `maxDelayed` when `delayed` is invoked",async()=>{let e=r.fn(),n=o(e,16,{maxWait:32});n(),await a(64),n(),t(e).toHaveBeenCalledTimes(1),await a(32),t(e).toHaveBeenCalledTimes(2)}),n("should invoke the trailing call with the correct arguments and `this` binding",async()=>{let e=r.fn(),n={},i=o(e,16,{leading:!0,maxWait:32});for(;e.mock.calls.length<2;)i(n,`a`),await s();await a(32),t(e).toHaveBeenCalledTimes(2),t(e).toHaveBeenLastCalledWith(n,`a`)})}),e(`https://github.com/lodash/lodash/blob/4.17.21/test/test.js#L23038`,()=>{n("should use a default `wait` of `0`",async()=>{let e=r.fn(),n=o(e);n(),await a(16),n(),t(e).toHaveBeenCalledTimes(1)}),n(`supports recursive calls`,async()=>{let e=[],n=[`a`,`b`,`c`],r=o(t=>{e.push(t);let i=n.shift();i!==void 0&&r(i)},16);r(n.shift()),t(e).toStrictEqual([]),await a(128),t(e).toStrictEqual([`a`,`b`,`c`])}),n(`should support cancelling delayed calls`,async()=>{let e=r.fn(),n=o(e,16,{leading:!1});n(),n.cancel(),await a(32),t(e).toHaveBeenCalledTimes(0)}),n("should reset `lastCalled` after cancelling",async()=>{let e=r.fn(),n=o(e,16,{leading:!0});n(),t(e).toHaveBeenCalledTimes(1),n.cancel(),n(),t(e).toHaveBeenCalledTimes(2),n(),await a(32),t(e).toHaveBeenCalledTimes(3)}),n(`should support flushing delayed calls`,async()=>{let e=r.fn(),n=o(e,16,{leading:!1});n(),n.flush(),t(e).toHaveBeenCalledTimes(1),await a(32),t(e).toHaveBeenCalledTimes(1)}),n("should noop `cancel` and `flush` when nothing is queued",async()=>{let e=r.fn(),n=o(e,16);n.cancel(),n.flush(),t(e).toHaveBeenCalledTimes(0),await a(32),t(e).toHaveBeenCalledTimes(0)})});async function s(){return await a(0)}
+import{a as e,i as t,n,r}from"./dist-CUT1dnRU.js";import{funnel as i}from"./funnel.js";import{sleep as a}from"./sleep.js";function o(e,t=0,{leading:n=!1,trailing:r=!0,maxWait:a}={}){let{call:o,isIdle:s,...c}=i(t=>{!r&&!n||e(...t)},{reducer:(e,...t)=>t,minQuietPeriodMs:t,...a!==void 0&&{maxBurstDurationMs:a},...r?n?{triggerAt:`both`}:{triggerAt:`end`}:{triggerAt:`start`}});return Object.assign(o,c)}t(`https://github.com/lodash/lodash/blob/4.17.21/test/test.js#L4187`,()=>{e(`should debounce a function`,async()=>{let e=r.fn(),t=o(e,16);t(`a`),t(`b`),t(`c`),n(e).toHaveBeenCalledTimes(0),await a(64),n(e).toHaveBeenCalledExactlyOnceWith(`c`),t(`d`),t(`e`),t(`f`),n(e).toHaveBeenCalledTimes(1),await a(64),n(e).toHaveBeenCalledTimes(2)}),e("should not immediately call `func` when `wait` is `0`",async()=>{let e=r.fn(),t=o(e,0);t(),t(),n(e).toHaveBeenCalledTimes(0),await s(),n(e).toHaveBeenCalledTimes(1)}),e(`should apply default options`,async()=>{let e=r.fn();o(e,16,{})(),n(e).toHaveBeenCalledTimes(0),await a(32),n(e).toHaveBeenCalledTimes(1)}),e("should support a `leading` option",async()=>{let e=r.fn(),t=r.fn(),i=o(e,16,{leading:!0,trailing:!1}),s=o(t,16,{leading:!0,trailing:!0});i(),n(e).toHaveBeenCalledTimes(1),s(),s(),n(t).toHaveBeenCalledTimes(1),await a(32),n(e).toHaveBeenCalledTimes(1),n(t).toHaveBeenCalledTimes(2),i(),n(e).toHaveBeenCalledTimes(2)}),e("should support a `trailing` option",async()=>{let e=r.fn(),t=r.fn(),i=o(e,16,{trailing:!0}),s=o(t,16,{trailing:!1});i(),n(e).toHaveBeenCalledTimes(0),s(),n(t).toHaveBeenCalledTimes(0),await a(32),n(e).toHaveBeenCalledTimes(1),n(t).toHaveBeenCalledTimes(0)}),e("should support a `maxWait` option",async()=>{let e=r.fn(),t=o(e,16,{maxWait:32});t(),t(),n(e).toHaveBeenCalledTimes(0),await a(64),n(e).toHaveBeenCalledTimes(1),t(),t(),n(e).toHaveBeenCalledTimes(1),await a(64),n(e).toHaveBeenCalledTimes(2)}),e("should support `maxWait` in a tight loop",async()=>{let e=r.fn(),t=r.fn(),i=o(e,32,{maxWait:64}),a=o(t,48),c=Date.now()+160;for(;Date.now()<c;)i(),a();n(t).toHaveBeenCalledTimes(0),n(e).toHaveBeenCalledTimes(0),await s(),n(t).toHaveBeenCalledTimes(0),n(e).toHaveBeenCalledTimes(1)}),e("should queue a trailing call for subsequent debounced calls after `maxWait`",async()=>{let e=r.fn(),t=o(e,96,{maxWait:96});t(),await a(5.5*16),t(),await a(.5*16),t(),await a(.5*16),t(),await a(9.5*16),n(e).toHaveBeenCalledTimes(2)}),e("should cancel `maxDelayed` when `delayed` is invoked",async()=>{let e=r.fn(),t=o(e,16,{maxWait:32});t(),await a(64),t(),n(e).toHaveBeenCalledTimes(1),await a(32),n(e).toHaveBeenCalledTimes(2)}),e("should invoke the trailing call with the correct arguments and `this` binding",async()=>{let e=r.fn(),t={},i=o(e,16,{leading:!0,maxWait:32});for(;e.mock.calls.length<2;)i(t,`a`),await s();await a(32),n(e).toHaveBeenCalledTimes(2),n(e).toHaveBeenLastCalledWith(t,`a`)})}),t(`https://github.com/lodash/lodash/blob/4.17.21/test/test.js#L23038`,()=>{e("should use a default `wait` of `0`",async()=>{let e=r.fn(),t=o(e);t(),await a(16),t(),n(e).toHaveBeenCalledTimes(1)}),e(`supports recursive calls`,async()=>{let e=[],t=[`a`,`b`,`c`],r=o(n=>{e.push(n);let i=t.shift();i!==void 0&&r(i)},16);r(t.shift()),n(e).toStrictEqual([]),await a(128),n(e).toStrictEqual([`a`,`b`,`c`])}),e(`should support cancelling delayed calls`,async()=>{let e=r.fn(),t=o(e,16,{leading:!1});t(),t.cancel(),await a(32),n(e).toHaveBeenCalledTimes(0)}),e("should reset `lastCalled` after cancelling",async()=>{let e=r.fn(),t=o(e,16,{leading:!0});t(),n(e).toHaveBeenCalledTimes(1),t.cancel(),t(),n(e).toHaveBeenCalledTimes(2),t(),await a(32),n(e).toHaveBeenCalledTimes(3)}),e(`should support flushing delayed calls`,async()=>{let e=r.fn(),t=o(e,16,{leading:!1});t(),t.flush(),n(e).toHaveBeenCalledTimes(1),await a(32),n(e).toHaveBeenCalledTimes(1)}),e("should noop `cancel` and `flush` when nothing is queued",async()=>{let e=r.fn(),t=o(e,16);t.cancel(),t.flush(),n(e).toHaveBeenCalledTimes(0),await a(32),n(e).toHaveBeenCalledTimes(0)})});async function s(){return await a(0)}
 //# sourceMappingURL=funnel.lodash-debounce.test.js.map

package/dist/funnel.lodash-debounce.test.js.map

@@ -1 +1 @@
-{"version":3,"file":"funnel.lodash-debounce.test.js","names":[],"sources":["../src/funnel.lodash-debounce.test.ts"],"sourcesContent":["/* eslint-disable no-nested-ternary */\n/* eslint-disable antfu/consistent-list-newline */\n/* eslint-disable ts/explicit-function-return-type, ts/no-explicit-any --\n * These aren't useful for a reference implementation for a legacy library!\n */\n\nimport { describe, expect, it, vi } from 'vitest';\nimport { funnel } from './funnel';\nimport { sleep } from './sleep';\n\n/**\n * A reference implementation of the Lodash `debounce` function using the\n * Our `funnel` function. While migrating from Lodash you can copy this\n * function as-is into your code base and use it as a drop-in replacement; but\n * we recommend eventually inlining the call to `funnel` so you can adjust the\n * function to your specific needs.\n *\n * This is a simplified implementation which ignores the Lodash capability to\n * track the return value of the callback function, but it is most likely the\n * more common use-case. For a more complete (and more complex) implementation\n * that also handles that requirement see the reference implementation for\n * `debounceWithCachedValue` in the other test file.\n *\n * The following tests in this file are based on the Lodash tests for debounce.\n * They have been adapted to work with our testing framework, have been fixed\n * or expanded slightly were it felt necessary, and have been modernized for\n * better readability. The names of the test cases have been preserved to ease\n * comparing them to the original tests.\n *\n * Note that this means that whenever Lodash offered a concrete spec, we made\n * sure our reference implementation respects it, but there might be untested\n * use-cases that would have differing runtime behaviors.\n *\n * @see Lodash Documentation: https://lodash.com/docs/4.17.15#debounce\n * @see Lodash Implementation: https://github.com/lodash/lodash/blob/4.17.21/lodash.js#L10372\n * @see Lodash Typing: https://github.com/DefinitelyTyped/DefinitelyTyped/blob/master/types/lodash/common/function.d.ts#L374\n */\nfunction debounce<F extends (...args: any) => void>(\n  func: F,\n  wait = 0,\n  {\n    leading = false,\n    trailing = true,\n    maxWait,\n  }: {\n    readonly leading?: boolean;\n    readonly trailing?: boolean;\n    readonly maxWait?: number;\n  } = {}) {\n  const {\n    call,\n    // Lodash v4 doesn't provide access to the `isIdle` (called `pending` in Lodash v5) information.\n    isIdle: _isIdle,\n    ...rest\n  } = funnel(\n    (args: Parameters<F>) => {\n      if (!trailing && !leading) {\n        /**\n         * In Lodash you can disable both the trailing and leading edges of the\n         * debounce window, effectively causing the function to never be\n         * invoked. Our's uses the invokedAt enum exactly to prevent such a\n         * situation; so to simulate Lodash we need to only pass the callback\n         * when at least one of them is enabled.\n         */\n        return;\n      }\n\n      /**\n       * Funnel provides more control over the args, but lodash simply passes\n       * them through, to replicate this behavior we need to spread the args\n       * array maintained via the reducer below.\n       */\n      func(...args);\n    },\n    {\n      // Debounce stores the latest args it was called with for the next invocation of the callback.\n      reducer: (_, ...args: Parameters<F>) => args,\n      minQuietPeriodMs: wait,\n      ...(maxWait !== undefined && { maxBurstDurationMs: maxWait }),\n      ...(trailing\n        ? leading\n          ? { triggerAt: 'both' }\n          : { triggerAt: 'end' }\n        : { triggerAt: 'start' }),\n    },\n  );\n\n  /**\n   * Lodash uses a legacy JS-ism to attach helper functions to the main\n   * callback of `debounce`. In our's we return a proper object where the\n   * callback is one of the available properties. Here we destructure and then\n   * reconstruct the object to fit the Lodash API.\n   */\n  return Object.assign(call, rest);\n}\n\n/**\n * We need some non-trivial duration to use in all our tests, to abstract the\n * actual chosen value we use this UnitOfTime (UT) constant. As long as it is a\n * positive integer, the actual value doesn't matter (but the larger it is,\n * the longer the tests would take to run); the value used by Lodash is 32.\n * The number is in milliseconds.\n */\nconst UT = 16;\n\ndescribe('https://github.com/lodash/lodash/blob/4.17.21/test/test.js#L4187', () => {\n  it('should debounce a function', async () => {\n    const mockFn = vi.fn<(x: string) => void>();\n    const debounced = debounce(mockFn, UT);\n    debounced('a');\n    debounced('b');\n    debounced('c');\n\n    expect(mockFn).toHaveBeenCalledTimes(0);\n\n    await sleep(4 * UT);\n\n    expect(mockFn).toHaveBeenCalledExactlyOnceWith('c');\n\n    debounced('d');\n    debounced('e');\n    debounced('f');\n\n    expect(mockFn).toHaveBeenCalledTimes(1);\n\n    await sleep(4 * UT);\n\n    expect(mockFn).toHaveBeenCalledTimes(2);\n  });\n\n  it('should not immediately call `func` when `wait` is `0`', async () => {\n    const mockFn = vi.fn<() => void>();\n    const debounced = debounce(mockFn, 0);\n    debounced();\n    debounced();\n\n    expect(mockFn).toHaveBeenCalledTimes(0);\n\n    await yieldExecution();\n\n    expect(mockFn).toHaveBeenCalledTimes(1);\n  });\n\n  it('should apply default options', async () => {\n    const mockFn = vi.fn<() => void>();\n    const debounced = debounce(mockFn, UT, {});\n    debounced();\n\n    expect(mockFn).toHaveBeenCalledTimes(0);\n\n    await sleep(2 * UT);\n\n    expect(mockFn).toHaveBeenCalledTimes(1);\n  });\n\n  it('should support a `leading` option', async () => {\n    const mockWithLeading = vi.fn<() => void>();\n    const mockWithLeadingAndTrailing = vi.fn<() => void>();\n    const withLeading = debounce(mockWithLeading, UT, {\n      leading: true,\n      /**\n       * This Lodash test configures both debouncers with the same timing\n       * options which doesn't seem to be the intent of the test based on the test\n       * name and the debouncer names. We fixed it in our test.\n       */\n      trailing: false,\n    });\n    const withLeadingAndTrailing = debounce(mockWithLeadingAndTrailing, UT, {\n      leading: true,\n      trailing: true,\n    });\n    withLeading();\n\n    expect(mockWithLeading).toHaveBeenCalledTimes(1);\n\n    withLeadingAndTrailing();\n    withLeadingAndTrailing();\n\n    expect(mockWithLeadingAndTrailing).toHaveBeenCalledTimes(1);\n\n    await sleep(2 * UT);\n\n    expect(mockWithLeading).toHaveBeenCalledTimes(1);\n    expect(mockWithLeadingAndTrailing).toHaveBeenCalledTimes(2);\n\n    withLeading();\n\n    expect(mockWithLeading).toHaveBeenCalledTimes(2);\n  });\n\n  it('should support a `trailing` option', async () => {\n    const mockWith = vi.fn<() => void>();\n    const mockWithout = vi.fn<() => void>();\n    const withTrailing = debounce(mockWith, UT, { trailing: true });\n    /**\n     * The lodash test disabled `trailing` but doesn't enable `leading`\n     * resulting in a debouncer that has no effective timing policy. We handle\n     * this situation so we kept the test, but it might be have been what the\n     * test was supposed to test.\n     */\n    const withoutTrailing = debounce(mockWithout, UT, { trailing: false });\n    withTrailing();\n\n    expect(mockWith).toHaveBeenCalledTimes(0);\n\n    withoutTrailing();\n\n    expect(mockWithout).toHaveBeenCalledTimes(0);\n\n    await sleep(2 * UT);\n\n    expect(mockWith).toHaveBeenCalledTimes(1);\n    expect(mockWithout).toHaveBeenCalledTimes(0);\n  });\n\n  it('should support a `maxWait` option', async () => {\n    const mockFn = vi.fn<() => void>();\n    const debounced = debounce(mockFn, UT, { maxWait: 2 * UT });\n    debounced();\n    debounced();\n\n    expect(mockFn).toHaveBeenCalledTimes(0);\n\n    await sleep(4 * UT);\n\n    expect(mockFn).toHaveBeenCalledTimes(1);\n\n    debounced();\n    debounced();\n\n    expect(mockFn).toHaveBeenCalledTimes(1);\n\n    await sleep(4 * UT);\n\n    expect(mockFn).toHaveBeenCalledTimes(2);\n  });\n\n  it('should support `maxWait` in a tight loop', async () => {\n    const mockWith = vi.fn<() => void>();\n    const mockWithout = vi.fn<() => void>();\n    const withMaxWait = debounce(mockWith, 2 * UT, { maxWait: 4 * UT });\n    const withoutMaxWait = debounce(mockWithout, 3 * UT);\n    const end = Date.now() + 10 * UT;\n    while (Date.now() < end) {\n      withMaxWait();\n      withoutMaxWait();\n    }\n\n    /**\n     * There's a bug in the Lodash test where they take the result before the\n     * sleep (setTimeout); but it still worked for them coincidentally because\n     * of how maxWait is implemented:\n     * In Lodash, when the maxWait is reached, the callback is invoked within\n     * the same execution frame (without a setTimeout). In our's we use a\n     * setTimeout even when it's effective delay is 0ms. This means that we fail\n     * the lodash test if we don't first yield the execution frame to get the\n     * timeout to run; Oddly, the Lodash test already had this yield in place\n     * (although removing it won't break the lodash test), so to fix the test we\n     * simply added more expects to show the difference in implementations.\n     */\n\n    expect(mockWithout).toHaveBeenCalledTimes(0);\n    expect(mockWith).toHaveBeenCalledTimes(0);\n\n    await yieldExecution();\n\n    expect(mockWithout).toHaveBeenCalledTimes(0);\n    expect(mockWith).toHaveBeenCalledTimes(1);\n  });\n\n  it('should queue a trailing call for subsequent debounced calls after `maxWait`', async () => {\n    const mockFn = vi.fn<() => void>();\n    const debounced = debounce(mockFn, 6 * UT, { maxWait: 6 * UT });\n    debounced();\n    await sleep(5.5 * UT);\n    debounced();\n    await sleep(0.5 * UT);\n    debounced();\n    await sleep(0.5 * UT);\n    debounced();\n    await sleep(9.5 * UT);\n\n    expect(mockFn).toHaveBeenCalledTimes(2);\n  });\n\n  it('should cancel `maxDelayed` when `delayed` is invoked', async () => {\n    const mockFn = vi.fn<() => void>();\n    const debounced = debounce(mockFn, UT, { maxWait: 2 * UT });\n    debounced();\n    await sleep(4 * UT);\n    debounced();\n\n    expect(mockFn).toHaveBeenCalledTimes(1);\n\n    await sleep(2 * UT);\n\n    expect(mockFn).toHaveBeenCalledTimes(2);\n  });\n\n  it('should invoke the trailing call with the correct arguments and `this` binding', async () => {\n    const mockFn = vi.fn<(a: object, b: string) => void>();\n    const DATA = {};\n    const debounced = debounce(mockFn, UT, {\n      leading: true,\n      maxWait: 2 * UT,\n    });\n    while (mockFn.mock.calls.length < 2) {\n      debounced(DATA, 'a');\n      // eslint-disable-next-line no-await-in-loop\n      await yieldExecution();\n    }\n    await sleep(2 * UT);\n\n    expect(mockFn).toHaveBeenCalledTimes(2);\n    expect(mockFn).toHaveBeenLastCalledWith(DATA, 'a');\n  });\n});\n\ndescribe('https://github.com/lodash/lodash/blob/4.17.21/test/test.js#L23038', () => {\n  it('should use a default `wait` of `0`', async () => {\n    const mockFn = vi.fn<() => void>();\n    const debounced = debounce(mockFn);\n    debounced();\n    await sleep(UT);\n    debounced();\n\n    expect(mockFn).toHaveBeenCalledTimes(1);\n  });\n\n  it('supports recursive calls', async () => {\n    const actual = [] as Array<string>;\n    const queue = ['a', 'b', 'c'];\n    const debounced = debounce((chr: string) => {\n      actual.push(chr);\n      const next = queue.shift();\n      if (next !== undefined) {\n        debounced(next);\n      }\n    }, UT);\n    debounced(queue.shift()!);\n\n    expect(actual).toStrictEqual([]);\n\n    await sleep(8 * UT);\n\n    expect(actual).toStrictEqual(['a', 'b', 'c']);\n  });\n\n  it('should support cancelling delayed calls', async () => {\n    const mockFn = vi.fn<() => void>();\n    const debounced = debounce(mockFn, UT, { leading: false });\n    debounced();\n    debounced.cancel();\n    await sleep(2 * UT);\n\n    expect(mockFn).toHaveBeenCalledTimes(0);\n  });\n\n  it('should reset `lastCalled` after cancelling', async () => {\n    const mockFn = vi.fn<() => void>();\n    const debounced = debounce(mockFn, UT, { leading: true });\n    debounced();\n\n    expect(mockFn).toHaveBeenCalledTimes(1);\n\n    debounced.cancel();\n    debounced();\n\n    expect(mockFn).toHaveBeenCalledTimes(2);\n\n    debounced();\n    await sleep(2 * UT);\n\n    expect(mockFn).toHaveBeenCalledTimes(3);\n  });\n\n  it('should support flushing delayed calls', async () => {\n    const mockFn = vi.fn<() => void>();\n    const debounced = debounce(mockFn, UT, { leading: false });\n    debounced();\n    debounced.flush();\n\n    expect(mockFn).toHaveBeenCalledTimes(1);\n\n    await sleep(2 * UT);\n\n    expect(mockFn).toHaveBeenCalledTimes(1);\n  });\n\n  it('should noop `cancel` and `flush` when nothing is queued', async () => {\n    const mockFn = vi.fn<() => void>();\n    const debounced = debounce(mockFn, UT);\n    debounced.cancel();\n    debounced.flush();\n\n    expect(mockFn).toHaveBeenCalledTimes(0);\n\n    await sleep(2 * UT);\n\n    expect(mockFn).toHaveBeenCalledTimes(0);\n  });\n});\n\n/**\n * Funnel relies on letting the timeouts run. To ensure that happens the tests\n * need to yield execution.\n */\nasync function yieldExecution() {\n  return await sleep(0);\n}\n"],"mappings":"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"}
+{"version":3,"file":"funnel.lodash-debounce.test.js","names":[],"sources":["../src/funnel.lodash-debounce.test.ts"],"sourcesContent":["/* eslint-disable no-nested-ternary */\n/* eslint-disable antfu/consistent-list-newline */\n/* eslint-disable ts/explicit-function-return-type, ts/no-explicit-any --\n * These aren't useful for a reference implementation for a legacy library!\n */\n\nimport { describe, expect, it, vi } from 'vitest';\nimport { funnel } from './funnel';\nimport { sleep } from './sleep';\n\n/**\n * A reference implementation of the Lodash `debounce` function using the\n * Our `funnel` function. While migrating from Lodash you can copy this\n * function as-is into your code base and use it as a drop-in replacement; but\n * we recommend eventually inlining the call to `funnel` so you can adjust the\n * function to your specific needs.\n *\n * This is a simplified implementation which ignores the Lodash capability to\n * track the return value of the callback function, but it is most likely the\n * more common use-case. For a more complete (and more complex) implementation\n * that also handles that requirement see the reference implementation for\n * `debounceWithCachedValue` in the other test file.\n *\n * The following tests in this file are based on the Lodash tests for debounce.\n * They have been adapted to work with our testing framework, have been fixed\n * or expanded slightly were it felt necessary, and have been modernized for\n * better readability. The names of the test cases have been preserved to ease\n * comparing them to the original tests.\n *\n * Note that this means that whenever Lodash offered a concrete spec, we made\n * sure our reference implementation respects it, but there might be untested\n * use-cases that would have differing runtime behaviors.\n *\n * @see Lodash Documentation: https://lodash.com/docs/4.17.15#debounce\n * @see Lodash Implementation: https://github.com/lodash/lodash/blob/4.17.21/lodash.js#L10372\n * @see Lodash Typing: https://github.com/DefinitelyTyped/DefinitelyTyped/blob/master/types/lodash/common/function.d.ts#L374\n */\nfunction debounce<F extends (...args: any) => void>(\n  func: F,\n  wait = 0,\n  {\n    leading = false,\n    trailing = true,\n    maxWait,\n  }: {\n    readonly leading?: boolean;\n    readonly trailing?: boolean;\n    readonly maxWait?: number;\n  } = {}) {\n  const {\n    call,\n    // Lodash v4 doesn't provide access to the `isIdle` (called `pending` in Lodash v5) information.\n    isIdle: _isIdle,\n    ...rest\n  } = funnel(\n    (args: Parameters<F>) => {\n      if (!trailing && !leading) {\n        /**\n         * In Lodash you can disable both the trailing and leading edges of the\n         * debounce window, effectively causing the function to never be\n         * invoked. Our's uses the invokedAt enum exactly to prevent such a\n         * situation; so to simulate Lodash we need to only pass the callback\n         * when at least one of them is enabled.\n         */\n        return;\n      }\n\n      /**\n       * Funnel provides more control over the args, but lodash simply passes\n       * them through, to replicate this behavior we need to spread the args\n       * array maintained via the reducer below.\n       */\n      func(...args);\n    },\n    {\n      // Debounce stores the latest args it was called with for the next invocation of the callback.\n      reducer: (_, ...args: Parameters<F>) => args,\n      minQuietPeriodMs: wait,\n      ...(maxWait !== undefined && { maxBurstDurationMs: maxWait }),\n      ...(trailing\n        ? leading\n          ? { triggerAt: 'both' }\n          : { triggerAt: 'end' }\n        : { triggerAt: 'start' }),\n    },\n  );\n\n  /**\n   * Lodash uses a legacy JS-ism to attach helper functions to the main\n   * callback of `debounce`. In our's we return a proper object where the\n   * callback is one of the available properties. Here we destructure and then\n   * reconstruct the object to fit the Lodash API.\n   */\n  return Object.assign(call, rest);\n}\n\n/**\n * We need some non-trivial duration to use in all our tests, to abstract the\n * actual chosen value we use this UnitOfTime (UT) constant. As long as it is a\n * positive integer, the actual value doesn't matter (but the larger it is,\n * the longer the tests would take to run); the value used by Lodash is 32.\n * The number is in milliseconds.\n */\nconst UT = 16;\n\ndescribe('https://github.com/lodash/lodash/blob/4.17.21/test/test.js#L4187', () => {\n  it('should debounce a function', async () => {\n    const mockFn = vi.fn<(x: string) => void>();\n    const debounced = debounce(mockFn, UT);\n    debounced('a');\n    debounced('b');\n    debounced('c');\n\n    expect(mockFn).toHaveBeenCalledTimes(0);\n\n    await sleep(4 * UT);\n\n    expect(mockFn).toHaveBeenCalledExactlyOnceWith('c');\n\n    debounced('d');\n    debounced('e');\n    debounced('f');\n\n    expect(mockFn).toHaveBeenCalledTimes(1);\n\n    await sleep(4 * UT);\n\n    expect(mockFn).toHaveBeenCalledTimes(2);\n  });\n\n  it('should not immediately call `func` when `wait` is `0`', async () => {\n    const mockFn = vi.fn<() => void>();\n    const debounced = debounce(mockFn, 0);\n    debounced();\n    debounced();\n\n    expect(mockFn).toHaveBeenCalledTimes(0);\n\n    await yieldExecution();\n\n    expect(mockFn).toHaveBeenCalledTimes(1);\n  });\n\n  it('should apply default options', async () => {\n    const mockFn = vi.fn<() => void>();\n    const debounced = debounce(mockFn, UT, {});\n    debounced();\n\n    expect(mockFn).toHaveBeenCalledTimes(0);\n\n    await sleep(2 * UT);\n\n    expect(mockFn).toHaveBeenCalledTimes(1);\n  });\n\n  it('should support a `leading` option', async () => {\n    const mockWithLeading = vi.fn<() => void>();\n    const mockWithLeadingAndTrailing = vi.fn<() => void>();\n    const withLeading = debounce(mockWithLeading, UT, {\n      leading: true,\n      /**\n       * This Lodash test configures both debouncers with the same timing\n       * options which doesn't seem to be the intent of the test based on the test\n       * name and the debouncer names. We fixed it in our test.\n       */\n      trailing: false,\n    });\n    const withLeadingAndTrailing = debounce(mockWithLeadingAndTrailing, UT, {\n      leading: true,\n      trailing: true,\n    });\n    withLeading();\n\n    expect(mockWithLeading).toHaveBeenCalledTimes(1);\n\n    withLeadingAndTrailing();\n    withLeadingAndTrailing();\n\n    expect(mockWithLeadingAndTrailing).toHaveBeenCalledTimes(1);\n\n    await sleep(2 * UT);\n\n    expect(mockWithLeading).toHaveBeenCalledTimes(1);\n    expect(mockWithLeadingAndTrailing).toHaveBeenCalledTimes(2);\n\n    withLeading();\n\n    expect(mockWithLeading).toHaveBeenCalledTimes(2);\n  });\n\n  it('should support a `trailing` option', async () => {\n    const mockWith = vi.fn<() => void>();\n    const mockWithout = vi.fn<() => void>();\n    const withTrailing = debounce(mockWith, UT, { trailing: true });\n    /**\n     * The lodash test disabled `trailing` but doesn't enable `leading`\n     * resulting in a debouncer that has no effective timing policy. We handle\n     * this situation so we kept the test, but it might be have been what the\n     * test was supposed to test.\n     */\n    const withoutTrailing = debounce(mockWithout, UT, { trailing: false });\n    withTrailing();\n\n    expect(mockWith).toHaveBeenCalledTimes(0);\n\n    withoutTrailing();\n\n    expect(mockWithout).toHaveBeenCalledTimes(0);\n\n    await sleep(2 * UT);\n\n    expect(mockWith).toHaveBeenCalledTimes(1);\n    expect(mockWithout).toHaveBeenCalledTimes(0);\n  });\n\n  it('should support a `maxWait` option', async () => {\n    const mockFn = vi.fn<() => void>();\n    const debounced = debounce(mockFn, UT, { maxWait: 2 * UT });\n    debounced();\n    debounced();\n\n    expect(mockFn).toHaveBeenCalledTimes(0);\n\n    await sleep(4 * UT);\n\n    expect(mockFn).toHaveBeenCalledTimes(1);\n\n    debounced();\n    debounced();\n\n    expect(mockFn).toHaveBeenCalledTimes(1);\n\n    await sleep(4 * UT);\n\n    expect(mockFn).toHaveBeenCalledTimes(2);\n  });\n\n  it('should support `maxWait` in a tight loop', async () => {\n    const mockWith = vi.fn<() => void>();\n    const mockWithout = vi.fn<() => void>();\n    const withMaxWait = debounce(mockWith, 2 * UT, { maxWait: 4 * UT });\n    const withoutMaxWait = debounce(mockWithout, 3 * UT);\n    const end = Date.now() + 10 * UT;\n    while (Date.now() < end) {\n      withMaxWait();\n      withoutMaxWait();\n    }\n\n    /**\n     * There's a bug in the Lodash test where they take the result before the\n     * sleep (setTimeout); but it still worked for them coincidentally because\n     * of how maxWait is implemented:\n     * In Lodash, when the maxWait is reached, the callback is invoked within\n     * the same execution frame (without a setTimeout). In our's we use a\n     * setTimeout even when it's effective delay is 0ms. This means that we fail\n     * the lodash test if we don't first yield the execution frame to get the\n     * timeout to run; Oddly, the Lodash test already had this yield in place\n     * (although removing it won't break the lodash test), so to fix the test we\n     * simply added more expects to show the difference in implementations.\n     */\n\n    expect(mockWithout).toHaveBeenCalledTimes(0);\n    expect(mockWith).toHaveBeenCalledTimes(0);\n\n    await yieldExecution();\n\n    expect(mockWithout).toHaveBeenCalledTimes(0);\n    expect(mockWith).toHaveBeenCalledTimes(1);\n  });\n\n  it('should queue a trailing call for subsequent debounced calls after `maxWait`', async () => {\n    const mockFn = vi.fn<() => void>();\n    const debounced = debounce(mockFn, 6 * UT, { maxWait: 6 * UT });\n    debounced();\n    await sleep(5.5 * UT);\n    debounced();\n    await sleep(0.5 * UT);\n    debounced();\n    await sleep(0.5 * UT);\n    debounced();\n    await sleep(9.5 * UT);\n\n    expect(mockFn).toHaveBeenCalledTimes(2);\n  });\n\n  it('should cancel `maxDelayed` when `delayed` is invoked', async () => {\n    const mockFn = vi.fn<() => void>();\n    const debounced = debounce(mockFn, UT, { maxWait: 2 * UT });\n    debounced();\n    await sleep(4 * UT);\n    debounced();\n\n    expect(mockFn).toHaveBeenCalledTimes(1);\n\n    await sleep(2 * UT);\n\n    expect(mockFn).toHaveBeenCalledTimes(2);\n  });\n\n  it('should invoke the trailing call with the correct arguments and `this` binding', async () => {\n    const mockFn = vi.fn<(a: object, b: string) => void>();\n    const DATA = {};\n    const debounced = debounce(mockFn, UT, {\n      leading: true,\n      maxWait: 2 * UT,\n    });\n    while (mockFn.mock.calls.length < 2) {\n      debounced(DATA, 'a');\n      // eslint-disable-next-line no-await-in-loop\n      await yieldExecution();\n    }\n    await sleep(2 * UT);\n\n    expect(mockFn).toHaveBeenCalledTimes(2);\n    expect(mockFn).toHaveBeenLastCalledWith(DATA, 'a');\n  });\n});\n\ndescribe('https://github.com/lodash/lodash/blob/4.17.21/test/test.js#L23038', () => {\n  it('should use a default `wait` of `0`', async () => {\n    const mockFn = vi.fn<() => void>();\n    const debounced = debounce(mockFn);\n    debounced();\n    await sleep(UT);\n    debounced();\n\n    expect(mockFn).toHaveBeenCalledTimes(1);\n  });\n\n  it('supports recursive calls', async () => {\n    const actual = [] as Array<string>;\n    const queue = ['a', 'b', 'c'];\n    const debounced = debounce((chr: string) => {\n      actual.push(chr);\n      const next = queue.shift();\n      if (next !== undefined) {\n        debounced(next);\n      }\n    }, UT);\n    debounced(queue.shift()!);\n\n    expect(actual).toStrictEqual([]);\n\n    await sleep(8 * UT);\n\n    expect(actual).toStrictEqual(['a', 'b', 'c']);\n  });\n\n  it('should support cancelling delayed calls', async () => {\n    const mockFn = vi.fn<() => void>();\n    const debounced = debounce(mockFn, UT, { leading: false });\n    debounced();\n    debounced.cancel();\n    await sleep(2 * UT);\n\n    expect(mockFn).toHaveBeenCalledTimes(0);\n  });\n\n  it('should reset `lastCalled` after cancelling', async () => {\n    const mockFn = vi.fn<() => void>();\n    const debounced = debounce(mockFn, UT, { leading: true });\n    debounced();\n\n    expect(mockFn).toHaveBeenCalledTimes(1);\n\n    debounced.cancel();\n    debounced();\n\n    expect(mockFn).toHaveBeenCalledTimes(2);\n\n    debounced();\n    await sleep(2 * UT);\n\n    expect(mockFn).toHaveBeenCalledTimes(3);\n  });\n\n  it('should support flushing delayed calls', async () => {\n    const mockFn = vi.fn<() => void>();\n    const debounced = debounce(mockFn, UT, { leading: false });\n    debounced();\n    debounced.flush();\n\n    expect(mockFn).toHaveBeenCalledTimes(1);\n\n    await sleep(2 * UT);\n\n    expect(mockFn).toHaveBeenCalledTimes(1);\n  });\n\n  it('should noop `cancel` and `flush` when nothing is queued', async () => {\n    const mockFn = vi.fn<() => void>();\n    const debounced = debounce(mockFn, UT);\n    debounced.cancel();\n    debounced.flush();\n\n    expect(mockFn).toHaveBeenCalledTimes(0);\n\n    await sleep(2 * UT);\n\n    expect(mockFn).toHaveBeenCalledTimes(0);\n  });\n});\n\n/**\n * Funnel relies on letting the timeouts run. To ensure that happens the tests\n * need to yield execution.\n */\nasync function yieldExecution() {\n  return await sleep(0);\n}\n"],"mappings":"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"}

package/dist/funnel.lodash-throttle-with-cached-value.test.cjs

@@ -1 +1 @@
-const e=require(`./dist-gvJoKj_M.cjs`),t=require(`./constant-BuIJ9GIn.cjs`),n=require(`./funnel-CL-QFpGk.cjs`),r=require(`./identity-BAryUWbs.cjs`),i=require(`./sleep-1rGV3wAg.cjs`);function a(e,t=0,{leading:r=!0,trailing:i=!0}={}){let a,{call:o,flush:s,cancel:c}=n.funnel(t=>{!r&&!i||(a=e(...t))},{reducer:(e,...t)=>t,minQuietPeriodMs:t,maxBurstDurationMs:t,...i?r?{triggerAt:`both`}:{triggerAt:`end`}:{triggerAt:`start`}});return Object.assign((...e)=>(o(...e),a),{flush:()=>(s(),a),cancel:c})}const o=16;e.describe(`https://github.com/lodash/lodash/blob/4.17.21/test/test.js#L22768`,()=>{e.it(`subsequent calls should return the result of the first call`,async()=>{let t=a(r.identity(),16);e.globalExpect(t(`a`)).toBe(`a`),e.globalExpect(t(`b`)).toBe(`a`),await i.sleep(32);let n=t(`c`),o=t(`d`);e.globalExpect(n).not.toBe(`a`),e.globalExpect(n).toBeDefined(),e.globalExpect(o).not.toBe(`d`),e.globalExpect(o).toBeDefined()}),e.it("should support a `leading` option",()=>{let t=a(r.identity(),16,{leading:!0}),n=a(r.identity(),16,{leading:!1});e.globalExpect(t(`a`)).toBe(`a`),e.globalExpect(n(`a`)).toBeUndefined()}),e.it("should support a `trailing` option",async()=>{let t=e.vi.fn(r.identity()),n=e.vi.fn(r.identity()),o=a(t,32,{trailing:!0}),s=a(n,32,{trailing:!1});e.globalExpect(o(`a`)).toBe(`a`),e.globalExpect(o(`b`)).toBe(`a`),e.globalExpect(s(`a`)).toBe(`a`),e.globalExpect(s(`b`)).toBe(`a`),await i.sleep(128),e.globalExpect(t).toHaveBeenCalledTimes(2),e.globalExpect(n).toHaveBeenCalledTimes(1)})}),e.describe(`https://github.com/lodash/lodash/blob/4.17.21/test/test.js#L23038`,()=>{e.it("should reset `lastCalled` after cancelling",async()=>{let t=0,n=a(()=>(t+=1,t),16,{leading:!0});e.globalExpect(n()).toBe(1),n.cancel(),e.globalExpect(n()).toBe(2),n(),await i.sleep(32),e.globalExpect(t).toBe(3)}),e.it(`should support flushing delayed calls`,async()=>{let t=0,n=a(()=>(t+=1,t),16,{leading:!1});n(),e.globalExpect(n.flush()).toBe(1),await i.sleep(32),e.globalExpect(t).toBe(1)}),e.it("should noop `cancel` and `flush` when nothing is queued",async()=>{let n=e.vi.fn(t.constant(`hello`)),r=a(n,16);r.cancel(),e.globalExpect(r.flush()).toBeUndefined(),await i.sleep(32),e.globalExpect(n).toHaveBeenCalledTimes(0)})}),e.describe(`features not tested by Lodash`,()=>{e.it(`does nothing when neither leading nor trailing are enabled`,async()=>{let t=a(r.identity(),16,{leading:!1,trailing:!1});e.globalExpect(t(`hello`)).toBeUndefined(),e.globalExpect(t(`world`)).toBeUndefined(),await i.sleep(64),e.globalExpect(t(`goodbye`)).toBeUndefined()})});
+const e=require(`./dist-CiyBKPT6.cjs`),t=require(`./constant.cjs`),n=require(`./funnel.cjs`),r=require(`./identity.cjs`),i=require(`./sleep.cjs`);function a(e,t=0,{leading:r=!0,trailing:i=!0}={}){let a,{call:o,flush:s,cancel:c}=n.funnel(t=>{!r&&!i||(a=e(...t))},{reducer:(e,...t)=>t,minQuietPeriodMs:t,maxBurstDurationMs:t,...i?r?{triggerAt:`both`}:{triggerAt:`end`}:{triggerAt:`start`}});return Object.assign((...e)=>(o(...e),a),{flush:()=>(s(),a),cancel:c})}const o=16;e.i(`https://github.com/lodash/lodash/blob/4.17.21/test/test.js#L22768`,()=>{e.a(`subsequent calls should return the result of the first call`,async()=>{let t=a(r.identity(),16);e.n(t(`a`)).toBe(`a`),e.n(t(`b`)).toBe(`a`),await i.sleep(32);let n=t(`c`),o=t(`d`);e.n(n).not.toBe(`a`),e.n(n).toBeDefined(),e.n(o).not.toBe(`d`),e.n(o).toBeDefined()}),e.a("should support a `leading` option",()=>{let t=a(r.identity(),16,{leading:!0}),n=a(r.identity(),16,{leading:!1});e.n(t(`a`)).toBe(`a`),e.n(n(`a`)).toBeUndefined()}),e.a("should support a `trailing` option",async()=>{let t=e.r.fn(r.identity()),n=e.r.fn(r.identity()),o=a(t,32,{trailing:!0}),s=a(n,32,{trailing:!1});e.n(o(`a`)).toBe(`a`),e.n(o(`b`)).toBe(`a`),e.n(s(`a`)).toBe(`a`),e.n(s(`b`)).toBe(`a`),await i.sleep(128),e.n(t).toHaveBeenCalledTimes(2),e.n(n).toHaveBeenCalledTimes(1)})}),e.i(`https://github.com/lodash/lodash/blob/4.17.21/test/test.js#L23038`,()=>{e.a("should reset `lastCalled` after cancelling",async()=>{let t=0,n=a(()=>(t+=1,t),16,{leading:!0});e.n(n()).toBe(1),n.cancel(),e.n(n()).toBe(2),n(),await i.sleep(32),e.n(t).toBe(3)}),e.a(`should support flushing delayed calls`,async()=>{let t=0,n=a(()=>(t+=1,t),16,{leading:!1});n(),e.n(n.flush()).toBe(1),await i.sleep(32),e.n(t).toBe(1)}),e.a("should noop `cancel` and `flush` when nothing is queued",async()=>{let n=e.r.fn(t.constant(`hello`)),r=a(n,16);r.cancel(),e.n(r.flush()).toBeUndefined(),await i.sleep(32),e.n(n).toHaveBeenCalledTimes(0)})}),e.i(`features not tested by Lodash`,()=>{e.a(`does nothing when neither leading nor trailing are enabled`,async()=>{let t=a(r.identity(),16,{leading:!1,trailing:!1});e.n(t(`hello`)).toBeUndefined(),e.n(t(`world`)).toBeUndefined(),await i.sleep(64),e.n(t(`goodbye`)).toBeUndefined()})});

package/dist/funnel.lodash-throttle-with-cached-value.test.js

@@ -1,2 +1,2 @@
-import{describe as e,globalExpect as t,it as n,vi as r}from"./dist-BQGZfjDS.js";import{constant as i}from"./constant-DrpDXHc7.js";import{funnel as a}from"./funnel-CEbURcmp.js";import{identity as o}from"./identity-D7NWGnLw.js";import{sleep as s}from"./sleep-DvzRMgY-.js";function c(e,t=0,{leading:n=!0,trailing:r=!0}={}){let i,{call:o,flush:s,cancel:c}=a(t=>{!n&&!r||(i=e(...t))},{reducer:(e,...t)=>t,minQuietPeriodMs:t,maxBurstDurationMs:t,...r?n?{triggerAt:`both`}:{triggerAt:`end`}:{triggerAt:`start`}});return Object.assign((...e)=>(o(...e),i),{flush:()=>(s(),i),cancel:c})}e(`https://github.com/lodash/lodash/blob/4.17.21/test/test.js#L22768`,()=>{n(`subsequent calls should return the result of the first call`,async()=>{let e=c(o(),16);t(e(`a`)).toBe(`a`),t(e(`b`)).toBe(`a`),await s(32);let n=e(`c`),r=e(`d`);t(n).not.toBe(`a`),t(n).toBeDefined(),t(r).not.toBe(`d`),t(r).toBeDefined()}),n("should support a `leading` option",()=>{let e=c(o(),16,{leading:!0}),n=c(o(),16,{leading:!1});t(e(`a`)).toBe(`a`),t(n(`a`)).toBeUndefined()}),n("should support a `trailing` option",async()=>{let e=r.fn(o()),n=r.fn(o()),i=c(e,32,{trailing:!0}),a=c(n,32,{trailing:!1});t(i(`a`)).toBe(`a`),t(i(`b`)).toBe(`a`),t(a(`a`)).toBe(`a`),t(a(`b`)).toBe(`a`),await s(128),t(e).toHaveBeenCalledTimes(2),t(n).toHaveBeenCalledTimes(1)})}),e(`https://github.com/lodash/lodash/blob/4.17.21/test/test.js#L23038`,()=>{n("should reset `lastCalled` after cancelling",async()=>{let e=0,n=c(()=>(e+=1,e),16,{leading:!0});t(n()).toBe(1),n.cancel(),t(n()).toBe(2),n(),await s(32),t(e).toBe(3)}),n(`should support flushing delayed calls`,async()=>{let e=0,n=c(()=>(e+=1,e),16,{leading:!1});n(),t(n.flush()).toBe(1),await s(32),t(e).toBe(1)}),n("should noop `cancel` and `flush` when nothing is queued",async()=>{let e=r.fn(i(`hello`)),n=c(e,16);n.cancel(),t(n.flush()).toBeUndefined(),await s(32),t(e).toHaveBeenCalledTimes(0)})}),e(`features not tested by Lodash`,()=>{n(`does nothing when neither leading nor trailing are enabled`,async()=>{let e=c(o(),16,{leading:!1,trailing:!1});t(e(`hello`)).toBeUndefined(),t(e(`world`)).toBeUndefined(),await s(64),t(e(`goodbye`)).toBeUndefined()})});
+import{a as e,i as t,n,r}from"./dist-CUT1dnRU.js";import{constant as i}from"./constant.js";import{funnel as a}from"./funnel.js";import{identity as o}from"./identity.js";import{sleep as s}from"./sleep.js";function c(e,t=0,{leading:n=!0,trailing:r=!0}={}){let i,{call:o,flush:s,cancel:c}=a(t=>{!n&&!r||(i=e(...t))},{reducer:(e,...t)=>t,minQuietPeriodMs:t,maxBurstDurationMs:t,...r?n?{triggerAt:`both`}:{triggerAt:`end`}:{triggerAt:`start`}});return Object.assign((...e)=>(o(...e),i),{flush:()=>(s(),i),cancel:c})}t(`https://github.com/lodash/lodash/blob/4.17.21/test/test.js#L22768`,()=>{e(`subsequent calls should return the result of the first call`,async()=>{let e=c(o(),16);n(e(`a`)).toBe(`a`),n(e(`b`)).toBe(`a`),await s(32);let t=e(`c`),r=e(`d`);n(t).not.toBe(`a`),n(t).toBeDefined(),n(r).not.toBe(`d`),n(r).toBeDefined()}),e("should support a `leading` option",()=>{let e=c(o(),16,{leading:!0}),t=c(o(),16,{leading:!1});n(e(`a`)).toBe(`a`),n(t(`a`)).toBeUndefined()}),e("should support a `trailing` option",async()=>{let e=r.fn(o()),t=r.fn(o()),i=c(e,32,{trailing:!0}),a=c(t,32,{trailing:!1});n(i(`a`)).toBe(`a`),n(i(`b`)).toBe(`a`),n(a(`a`)).toBe(`a`),n(a(`b`)).toBe(`a`),await s(128),n(e).toHaveBeenCalledTimes(2),n(t).toHaveBeenCalledTimes(1)})}),t(`https://github.com/lodash/lodash/blob/4.17.21/test/test.js#L23038`,()=>{e("should reset `lastCalled` after cancelling",async()=>{let e=0,t=c(()=>(e+=1,e),16,{leading:!0});n(t()).toBe(1),t.cancel(),n(t()).toBe(2),t(),await s(32),n(e).toBe(3)}),e(`should support flushing delayed calls`,async()=>{let e=0,t=c(()=>(e+=1,e),16,{leading:!1});t(),n(t.flush()).toBe(1),await s(32),n(e).toBe(1)}),e("should noop `cancel` and `flush` when nothing is queued",async()=>{let e=r.fn(i(`hello`)),t=c(e,16);t.cancel(),n(t.flush()).toBeUndefined(),await s(32),n(e).toHaveBeenCalledTimes(0)})}),t(`features not tested by Lodash`,()=>{e(`does nothing when neither leading nor trailing are enabled`,async()=>{let e=c(o(),16,{leading:!1,trailing:!1});n(e(`hello`)).toBeUndefined(),n(e(`world`)).toBeUndefined(),await s(64),n(e(`goodbye`)).toBeUndefined()})});
 //# sourceMappingURL=funnel.lodash-throttle-with-cached-value.test.js.map

package/dist/funnel.lodash-throttle-with-cached-value.test.js.map

@@ -1 +1 @@
-{"version":3,"file":"funnel.lodash-throttle-with-cached-value.test.js","names":["cachedValue: ReturnType<F> | undefined"],"sources":["../src/funnel.lodash-throttle-with-cached-value.test.ts"],"sourcesContent":["/* eslint-disable no-nested-ternary, function-paren-newline, ts/explicit-function-return-type, ts/no-explicit-any --\n * These aren't useful for a reference implementation for a legacy library!\n */\n\nimport { describe, expect, it, vi } from 'vitest';\nimport { constant } from './constant';\nimport { funnel } from './funnel';\nimport { identity } from './identity';\nimport { sleep } from './sleep';\n\n/**\n * A reference implementation of the Lodash `throttle` function using the\n * Our `funnel` function. While migrating from Lodash you can copy this\n * function as-is into your codebase and use it as a drop-in replacement; but\n * we recommend eventually inlining the call to `funnel` so you can adjust the\n * function to your specific needs.\n *\n * This is a more complex implementation which respects Lodash capability to\n * track the return value of the callback function. In most cases you are more\n * likely to prefer the simpler reference implementation `throttle` which can\n * be found in the other test file.\n *\n * The following tests in this file are based on the Lodash tests for throttle.\n * They have been adapted to work with our testing framework, have been fixed\n * or expanded slightly were it felt necessary, and have been modernized for\n * better readability. The names of the test cases have been preserved to ease\n * comparing them to the original tests. Tests that are unrelated to the cache\n * capability have been removed to avoid duplication with the other test file.\n *\n * Note that this means that whenever Lodash offered a concrete spec, we made\n * sure our reference implementation respects it, but there might be untested\n * use-cases that would have differing runtime behaviors.\n *\n * @see Lodash Documentation: https://lodash.com/docs/4.17.15#throttle\n * @see Lodash Implementation: https://github.com/lodash/lodash/blob/4.17.21/lodash.js#L10965\n * @see Lodash Tests: https://github.com/lodash/lodash/blob/4.17.21/test/test.js#L22768\n * @see Lodash Typing: https://github.com/DefinitelyTyped/DefinitelyTyped/blob/master/types/lodash/common/function.d.ts#L1347\n */\nfunction throttleWithCachedValue<F extends (...args: any) => any>(\n  func: F,\n  wait = 0,\n  {\n    leading = true,\n    trailing = true,\n  }: { readonly leading?: boolean; readonly trailing?: boolean } = {},\n) {\n  let cachedValue: ReturnType<F> | undefined;\n\n  const { call, flush, cancel } = funnel(\n    (args: Parameters<F>) => {\n      if (!leading && !trailing) {\n        /**\n         * In Lodash you can disable both the trailing and leading edges of the\n         * throttle window, effectively causing the function to never be\n         * invoked. Our's uses the invokedAt enum exactly to prevent such a\n         * situation; so to simulate Lodash we need to only pass the callback\n         * when at least one of them is enabled.\n         */\n        return;\n      }\n\n      /**\n       * Funnel provides more control over the args, but lodash simply passes\n       * them through, to replicate this behavior we need to spread the args\n       * array maintained via the reducer below.\n       * Also, every time the function is invoked the cached value is updated.\n       */\n      cachedValue = func(...args) as ReturnType<F>;\n    },\n    {\n      // Throttle stores the latest args it was called with for the next invocation of the callback.\n      reducer: (_, ...args: Parameters<F>) => args,\n      minQuietPeriodMs: wait,\n      maxBurstDurationMs: wait,\n      ...(trailing\n        ? leading\n          ? { triggerAt: 'both' }\n          : { triggerAt: 'end' }\n        : { triggerAt: 'start' }),\n    },\n  );\n\n  /**\n   * Lodash uses a legacy JS-isms to attach helper functions to the main\n   * callback of `throttle`. In our's we return a proper object where the\n   * callback is one of the available properties. Here we destructure and then\n   * reconstruct the object to fit the Lodash API.\n   */\n  return Object.assign(\n    (...args: Parameters<F>) => {\n      call(...args);\n      return cachedValue;\n    },\n    {\n      flush: () => {\n        flush();\n        return cachedValue;\n      },\n\n      cancel,\n    },\n  );\n}\n\n/**\n * We need some non-trivial duration to use in all our tests, to abstract the\n * actual chosen value we use this UnitOfTime (UT) constant. As long as it is a\n * positive integer, the actual value doesn't matter (but the larger it is,\n * the longer the tests would take to run); the value used by Lodash is 32.\n * The number is in milliseconds.\n */\nconst UT = 16;\n\ndescribe('https://github.com/lodash/lodash/blob/4.17.21/test/test.js#L22768', () => {\n  it('subsequent calls should return the result of the first call', async () => {\n    const throttled = throttleWithCachedValue(identity(), UT);\n\n    expect(throttled('a')).toBe('a');\n    expect(throttled('b')).toBe('a');\n\n    await sleep(2 * UT);\n    const resultC = throttled('c');\n    const resultD = throttled('d');\n\n    expect(resultC).not.toBe('a');\n    expect(resultC).toBeDefined();\n    expect(resultD).not.toBe('d');\n    expect(resultD).toBeDefined();\n  });\n\n  it('should support a `leading` option', () => {\n    const withLeading = throttleWithCachedValue(identity(), UT, {\n      leading: true,\n    });\n    const withoutLeading = throttleWithCachedValue(identity(), UT, {\n      leading: false,\n    });\n\n    expect(withLeading('a')).toBe('a');\n    expect(withoutLeading('a')).toBeUndefined();\n  });\n\n  it('should support a `trailing` option', async () => {\n    const mockWith = vi.fn<<T>(x: T) => T>(identity());\n    const mockWithout = vi.fn<<T>(x: T) => T>(identity());\n    const withTrailing = throttleWithCachedValue(mockWith, 2 * UT, {\n      trailing: true,\n    });\n    const withoutTrailing = throttleWithCachedValue(mockWithout, 2 * UT, {\n      trailing: false,\n    });\n\n    expect(withTrailing('a')).toBe('a');\n    expect(withTrailing('b')).toBe('a');\n    expect(withoutTrailing('a')).toBe('a');\n    expect(withoutTrailing('b')).toBe('a');\n\n    await sleep(8 * UT);\n\n    expect(mockWith).toHaveBeenCalledTimes(2);\n    expect(mockWithout).toHaveBeenCalledTimes(1);\n  });\n});\n\ndescribe('https://github.com/lodash/lodash/blob/4.17.21/test/test.js#L23038', () => {\n  it('should reset `lastCalled` after cancelling', async () => {\n    let callCount = 0;\n    const throttled = throttleWithCachedValue(\n      () => {\n        callCount += 1;\n        return callCount;\n      },\n      UT,\n      { leading: true },\n    );\n\n    expect(throttled()).toBe(1);\n\n    throttled.cancel();\n\n    expect(throttled()).toBe(2);\n\n    throttled();\n    await sleep(2 * UT);\n\n    expect(callCount).toBe(3);\n  });\n\n  it('should support flushing delayed calls', async () => {\n    let callCount = 0;\n    const throttled = throttleWithCachedValue(\n      () => {\n        callCount += 1;\n        return callCount;\n      },\n      UT,\n      { leading: false },\n    );\n    throttled();\n\n    expect(throttled.flush()).toBe(1);\n\n    await sleep(2 * UT);\n\n    expect(callCount).toBe(1);\n  });\n\n  it('should noop `cancel` and `flush` when nothing is queued', async () => {\n    const mockFn = vi.fn<() => string>(constant('hello'));\n    const throttled = throttleWithCachedValue(mockFn, UT);\n    throttled.cancel();\n\n    expect(throttled.flush()).toBeUndefined();\n\n    await sleep(2 * UT);\n\n    expect(mockFn).toHaveBeenCalledTimes(0);\n  });\n});\n\ndescribe('features not tested by Lodash', () => {\n  it('does nothing when neither leading nor trailing are enabled', async () => {\n    const throttled = throttleWithCachedValue(identity(), UT, {\n      leading: false,\n      trailing: false,\n    });\n\n    expect(throttled('hello')).toBeUndefined();\n    expect(throttled('world')).toBeUndefined();\n\n    await sleep(4 * UT);\n\n    expect(throttled('goodbye')).toBeUndefined();\n  });\n});\n"],"mappings":"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"}
+{"version":3,"file":"funnel.lodash-throttle-with-cached-value.test.js","names":["cachedValue: ReturnType<F> | undefined"],"sources":["../src/funnel.lodash-throttle-with-cached-value.test.ts"],"sourcesContent":["/* eslint-disable no-nested-ternary, function-paren-newline, ts/explicit-function-return-type, ts/no-explicit-any --\n * These aren't useful for a reference implementation for a legacy library!\n */\n\nimport { describe, expect, it, vi } from 'vitest';\nimport { constant } from './constant';\nimport { funnel } from './funnel';\nimport { identity } from './identity';\nimport { sleep } from './sleep';\n\n/**\n * A reference implementation of the Lodash `throttle` function using the\n * Our `funnel` function. While migrating from Lodash you can copy this\n * function as-is into your codebase and use it as a drop-in replacement; but\n * we recommend eventually inlining the call to `funnel` so you can adjust the\n * function to your specific needs.\n *\n * This is a more complex implementation which respects Lodash capability to\n * track the return value of the callback function. In most cases you are more\n * likely to prefer the simpler reference implementation `throttle` which can\n * be found in the other test file.\n *\n * The following tests in this file are based on the Lodash tests for throttle.\n * They have been adapted to work with our testing framework, have been fixed\n * or expanded slightly were it felt necessary, and have been modernized for\n * better readability. The names of the test cases have been preserved to ease\n * comparing them to the original tests. Tests that are unrelated to the cache\n * capability have been removed to avoid duplication with the other test file.\n *\n * Note that this means that whenever Lodash offered a concrete spec, we made\n * sure our reference implementation respects it, but there might be untested\n * use-cases that would have differing runtime behaviors.\n *\n * @see Lodash Documentation: https://lodash.com/docs/4.17.15#throttle\n * @see Lodash Implementation: https://github.com/lodash/lodash/blob/4.17.21/lodash.js#L10965\n * @see Lodash Tests: https://github.com/lodash/lodash/blob/4.17.21/test/test.js#L22768\n * @see Lodash Typing: https://github.com/DefinitelyTyped/DefinitelyTyped/blob/master/types/lodash/common/function.d.ts#L1347\n */\nfunction throttleWithCachedValue<F extends (...args: any) => any>(\n  func: F,\n  wait = 0,\n  {\n    leading = true,\n    trailing = true,\n  }: { readonly leading?: boolean; readonly trailing?: boolean } = {},\n) {\n  let cachedValue: ReturnType<F> | undefined;\n\n  const { call, flush, cancel } = funnel(\n    (args: Parameters<F>) => {\n      if (!leading && !trailing) {\n        /**\n         * In Lodash you can disable both the trailing and leading edges of the\n         * throttle window, effectively causing the function to never be\n         * invoked. Our's uses the invokedAt enum exactly to prevent such a\n         * situation; so to simulate Lodash we need to only pass the callback\n         * when at least one of them is enabled.\n         */\n        return;\n      }\n\n      /**\n       * Funnel provides more control over the args, but lodash simply passes\n       * them through, to replicate this behavior we need to spread the args\n       * array maintained via the reducer below.\n       * Also, every time the function is invoked the cached value is updated.\n       */\n      cachedValue = func(...args) as ReturnType<F>;\n    },\n    {\n      // Throttle stores the latest args it was called with for the next invocation of the callback.\n      reducer: (_, ...args: Parameters<F>) => args,\n      minQuietPeriodMs: wait,\n      maxBurstDurationMs: wait,\n      ...(trailing\n        ? leading\n          ? { triggerAt: 'both' }\n          : { triggerAt: 'end' }\n        : { triggerAt: 'start' }),\n    },\n  );\n\n  /**\n   * Lodash uses a legacy JS-isms to attach helper functions to the main\n   * callback of `throttle`. In our's we return a proper object where the\n   * callback is one of the available properties. Here we destructure and then\n   * reconstruct the object to fit the Lodash API.\n   */\n  return Object.assign(\n    (...args: Parameters<F>) => {\n      call(...args);\n      return cachedValue;\n    },\n    {\n      flush: () => {\n        flush();\n        return cachedValue;\n      },\n\n      cancel,\n    },\n  );\n}\n\n/**\n * We need some non-trivial duration to use in all our tests, to abstract the\n * actual chosen value we use this UnitOfTime (UT) constant. As long as it is a\n * positive integer, the actual value doesn't matter (but the larger it is,\n * the longer the tests would take to run); the value used by Lodash is 32.\n * The number is in milliseconds.\n */\nconst UT = 16;\n\ndescribe('https://github.com/lodash/lodash/blob/4.17.21/test/test.js#L22768', () => {\n  it('subsequent calls should return the result of the first call', async () => {\n    const throttled = throttleWithCachedValue(identity(), UT);\n\n    expect(throttled('a')).toBe('a');\n    expect(throttled('b')).toBe('a');\n\n    await sleep(2 * UT);\n    const resultC = throttled('c');\n    const resultD = throttled('d');\n\n    expect(resultC).not.toBe('a');\n    expect(resultC).toBeDefined();\n    expect(resultD).not.toBe('d');\n    expect(resultD).toBeDefined();\n  });\n\n  it('should support a `leading` option', () => {\n    const withLeading = throttleWithCachedValue(identity(), UT, {\n      leading: true,\n    });\n    const withoutLeading = throttleWithCachedValue(identity(), UT, {\n      leading: false,\n    });\n\n    expect(withLeading('a')).toBe('a');\n    expect(withoutLeading('a')).toBeUndefined();\n  });\n\n  it('should support a `trailing` option', async () => {\n    const mockWith = vi.fn<<T>(x: T) => T>(identity());\n    const mockWithout = vi.fn<<T>(x: T) => T>(identity());\n    const withTrailing = throttleWithCachedValue(mockWith, 2 * UT, {\n      trailing: true,\n    });\n    const withoutTrailing = throttleWithCachedValue(mockWithout, 2 * UT, {\n      trailing: false,\n    });\n\n    expect(withTrailing('a')).toBe('a');\n    expect(withTrailing('b')).toBe('a');\n    expect(withoutTrailing('a')).toBe('a');\n    expect(withoutTrailing('b')).toBe('a');\n\n    await sleep(8 * UT);\n\n    expect(mockWith).toHaveBeenCalledTimes(2);\n    expect(mockWithout).toHaveBeenCalledTimes(1);\n  });\n});\n\ndescribe('https://github.com/lodash/lodash/blob/4.17.21/test/test.js#L23038', () => {\n  it('should reset `lastCalled` after cancelling', async () => {\n    let callCount = 0;\n    const throttled = throttleWithCachedValue(\n      () => {\n        callCount += 1;\n        return callCount;\n      },\n      UT,\n      { leading: true },\n    );\n\n    expect(throttled()).toBe(1);\n\n    throttled.cancel();\n\n    expect(throttled()).toBe(2);\n\n    throttled();\n    await sleep(2 * UT);\n\n    expect(callCount).toBe(3);\n  });\n\n  it('should support flushing delayed calls', async () => {\n    let callCount = 0;\n    const throttled = throttleWithCachedValue(\n      () => {\n        callCount += 1;\n        return callCount;\n      },\n      UT,\n      { leading: false },\n    );\n    throttled();\n\n    expect(throttled.flush()).toBe(1);\n\n    await sleep(2 * UT);\n\n    expect(callCount).toBe(1);\n  });\n\n  it('should noop `cancel` and `flush` when nothing is queued', async () => {\n    const mockFn = vi.fn<() => string>(constant('hello'));\n    const throttled = throttleWithCachedValue(mockFn, UT);\n    throttled.cancel();\n\n    expect(throttled.flush()).toBeUndefined();\n\n    await sleep(2 * UT);\n\n    expect(mockFn).toHaveBeenCalledTimes(0);\n  });\n});\n\ndescribe('features not tested by Lodash', () => {\n  it('does nothing when neither leading nor trailing are enabled', async () => {\n    const throttled = throttleWithCachedValue(identity(), UT, {\n      leading: false,\n      trailing: false,\n    });\n\n    expect(throttled('hello')).toBeUndefined();\n    expect(throttled('world')).toBeUndefined();\n\n    await sleep(4 * UT);\n\n    expect(throttled('goodbye')).toBeUndefined();\n  });\n});\n"],"mappings":"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"}

package/dist/funnel.lodash-throttle.test.cjs

@@ -1 +1 @@
-const e=require(`./dist-gvJoKj_M.cjs`),t=require(`./funnel-CL-QFpGk.cjs`),n=require(`./sleep-1rGV3wAg.cjs`);function r(e,n=0,{leading:r=!0,trailing:i=!0}={}){let{call:a,isIdle:o,...s}=t.funnel(t=>{!r&&!i||e(...t)},{reducer:(e,...t)=>t,minQuietPeriodMs:n,maxBurstDurationMs:n,...i?r?{triggerAt:`both`}:{triggerAt:`end`}:{triggerAt:`start`}});return Object.assign(a,s)}const i=16;e.describe(`https://github.com/lodash/lodash/blob/4.17.21/test/test.js#L22768`,()=>{e.it(`should throttle a function`,async()=>{let t=e.vi.fn(),i=r(t,16);i(),i(),i();let a=t.mock.calls.length;e.globalExpect(a).toBeGreaterThan(0),await n.sleep(32),e.globalExpect(t.mock.calls.length).toBeGreaterThan(a)}),e.it("should clear timeout when `func` is called",async()=>{let t=e.vi.fn(),i=r(t,16);i(),e.globalExpect(t).toHaveBeenCalledTimes(1),await n.sleep(32),i(),e.globalExpect(t).toHaveBeenCalledTimes(2)}),e.it(`should not trigger a trailing call when invoked once`,async()=>{let t=e.vi.fn();r(t,16)(),e.globalExpect(t).toHaveBeenCalledTimes(1),await n.sleep(32),e.globalExpect(t).toHaveBeenCalledTimes(1)}),e.it(`should trigger a call when invoked repeatedly`,()=>{let t=e.vi.fn(),n=r(t,16),i=Date.now()+160;for(;Date.now()<i;)n();e.globalExpect(t).toHaveBeenCalledExactlyOnceWith()}),e.it("should trigger a call when invoked repeatedly and `leading` is `false`",async()=>{let t=e.vi.fn(),i=r(t,16,{leading:!1}),a=Date.now()+160;for(;Date.now()<a;)i();await n.sleep(0),e.globalExpect(t).toHaveBeenCalledExactlyOnceWith()}),e.it(`should trigger a second throttled call as soon as possible`,async()=>{let t=e.vi.fn(),i=r(t,64,{leading:!1});i(),await n.sleep(96),e.globalExpect(t).toHaveBeenCalledTimes(1),i(),await n.sleep(32),e.globalExpect(t).toHaveBeenCalledTimes(1),await n.sleep(64),e.globalExpect(t).toHaveBeenCalledTimes(2)}),e.it(`should apply default options`,async()=>{let t=e.vi.fn(),i=r(t,16,{});i(),i(),e.globalExpect(t).toHaveBeenCalledTimes(1),await n.sleep(64),e.globalExpect(t).toHaveBeenCalledTimes(2)}),e.it("should support a `leading` option",()=>{let t=e.vi.fn(),n=e.vi.fn(),i=r(t,16,{leading:!0}),a=r(n,16,{leading:!1});i(),a(),e.globalExpect(t).toHaveBeenCalledTimes(1),e.globalExpect(n).toHaveBeenCalledTimes(0)}),e.it("should support a `trailing` option",async()=>{let t=e.vi.fn(),i=e.vi.fn(),a=r(t,32,{trailing:!0}),o=r(i,32,{trailing:!1});a(`a`),a(`b`),o(`a`),o(`b`),e.globalExpect(t).toHaveBeenCalledExactlyOnceWith(`a`),e.globalExpect(i).toHaveBeenCalledExactlyOnceWith(`a`),await n.sleep(128),e.globalExpect(t).toHaveBeenCalledTimes(2),e.globalExpect(i).toHaveBeenCalledTimes(1)}),e.it("should not update `lastCalled`, at the end of the timeout, when `trailing` is `false`",async()=>{let t=e.vi.fn(),i=r(t,64,{trailing:!1});i(),i(),await n.sleep(48),i(),i(),await n.sleep(48),e.globalExpect(t).toHaveBeenCalledExactlyOnceWith()})}),e.describe(`https://github.com/lodash/lodash/blob/4.17.21/test/test.js#L23038`,()=>{e.it("should use a default `wait` of `0`",async()=>{let t=e.vi.fn(),i=r(t);i(),await n.sleep(16),i(),e.globalExpect(t).toHaveBeenCalledTimes(2)}),e.it(`supports recursive calls`,async()=>{let t=[],i=[`a`,`b`,`c`],a=r(e=>{t.push(e);let n=i.shift();n!==void 0&&a(n)},16);a(i.shift()),e.globalExpect(t).toStrictEqual([`a`]),await n.sleep(128),e.globalExpect(t).toStrictEqual([`a`,`b`,`c`])}),e.it(`should support cancelling delayed calls`,async()=>{let t=e.vi.fn(),i=r(t,16,{leading:!1});i(),i.cancel(),await n.sleep(32),e.globalExpect(t).toHaveBeenCalledTimes(0)}),e.it("should reset `lastCalled` after cancelling",async()=>{let t=e.vi.fn(),i=r(t,16,{leading:!0});i(),e.globalExpect(t).toHaveBeenCalledTimes(1),i.cancel(),i(),e.globalExpect(t).toHaveBeenCalledTimes(2),i(),await n.sleep(32),e.globalExpect(t).toHaveBeenCalledTimes(3)}),e.it(`should support flushing delayed calls`,async()=>{let t=e.vi.fn(),i=r(t,16,{leading:!1});i(),i.flush(),e.globalExpect(t).toHaveBeenCalledTimes(1),await n.sleep(32),e.globalExpect(t).toHaveBeenCalledTimes(1)}),e.it("should noop `cancel` and `flush` when nothing is queued",async()=>{let t=e.vi.fn(),i=r(t,16);i.cancel(),i.flush(),e.globalExpect(t).toHaveBeenCalledTimes(0),await n.sleep(32),e.globalExpect(t).toHaveBeenCalledTimes(0)})}),e.describe(`not tested by Lodash`,()=>{e.it("should do nothing when `leading` and `trailing` are both `disabled`",async()=>{let t=e.vi.fn(),i=r(t,16,{leading:!1,trailing:!1});i(),i(),i(),e.globalExpect(t).toHaveBeenCalledTimes(0),await n.sleep(32),e.globalExpect(t).toHaveBeenCalledTimes(0)})});
+const e=require(`./dist-CiyBKPT6.cjs`),t=require(`./funnel.cjs`),n=require(`./sleep.cjs`);function r(e,n=0,{leading:r=!0,trailing:i=!0}={}){let{call:a,isIdle:o,...s}=t.funnel(t=>{!r&&!i||e(...t)},{reducer:(e,...t)=>t,minQuietPeriodMs:n,maxBurstDurationMs:n,...i?r?{triggerAt:`both`}:{triggerAt:`end`}:{triggerAt:`start`}});return Object.assign(a,s)}const i=16;e.i(`https://github.com/lodash/lodash/blob/4.17.21/test/test.js#L22768`,()=>{e.a(`should throttle a function`,async()=>{let t=e.r.fn(),i=r(t,16);i(),i(),i();let a=t.mock.calls.length;e.n(a).toBeGreaterThan(0),await n.sleep(32),e.n(t.mock.calls.length).toBeGreaterThan(a)}),e.a("should clear timeout when `func` is called",async()=>{let t=e.r.fn(),i=r(t,16);i(),e.n(t).toHaveBeenCalledTimes(1),await n.sleep(32),i(),e.n(t).toHaveBeenCalledTimes(2)}),e.a(`should not trigger a trailing call when invoked once`,async()=>{let t=e.r.fn();r(t,16)(),e.n(t).toHaveBeenCalledTimes(1),await n.sleep(32),e.n(t).toHaveBeenCalledTimes(1)}),e.a(`should trigger a call when invoked repeatedly`,()=>{let t=e.r.fn(),n=r(t,16),i=Date.now()+160;for(;Date.now()<i;)n();e.n(t).toHaveBeenCalledExactlyOnceWith()}),e.a("should trigger a call when invoked repeatedly and `leading` is `false`",async()=>{let t=e.r.fn(),i=r(t,16,{leading:!1}),a=Date.now()+160;for(;Date.now()<a;)i();await n.sleep(0),e.n(t).toHaveBeenCalledExactlyOnceWith()}),e.a(`should trigger a second throttled call as soon as possible`,async()=>{let t=e.r.fn(),i=r(t,64,{leading:!1});i(),await n.sleep(96),e.n(t).toHaveBeenCalledTimes(1),i(),await n.sleep(32),e.n(t).toHaveBeenCalledTimes(1),await n.sleep(64),e.n(t).toHaveBeenCalledTimes(2)}),e.a(`should apply default options`,async()=>{let t=e.r.fn(),i=r(t,16,{});i(),i(),e.n(t).toHaveBeenCalledTimes(1),await n.sleep(64),e.n(t).toHaveBeenCalledTimes(2)}),e.a("should support a `leading` option",()=>{let t=e.r.fn(),n=e.r.fn(),i=r(t,16,{leading:!0}),a=r(n,16,{leading:!1});i(),a(),e.n(t).toHaveBeenCalledTimes(1),e.n(n).toHaveBeenCalledTimes(0)}),e.a("should support a `trailing` option",async()=>{let t=e.r.fn(),i=e.r.fn(),a=r(t,32,{trailing:!0}),o=r(i,32,{trailing:!1});a(`a`),a(`b`),o(`a`),o(`b`),e.n(t).toHaveBeenCalledExactlyOnceWith(`a`),e.n(i).toHaveBeenCalledExactlyOnceWith(`a`),await n.sleep(128),e.n(t).toHaveBeenCalledTimes(2),e.n(i).toHaveBeenCalledTimes(1)}),e.a("should not update `lastCalled`, at the end of the timeout, when `trailing` is `false`",async()=>{let t=e.r.fn(),i=r(t,64,{trailing:!1});i(),i(),await n.sleep(48),i(),i(),await n.sleep(48),e.n(t).toHaveBeenCalledExactlyOnceWith()})}),e.i(`https://github.com/lodash/lodash/blob/4.17.21/test/test.js#L23038`,()=>{e.a("should use a default `wait` of `0`",async()=>{let t=e.r.fn(),i=r(t);i(),await n.sleep(16),i(),e.n(t).toHaveBeenCalledTimes(2)}),e.a(`supports recursive calls`,async()=>{let t=[],i=[`a`,`b`,`c`],a=r(e=>{t.push(e);let n=i.shift();n!==void 0&&a(n)},16);a(i.shift()),e.n(t).toStrictEqual([`a`]),await n.sleep(128),e.n(t).toStrictEqual([`a`,`b`,`c`])}),e.a(`should support cancelling delayed calls`,async()=>{let t=e.r.fn(),i=r(t,16,{leading:!1});i(),i.cancel(),await n.sleep(32),e.n(t).toHaveBeenCalledTimes(0)}),e.a("should reset `lastCalled` after cancelling",async()=>{let t=e.r.fn(),i=r(t,16,{leading:!0});i(),e.n(t).toHaveBeenCalledTimes(1),i.cancel(),i(),e.n(t).toHaveBeenCalledTimes(2),i(),await n.sleep(32),e.n(t).toHaveBeenCalledTimes(3)}),e.a(`should support flushing delayed calls`,async()=>{let t=e.r.fn(),i=r(t,16,{leading:!1});i(),i.flush(),e.n(t).toHaveBeenCalledTimes(1),await n.sleep(32),e.n(t).toHaveBeenCalledTimes(1)}),e.a("should noop `cancel` and `flush` when nothing is queued",async()=>{let t=e.r.fn(),i=r(t,16);i.cancel(),i.flush(),e.n(t).toHaveBeenCalledTimes(0),await n.sleep(32),e.n(t).toHaveBeenCalledTimes(0)})}),e.i(`not tested by Lodash`,()=>{e.a("should do nothing when `leading` and `trailing` are both `disabled`",async()=>{let t=e.r.fn(),i=r(t,16,{leading:!1,trailing:!1});i(),i(),i(),e.n(t).toHaveBeenCalledTimes(0),await n.sleep(32),e.n(t).toHaveBeenCalledTimes(0)})});

package/dist/funnel.lodash-throttle.test.js

@@ -1,2 +1,2 @@
-import{describe as e,globalExpect as t,it as n,vi as r}from"./dist-BQGZfjDS.js";import{funnel as i}from"./funnel-CEbURcmp.js";import{sleep as a}from"./sleep-DvzRMgY-.js";function o(e,t=0,{leading:n=!0,trailing:r=!0}={}){let{call:a,isIdle:o,...s}=i(t=>{!n&&!r||e(...t)},{reducer:(e,...t)=>t,minQuietPeriodMs:t,maxBurstDurationMs:t,...r?n?{triggerAt:`both`}:{triggerAt:`end`}:{triggerAt:`start`}});return Object.assign(a,s)}e(`https://github.com/lodash/lodash/blob/4.17.21/test/test.js#L22768`,()=>{n(`should throttle a function`,async()=>{let e=r.fn(),n=o(e,16);n(),n(),n();let i=e.mock.calls.length;t(i).toBeGreaterThan(0),await a(32),t(e.mock.calls.length).toBeGreaterThan(i)}),n("should clear timeout when `func` is called",async()=>{let e=r.fn(),n=o(e,16);n(),t(e).toHaveBeenCalledTimes(1),await a(32),n(),t(e).toHaveBeenCalledTimes(2)}),n(`should not trigger a trailing call when invoked once`,async()=>{let e=r.fn();o(e,16)(),t(e).toHaveBeenCalledTimes(1),await a(32),t(e).toHaveBeenCalledTimes(1)}),n(`should trigger a call when invoked repeatedly`,()=>{let e=r.fn(),n=o(e,16),i=Date.now()+160;for(;Date.now()<i;)n();t(e).toHaveBeenCalledExactlyOnceWith()}),n("should trigger a call when invoked repeatedly and `leading` is `false`",async()=>{let e=r.fn(),n=o(e,16,{leading:!1}),i=Date.now()+160;for(;Date.now()<i;)n();await a(0),t(e).toHaveBeenCalledExactlyOnceWith()}),n(`should trigger a second throttled call as soon as possible`,async()=>{let e=r.fn(),n=o(e,64,{leading:!1});n(),await a(96),t(e).toHaveBeenCalledTimes(1),n(),await a(32),t(e).toHaveBeenCalledTimes(1),await a(64),t(e).toHaveBeenCalledTimes(2)}),n(`should apply default options`,async()=>{let e=r.fn(),n=o(e,16,{});n(),n(),t(e).toHaveBeenCalledTimes(1),await a(64),t(e).toHaveBeenCalledTimes(2)}),n("should support a `leading` option",()=>{let e=r.fn(),n=r.fn(),i=o(e,16,{leading:!0}),a=o(n,16,{leading:!1});i(),a(),t(e).toHaveBeenCalledTimes(1),t(n).toHaveBeenCalledTimes(0)}),n("should support a `trailing` option",async()=>{let e=r.fn(),n=r.fn(),i=o(e,32,{trailing:!0}),s=o(n,32,{trailing:!1});i(`a`),i(`b`),s(`a`),s(`b`),t(e).toHaveBeenCalledExactlyOnceWith(`a`),t(n).toHaveBeenCalledExactlyOnceWith(`a`),await a(128),t(e).toHaveBeenCalledTimes(2),t(n).toHaveBeenCalledTimes(1)}),n("should not update `lastCalled`, at the end of the timeout, when `trailing` is `false`",async()=>{let e=r.fn(),n=o(e,64,{trailing:!1});n(),n(),await a(48),n(),n(),await a(48),t(e).toHaveBeenCalledExactlyOnceWith()})}),e(`https://github.com/lodash/lodash/blob/4.17.21/test/test.js#L23038`,()=>{n("should use a default `wait` of `0`",async()=>{let e=r.fn(),n=o(e);n(),await a(16),n(),t(e).toHaveBeenCalledTimes(2)}),n(`supports recursive calls`,async()=>{let e=[],n=[`a`,`b`,`c`],r=o(t=>{e.push(t);let i=n.shift();i!==void 0&&r(i)},16);r(n.shift()),t(e).toStrictEqual([`a`]),await a(128),t(e).toStrictEqual([`a`,`b`,`c`])}),n(`should support cancelling delayed calls`,async()=>{let e=r.fn(),n=o(e,16,{leading:!1});n(),n.cancel(),await a(32),t(e).toHaveBeenCalledTimes(0)}),n("should reset `lastCalled` after cancelling",async()=>{let e=r.fn(),n=o(e,16,{leading:!0});n(),t(e).toHaveBeenCalledTimes(1),n.cancel(),n(),t(e).toHaveBeenCalledTimes(2),n(),await a(32),t(e).toHaveBeenCalledTimes(3)}),n(`should support flushing delayed calls`,async()=>{let e=r.fn(),n=o(e,16,{leading:!1});n(),n.flush(),t(e).toHaveBeenCalledTimes(1),await a(32),t(e).toHaveBeenCalledTimes(1)}),n("should noop `cancel` and `flush` when nothing is queued",async()=>{let e=r.fn(),n=o(e,16);n.cancel(),n.flush(),t(e).toHaveBeenCalledTimes(0),await a(32),t(e).toHaveBeenCalledTimes(0)})}),e(`not tested by Lodash`,()=>{n("should do nothing when `leading` and `trailing` are both `disabled`",async()=>{let e=r.fn(),n=o(e,16,{leading:!1,trailing:!1});n(),n(),n(),t(e).toHaveBeenCalledTimes(0),await a(32),t(e).toHaveBeenCalledTimes(0)})});
+import{a as e,i as t,n,r}from"./dist-CUT1dnRU.js";import{funnel as i}from"./funnel.js";import{sleep as a}from"./sleep.js";function o(e,t=0,{leading:n=!0,trailing:r=!0}={}){let{call:a,isIdle:o,...s}=i(t=>{!n&&!r||e(...t)},{reducer:(e,...t)=>t,minQuietPeriodMs:t,maxBurstDurationMs:t,...r?n?{triggerAt:`both`}:{triggerAt:`end`}:{triggerAt:`start`}});return Object.assign(a,s)}t(`https://github.com/lodash/lodash/blob/4.17.21/test/test.js#L22768`,()=>{e(`should throttle a function`,async()=>{let e=r.fn(),t=o(e,16);t(),t(),t();let i=e.mock.calls.length;n(i).toBeGreaterThan(0),await a(32),n(e.mock.calls.length).toBeGreaterThan(i)}),e("should clear timeout when `func` is called",async()=>{let e=r.fn(),t=o(e,16);t(),n(e).toHaveBeenCalledTimes(1),await a(32),t(),n(e).toHaveBeenCalledTimes(2)}),e(`should not trigger a trailing call when invoked once`,async()=>{let e=r.fn();o(e,16)(),n(e).toHaveBeenCalledTimes(1),await a(32),n(e).toHaveBeenCalledTimes(1)}),e(`should trigger a call when invoked repeatedly`,()=>{let e=r.fn(),t=o(e,16),i=Date.now()+160;for(;Date.now()<i;)t();n(e).toHaveBeenCalledExactlyOnceWith()}),e("should trigger a call when invoked repeatedly and `leading` is `false`",async()=>{let e=r.fn(),t=o(e,16,{leading:!1}),i=Date.now()+160;for(;Date.now()<i;)t();await a(0),n(e).toHaveBeenCalledExactlyOnceWith()}),e(`should trigger a second throttled call as soon as possible`,async()=>{let e=r.fn(),t=o(e,64,{leading:!1});t(),await a(96),n(e).toHaveBeenCalledTimes(1),t(),await a(32),n(e).toHaveBeenCalledTimes(1),await a(64),n(e).toHaveBeenCalledTimes(2)}),e(`should apply default options`,async()=>{let e=r.fn(),t=o(e,16,{});t(),t(),n(e).toHaveBeenCalledTimes(1),await a(64),n(e).toHaveBeenCalledTimes(2)}),e("should support a `leading` option",()=>{let e=r.fn(),t=r.fn(),i=o(e,16,{leading:!0}),a=o(t,16,{leading:!1});i(),a(),n(e).toHaveBeenCalledTimes(1),n(t).toHaveBeenCalledTimes(0)}),e("should support a `trailing` option",async()=>{let e=r.fn(),t=r.fn(),i=o(e,32,{trailing:!0}),s=o(t,32,{trailing:!1});i(`a`),i(`b`),s(`a`),s(`b`),n(e).toHaveBeenCalledExactlyOnceWith(`a`),n(t).toHaveBeenCalledExactlyOnceWith(`a`),await a(128),n(e).toHaveBeenCalledTimes(2),n(t).toHaveBeenCalledTimes(1)}),e("should not update `lastCalled`, at the end of the timeout, when `trailing` is `false`",async()=>{let e=r.fn(),t=o(e,64,{trailing:!1});t(),t(),await a(48),t(),t(),await a(48),n(e).toHaveBeenCalledExactlyOnceWith()})}),t(`https://github.com/lodash/lodash/blob/4.17.21/test/test.js#L23038`,()=>{e("should use a default `wait` of `0`",async()=>{let e=r.fn(),t=o(e);t(),await a(16),t(),n(e).toHaveBeenCalledTimes(2)}),e(`supports recursive calls`,async()=>{let e=[],t=[`a`,`b`,`c`],r=o(n=>{e.push(n);let i=t.shift();i!==void 0&&r(i)},16);r(t.shift()),n(e).toStrictEqual([`a`]),await a(128),n(e).toStrictEqual([`a`,`b`,`c`])}),e(`should support cancelling delayed calls`,async()=>{let e=r.fn(),t=o(e,16,{leading:!1});t(),t.cancel(),await a(32),n(e).toHaveBeenCalledTimes(0)}),e("should reset `lastCalled` after cancelling",async()=>{let e=r.fn(),t=o(e,16,{leading:!0});t(),n(e).toHaveBeenCalledTimes(1),t.cancel(),t(),n(e).toHaveBeenCalledTimes(2),t(),await a(32),n(e).toHaveBeenCalledTimes(3)}),e(`should support flushing delayed calls`,async()=>{let e=r.fn(),t=o(e,16,{leading:!1});t(),t.flush(),n(e).toHaveBeenCalledTimes(1),await a(32),n(e).toHaveBeenCalledTimes(1)}),e("should noop `cancel` and `flush` when nothing is queued",async()=>{let e=r.fn(),t=o(e,16);t.cancel(),t.flush(),n(e).toHaveBeenCalledTimes(0),await a(32),n(e).toHaveBeenCalledTimes(0)})}),t(`not tested by Lodash`,()=>{e("should do nothing when `leading` and `trailing` are both `disabled`",async()=>{let e=r.fn(),t=o(e,16,{leading:!1,trailing:!1});t(),t(),t(),n(e).toHaveBeenCalledTimes(0),await a(32),n(e).toHaveBeenCalledTimes(0)})});
 //# sourceMappingURL=funnel.lodash-throttle.test.js.map

package/dist/funnel.lodash-throttle.test.js.map

@@ -1 +1 @@
-{"version":3,"file":"funnel.lodash-throttle.test.js","names":[],"sources":["../src/funnel.lodash-throttle.test.ts"],"sourcesContent":["/* eslint-disable function-paren-newline, no-nested-ternary, ts/explicit-function-return-type, ts/no-explicit-any --\n * These aren't useful for a reference implementation for a legacy library!\n */\n\nimport { describe, expect, it, vi } from 'vitest';\nimport { funnel } from './funnel';\nimport { sleep } from './sleep';\n\n/**\n * A reference implementation of the Lodash `throttle` function using the\n * Our `funnel` function. While migrating from Lodash you can copy this\n * function as-is into your code base and use it as a drop-in replacement; but\n * we recommend eventually inlining the call to `funnel` so you can adjust the\n * function to your specific needs.\n *\n * This is a simplified implementation which ignores the Lodash capability to\n * track the return value of the callback function, but it is most likely the\n * more common use-case. For a more complete (and more complex) implementation\n * that also does that see the reference implementation for\n * `throttleWithCachedValue` in the other test file.\n *\n * The following tests in this file are based on the Lodash tests for throttle.\n * They have been adapted to work with our testing framework, have been fixed\n * or expanded slightly were it felt necessary, and have been modernized for\n * better readability. The names of the test cases have been preserved to ease\n * comparing them to the original tests.\n *\n * Note that this means that whenever Lodash offered a concrete spec, we made\n * sure our reference implementation respects it, but there might be untested\n * use-cases that would have differing runtime behaviors.\n *\n * @see Lodash Documentation: https://lodash.com/docs/4.17.15#throttle\n * @see Lodash Implementation: https://github.com/lodash/lodash/blob/4.17.21/lodash.js#L10965\n * @see Lodash Typing: https://github.com/DefinitelyTyped/DefinitelyTyped/blob/master/types/lodash/common/function.d.ts#L1347\n */\nfunction throttle<F extends (...args: any) => void>(\n  func: F,\n  wait = 0,\n  {\n    leading = true,\n    trailing = true,\n  }: { readonly leading?: boolean; readonly trailing?: boolean } = {},\n) {\n  const {\n    call,\n    // Lodash v4 doesn't provide access to the `isIdle` (called `pending` in Lodash v5) information.\n    isIdle: _isIdle,\n    ...rest\n  } = funnel(\n    (args: Parameters<F>) => {\n      if (!leading && !trailing) {\n        /**\n         * In Lodash you can disable both the trailing and leading edges of the\n         * throttle window, effectively causing the function to never be\n         * invoked. Our's uses the invokedAt enum exactly to prevent such a\n         * situation; so to simulate Lodash we need to only pass the callback\n         * when at least one of them is enabled.\n         */\n        return;\n      }\n\n      /**\n       * Funnel provides more control over the args, but lodash simply passes\n       * them through, to replicate this behavior we need to spread the args\n       * array maintained via the reducer below.\n       */\n      func(...args);\n    },\n    {\n      // Throttle stores the latest args it was called with for the next invocation of the callback.\n      reducer: (_, ...args: Parameters<F>) => args,\n      minQuietPeriodMs: wait,\n      maxBurstDurationMs: wait,\n      ...(trailing\n        ? leading\n          ? { triggerAt: 'both' }\n          : { triggerAt: 'end' }\n        : { triggerAt: 'start' }),\n    },\n  );\n  /**\n   * Lodash uses a legacy JS-ism to attach helper functions to the main\n   * callback of `throttle`. In our's we return a proper object where the\n   * callback is one of the available properties. Here we destructure and then\n   * reconstruct the object to fit the Lodash API.\n   */\n  return Object.assign(call, rest);\n}\n\n/**\n * We need some non-trivial duration to use in all our tests, to abstract the\n * actual chosen value we use this UnitOfTime (UT) constant. As long as it is a\n * positive integer, the actual value doesn't matter (but the larger it is,\n * the longer the tests would take to run); the value used by Lodash is 32.\n * The number is in milliseconds.\n */\nconst UT = 16;\n\ndescribe('https://github.com/lodash/lodash/blob/4.17.21/test/test.js#L22768', () => {\n  it('should throttle a function', async () => {\n    const mockFn = vi.fn<() => void>();\n    const throttled = throttle(mockFn, UT);\n    throttled();\n    throttled();\n    throttled();\n    const callCount = mockFn.mock.calls.length;\n\n    expect(callCount).toBeGreaterThan(0);\n\n    await sleep(2 * UT);\n\n    expect(mockFn.mock.calls.length).toBeGreaterThan(callCount);\n  });\n\n  it('should clear timeout when `func` is called', async () => {\n    const mockFn = vi.fn<() => void>();\n    const throttled = throttle(mockFn, UT);\n    throttled();\n\n    expect(mockFn).toHaveBeenCalledTimes(1);\n\n    await sleep(2 * UT);\n\n    throttled();\n\n    expect(mockFn).toHaveBeenCalledTimes(2);\n  });\n\n  it('should not trigger a trailing call when invoked once', async () => {\n    const mockFn = vi.fn<() => void>();\n    const throttled = throttle(mockFn, UT);\n    throttled();\n\n    expect(mockFn).toHaveBeenCalledTimes(1);\n\n    await sleep(2 * UT);\n\n    expect(mockFn).toHaveBeenCalledTimes(1);\n  });\n\n  it('should trigger a call when invoked repeatedly', () => {\n    const mockFn = vi.fn<() => void>();\n\n    const throttled = throttle(mockFn, UT);\n\n    const end = Date.now() + 10 * UT;\n    while (Date.now() < end) {\n      throttled();\n    }\n\n    expect(mockFn).toHaveBeenCalledExactlyOnceWith();\n  });\n\n  it('should trigger a call when invoked repeatedly and `leading` is `false`', async () => {\n    const mockFn = vi.fn<() => void>();\n    const throttled = throttle(mockFn, UT, { leading: false });\n    const end = Date.now() + 10 * UT;\n    while (Date.now() < end) {\n      throttled();\n    }\n    // Yield execution to allow timeouts to run\n    await sleep(0);\n\n    expect(mockFn).toHaveBeenCalledExactlyOnceWith();\n  });\n\n  it('should trigger a second throttled call as soon as possible', async () => {\n    const mockFn = vi.fn<() => void>();\n    const throttled = throttle(mockFn, 4 * UT, { leading: false });\n    throttled();\n    await sleep(6 * UT);\n\n    expect(mockFn).toHaveBeenCalledTimes(1);\n\n    throttled();\n    await sleep(2 * UT);\n\n    expect(mockFn).toHaveBeenCalledTimes(1);\n\n    await sleep(4 * UT);\n\n    expect(mockFn).toHaveBeenCalledTimes(2);\n  });\n\n  it('should apply default options', async () => {\n    const mockFn = vi.fn<() => void>();\n    const throttled = throttle(mockFn, UT, {});\n    throttled();\n    throttled();\n\n    expect(mockFn).toHaveBeenCalledTimes(1);\n\n    await sleep(4 * UT);\n\n    expect(mockFn).toHaveBeenCalledTimes(2);\n  });\n\n  it('should support a `leading` option', () => {\n    const mockWith = vi.fn<() => void>();\n    const mockWithout = vi.fn<() => void>();\n    const withLeading = throttle(mockWith, UT, { leading: true });\n    const withoutLeading = throttle(mockWithout, UT, { leading: false });\n\n    withLeading();\n    withoutLeading();\n\n    expect(mockWith).toHaveBeenCalledTimes(1);\n    expect(mockWithout).toHaveBeenCalledTimes(0);\n  });\n\n  it('should support a `trailing` option', async () => {\n    const mockWith = vi.fn<(x: string) => void>();\n    const mockWithout = vi.fn<(x: string) => void>();\n    const withTrailing = throttle(mockWith, 2 * UT, { trailing: true });\n    const withoutTrailing = throttle(mockWithout, 2 * UT, { trailing: false });\n    withTrailing('a');\n    withTrailing('b');\n    withoutTrailing('a');\n    withoutTrailing('b');\n\n    expect(mockWith).toHaveBeenCalledExactlyOnceWith('a');\n    expect(mockWithout).toHaveBeenCalledExactlyOnceWith('a');\n\n    await sleep(8 * UT);\n\n    expect(mockWith).toHaveBeenCalledTimes(2);\n    expect(mockWithout).toHaveBeenCalledTimes(1);\n  });\n\n  it('should not update `lastCalled`, at the end of the timeout, when `trailing` is `false`', async () => {\n    const mockFn = vi.fn<() => void>();\n    const throttled = throttle(mockFn, 64, { trailing: false });\n    throttled();\n    throttled();\n    await sleep(3 * UT);\n    throttled();\n    throttled();\n    await sleep(3 * UT);\n\n    expect(mockFn).toHaveBeenCalledExactlyOnceWith();\n  });\n});\n\ndescribe('https://github.com/lodash/lodash/blob/4.17.21/test/test.js#L23038', () => {\n  it('should use a default `wait` of `0`', async () => {\n    const mockFn = vi.fn<() => void>();\n    const throttled = throttle(mockFn);\n    throttled();\n    await sleep(UT);\n    throttled();\n\n    expect(mockFn).toHaveBeenCalledTimes(2);\n  });\n\n  it('supports recursive calls', async () => {\n    const actual = [] as Array<string>;\n    const queue = ['a', 'b', 'c'];\n    const throttled = throttle((chr: string) => {\n      actual.push(chr);\n      const next = queue.shift();\n      if (next !== undefined) {\n        throttled(next);\n      }\n    }, UT);\n    throttled(queue.shift()!);\n\n    expect(actual).toStrictEqual(['a']);\n\n    await sleep(8 * UT);\n\n    expect(actual).toStrictEqual(['a', 'b', 'c']);\n  });\n\n  it('should support cancelling delayed calls', async () => {\n    const mockFn = vi.fn<() => void>();\n    const throttled = throttle(mockFn, UT, { leading: false });\n    throttled();\n    throttled.cancel();\n    await sleep(2 * UT);\n\n    expect(mockFn).toHaveBeenCalledTimes(0);\n  });\n\n  it('should reset `lastCalled` after cancelling', async () => {\n    const mockFn = vi.fn<() => void>();\n    const throttled = throttle(mockFn, UT, { leading: true });\n    throttled();\n\n    expect(mockFn).toHaveBeenCalledTimes(1);\n\n    throttled.cancel();\n    throttled();\n\n    expect(mockFn).toHaveBeenCalledTimes(2);\n\n    throttled();\n    await sleep(2 * UT);\n\n    expect(mockFn).toHaveBeenCalledTimes(3);\n  });\n\n  it('should support flushing delayed calls', async () => {\n    const mockFn = vi.fn<() => void>();\n    const throttled = throttle(mockFn, UT, { leading: false });\n    throttled();\n    throttled.flush();\n\n    expect(mockFn).toHaveBeenCalledTimes(1);\n\n    await sleep(2 * UT);\n\n    expect(mockFn).toHaveBeenCalledTimes(1);\n  });\n\n  it('should noop `cancel` and `flush` when nothing is queued', async () => {\n    const mockFn = vi.fn<() => void>();\n    const throttled = throttle(mockFn, UT);\n    throttled.cancel();\n    throttled.flush();\n\n    expect(mockFn).toHaveBeenCalledTimes(0);\n\n    await sleep(2 * UT);\n\n    expect(mockFn).toHaveBeenCalledTimes(0);\n  });\n});\n\ndescribe('not tested by Lodash', () => {\n  it('should do nothing when `leading` and `trailing` are both `disabled`', async () => {\n    const mockFn = vi.fn<() => void>();\n    const throttled = throttle(mockFn, UT, { leading: false, trailing: false });\n    throttled();\n    throttled();\n    throttled();\n\n    expect(mockFn).toHaveBeenCalledTimes(0);\n\n    await sleep(2 * UT);\n\n    expect(mockFn).toHaveBeenCalledTimes(0);\n  });\n});\n"],"mappings":"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"}
+{"version":3,"file":"funnel.lodash-throttle.test.js","names":[],"sources":["../src/funnel.lodash-throttle.test.ts"],"sourcesContent":["/* eslint-disable function-paren-newline, no-nested-ternary, ts/explicit-function-return-type, ts/no-explicit-any --\n * These aren't useful for a reference implementation for a legacy library!\n */\n\nimport { describe, expect, it, vi } from 'vitest';\nimport { funnel } from './funnel';\nimport { sleep } from './sleep';\n\n/**\n * A reference implementation of the Lodash `throttle` function using the\n * Our `funnel` function. While migrating from Lodash you can copy this\n * function as-is into your code base and use it as a drop-in replacement; but\n * we recommend eventually inlining the call to `funnel` so you can adjust the\n * function to your specific needs.\n *\n * This is a simplified implementation which ignores the Lodash capability to\n * track the return value of the callback function, but it is most likely the\n * more common use-case. For a more complete (and more complex) implementation\n * that also does that see the reference implementation for\n * `throttleWithCachedValue` in the other test file.\n *\n * The following tests in this file are based on the Lodash tests for throttle.\n * They have been adapted to work with our testing framework, have been fixed\n * or expanded slightly were it felt necessary, and have been modernized for\n * better readability. The names of the test cases have been preserved to ease\n * comparing them to the original tests.\n *\n * Note that this means that whenever Lodash offered a concrete spec, we made\n * sure our reference implementation respects it, but there might be untested\n * use-cases that would have differing runtime behaviors.\n *\n * @see Lodash Documentation: https://lodash.com/docs/4.17.15#throttle\n * @see Lodash Implementation: https://github.com/lodash/lodash/blob/4.17.21/lodash.js#L10965\n * @see Lodash Typing: https://github.com/DefinitelyTyped/DefinitelyTyped/blob/master/types/lodash/common/function.d.ts#L1347\n */\nfunction throttle<F extends (...args: any) => void>(\n  func: F,\n  wait = 0,\n  {\n    leading = true,\n    trailing = true,\n  }: { readonly leading?: boolean; readonly trailing?: boolean } = {},\n) {\n  const {\n    call,\n    // Lodash v4 doesn't provide access to the `isIdle` (called `pending` in Lodash v5) information.\n    isIdle: _isIdle,\n    ...rest\n  } = funnel(\n    (args: Parameters<F>) => {\n      if (!leading && !trailing) {\n        /**\n         * In Lodash you can disable both the trailing and leading edges of the\n         * throttle window, effectively causing the function to never be\n         * invoked. Our's uses the invokedAt enum exactly to prevent such a\n         * situation; so to simulate Lodash we need to only pass the callback\n         * when at least one of them is enabled.\n         */\n        return;\n      }\n\n      /**\n       * Funnel provides more control over the args, but lodash simply passes\n       * them through, to replicate this behavior we need to spread the args\n       * array maintained via the reducer below.\n       */\n      func(...args);\n    },\n    {\n      // Throttle stores the latest args it was called with for the next invocation of the callback.\n      reducer: (_, ...args: Parameters<F>) => args,\n      minQuietPeriodMs: wait,\n      maxBurstDurationMs: wait,\n      ...(trailing\n        ? leading\n          ? { triggerAt: 'both' }\n          : { triggerAt: 'end' }\n        : { triggerAt: 'start' }),\n    },\n  );\n  /**\n   * Lodash uses a legacy JS-ism to attach helper functions to the main\n   * callback of `throttle`. In our's we return a proper object where the\n   * callback is one of the available properties. Here we destructure and then\n   * reconstruct the object to fit the Lodash API.\n   */\n  return Object.assign(call, rest);\n}\n\n/**\n * We need some non-trivial duration to use in all our tests, to abstract the\n * actual chosen value we use this UnitOfTime (UT) constant. As long as it is a\n * positive integer, the actual value doesn't matter (but the larger it is,\n * the longer the tests would take to run); the value used by Lodash is 32.\n * The number is in milliseconds.\n */\nconst UT = 16;\n\ndescribe('https://github.com/lodash/lodash/blob/4.17.21/test/test.js#L22768', () => {\n  it('should throttle a function', async () => {\n    const mockFn = vi.fn<() => void>();\n    const throttled = throttle(mockFn, UT);\n    throttled();\n    throttled();\n    throttled();\n    const callCount = mockFn.mock.calls.length;\n\n    expect(callCount).toBeGreaterThan(0);\n\n    await sleep(2 * UT);\n\n    expect(mockFn.mock.calls.length).toBeGreaterThan(callCount);\n  });\n\n  it('should clear timeout when `func` is called', async () => {\n    const mockFn = vi.fn<() => void>();\n    const throttled = throttle(mockFn, UT);\n    throttled();\n\n    expect(mockFn).toHaveBeenCalledTimes(1);\n\n    await sleep(2 * UT);\n\n    throttled();\n\n    expect(mockFn).toHaveBeenCalledTimes(2);\n  });\n\n  it('should not trigger a trailing call when invoked once', async () => {\n    const mockFn = vi.fn<() => void>();\n    const throttled = throttle(mockFn, UT);\n    throttled();\n\n    expect(mockFn).toHaveBeenCalledTimes(1);\n\n    await sleep(2 * UT);\n\n    expect(mockFn).toHaveBeenCalledTimes(1);\n  });\n\n  it('should trigger a call when invoked repeatedly', () => {\n    const mockFn = vi.fn<() => void>();\n\n    const throttled = throttle(mockFn, UT);\n\n    const end = Date.now() + 10 * UT;\n    while (Date.now() < end) {\n      throttled();\n    }\n\n    expect(mockFn).toHaveBeenCalledExactlyOnceWith();\n  });\n\n  it('should trigger a call when invoked repeatedly and `leading` is `false`', async () => {\n    const mockFn = vi.fn<() => void>();\n    const throttled = throttle(mockFn, UT, { leading: false });\n    const end = Date.now() + 10 * UT;\n    while (Date.now() < end) {\n      throttled();\n    }\n    // Yield execution to allow timeouts to run\n    await sleep(0);\n\n    expect(mockFn).toHaveBeenCalledExactlyOnceWith();\n  });\n\n  it('should trigger a second throttled call as soon as possible', async () => {\n    const mockFn = vi.fn<() => void>();\n    const throttled = throttle(mockFn, 4 * UT, { leading: false });\n    throttled();\n    await sleep(6 * UT);\n\n    expect(mockFn).toHaveBeenCalledTimes(1);\n\n    throttled();\n    await sleep(2 * UT);\n\n    expect(mockFn).toHaveBeenCalledTimes(1);\n\n    await sleep(4 * UT);\n\n    expect(mockFn).toHaveBeenCalledTimes(2);\n  });\n\n  it('should apply default options', async () => {\n    const mockFn = vi.fn<() => void>();\n    const throttled = throttle(mockFn, UT, {});\n    throttled();\n    throttled();\n\n    expect(mockFn).toHaveBeenCalledTimes(1);\n\n    await sleep(4 * UT);\n\n    expect(mockFn).toHaveBeenCalledTimes(2);\n  });\n\n  it('should support a `leading` option', () => {\n    const mockWith = vi.fn<() => void>();\n    const mockWithout = vi.fn<() => void>();\n    const withLeading = throttle(mockWith, UT, { leading: true });\n    const withoutLeading = throttle(mockWithout, UT, { leading: false });\n\n    withLeading();\n    withoutLeading();\n\n    expect(mockWith).toHaveBeenCalledTimes(1);\n    expect(mockWithout).toHaveBeenCalledTimes(0);\n  });\n\n  it('should support a `trailing` option', async () => {\n    const mockWith = vi.fn<(x: string) => void>();\n    const mockWithout = vi.fn<(x: string) => void>();\n    const withTrailing = throttle(mockWith, 2 * UT, { trailing: true });\n    const withoutTrailing = throttle(mockWithout, 2 * UT, { trailing: false });\n    withTrailing('a');\n    withTrailing('b');\n    withoutTrailing('a');\n    withoutTrailing('b');\n\n    expect(mockWith).toHaveBeenCalledExactlyOnceWith('a');\n    expect(mockWithout).toHaveBeenCalledExactlyOnceWith('a');\n\n    await sleep(8 * UT);\n\n    expect(mockWith).toHaveBeenCalledTimes(2);\n    expect(mockWithout).toHaveBeenCalledTimes(1);\n  });\n\n  it('should not update `lastCalled`, at the end of the timeout, when `trailing` is `false`', async () => {\n    const mockFn = vi.fn<() => void>();\n    const throttled = throttle(mockFn, 64, { trailing: false });\n    throttled();\n    throttled();\n    await sleep(3 * UT);\n    throttled();\n    throttled();\n    await sleep(3 * UT);\n\n    expect(mockFn).toHaveBeenCalledExactlyOnceWith();\n  });\n});\n\ndescribe('https://github.com/lodash/lodash/blob/4.17.21/test/test.js#L23038', () => {\n  it('should use a default `wait` of `0`', async () => {\n    const mockFn = vi.fn<() => void>();\n    const throttled = throttle(mockFn);\n    throttled();\n    await sleep(UT);\n    throttled();\n\n    expect(mockFn).toHaveBeenCalledTimes(2);\n  });\n\n  it('supports recursive calls', async () => {\n    const actual = [] as Array<string>;\n    const queue = ['a', 'b', 'c'];\n    const throttled = throttle((chr: string) => {\n      actual.push(chr);\n      const next = queue.shift();\n      if (next !== undefined) {\n        throttled(next);\n      }\n    }, UT);\n    throttled(queue.shift()!);\n\n    expect(actual).toStrictEqual(['a']);\n\n    await sleep(8 * UT);\n\n    expect(actual).toStrictEqual(['a', 'b', 'c']);\n  });\n\n  it('should support cancelling delayed calls', async () => {\n    const mockFn = vi.fn<() => void>();\n    const throttled = throttle(mockFn, UT, { leading: false });\n    throttled();\n    throttled.cancel();\n    await sleep(2 * UT);\n\n    expect(mockFn).toHaveBeenCalledTimes(0);\n  });\n\n  it('should reset `lastCalled` after cancelling', async () => {\n    const mockFn = vi.fn<() => void>();\n    const throttled = throttle(mockFn, UT, { leading: true });\n    throttled();\n\n    expect(mockFn).toHaveBeenCalledTimes(1);\n\n    throttled.cancel();\n    throttled();\n\n    expect(mockFn).toHaveBeenCalledTimes(2);\n\n    throttled();\n    await sleep(2 * UT);\n\n    expect(mockFn).toHaveBeenCalledTimes(3);\n  });\n\n  it('should support flushing delayed calls', async () => {\n    const mockFn = vi.fn<() => void>();\n    const throttled = throttle(mockFn, UT, { leading: false });\n    throttled();\n    throttled.flush();\n\n    expect(mockFn).toHaveBeenCalledTimes(1);\n\n    await sleep(2 * UT);\n\n    expect(mockFn).toHaveBeenCalledTimes(1);\n  });\n\n  it('should noop `cancel` and `flush` when nothing is queued', async () => {\n    const mockFn = vi.fn<() => void>();\n    const throttled = throttle(mockFn, UT);\n    throttled.cancel();\n    throttled.flush();\n\n    expect(mockFn).toHaveBeenCalledTimes(0);\n\n    await sleep(2 * UT);\n\n    expect(mockFn).toHaveBeenCalledTimes(0);\n  });\n});\n\ndescribe('not tested by Lodash', () => {\n  it('should do nothing when `leading` and `trailing` are both `disabled`', async () => {\n    const mockFn = vi.fn<() => void>();\n    const throttled = throttle(mockFn, UT, { leading: false, trailing: false });\n    throttled();\n    throttled();\n    throttled();\n\n    expect(mockFn).toHaveBeenCalledTimes(0);\n\n    await sleep(2 * UT);\n\n    expect(mockFn).toHaveBeenCalledTimes(0);\n  });\n});\n"],"mappings":"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"}

package/dist/funnel.perkakas-debounce.test.cjs

@@ -1 +1 @@
-const e=require(`./dist-gvJoKj_M.cjs`),t=require(`./constant-BuIJ9GIn.cjs`),n=require(`./funnel-CL-QFpGk.cjs`),r=require(`./identity-BAryUWbs.cjs`),i=require(`./sleep-1rGV3wAg.cjs`);function a(e,{timing:t,waitMs:r,maxWaitMs:i}){if(i!==void 0&&r!==void 0&&i<r)throw Error(`debounce: maxWaitMs (${i.toString()}) cannot be less than waitMs (${r.toString()})`);let a,o=n.funnel(t=>{a=e(...t)},{reducer:(e,...t)=>t,minQuietPeriodMs:r??i??0,...i!==void 0&&{maxBurstDurationMs:i},...t===`leading`?{triggerAt:`start`}:t===`both`?{triggerAt:`both`}:{triggerAt:`end`}});return{call:(...e)=>(o.call(...e),a),flush:()=>(o.flush(),a),cancel:()=>{o.cancel()},get isPending(){return!o.isIdle},get cachedValue(){return a}}}e.describe(`main functionality`,()=>{e.it(`should debounce a function`,async()=>{let t=e.vi.fn(r.identity()),n=a(t,{waitMs:32});e.globalExpect([n.call(`a`),n.call(`b`),n.call(`c`)]).toStrictEqual([void 0,void 0,void 0]),e.globalExpect(t).toHaveBeenCalledTimes(0),await i.sleep(128),e.globalExpect(t).toHaveBeenCalledTimes(1),e.globalExpect([n.call(`d`),n.call(`e`),n.call(`f`)]).toStrictEqual([`c`,`c`,`c`]),e.globalExpect(t).toHaveBeenCalledTimes(1),await i.sleep(256),e.globalExpect(t).toHaveBeenCalledTimes(2)}),e.it("subsequent debounced calls return the last `func` result",async()=>{let t=a(r.identity(),{waitMs:32});t.call(`a`),await i.sleep(64),e.globalExpect(t.call(`b`)).toBe(`a`),await i.sleep(128),e.globalExpect(t.call(`c`)).toBe(`b`)}),e.it("should not immediately call `func` when `wait` is `0`",async()=>{let t=e.vi.fn(),n=a(t,{});n.call(),n.call(),e.globalExpect(t).toHaveBeenCalledTimes(0),await i.sleep(5),e.globalExpect(t).toHaveBeenCalledTimes(1)}),e.it(`should apply default options`,async()=>{let t=e.vi.fn();a(t,{waitMs:32}).call(),e.globalExpect(t).toHaveBeenCalledTimes(0),await i.sleep(64),e.globalExpect(t).toHaveBeenCalledTimes(1)}),e.it("should support a `leading` option",async()=>{let t=e.vi.fn(),n=e.vi.fn(),r=a(t,{waitMs:32,timing:`leading`});r.call(),e.globalExpect(t).toHaveBeenCalledTimes(1);let o=a(n,{waitMs:32,timing:`both`});o.call(),o.call(),e.globalExpect(n).toHaveBeenCalledTimes(1),await i.sleep(64),e.globalExpect(n).toHaveBeenCalledTimes(2),r.call(),e.globalExpect(t).toHaveBeenCalledTimes(2)}),e.it("subsequent leading debounced calls return the last `func` result",async()=>{let t=a(r.identity(),{waitMs:32,timing:`leading`});e.globalExpect([t.call(`a`),t.call(`b`)]).toStrictEqual([`a`,`a`]),await i.sleep(64),e.globalExpect([t.call(`c`),t.call(`d`)]).toStrictEqual([`c`,`c`])}),e.it("should support a `trailing` option",async()=>{let t=e.vi.fn();a(t,{waitMs:32,timing:`trailing`}).call(),e.globalExpect(t).toHaveBeenCalledTimes(0),await i.sleep(64),e.globalExpect(t).toHaveBeenCalledTimes(1)})}),e.describe(`optional param maxWaitMs`,()=>{e.it("should support a `maxWait` option",async()=>{let t=e.vi.fn(),n=a(t,{waitMs:32,maxWaitMs:64});n.call(`a`),n.call(`b`),e.globalExpect(t).toHaveBeenCalledTimes(0),await i.sleep(128),e.globalExpect(t).toHaveBeenCalledTimes(1),n.call(`c`),n.call(`d`),e.globalExpect(t).toHaveBeenCalledTimes(1),await i.sleep(256),e.globalExpect(t).toHaveBeenCalledTimes(2)}),e.it("should support `maxWait` in a tight loop",async()=>{let t=e.vi.fn(),n=e.vi.fn(),r=a(t,{waitMs:32,maxWaitMs:128}),o=a(n,{waitMs:96}),s=Date.now();for(;Date.now()-s<320;)r.call(),o.call();await i.sleep(1),e.globalExpect(n).toHaveBeenCalledTimes(0),e.globalExpect(t).not.toHaveBeenCalledTimes(0)}),e.it("should queue a trailing call for subsequent debounced calls after `maxWait`",async()=>{let t=e.vi.fn(),n=a(t,{waitMs:200,maxWaitMs:200});n.call(),setTimeout(()=>{n.call()},190),setTimeout(()=>{n.call()},200),setTimeout(()=>{n.call()},210),await i.sleep(500),e.globalExpect(t).toHaveBeenCalledTimes(2)}),e.it("should cancel `maxDelayed` when `delayed` is invoked",async()=>{let t=e.vi.fn(),n=a(t,{waitMs:32,maxWaitMs:64});n.call(),await i.sleep(128),n.call(),e.globalExpect(t).toHaveBeenCalledTimes(1),await i.sleep(192),e.globalExpect(t).toHaveBeenCalledTimes(2)}),e.it(`works like a leaky bucket when only maxWaitMs is set`,async()=>{let t=e.vi.fn(),n=a(t,{maxWaitMs:32});n.call(),e.globalExpect(t).toHaveBeenCalledTimes(0),await i.sleep(16),n.call(),e.globalExpect(t).toHaveBeenCalledTimes(0),await i.sleep(17),e.globalExpect(t).toHaveBeenCalledTimes(1)})}),e.describe(`additional functionality`,()=>{e.it(`can cancel before the timer starts`,async()=>{let t=a(r.identity(),{waitMs:32});e.globalExpect(()=>{t.cancel()}).not.toThrow(),e.globalExpect(t.call(`hello`)).toBeUndefined(),await i.sleep(32),e.globalExpect(t.call(`world`)).toBe(`hello`)}),e.it(`can cancel the timer`,async()=>{let n=e.vi.fn(t.constant(`Hello, World!`)),r=a(n,{waitMs:32});e.globalExpect(r.call()).toBeUndefined(),e.globalExpect(n).toHaveBeenCalledTimes(0),await i.sleep(1),e.globalExpect(r.call()).toBeUndefined(),e.globalExpect(n).toHaveBeenCalledTimes(0),r.cancel(),await i.sleep(32),e.globalExpect(r.call()).toBeUndefined(),e.globalExpect(n).toHaveBeenCalledTimes(0),await i.sleep(32),e.globalExpect(r.call()).toBe(`Hello, World!`),e.globalExpect(n).toHaveBeenCalledTimes(1)}),e.it(`can cancel after the timer ends`,async()=>{let t=a(r.identity(),{waitMs:32});e.globalExpect(t.call(`hello`)).toBeUndefined(),await i.sleep(32),e.globalExpect(t.call(`world`)).toBe(`hello`),e.globalExpect(()=>{t.cancel()}).not.toThrow()}),e.it(`can cancel maxWait timer`,async()=>{let t=a(r.identity(),{waitMs:16,maxWaitMs:32});e.globalExpect(t.call(`hello`)).toBeUndefined(),await i.sleep(1),t.cancel(),await i.sleep(32),e.globalExpect(t.call(`world`)).toBeUndefined()}),e.it(`can return a cached value`,()=>{let t=a(r.identity(),{timing:`leading`,waitMs:32});e.globalExpect(t.cachedValue).toBeUndefined(),e.globalExpect(t.call(`hello`)).toBe(`hello`),e.globalExpect(t.cachedValue).toBe(`hello`)}),e.it(`can check for inflight timers (trailing)`,async()=>{let t=a(r.identity(),{waitMs:32});e.globalExpect(t.isPending).toBe(!1),e.globalExpect(t.call(`hello`)).toBeUndefined(),e.globalExpect(t.isPending).toBe(!0),await i.sleep(1),e.globalExpect(t.isPending).toBe(!0),await i.sleep(32),e.globalExpect(t.isPending).toBe(!1)}),e.it(`can check for inflight timers (leading)`,async()=>{let t=a(r.identity(),{timing:`leading`,waitMs:32});e.globalExpect(t.isPending).toBe(!1),e.globalExpect(t.call(`hello`)).toBe(`hello`),e.globalExpect(t.isPending).toBe(!0),await i.sleep(1),e.globalExpect(t.isPending).toBe(!0),await i.sleep(32),e.globalExpect(t.isPending).toBe(!1)}),e.it(`can flush before a cool-down`,async()=>{let t=a(r.identity(),{waitMs:32});e.globalExpect(t.flush()).toBeUndefined(),e.globalExpect(t.call(`hello`)).toBeUndefined(),await i.sleep(32),e.globalExpect(t.call(`world`)).toBe(`hello`)}),e.it(`can flush during a cool-down`,async()=>{let t=a(r.identity(),{waitMs:32});e.globalExpect(t.call(`hello`)).toBeUndefined(),await i.sleep(1),e.globalExpect(t.call(`world`)).toBeUndefined(),await i.sleep(1),e.globalExpect(t.flush()).toBe(`world`)}),e.it(`can flush after a cool-down`,async()=>{let t=a(r.identity(),{waitMs:32});e.globalExpect(t.call(`hello`)).toBeUndefined(),await i.sleep(32),e.globalExpect(t.flush()).toBe(`hello`)})}),e.describe(`errors`,()=>{e.it(`prevents maxWaitMs to be less then waitMs`,()=>{e.globalExpect(()=>a(r.identity(),{waitMs:32,maxWaitMs:16})).toThrow(`debounce: maxWaitMs (16) cannot be less than waitMs (32)`)})});
+const e=require(`./dist-CiyBKPT6.cjs`),t=require(`./constant.cjs`),n=require(`./funnel.cjs`),r=require(`./identity.cjs`),i=require(`./sleep.cjs`);function a(e,{timing:t,waitMs:r,maxWaitMs:i}){if(i!==void 0&&r!==void 0&&i<r)throw Error(`debounce: maxWaitMs (${i.toString()}) cannot be less than waitMs (${r.toString()})`);let a,o=n.funnel(t=>{a=e(...t)},{reducer:(e,...t)=>t,minQuietPeriodMs:r??i??0,...i!==void 0&&{maxBurstDurationMs:i},...t===`leading`?{triggerAt:`start`}:t===`both`?{triggerAt:`both`}:{triggerAt:`end`}});return{call:(...e)=>(o.call(...e),a),flush:()=>(o.flush(),a),cancel:()=>{o.cancel()},get isPending(){return!o.isIdle},get cachedValue(){return a}}}e.i(`main functionality`,()=>{e.a(`should debounce a function`,async()=>{let t=e.r.fn(r.identity()),n=a(t,{waitMs:32});e.n([n.call(`a`),n.call(`b`),n.call(`c`)]).toStrictEqual([void 0,void 0,void 0]),e.n(t).toHaveBeenCalledTimes(0),await i.sleep(128),e.n(t).toHaveBeenCalledTimes(1),e.n([n.call(`d`),n.call(`e`),n.call(`f`)]).toStrictEqual([`c`,`c`,`c`]),e.n(t).toHaveBeenCalledTimes(1),await i.sleep(256),e.n(t).toHaveBeenCalledTimes(2)}),e.a("subsequent debounced calls return the last `func` result",async()=>{let t=a(r.identity(),{waitMs:32});t.call(`a`),await i.sleep(64),e.n(t.call(`b`)).toBe(`a`),await i.sleep(128),e.n(t.call(`c`)).toBe(`b`)}),e.a("should not immediately call `func` when `wait` is `0`",async()=>{let t=e.r.fn(),n=a(t,{});n.call(),n.call(),e.n(t).toHaveBeenCalledTimes(0),await i.sleep(5),e.n(t).toHaveBeenCalledTimes(1)}),e.a(`should apply default options`,async()=>{let t=e.r.fn();a(t,{waitMs:32}).call(),e.n(t).toHaveBeenCalledTimes(0),await i.sleep(64),e.n(t).toHaveBeenCalledTimes(1)}),e.a("should support a `leading` option",async()=>{let t=e.r.fn(),n=e.r.fn(),r=a(t,{waitMs:32,timing:`leading`});r.call(),e.n(t).toHaveBeenCalledTimes(1);let o=a(n,{waitMs:32,timing:`both`});o.call(),o.call(),e.n(n).toHaveBeenCalledTimes(1),await i.sleep(64),e.n(n).toHaveBeenCalledTimes(2),r.call(),e.n(t).toHaveBeenCalledTimes(2)}),e.a("subsequent leading debounced calls return the last `func` result",async()=>{let t=a(r.identity(),{waitMs:32,timing:`leading`});e.n([t.call(`a`),t.call(`b`)]).toStrictEqual([`a`,`a`]),await i.sleep(64),e.n([t.call(`c`),t.call(`d`)]).toStrictEqual([`c`,`c`])}),e.a("should support a `trailing` option",async()=>{let t=e.r.fn();a(t,{waitMs:32,timing:`trailing`}).call(),e.n(t).toHaveBeenCalledTimes(0),await i.sleep(64),e.n(t).toHaveBeenCalledTimes(1)})}),e.i(`optional param maxWaitMs`,()=>{e.a("should support a `maxWait` option",async()=>{let t=e.r.fn(),n=a(t,{waitMs:32,maxWaitMs:64});n.call(`a`),n.call(`b`),e.n(t).toHaveBeenCalledTimes(0),await i.sleep(128),e.n(t).toHaveBeenCalledTimes(1),n.call(`c`),n.call(`d`),e.n(t).toHaveBeenCalledTimes(1),await i.sleep(256),e.n(t).toHaveBeenCalledTimes(2)}),e.a("should support `maxWait` in a tight loop",async()=>{let t=e.r.fn(),n=e.r.fn(),r=a(t,{waitMs:32,maxWaitMs:128}),o=a(n,{waitMs:96}),s=Date.now();for(;Date.now()-s<320;)r.call(),o.call();await i.sleep(1),e.n(n).toHaveBeenCalledTimes(0),e.n(t).not.toHaveBeenCalledTimes(0)}),e.a("should queue a trailing call for subsequent debounced calls after `maxWait`",async()=>{let t=e.r.fn(),n=a(t,{waitMs:200,maxWaitMs:200});n.call(),setTimeout(()=>{n.call()},190),setTimeout(()=>{n.call()},200),setTimeout(()=>{n.call()},210),await i.sleep(500),e.n(t).toHaveBeenCalledTimes(2)}),e.a("should cancel `maxDelayed` when `delayed` is invoked",async()=>{let t=e.r.fn(),n=a(t,{waitMs:32,maxWaitMs:64});n.call(),await i.sleep(128),n.call(),e.n(t).toHaveBeenCalledTimes(1),await i.sleep(192),e.n(t).toHaveBeenCalledTimes(2)}),e.a(`works like a leaky bucket when only maxWaitMs is set`,async()=>{let t=e.r.fn(),n=a(t,{maxWaitMs:32});n.call(),e.n(t).toHaveBeenCalledTimes(0),await i.sleep(16),n.call(),e.n(t).toHaveBeenCalledTimes(0),await i.sleep(17),e.n(t).toHaveBeenCalledTimes(1)})}),e.i(`additional functionality`,()=>{e.a(`can cancel before the timer starts`,async()=>{let t=a(r.identity(),{waitMs:32});e.n(()=>{t.cancel()}).not.toThrow(),e.n(t.call(`hello`)).toBeUndefined(),await i.sleep(32),e.n(t.call(`world`)).toBe(`hello`)}),e.a(`can cancel the timer`,async()=>{let n=e.r.fn(t.constant(`Hello, World!`)),r=a(n,{waitMs:32});e.n(r.call()).toBeUndefined(),e.n(n).toHaveBeenCalledTimes(0),await i.sleep(1),e.n(r.call()).toBeUndefined(),e.n(n).toHaveBeenCalledTimes(0),r.cancel(),await i.sleep(32),e.n(r.call()).toBeUndefined(),e.n(n).toHaveBeenCalledTimes(0),await i.sleep(32),e.n(r.call()).toBe(`Hello, World!`),e.n(n).toHaveBeenCalledTimes(1)}),e.a(`can cancel after the timer ends`,async()=>{let t=a(r.identity(),{waitMs:32});e.n(t.call(`hello`)).toBeUndefined(),await i.sleep(32),e.n(t.call(`world`)).toBe(`hello`),e.n(()=>{t.cancel()}).not.toThrow()}),e.a(`can cancel maxWait timer`,async()=>{let t=a(r.identity(),{waitMs:16,maxWaitMs:32});e.n(t.call(`hello`)).toBeUndefined(),await i.sleep(1),t.cancel(),await i.sleep(32),e.n(t.call(`world`)).toBeUndefined()}),e.a(`can return a cached value`,()=>{let t=a(r.identity(),{timing:`leading`,waitMs:32});e.n(t.cachedValue).toBeUndefined(),e.n(t.call(`hello`)).toBe(`hello`),e.n(t.cachedValue).toBe(`hello`)}),e.a(`can check for inflight timers (trailing)`,async()=>{let t=a(r.identity(),{waitMs:32});e.n(t.isPending).toBe(!1),e.n(t.call(`hello`)).toBeUndefined(),e.n(t.isPending).toBe(!0),await i.sleep(1),e.n(t.isPending).toBe(!0),await i.sleep(32),e.n(t.isPending).toBe(!1)}),e.a(`can check for inflight timers (leading)`,async()=>{let t=a(r.identity(),{timing:`leading`,waitMs:32});e.n(t.isPending).toBe(!1),e.n(t.call(`hello`)).toBe(`hello`),e.n(t.isPending).toBe(!0),await i.sleep(1),e.n(t.isPending).toBe(!0),await i.sleep(32),e.n(t.isPending).toBe(!1)}),e.a(`can flush before a cool-down`,async()=>{let t=a(r.identity(),{waitMs:32});e.n(t.flush()).toBeUndefined(),e.n(t.call(`hello`)).toBeUndefined(),await i.sleep(32),e.n(t.call(`world`)).toBe(`hello`)}),e.a(`can flush during a cool-down`,async()=>{let t=a(r.identity(),{waitMs:32});e.n(t.call(`hello`)).toBeUndefined(),await i.sleep(1),e.n(t.call(`world`)).toBeUndefined(),await i.sleep(1),e.n(t.flush()).toBe(`world`)}),e.a(`can flush after a cool-down`,async()=>{let t=a(r.identity(),{waitMs:32});e.n(t.call(`hello`)).toBeUndefined(),await i.sleep(32),e.n(t.flush()).toBe(`hello`)})}),e.i(`errors`,()=>{e.a(`prevents maxWaitMs to be less then waitMs`,()=>{e.n(()=>a(r.identity(),{waitMs:32,maxWaitMs:16})).toThrow(`debounce: maxWaitMs (16) cannot be less than waitMs (32)`)})});