@vinicunca/perkakas 1.13.2 → 1.15.0

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

@@ -1 +0,0 @@
-{"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 +0,0 @@
-const e=require(`./dist-8XtUY3ad.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.toThrowError(),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.toThrowError()}),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})).toThrowError(`debounce: maxWaitMs (16) cannot be less than waitMs (32)`)})});

package/dist/funnel.perkakas-debounce.test.d.cts

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

package/dist/funnel.perkakas-debounce.test.d.ts

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

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

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

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

@@ -1 +0,0 @@
-{"version":3,"file":"funnel.perkakas-debounce.test.js","names":["cachedValue: ReturnType<F> | undefined"],"sources":["../src/funnel.perkakas-debounce.test.ts"],"sourcesContent":["/* eslint-disable no-nested-ternary, ts/explicit-function-return-type --\n * These aren't useful for a reference implementation!\n */\n\nimport type { StrictFunction } from './internal/types/strict-function';\nimport { describe, expect, it, vi } from 'vitest';\nimport { constant } from './constant';\nimport { funnel } from './funnel';\nimport { identity } from './identity';\nimport { sleep } from './sleep';\n\ninterface Debouncer<F extends StrictFunction, IsNullable extends boolean = true> {\n  readonly call: (\n    ...args: Parameters<F>\n  ) => ReturnType<F> | (true extends IsNullable ? undefined : never);\n  readonly cancel: () => void;\n  readonly flush: () => ReturnType<F> | undefined;\n  readonly isPending: boolean;\n  readonly cachedValue: ReturnType<F> | undefined;\n}\n\ninterface DebounceOptions {\n  readonly waitMs?: number;\n  readonly maxWaitMs?: number;\n}\n\n/**\n * A reference implementation of the now deprecated `debounce` function using\n * the `funnel` function instead. While you update your codebase you can copy\n * this function as-is and use it as a drop-in replacement; but we recommend\n * eventually inlining the call to `funnel` so you can adjust the function to\n * your specific needs.\n *\n * The following tests in this file are the original tests for debounce.\n *\n * @see debounce\n */\nfunction debounce<F extends StrictFunction>(\n  func: F,\n  options: DebounceOptions & { readonly timing?: 'trailing' },\n): Debouncer<F>;\nfunction debounce<F extends StrictFunction>(\n  func: F,\n  options:\n    | (DebounceOptions & { readonly timing: 'both' })\n    | (Omit<DebounceOptions, 'maxWaitMs'> & { readonly timing: 'leading' }),\n): Debouncer<F, false>;\nfunction debounce<F extends StrictFunction>(\n  func: F,\n  {\n    timing,\n    waitMs,\n    maxWaitMs,\n  }: DebounceOptions & {\n    readonly timing?: 'both' | 'leading' | 'trailing';\n  },\n) {\n  if (maxWaitMs !== undefined && waitMs !== undefined && maxWaitMs < waitMs) {\n    throw new Error(\n      `debounce: maxWaitMs (${maxWaitMs.toString()}) cannot be less than waitMs (${waitMs.toString()})`,\n    );\n  }\n\n  let cachedValue: ReturnType<F> | undefined;\n\n  const debouncingFunnel = funnel(\n    (args: Parameters<F>) => {\n      // @ts-expect-error [ts2345, ts2322] -- TypeScript infers the generic sub-\n      // types too eagerly, making itself blind to the fact that the types\n      // match here.\n      cachedValue = func(...args) as ReturnType<F>;\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: waitMs ?? maxWaitMs ?? 0,\n      ...(maxWaitMs !== undefined && { maxBurstDurationMs: maxWaitMs }),\n      ...(timing === 'leading'\n        ? { triggerAt: 'start' }\n        : timing === 'both'\n          ? { triggerAt: 'both' }\n          : { triggerAt: 'end' }),\n    },\n  );\n\n  return {\n    call: (...args: Parameters<F>) => {\n      debouncingFunnel.call(...args);\n      return cachedValue;\n    },\n\n    flush: () => {\n      debouncingFunnel.flush();\n      return cachedValue;\n    },\n\n    cancel: () => {\n      debouncingFunnel.cancel();\n    },\n\n    get isPending() {\n      return !debouncingFunnel.isIdle;\n    },\n\n    get cachedValue() {\n      return cachedValue;\n    },\n  };\n}\n\ndescribe('main functionality', () => {\n  it('should debounce a function', async () => {\n    const mockFn = vi.fn<(x: string) => string>(identity());\n    const debouncer = debounce(mockFn, { waitMs: 32 });\n\n    expect([\n      debouncer.call('a'),\n      debouncer.call('b'),\n      debouncer.call('c'),\n    ]).toStrictEqual([undefined, undefined, undefined]);\n    expect(mockFn).toHaveBeenCalledTimes(0);\n\n    await sleep(128);\n\n    expect(mockFn).toHaveBeenCalledTimes(1);\n    expect([\n      debouncer.call('d'),\n      debouncer.call('e'),\n      debouncer.call('f'),\n    ]).toStrictEqual(['c', 'c', 'c']);\n    expect(mockFn).toHaveBeenCalledTimes(1);\n\n    await sleep(256);\n\n    expect(mockFn).toHaveBeenCalledTimes(2);\n  });\n\n  it('subsequent debounced calls return the last `func` result', async () => {\n    const debouncer = debounce(identity(), { waitMs: 32 });\n    debouncer.call('a');\n    await sleep(64);\n\n    expect(debouncer.call('b')).toBe('a');\n\n    await sleep(128);\n\n    expect(debouncer.call('c')).toBe('b');\n  });\n\n  it('should not immediately call `func` when `wait` is `0`', async () => {\n    const mockFn = vi.fn<() => void>();\n    const debouncer = debounce(mockFn, {});\n    debouncer.call();\n    debouncer.call();\n\n    expect(mockFn).toHaveBeenCalledTimes(0);\n\n    await sleep(5);\n\n    expect(mockFn).toHaveBeenCalledTimes(1);\n  });\n\n  it('should apply default options', async () => {\n    const mockFn = vi.fn<() => void>();\n    const debouncer = debounce(mockFn, { waitMs: 32 });\n    debouncer.call();\n\n    expect(mockFn).toHaveBeenCalledTimes(0);\n\n    await sleep(64);\n\n    expect(mockFn).toHaveBeenCalledTimes(1);\n  });\n\n  it('should support a `leading` option', async () => {\n    const leadingMockFn = vi.fn<() => void>();\n    const bothMockFn = vi.fn<() => void>();\n    const withLeading = debounce(leadingMockFn, {\n      waitMs: 32,\n      timing: 'leading',\n    });\n    withLeading.call();\n\n    expect(leadingMockFn).toHaveBeenCalledTimes(1);\n\n    const withLeadingAndTrailing = debounce(bothMockFn, {\n      waitMs: 32,\n      timing: 'both',\n    });\n    withLeadingAndTrailing.call();\n    withLeadingAndTrailing.call();\n\n    expect(bothMockFn).toHaveBeenCalledTimes(1);\n\n    await sleep(64);\n\n    expect(bothMockFn).toHaveBeenCalledTimes(2);\n\n    withLeading.call();\n\n    expect(leadingMockFn).toHaveBeenCalledTimes(2);\n  });\n\n  it('subsequent leading debounced calls return the last `func` result', async () => {\n    const debouncer = debounce(identity(), { waitMs: 32, timing: 'leading' });\n\n    expect([debouncer.call('a'), debouncer.call('b')]).toStrictEqual([\n      'a',\n      'a',\n    ]);\n\n    await sleep(64);\n\n    expect([debouncer.call('c'), debouncer.call('d')]).toStrictEqual([\n      'c',\n      'c',\n    ]);\n  });\n\n  it('should support a `trailing` option', async () => {\n    const mockFn = vi.fn<() => void>();\n    const withTrailing = debounce(mockFn, { waitMs: 32, timing: 'trailing' });\n    withTrailing.call();\n\n    expect(mockFn).toHaveBeenCalledTimes(0);\n\n    await sleep(64);\n\n    expect(mockFn).toHaveBeenCalledTimes(1);\n  });\n});\n\ndescribe('optional param maxWaitMs', () => {\n  it('should support a `maxWait` option', async () => {\n    const mockFn = vi.fn<(x: string) => void>();\n    const debouncer = debounce(mockFn, { waitMs: 32, maxWaitMs: 64 });\n    debouncer.call('a');\n    debouncer.call('b');\n\n    expect(mockFn).toHaveBeenCalledTimes(0);\n\n    await sleep(128);\n\n    expect(mockFn).toHaveBeenCalledTimes(1);\n\n    debouncer.call('c');\n    debouncer.call('d');\n\n    expect(mockFn).toHaveBeenCalledTimes(1);\n\n    await sleep(256);\n\n    expect(mockFn).toHaveBeenCalledTimes(2);\n  });\n\n  it('should support `maxWait` in a tight loop', async () => {\n    const withMockFn = vi.fn<() => void>();\n    const withoutMockFn = vi.fn<() => void>();\n    const withMaxWait = debounce(withMockFn, { waitMs: 32, maxWaitMs: 128 });\n    const withoutMaxWait = debounce(withoutMockFn, { waitMs: 96 });\n    const start = Date.now();\n    while (Date.now() - start < 320) {\n      withMaxWait.call();\n      withoutMaxWait.call();\n    }\n    await sleep(1);\n\n    expect(withoutMockFn).toHaveBeenCalledTimes(0);\n    expect(withMockFn).not.toHaveBeenCalledTimes(0);\n  });\n\n  it('should queue a trailing call for subsequent debounced calls after `maxWait`', async () => {\n    const mockFn = vi.fn<() => void>();\n    const debouncer = debounce(mockFn, { waitMs: 200, maxWaitMs: 200 });\n    debouncer.call();\n    setTimeout(() => {\n      debouncer.call();\n    }, 190);\n    setTimeout(() => {\n      debouncer.call();\n    }, 200);\n    setTimeout(() => {\n      debouncer.call();\n    }, 210);\n    await sleep(500);\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 debouncer = debounce(mockFn, { waitMs: 32, maxWaitMs: 64 });\n    debouncer.call();\n    await sleep(128);\n    debouncer.call();\n\n    expect(mockFn).toHaveBeenCalledTimes(1);\n\n    await sleep(192);\n\n    expect(mockFn).toHaveBeenCalledTimes(2);\n  });\n\n  it('works like a leaky bucket when only maxWaitMs is set', async () => {\n    const mockFn = vi.fn<() => void>();\n    const debouncer = debounce(mockFn, { maxWaitMs: 32 });\n    debouncer.call();\n\n    expect(mockFn).toHaveBeenCalledTimes(0);\n\n    await sleep(16);\n    // Without maxWaitMs this call would cause the actual invocation to be\n    // postponed for a full window.\n    debouncer.call();\n\n    expect(mockFn).toHaveBeenCalledTimes(0);\n\n    await sleep(17);\n\n    expect(mockFn).toHaveBeenCalledTimes(1);\n  });\n});\n\ndescribe('additional functionality', () => {\n  it('can cancel before the timer starts', async () => {\n    const debouncer = debounce(identity(), { waitMs: 32 });\n\n    expect(() => {\n      debouncer.cancel();\n    }).not.toThrowError();\n    expect(debouncer.call('hello')).toBeUndefined();\n\n    await sleep(32);\n\n    expect(debouncer.call('world')).toBe('hello');\n  });\n\n  it('can cancel the timer', async () => {\n    const mockFn = vi.fn<() => string>(constant('Hello, World!'));\n    const debouncer = debounce(mockFn, { waitMs: 32 });\n\n    expect(debouncer.call()).toBeUndefined();\n    expect(mockFn).toHaveBeenCalledTimes(0);\n\n    await sleep(1);\n\n    expect(debouncer.call()).toBeUndefined();\n    expect(mockFn).toHaveBeenCalledTimes(0);\n\n    debouncer.cancel();\n    await sleep(32);\n\n    expect(debouncer.call()).toBeUndefined();\n    expect(mockFn).toHaveBeenCalledTimes(0);\n\n    await sleep(32);\n\n    expect(debouncer.call()).toBe('Hello, World!');\n    expect(mockFn).toHaveBeenCalledTimes(1);\n  });\n\n  it('can cancel after the timer ends', async () => {\n    const debouncer = debounce(identity(), { waitMs: 32 });\n\n    expect(debouncer.call('hello')).toBeUndefined();\n\n    await sleep(32);\n\n    expect(debouncer.call('world')).toBe('hello');\n    expect(() => {\n      debouncer.cancel();\n    }).not.toThrowError();\n  });\n\n  it('can cancel maxWait timer', async () => {\n    const debouncer = debounce(identity(), { waitMs: 16, maxWaitMs: 32 });\n\n    expect(debouncer.call('hello')).toBeUndefined();\n\n    await sleep(1);\n    debouncer.cancel();\n    await sleep(32);\n\n    expect(debouncer.call('world')).toBeUndefined();\n  });\n\n  it('can return a cached value', () => {\n    const debouncer = debounce(identity(), { timing: 'leading', waitMs: 32 });\n\n    expect(debouncer.cachedValue).toBeUndefined();\n    expect(debouncer.call('hello')).toBe('hello');\n    expect(debouncer.cachedValue).toBe('hello');\n  });\n\n  it('can check for inflight timers (trailing)', async () => {\n    const debouncer = debounce(identity(), { waitMs: 32 });\n\n    expect(debouncer.isPending).toBe(false);\n    expect(debouncer.call('hello')).toBeUndefined();\n    expect(debouncer.isPending).toBe(true);\n\n    await sleep(1);\n\n    expect(debouncer.isPending).toBe(true);\n\n    await sleep(32);\n\n    expect(debouncer.isPending).toBe(false);\n  });\n\n  it('can check for inflight timers (leading)', async () => {\n    const debouncer = debounce(identity(), { timing: 'leading', waitMs: 32 });\n\n    expect(debouncer.isPending).toBe(false);\n    expect(debouncer.call('hello')).toBe('hello');\n    expect(debouncer.isPending).toBe(true);\n\n    await sleep(1);\n\n    expect(debouncer.isPending).toBe(true);\n\n    await sleep(32);\n\n    expect(debouncer.isPending).toBe(false);\n  });\n\n  it('can flush before a cool-down', async () => {\n    const debouncer = debounce(identity(), { waitMs: 32 });\n\n    expect(debouncer.flush()).toBeUndefined();\n    expect(debouncer.call('hello')).toBeUndefined();\n\n    await sleep(32);\n\n    expect(debouncer.call('world')).toBe('hello');\n  });\n\n  it('can flush during a cool-down', async () => {\n    const debouncer = debounce(identity(), { waitMs: 32 });\n\n    expect(debouncer.call('hello')).toBeUndefined();\n\n    await sleep(1);\n\n    expect(debouncer.call('world')).toBeUndefined();\n\n    await sleep(1);\n\n    expect(debouncer.flush()).toBe('world');\n  });\n\n  it('can flush after a cool-down', async () => {\n    const debouncer = debounce(identity(), { waitMs: 32 });\n\n    expect(debouncer.call('hello')).toBeUndefined();\n\n    await sleep(32);\n\n    expect(debouncer.flush()).toBe('hello');\n  });\n});\n\ndescribe('errors', () => {\n  it('prevents maxWaitMs to be less then waitMs', () => {\n    expect(() => debounce(identity(), { waitMs: 32, maxWaitMs: 16 })).toThrowError(\n      'debounce: maxWaitMs (16) cannot be less than waitMs (32)',\n    );\n  });\n});\n"],"mappings":"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"}

package/dist/funnel.reference-batch.test.cjs

@@ -1 +0,0 @@
-const e=require(`./dist-8XtUY3ad.cjs`),t=require(`./do-nothing.cjs`),n=require(`./from-keys.cjs`),r=require(`./funnel.cjs`);function i(e,t,n=0){let i=r.funnel(n=>{e(n.map(({params:e})=>e)).then(e=>{for(let[r,{params:i,promiseCallbacks:[a]}]of n.entries())a(t(e,r,...i))}).catch(e=>{for(let{promiseCallbacks:[,t]}of n)t(e)})},{reducer:(e,t)=>[...e??[],t],maxBurstDurationMs:n,triggerAt:`end`});return{...i,call:async(...e)=>new Promise((...t)=>{i.call({promiseCallbacks:t,params:e})})}}e.i(`showcase`,()=>{e.a(`results as object`,async()=>{let t=e.r.fn(async e=>n.fromKeys(e,e=>e.length)),r=i(async e=>await t(e.flat()),(e,t,n)=>e[n]),a=[r.call(`short`),r.call(`medium`),r.call(`loooooooooooooong`)];e.n(t).toHaveBeenCalledTimes(0);let[o,s,c]=await Promise.all(a);e.n(t).toHaveBeenCalledTimes(1),e.n(t).toHaveBeenLastCalledWith([`short`,`medium`,`loooooooooooooong`]),e.n(t).toHaveLastResolvedWith({short:5,medium:6,loooooooooooooong:17}),e.n(o).toBe(5),e.n(s).toBe(6),e.n(c).toBe(17)}),e.a(`results as array`,async()=>{let t=e.r.fn(async e=>e.map(e=>e.length)),n=i(async e=>await t(e.flat()),(e,t)=>e[t]),r=[n.call(`short`),n.call(`medium`),n.call(`loooooooooooooong`)];e.n(t).toHaveBeenCalledTimes(0);let[a,o,s]=await Promise.all(r);e.n(t).toHaveBeenCalledTimes(1),e.n(t).toHaveBeenLastCalledWith([`short`,`medium`,`loooooooooooooong`]),e.n(t).toHaveLastResolvedWith([5,6,17]),e.n(a).toBe(5),e.n(o).toBe(6),e.n(s).toBe(17)}),e.a(`error handling`,async()=>{let n=i(async e=>{if(e.length>1)throw Error(`Batch too big! ${JSON.stringify(e)}`)},t.doNothing());await e.n(n.call(`a`)).resolves.toBeUndefined(),await e.n(Promise.all([n.call(`hello`),n.call(`world`)])).rejects.toThrowError(`Batch too big! [["hello"],["world"]]`)})});

package/dist/funnel.reference-batch.test.d.cts

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

package/dist/funnel.reference-batch.test.d.ts

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

package/dist/funnel.reference-batch.test.js

@@ -1,2 +0,0 @@
-import{doNothing as e}from"./do-nothing.js";import{fromKeys as t}from"./from-keys.js";import{a as n,i as r,n as i,r as a}from"./dist-Bd1vawFi.js";import{funnel as o}from"./funnel.js";function s(e,t,n=0){let r=o(n=>{e(n.map(({params:e})=>e)).then(e=>{for(let[r,{params:i,promiseCallbacks:[a]}]of n.entries())a(t(e,r,...i))}).catch(e=>{for(let{promiseCallbacks:[,t]}of n)t(e)})},{reducer:(e,t)=>[...e??[],t],maxBurstDurationMs:n,triggerAt:`end`});return{...r,call:async(...e)=>new Promise((...t)=>{r.call({promiseCallbacks:t,params:e})})}}r(`showcase`,()=>{n(`results as object`,async()=>{let e=a.fn(async e=>t(e,e=>e.length)),n=s(async t=>await e(t.flat()),(e,t,n)=>e[n]),r=[n.call(`short`),n.call(`medium`),n.call(`loooooooooooooong`)];i(e).toHaveBeenCalledTimes(0);let[o,c,l]=await Promise.all(r);i(e).toHaveBeenCalledTimes(1),i(e).toHaveBeenLastCalledWith([`short`,`medium`,`loooooooooooooong`]),i(e).toHaveLastResolvedWith({short:5,medium:6,loooooooooooooong:17}),i(o).toBe(5),i(c).toBe(6),i(l).toBe(17)}),n(`results as array`,async()=>{let e=a.fn(async e=>e.map(e=>e.length)),t=s(async t=>await e(t.flat()),(e,t)=>e[t]),n=[t.call(`short`),t.call(`medium`),t.call(`loooooooooooooong`)];i(e).toHaveBeenCalledTimes(0);let[r,o,c]=await Promise.all(n);i(e).toHaveBeenCalledTimes(1),i(e).toHaveBeenLastCalledWith([`short`,`medium`,`loooooooooooooong`]),i(e).toHaveLastResolvedWith([5,6,17]),i(r).toBe(5),i(o).toBe(6),i(c).toBe(17)}),n(`error handling`,async()=>{let t=s(async e=>{if(e.length>1)throw Error(`Batch too big! ${JSON.stringify(e)}`)},e());await i(t.call(`a`)).resolves.toBeUndefined(),await i(Promise.all([t.call(`hello`),t.call(`world`)])).rejects.toThrowError(`Batch too big! [["hello"],["world"]]`)})});
-//# sourceMappingURL=funnel.reference-batch.test.js.map

package/dist/funnel.reference-batch.test.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"funnel.reference-batch.test.js","names":["expect"],"sources":["../src/funnel.reference-batch.test.ts"],"sourcesContent":["/* eslint-disable ts/explicit-function-return-type,  ts/no-explicit-any --\n * These aren't useful for a reference implementation!\n */\n\nimport { describe, expect, it, vi } from 'vitest';\nimport { doNothing } from './do-nothing';\nimport { fromKeys } from './from-keys';\nimport { funnel } from './funnel';\n\ninterface BatchRequest<Params extends Array<any>, Result> {\n  readonly params: Params;\n  readonly promiseCallbacks: Readonly<\n    Parameters<ConstructorParameters<typeof Promise<Result>>[0]>\n  >;\n}\n\n/**\n * A reference implementation for an async batching utility function built on\n * top of the `funnel` general purpose execution utility function. It will\n * accumulate all params passed to an async `call` method within the defined\n * burst duration and then use an async executor to process them in one\n * invocation. It then extracts an individual result for each call which is\n * used to resolve the original call.\n *\n * This allows synchronizing multiple async calls while keeping each call site\n * isolated from the rest (for example, as react components).\n *\n * This reference implementation can be copied into your project as-is, or you\n * can use it as the basis for a more complex implementation with additional\n * features.\n *\n * @param callback - The main function that takes a batch and returns an\n * aggregated response. The typing for the it's parameters will derive the\n * typing for the extractor and the `call` method.\n * @param extractor - A function that takes the aggregated response and extracts\n * from it the result for each individual call. The function is called with both\n * the index in the batch, and the params passed to the `call` method. This\n * allows handling APIs that return batch results as both objects and arrays.\n * @param maxBurstDurationMs - The period of time where the batcher would\n * collect params before triggering the executor. When set to 0 the batcher\n * does not incur any additional delays to the execution and would trigger at\n * the next tick, just like a regular async function would. This is also the\n * default value.\n * @returns A Funnel object with the `call` method augmented to support async\n * response.\n */\nfunction batch<Params extends Array<any>, BatchResponse, Result>(\n  callback: (requests: ReadonlyArray<Params>) => Promise<BatchResponse>,\n  extractor: (\n    response: BatchResponse,\n    index: number,\n    ...params: Params\n  ) => Result,\n  maxBurstDurationMs = 0,\n) {\n  const batchFunnel = funnel(\n    // Passes all accumulated parameters to the callback and then extracts the response for each individual call via the extractor.\n    (requests: ReadonlyArray<BatchRequest<Params, Result>>) => {\n      callback(requests.map(({ params }) => params))\n        // On success we iterate again over all calls and allow the extractor to pull a value out of the aggregated response for each one.\n        .then((response) => {\n          for (const [\n            index,\n            {\n              params,\n              promiseCallbacks: [resolve],\n            },\n          ] of requests.entries()) {\n            const result = extractor(response, index, ...params);\n            resolve(result);\n          }\n        })\n\n        // On error we simply pass the error along to all reject callbacks.\n        .catch((error) => {\n          for (const {\n            promiseCallbacks: [, reject],\n          } of requests) {\n            reject(error);\n          }\n        });\n    },\n    {\n      // Reducer: Accumulates the parameters for each call, together with the promise executor callbacks needed to resolve or reject the call.\n      reducer: (requests, request: BatchRequest<Params, Result>) => [\n        ...(requests ?? []),\n        request,\n      ],\n      maxBurstDurationMs,\n      triggerAt: 'end',\n    },\n  );\n\n  return {\n    ...batchFunnel,\n\n    call: async (...params: Params) =>\n      new Promise<Result>((...promiseCallbacks) => {\n        batchFunnel.call({ promiseCallbacks, params });\n      }),\n  };\n}\n\ndescribe('showcase', () => {\n  it('results as object', async () => {\n    const mockApi = vi.fn<\n      (words: ReadonlyArray<string>) => Promise<Record<string, number>>\n    >(async (words) => fromKeys(words, (word) => word.length));\n\n    const countLettersApi = batch(\n      // We only need to type the `requests` param of the `executor` callback.\n      // All other types are derived from it.\n      async (requests: ReadonlyArray<[word: string]>) =>\n        await mockApi(requests.flat()),\n      (response, _, word) => response[word],\n    );\n\n    const prepared = [\n      countLettersApi.call('short'),\n      countLettersApi.call('medium'),\n      countLettersApi.call('loooooooooooooong'),\n    ];\n\n    expect(mockApi).toHaveBeenCalledTimes(0);\n\n    const [shortResult, mediumResult, longResult] = await Promise.all(prepared);\n\n    expect(mockApi).toHaveBeenCalledTimes(1);\n    expect(mockApi).toHaveBeenLastCalledWith([\n      'short',\n      'medium',\n      'loooooooooooooong',\n    ]);\n    expect(mockApi).toHaveLastResolvedWith({\n      short: 5,\n      medium: 6,\n      loooooooooooooong: 17,\n    });\n    expect(shortResult).toBe(5);\n    expect(mediumResult).toBe(6);\n    expect(longResult).toBe(17);\n  });\n\n  it('results as array', async () => {\n    const mockApi = vi.fn<\n      (words: ReadonlyArray<string>) => Promise<ReadonlyArray<number>>\n    >(async (words) => words.map((word) => word.length));\n\n    const countLettersApi = batch(\n      // We only need to type the `requests` param of the `executor` callback.\n      // All other types are derived from it.\n      async (requests: ReadonlyArray<[word: string]>) =>\n        await mockApi(requests.flat()),\n      (response, index) => response[index],\n    );\n\n    const prepared = [\n      countLettersApi.call('short'),\n      countLettersApi.call('medium'),\n      countLettersApi.call('loooooooooooooong'),\n    ];\n\n    expect(mockApi).toHaveBeenCalledTimes(0);\n\n    const [shortResult, mediumResult, longResult] = await Promise.all(prepared);\n\n    expect(mockApi).toHaveBeenCalledTimes(1);\n    expect(mockApi).toHaveBeenLastCalledWith([\n      'short',\n      'medium',\n      'loooooooooooooong',\n    ]);\n    expect(mockApi).toHaveLastResolvedWith([5, 6, 17]);\n    expect(shortResult).toBe(5);\n    expect(mediumResult).toBe(6);\n    expect(longResult).toBe(17);\n  });\n\n  it('error handling', async () => {\n    const failingApi = batch(\n      // We only need to type the `requests` param of the `executor` callback.\n      // All other types are derived from it.\n      async (requests: ReadonlyArray<[id: string]>) => {\n        if (requests.length > 1) {\n          throw new Error(`Batch too big! ${JSON.stringify(requests)}`);\n        }\n      },\n      doNothing(),\n    );\n\n    await expect(failingApi.call('a')).resolves.toBeUndefined();\n\n    await expect(\n      Promise.all([failingApi.call('hello'), failingApi.call('world')]),\n    ).rejects.toThrowError('Batch too big! [[\"hello\"],[\"world\"]]');\n  });\n});\n"],"mappings":"uLA8CA,SAAS,EACP,EACA,EAKA,EAAqB,EACrB,CACA,IAAM,EAAc,EAEjB,GAA0D,CACzD,EAAS,EAAS,KAAK,CAAE,YAAa,EAAO,CAAC,CAE3C,KAAM,GAAa,CAClB,IAAK,GAAM,CACT,EACA,CACE,SACA,iBAAkB,CAAC,OAElB,EAAS,SAAS,CAErB,EADe,EAAU,EAAU,EAAO,GAAG,EAAO,CACrC,EAEjB,CAGD,MAAO,GAAU,CAChB,IAAK,GAAM,CACT,iBAAkB,EAAG,MAClB,EACH,EAAO,EAAM,EAEf,EAEN,CAEE,SAAU,EAAU,IAA0C,CAC5D,GAAI,GAAY,EAAE,CAClB,EACD,CACD,qBACA,UAAW,MACZ,CACF,CAED,MAAO,CACL,GAAG,EAEH,KAAM,MAAO,GAAG,IACd,IAAI,SAAiB,GAAG,IAAqB,CAC3C,EAAY,KAAK,CAAE,mBAAkB,SAAQ,CAAC,EAC9C,CACL,CAGH,EAAS,eAAkB,CACzB,EAAG,oBAAqB,SAAY,CAClC,IAAM,EAAU,EAAG,GAEjB,KAAO,IAAU,EAAS,EAAQ,GAAS,EAAK,OAAO,CAAC,CAEpD,EAAkB,EAGtB,KAAO,IACL,MAAM,EAAQ,EAAS,MAAM,CAAC,EAC/B,EAAU,EAAG,IAAS,EAAS,GACjC,CAEK,EAAW,CACf,EAAgB,KAAK,QAAQ,CAC7B,EAAgB,KAAK,SAAS,CAC9B,EAAgB,KAAK,oBAAoB,CAC1C,CAED,EAAO,EAAQ,CAAC,sBAAsB,EAAE,CAExC,GAAM,CAAC,EAAa,EAAc,GAAc,MAAM,QAAQ,IAAI,EAAS,CAE3E,EAAO,EAAQ,CAAC,sBAAsB,EAAE,CACxC,EAAO,EAAQ,CAAC,yBAAyB,CACvC,QACA,SACA,oBACD,CAAC,CACF,EAAO,EAAQ,CAAC,uBAAuB,CACrC,MAAO,EACP,OAAQ,EACR,kBAAmB,GACpB,CAAC,CACF,EAAO,EAAY,CAAC,KAAK,EAAE,CAC3B,EAAO,EAAa,CAAC,KAAK,EAAE,CAC5B,EAAO,EAAW,CAAC,KAAK,GAAG,EAC3B,CAEF,EAAG,mBAAoB,SAAY,CACjC,IAAM,EAAU,EAAG,GAEjB,KAAO,IAAU,EAAM,IAAK,GAAS,EAAK,OAAO,CAAC,CAE9C,EAAkB,EAGtB,KAAO,IACL,MAAM,EAAQ,EAAS,MAAM,CAAC,EAC/B,EAAU,IAAU,EAAS,GAC/B,CAEK,EAAW,CACf,EAAgB,KAAK,QAAQ,CAC7B,EAAgB,KAAK,SAAS,CAC9B,EAAgB,KAAK,oBAAoB,CAC1C,CAED,EAAO,EAAQ,CAAC,sBAAsB,EAAE,CAExC,GAAM,CAAC,EAAa,EAAc,GAAc,MAAM,QAAQ,IAAI,EAAS,CAE3E,EAAO,EAAQ,CAAC,sBAAsB,EAAE,CACxC,EAAO,EAAQ,CAAC,yBAAyB,CACvC,QACA,SACA,oBACD,CAAC,CACF,EAAO,EAAQ,CAAC,uBAAuB,CAAC,EAAG,EAAG,GAAG,CAAC,CAClD,EAAO,EAAY,CAAC,KAAK,EAAE,CAC3B,EAAO,EAAa,CAAC,KAAK,EAAE,CAC5B,EAAO,EAAW,CAAC,KAAK,GAAG,EAC3B,CAEF,EAAG,iBAAkB,SAAY,CAC/B,IAAM,EAAa,EAGjB,KAAO,IAA0C,CAC/C,GAAI,EAAS,OAAS,EACpB,MAAU,MAAM,kBAAkB,KAAK,UAAU,EAAS,GAAG,EAGjE,GAAW,CACZ,CAED,MAAMA,EAAO,EAAW,KAAK,IAAI,CAAC,CAAC,SAAS,eAAe,CAE3D,MAAMA,EACJ,QAAQ,IAAI,CAAC,EAAW,KAAK,QAAQ,CAAE,EAAW,KAAK,QAAQ,CAAC,CAAC,CAClE,CAAC,QAAQ,aAAa,uCAAuC,EAC9D,EACF"}

package/dist/funnel.test-d.cjs

@@ -1 +0,0 @@
-const e=require(`./dist-8XtUY3ad.cjs`),t=require(`./do-nothing.cjs`),n=require(`./funnel.cjs`);e.i(`'call' method args`,()=>{e.a(`no args`,()=>{(0,e.t.expectTypeOf)(n.funnel(t.doNothing(),{reducer:e=>`test`,triggerAt:`start`}).call).parameters.toEqualTypeOf()}),e.a(`non-optional args`,()=>{(0,e.t.expectTypeOf)(n.funnel(t.doNothing(),{reducer:(e,t,n,r)=>`test`,triggerAt:`start`}).call).parameters.toEqualTypeOf()}),e.a(`optional args`,()=>{(0,e.t.expectTypeOf)(n.funnel(t.doNothing(),{reducer:(e,t)=>`test`,triggerAt:`start`}).call).parameters.toEqualTypeOf()}),e.a(`rest args`,()=>{(0,e.t.expectTypeOf)(n.funnel(t.doNothing(),{reducer:(e,...t)=>`test`,triggerAt:`start`}).call).parameters.toEqualTypeOf()})}),e.i(`derive the reducer accumulator type from the executor param`,()=>{e.a(`simple types`,()=>{n.funnel(e=>{},{reducer:t=>((0,e.t.expectTypeOf)(t).toEqualTypeOf(),t),triggerAt:`start`})}),e.a(`arrays`,()=>{n.funnel(e=>{},{reducer:t=>((0,e.t.expectTypeOf)(t).toEqualTypeOf(),t),triggerAt:`start`})}),e.a(`objects`,()=>{n.funnel(e=>{},{reducer:t=>((0,e.t.expectTypeOf)(t).toEqualTypeOf(),t),triggerAt:`start`})})}),e.i(`prevent bad options`,()=>{e.a(`minGapMs cannot be the only option with timing: end`,()=>{n.funnel(t.doNothing(),{minGapMs:100}),n.funnel(t.doNothing(),{triggerAt:`end`,minGapMs:100}),n.funnel(t.doNothing(),{triggerAt:`start`,minGapMs:100}),n.funnel(t.doNothing(),{triggerAt:`both`,minGapMs:100})})});

package/dist/funnel.test-d.d.cts

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

package/dist/funnel.test-d.d.ts

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

package/dist/funnel.test-d.js

@@ -1,2 +0,0 @@
-import{doNothing as e}from"./do-nothing.js";import{a as t,i as n,t as r}from"./dist-Bd1vawFi.js";import{funnel as i}from"./funnel.js";n(`'call' method args`,()=>{t(`no args`,()=>{r(i(e(),{reducer:e=>`test`,triggerAt:`start`}).call).parameters.toEqualTypeOf()}),t(`non-optional args`,()=>{r(i(e(),{reducer:(e,t,n,r)=>`test`,triggerAt:`start`}).call).parameters.toEqualTypeOf()}),t(`optional args`,()=>{r(i(e(),{reducer:(e,t)=>`test`,triggerAt:`start`}).call).parameters.toEqualTypeOf()}),t(`rest args`,()=>{r(i(e(),{reducer:(e,...t)=>`test`,triggerAt:`start`}).call).parameters.toEqualTypeOf()})}),n(`derive the reducer accumulator type from the executor param`,()=>{t(`simple types`,()=>{i(e=>{},{reducer:e=>(r(e).toEqualTypeOf(),e),triggerAt:`start`})}),t(`arrays`,()=>{i(e=>{},{reducer:e=>(r(e).toEqualTypeOf(),e),triggerAt:`start`})}),t(`objects`,()=>{i(e=>{},{reducer:e=>(r(e).toEqualTypeOf(),e),triggerAt:`start`})})}),n(`prevent bad options`,()=>{t(`minGapMs cannot be the only option with timing: end`,()=>{i(e(),{minGapMs:100}),i(e(),{triggerAt:`end`,minGapMs:100}),i(e(),{triggerAt:`start`,minGapMs:100}),i(e(),{triggerAt:`both`,minGapMs:100})})});
-//# sourceMappingURL=funnel.test-d.js.map

package/dist/funnel.test-d.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"funnel.test-d.js","names":[],"sources":["../src/funnel.test-d.ts"],"sourcesContent":["/* eslint-disable ts/no-unused-vars -- We just want to build types, we don't care about using the params... */\n\nimport { describe, expectTypeOf, it } from 'vitest';\nimport { doNothing } from './do-nothing';\nimport { funnel } from './funnel';\n\ndescribe('\\'call\\' method args', () => {\n  it('no args', () => {\n    const foo = funnel(doNothing(), {\n      reducer: (_: 'test' | undefined) => 'test' as const,\n      triggerAt: 'start',\n    });\n\n    expectTypeOf(foo.call).parameters.toEqualTypeOf<[]>();\n  });\n\n  it('non-optional args', () => {\n    const foo = funnel(doNothing(), {\n      // @ts-expect-error [ts(6133)] -- We want to use explicit names, not prefixed with _\n      reducer: (_: 'test' | undefined, a: string, b: number, c: boolean) =>\n        'test' as const,\n\n      triggerAt: 'start',\n    });\n\n    expectTypeOf(foo.call).parameters.toEqualTypeOf<\n      [a: string, b: number, c: boolean]\n    >();\n  });\n\n  it('optional args', () => {\n    const foo = funnel(doNothing(), {\n      // @ts-expect-error [ts(6133)] -- We want to use explicit names, not prefixed with _\n      reducer: (_: 'test' | undefined, a?: string) => 'test' as const,\n      triggerAt: 'start',\n    });\n\n    expectTypeOf(foo.call).parameters.toEqualTypeOf<[a?: string | undefined]>();\n  });\n\n  it('rest args', () => {\n    const foo = funnel(doNothing(), {\n      reducer:\n        // @ts-expect-error [ts(6133)] -- We want to use explicit names, not prefixed with _\n        (_: 'test' | undefined, ...as: Array<string>) => 'test' as const,\n\n      triggerAt: 'start',\n    });\n\n    expectTypeOf(foo.call).parameters.toEqualTypeOf<Array<string>>();\n  });\n});\n\ndescribe('derive the reducer accumulator type from the executor param', () => {\n  it('simple types', () => {\n    funnel(\n      (_: number) => {\n        // do nothing\n      },\n      {\n        reducer: (reduced) => {\n          expectTypeOf(reduced).toEqualTypeOf<number | undefined>();\n\n          return reduced!;\n        },\n        triggerAt: 'start',\n      },\n    );\n  });\n\n  it('arrays', () => {\n    funnel(\n      (_: ReadonlyArray<number>) => {\n        // do nothing,\n      },\n      {\n        reducer: (reduced) => {\n          expectTypeOf(reduced).toEqualTypeOf<\n            ReadonlyArray<number> | undefined\n          >();\n\n          return reduced!;\n        },\n        triggerAt: 'start',\n      },\n    );\n  });\n\n  it('objects', () => {\n    funnel(\n      (_: { readonly a: number }) => {\n        // do nothing\n      },\n      {\n        reducer: (reduced) => {\n          expectTypeOf(reduced).toEqualTypeOf<\n            { readonly a: number } | undefined\n          >();\n\n          return reduced!;\n        },\n        triggerAt: 'start',\n      },\n    );\n  });\n});\n\ndescribe('prevent bad options', () => {\n  it('minGapMs cannot be the only option with timing: end', () => {\n    funnel(\n      doNothing(),\n      // @ts-expect-error [ts(2345)] -- minGapMs cannot be set alone]\n      { minGapMs: 100 },\n    );\n\n    funnel(\n      doNothing(),\n      // @ts-expect-error [ts(2345)] -- minGapMs cannot be set alone]\n      { triggerAt: 'end', minGapMs: 100 },\n    );\n\n    // But it works with \"start\" and \"both\"\n\n    funnel(doNothing(), { triggerAt: 'start', minGapMs: 100 });\n    funnel(doNothing(), { triggerAt: 'both', minGapMs: 100 });\n  });\n});\n"],"mappings":"sIAMA,EAAS,yBAA8B,CACrC,EAAG,cAAiB,CAMlB,EALY,EAAO,GAAW,CAAE,CAC9B,QAAU,GAA0B,OACpC,UAAW,QACZ,CAAC,CAEe,KAAK,CAAC,WAAW,eAAmB,EACrD,CAEF,EAAG,wBAA2B,CAS5B,EARY,EAAO,GAAW,CAAE,CAE9B,SAAU,EAAuB,EAAW,EAAW,IACrD,OAEF,UAAW,QACZ,CAAC,CAEe,KAAK,CAAC,WAAW,eAE/B,EACH,CAEF,EAAG,oBAAuB,CAOxB,EANY,EAAO,GAAW,CAAE,CAE9B,SAAU,EAAuB,IAAe,OAChD,UAAW,QACZ,CAAC,CAEe,KAAK,CAAC,WAAW,eAAyC,EAC3E,CAEF,EAAG,gBAAmB,CASpB,EARY,EAAO,GAAW,CAAE,CAC9B,SAEG,EAAuB,GAAG,IAAsB,OAEnD,UAAW,QACZ,CAAC,CAEe,KAAK,CAAC,WAAW,eAA8B,EAChE,EACF,CAEF,EAAS,kEAAqE,CAC5E,EAAG,mBAAsB,CACvB,EACG,GAAc,GAGf,CACE,QAAU,IACR,EAAa,EAAQ,CAAC,eAAmC,CAElD,GAET,UAAW,QACZ,CACF,EACD,CAEF,EAAG,aAAgB,CACjB,EACG,GAA6B,GAG9B,CACE,QAAU,IACR,EAAa,EAAQ,CAAC,eAEnB,CAEI,GAET,UAAW,QACZ,CACF,EACD,CAEF,EAAG,cAAiB,CAClB,EACG,GAA8B,GAG/B,CACE,QAAU,IACR,EAAa,EAAQ,CAAC,eAEnB,CAEI,GAET,UAAW,QACZ,CACF,EACD,EACF,CAEF,EAAS,0BAA6B,CACpC,EAAG,0DAA6D,CAC9D,EACE,GAAW,CAEX,CAAE,SAAU,IAAK,CAClB,CAED,EACE,GAAW,CAEX,CAAE,UAAW,MAAO,SAAU,IAAK,CACpC,CAID,EAAO,GAAW,CAAE,CAAE,UAAW,QAAS,SAAU,IAAK,CAAC,CAC1D,EAAO,GAAW,CAAE,CAAE,UAAW,OAAQ,SAAU,IAAK,CAAC,EACzD,EACF"}

package/dist/funnel.test.cjs

@@ -1 +0,0 @@
-const e=require(`./dist-8XtUY3ad.cjs`),t=require(`./constant.cjs`),n=require(`./do-nothing.cjs`),r=require(`./funnel.cjs`),i=require(`./sleep.cjs`),a=16;function o(e,t){return e===void 0?[t]:[...e,t]}e.i(`reducer behavior`,()=>{e.a(`passes the reduced arg to the executor`,()=>{let n=e.r.fn();r.funnel(n,{reducer:t.constant(`hello world`),triggerAt:`start`,minQuietPeriodMs:16}).call(),e.n(n).toHaveBeenCalledTimes(1),e.n(n).toHaveBeenLastCalledWith(`hello world`)}),e.a(`reduces call args`,async()=>{let t=e.r.fn(e=>{}),n=r.funnel(t,{reducer:(e,t)=>(e??0)+t,minQuietPeriodMs:32,triggerAt:`end`});n.call(1),n.call(2),n.call(3),await i.sleep(16),n.call(4),n.call(5),n.call(6),await i.sleep(32),e.n(t).toHaveBeenCalledTimes(1),e.n(t).toHaveBeenLastCalledWith(21)}),e.a(`does not invoke if reduceArgs returns undefined`,async()=>{let n=e.r.fn();r.funnel(n,{reducer:t.constant(void 0),triggerAt:`end`,minQuietPeriodMs:16}).call(),await i.sleep(32),e.n(n).toHaveBeenCalledTimes(0)}),e.a(`supports multiple arguments`,()=>{let t=e.r.fn();r.funnel(t,{reducer:(e,t,n,r)=>[e,t,n,r],triggerAt:`start`,minQuietPeriodMs:16}).call(1,`a`,!0),e.n(t).toHaveBeenCalledTimes(1),e.n(t).toHaveBeenLastCalledWith([void 0,1,`a`,!0])}),e.a(`reducer isn't called again when 'invokedAt: start'`,async()=>{let t=e.r.fn(o),a=r.funnel(n.doNothing(),{reducer:t,triggerAt:`start`,minQuietPeriodMs:16});a.call(`a`),e.n(t).toHaveBeenCalledTimes(1),e.n(t).toHaveBeenLastCalledWith(void 0,`a`),a.call(`b`),a.call(`c`),e.n(t).toHaveBeenCalledTimes(1),await i.sleep(32),e.n(t).toHaveBeenCalledTimes(1)})}),e.i(`non-trivial (>0ms) timer duration`,()=>{e.i(`delay timer`,()=>{e.a(`invokedAt: start`,async()=>{let t=e.r.fn(),n=r.funnel(t,{reducer:o,triggerAt:`start`,minGapMs:16});n.call(`a`),n.call(`b`),n.call(`c`),e.n(t).toHaveBeenCalledTimes(1),e.n(t).toHaveBeenLastCalledWith([`a`]),await i.sleep(16),e.n(t).toHaveBeenCalledTimes(1),n.call(`d`),e.n(t).toHaveBeenCalledTimes(2),e.n(t).toHaveBeenLastCalledWith([`d`])}),e.a(`invokedAt: both`,async()=>{let t=e.r.fn(),n=r.funnel(t,{reducer:o,triggerAt:`both`,minGapMs:16});n.call(`a`),n.call(`b`),n.call(`c`),e.n(t).toHaveBeenCalledTimes(1),e.n(t).toHaveBeenLastCalledWith([`a`]),await i.sleep(16),e.n(t).toHaveBeenCalledTimes(2),e.n(t).toHaveBeenLastCalledWith([`b`,`c`]),n.call(`d`),n.call(`e`),n.call(`f`),e.n(t).toHaveBeenCalledTimes(2),await i.sleep(16),e.n(t).toHaveBeenCalledTimes(3),e.n(t).toHaveBeenLastCalledWith([`d`,`e`,`f`])}),e.a(`invocations in the middle of a window`,async()=>{let t=e.r.fn(),n=r.funnel(t,{reducer:o,triggerAt:`both`,minGapMs:16});n.call(`a`),n.call(`b`),n.call(`c`),e.n(t).toHaveBeenCalledTimes(1),e.n(t).toHaveBeenLastCalledWith([`a`]),await i.sleep(.75*16),n.call(`d`),n.call(`e`),n.call(`f`),e.n(t).toHaveBeenCalledTimes(1),await i.sleep(.75*16),e.n(t).toHaveBeenCalledTimes(2),e.n(t).toHaveBeenLastCalledWith([`b`,`c`,`d`,`e`,`f`])})}),e.i(`burst timer`,()=>{e.a(`invokedAt: start`,async()=>{let t=e.r.fn(),n=r.funnel(t,{reducer:o,triggerAt:`start`,minQuietPeriodMs:16});n.call(`a`),n.call(`b`),n.call(`c`),e.n(t).toHaveBeenCalledTimes(1),e.n(t).toHaveBeenLastCalledWith([`a`]),await i.sleep(16),e.n(t).toHaveBeenCalledTimes(1),n.call(`d`),e.n(t).toHaveBeenCalledTimes(2),e.n(t).toHaveBeenLastCalledWith([`d`])}),e.a(`invokedAt: both`,async()=>{let t=e.r.fn(),n=r.funnel(t,{reducer:o,triggerAt:`both`,minQuietPeriodMs:16});n.call(`a`),n.call(`b`),n.call(`c`),e.n(t).toHaveBeenCalledTimes(1),e.n(t).toHaveBeenLastCalledWith([`a`]),await i.sleep(16),e.n(t).toHaveBeenCalledTimes(2),e.n(t).toHaveBeenLastCalledWith([`b`,`c`]),n.call(`d`),n.call(`e`),n.call(`f`),e.n(t).toHaveBeenCalledTimes(3),e.n(t).toHaveBeenLastCalledWith([`d`]),await i.sleep(16),e.n(t).toHaveBeenCalledTimes(4),e.n(t).toHaveBeenLastCalledWith([`e`,`f`])}),e.a(`invokedAt: end`,async()=>{let t=e.r.fn(),n=r.funnel(t,{reducer:o,triggerAt:`end`,minQuietPeriodMs:16});n.call(`a`),n.call(`b`),n.call(`c`),e.n(t).toHaveBeenCalledTimes(0),await i.sleep(16),e.n(t).toHaveBeenCalledTimes(1),e.n(t).toHaveBeenLastCalledWith([`a`,`b`,`c`]),n.call(`e`),n.call(`f`),n.call(`g`),e.n(t).toHaveBeenCalledTimes(1),await i.sleep(16),e.n(t).toHaveBeenCalledTimes(2),e.n(t).toHaveBeenLastCalledWith([`e`,`f`,`g`])}),e.a(`invocations in the middle of a window`,async()=>{let t=e.r.fn(),n=r.funnel(t,{reducer:o,triggerAt:`end`,minQuietPeriodMs:16});n.call(`a`),n.call(`b`),n.call(`c`),e.n(t).toHaveBeenCalledTimes(0),await i.sleep(.9*16),n.call(`d`),n.call(`e`),n.call(`f`),e.n(t).toHaveBeenCalledTimes(0),await i.sleep(.1*16),e.n(t).toHaveBeenCalledTimes(0),await i.sleep(16),e.n(t).toHaveBeenCalledTimes(1),e.n(t).toHaveBeenLastCalledWith([`a`,`b`,`c`,`d`,`e`,`f`])}),e.a(`maxBurstDurationMs limits the burst duration`,async()=>{let t=e.r.fn(),n=r.funnel(t,{reducer:o,minQuietPeriodMs:16,maxBurstDurationMs:32,triggerAt:`end`});n.call(`a`),await i.sleep(.75*16),n.call(`b`),await i.sleep(.75*16),n.call(`c`),e.n(t).toHaveBeenCalledTimes(0),await i.sleep(.75*16),e.n(t).toHaveBeenCalledTimes(1),e.n(t).toHaveBeenLastCalledWith([`a`,`b`,`c`])})}),e.i(`both timers`,()=>{e.a(`delay is longer than burst`,async()=>{let t=e.r.fn(),n=r.funnel(t,{reducer:o,minGapMs:32,minQuietPeriodMs:16,triggerAt:`both`});n.call(`a`),n.call(`b`),n.call(`c`),e.n(t).toHaveBeenCalledTimes(1),e.n(t).toHaveBeenLastCalledWith([`a`]),await i.sleep(16),n.call(`d`),n.call(`e`),n.call(`f`),e.n(t).toHaveBeenCalledTimes(1),await i.sleep(16),e.n(t).toHaveBeenCalledTimes(2),e.n(t).toHaveBeenLastCalledWith([`b`,`c`,`d`,`e`,`f`])}),e.a(`burst is longer than delay`,async()=>{let t=e.r.fn(),n=r.funnel(t,{reducer:o,minGapMs:16,minQuietPeriodMs:32,triggerAt:`both`});n.call(`a`),n.call(`b`),n.call(`c`),e.n(t).toHaveBeenCalledTimes(1),e.n(t).toHaveBeenLastCalledWith([`a`]),await i.sleep(16),n.call(`d`),n.call(`e`),n.call(`f`),e.n(t).toHaveBeenCalledTimes(1),await i.sleep(16),e.n(t).toHaveBeenCalledTimes(1),await i.sleep(16),e.n(t).toHaveBeenCalledTimes(2),e.n(t).toHaveBeenLastCalledWith([`b`,`c`,`d`,`e`,`f`])}),e.a(`burst and delay are equal`,async()=>{let t=e.r.fn(),n=r.funnel(t,{reducer:o,minGapMs:16,minQuietPeriodMs:16,triggerAt:`both`});n.call(`a`),n.call(`b`),n.call(`c`),e.n(t).toHaveBeenCalledTimes(1),e.n(t).toHaveBeenLastCalledWith([`a`]),await i.sleep(16),n.call(`d`),n.call(`e`),n.call(`f`),e.n(t).toHaveBeenCalledTimes(2),e.n(t).toHaveBeenLastCalledWith([`b`,`c`]),await i.sleep(16),e.n(t).toHaveBeenCalledTimes(3),e.n(t).toHaveBeenLastCalledWith([`d`,`e`,`f`])}),e.a(`delay and maxBurstDurationMs are equal`,async()=>{let t=e.r.fn(),n=r.funnel(t,{reducer:o,minGapMs:16,minQuietPeriodMs:32,maxBurstDurationMs:16,triggerAt:`both`});n.call(`a`),n.call(`b`),n.call(`c`),e.n(t).toHaveBeenCalledTimes(1),e.n(t).toHaveBeenLastCalledWith([`a`]),await i.sleep(16),n.call(`d`),n.call(`e`),n.call(`f`),e.n(t).toHaveBeenCalledTimes(2),e.n(t).toHaveBeenLastCalledWith([`b`,`c`]),await i.sleep(16),e.n(t).toHaveBeenCalledTimes(3),e.n(t).toHaveBeenLastCalledWith([`d`,`e`,`f`])})})}),e.i(`immediate (===0) timer durations`,()=>{e.i(`delay timer`,()=>{e.a(`invokedAt: start`,async()=>{let t=e.r.fn(),n=r.funnel(t,{reducer:o,triggerAt:`start`,minGapMs:0});n.call(`a`),n.call(`b`),n.call(`c`),e.n(t).toHaveBeenCalledTimes(1),e.n(t).toHaveBeenLastCalledWith([`a`]),await i.sleep(0),n.call(`d`),n.call(`e`),n.call(`f`),e.n(t).toHaveBeenCalledTimes(2),e.n(t).toHaveBeenLastCalledWith([`d`]),await i.sleep(0),e.n(t).toHaveBeenCalledTimes(2)}),e.a(`invokedAt: both`,async()=>{let t=e.r.fn(),n=r.funnel(t,{reducer:o,triggerAt:`both`,minGapMs:0});n.call(`a`),n.call(`b`),n.call(`c`),e.n(t).toHaveBeenCalledTimes(1),e.n(t).toHaveBeenLastCalledWith([`a`]),await i.sleep(0),n.call(`d`),n.call(`e`),n.call(`f`),e.n(t).toHaveBeenCalledTimes(2),e.n(t).toHaveBeenLastCalledWith([`b`,`c`]),await i.sleep(0),e.n(t).toHaveBeenCalledTimes(3),e.n(t).toHaveBeenLastCalledWith([`d`,`e`,`f`])}),e.a(`with a non-trivial burst timer`,async()=>{let t=e.r.fn(),n=r.funnel(t,{reducer:o,triggerAt:`both`,minGapMs:0,minQuietPeriodMs:16});n.call(`a`),e.n(t).toHaveBeenCalledTimes(1),e.n(t).toHaveBeenLastCalledWith([`a`]),n.call(`b`),e.n(t).toHaveBeenCalledTimes(1),await i.sleep(16),e.n(t).toHaveBeenCalledTimes(2),e.n(t).toHaveBeenLastCalledWith([`b`])})}),e.i(`burst timer`,()=>{e.a(`invokedAt: start`,async()=>{let t=e.r.fn(),n=r.funnel(t,{reducer:o,triggerAt:`start`,minQuietPeriodMs:0});n.call(`a`),n.call(`b`),n.call(`c`),e.n(t).toHaveBeenCalledTimes(1),e.n(t).toHaveBeenLastCalledWith([`a`]),await i.sleep(0),n.call(`d`),n.call(`e`),n.call(`f`),e.n(t).toHaveBeenCalledTimes(2),e.n(t).toHaveBeenLastCalledWith([`d`]),await i.sleep(0),e.n(t).toHaveBeenCalledTimes(2)}),e.a(`invokedAt: both`,async()=>{let t=e.r.fn(),n=r.funnel(t,{reducer:o,triggerAt:`both`,minQuietPeriodMs:0});n.call(`a`),n.call(`b`),n.call(`c`),e.n(t).toHaveBeenCalledTimes(1),e.n(t).toHaveBeenLastCalledWith([`a`]),await i.sleep(0),e.n(t).toHaveBeenCalledTimes(2),e.n(t).toHaveBeenLastCalledWith([`b`,`c`]),n.call(`d`),n.call(`e`),n.call(`f`),e.n(t).toHaveBeenCalledTimes(3),e.n(t).toHaveBeenLastCalledWith([`d`]),await i.sleep(0),e.n(t).toHaveBeenCalledTimes(4),e.n(t).toHaveBeenLastCalledWith([`e`,`f`])}),e.a(`invokedAt: end`,async()=>{let t=e.r.fn(),n=r.funnel(t,{reducer:o,triggerAt:`end`,minQuietPeriodMs:0});n.call(`a`),n.call(`b`),n.call(`c`),e.n(t).toHaveBeenCalledTimes(0),await i.sleep(0),e.n(t).toHaveBeenCalledTimes(1),e.n(t).toHaveBeenLastCalledWith([`a`,`b`,`c`]),n.call(`d`),n.call(`e`),n.call(`f`),e.n(t).toHaveBeenCalledTimes(1),await i.sleep(0),e.n(t).toHaveBeenCalledTimes(2),e.n(t).toHaveBeenLastCalledWith([`d`,`e`,`f`])}),e.a(`with a non-trivial delay timer`,async()=>{let t=e.r.fn(),n=r.funnel(t,{reducer:o,triggerAt:`both`,minGapMs:16,minQuietPeriodMs:0});n.call(`a`),n.call(`b`),e.n(t).toHaveBeenCalledTimes(1),e.n(t).toHaveBeenLastCalledWith([`a`]),await i.sleep(0),e.n(t).toHaveBeenCalledTimes(1),await i.sleep(16),e.n(t).toHaveBeenCalledTimes(2),e.n(t).toHaveBeenLastCalledWith([`b`])}),e.a(`burst timer with non-trivial maxBurstDuration`,async()=>{let t=e.r.fn(),n=r.funnel(t,{reducer:o,minQuietPeriodMs:0,maxBurstDurationMs:16,triggerAt:`end`});n.call(`a`),n.call(`b`),n.call(`c`),e.n(t).toHaveBeenCalledTimes(0),await i.sleep(0),e.n(t).toHaveBeenCalledTimes(1),e.n(t).toHaveBeenLastCalledWith([`a`,`b`,`c`])})}),e.a(`both timers`,async()=>{let t=e.r.fn();r.funnel(t,{reducer:o,triggerAt:`both`,minGapMs:0,minQuietPeriodMs:0}).call(`a`),e.n(t).toHaveBeenCalledTimes(1),e.n(t).toHaveBeenLastCalledWith([`a`]),await i.sleep(0),e.n(t).toHaveBeenCalledTimes(1)}),e.a(`maxBurstDurationMs = 0 limits the burst immediately`,async()=>{let t=e.r.fn();r.funnel(t,{reducer:o,triggerAt:`end`,minQuietPeriodMs:16,maxBurstDurationMs:0}).call(`a`),await i.sleep(0),e.n(t).toHaveBeenCalledTimes(1),e.n(t).toHaveBeenLastCalledWith([`a`])}),e.a(`all timeouts zero`,async()=>{let t=e.r.fn(),n=r.funnel(t,{reducer:o,triggerAt:`both`,minGapMs:0,minQuietPeriodMs:0,maxBurstDurationMs:0});n.call(`a`),n.call(`b`),e.n(t).toHaveBeenCalledTimes(1),e.n(t).toHaveBeenLastCalledWith([`a`]),await i.sleep(0),e.n(t).toHaveBeenCalledTimes(2),e.n(t).toHaveBeenLastCalledWith([`b`])})}),e.i(`default minQuietPeriodMs === 0 when minGapMs is not defined`,()=>{e.a(`invokedAt: start`,async()=>{let t=e.r.fn(),n=r.funnel(t,{reducer:o,triggerAt:`start`});n.call(`a`),e.n(t).toHaveBeenCalledTimes(1),e.n(t).toHaveBeenLastCalledWith([`a`]),n.call(`b`),e.n(t).toHaveBeenCalledTimes(1),await i.sleep(0),e.n(t).toHaveBeenCalledTimes(1),n.call(`c`),e.n(t).toHaveBeenCalledTimes(2),e.n(t).toHaveBeenLastCalledWith([`c`])}),e.a(`invokedAt: both`,async()=>{let t=e.r.fn(),n=r.funnel(t,{reducer:o,triggerAt:`both`});n.call(`a`),e.n(t).toHaveBeenCalledTimes(1),e.n(t).toHaveBeenLastCalledWith([`a`]),n.call(`b`),e.n(t).toHaveBeenCalledTimes(1),await i.sleep(0),e.n(t).toHaveBeenCalledTimes(2),e.n(t).toHaveBeenLastCalledWith([`b`]),n.call(`c`),e.n(t).toHaveBeenCalledTimes(3),e.n(t).toHaveBeenLastCalledWith([`c`])})}),e.i(`utility functions`,()=>{e.i(`flush`,()=>{e.a(`flush triggers an immediate invocation`,async()=>{let t=e.r.fn(),n=r.funnel(t,{reducer:o,triggerAt:`end`,minQuietPeriodMs:16});n.call(`a`),n.call(`b`),n.call(`c`),n.flush(),e.n(t).toHaveBeenCalledTimes(1),e.n(t).toHaveBeenLastCalledWith([`a`,`b`,`c`]),await i.sleep(16),e.n(t).toHaveBeenCalledTimes(1)}),e.a(`flush during active burst`,async()=>{let t=e.r.fn(),n=r.funnel(t,{reducer:o,triggerAt:`end`,minQuietPeriodMs:32});n.call(`a`),n.call(`b`),n.call(`c`),await i.sleep(16),n.flush(),e.n(t).toHaveBeenCalledTimes(1),e.n(t).toHaveBeenLastCalledWith([`a`,`b`,`c`]),await i.sleep(32),e.n(t).toHaveBeenCalledTimes(1)})}),e.i(`cancel`,()=>{e.a(`cancel prevents invocation`,async()=>{let t=e.r.fn(),n=r.funnel(t,{reducer:o,triggerAt:`end`,minQuietPeriodMs:16});n.call(`a`),n.call(`b`),n.call(`c`),n.cancel(),await i.sleep(16),e.n(t).toHaveBeenCalledTimes(0)}),e.a(`cancel during delay period`,async()=>{let t=e.r.fn(),n=r.funnel(t,{reducer:o,triggerAt:`start`,minGapMs:32});n.call(`a`),n.call(`b`),await i.sleep(16),n.cancel(),await i.sleep(16),e.n(t).toHaveBeenCalledTimes(1)})}),e.i(`isIdle`,()=>{e.a(`isIdle reflects the funnel's state`,()=>{let t=r.funnel(e.r.fn(),{reducer:o,triggerAt:`end`,minQuietPeriodMs:16});e.n(t.isIdle).toBe(!0),t.call(`a`),e.n(t.isIdle).toBe(!1),t.cancel(),e.n(t.isIdle).toBe(!0)}),e.a(`isIdle works when burst duration is 0`,async()=>{let t=r.funnel(e.r.fn(),{reducer:o,triggerAt:`end`,minQuietPeriodMs:0});e.n(t.isIdle).toBe(!0),t.call(`a`),t.call(`b`),t.call(`c`),e.n(t.isIdle).toBe(!1),await i.sleep(0),e.n(t.isIdle).toBe(!0)})})}),e.i(`edge-cases`,()=>{e.a(`bursts that start late don't prevent delayed invocations`,async()=>{let t=e.r.fn(),n=r.funnel(t,{reducer:o,triggerAt:`both`,minQuietPeriodMs:16,minGapMs:32});n.call(`a`),n.call(`b`),n.call(`c`),e.n(t).toHaveBeenCalledTimes(1),e.n(t).toHaveBeenLastCalledWith([`a`]),await i.sleep(1.5*16),e.n(t).toHaveBeenCalledTimes(1),n.call(`d`),n.call(`e`),n.call(`f`),e.n(t).toHaveBeenCalledTimes(1),await i.sleep(.5*16),e.n(t).toHaveBeenCalledTimes(2),e.n(t).toHaveBeenLastCalledWith([`b`,`c`,`d`,`e`,`f`])}),e.a(`delay timeouts don't cause an invocation in the middle of bursts`,async()=>{let t=e.r.fn(),n=r.funnel(t,{reducer:o,triggerAt:`both`,minQuietPeriodMs:32,minGapMs:16});n.call(`a`),e.n(t).toHaveBeenCalledTimes(1),e.n(t).toHaveBeenLastCalledWith([`a`]),await i.sleep(16),n.call(`b`),e.n(t).toHaveBeenCalledTimes(1),await i.sleep(16),n.call(`c`),e.n(t).toHaveBeenCalledTimes(1),await i.sleep(16),n.call(`d`),e.n(t).toHaveBeenCalledTimes(1),await i.sleep(16),e.n(t).toHaveBeenCalledTimes(1),await i.sleep(16),e.n(t).toHaveBeenCalledTimes(2)})});

package/dist/funnel.test.d.cts

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

package/dist/funnel.test.d.ts

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

package/dist/funnel.test.js

@@ -1,2 +0,0 @@
-import{constant as e}from"./constant.js";import{doNothing as t}from"./do-nothing.js";import{a as n,i as r,n as i,r as a}from"./dist-Bd1vawFi.js";import{funnel as o}from"./funnel.js";import{sleep as s}from"./sleep.js";function c(e,t){return e===void 0?[t]:[...e,t]}r(`reducer behavior`,()=>{n(`passes the reduced arg to the executor`,()=>{let t=a.fn();o(t,{reducer:e(`hello world`),triggerAt:`start`,minQuietPeriodMs:16}).call(),i(t).toHaveBeenCalledTimes(1),i(t).toHaveBeenLastCalledWith(`hello world`)}),n(`reduces call args`,async()=>{let e=a.fn(e=>{}),t=o(e,{reducer:(e,t)=>(e??0)+t,minQuietPeriodMs:32,triggerAt:`end`});t.call(1),t.call(2),t.call(3),await s(16),t.call(4),t.call(5),t.call(6),await s(32),i(e).toHaveBeenCalledTimes(1),i(e).toHaveBeenLastCalledWith(21)}),n(`does not invoke if reduceArgs returns undefined`,async()=>{let t=a.fn();o(t,{reducer:e(void 0),triggerAt:`end`,minQuietPeriodMs:16}).call(),await s(32),i(t).toHaveBeenCalledTimes(0)}),n(`supports multiple arguments`,()=>{let e=a.fn();o(e,{reducer:(e,t,n,r)=>[e,t,n,r],triggerAt:`start`,minQuietPeriodMs:16}).call(1,`a`,!0),i(e).toHaveBeenCalledTimes(1),i(e).toHaveBeenLastCalledWith([void 0,1,`a`,!0])}),n(`reducer isn't called again when 'invokedAt: start'`,async()=>{let e=a.fn(c),n=o(t(),{reducer:e,triggerAt:`start`,minQuietPeriodMs:16});n.call(`a`),i(e).toHaveBeenCalledTimes(1),i(e).toHaveBeenLastCalledWith(void 0,`a`),n.call(`b`),n.call(`c`),i(e).toHaveBeenCalledTimes(1),await s(32),i(e).toHaveBeenCalledTimes(1)})}),r(`non-trivial (>0ms) timer duration`,()=>{r(`delay timer`,()=>{n(`invokedAt: start`,async()=>{let e=a.fn(),t=o(e,{reducer:c,triggerAt:`start`,minGapMs:16});t.call(`a`),t.call(`b`),t.call(`c`),i(e).toHaveBeenCalledTimes(1),i(e).toHaveBeenLastCalledWith([`a`]),await s(16),i(e).toHaveBeenCalledTimes(1),t.call(`d`),i(e).toHaveBeenCalledTimes(2),i(e).toHaveBeenLastCalledWith([`d`])}),n(`invokedAt: both`,async()=>{let e=a.fn(),t=o(e,{reducer:c,triggerAt:`both`,minGapMs:16});t.call(`a`),t.call(`b`),t.call(`c`),i(e).toHaveBeenCalledTimes(1),i(e).toHaveBeenLastCalledWith([`a`]),await s(16),i(e).toHaveBeenCalledTimes(2),i(e).toHaveBeenLastCalledWith([`b`,`c`]),t.call(`d`),t.call(`e`),t.call(`f`),i(e).toHaveBeenCalledTimes(2),await s(16),i(e).toHaveBeenCalledTimes(3),i(e).toHaveBeenLastCalledWith([`d`,`e`,`f`])}),n(`invocations in the middle of a window`,async()=>{let e=a.fn(),t=o(e,{reducer:c,triggerAt:`both`,minGapMs:16});t.call(`a`),t.call(`b`),t.call(`c`),i(e).toHaveBeenCalledTimes(1),i(e).toHaveBeenLastCalledWith([`a`]),await s(.75*16),t.call(`d`),t.call(`e`),t.call(`f`),i(e).toHaveBeenCalledTimes(1),await s(.75*16),i(e).toHaveBeenCalledTimes(2),i(e).toHaveBeenLastCalledWith([`b`,`c`,`d`,`e`,`f`])})}),r(`burst timer`,()=>{n(`invokedAt: start`,async()=>{let e=a.fn(),t=o(e,{reducer:c,triggerAt:`start`,minQuietPeriodMs:16});t.call(`a`),t.call(`b`),t.call(`c`),i(e).toHaveBeenCalledTimes(1),i(e).toHaveBeenLastCalledWith([`a`]),await s(16),i(e).toHaveBeenCalledTimes(1),t.call(`d`),i(e).toHaveBeenCalledTimes(2),i(e).toHaveBeenLastCalledWith([`d`])}),n(`invokedAt: both`,async()=>{let e=a.fn(),t=o(e,{reducer:c,triggerAt:`both`,minQuietPeriodMs:16});t.call(`a`),t.call(`b`),t.call(`c`),i(e).toHaveBeenCalledTimes(1),i(e).toHaveBeenLastCalledWith([`a`]),await s(16),i(e).toHaveBeenCalledTimes(2),i(e).toHaveBeenLastCalledWith([`b`,`c`]),t.call(`d`),t.call(`e`),t.call(`f`),i(e).toHaveBeenCalledTimes(3),i(e).toHaveBeenLastCalledWith([`d`]),await s(16),i(e).toHaveBeenCalledTimes(4),i(e).toHaveBeenLastCalledWith([`e`,`f`])}),n(`invokedAt: end`,async()=>{let e=a.fn(),t=o(e,{reducer:c,triggerAt:`end`,minQuietPeriodMs:16});t.call(`a`),t.call(`b`),t.call(`c`),i(e).toHaveBeenCalledTimes(0),await s(16),i(e).toHaveBeenCalledTimes(1),i(e).toHaveBeenLastCalledWith([`a`,`b`,`c`]),t.call(`e`),t.call(`f`),t.call(`g`),i(e).toHaveBeenCalledTimes(1),await s(16),i(e).toHaveBeenCalledTimes(2),i(e).toHaveBeenLastCalledWith([`e`,`f`,`g`])}),n(`invocations in the middle of a window`,async()=>{let e=a.fn(),t=o(e,{reducer:c,triggerAt:`end`,minQuietPeriodMs:16});t.call(`a`),t.call(`b`),t.call(`c`),i(e).toHaveBeenCalledTimes(0),await s(.9*16),t.call(`d`),t.call(`e`),t.call(`f`),i(e).toHaveBeenCalledTimes(0),await s(.1*16),i(e).toHaveBeenCalledTimes(0),await s(16),i(e).toHaveBeenCalledTimes(1),i(e).toHaveBeenLastCalledWith([`a`,`b`,`c`,`d`,`e`,`f`])}),n(`maxBurstDurationMs limits the burst duration`,async()=>{let e=a.fn(),t=o(e,{reducer:c,minQuietPeriodMs:16,maxBurstDurationMs:32,triggerAt:`end`});t.call(`a`),await s(.75*16),t.call(`b`),await s(.75*16),t.call(`c`),i(e).toHaveBeenCalledTimes(0),await s(.75*16),i(e).toHaveBeenCalledTimes(1),i(e).toHaveBeenLastCalledWith([`a`,`b`,`c`])})}),r(`both timers`,()=>{n(`delay is longer than burst`,async()=>{let e=a.fn(),t=o(e,{reducer:c,minGapMs:32,minQuietPeriodMs:16,triggerAt:`both`});t.call(`a`),t.call(`b`),t.call(`c`),i(e).toHaveBeenCalledTimes(1),i(e).toHaveBeenLastCalledWith([`a`]),await s(16),t.call(`d`),t.call(`e`),t.call(`f`),i(e).toHaveBeenCalledTimes(1),await s(16),i(e).toHaveBeenCalledTimes(2),i(e).toHaveBeenLastCalledWith([`b`,`c`,`d`,`e`,`f`])}),n(`burst is longer than delay`,async()=>{let e=a.fn(),t=o(e,{reducer:c,minGapMs:16,minQuietPeriodMs:32,triggerAt:`both`});t.call(`a`),t.call(`b`),t.call(`c`),i(e).toHaveBeenCalledTimes(1),i(e).toHaveBeenLastCalledWith([`a`]),await s(16),t.call(`d`),t.call(`e`),t.call(`f`),i(e).toHaveBeenCalledTimes(1),await s(16),i(e).toHaveBeenCalledTimes(1),await s(16),i(e).toHaveBeenCalledTimes(2),i(e).toHaveBeenLastCalledWith([`b`,`c`,`d`,`e`,`f`])}),n(`burst and delay are equal`,async()=>{let e=a.fn(),t=o(e,{reducer:c,minGapMs:16,minQuietPeriodMs:16,triggerAt:`both`});t.call(`a`),t.call(`b`),t.call(`c`),i(e).toHaveBeenCalledTimes(1),i(e).toHaveBeenLastCalledWith([`a`]),await s(16),t.call(`d`),t.call(`e`),t.call(`f`),i(e).toHaveBeenCalledTimes(2),i(e).toHaveBeenLastCalledWith([`b`,`c`]),await s(16),i(e).toHaveBeenCalledTimes(3),i(e).toHaveBeenLastCalledWith([`d`,`e`,`f`])}),n(`delay and maxBurstDurationMs are equal`,async()=>{let e=a.fn(),t=o(e,{reducer:c,minGapMs:16,minQuietPeriodMs:32,maxBurstDurationMs:16,triggerAt:`both`});t.call(`a`),t.call(`b`),t.call(`c`),i(e).toHaveBeenCalledTimes(1),i(e).toHaveBeenLastCalledWith([`a`]),await s(16),t.call(`d`),t.call(`e`),t.call(`f`),i(e).toHaveBeenCalledTimes(2),i(e).toHaveBeenLastCalledWith([`b`,`c`]),await s(16),i(e).toHaveBeenCalledTimes(3),i(e).toHaveBeenLastCalledWith([`d`,`e`,`f`])})})}),r(`immediate (===0) timer durations`,()=>{r(`delay timer`,()=>{n(`invokedAt: start`,async()=>{let e=a.fn(),t=o(e,{reducer:c,triggerAt:`start`,minGapMs:0});t.call(`a`),t.call(`b`),t.call(`c`),i(e).toHaveBeenCalledTimes(1),i(e).toHaveBeenLastCalledWith([`a`]),await s(0),t.call(`d`),t.call(`e`),t.call(`f`),i(e).toHaveBeenCalledTimes(2),i(e).toHaveBeenLastCalledWith([`d`]),await s(0),i(e).toHaveBeenCalledTimes(2)}),n(`invokedAt: both`,async()=>{let e=a.fn(),t=o(e,{reducer:c,triggerAt:`both`,minGapMs:0});t.call(`a`),t.call(`b`),t.call(`c`),i(e).toHaveBeenCalledTimes(1),i(e).toHaveBeenLastCalledWith([`a`]),await s(0),t.call(`d`),t.call(`e`),t.call(`f`),i(e).toHaveBeenCalledTimes(2),i(e).toHaveBeenLastCalledWith([`b`,`c`]),await s(0),i(e).toHaveBeenCalledTimes(3),i(e).toHaveBeenLastCalledWith([`d`,`e`,`f`])}),n(`with a non-trivial burst timer`,async()=>{let e=a.fn(),t=o(e,{reducer:c,triggerAt:`both`,minGapMs:0,minQuietPeriodMs:16});t.call(`a`),i(e).toHaveBeenCalledTimes(1),i(e).toHaveBeenLastCalledWith([`a`]),t.call(`b`),i(e).toHaveBeenCalledTimes(1),await s(16),i(e).toHaveBeenCalledTimes(2),i(e).toHaveBeenLastCalledWith([`b`])})}),r(`burst timer`,()=>{n(`invokedAt: start`,async()=>{let e=a.fn(),t=o(e,{reducer:c,triggerAt:`start`,minQuietPeriodMs:0});t.call(`a`),t.call(`b`),t.call(`c`),i(e).toHaveBeenCalledTimes(1),i(e).toHaveBeenLastCalledWith([`a`]),await s(0),t.call(`d`),t.call(`e`),t.call(`f`),i(e).toHaveBeenCalledTimes(2),i(e).toHaveBeenLastCalledWith([`d`]),await s(0),i(e).toHaveBeenCalledTimes(2)}),n(`invokedAt: both`,async()=>{let e=a.fn(),t=o(e,{reducer:c,triggerAt:`both`,minQuietPeriodMs:0});t.call(`a`),t.call(`b`),t.call(`c`),i(e).toHaveBeenCalledTimes(1),i(e).toHaveBeenLastCalledWith([`a`]),await s(0),i(e).toHaveBeenCalledTimes(2),i(e).toHaveBeenLastCalledWith([`b`,`c`]),t.call(`d`),t.call(`e`),t.call(`f`),i(e).toHaveBeenCalledTimes(3),i(e).toHaveBeenLastCalledWith([`d`]),await s(0),i(e).toHaveBeenCalledTimes(4),i(e).toHaveBeenLastCalledWith([`e`,`f`])}),n(`invokedAt: end`,async()=>{let e=a.fn(),t=o(e,{reducer:c,triggerAt:`end`,minQuietPeriodMs:0});t.call(`a`),t.call(`b`),t.call(`c`),i(e).toHaveBeenCalledTimes(0),await s(0),i(e).toHaveBeenCalledTimes(1),i(e).toHaveBeenLastCalledWith([`a`,`b`,`c`]),t.call(`d`),t.call(`e`),t.call(`f`),i(e).toHaveBeenCalledTimes(1),await s(0),i(e).toHaveBeenCalledTimes(2),i(e).toHaveBeenLastCalledWith([`d`,`e`,`f`])}),n(`with a non-trivial delay timer`,async()=>{let e=a.fn(),t=o(e,{reducer:c,triggerAt:`both`,minGapMs:16,minQuietPeriodMs:0});t.call(`a`),t.call(`b`),i(e).toHaveBeenCalledTimes(1),i(e).toHaveBeenLastCalledWith([`a`]),await s(0),i(e).toHaveBeenCalledTimes(1),await s(16),i(e).toHaveBeenCalledTimes(2),i(e).toHaveBeenLastCalledWith([`b`])}),n(`burst timer with non-trivial maxBurstDuration`,async()=>{let e=a.fn(),t=o(e,{reducer:c,minQuietPeriodMs:0,maxBurstDurationMs:16,triggerAt:`end`});t.call(`a`),t.call(`b`),t.call(`c`),i(e).toHaveBeenCalledTimes(0),await s(0),i(e).toHaveBeenCalledTimes(1),i(e).toHaveBeenLastCalledWith([`a`,`b`,`c`])})}),n(`both timers`,async()=>{let e=a.fn();o(e,{reducer:c,triggerAt:`both`,minGapMs:0,minQuietPeriodMs:0}).call(`a`),i(e).toHaveBeenCalledTimes(1),i(e).toHaveBeenLastCalledWith([`a`]),await s(0),i(e).toHaveBeenCalledTimes(1)}),n(`maxBurstDurationMs = 0 limits the burst immediately`,async()=>{let e=a.fn();o(e,{reducer:c,triggerAt:`end`,minQuietPeriodMs:16,maxBurstDurationMs:0}).call(`a`),await s(0),i(e).toHaveBeenCalledTimes(1),i(e).toHaveBeenLastCalledWith([`a`])}),n(`all timeouts zero`,async()=>{let e=a.fn(),t=o(e,{reducer:c,triggerAt:`both`,minGapMs:0,minQuietPeriodMs:0,maxBurstDurationMs:0});t.call(`a`),t.call(`b`),i(e).toHaveBeenCalledTimes(1),i(e).toHaveBeenLastCalledWith([`a`]),await s(0),i(e).toHaveBeenCalledTimes(2),i(e).toHaveBeenLastCalledWith([`b`])})}),r(`default minQuietPeriodMs === 0 when minGapMs is not defined`,()=>{n(`invokedAt: start`,async()=>{let e=a.fn(),t=o(e,{reducer:c,triggerAt:`start`});t.call(`a`),i(e).toHaveBeenCalledTimes(1),i(e).toHaveBeenLastCalledWith([`a`]),t.call(`b`),i(e).toHaveBeenCalledTimes(1),await s(0),i(e).toHaveBeenCalledTimes(1),t.call(`c`),i(e).toHaveBeenCalledTimes(2),i(e).toHaveBeenLastCalledWith([`c`])}),n(`invokedAt: both`,async()=>{let e=a.fn(),t=o(e,{reducer:c,triggerAt:`both`});t.call(`a`),i(e).toHaveBeenCalledTimes(1),i(e).toHaveBeenLastCalledWith([`a`]),t.call(`b`),i(e).toHaveBeenCalledTimes(1),await s(0),i(e).toHaveBeenCalledTimes(2),i(e).toHaveBeenLastCalledWith([`b`]),t.call(`c`),i(e).toHaveBeenCalledTimes(3),i(e).toHaveBeenLastCalledWith([`c`])})}),r(`utility functions`,()=>{r(`flush`,()=>{n(`flush triggers an immediate invocation`,async()=>{let e=a.fn(),t=o(e,{reducer:c,triggerAt:`end`,minQuietPeriodMs:16});t.call(`a`),t.call(`b`),t.call(`c`),t.flush(),i(e).toHaveBeenCalledTimes(1),i(e).toHaveBeenLastCalledWith([`a`,`b`,`c`]),await s(16),i(e).toHaveBeenCalledTimes(1)}),n(`flush during active burst`,async()=>{let e=a.fn(),t=o(e,{reducer:c,triggerAt:`end`,minQuietPeriodMs:32});t.call(`a`),t.call(`b`),t.call(`c`),await s(16),t.flush(),i(e).toHaveBeenCalledTimes(1),i(e).toHaveBeenLastCalledWith([`a`,`b`,`c`]),await s(32),i(e).toHaveBeenCalledTimes(1)})}),r(`cancel`,()=>{n(`cancel prevents invocation`,async()=>{let e=a.fn(),t=o(e,{reducer:c,triggerAt:`end`,minQuietPeriodMs:16});t.call(`a`),t.call(`b`),t.call(`c`),t.cancel(),await s(16),i(e).toHaveBeenCalledTimes(0)}),n(`cancel during delay period`,async()=>{let e=a.fn(),t=o(e,{reducer:c,triggerAt:`start`,minGapMs:32});t.call(`a`),t.call(`b`),await s(16),t.cancel(),await s(16),i(e).toHaveBeenCalledTimes(1)})}),r(`isIdle`,()=>{n(`isIdle reflects the funnel's state`,()=>{let e=o(a.fn(),{reducer:c,triggerAt:`end`,minQuietPeriodMs:16});i(e.isIdle).toBe(!0),e.call(`a`),i(e.isIdle).toBe(!1),e.cancel(),i(e.isIdle).toBe(!0)}),n(`isIdle works when burst duration is 0`,async()=>{let e=o(a.fn(),{reducer:c,triggerAt:`end`,minQuietPeriodMs:0});i(e.isIdle).toBe(!0),e.call(`a`),e.call(`b`),e.call(`c`),i(e.isIdle).toBe(!1),await s(0),i(e.isIdle).toBe(!0)})})}),r(`edge-cases`,()=>{n(`bursts that start late don't prevent delayed invocations`,async()=>{let e=a.fn(),t=o(e,{reducer:c,triggerAt:`both`,minQuietPeriodMs:16,minGapMs:32});t.call(`a`),t.call(`b`),t.call(`c`),i(e).toHaveBeenCalledTimes(1),i(e).toHaveBeenLastCalledWith([`a`]),await s(1.5*16),i(e).toHaveBeenCalledTimes(1),t.call(`d`),t.call(`e`),t.call(`f`),i(e).toHaveBeenCalledTimes(1),await s(.5*16),i(e).toHaveBeenCalledTimes(2),i(e).toHaveBeenLastCalledWith([`b`,`c`,`d`,`e`,`f`])}),n(`delay timeouts don't cause an invocation in the middle of bursts`,async()=>{let e=a.fn(),t=o(e,{reducer:c,triggerAt:`both`,minQuietPeriodMs:32,minGapMs:16});t.call(`a`),i(e).toHaveBeenCalledTimes(1),i(e).toHaveBeenLastCalledWith([`a`]),await s(16),t.call(`b`),i(e).toHaveBeenCalledTimes(1),await s(16),t.call(`c`),i(e).toHaveBeenCalledTimes(1),await s(16),t.call(`d`),i(e).toHaveBeenCalledTimes(1),await s(16),i(e).toHaveBeenCalledTimes(1),await s(16),i(e).toHaveBeenCalledTimes(2)})});
-//# sourceMappingURL=funnel.test.js.map

package/dist/funnel.test.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"funnel.test.js","names":[],"sources":["../src/funnel.test.ts"],"sourcesContent":["import { describe, expect, it, vi } from 'vitest';\nimport { constant } from './constant';\nimport { doNothing } from './do-nothing';\nimport { funnel } from './funnel';\nimport { sleep } from './sleep';\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 number is in milliseconds.\n */\nconst UT = 16;\n\n// We use this reducer to collect arguments from each invocation so we can test what the function was invoked with.\nfunction ARGS_COLLECTOR(accumulator: ReadonlyArray<string> | undefined, item: string): ReadonlyArray<string> {\n  return accumulator === undefined ? [item] : [...accumulator, item];\n}\n\ndescribe('reducer behavior', () => {\n  it('passes the reduced arg to the executor', () => {\n    const mockFn = vi.fn();\n    const foo = funnel(mockFn, {\n      reducer: constant('hello world'),\n      triggerAt: 'start',\n      minQuietPeriodMs: UT,\n    });\n    foo.call();\n\n    expect(mockFn).toHaveBeenCalledTimes(1);\n    expect(mockFn).toHaveBeenLastCalledWith('hello world');\n  });\n\n  it('reduces call args', async () => {\n    const mockFn = vi.fn((_total: number): void => {\n      /* do nothing */\n    });\n\n    const foo = funnel(mockFn, {\n      reducer: (total, item: number) => (total ?? 0) + item,\n      minQuietPeriodMs: 2 * UT,\n      triggerAt: 'end',\n    });\n    foo.call(1);\n    foo.call(2);\n    foo.call(3);\n    await sleep(UT);\n    foo.call(4);\n    foo.call(5);\n    foo.call(6);\n    await sleep(2 * UT);\n\n    expect(mockFn).toHaveBeenCalledTimes(1);\n    expect(mockFn).toHaveBeenLastCalledWith(21 /* 1 + 2 + ... + 6 */);\n  });\n\n  it('does not invoke if reduceArgs returns undefined', async () => {\n    const mockFn = vi.fn();\n    const foo = funnel(mockFn, {\n      reducer: constant(undefined),\n      triggerAt: 'end',\n      minQuietPeriodMs: UT,\n    });\n    foo.call();\n    await sleep(2 * UT);\n\n    expect(mockFn).toHaveBeenCalledTimes(0);\n  });\n\n  it('supports multiple arguments', () => {\n    const mockFn = vi.fn();\n    const foo = funnel(mockFn, {\n      reducer: (ret: unknown, a: number, b: string, c: boolean) => [\n        ret,\n        a,\n        b,\n        c,\n      ],\n      triggerAt: 'start',\n      minQuietPeriodMs: UT,\n    });\n    foo.call(1, 'a', true);\n\n    expect(mockFn).toHaveBeenCalledTimes(1);\n    expect(mockFn).toHaveBeenLastCalledWith([undefined, 1, 'a', true]);\n  });\n\n  it('reducer isn\\'t called again when \\'invokedAt: start\\'', async () => {\n    const mockFn = vi.fn(ARGS_COLLECTOR);\n    const foo = funnel(doNothing(), {\n      reducer: mockFn,\n      triggerAt: 'start',\n      minQuietPeriodMs: UT,\n    });\n    foo.call('a');\n\n    expect(mockFn).toHaveBeenCalledTimes(1);\n    expect(mockFn).toHaveBeenLastCalledWith(undefined, 'a');\n\n    foo.call('b');\n    foo.call('c');\n\n    expect(mockFn).toHaveBeenCalledTimes(1);\n\n    await sleep(2 * UT);\n\n    expect(mockFn).toHaveBeenCalledTimes(1);\n  });\n});\n\ndescribe('non-trivial (>0ms) timer duration', () => {\n  describe('delay timer', () => {\n    it('invokedAt: start', async () => {\n      const mockFn = vi.fn();\n      const foo = funnel(mockFn, {\n        reducer: ARGS_COLLECTOR,\n        triggerAt: 'start',\n        minGapMs: UT,\n      });\n      foo.call('a');\n      foo.call('b');\n      foo.call('c');\n\n      expect(mockFn).toHaveBeenCalledTimes(1);\n      expect(mockFn).toHaveBeenLastCalledWith(['a']);\n\n      await sleep(UT);\n\n      expect(mockFn).toHaveBeenCalledTimes(1);\n\n      foo.call('d');\n\n      expect(mockFn).toHaveBeenCalledTimes(2);\n      // \"b\" and \"c\" have been ignored because the funnel is only configured to\n      // run the function at the start of the delay window, meaning anything\n      // after that is simply dropped.\n      expect(mockFn).toHaveBeenLastCalledWith(['d']);\n    });\n\n    it('invokedAt: both', async () => {\n      const mockFn = vi.fn();\n      const foo = funnel(mockFn, {\n        reducer: ARGS_COLLECTOR,\n        triggerAt: 'both',\n        minGapMs: UT,\n      });\n      foo.call('a');\n      foo.call('b');\n      foo.call('c');\n\n      expect(mockFn).toHaveBeenCalledTimes(1);\n      expect(mockFn).toHaveBeenLastCalledWith(['a']);\n\n      await sleep(UT);\n\n      expect(mockFn).toHaveBeenCalledTimes(2);\n      expect(mockFn).toHaveBeenLastCalledWith(['b', 'c']);\n\n      foo.call('d');\n      foo.call('e');\n      foo.call('f');\n\n      expect(mockFn).toHaveBeenCalledTimes(2);\n\n      await sleep(UT);\n\n      expect(mockFn).toHaveBeenCalledTimes(3);\n      expect(mockFn).toHaveBeenLastCalledWith(['d', 'e', 'f']);\n    });\n\n    it('invocations in the middle of a window', async () => {\n      const mockFn = vi.fn();\n      const foo = funnel(mockFn, {\n        reducer: ARGS_COLLECTOR,\n        triggerAt: 'both',\n        minGapMs: UT,\n      });\n      foo.call('a');\n      foo.call('b');\n      foo.call('c');\n\n      expect(mockFn).toHaveBeenCalledTimes(1);\n      expect(mockFn).toHaveBeenLastCalledWith(['a']);\n\n      await sleep(0.75 * UT);\n      foo.call('d');\n      foo.call('e');\n      foo.call('f');\n\n      expect(mockFn).toHaveBeenCalledTimes(1);\n\n      await sleep(0.75 * UT);\n\n      expect(mockFn).toHaveBeenCalledTimes(2);\n      expect(mockFn).toHaveBeenLastCalledWith(['b', 'c', 'd', 'e', 'f']);\n    });\n  });\n\n  describe('burst timer', () => {\n    it('invokedAt: start', async () => {\n      const mockFn = vi.fn();\n      const foo = funnel(mockFn, {\n        reducer: ARGS_COLLECTOR,\n        triggerAt: 'start',\n        minQuietPeriodMs: UT,\n      });\n      foo.call('a');\n      foo.call('b');\n      foo.call('c');\n\n      expect(mockFn).toHaveBeenCalledTimes(1);\n      expect(mockFn).toHaveBeenLastCalledWith(['a']);\n\n      await sleep(UT);\n\n      expect(mockFn).toHaveBeenCalledTimes(1);\n\n      foo.call('d');\n\n      expect(mockFn).toHaveBeenCalledTimes(2);\n      // \"b\" and \"c\" have been ignored because the funnel is only configured to\n      // run the function at the start of the delay window, meaning anything\n      // after that is simply dropped.\n      expect(mockFn).toHaveBeenLastCalledWith(['d']);\n    });\n\n    it('invokedAt: both', async () => {\n      const mockFn = vi.fn();\n      const foo = funnel(mockFn, {\n        reducer: ARGS_COLLECTOR,\n        triggerAt: 'both',\n        minQuietPeriodMs: UT,\n      });\n      foo.call('a');\n      foo.call('b');\n      foo.call('c');\n\n      expect(mockFn).toHaveBeenCalledTimes(1);\n      expect(mockFn).toHaveBeenLastCalledWith(['a']);\n\n      await sleep(UT);\n\n      expect(mockFn).toHaveBeenCalledTimes(2);\n      expect(mockFn).toHaveBeenLastCalledWith(['b', 'c']);\n\n      foo.call('d');\n      foo.call('e');\n      foo.call('f');\n\n      expect(mockFn).toHaveBeenCalledTimes(3);\n      expect(mockFn).toHaveBeenLastCalledWith(['d']);\n\n      await sleep(UT);\n\n      expect(mockFn).toHaveBeenCalledTimes(4);\n      expect(mockFn).toHaveBeenLastCalledWith(['e', 'f']);\n    });\n\n    it('invokedAt: end', async () => {\n      const mockFn = vi.fn();\n      const foo = funnel(mockFn, {\n        reducer: ARGS_COLLECTOR,\n        triggerAt: 'end',\n        minQuietPeriodMs: UT,\n      });\n      foo.call('a');\n      foo.call('b');\n      foo.call('c');\n\n      expect(mockFn).toHaveBeenCalledTimes(0);\n\n      await sleep(UT);\n\n      expect(mockFn).toHaveBeenCalledTimes(1);\n      expect(mockFn).toHaveBeenLastCalledWith(['a', 'b', 'c']);\n\n      foo.call('e');\n      foo.call('f');\n      foo.call('g');\n\n      expect(mockFn).toHaveBeenCalledTimes(1);\n\n      await sleep(UT);\n\n      expect(mockFn).toHaveBeenCalledTimes(2);\n      expect(mockFn).toHaveBeenLastCalledWith(['e', 'f', 'g']);\n    });\n\n    it('invocations in the middle of a window', async () => {\n      const mockFn = vi.fn();\n      const foo = funnel(mockFn, {\n        reducer: ARGS_COLLECTOR,\n        triggerAt: 'end',\n        minQuietPeriodMs: UT,\n      });\n      foo.call('a');\n      foo.call('b');\n      foo.call('c');\n\n      expect(mockFn).toHaveBeenCalledTimes(0);\n\n      await sleep(0.9 * UT);\n      foo.call('d');\n      foo.call('e');\n      foo.call('f');\n\n      expect(mockFn).toHaveBeenCalledTimes(0);\n\n      await sleep(0.1 * UT);\n\n      expect(mockFn).toHaveBeenCalledTimes(0);\n\n      await sleep(UT);\n\n      expect(mockFn).toHaveBeenCalledTimes(1);\n      expect(mockFn).toHaveBeenLastCalledWith(['a', 'b', 'c', 'd', 'e', 'f']);\n    });\n\n    it('maxBurstDurationMs limits the burst duration', async () => {\n      const mockFn = vi.fn();\n      const foo = funnel(mockFn, {\n        reducer: ARGS_COLLECTOR,\n        minQuietPeriodMs: UT,\n        maxBurstDurationMs: 2 * UT,\n        triggerAt: 'end',\n      });\n      foo.call('a');\n      await sleep(0.75 * UT);\n      foo.call('b');\n      await sleep(0.75 * UT);\n      foo.call('c');\n\n      // Total time is approximately 1.5*UT, less than 2UT which is\n      // maxBurstDurationMs\n      expect(mockFn).toHaveBeenCalledTimes(0);\n\n      // We sleep less than minQuietPeriodMs but more than our\n      // maxBurstDurationMs so that we validate that the burst is being ended\n      // prematurely.\n      await sleep(0.75 * UT);\n\n      expect(mockFn).toHaveBeenCalledTimes(1);\n      expect(mockFn).toHaveBeenLastCalledWith(['a', 'b', 'c']);\n    });\n  });\n\n  describe('both timers', () => {\n    it('delay is longer than burst', async () => {\n      const mockFn = vi.fn();\n      const foo = funnel(mockFn, {\n        reducer: ARGS_COLLECTOR,\n        minGapMs: 2 * UT,\n        minQuietPeriodMs: UT,\n        triggerAt: 'both',\n      });\n      foo.call('a');\n      foo.call('b');\n      foo.call('c');\n\n      expect(mockFn).toHaveBeenCalledTimes(1);\n      expect(mockFn).toHaveBeenLastCalledWith(['a']);\n\n      await sleep(UT);\n      foo.call('d');\n      foo.call('e');\n      foo.call('f');\n\n      expect(mockFn).toHaveBeenCalledTimes(1);\n\n      await sleep(UT);\n\n      expect(mockFn).toHaveBeenCalledTimes(2);\n      expect(mockFn).toHaveBeenLastCalledWith(['b', 'c', 'd', 'e', 'f']);\n    });\n\n    it('burst is longer than delay', async () => {\n      const mockFn = vi.fn();\n      const foo = funnel(mockFn, {\n        reducer: ARGS_COLLECTOR,\n        minGapMs: UT,\n        minQuietPeriodMs: 2 * UT,\n        triggerAt: 'both',\n      });\n      foo.call('a');\n      foo.call('b');\n      foo.call('c');\n\n      expect(mockFn).toHaveBeenCalledTimes(1);\n      expect(mockFn).toHaveBeenLastCalledWith(['a']);\n\n      await sleep(UT);\n      foo.call('d');\n      foo.call('e');\n      foo.call('f');\n\n      expect(mockFn).toHaveBeenCalledTimes(1);\n\n      await sleep(UT);\n\n      expect(mockFn).toHaveBeenCalledTimes(1);\n\n      await sleep(UT);\n\n      expect(mockFn).toHaveBeenCalledTimes(2);\n      expect(mockFn).toHaveBeenLastCalledWith(['b', 'c', 'd', 'e', 'f']);\n    });\n\n    it('burst and delay are equal', async () => {\n      const mockFn = vi.fn();\n      const foo = funnel(mockFn, {\n        reducer: ARGS_COLLECTOR,\n        minGapMs: UT,\n        minQuietPeriodMs: UT,\n        triggerAt: 'both',\n      });\n      foo.call('a');\n      foo.call('b');\n      foo.call('c');\n\n      expect(mockFn).toHaveBeenCalledTimes(1);\n      expect(mockFn).toHaveBeenLastCalledWith(['a']);\n\n      await sleep(UT);\n      foo.call('d');\n      foo.call('e');\n      foo.call('f');\n\n      expect(mockFn).toHaveBeenCalledTimes(2);\n      expect(mockFn).toHaveBeenLastCalledWith(['b', 'c']);\n\n      await sleep(UT);\n\n      expect(mockFn).toHaveBeenCalledTimes(3);\n      expect(mockFn).toHaveBeenLastCalledWith(['d', 'e', 'f']);\n    });\n\n    it('delay and maxBurstDurationMs are equal', async () => {\n      const mockFn = vi.fn();\n      const foo = funnel(mockFn, {\n        reducer: ARGS_COLLECTOR,\n        minGapMs: UT,\n        minQuietPeriodMs: 2 * UT,\n        maxBurstDurationMs: UT,\n        triggerAt: 'both',\n      });\n      foo.call('a');\n      foo.call('b');\n      foo.call('c');\n\n      expect(mockFn).toHaveBeenCalledTimes(1);\n      expect(mockFn).toHaveBeenLastCalledWith(['a']);\n\n      await sleep(UT);\n      foo.call('d');\n      foo.call('e');\n      foo.call('f');\n\n      expect(mockFn).toHaveBeenCalledTimes(2);\n      expect(mockFn).toHaveBeenLastCalledWith(['b', 'c']);\n\n      await sleep(UT);\n\n      expect(mockFn).toHaveBeenCalledTimes(3);\n      expect(mockFn).toHaveBeenLastCalledWith(['d', 'e', 'f']);\n    });\n  });\n});\n\ndescribe('immediate (===0) timer durations', () => {\n  describe('delay timer', () => {\n    it('invokedAt: start', async () => {\n      const mockFn = vi.fn();\n      const foo = funnel(mockFn, {\n        reducer: ARGS_COLLECTOR,\n        triggerAt: 'start',\n        minGapMs: 0,\n      });\n      foo.call('a');\n      foo.call('b');\n      foo.call('c');\n\n      expect(mockFn).toHaveBeenCalledTimes(1);\n      expect(mockFn).toHaveBeenLastCalledWith(['a']);\n\n      await sleep(0);\n      foo.call('d');\n      foo.call('e');\n      foo.call('f');\n\n      expect(mockFn).toHaveBeenCalledTimes(2);\n      // \"b\" and \"c\" have been ignored because the funnel is only configured to\n      // run the function at the start of the delay window, meaning anything\n      // after that is simply dropped.\n      expect(mockFn).toHaveBeenLastCalledWith(['d']);\n\n      await sleep(0);\n\n      expect(mockFn).toHaveBeenCalledTimes(2);\n    });\n\n    it('invokedAt: both', async () => {\n      const mockFn = vi.fn();\n      const foo = funnel(mockFn, {\n        reducer: ARGS_COLLECTOR,\n        triggerAt: 'both',\n        minGapMs: 0,\n      });\n      foo.call('a');\n      foo.call('b');\n      foo.call('c');\n\n      expect(mockFn).toHaveBeenCalledTimes(1);\n      expect(mockFn).toHaveBeenLastCalledWith(['a']);\n\n      await sleep(0);\n      foo.call('d');\n      foo.call('e');\n      foo.call('f');\n\n      expect(mockFn).toHaveBeenCalledTimes(2);\n      expect(mockFn).toHaveBeenLastCalledWith(['b', 'c']);\n\n      await sleep(0);\n\n      expect(mockFn).toHaveBeenCalledTimes(3);\n      expect(mockFn).toHaveBeenLastCalledWith(['d', 'e', 'f']);\n    });\n\n    it('with a non-trivial burst timer', async () => {\n      const mockFn = vi.fn();\n      const foo = funnel(mockFn, {\n        reducer: ARGS_COLLECTOR,\n        triggerAt: 'both',\n        minGapMs: 0,\n        minQuietPeriodMs: UT,\n      });\n      foo.call('a');\n\n      expect(mockFn).toHaveBeenCalledTimes(1);\n      expect(mockFn).toHaveBeenLastCalledWith(['a']);\n\n      foo.call('b');\n\n      expect(mockFn).toHaveBeenCalledTimes(1);\n\n      await sleep(UT);\n\n      expect(mockFn).toHaveBeenCalledTimes(2);\n      expect(mockFn).toHaveBeenLastCalledWith(['b']);\n    });\n  });\n\n  describe('burst timer', () => {\n    it('invokedAt: start', async () => {\n      const mockFn = vi.fn();\n      const foo = funnel(mockFn, {\n        reducer: ARGS_COLLECTOR,\n        triggerAt: 'start',\n        minQuietPeriodMs: 0,\n      });\n      foo.call('a');\n      foo.call('b');\n      foo.call('c');\n\n      expect(mockFn).toHaveBeenCalledTimes(1);\n      expect(mockFn).toHaveBeenLastCalledWith(['a']);\n\n      await sleep(0);\n      foo.call('d');\n      foo.call('e');\n      foo.call('f');\n\n      expect(mockFn).toHaveBeenCalledTimes(2);\n      // \"b\" and \"c\" have been ignored because the funnel is only configured to\n      // run the function at the start of the delay window, meaning anything\n      // after that is simply dropped.\n      expect(mockFn).toHaveBeenLastCalledWith(['d']);\n\n      await sleep(0);\n\n      expect(mockFn).toHaveBeenCalledTimes(2);\n    });\n\n    it('invokedAt: both', async () => {\n      const mockFn = vi.fn();\n      const foo = funnel(mockFn, {\n        reducer: ARGS_COLLECTOR,\n        triggerAt: 'both',\n        minQuietPeriodMs: 0,\n      });\n      foo.call('a');\n      foo.call('b');\n      foo.call('c');\n\n      expect(mockFn).toHaveBeenCalledTimes(1);\n      expect(mockFn).toHaveBeenLastCalledWith(['a']);\n\n      await sleep(0);\n\n      expect(mockFn).toHaveBeenCalledTimes(2);\n      expect(mockFn).toHaveBeenLastCalledWith(['b', 'c']);\n\n      foo.call('d');\n      foo.call('e');\n      foo.call('f');\n\n      expect(mockFn).toHaveBeenCalledTimes(3);\n      expect(mockFn).toHaveBeenLastCalledWith(['d']);\n\n      await sleep(0);\n\n      expect(mockFn).toHaveBeenCalledTimes(4);\n      expect(mockFn).toHaveBeenLastCalledWith(['e', 'f']);\n    });\n\n    it('invokedAt: end', async () => {\n      const mockFn = vi.fn();\n      const foo = funnel(mockFn, {\n        reducer: ARGS_COLLECTOR,\n        triggerAt: 'end',\n        minQuietPeriodMs: 0,\n      });\n      foo.call('a');\n      foo.call('b');\n      foo.call('c');\n\n      expect(mockFn).toHaveBeenCalledTimes(0);\n\n      await sleep(0);\n\n      expect(mockFn).toHaveBeenCalledTimes(1);\n      expect(mockFn).toHaveBeenLastCalledWith(['a', 'b', 'c']);\n\n      foo.call('d');\n      foo.call('e');\n      foo.call('f');\n\n      expect(mockFn).toHaveBeenCalledTimes(1);\n\n      await sleep(0);\n\n      expect(mockFn).toHaveBeenCalledTimes(2);\n      expect(mockFn).toHaveBeenLastCalledWith(['d', 'e', 'f']);\n    });\n\n    it('with a non-trivial delay timer', async () => {\n      const mockFn = vi.fn();\n      const foo = funnel(mockFn, {\n        reducer: ARGS_COLLECTOR,\n        triggerAt: 'both',\n        minGapMs: UT,\n        minQuietPeriodMs: 0,\n      });\n      foo.call('a');\n      foo.call('b');\n\n      expect(mockFn).toHaveBeenCalledTimes(1);\n      expect(mockFn).toHaveBeenLastCalledWith(['a']);\n\n      await sleep(0);\n\n      expect(mockFn).toHaveBeenCalledTimes(1);\n\n      await sleep(UT);\n\n      expect(mockFn).toHaveBeenCalledTimes(2);\n      expect(mockFn).toHaveBeenLastCalledWith(['b']);\n    });\n\n    it('burst timer with non-trivial maxBurstDuration', async () => {\n      const mockFn = vi.fn();\n      const foo = funnel(mockFn, {\n        reducer: ARGS_COLLECTOR,\n        minQuietPeriodMs: 0,\n        maxBurstDurationMs: UT,\n        triggerAt: 'end',\n      });\n      foo.call('a');\n      foo.call('b');\n      foo.call('c');\n\n      expect(mockFn).toHaveBeenCalledTimes(0);\n\n      await sleep(0);\n\n      expect(mockFn).toHaveBeenCalledTimes(1);\n      expect(mockFn).toHaveBeenLastCalledWith(['a', 'b', 'c']);\n    });\n  });\n\n  it('both timers', async () => {\n    const mockFn = vi.fn();\n    const foo = funnel(mockFn, {\n      reducer: ARGS_COLLECTOR,\n      triggerAt: 'both',\n      minGapMs: 0,\n      minQuietPeriodMs: 0,\n    });\n    foo.call('a');\n\n    expect(mockFn).toHaveBeenCalledTimes(1);\n    expect(mockFn).toHaveBeenLastCalledWith(['a']);\n\n    await sleep(0);\n\n    expect(mockFn).toHaveBeenCalledTimes(1);\n  });\n\n  it('maxBurstDurationMs = 0 limits the burst immediately', async () => {\n    const mockFn = vi.fn();\n    const foo = funnel(mockFn, {\n      reducer: ARGS_COLLECTOR,\n      triggerAt: 'end',\n      minQuietPeriodMs: UT,\n      maxBurstDurationMs: 0,\n    });\n    foo.call('a');\n    await sleep(0);\n\n    expect(mockFn).toHaveBeenCalledTimes(1);\n    expect(mockFn).toHaveBeenLastCalledWith(['a']);\n  });\n\n  it('all timeouts zero', async () => {\n    const mockFn = vi.fn();\n    const foo = funnel(mockFn, {\n      reducer: ARGS_COLLECTOR,\n      triggerAt: 'both',\n      minGapMs: 0,\n      minQuietPeriodMs: 0,\n      maxBurstDurationMs: 0,\n    });\n    foo.call('a');\n    foo.call('b');\n\n    expect(mockFn).toHaveBeenCalledTimes(1);\n    expect(mockFn).toHaveBeenLastCalledWith(['a']);\n\n    await sleep(0);\n\n    expect(mockFn).toHaveBeenCalledTimes(2);\n    expect(mockFn).toHaveBeenLastCalledWith(['b']);\n  });\n});\n\ndescribe('default minQuietPeriodMs === 0 when minGapMs is not defined', () => {\n  it('invokedAt: start', async () => {\n    const mockFn = vi.fn();\n    const foo = funnel(mockFn, {\n      reducer: ARGS_COLLECTOR,\n      triggerAt: 'start',\n    });\n    foo.call('a');\n\n    expect(mockFn).toHaveBeenCalledTimes(1);\n    expect(mockFn).toHaveBeenLastCalledWith(['a']);\n\n    foo.call('b');\n\n    expect(mockFn).toHaveBeenCalledTimes(1);\n\n    await sleep(0);\n\n    expect(mockFn).toHaveBeenCalledTimes(1);\n\n    foo.call('c');\n\n    expect(mockFn).toHaveBeenCalledTimes(2);\n    expect(mockFn).toHaveBeenLastCalledWith(['c']);\n  });\n\n  it('invokedAt: both', async () => {\n    const mockFn = vi.fn();\n    const foo = funnel(mockFn, {\n      reducer: ARGS_COLLECTOR,\n      triggerAt: 'both',\n    });\n    foo.call('a');\n\n    expect(mockFn).toHaveBeenCalledTimes(1);\n    expect(mockFn).toHaveBeenLastCalledWith(['a']);\n\n    foo.call('b');\n\n    expect(mockFn).toHaveBeenCalledTimes(1);\n\n    await sleep(0);\n\n    expect(mockFn).toHaveBeenCalledTimes(2);\n    expect(mockFn).toHaveBeenLastCalledWith(['b']);\n\n    foo.call('c');\n\n    expect(mockFn).toHaveBeenCalledTimes(3);\n    expect(mockFn).toHaveBeenLastCalledWith(['c']);\n  });\n});\n\ndescribe('utility functions', () => {\n  describe('flush', () => {\n    it('flush triggers an immediate invocation', async () => {\n      const mockFn = vi.fn();\n      const foo = funnel(mockFn, {\n        reducer: ARGS_COLLECTOR,\n        triggerAt: 'end',\n        minQuietPeriodMs: UT,\n      });\n      foo.call('a');\n      foo.call('b');\n      foo.call('c');\n      foo.flush();\n\n      expect(mockFn).toHaveBeenCalledTimes(1);\n      expect(mockFn).toHaveBeenLastCalledWith(['a', 'b', 'c']);\n\n      await sleep(UT);\n\n      expect(mockFn).toHaveBeenCalledTimes(1);\n    });\n\n    it('flush during active burst', async () => {\n      const mockFn = vi.fn();\n      const foo = funnel(mockFn, {\n        reducer: ARGS_COLLECTOR,\n        triggerAt: 'end',\n        minQuietPeriodMs: 2 * UT,\n      });\n      foo.call('a');\n      foo.call('b');\n      foo.call('c');\n\n      await sleep(UT);\n\n      foo.flush();\n\n      expect(mockFn).toHaveBeenCalledTimes(1);\n      expect(mockFn).toHaveBeenLastCalledWith(['a', 'b', 'c']);\n\n      await sleep(2 * UT);\n\n      expect(mockFn).toHaveBeenCalledTimes(1);\n    });\n  });\n\n  describe('cancel', () => {\n    it('cancel prevents invocation', async () => {\n      const mockFn = vi.fn();\n      const foo = funnel(mockFn, {\n        reducer: ARGS_COLLECTOR,\n        triggerAt: 'end',\n        minQuietPeriodMs: UT,\n      });\n      foo.call('a');\n      foo.call('b');\n      foo.call('c');\n      foo.cancel();\n      await sleep(UT);\n\n      expect(mockFn).toHaveBeenCalledTimes(0);\n    });\n\n    it('cancel during delay period', async () => {\n      const mockFn = vi.fn();\n      const foo = funnel(mockFn, {\n        reducer: ARGS_COLLECTOR,\n        triggerAt: 'start',\n        minGapMs: 2 * UT,\n      });\n      foo.call('a');\n      foo.call('b');\n\n      await sleep(UT);\n      foo.cancel();\n\n      await sleep(UT);\n\n      expect(mockFn).toHaveBeenCalledTimes(1);\n    });\n  });\n\n  describe('isIdle', () => {\n    it('isIdle reflects the funnel\\'s state', () => {\n      const mockFn = vi.fn();\n      const foo = funnel(mockFn, {\n        reducer: ARGS_COLLECTOR,\n        triggerAt: 'end',\n        minQuietPeriodMs: UT,\n      });\n\n      expect(foo.isIdle).toBe(true);\n\n      foo.call('a');\n\n      expect(foo.isIdle).toBe(false);\n\n      foo.cancel();\n\n      expect(foo.isIdle).toBe(true);\n    });\n\n    it('isIdle works when burst duration is 0', async () => {\n      const mockFn = vi.fn();\n      const foo = funnel(mockFn, {\n        reducer: ARGS_COLLECTOR,\n        triggerAt: 'end',\n        minQuietPeriodMs: 0,\n      });\n\n      expect(foo.isIdle).toBe(true);\n\n      foo.call('a');\n      foo.call('b');\n      foo.call('c');\n\n      expect(foo.isIdle).toBe(false);\n\n      await sleep(0);\n\n      expect(foo.isIdle).toBe(true);\n    });\n  });\n});\n\ndescribe('edge-cases', () => {\n  it('bursts that start late don\\'t prevent delayed invocations', async () => {\n    const mockFn = vi.fn();\n    const foo = funnel(mockFn, {\n      reducer: ARGS_COLLECTOR,\n      triggerAt: 'both',\n      minQuietPeriodMs: UT,\n      minGapMs: 2 * UT,\n    });\n    foo.call('a');\n    foo.call('b');\n    foo.call('c');\n\n    // We expect the function to be called once because we invoke it both at\n    // the start and end of the blackout periods.\n    expect(mockFn).toHaveBeenCalledTimes(1);\n    expect(mockFn).toHaveBeenLastCalledWith(['a']);\n\n    await sleep(1.5 * UT);\n\n    // But because our delay time is still longer, we still expect that the\n    // function hasn't been called yet again for the end of the blackout period.\n    expect(mockFn).toHaveBeenCalledTimes(1);\n\n    foo.call('d');\n    foo.call('e');\n    foo.call('f');\n\n    expect(mockFn).toHaveBeenCalledTimes(1);\n\n    await sleep(0.5 * UT);\n\n    // After the delay is over we expect the function to be invoked again for\n    // the end of the blackout period.\n    expect(mockFn).toHaveBeenCalledTimes(2);\n    expect(mockFn).toHaveBeenLastCalledWith(['b', 'c', 'd', 'e', 'f']);\n  });\n\n  it('delay timeouts don\\'t cause an invocation in the middle of bursts', async () => {\n    const mockFn = vi.fn();\n    const foo = funnel(mockFn, {\n      reducer: ARGS_COLLECTOR,\n      triggerAt: 'both',\n      minQuietPeriodMs: 2 * UT,\n      minGapMs: UT,\n    });\n    foo.call('a');\n\n    expect(mockFn).toHaveBeenCalledTimes(1);\n    expect(mockFn).toHaveBeenLastCalledWith(['a']);\n\n    await sleep(UT);\n    foo.call('b');\n\n    expect(mockFn).toHaveBeenCalledTimes(1);\n\n    await sleep(UT);\n    foo.call('c');\n\n    expect(mockFn).toHaveBeenCalledTimes(1);\n\n    await sleep(UT);\n    foo.call('d');\n\n    expect(mockFn).toHaveBeenCalledTimes(1);\n\n    await sleep(UT);\n\n    expect(mockFn).toHaveBeenCalledTimes(1);\n\n    await sleep(UT);\n\n    expect(mockFn).toHaveBeenCalledTimes(2);\n  });\n});\n"],"mappings":"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"}

package/dist/group-by-prop.d.cts

@@ -1,89 +0,0 @@
-import { t as IterableContainer } from "./iterable-container-1TN3AJ3s.cjs";
-import { t as TupleParts } from "./tuple-parts-CzQQupgi.cjs";
-import { t as BoundedPartial } from "./bounded-partial-CtOsGqxa.cjs";
-import { t as FilteredArray } from "./filtered-array-C--8loav.cjs";
-import { t as ArrayRequiredPrefix } from "./array-required-prefix-BFDM7eSS.cjs";
-import { AllUnionFields, ConditionalKeys, EmptyObject, IsNever, Or, Simplify } from "type-fest";
-
-//#region src/group-by-prop.d.ts
-type GroupByProp<T extends IterableContainer, Prop extends GroupableProps<T>> = T extends unknown ? FixEmptyObject<EnsureValuesAreNonEmpty<GroupByPropRaw<T, Prop>>> : never;
-type GroupByPropRaw<T extends IterableContainer, Prop extends GroupableProps<T>> = { [Value in AllPropValues<T, Prop>]: FilteredArray<T, Record<Prop, Value>> };
-type GroupableProps<T extends IterableContainer> = ConditionalKeys<ItemsSuperObject<T>, PropertyKey | undefined>;
-type AllPropValues<T extends IterableContainer, Prop extends GroupableProps<T>> = Extract<ItemsSuperObject<T>[Prop], PropertyKey>;
-type ItemsSuperObject<T extends IterableContainer> = AllUnionFields<Exclude<T[number], undefined>>;
-type FixEmptyObject<T> = IsNever<keyof T> extends true ? EmptyObject : T;
-type EnsureValuesAreNonEmpty<T extends Record<PropertyKey, IterableContainer>> = Simplify<Omit<T, PossiblyEmptyArrayKeys<T>> & BoundedPartial<CoercedNonEmptyValues<Pick<T, PossiblyEmptyArrayKeys<T>>>>>;
-type PossiblyEmptyArrayKeys<T extends Record<PropertyKey, IterableContainer>> = keyof T extends infer Key extends unknown ? Key extends keyof T ? IsNonEmptyArray<T[Key]> extends true ? never : Key : never : never;
-type IsNonEmptyArray<T extends IterableContainer> = Or<IsNonEmptyFixedTuple<TupleParts<T>['required']>, IsNonEmptyFixedTuple<TupleParts<T>['suffix']>>;
-type IsNonEmptyFixedTuple<T> = IsNever<Extract<T, readonly []>>;
-type CoercedNonEmptyValues<T extends Record<PropertyKey, IterableContainer>> = { [P in keyof T]: ArrayRequiredPrefix<T[P], 1> };
-/**
- * Groups the elements of an array of objects based on the values of a
- * specified property of those objects. The result would contain a property for
- * each unique value of the specific property, with it's value being the input
- * array filtered to only items that have that property set to that value.
- * For any object where the property is missing, or if it's value is
- * `undefined` the item would be filtered out.
- *
- * The grouping property is enforced at the type level to exist in at least one
- * item and to never have a value that cannot be used as an object key (e.g. it
- * must be `PropertyKey | undefined`).
- *
- * The resulting arrays are filtered with the prop and it's value as a
- * type-guard, effectively narrowing the items in each output arrays. This
- * means that when the grouping property is the discriminator of a
- * discriminated union type each output array would contain just the subtype for
- * that value.
- *
- * If you need more control over the grouping you should use `groupBy` instead.
- *
- * @param data - The items to group.
- * @param prop - The property name to group by.
- * @signature
- *    R.groupByProp(data, prop)
- * @example
- *    const result = R.groupByProp(
- *      //  ^? { cat: [{ a: 'cat' }], dog: [{ a: 'dog' }] }
- *      [{ a: 'cat' }, { a: 'dog' }] as const,
- *      'a',
- *    );
- * @dataFirst
- * @category Array
- */
-declare function groupByProp<T extends IterableContainer, const Prop extends GroupableProps<T>>(data: T, prop: Prop): GroupByProp<T, Prop>;
-/**
- * Groups the elements of an array of objects based on the values of a
- * specified property of those objects. The result would contain a property for
- * each unique value of the specific property, with it's value being the input
- * array filtered to only items that have that property set to that value.
- * For any object where the property is missing, or if it's value is
- * `undefined` the item would be filtered out.
- *
- * The grouping property is enforced at the type level to exist in at least one
- * item and to never have a value that cannot be used as an object key (e.g. it
- * must be `PropertyKey | undefined`).
- *
- * The resulting arrays are filtered with the prop and it's value as a
- * type-guard, effectively narrowing the items in each output arrays. This
- * means that when the grouping property is the discriminator of a
- * discriminated union type each output array would contain just the subtype for
- * that value.
- *
- * If you need more control over the grouping you should use `groupBy` instead.
- *
- * @param prop - The property name to group by.
- * @signature
- *    R.groupByProp(prop)(data);
- * @example
- *    const result = R.pipe(
- *      //  ^? { cat: [{ a: 'cat' }], dog: [{ a: 'dog' }] }
- *      [{ a: 'cat' }, { a: 'dog' }] as const,
- *      R.groupByProp('a'),
- *    );
- * @dataLast
- * @category Array
- */
-declare function groupByProp<T extends IterableContainer, const Prop extends GroupableProps<T>>(prop: Prop): (data: T) => GroupByProp<T, Prop>;
-//#endregion
-export { groupByProp };
-//# sourceMappingURL=group-by-prop.d.cts.map

package/dist/group-by-prop.d.cts.map

@@ -1 +0,0 @@
-{"version":3,"file":"group-by-prop.d.cts","names":[],"sources":["../src/group-by-prop.ts"],"sourcesContent":[],"mappings":"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"}

package/dist/group-by-prop.d.ts

@@ -1,89 +0,0 @@
-import { t as IterableContainer } from "./iterable-container-Dv5vSKht.js";
-import { t as TupleParts } from "./tuple-parts-BYI4o8Vk.js";
-import { t as BoundedPartial } from "./bounded-partial-CPc1XU57.js";
-import { t as FilteredArray } from "./filtered-array-wtIEwdU7.js";
-import { t as ArrayRequiredPrefix } from "./array-required-prefix-DwpaLy0D.js";
-import { AllUnionFields, ConditionalKeys, EmptyObject, IsNever, Or, Simplify } from "type-fest";
-
-//#region src/group-by-prop.d.ts
-type GroupByProp<T extends IterableContainer, Prop extends GroupableProps<T>> = T extends unknown ? FixEmptyObject<EnsureValuesAreNonEmpty<GroupByPropRaw<T, Prop>>> : never;
-type GroupByPropRaw<T extends IterableContainer, Prop extends GroupableProps<T>> = { [Value in AllPropValues<T, Prop>]: FilteredArray<T, Record<Prop, Value>> };
-type GroupableProps<T extends IterableContainer> = ConditionalKeys<ItemsSuperObject<T>, PropertyKey | undefined>;
-type AllPropValues<T extends IterableContainer, Prop extends GroupableProps<T>> = Extract<ItemsSuperObject<T>[Prop], PropertyKey>;
-type ItemsSuperObject<T extends IterableContainer> = AllUnionFields<Exclude<T[number], undefined>>;
-type FixEmptyObject<T> = IsNever<keyof T> extends true ? EmptyObject : T;
-type EnsureValuesAreNonEmpty<T extends Record<PropertyKey, IterableContainer>> = Simplify<Omit<T, PossiblyEmptyArrayKeys<T>> & BoundedPartial<CoercedNonEmptyValues<Pick<T, PossiblyEmptyArrayKeys<T>>>>>;
-type PossiblyEmptyArrayKeys<T extends Record<PropertyKey, IterableContainer>> = keyof T extends infer Key extends unknown ? Key extends keyof T ? IsNonEmptyArray<T[Key]> extends true ? never : Key : never : never;
-type IsNonEmptyArray<T extends IterableContainer> = Or<IsNonEmptyFixedTuple<TupleParts<T>['required']>, IsNonEmptyFixedTuple<TupleParts<T>['suffix']>>;
-type IsNonEmptyFixedTuple<T> = IsNever<Extract<T, readonly []>>;
-type CoercedNonEmptyValues<T extends Record<PropertyKey, IterableContainer>> = { [P in keyof T]: ArrayRequiredPrefix<T[P], 1> };
-/**
- * Groups the elements of an array of objects based on the values of a
- * specified property of those objects. The result would contain a property for
- * each unique value of the specific property, with it's value being the input
- * array filtered to only items that have that property set to that value.
- * For any object where the property is missing, or if it's value is
- * `undefined` the item would be filtered out.
- *
- * The grouping property is enforced at the type level to exist in at least one
- * item and to never have a value that cannot be used as an object key (e.g. it
- * must be `PropertyKey | undefined`).
- *
- * The resulting arrays are filtered with the prop and it's value as a
- * type-guard, effectively narrowing the items in each output arrays. This
- * means that when the grouping property is the discriminator of a
- * discriminated union type each output array would contain just the subtype for
- * that value.
- *
- * If you need more control over the grouping you should use `groupBy` instead.
- *
- * @param data - The items to group.
- * @param prop - The property name to group by.
- * @signature
- *    R.groupByProp(data, prop)
- * @example
- *    const result = R.groupByProp(
- *      //  ^? { cat: [{ a: 'cat' }], dog: [{ a: 'dog' }] }
- *      [{ a: 'cat' }, { a: 'dog' }] as const,
- *      'a',
- *    );
- * @dataFirst
- * @category Array
- */
-declare function groupByProp<T extends IterableContainer, const Prop extends GroupableProps<T>>(data: T, prop: Prop): GroupByProp<T, Prop>;
-/**
- * Groups the elements of an array of objects based on the values of a
- * specified property of those objects. The result would contain a property for
- * each unique value of the specific property, with it's value being the input
- * array filtered to only items that have that property set to that value.
- * For any object where the property is missing, or if it's value is
- * `undefined` the item would be filtered out.
- *
- * The grouping property is enforced at the type level to exist in at least one
- * item and to never have a value that cannot be used as an object key (e.g. it
- * must be `PropertyKey | undefined`).
- *
- * The resulting arrays are filtered with the prop and it's value as a
- * type-guard, effectively narrowing the items in each output arrays. This
- * means that when the grouping property is the discriminator of a
- * discriminated union type each output array would contain just the subtype for
- * that value.
- *
- * If you need more control over the grouping you should use `groupBy` instead.
- *
- * @param prop - The property name to group by.
- * @signature
- *    R.groupByProp(prop)(data);
- * @example
- *    const result = R.pipe(
- *      //  ^? { cat: [{ a: 'cat' }], dog: [{ a: 'dog' }] }
- *      [{ a: 'cat' }, { a: 'dog' }] as const,
- *      R.groupByProp('a'),
- *    );
- * @dataLast
- * @category Array
- */
-declare function groupByProp<T extends IterableContainer, const Prop extends GroupableProps<T>>(prop: Prop): (data: T) => GroupByProp<T, Prop>;
-//#endregion
-export { groupByProp };
-//# sourceMappingURL=group-by-prop.d.ts.map

package/dist/group-by-prop.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"group-by-prop.d.ts","names":[],"sources":["../src/group-by-prop.ts"],"sourcesContent":[],"mappings":"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"}