@vinicunca/perkakas 1.8.0 → 1.12.0

package/dist/funnel.test.js.map

@@ -1 +1 @@
-{"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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"}
+{"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.cjs

@@ -1 +1 @@
-require(`./lazy-data-last-impl-3PAFkslW.cjs`),require(`./curry-BPVIsvo3.cjs`);const e=require(`./group-by-prop-ByeUoeXV.cjs`);exports.groupByProp=e.groupByProp;
+const e=require(`./curry-BsY0Z8jH.cjs`);function t(...t){return e.t(n,t)}function n(e,t){let n=Object.create(null);for(let r of e){let e=r?.[t];if(e!==void 0){let t=n[e];t===void 0?n[e]=[r]:t.push(r)}}return Object.setPrototypeOf(n,Object.prototype),n}exports.groupByProp=t;

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

@@ -1,11 +1,89 @@
-import "./iterable-container-V5sa0V_H.cjs";
-import "./perkakas-type-error-0tHtaPbi.cjs";
-import "./tuple-parts-BIyABPYv.cjs";
-import "./is-bounded-record-kpsb1wQA.cjs";
-import "./bounded-partial-A89bt7Kj.cjs";
-import "./clamped-integer-subtract-DId0tRjp.cjs";
-import "./coerced-array-kVJtBrMl.cjs";
-import "./filtered-array-DQcAXQDD.cjs";
-import "./array-required-prefix-FSH3Acx8.cjs";
-import { groupByProp } from "./group-by-prop-CcSzCSuu.cjs";
-export { groupByProp };
+import { t as IterableContainer } from "./iterable-container-OFsaw8WL.cjs";
+import { t as TupleParts } from "./tuple-parts-BJQEORxn.cjs";
+import { t as BoundedPartial } from "./bounded-partial-D6ouPlXl.cjs";
+import { t as FilteredArray } from "./filtered-array-D_RqQ8tX.cjs";
+import { t as ArrayRequiredPrefix } from "./array-required-prefix-DxzEAAwi.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
+ *    P.groupByProp(data, prop)
+ * @example
+ *    const result = P.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
+ *    P.groupByProp(prop)(data);
+ * @example
+ *    const result = P.pipe(
+ *      //  ^? { cat: [{ a: 'cat' }], dog: [{ a: 'dog' }] }
+ *      [{ a: 'cat' }, { a: 'dog' }] as const,
+ *      P.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

@@ -0,0 +1 @@
+{"version":3,"file":"group-by-prop.d.cts","names":[],"sources":["../src/group-by-prop.ts"],"sourcesContent":[],"mappings":";;;;;;;;KAeK,sBAAsB,gCAAgC,eAAe,MAEtE,oBACE,eAAe,wBAAwB,eAAe,GAAG;KAK1D,yBACO,gCACG,eAAe,kBAElB,aAZI,CAYU,CAZV,EAYa,IAZb,CAAA,GAYqB,aAZrB,CAYmC,CAZnC,EAYsC,MAZtC,CAY6C,IAZ7C,EAYmD,KAZnD,CAAA,CAAA,EAAW;KAkBtB,cAlBqE,CAAA,UAkB5C,iBAlB4C,CAAA,GAkBvB,eAlBuB,CAmBxE,gBAnBwE,CAmBvD,CAnBuD,CAAA,EAoBxE,WApBwE,GAAA,SAAA,CAAA;KAwBrE,aAxBsD,CAAA,UAyB/C,iBAzB+C,EAAA,aA0B5C,cA1B4C,CA0B7B,CA1B6B,CAAA,CAAA,GA2BvD,OA3BuD,CA2B/C,gBA3B+C,CA2B9B,CA3B8B,CAAA,CA2B3B,IA3B2B,CAAA,EA2BpB,WA3BoB,CAAA;KAqCtD,gBAnCD,CAAA,UAmC4B,iBAnC5B,CAAA,GAmCiD,cAnCjD,CAwCF,OAxCE,CAwCM,CAxCN,CAAA,MAAA,CAAA,EAAA,SAAA,CAAA,CAAA;KAmDC,cAlDuD,CAAA,CAAA,CAAA,GAkDnC,OAlDmC,CAAA,MAkDrB,CAlDqB,CAAA,SAAA,IAAA,GAkDH,WAlDG,GAkDW,CAlDX;KAuDvD,uBAvD0D,CAAA,UAuDxB,MAvDwB,CAuDjB,WAvDiB,EAuDJ,iBAvDI,CAAA,CAAA,GAwD3D,QAxD2D,CAyD3D,IAzD2D,CAyDtD,CAzDsD,EAyDnD,sBAzDmD,CAyD5B,CAzD4B,CAAA,CAAA,GA0DzD,cA1DyD,CA0D1C,qBA1D0C,CA0DpB,IA1DoB,CA0Df,CA1De,EA0DZ,sBA1DY,CA0DW,CA1DX,CAAA,CAAA,CAAA,CAAA,CAAA;KA+D1D,sBA/DwC,CAAA,UA+DP,MA/DO,CA+DA,WA/DA,EA+Da,iBA/Db,CAAA,CAAA,GAAA,MAgEnC,CAhEmC,SAAA,KAAA,aAAA,OAAA,GAAA,GAAA,SAAA,MAiErB,CAjEqB,GAkErC,eAlEqC,CAkErB,CAlEqB,CAkEnB,GAlEmB,CAAA,CAAA,SAAA,IAAA,GAAA,KAAA,GAAA,GAAA,GAAA,KAAA,GAAA,KAAA;KAyExC,eAzEgB,CAAA,UAyEU,iBAzEV,CAAA,GAyE+B,EAzE/B,CA0EnB,oBA1EmB,CA0EE,UA1EF,CA0Ea,CA1Eb,CAAA,CAAA,UAAA,CAAA,CAAA,EA2EnB,oBA3EmB,CA2EE,UA3EF,CA2Ea,CA3Eb,CAAA,CAAA,QAAA,CAAA,CAAA,CAAA;KAgFhB,oBAhFC,CAAA,CAAA,CAAA,GAgFyB,OAhFzB,CAgFiC,OAhFjC,CAgFyC,CAhFzC,EAAA,SAAA,EAAA,CAAA,CAAA;KAmFD,qBAnFe,CAAA,UAmFiB,MAnFjB,CAmFwB,WAnFxB,EAmFqC,iBAnFrC,CAAA,CAAA,GAAA,QAKf,MA+ES,CA/ET,GA+Ea,mBA/EC,CA+EmB,CA/EnB,CA+EqB,CA/ErB,CAAA,EAAA,CAAA,CAAA,EACP;;;;;;;;;;;;AAGsC;;;;;;;AAMgB;;;;;;;;;;AASvD;;;;;AAUwD,iBAsFnD,WAtFmD,CAAA,UAuFvD,iBAvFuD,EAAA,mBAwF9C,cAxF8C,CAwF/B,CAxF+B,CAAA,CAAA,CAAA,IAAA,EAyF3D,CAzF2D,EAAA,IAAA,EAyFlD,IAzFkD,CAAA,EAyF3C,WAzF2C,CAyF/B,CAzF+B,EAyF5B,IAzF4B,CAAA;AAAA;;;;;;AAgBK;;;;;;;;;;;;;;;;AAM5D;;;;;;;;;;AAiBP,iBAoFW,WApFI,CAAA,UAqFR,iBArFQ,EAAA,mBAsFC,cAtFD,CAsFgB,CAtFhB,CAAA,CAAA,CAAA,IAAA,EAuFZ,IAvFY,CAAA,EAAA,CAAA,IAAA,EAuFE,CAvFF,EAAA,GAuFQ,WAvFR,CAuFoB,CAvFpB,EAuFuB,IAvFvB,CAAA"}

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

@@ -1,11 +1,89 @@
-import "./iterable-container-wtkYslN_.js";
-import "./perkakas-type-error-Da3ni385.js";
-import "./tuple-parts-BxpZLJ7r.js";
-import "./is-bounded-record-DCEYRY41.js";
-import "./bounded-partial-TshEjJC1.js";
-import "./clamped-integer-subtract-CQL8aT__.js";
-import "./coerced-array-DyA0Yc12.js";
-import "./filtered-array-BGEkFwrv.js";
-import "./array-required-prefix-BeSNHH4G.js";
-import { groupByProp } from "./group-by-prop--MehVKql.js";
-export { groupByProp };
+import { t as IterableContainer } from "./iterable-container-BdjPuIjL.js";
+import { t as TupleParts } from "./tuple-parts-Bhbm4jiu.js";
+import { t as BoundedPartial } from "./bounded-partial-DBIIClPU.js";
+import { t as FilteredArray } from "./filtered-array-Yij-X3T4.js";
+import { t as ArrayRequiredPrefix } from "./array-required-prefix-CefHtaKs.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
+ *    P.groupByProp(data, prop)
+ * @example
+ *    const result = P.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
+ *    P.groupByProp(prop)(data);
+ * @example
+ *    const result = P.pipe(
+ *      //  ^? { cat: [{ a: 'cat' }], dog: [{ a: 'dog' }] }
+ *      [{ a: 'cat' }, { a: 'dog' }] as const,
+ *      P.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

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

package/dist/group-by-prop.js

@@ -1 +1,2 @@
-import"./lazy-data-last-impl-7QfM1xXg.js";import"./curry-CzZjDrpv.js";import{groupByProp as e}from"./group-by-prop-Gi66eXCp.js";export{e as groupByProp};
+import{t as e}from"./curry-BcQ8Up1_.js";function t(...t){return e(n,t)}function n(e,t){let n=Object.create(null);for(let r of e){let e=r?.[t];if(e!==void 0){let t=n[e];t===void 0?n[e]=[r]:t.push(r)}}return Object.setPrototypeOf(n,Object.prototype),n}export{t as groupByProp};
+//# sourceMappingURL=group-by-prop.js.map

package/dist/group-by-prop.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"group-by-prop.js","names":["output: BoundedPartial<\n    Record<AllPropValues<T, Prop>, Array<T[number]>>\n  >"],"sources":["../src/group-by-prop.ts"],"sourcesContent":["import type {\n  AllUnionFields,\n  ConditionalKeys,\n  EmptyObject,\n  IsNever,\n  Or,\n  Simplify,\n} from 'type-fest';\nimport type { ArrayRequiredPrefix } from './internal/types/array-required-prefix';\nimport type { BoundedPartial } from './internal/types/bounded-partial';\nimport type { FilteredArray } from './internal/types/filtered-array';\nimport type { IterableContainer } from './internal/types/iterable-container';\nimport type { TupleParts } from './internal/types/tuple-parts';\nimport { curry } from './curry';\n\ntype GroupByProp<T extends IterableContainer, Prop extends GroupableProps<T>>\n  // Distribute unions.\n  = T extends unknown\n    ? FixEmptyObject<EnsureValuesAreNonEmpty<GroupByPropRaw<T, Prop>>>\n    : never;\n\n// For each possible value of the prop we filter the input tuple with the prop\n// assigned to the value, e.g. `{ type: \"cat\" }`\ntype GroupByPropRaw<\n  T extends IterableContainer,\n  Prop extends GroupableProps<T>,\n> = {\n  [Value in AllPropValues<T, Prop>]: FilteredArray<T, Record<Prop, Value>>;\n};\n\n// We can only group by props that only have values that could be used to key\n// an object (i.e. PropertyKey), or if they are undefined (which would filter\n// them out of the grouping).\ntype GroupableProps<T extends IterableContainer> = ConditionalKeys<\n  ItemsSuperObject<T>,\n  PropertyKey | undefined\n>;\n\n// The union of all possible values that the prop could have within the tuple.\ntype AllPropValues<\n  T extends IterableContainer,\n  Prop extends GroupableProps<T>,\n> = Extract<ItemsSuperObject<T>[Prop], PropertyKey>;\n\n// Creates a singular object type that all items in the tuple would extend. This\n// provides us a way to check, for each prop, what are all values it would\n// have within the tuple. We use this to map which props are candidates for\n// grouping, and when a prop is selected, the full list of values that would\n// exist in the output. For example:\n// `{ a: number, b: \"cat\", c: string } | { b: \"dog\", c: Date }` is groupable\n// by 'a' and 'b', but not 'c', and when selecting by 'b', the output would\n// have a prop for \"cat\" and a prop for \"dog\".\ntype ItemsSuperObject<T extends IterableContainer> = AllUnionFields<\n  // If the input tuple contains optional elements they would add `undefined` to\n  // T[number] (and could technically show up in the array itself). Because\n  // undefined breaks AllUnionFields we need to remove it from the union. This\n  // is OK because we handle this in the implementation too.\n  Exclude<T[number], undefined>\n>;\n\n// When the input array is empty the constructed result type would be `{}`\n// because our mapped type would never run; but this doesn't represent the\n// semantics of the return value for that case, because it effectively means\n// \"any object\" and not \"empty object\". This can happen in 2 situations:\n// A union of tuples where one of the tuples doesn't have any item with the\n// groupable prop, or when the groupable prop has a value of `undefined` for\n// all items. The former is extra problematic because it would add `| {}` to the\n// result type which effectively cancels out all other parts of the union.\ntype FixEmptyObject<T> = IsNever<keyof T> extends true ? EmptyObject : T;\n\n// Group by can never return an empty tuple but our filtered arrays might not\n// represent that. We need to reshape the tuples so that they always have at\n// least one item in them.\ntype EnsureValuesAreNonEmpty<T extends Record<PropertyKey, IterableContainer>>\n  = Simplify<\n    Omit<T, PossiblyEmptyArrayKeys<T>>\n    & BoundedPartial<CoercedNonEmptyValues<Pick<T, PossiblyEmptyArrayKeys<T>>>>\n  >;\n\n// Go over the keys the object and return those that their value can accept an\n// empty array.\ntype PossiblyEmptyArrayKeys<T extends Record<PropertyKey, IterableContainer>>\n  = keyof T extends infer Key extends unknown\n    ? Key extends keyof T\n      ? IsNonEmptyArray<T[Key]> extends true\n        ? never\n        : Key\n      : never\n    : never;\n\n// An array is non-empty if any of the fixed parts are non-empty.\ntype IsNonEmptyArray<T extends IterableContainer> = Or<\n  IsNonEmptyFixedTuple<TupleParts<T>['required']>,\n  IsNonEmptyFixedTuple<TupleParts<T>['suffix']>\n>;\n\n// A fixed tuple (one without optional or a rest element in it) is non-empty if\n// we can't extract the empty tuple from it.\ntype IsNonEmptyFixedTuple<T> = IsNever<Extract<T, readonly []>>;\n\n// We coerce the arbitrary array values to have a prefix of at least one item.\ntype CoercedNonEmptyValues<T extends Record<PropertyKey, IterableContainer>> = {\n  [P in keyof T]: ArrayRequiredPrefix<T[P], 1>;\n};\n\n/**\n * Groups the elements of an array of objects based on the values of a\n * specified property of those objects. The result would contain a property for\n * each unique value of the specific property, with it's value being the input\n * array filtered to only items that have that property set to that value.\n * For any object where the property is missing, or if it's value is\n * `undefined` the item would be filtered out.\n *\n * The grouping property is enforced at the type level to exist in at least one\n * item and to never have a value that cannot be used as an object key (e.g. it\n * must be `PropertyKey | undefined`).\n *\n * The resulting arrays are filtered with the prop and it's value as a\n * type-guard, effectively narrowing the items in each output arrays. This\n * means that when the grouping property is the discriminator of a\n * discriminated union type each output array would contain just the subtype for\n * that value.\n *\n * If you need more control over the grouping you should use `groupBy` instead.\n *\n * @param data - The items to group.\n * @param prop - The property name to group by.\n * @signature\n *    P.groupByProp(data, prop)\n * @example\n *    const result = P.groupByProp(\n *      //  ^? { cat: [{ a: 'cat' }], dog: [{ a: 'dog' }] }\n *      [{ a: 'cat' }, { a: 'dog' }] as const,\n *      'a',\n *    );\n * @dataFirst\n * @category Array\n */\nexport function groupByProp<\n  T extends IterableContainer,\n  const Prop extends GroupableProps<T>,\n>(data: T, prop: Prop): GroupByProp<T, Prop>;\n\n/**\n * Groups the elements of an array of objects based on the values of a\n * specified property of those objects. The result would contain a property for\n * each unique value of the specific property, with it's value being the input\n * array filtered to only items that have that property set to that value.\n * For any object where the property is missing, or if it's value is\n * `undefined` the item would be filtered out.\n *\n * The grouping property is enforced at the type level to exist in at least one\n * item and to never have a value that cannot be used as an object key (e.g. it\n * must be `PropertyKey | undefined`).\n *\n * The resulting arrays are filtered with the prop and it's value as a\n * type-guard, effectively narrowing the items in each output arrays. This\n * means that when the grouping property is the discriminator of a\n * discriminated union type each output array would contain just the subtype for\n * that value.\n *\n * If you need more control over the grouping you should use `groupBy` instead.\n *\n * @param prop - The property name to group by.\n * @signature\n *    P.groupByProp(prop)(data);\n * @example\n *    const result = P.pipe(\n *      //  ^? { cat: [{ a: 'cat' }], dog: [{ a: 'dog' }] }\n *      [{ a: 'cat' }, { a: 'dog' }] as const,\n *      P.groupByProp('a'),\n *    );\n * @dataLast\n * @category Array\n */\nexport function groupByProp<\n  T extends IterableContainer,\n  const Prop extends GroupableProps<T>,\n>(prop: Prop): (data: T) => GroupByProp<T, Prop>;\n\nexport function groupByProp(...args: ReadonlyArray<unknown>): unknown {\n  return curry(groupByPropImplementation, args);\n}\n\nfunction groupByPropImplementation<\n  T extends IterableContainer,\n  Prop extends GroupableProps<T>,\n>(data: T, prop: Prop): GroupByProp<T, Prop> {\n  const output: BoundedPartial<\n    Record<AllPropValues<T, Prop>, Array<T[number]>>\n  > = Object.create(null);\n\n  for (const item of data) {\n    // @ts-expect-error [ts18046] -- `item` should be typed `T[number]` but TypeScript isn't inferring that correctly here, in fact, the item could also be typed as ItemsSuperObject<T> because it extends from it. When item is typed as such this error goes away, maybe in the future TypeScript would be able to infer this by itself.\n\n    const key = item?.[prop];\n    if (key !== undefined) {\n      // Once the prototype chain is fixed, it is safe to access the prop\n      // directly without needing to check existence or types.\n      // @ts-expect-error [ts7053] -- `key` should be typed `AllPropValues<T, Prop>` but TypeScript isn't inferring that correctly, causing an error when we try to access this prop on the output object.\n      const items = output[key];\n\n      if (items === undefined) {\n        // It is more performant to create a 1-element array over creating an\n        // empty array and falling through to a unified the push. It is also\n        // more performant to mutate the existing object over using spread to\n        // continually create new objects on every unique key.\n        // @ts-expect-error [ts7053] -- For the same reasons as mentioned above, TypeScript isn't inferring `key` correctly, and therefore is erroring when trying to access the output object using it.\n        output[key] = [item];\n      } else {\n        // It is more performant to add the items to an existing array instead\n        // of creating a new array via spreading every time we add an item to\n        // it (e.g., `[...current, item]`).\n        items.push(item);\n      }\n    }\n  }\n\n  // Set the prototype as if we initialized our object as a normal object (e.g.\n  // `{}`). Without this none of the built-in object methods like `toString`\n  // would work on this object and it would act differently than expected.\n  Object.setPrototypeOf(output, Object.prototype);\n\n  // @ts-expect-error [ts2322] -- This is fine! We use a broader type for output while we build it because it more accurately represents the shape of the object *while it is being built*. TypeScript can't tell that we finished building the object so can't ensure that output matches the expected output at this point.\n  return output;\n}\n"],"mappings":"wCAoLA,SAAgB,EAAY,GAAG,EAAuC,CACpE,OAAO,EAAM,EAA2B,EAAK,CAG/C,SAAS,EAGP,EAAS,EAAkC,CAC3C,IAAMA,EAEF,OAAO,OAAO,KAAK,CAEvB,IAAK,IAAM,KAAQ,EAAM,CAGvB,IAAM,EAAM,IAAO,GACnB,GAAI,IAAQ,IAAA,GAAW,CAIrB,IAAM,EAAQ,EAAO,GAEjB,IAAU,IAAA,GAMZ,EAAO,GAAO,CAAC,EAAK,CAKpB,EAAM,KAAK,EAAK,EAWtB,OAHA,OAAO,eAAe,EAAQ,OAAO,UAAU,CAGxC"}

package/dist/group-by.cjs

@@ -1 +1 @@
-require(`./lazy-data-last-impl-3PAFkslW.cjs`),require(`./curry-BPVIsvo3.cjs`);const e=require(`./group-by-057Glgkg.cjs`);exports.groupBy=e.groupBy;
+const e=require(`./curry-BsY0Z8jH.cjs`);function t(...t){return e.t(n,t)}function n(e,t){let n=Object.create(null);for(let r=0;r<e.length;r++){let i=e[r],a=t(i,r,e);if(a!==void 0){let e=n[a];e===void 0?n[a]=[i]:e.push(i)}}return Object.setPrototypeOf(n,Object.prototype),n}exports.groupBy=t;

package/dist/group-by.d.cts

@@ -1,5 +1,69 @@
-import "./non-empty-array-D3ZRHApS.cjs";
-import "./is-bounded-record-kpsb1wQA.cjs";
-import "./bounded-partial-A89bt7Kj.cjs";
-import { groupBy } from "./group-by-DDS1NPHf.cjs";
-export { groupBy };
+import { t as NonEmptyArray } from "./non-empty-array-CFG7wGD-.cjs";
+import { t as BoundedPartial } from "./bounded-partial-D6ouPlXl.cjs";
+
+//#region src/group-by.d.ts
+
+/**
+ * Groups the elements of a given iterable according to the string values
+ * returned by a provided callback function. The returned object has separate
+ * properties for each group, containing arrays with the elements in the group.
+ * Unlike the built in `Object.groupBy` this function also allows the callback to
+ * return `undefined` in order to exclude the item from being added to any
+ * group.
+ *
+ * If you are grouping objects by a property of theirs (e.g.
+ * `groupBy(data, ({ myProp }) => myProp)` or `groupBy(data, prop('myProp'))`)
+ * consider using `groupByProp` (e.g. `groupByProp(data, 'myProp')`) instead,
+ * as it would provide better typing.
+ *
+ * @param data - The items to group.
+ * @param callbackfn - A function to execute for each element in the iterable.
+ * It should return a value indicating the group of the current element, or
+ * `undefined` when the item should be excluded from any group.
+ * @returns An object with properties for all groups, each assigned to an array
+ * containing the elements of the associated group.
+ * @signature
+ *    P.groupBy(data, callbackfn)
+ * @example
+ *    P.groupBy([{a: 'cat'}, {a: 'dog'}] as const, P.prop('a')) // => {cat: [{a: 'cat'}], dog: [{a: 'dog'}]}
+ *    P.groupBy([0, 1], x => x % 2 === 0 ? 'even' : undefined) // => {even: [0]}
+ * @dataFirst
+ * @category Array
+ */
+declare function groupBy<T, Key extends PropertyKey = PropertyKey>(data: ReadonlyArray<T>, callbackfn: (value: T, index: number, data: ReadonlyArray<T>) => Key | undefined): BoundedPartial<Record<Key, NonEmptyArray<T>>>;
+/**
+ * Groups the elements of a given iterable according to the string values
+ * returned by a provided callback function. The returned object has separate
+ * properties for each group, containing arrays with the elements in the group.
+ * Unlike the built in `Object.groupBy` this function also allows the callback to
+ * return `undefined` in order to exclude the item from being added to any
+ * group.
+ *
+ *  If you are grouping objects by a property of theirs (e.g.
+ * `groupBy(data, ({ myProp }) => myProp)` or `groupBy(data, prop('myProp'))`)
+ * consider using `groupByProp` (e.g. `groupByProp(data, 'myProp')`) instead,
+ * as it would provide better typing.
+ *
+ * @param callbackfn - A function to execute for each element in the iterable.
+ * It should return a value indicating the group of the current element, or
+ * `undefined` when the item should be excluded from any group.
+ * @returns An object with properties for all groups, each assigned to an array
+ * containing the elements of the associated group.
+ * @signature
+ *    P.groupBy(callbackfn)(data);
+ * @example
+ *    P.pipe(
+ *      [{a: 'cat'}, {a: 'dog'}] as const,
+ *      P.groupBy(P.prop('a')),
+ *    ); // => {cat: [{a: 'cat'}], dog: [{a: 'dog'}]}
+ *    P.pipe(
+ *      [0, 1],
+ *      P.groupBy(x => x % 2 === 0 ? 'even' : undefined),
+ *    ); // => {even: [0]}
+ * @dataLast
+ * @category Array
+ */
+declare function groupBy<T, Key extends PropertyKey = PropertyKey>(callbackfn: (value: T, index: number, data: ReadonlyArray<T>) => Key | undefined): (items: ReadonlyArray<T>) => BoundedPartial<Record<Key, NonEmptyArray<T>>>;
+//#endregion
+export { groupBy };
+//# sourceMappingURL=group-by.d.cts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"group-by.d.cts","names":[],"sources":["../src/group-by.ts"],"sourcesContent":[],"mappings":";;;;;;;AAgCA;;;;;;;;;;;;;;;AAyCA;;;;;;;;;;AAMyE,iBA/CzD,OA+CyD,CAAA,CAAA,EAAA,YA/ClC,WA+CkC,GA/CpB,WA+CoB,CAAA,CAAA,IAAA,EA9CjE,aA8CiE,CA9CnD,CA8CmD,CAAA,EAAA,UAAA,EAAA,CAAA,KAAA,EA5C9D,CA4C8D,EAAA,KAAA,EAAA,MAAA,EAAA,IAAA,EA1C/D,aA0C+D,CA1CjD,CA0CiD,CAAA,EAAA,GAzClE,GAyCkE,GAAA,SAAA,CAAA,EAxCtE,cAwCsE,CAxCvD,MAwCuD,CAxChD,GAwCgD,EAxC3C,aAwC2C,CAxC7B,CAwC6B,CAAA,CAAA,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBANzD,uBAAuB,cAAc,iCAE1C,wBAED,cAAc,OACjB,0BACI,cAAc,OAAO,eAAe,OAAO,KAAK,cAAc"}