@vinicunca/perkakas 1.8.0 → 1.12.0

package/dist/is-emptyish.test-d.cjs

@@ -0,0 +1 @@
+const e=require(`./dist-CiyBKPT6.cjs`),t=require(`./is-emptyish.cjs`);new Int8Array(1),Buffer.alloc(0),e.i(`strings`,()=>{e.o(`primitives`,()=>{let n=`test`;t.isEmptyish(n),(0,e.t.expectTypeOf)(n).toEqualTypeOf()}),e.o(`empty literal`,()=>{t.isEmptyish(``),(0,e.t.expectTypeOf)(``).toEqualTypeOf()}),e.o(`non-empty literals`,()=>{let n=`test`;t.isEmptyish(n),(0,e.t.expectTypeOf)(n).toEqualTypeOf()}),e.o(`union of non-empty literals`,()=>{t.isEmptyish(`cat`),(0,e.t.expectTypeOf)(`cat`).toEqualTypeOf()}),e.o(`union with an empty literal`,()=>{t.isEmptyish(``),(0,e.t.expectTypeOf)(``).toEqualTypeOf()}),e.o(`non-empty string templates`,()=>{let n=`prefix_0`;t.isEmptyish(n),(0,e.t.expectTypeOf)(n).toEqualTypeOf()}),e.o(`string template (with empty)`,()=>{t.isEmptyish(``),(0,e.t.expectTypeOf)(``).toEqualTypeOf()}),e.o(`empty-able string template`,()=>{t.isEmptyish(``),(0,e.t.expectTypeOf)(``).toEqualTypeOf()})}),e.i(`branded`,()=>{e.o(`primitive`,()=>{t.isEmptyish(``),(0,e.t.expectTypeOf)(``).toEqualTypeOf()}),e.o(`non-empty literal`,()=>{let n=`test`;t.isEmptyish(n),(0,e.t.expectTypeOf)(n).toEqualTypeOf()}),e.o(`empty literal`,()=>{t.isEmptyish(``),(0,e.t.expectTypeOf)(``).toEqualTypeOf()}),e.o(`union of non-empty literals`,()=>{t.isEmptyish(`cat`),(0,e.t.expectTypeOf)(`cat`).toEqualTypeOf()}),e.o(`union of empty and non-empty literals`,()=>{t.isEmptyish(``),(0,e.t.expectTypeOf)(``).toEqualTypeOf()})}),e.i(`nullish`,()=>{e.o(`null`,()=>{t.isEmptyish(null),(0,e.t.expectTypeOf)(null).toEqualTypeOf()}),e.o(`undefined`,()=>{t.isEmptyish(void 0),(0,e.t.expectTypeOf)(void 0).toEqualTypeOf()}),e.o(`optional nullable`,()=>{t.isEmptyish(null),(0,e.t.expectTypeOf)(null).toEqualTypeOf()}),e.o(`optional primitive`,()=>{t.isEmptyish(void 0),(0,e.t.expectTypeOf)(void 0).toEqualTypeOf()}),e.o(`optional non-empty literal`,()=>{t.isEmptyish(`cat`),(0,e.t.expectTypeOf)(`cat`).toEqualTypeOf()}),e.o(`optional empty literal`,()=>{t.isEmptyish(``),(0,e.t.expectTypeOf)(``).toEqualTypeOf()}),e.o(`nullable primitive`,()=>{t.isEmptyish(null),(0,e.t.expectTypeOf)(null).toEqualTypeOf()}),e.o(`nullable non-empty literal`,()=>{t.isEmptyish(`cat`),(0,e.t.expectTypeOf)(`cat`).toEqualTypeOf()}),e.o(`nullable empty literal`,()=>{t.isEmptyish(``),(0,e.t.expectTypeOf)(``).toEqualTypeOf()}),e.o(`optional, nullable, empty, and non-empty`,()=>{t.isEmptyish(``),(0,e.t.expectTypeOf)(``).toEqualTypeOf()})}),e.i(`all tuple shapes`,()=>{e.o(`empty tuple`,()=>{let n=[];t.isEmptyish(n),(0,e.t.expectTypeOf)(n).toEqualTypeOf()}),e.o(`empty readonly tuple`,()=>{let n=[];t.isEmptyish(n),(0,e.t.expectTypeOf)(n).toEqualTypeOf()}),e.o(`fixed tuple`,()=>{let n=[1,2,3];t.isEmptyish(n),(0,e.t.expectTypeOf)(n).toEqualTypeOf()}),e.o(`fixed readonly tuple`,()=>{let n=[1,2,3];t.isEmptyish(n),(0,e.t.expectTypeOf)(n).toEqualTypeOf()}),e.o(`array`,()=>{let n=[];t.isEmptyish(n)?(0,e.t.expectTypeOf)(n).toExtend():(0,e.t.expectTypeOf)(n).toEqualTypeOf()}),e.o(`readonly array`,()=>{let n=[];t.isEmptyish(n),(0,e.t.expectTypeOf)(n).toEqualTypeOf()}),e.o(`optional tuple`,()=>{let n=[];t.isEmptyish(n)?(0,e.t.expectTypeOf)(n).toExtend():(0,e.t.expectTypeOf)(n).toEqualTypeOf()}),e.o(`readonly optional tuple`,()=>{let n=[];t.isEmptyish(n),(0,e.t.expectTypeOf)(n).toEqualTypeOf()}),e.o(`fixed-prefix array`,()=>{let n=[1];t.isEmptyish(n),(0,e.t.expectTypeOf)(n).toEqualTypeOf()}),e.o(`readonly fixed-prefix array`,()=>{let n=[1];t.isEmptyish(n),(0,e.t.expectTypeOf)(n).toEqualTypeOf()}),e.o(`fixed-suffix array`,()=>{let n=[1];t.isEmptyish(n),(0,e.t.expectTypeOf)(n).toEqualTypeOf()}),e.o(`readonly fixed-suffix array`,()=>{let n=[1];t.isEmptyish(n),(0,e.t.expectTypeOf)(n).toEqualTypeOf()}),e.o(`mixed tuples`,()=>{let n=[1];t.isEmptyish(n),(0,e.t.expectTypeOf)(n).toEqualTypeOf()}),e.o(`readonly mixed tuples`,()=>{let n=[1];t.isEmptyish(n),(0,e.t.expectTypeOf)(n).toEqualTypeOf()}),e.o(`optional prefix arrays`,()=>{let n=[];t.isEmptyish(n)?(0,e.t.expectTypeOf)(n).toExtend():(0,e.t.expectTypeOf)(n).toEqualTypeOf()}),e.o(`readonly optional prefix arrays`,()=>{let n=[];t.isEmptyish(n),(0,e.t.expectTypeOf)(n).toEqualTypeOf()}),e.o(`fixed-elements array`,()=>{let n=[1,2];t.isEmptyish(n),(0,e.t.expectTypeOf)(n).toEqualTypeOf()}),e.o(`readonly fixed-elements array`,()=>{let n=[1,2];t.isEmptyish(n),(0,e.t.expectTypeOf)(n).toEqualTypeOf()})}),e.i(`array-like`,()=>{e.o(`typed arrays`,()=>{let n={};t.isEmptyish(n)?(0,e.t.expectTypeOf)(n).toExtend():(0,e.t.expectTypeOf)(n).toEqualTypeOf()}),e.o(`buffers`,()=>{let n={};t.isEmptyish(n)?(0,e.t.expectTypeOf)(n).toExtend():(0,e.t.expectTypeOf)(n).toEqualTypeOf()}),e.o(`sets`,()=>{let n=new Set;t.isEmptyish(n)?(0,e.t.expectTypeOf)(n).toExtend():(0,e.t.expectTypeOf)(n).toEqualTypeOf()}),e.o(`readonly sets`,()=>{let n=new Set;t.isEmptyish(n),(0,e.t.expectTypeOf)(n).toEqualTypeOf()}),e.o("array-like (e.g., `arguments`)",()=>{})}),e.i(`plain objects`,()=>{e.o(`never record`,()=>{let n={};t.isEmptyish(n),(0,e.t.expectTypeOf)(n).toEqualTypeOf()}),e.o(`readonly never record`,()=>{let n={};t.isEmptyish(n),(0,e.t.expectTypeOf)(n).toEqualTypeOf()}),e.o(`plain object`,()=>{let n={a:123,b:`hello`};t.isEmptyish(n),(0,e.t.expectTypeOf)(n).toEqualTypeOf()}),e.o(`readonly plain object`,()=>{let n={a:123,b:`hello`};t.isEmptyish(n),(0,e.t.expectTypeOf)(n).toEqualTypeOf()}),e.o(`unbounded record`,()=>{let n={};t.isEmptyish(n)?(0,e.t.expectTypeOf)(n).toExtend():(0,e.t.expectTypeOf)(n).toEqualTypeOf()}),e.o(`readonly unbounded record`,()=>{let n={};t.isEmptyish(n),(0,e.t.expectTypeOf)(n).toEqualTypeOf()}),e.o(`partial bounded record`,()=>{let n={};t.isEmptyish(n)?(0,e.t.expectTypeOf)(n).toExtend():(0,e.t.expectTypeOf)(n).toEqualTypeOf()}),e.o(`readonly partial bounded record`,()=>{let n={};t.isEmptyish(n),(0,e.t.expectTypeOf)(n).toEqualTypeOf()}),e.o(`partial and required props`,()=>{let n={};t.isEmptyish(n),(0,e.t.expectTypeOf)(n).toEqualTypeOf()}),e.o(`required interfaces`,()=>{let n={};t.isEmptyish(n),(0,e.t.expectTypeOf)(n).toEqualTypeOf()}),e.o(`optional interfaces`,()=>{let n={};t.isEmptyish(n)?(0,e.t.expectTypeOf)(n).toExtend():(0,e.t.expectTypeOf)(n).toEqualTypeOf()}),e.o(`optional readonly interfaces`,()=>{let n={};t.isEmptyish(n),(0,e.t.expectTypeOf)(n).toEqualTypeOf()}),e.o(`required prop and index signature`,()=>{let n={a:`hello`};t.isEmptyish(n),(0,e.t.expectTypeOf)(n).toEqualTypeOf()}),e.o(`readonly required prop and index signature`,()=>{let n={a:`hello`};t.isEmptyish(n),(0,e.t.expectTypeOf)(n).toEqualTypeOf()}),e.o(`optional prop and index signature`,()=>{let n={};t.isEmptyish(n)?(0,e.t.expectTypeOf)(n).toExtend():(0,e.t.expectTypeOf)(n).toEqualTypeOf()}),e.o(`readonly optional prop and index signature`,()=>{let n={};t.isEmptyish(n),(0,e.t.expectTypeOf)(n).toEqualTypeOf()}),e.o(`required symbol prop`,()=>{let n={[Symbol(`hello`)]:`world`};t.isEmptyish(n),(0,e.t.expectTypeOf)(n).toEqualTypeOf()}),e.o(`optional symbol prop`,()=>{let n={};t.isEmptyish(n)?(0,e.t.expectTypeOf)(n).toExtend():(0,e.t.expectTypeOf)(n).toEqualTypeOf()}),e.o(`readonly optional symbol prop`,()=>{let n={};t.isEmptyish(n),(0,e.t.expectTypeOf)(n).toEqualTypeOf()})}),e.i(`keyed collections`,()=>{e.o(`maps`,()=>{let n=new Map;t.isEmptyish(n)?(0,e.t.expectTypeOf)(n).toExtend():(0,e.t.expectTypeOf)(n).toEqualTypeOf()}),e.o(`readonly maps`,()=>{let n=new Map;t.isEmptyish(n),(0,e.t.expectTypeOf)(n).toEqualTypeOf()}),e.o(`search params`,()=>{let n=new URLSearchParams;t.isEmptyish(n)?(0,e.t.expectTypeOf)(n).toExtend():(0,e.t.expectTypeOf)(n).toEqualTypeOf()})}),e.i(`self-declared sizes`,()=>{e.o(`primitive length`,()=>{let n={length:0,a:`hello`};t.isEmptyish(n)?(0,e.t.expectTypeOf)(n).toExtend():(0,e.t.expectTypeOf)(n).toEqualTypeOf()}),e.o(`literal empty length`,()=>{let n={length:0};t.isEmptyish(n),(0,e.t.expectTypeOf)(n).toEqualTypeOf()}),e.o(`literal non-empty length`,()=>{let n={length:1};t.isEmptyish(n),(0,e.t.expectTypeOf)(n).toEqualTypeOf()}),e.o(`literal union of empty and non-empty length`,()=>{let n={length:1};t.isEmptyish(n)?(0,e.t.expectTypeOf)(n).toExtend():(0,e.t.expectTypeOf)(n).toEqualTypeOf()}),e.o(`length is optional and readonly`,()=>{let n={};t.isEmptyish(n),(0,e.t.expectTypeOf)(n).toEqualTypeOf()}),e.o(`primitive size`,()=>{let n={size:0,a:`hello`};t.isEmptyish(n)?(0,e.t.expectTypeOf)(n).toExtend():(0,e.t.expectTypeOf)(n).toEqualTypeOf()}),e.o(`literal empty size`,()=>{let n={size:0};t.isEmptyish(n),(0,e.t.expectTypeOf)(n).toEqualTypeOf()}),e.o(`literal non-empty size`,()=>{let n={size:1};t.isEmptyish(n),(0,e.t.expectTypeOf)(n).toEqualTypeOf()}),e.o(`literal union of empty and non-empty size`,()=>{let n={size:1};t.isEmptyish(n)?(0,e.t.expectTypeOf)(n).toExtend():(0,e.t.expectTypeOf)(n).toEqualTypeOf()}),e.o(`size is optional and readonly`,()=>{let n={};t.isEmptyish(n),(0,e.t.expectTypeOf)(n).toEqualTypeOf()})}),e.i(`generic types`,()=>{e.o(`non-nullable`,()=>{let n={};t.isEmptyish(n)&&(0,e.t.expectTypeOf)(n).toEqualTypeOf()}),e.o(`any`,()=>{t.isEmptyish(``)&&(0,e.t.expectTypeOf)(``).toEqualTypeOf()}),e.o(`unknown`,()=>{t.isEmptyish(``)&&(0,e.t.expectTypeOf)(``).toEqualTypeOf()})});

package/dist/is-emptyish.test-d.d.cts

@@ -0,0 +1,8 @@
+//#region src/is-emptyish.test-d.d.ts
+declare const TYPED_ARRAY: Int8Array<ArrayBuffer>;
+type TypedArray = typeof TYPED_ARRAY;
+declare const BUFFER: globalThis.Buffer<ArrayBuffer>;
+type Buffer = typeof BUFFER;
+//#endregion
+export { Buffer, TypedArray };
+//# sourceMappingURL=is-emptyish.test-d.d.cts.map

package/dist/is-emptyish.test-d.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-emptyish.test-d.d.cts","names":[],"sources":["../src/is-emptyish.test-d.ts"],"sourcesContent":[],"mappings":";cAKM,aAAW,UAAA;AAAX,KACM,UAAA,GADwB,OACJ,WADf;AACjB,cAGM,MAHgB,EAGV,UAAA,CAAA,MAHoB,CAGpB,WAH+B,CAAA;AAGrC,KACM,MAAA,GADkB,OACF,MADhB"}

package/dist/is-emptyish.test-d.d.ts

@@ -0,0 +1,8 @@
+//#region src/is-emptyish.test-d.d.ts
+declare const TYPED_ARRAY: Int8Array<ArrayBuffer>;
+type TypedArray = typeof TYPED_ARRAY;
+declare const BUFFER: globalThis.Buffer<ArrayBuffer>;
+type Buffer = typeof BUFFER;
+//#endregion
+export { Buffer, TypedArray };
+//# sourceMappingURL=is-emptyish.test-d.d.ts.map

package/dist/is-emptyish.test-d.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-emptyish.test-d.d.ts","names":[],"sources":["../src/is-emptyish.test-d.ts"],"sourcesContent":[],"mappings":";cAKM,aAAW,UAAA;AAAX,KACM,UAAA,GADwB,OACJ,WADf;AACjB,cAGM,MAHgB,EAGV,UAAA,CAAA,MAHoB,CAGpB,WAH+B,CAAA;AAGrC,KACM,MAAA,GADkB,OACF,MADhB"}

package/dist/is-emptyish.test-d.js

@@ -0,0 +1,2 @@
+import{i as e,o as t,t as n}from"./dist-CUT1dnRU.js";import{isEmptyish as r}from"./is-emptyish.js";new Int8Array(1),Buffer.alloc(0),e(`strings`,()=>{t(`primitives`,()=>{let e=`test`;r(e),n(e).toEqualTypeOf()}),t(`empty literal`,()=>{r(``),n(``).toEqualTypeOf()}),t(`non-empty literals`,()=>{let e=`test`;r(e),n(e).toEqualTypeOf()}),t(`union of non-empty literals`,()=>{r(`cat`),n(`cat`).toEqualTypeOf()}),t(`union with an empty literal`,()=>{r(``),n(``).toEqualTypeOf()}),t(`non-empty string templates`,()=>{let e=`prefix_0`;r(e),n(e).toEqualTypeOf()}),t(`string template (with empty)`,()=>{r(``),n(``).toEqualTypeOf()}),t(`empty-able string template`,()=>{r(``),n(``).toEqualTypeOf()})}),e(`branded`,()=>{t(`primitive`,()=>{r(``),n(``).toEqualTypeOf()}),t(`non-empty literal`,()=>{let e=`test`;r(e),n(e).toEqualTypeOf()}),t(`empty literal`,()=>{r(``),n(``).toEqualTypeOf()}),t(`union of non-empty literals`,()=>{r(`cat`),n(`cat`).toEqualTypeOf()}),t(`union of empty and non-empty literals`,()=>{r(``),n(``).toEqualTypeOf()})}),e(`nullish`,()=>{t(`null`,()=>{r(null),n(null).toEqualTypeOf()}),t(`undefined`,()=>{r(void 0),n(void 0).toEqualTypeOf()}),t(`optional nullable`,()=>{r(null),n(null).toEqualTypeOf()}),t(`optional primitive`,()=>{r(void 0),n(void 0).toEqualTypeOf()}),t(`optional non-empty literal`,()=>{r(`cat`),n(`cat`).toEqualTypeOf()}),t(`optional empty literal`,()=>{r(``),n(``).toEqualTypeOf()}),t(`nullable primitive`,()=>{r(null),n(null).toEqualTypeOf()}),t(`nullable non-empty literal`,()=>{r(`cat`),n(`cat`).toEqualTypeOf()}),t(`nullable empty literal`,()=>{r(``),n(``).toEqualTypeOf()}),t(`optional, nullable, empty, and non-empty`,()=>{r(``),n(``).toEqualTypeOf()})}),e(`all tuple shapes`,()=>{t(`empty tuple`,()=>{let e=[];r(e),n(e).toEqualTypeOf()}),t(`empty readonly tuple`,()=>{let e=[];r(e),n(e).toEqualTypeOf()}),t(`fixed tuple`,()=>{let e=[1,2,3];r(e),n(e).toEqualTypeOf()}),t(`fixed readonly tuple`,()=>{let e=[1,2,3];r(e),n(e).toEqualTypeOf()}),t(`array`,()=>{let e=[];r(e)?n(e).toExtend():n(e).toEqualTypeOf()}),t(`readonly array`,()=>{let e=[];r(e),n(e).toEqualTypeOf()}),t(`optional tuple`,()=>{let e=[];r(e)?n(e).toExtend():n(e).toEqualTypeOf()}),t(`readonly optional tuple`,()=>{let e=[];r(e),n(e).toEqualTypeOf()}),t(`fixed-prefix array`,()=>{let e=[1];r(e),n(e).toEqualTypeOf()}),t(`readonly fixed-prefix array`,()=>{let e=[1];r(e),n(e).toEqualTypeOf()}),t(`fixed-suffix array`,()=>{let e=[1];r(e),n(e).toEqualTypeOf()}),t(`readonly fixed-suffix array`,()=>{let e=[1];r(e),n(e).toEqualTypeOf()}),t(`mixed tuples`,()=>{let e=[1];r(e),n(e).toEqualTypeOf()}),t(`readonly mixed tuples`,()=>{let e=[1];r(e),n(e).toEqualTypeOf()}),t(`optional prefix arrays`,()=>{let e=[];r(e)?n(e).toExtend():n(e).toEqualTypeOf()}),t(`readonly optional prefix arrays`,()=>{let e=[];r(e),n(e).toEqualTypeOf()}),t(`fixed-elements array`,()=>{let e=[1,2];r(e),n(e).toEqualTypeOf()}),t(`readonly fixed-elements array`,()=>{let e=[1,2];r(e),n(e).toEqualTypeOf()})}),e(`array-like`,()=>{t(`typed arrays`,()=>{let e={};r(e)?n(e).toExtend():n(e).toEqualTypeOf()}),t(`buffers`,()=>{let e={};r(e)?n(e).toExtend():n(e).toEqualTypeOf()}),t(`sets`,()=>{let e=new Set;r(e)?n(e).toExtend():n(e).toEqualTypeOf()}),t(`readonly sets`,()=>{let e=new Set;r(e),n(e).toEqualTypeOf()}),t("array-like (e.g., `arguments`)",()=>{})}),e(`plain objects`,()=>{t(`never record`,()=>{let e={};r(e),n(e).toEqualTypeOf()}),t(`readonly never record`,()=>{let e={};r(e),n(e).toEqualTypeOf()}),t(`plain object`,()=>{let e={a:123,b:`hello`};r(e),n(e).toEqualTypeOf()}),t(`readonly plain object`,()=>{let e={a:123,b:`hello`};r(e),n(e).toEqualTypeOf()}),t(`unbounded record`,()=>{let e={};r(e)?n(e).toExtend():n(e).toEqualTypeOf()}),t(`readonly unbounded record`,()=>{let e={};r(e),n(e).toEqualTypeOf()}),t(`partial bounded record`,()=>{let e={};r(e)?n(e).toExtend():n(e).toEqualTypeOf()}),t(`readonly partial bounded record`,()=>{let e={};r(e),n(e).toEqualTypeOf()}),t(`partial and required props`,()=>{let e={};r(e),n(e).toEqualTypeOf()}),t(`required interfaces`,()=>{let e={};r(e),n(e).toEqualTypeOf()}),t(`optional interfaces`,()=>{let e={};r(e)?n(e).toExtend():n(e).toEqualTypeOf()}),t(`optional readonly interfaces`,()=>{let e={};r(e),n(e).toEqualTypeOf()}),t(`required prop and index signature`,()=>{let e={a:`hello`};r(e),n(e).toEqualTypeOf()}),t(`readonly required prop and index signature`,()=>{let e={a:`hello`};r(e),n(e).toEqualTypeOf()}),t(`optional prop and index signature`,()=>{let e={};r(e)?n(e).toExtend():n(e).toEqualTypeOf()}),t(`readonly optional prop and index signature`,()=>{let e={};r(e),n(e).toEqualTypeOf()}),t(`required symbol prop`,()=>{let e={[Symbol(`hello`)]:`world`};r(e),n(e).toEqualTypeOf()}),t(`optional symbol prop`,()=>{let e={};r(e)?n(e).toExtend():n(e).toEqualTypeOf()}),t(`readonly optional symbol prop`,()=>{let e={};r(e),n(e).toEqualTypeOf()})}),e(`keyed collections`,()=>{t(`maps`,()=>{let e=new Map;r(e)?n(e).toExtend():n(e).toEqualTypeOf()}),t(`readonly maps`,()=>{let e=new Map;r(e),n(e).toEqualTypeOf()}),t(`search params`,()=>{let e=new URLSearchParams;r(e)?n(e).toExtend():n(e).toEqualTypeOf()})}),e(`self-declared sizes`,()=>{t(`primitive length`,()=>{let e={length:0,a:`hello`};r(e)?n(e).toExtend():n(e).toEqualTypeOf()}),t(`literal empty length`,()=>{let e={length:0};r(e),n(e).toEqualTypeOf()}),t(`literal non-empty length`,()=>{let e={length:1};r(e),n(e).toEqualTypeOf()}),t(`literal union of empty and non-empty length`,()=>{let e={length:1};r(e)?n(e).toExtend():n(e).toEqualTypeOf()}),t(`length is optional and readonly`,()=>{let e={};r(e),n(e).toEqualTypeOf()}),t(`primitive size`,()=>{let e={size:0,a:`hello`};r(e)?n(e).toExtend():n(e).toEqualTypeOf()}),t(`literal empty size`,()=>{let e={size:0};r(e),n(e).toEqualTypeOf()}),t(`literal non-empty size`,()=>{let e={size:1};r(e),n(e).toEqualTypeOf()}),t(`literal union of empty and non-empty size`,()=>{let e={size:1};r(e)?n(e).toExtend():n(e).toEqualTypeOf()}),t(`size is optional and readonly`,()=>{let e={};r(e),n(e).toEqualTypeOf()})}),e(`generic types`,()=>{t(`non-nullable`,()=>{let e={};r(e)&&n(e).toEqualTypeOf()}),t(`any`,()=>{r(``)&&n(``).toEqualTypeOf()}),t(`unknown`,()=>{r(``)&&n(``).toEqualTypeOf()})});
+//# sourceMappingURL=is-emptyish.test-d.js.map

package/dist/is-emptyish.test-d.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-emptyish.test-d.js","names":["data: ReadonlyMap<string, number>"],"sources":["../src/is-emptyish.test-d.ts"],"sourcesContent":["import type { Tagged } from 'type-fest';\nimport { describe, expectTypeOf, test } from 'vitest';\nimport { isEmptyish } from './is-emptyish';\n\n// eslint-disable-next-line ts/no-unused-vars -- This is a trick in order to bypass breaking changes introduced in TypeScript that made TypedArrays like `Int8Array` accept a required type parameter.\nconst TYPED_ARRAY = new Int8Array(1);\nexport type TypedArray = typeof TYPED_ARRAY;\n\n// eslint-disable-next-line ts/no-unused-vars, node/prefer-global/buffer -- This is a trick in order to bypass breaking changes introduced in TypeScript that made `Buffer` accept a required type parameter.\nconst BUFFER = Buffer.alloc(0);\nexport type Buffer = typeof BUFFER;\n\ndescribe('strings', () => {\n  test('primitives', () => {\n    const data = 'test' as string;\n    if (isEmptyish(data)) {\n      expectTypeOf(data).toEqualTypeOf<''>();\n    } else {\n      expectTypeOf(data).toEqualTypeOf<string>();\n    }\n  });\n\n  test('empty literal', () => {\n    const data = '' as const;\n    if (isEmptyish(data)) {\n      expectTypeOf(data).toEqualTypeOf<''>();\n    } else {\n      expectTypeOf(data).toEqualTypeOf<never>();\n    }\n  });\n\n  test('non-empty literals', () => {\n    const data = 'test' as const;\n    if (isEmptyish(data)) {\n      expectTypeOf(data).toEqualTypeOf<never>();\n    } else {\n      expectTypeOf(data).toEqualTypeOf<'test'>();\n    }\n  });\n\n  test('union of non-empty literals', () => {\n    const data = 'cat' as 'cat' | 'dog';\n    if (isEmptyish(data)) {\n      expectTypeOf(data).toEqualTypeOf<never>();\n    } else {\n      expectTypeOf(data).toEqualTypeOf<'cat' | 'dog'>();\n    }\n  });\n\n  test('union with an empty literal', () => {\n    const data = '' as '' | 'cat' | 'dog';\n    if (isEmptyish(data)) {\n      expectTypeOf(data).toEqualTypeOf<''>();\n    } else {\n      expectTypeOf(data).toEqualTypeOf<'cat' | 'dog'>();\n    }\n  });\n\n  test('non-empty string templates', () => {\n    const data = 'prefix_0' as `prefix_${number}`;\n    if (isEmptyish(data)) {\n      expectTypeOf(data).toEqualTypeOf<never>();\n    } else {\n      expectTypeOf(data).toEqualTypeOf<`prefix_${number}`>();\n    }\n  });\n\n  test('string template (with empty)', () => {\n    const data = '' as '' | `prefix_${number}`;\n    if (isEmptyish(data)) {\n      expectTypeOf(data).toEqualTypeOf<''>();\n    } else {\n      expectTypeOf(data).toEqualTypeOf<`prefix_${number}`>();\n    }\n  });\n\n  test('empty-able string template', () => {\n    const data = '' as `${'' | 'cat'}${'' | 'dog'}`;\n    if (isEmptyish(data)) {\n      expectTypeOf(data).toEqualTypeOf<''>();\n    } else {\n      expectTypeOf(data).toEqualTypeOf<'cat' | 'dog' | 'catdog'>();\n    }\n  });\n});\n\ndescribe('branded', () => {\n  test('primitive', () => {\n    const data = '' as Tagged<string, 'brand'>;\n    if (isEmptyish(data)) {\n      expectTypeOf(data).toEqualTypeOf<Tagged<'', 'brand'>>();\n    } else {\n      expectTypeOf(data).toEqualTypeOf<Tagged<string, 'brand'>>();\n    }\n  });\n\n  test('non-empty literal', () => {\n    const data = 'test' as Tagged<'test', 'brand'>;\n    if (isEmptyish(data)) {\n      expectTypeOf(data).toEqualTypeOf<never>();\n    } else {\n      expectTypeOf(data).toEqualTypeOf<Tagged<'test', 'brand'>>();\n    }\n  });\n\n  test('empty literal', () => {\n    const data = '' as Tagged<'', 'brand'>;\n    if (isEmptyish(data)) {\n      expectTypeOf(data).toEqualTypeOf<Tagged<'', 'brand'>>();\n    } else {\n      expectTypeOf(data).toEqualTypeOf<never>();\n    }\n  });\n\n  test('union of non-empty literals', () => {\n    const data = 'cat' as Tagged<'cat' | 'dog', 'brand'>;\n    if (isEmptyish(data)) {\n      expectTypeOf(data).toEqualTypeOf<never>();\n    } else {\n      expectTypeOf(data).toEqualTypeOf<Tagged<'cat' | 'dog', 'brand'>>();\n    }\n  });\n\n  test('union of empty and non-empty literals', () => {\n    const data = '' as Tagged<'test' | '', 'brand'>;\n    if (isEmptyish(data)) {\n      expectTypeOf(data).toEqualTypeOf<Tagged<'', 'brand'>>();\n    } else {\n      expectTypeOf(data).toEqualTypeOf<Tagged<'test', 'brand'>>();\n    }\n  });\n});\n\ndescribe('nullish', () => {\n  test('null', () => {\n    const data = null;\n    if (isEmptyish(data)) {\n      expectTypeOf(data).toEqualTypeOf<null>();\n    } else {\n      expectTypeOf(data).toEqualTypeOf<never>();\n    }\n  });\n\n  test('undefined', () => {\n    const data = undefined;\n    if (isEmptyish(data)) {\n      expectTypeOf(data).toEqualTypeOf<undefined>();\n    } else {\n      expectTypeOf(data).toEqualTypeOf<never>();\n    }\n  });\n\n  test('optional nullable', () => {\n    const data = null as null | undefined;\n    if (isEmptyish(data)) {\n      expectTypeOf(data).toEqualTypeOf<null | undefined>();\n    } else {\n      expectTypeOf(data).toEqualTypeOf<never>();\n    }\n  });\n\n  test('optional primitive', () => {\n    const data = undefined as string | undefined;\n    if (isEmptyish(data)) {\n      expectTypeOf(data).toEqualTypeOf<'' | undefined>();\n    } else {\n      expectTypeOf(data).toEqualTypeOf<string>();\n    }\n  });\n\n  test('optional non-empty literal', () => {\n    const data = 'cat' as 'cat' | 'dog' | undefined;\n    if (isEmptyish(data)) {\n      expectTypeOf(data).toEqualTypeOf<undefined>();\n    } else {\n      expectTypeOf(data).toEqualTypeOf<'cat' | 'dog'>();\n    }\n  });\n\n  test('optional empty literal', () => {\n    const data = '' as '' | undefined;\n    if (isEmptyish(data)) {\n      expectTypeOf(data).toEqualTypeOf<'' | undefined>();\n    } else {\n      expectTypeOf(data).toEqualTypeOf<never>();\n    }\n  });\n\n  test('nullable primitive', () => {\n    const data = null as string | null;\n    if (isEmptyish(data)) {\n      expectTypeOf(data).toEqualTypeOf<'' | null>();\n    } else {\n      expectTypeOf(data).toEqualTypeOf<string>();\n    }\n  });\n\n  test('nullable non-empty literal', () => {\n    const data = 'cat' as 'cat' | null;\n    if (isEmptyish(data)) {\n      expectTypeOf(data).toEqualTypeOf<null>();\n    } else {\n      expectTypeOf(data).toEqualTypeOf<'cat'>();\n    }\n  });\n\n  test('nullable empty literal', () => {\n    const data = '' as '' | null;\n    if (isEmptyish(data)) {\n      expectTypeOf(data).toEqualTypeOf<'' | null>();\n    } else {\n      expectTypeOf(data).toEqualTypeOf<never>();\n    }\n  });\n\n  test('optional, nullable, empty, and non-empty', () => {\n    const data = '' as '' | 'cat' | null | undefined;\n    if (isEmptyish(data)) {\n      expectTypeOf(data).toEqualTypeOf<'' | null | undefined>();\n    } else {\n      expectTypeOf(data).toEqualTypeOf<'cat'>();\n    }\n  });\n});\n\ndescribe('all tuple shapes', () => {\n  // See TupleParts for a description of all possible tuple shapes.\n\n  test('empty tuple', () => {\n    const data = [] as [];\n    if (isEmptyish(data)) {\n      expectTypeOf(data).toEqualTypeOf<[]>();\n    } else {\n      // Can never be non-empty\n      expectTypeOf(data).toEqualTypeOf<never>();\n    }\n  });\n\n  test('empty readonly tuple', () => {\n    const data = [] as const;\n    if (isEmptyish(data)) {\n      expectTypeOf(data).toEqualTypeOf<readonly []>();\n    } else {\n      // Can never be non-empty\n      expectTypeOf(data).toEqualTypeOf<never>();\n    }\n  });\n\n  test('fixed tuple', () => {\n    const data = [1, 2, 3] as [number, number, number];\n    if (isEmptyish(data)) {\n      // Can never be empty\n      expectTypeOf(data).toEqualTypeOf<never>();\n    } else {\n      expectTypeOf(data).toEqualTypeOf<[number, number, number]>();\n    }\n  });\n\n  test('fixed readonly tuple', () => {\n    const data = [1, 2, 3] as const;\n    if (isEmptyish(data)) {\n      // Can never be empty\n      expectTypeOf(data).toEqualTypeOf<never>();\n    } else {\n      expectTypeOf(data).toEqualTypeOf<readonly [1, 2, 3]>();\n    }\n  });\n\n  test('array', () => {\n    const data = [] as Array<'cat'>;\n    if (isEmptyish(data)) {\n      // No narrowing when the array is mutable so that it remains mutable\n      // (effectively turning off the \"type-predicate\"-ness of the function)\n      expectTypeOf(data).toExtend<Array<'cat'>>();\n    } else {\n      expectTypeOf(data).toEqualTypeOf<Array<'cat'>>();\n    }\n  });\n\n  test('readonly array', () => {\n    const data = [] as ReadonlyArray<'cat'>;\n    if (isEmptyish(data)) {\n      // When the array is not mutable we can narrow it down because it can't\n      // change.\n      expectTypeOf(data).toEqualTypeOf<readonly []>();\n    } else {\n      expectTypeOf(data).toEqualTypeOf<ReadonlyArray<'cat'>>();\n    }\n  });\n\n  test('optional tuple', () => {\n    const data = [] as [number?, number?, string?];\n    if (isEmptyish(data)) {\n      // No narrowing when the array is mutable so that it remains mutable\n      // (effectively turning off the \"type-predicate\"-ness of the function)\n      expectTypeOf(data).toExtend<[number?, number?, string?]>();\n    } else {\n      expectTypeOf(data).toEqualTypeOf<[number?, number?, string?]>();\n    }\n  });\n\n  test('readonly optional tuple', () => {\n    const data = [] as readonly [number?, number?, string?];\n    if (isEmptyish(data)) {\n      // When the array is not mutable we can narrow it down because it can't\n      // change.\n      expectTypeOf(data).toEqualTypeOf<readonly []>();\n    } else {\n      expectTypeOf(data).toEqualTypeOf<readonly [number?, number?, string?]>();\n    }\n  });\n\n  test('fixed-prefix array', () => {\n    const data = [1] as [number, ...Array<number>];\n    if (isEmptyish(data)) {\n      // Can never be empty\n      expectTypeOf(data).toEqualTypeOf<never>();\n    } else {\n      expectTypeOf(data).toEqualTypeOf<[number, ...Array<number>]>();\n    }\n  });\n\n  test('readonly fixed-prefix array', () => {\n    const data = [1] as readonly [number, ...Array<number>];\n    if (isEmptyish(data)) {\n      // Can never be empty\n      expectTypeOf(data).toEqualTypeOf<never>();\n    } else {\n      expectTypeOf(data).toEqualTypeOf<readonly [number, ...Array<number>]>();\n    }\n  });\n\n  test('fixed-suffix array', () => {\n    const data = [1] as [...Array<number>, number];\n    if (isEmptyish(data)) {\n      // Can never be empty\n      expectTypeOf(data).toEqualTypeOf<never>();\n    } else {\n      expectTypeOf(data).toEqualTypeOf<[...Array<number>, number]>();\n    }\n  });\n\n  test('readonly fixed-suffix array', () => {\n    const data = [1] as readonly [...Array<number>, number];\n    if (isEmptyish(data)) {\n      // Can never be empty\n      expectTypeOf(data).toEqualTypeOf<never>();\n    } else {\n      expectTypeOf(data).toEqualTypeOf<readonly [...Array<number>, number]>();\n    }\n  });\n\n  test('mixed tuples', () => {\n    const data = [1] as [number, string?];\n    if (isEmptyish(data)) {\n      // Can never be empty\n      expectTypeOf(data).toEqualTypeOf<never>();\n    } else {\n      expectTypeOf(data).toEqualTypeOf<[number, string?]>();\n    }\n  });\n\n  test('readonly mixed tuples', () => {\n    const data = [1] as readonly [number, string?];\n    if (isEmptyish(data)) {\n      // Can never be empty\n      expectTypeOf(data).toEqualTypeOf<never>();\n    } else {\n      expectTypeOf(data).toEqualTypeOf<readonly [number, string?]>();\n    }\n  });\n\n  test('optional prefix arrays', () => {\n    const data = [] as [number?, ...Array<number>];\n    if (isEmptyish(data)) {\n      // No narrowing when the array is mutable so that it remains mutable\n      // (effectively turning off the \"type-predicate\"-ness of the function)\n      expectTypeOf(data).toExtend<[number?, ...Array<number>]>();\n    } else {\n      expectTypeOf(data).toEqualTypeOf<[number?, ...Array<number>]>();\n    }\n  });\n\n  test('readonly optional prefix arrays', () => {\n    const data = [] as readonly [number?, ...Array<number>];\n    if (isEmptyish(data)) {\n      // When the array is not mutable we can narrow it down because it can't\n      // change.\n      expectTypeOf(data).toEqualTypeOf<readonly []>();\n    } else {\n      expectTypeOf(data).toEqualTypeOf<readonly [number?, ...Array<number>]>();\n    }\n  });\n\n  test('fixed-elements array', () => {\n    const data = [1, 2] as [number, ...Array<number>, number];\n    if (isEmptyish(data)) {\n      // Can never be empty\n      expectTypeOf(data).toEqualTypeOf<never>();\n    } else {\n      expectTypeOf(data).toEqualTypeOf<[number, ...Array<number>, number]>();\n    }\n  });\n\n  test('readonly fixed-elements array', () => {\n    const data = [1, 2] as readonly [number, ...Array<number>, number];\n    if (isEmptyish(data)) {\n      // Can never be empty\n      expectTypeOf(data).toEqualTypeOf<never>();\n    } else {\n      expectTypeOf(data).toEqualTypeOf<\n        readonly [number, ...Array<number>, number]\n      >();\n    }\n  });\n});\n\ndescribe('array-like', () => {\n  test('typed arrays', () => {\n    const data = {} as TypedArray;\n    if (isEmptyish(data)) {\n      // Typed arrays are either mutable via their underlying buffer, or they\n      // do not track their length; in both cases we don't have a narrower type\n      // to represent the emptiness.\n\n      expectTypeOf(data).toExtend<TypedArray>();\n    } else {\n      expectTypeOf(data).toEqualTypeOf<TypedArray>();\n    }\n  });\n\n  test('buffers', () => {\n    const data = {} as Buffer;\n    if (isEmptyish(data)) {\n      // There's no way to construct an empty Buffer at the type level.\n\n      expectTypeOf(data).toExtend<Buffer>();\n    } else {\n      expectTypeOf(data).toEqualTypeOf<Buffer>();\n    }\n  });\n\n  test('sets', () => {\n    const data = new Set<number>();\n    if (isEmptyish(data)) {\n      expectTypeOf(data).toExtend<Set<number>>();\n    } else {\n      expectTypeOf(data).toEqualTypeOf<Set<number>>();\n    }\n  });\n\n  test('readonly sets', () => {\n    const data = new Set<number>() as ReadonlySet<number>;\n    if (isEmptyish(data)) {\n      expectTypeOf(data).toEqualTypeOf<ReadonlySet<never>>();\n    } else {\n      expectTypeOf(data).toEqualTypeOf<ReadonlySet<number>>();\n    }\n  });\n\n  test('array-like (e.g., `arguments`)', () => {\n    // @ts-expect-error [ts6133] -- This is the best way to initialize a proper\n    // `arguments` array.\n    // eslint-disable-next-line ts/no-unused-vars\n    function foo(): void {\n      // eslint-disable-next-line prefer-rest-params\n      const args = arguments;\n      if (isEmptyish(args)) {\n        expectTypeOf(args).toExtend<IArguments>();\n      } else {\n        expectTypeOf(args).toEqualTypeOf<IArguments>();\n      }\n    }\n  });\n});\n\ndescribe('plain objects', () => {\n  test('never record', () => {\n    const data = {} as Record<PropertyKey, never>;\n    if (isEmptyish(data)) {\n      expectTypeOf(data).toEqualTypeOf<Record<PropertyKey, never>>();\n    } else {\n      expectTypeOf(data).toEqualTypeOf<never>();\n    }\n  });\n\n  test('readonly never record', () => {\n    const data = {} as Readonly<Record<PropertyKey, never>>;\n    if (isEmptyish(data)) {\n      expectTypeOf(data).toEqualTypeOf<Readonly<Record<PropertyKey, never>>>();\n    } else {\n      expectTypeOf(data).toEqualTypeOf<never>();\n    }\n  });\n\n  test('plain object', () => {\n    const data = { a: 123, b: 'hello' } as { a: number; b: string };\n    if (isEmptyish(data)) {\n      expectTypeOf(data).toEqualTypeOf<never>();\n    } else {\n      expectTypeOf(data).toEqualTypeOf<{ a: number; b: string }>();\n    }\n  });\n\n  test('readonly plain object', () => {\n    const data = { a: 123, b: 'hello' } as const;\n    if (isEmptyish(data)) {\n      expectTypeOf(data).toEqualTypeOf<never>();\n    } else {\n      expectTypeOf(data).toEqualTypeOf<{\n        readonly a: 123;\n        readonly b: 'hello';\n      }>();\n    }\n  });\n\n  test('unbounded record', () => {\n    const data = {} as Record<string, string>;\n    if (isEmptyish(data)) {\n      expectTypeOf(data).toExtend<Record<string, string>>();\n    } else {\n      expectTypeOf(data).toEqualTypeOf<Record<string, string>>();\n    }\n  });\n\n  test('readonly unbounded record', () => {\n    const data = {} as Readonly<Record<string, string>>;\n    if (isEmptyish(data)) {\n      expectTypeOf(data).toEqualTypeOf<Readonly<Record<string, never>>>();\n    } else {\n      expectTypeOf(data).toEqualTypeOf<Readonly<Record<string, string>>>();\n    }\n  });\n\n  test('partial bounded record', () => {\n    const data = {} as { a?: number; b?: string };\n    if (isEmptyish(data)) {\n      expectTypeOf(data).toExtend<{ a?: number; b?: string }>();\n    } else {\n      expectTypeOf(data).toEqualTypeOf<{ a?: number; b?: string }>();\n    }\n  });\n\n  test('readonly partial bounded record', () => {\n    const data = {} as { readonly a?: number; readonly b?: string };\n    if (isEmptyish(data)) {\n      expectTypeOf(data).toEqualTypeOf<{\n        readonly a?: never;\n        readonly b?: never;\n      }>();\n    } else {\n      expectTypeOf(data).toEqualTypeOf<{\n        readonly a?: number;\n        readonly b?: string;\n      }>();\n    }\n  });\n\n  test('partial and required props', () => {\n    const data = {} as { a: number; b?: string };\n    if (isEmptyish(data)) {\n      expectTypeOf(data).toEqualTypeOf<never>();\n    } else {\n      expectTypeOf(data).toEqualTypeOf<{ a: number; b?: string }>();\n    }\n  });\n\n  test('required interfaces', () => {\n    interface MyInterface {\n      a: number;\n    }\n    const data = {} as MyInterface;\n    if (isEmptyish(data)) {\n      expectTypeOf(data).toEqualTypeOf<never>();\n    } else {\n      expectTypeOf(data).toEqualTypeOf<MyInterface>();\n    }\n  });\n\n  test('optional interfaces', () => {\n    interface MyInterface {\n      a?: number;\n    }\n    const data = {} as MyInterface;\n    if (isEmptyish(data)) {\n      expectTypeOf(data).toExtend<MyInterface>();\n    } else {\n      expectTypeOf(data).toEqualTypeOf<MyInterface>();\n    }\n  });\n\n  test('optional readonly interfaces', () => {\n    interface MyInterface {\n      readonly a?: number;\n    }\n    const data = {} as MyInterface;\n    if (isEmptyish(data)) {\n      expectTypeOf(data).toEqualTypeOf<{ readonly a?: never }>();\n    } else {\n      expectTypeOf(data).toEqualTypeOf<MyInterface>();\n    }\n  });\n\n  test('required prop and index signature', () => {\n    const data = { a: 'hello' } as { a: string; [key: string]: string };\n    if (isEmptyish(data)) {\n      expectTypeOf(data).toEqualTypeOf<never>();\n    } else {\n      expectTypeOf(data).toEqualTypeOf<{ a: string; [key: string]: string }>();\n    }\n  });\n\n  test('readonly required prop and index signature', () => {\n    const data = { a: 'hello' } as {\n      readonly a: string;\n      readonly [key: string]: string;\n    };\n    if (isEmptyish(data)) {\n      expectTypeOf(data).toEqualTypeOf<never>();\n    } else {\n      expectTypeOf(data).toEqualTypeOf<{\n        readonly a: string;\n        readonly [key: string]: string;\n      }>();\n    }\n  });\n\n  test('optional prop and index signature', () => {\n    const data = {} as { a?: string; [key: string]: string };\n    if (isEmptyish(data)) {\n      expectTypeOf(data).toExtend<{ a?: string; [key: string]: string }>();\n    } else {\n      expectTypeOf(data).toEqualTypeOf<{ a?: string; [key: string]: string }>();\n    }\n  });\n\n  test('readonly optional prop and index signature', () => {\n    const data = {} as { readonly a?: string; readonly [key: string]: string };\n    if (isEmptyish(data)) {\n      expectTypeOf(data).toEqualTypeOf<{\n        readonly a?: never;\n        readonly [key: string]: never;\n      }>();\n    } else {\n      expectTypeOf(data).toEqualTypeOf<{\n        readonly a?: string;\n        readonly [key: string]: string;\n      }>();\n    }\n  });\n\n  test('required symbol prop', () => {\n    const mySymbol = Symbol('hello');\n    const data = { [mySymbol]: 'world' };\n    if (isEmptyish(data)) {\n      expectTypeOf(data).toEqualTypeOf<never>();\n    } else {\n      expectTypeOf(data).toEqualTypeOf<{ [mySymbol]: string }>();\n    }\n  });\n\n  test('optional symbol prop', () => {\n    const mySymbol = Symbol('hello');\n    const data = {} as { [mySymbol]?: string };\n    if (isEmptyish(data)) {\n      expectTypeOf(data).toExtend<{ [mySymbol]?: string }>();\n    } else {\n      expectTypeOf(data).toEqualTypeOf<{ [mySymbol]?: string }>();\n    }\n  });\n\n  test('readonly optional symbol prop', () => {\n    const mySymbol = Symbol('hello');\n    const data = {} as { readonly [mySymbol]?: string };\n    if (isEmptyish(data)) {\n      expectTypeOf(data).toEqualTypeOf<{ readonly [mySymbol]?: never }>();\n    } else {\n      expectTypeOf(data).toEqualTypeOf<{ readonly [mySymbol]?: string }>();\n    }\n  });\n});\n\ndescribe('keyed collections', () => {\n  test('maps', () => {\n    const data = new Map<string, number>();\n    if (isEmptyish(data)) {\n      expectTypeOf(data).toExtend<Map<string, number>>();\n    } else {\n      expectTypeOf(data).toEqualTypeOf<Map<string, number>>();\n    }\n  });\n\n  test('readonly maps', () => {\n    const data: ReadonlyMap<string, number> = new Map();\n    if (isEmptyish(data)) {\n      expectTypeOf(data).toEqualTypeOf<ReadonlyMap<string, never>>();\n    } else {\n      expectTypeOf(data).toEqualTypeOf<ReadonlyMap<string, number>>();\n    }\n  });\n\n  test('search params', () => {\n    const data = new URLSearchParams();\n    if (isEmptyish(data)) {\n      expectTypeOf(data).toExtend<URLSearchParams>();\n    } else {\n      expectTypeOf(data).toEqualTypeOf<URLSearchParams>();\n    }\n  });\n});\n\ndescribe('self-declared sizes', () => {\n  test('primitive length', () => {\n    const data = { length: 0, a: 'hello' } as { length: number; a: string };\n    if (isEmptyish(data)) {\n      expectTypeOf(data).toExtend<{ length: number; a: string }>();\n    } else {\n      expectTypeOf(data).toEqualTypeOf<{ length: number; a: string }>();\n    }\n  });\n\n  test('literal empty length', () => {\n    const data = { length: 0 } as { length: 0; a?: string };\n    if (isEmptyish(data)) {\n      expectTypeOf(data).toEqualTypeOf<{ length: 0; a?: string }>();\n    } else {\n      expectTypeOf(data).toEqualTypeOf<never>();\n    }\n  });\n\n  test('literal non-empty length', () => {\n    const data = { length: 1 } as { length: 1; a: string };\n    if (isEmptyish(data)) {\n      expectTypeOf(data).toEqualTypeOf<never>();\n    } else {\n      expectTypeOf(data).toEqualTypeOf<{ length: 1; a: string }>();\n    }\n  });\n\n  test('literal union of empty and non-empty length', () => {\n    const data = { length: 1 } as { length: 0 | 1; a: string };\n    if (isEmptyish(data)) {\n      expectTypeOf(data).toExtend<{ length: 0 | 1; a: string }>();\n    } else {\n      expectTypeOf(data).toEqualTypeOf<{ length: 0 | 1; a: string }>();\n    }\n  });\n\n  test('length is optional and readonly', () => {\n    const data = {} as { readonly length?: number };\n    if (isEmptyish(data)) {\n      expectTypeOf(data).toEqualTypeOf<{ readonly length?: never }>();\n    } else {\n      expectTypeOf(data).toEqualTypeOf<{ readonly length?: number }>();\n    }\n  });\n\n  test('primitive size', () => {\n    const data = { size: 0, a: 'hello' } as { size: number; a: string };\n    if (isEmptyish(data)) {\n      expectTypeOf(data).toExtend<{ size: number; a: string }>();\n    } else {\n      expectTypeOf(data).toEqualTypeOf<{ size: number; a: string }>();\n    }\n  });\n\n  test('literal empty size', () => {\n    const data = { size: 0 } as { size: 0; a?: string };\n    if (isEmptyish(data)) {\n      expectTypeOf(data).toEqualTypeOf<{ size: 0; a?: string }>();\n    } else {\n      expectTypeOf(data).toEqualTypeOf<never>();\n    }\n  });\n\n  test('literal non-empty size', () => {\n    const data = { size: 1 } as { size: 1; a: string };\n    if (isEmptyish(data)) {\n      expectTypeOf(data).toEqualTypeOf<never>();\n    } else {\n      expectTypeOf(data).toEqualTypeOf<{ size: 1; a: string }>();\n    }\n  });\n\n  test('literal union of empty and non-empty size', () => {\n    const data = { size: 1 } as { size: 0 | 1; a: string };\n    if (isEmptyish(data)) {\n      expectTypeOf(data).toExtend<{ size: 0 | 1; a: string }>();\n    } else {\n      expectTypeOf(data).toEqualTypeOf<{ size: 0 | 1; a: string }>();\n    }\n  });\n\n  test('size is optional and readonly', () => {\n    const data = {} as { readonly size?: number };\n    if (isEmptyish(data)) {\n      expectTypeOf(data).toEqualTypeOf<{ readonly size?: never }>();\n    } else {\n      expectTypeOf(data).toEqualTypeOf<{ readonly size?: number }>();\n    }\n  });\n});\n\ndescribe('generic types', () => {\n  test('non-nullable', () => {\n    const data = {} as const;\n    if (isEmptyish(data)) {\n      // eslint-disable-next-line ts/no-empty-object-type\n      expectTypeOf(data).toEqualTypeOf<{}>();\n    }\n  });\n\n  test('any', () => {\n    // eslint-disable-next-line ts/no-explicit-any\n    const data = '' as any;\n    if (isEmptyish(data)) {\n      // eslint-disable-next-line ts/no-explicit-any\n      expectTypeOf(data).toEqualTypeOf<any>();\n    }\n  });\n\n  test('unknown', () => {\n    const data = '' as unknown;\n    if (isEmptyish(data)) {\n      expectTypeOf(data).toEqualTypeOf<unknown>();\n    }\n  });\n});\n"],"mappings":"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"}

package/dist/is-emptyish.test.cjs

@@ -0,0 +1 @@
+const e=require(`./dist-CiyBKPT6.cjs`),t=require(`./is-emptyish.cjs`);e.i(`nullish`,()=>{e.a(`null`,()=>{e.n(t.isEmptyish(null)).toBe(!0)}),e.a(`undefined`,()=>{e.n(t.isEmptyish(void 0)).toBe(!0)})}),e.i(`strings`,()=>{e.a(`literals`,()=>{e.n(t.isEmptyish(``)).toBe(!0),e.n(t.isEmptyish(`test`)).toBe(!1)}),e.a(`boxed`,()=>{e.n(t.isEmptyish(new String(``))).toBe(!0),e.n(t.isEmptyish(new String(`test`))).toBe(!1)})}),e.i(`arrays`,()=>{e.a(`simple`,()=>{e.n(t.isEmptyish([])).toBe(!0),e.n(t.isEmptyish([1,2,3])).toBe(!1)}),e.a(`sparse`,()=>{e.n(t.isEmptyish([,,])).toBe(!1)}),e.a(`via Array.from`,()=>{e.n(t.isEmptyish(Array.from({length:0}))).toBe(!0),e.n(t.isEmptyish(Array.from({length:10}))).toBe(!1)}),e.a(`typed arrays`,()=>{e.n(t.isEmptyish(new Int8Array)).toBe(!0),e.n(t.isEmptyish(new Int8Array([1,2,3]))).toBe(!1)}),e.a(`buffers`,()=>{e.n(t.isEmptyish(Buffer.alloc(0))).toBe(!0),e.n(t.isEmptyish(Buffer.alloc(3))).toBe(!1)}),e.a(`sets`,()=>{e.n(t.isEmptyish(new Set)).toBe(!0),e.n(t.isEmptyish(new Set([1,2,3]))).toBe(!1)}),e.a("array-like (e.g., `arguments`)",()=>{function n(){e.n(t.isEmptyish(arguments)).toBe(!0)}n();function r(n,r,i){e.n(t.isEmptyish(arguments)).toBe(!1)}r(`test`,123,!0)})}),e.i(`keyed collections`,()=>{e.a(`plain objects`,()=>{e.n(t.isEmptyish({})).toBe(!0),e.n(t.isEmptyish({key:`value`})).toBe(!1)}),e.a(`null-prototyped objects`,()=>{let n=Object.create(null);e.n(t.isEmptyish(n)).toBe(!0),n.key=`hello, world!`,e.n(t.isEmptyish(n)).toBe(!1)}),e.a(`symbol props`,()=>{e.n(t.isEmptyish({[Symbol(`hello`)]:`world`})).toBe(!1)}),e.a(`maps`,()=>{e.n(t.isEmptyish(new Map)).toBe(!0),e.n(t.isEmptyish(new Map([[`key`,`value`]]))).toBe(!1)}),e.a(`url search params`,()=>{e.n(t.isEmptyish(new URLSearchParams)).toBe(!0),e.n(t.isEmptyish(new URLSearchParams(``))).toBe(!0),e.n(t.isEmptyish(new URLSearchParams(`?`))).toBe(!0),e.n(t.isEmptyish(new URLSearchParams(`hello`))).toBe(!1),e.n(t.isEmptyish(new URLSearchParams({hello:`world `}))).toBe(!1)}),e.a(`prototype chains`,()=>{e.n(t.isEmptyish(Object.create(Object.create({})))).toBe(!0),e.n(t.isEmptyish(Object.create(Object.create({a:123})))).toBe(!1)})}),e.i(`self-declared sizes`,()=>{e.a(`length`,()=>{e.n(t.isEmptyish({length:0})).toBe(!0),e.n(t.isEmptyish({length:1})).toBe(!1)}),e.a(`size`,()=>{e.n(t.isEmptyish({size:0})).toBe(!0),e.n(t.isEmptyish({size:1})).toBe(!1)}),e.a(`props are not coerced`,()=>{e.n(t.isEmptyish({length:`0`})).toBe(!1),e.n(t.isEmptyish({size:null})).toBe(!1)}),e.a(`length has precedence over size`,()=>{e.n(t.isEmptyish({length:0,size:5})).toBe(!0),e.n(t.isEmptyish({length:1,size:0})).toBe(!1)})}),e.i(`unsupported types`,()=>{e.i(`always false`,()=>{e.a(`numbers`,()=>{e.n(t.isEmptyish(0)).toBe(!1),e.n(t.isEmptyish(-0)).toBe(!1),e.n(t.isEmptyish(NaN)).toBe(!1),e.n(t.isEmptyish(1/0)).toBe(!1),e.n(t.isEmptyish(100)).toBe(!1),e.n(t.isEmptyish(12.34)).toBe(!1)}),e.a(`bigints`,()=>{e.n(t.isEmptyish(0n)).toBe(!1),e.n(t.isEmptyish(1n)).toBe(!1)}),e.a(`booleans`,()=>{e.n(t.isEmptyish(!1)).toBe(!1),e.n(t.isEmptyish(!0)).toBe(!1)}),e.a(`symbols`,()=>{e.n(t.isEmptyish(Symbol(``))).toBe(!1),e.n(t.isEmptyish(Symbol(`something`))).toBe(!1)}),e.a(`functions`,()=>{e.n(t.isEmptyish(()=>{})).toBe(!1),e.n(t.isEmptyish(()=>{console.log(`hello`)})).toBe(!1)})}),e.a(`classes`,()=>{class n{}class r{a=`hello`}class i{#e=`hello`;get a(){return this.#e}}class a{data=[]}e.n(t.isEmptyish(new n)).toBe(!0),e.n(t.isEmptyish(new r)).toBe(!1),e.n(t.isEmptyish(new i)).toBe(!0),e.n(t.isEmptyish(new a)).toBe(!1)}),e.a(`errors`,()=>{class n extends Error{constructor(e=`hello`){super(),this.data=e}}e.n(t.isEmptyish(Error())).toBe(!0),e.n(t.isEmptyish(Error(`hello world!`))).toBe(!0),e.n(t.isEmptyish(new n)).toBe(!1)}),e.i(`always true`,()=>{e.a(`regexp`,()=>{e.n(t.isEmptyish(RegExp(``))).toBe(!0),e.n(t.isEmptyish(/abc/u)).toBe(!0)}),e.a(`dates`,()=>{e.n(t.isEmptyish(new Date(0))).toBe(!0),e.n(t.isEmptyish(new Date)).toBe(!0)}),e.a(`weak collections`,()=>{e.n(t.isEmptyish(new WeakMap)).toBe(!0),e.n(t.isEmptyish(new WeakSet)).toBe(!0)})})});

package/dist/is-emptyish.test.d.cts

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

package/dist/is-emptyish.test.d.ts

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

package/dist/is-emptyish.test.js

@@ -0,0 +1,2 @@
+import{a as e,i as t,n}from"./dist-CUT1dnRU.js";import{isEmptyish as r}from"./is-emptyish.js";t(`nullish`,()=>{e(`null`,()=>{n(r(null)).toBe(!0)}),e(`undefined`,()=>{n(r(void 0)).toBe(!0)})}),t(`strings`,()=>{e(`literals`,()=>{n(r(``)).toBe(!0),n(r(`test`)).toBe(!1)}),e(`boxed`,()=>{n(r(new String(``))).toBe(!0),n(r(new String(`test`))).toBe(!1)})}),t(`arrays`,()=>{e(`simple`,()=>{n(r([])).toBe(!0),n(r([1,2,3])).toBe(!1)}),e(`sparse`,()=>{n(r([,,])).toBe(!1)}),e(`via Array.from`,()=>{n(r(Array.from({length:0}))).toBe(!0),n(r(Array.from({length:10}))).toBe(!1)}),e(`typed arrays`,()=>{n(r(new Int8Array)).toBe(!0),n(r(new Int8Array([1,2,3]))).toBe(!1)}),e(`buffers`,()=>{n(r(Buffer.alloc(0))).toBe(!0),n(r(Buffer.alloc(3))).toBe(!1)}),e(`sets`,()=>{n(r(new Set)).toBe(!0),n(r(new Set([1,2,3]))).toBe(!1)}),e("array-like (e.g., `arguments`)",()=>{function e(){n(r(arguments)).toBe(!0)}e();function t(e,t,i){n(r(arguments)).toBe(!1)}t(`test`,123,!0)})}),t(`keyed collections`,()=>{e(`plain objects`,()=>{n(r({})).toBe(!0),n(r({key:`value`})).toBe(!1)}),e(`null-prototyped objects`,()=>{let e=Object.create(null);n(r(e)).toBe(!0),e.key=`hello, world!`,n(r(e)).toBe(!1)}),e(`symbol props`,()=>{n(r({[Symbol(`hello`)]:`world`})).toBe(!1)}),e(`maps`,()=>{n(r(new Map)).toBe(!0),n(r(new Map([[`key`,`value`]]))).toBe(!1)}),e(`url search params`,()=>{n(r(new URLSearchParams)).toBe(!0),n(r(new URLSearchParams(``))).toBe(!0),n(r(new URLSearchParams(`?`))).toBe(!0),n(r(new URLSearchParams(`hello`))).toBe(!1),n(r(new URLSearchParams({hello:`world `}))).toBe(!1)}),e(`prototype chains`,()=>{n(r(Object.create(Object.create({})))).toBe(!0),n(r(Object.create(Object.create({a:123})))).toBe(!1)})}),t(`self-declared sizes`,()=>{e(`length`,()=>{n(r({length:0})).toBe(!0),n(r({length:1})).toBe(!1)}),e(`size`,()=>{n(r({size:0})).toBe(!0),n(r({size:1})).toBe(!1)}),e(`props are not coerced`,()=>{n(r({length:`0`})).toBe(!1),n(r({size:null})).toBe(!1)}),e(`length has precedence over size`,()=>{n(r({length:0,size:5})).toBe(!0),n(r({length:1,size:0})).toBe(!1)})}),t(`unsupported types`,()=>{t(`always false`,()=>{e(`numbers`,()=>{n(r(0)).toBe(!1),n(r(-0)).toBe(!1),n(r(NaN)).toBe(!1),n(r(1/0)).toBe(!1),n(r(100)).toBe(!1),n(r(12.34)).toBe(!1)}),e(`bigints`,()=>{n(r(0n)).toBe(!1),n(r(1n)).toBe(!1)}),e(`booleans`,()=>{n(r(!1)).toBe(!1),n(r(!0)).toBe(!1)}),e(`symbols`,()=>{n(r(Symbol(``))).toBe(!1),n(r(Symbol(`something`))).toBe(!1)}),e(`functions`,()=>{n(r(()=>{})).toBe(!1),n(r(()=>{console.log(`hello`)})).toBe(!1)})}),e(`classes`,()=>{class e{}class t{a=`hello`}class i{#e=`hello`;get a(){return this.#e}}class a{data=[]}n(r(new e)).toBe(!0),n(r(new t)).toBe(!1),n(r(new i)).toBe(!0),n(r(new a)).toBe(!1)}),e(`errors`,()=>{class e extends Error{constructor(e=`hello`){super(),this.data=e}}n(r(Error())).toBe(!0),n(r(Error(`hello world!`))).toBe(!0),n(r(new e)).toBe(!1)}),t(`always true`,()=>{e(`regexp`,()=>{n(r(RegExp(``))).toBe(!0),n(r(/abc/u)).toBe(!0)}),e(`dates`,()=>{n(r(new Date(0))).toBe(!0),n(r(new Date)).toBe(!0)}),e(`weak collections`,()=>{n(r(new WeakMap)).toBe(!0),n(r(new WeakSet)).toBe(!0)})})});
+//# sourceMappingURL=is-emptyish.test.js.map

package/dist/is-emptyish.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-emptyish.test.js","names":["object: { key?: string }","#a"],"sources":["../src/is-emptyish.test.ts"],"sourcesContent":["/* eslint-disable node/prefer-global/buffer */\nimport { describe, expect, it } from 'vitest';\nimport { isEmptyish } from './is-emptyish';\n\ndescribe('nullish', () => {\n  it('null', () => {\n    expect(isEmptyish(null)).toBe(true);\n  });\n\n  it('undefined', () => {\n    expect(isEmptyish(undefined)).toBe(true);\n  });\n});\n\ndescribe('strings', () => {\n  it('literals', () => {\n    expect(isEmptyish('')).toBe(true);\n    expect(isEmptyish('test')).toBe(false);\n  });\n\n  it('boxed', () => {\n    // eslint-disable-next-line no-new-wrappers, sonar/no-primitive-wrappers\n    expect(isEmptyish(new String(''))).toBe(true);\n    // eslint-disable-next-line no-new-wrappers, sonar/no-primitive-wrappers\n    expect(isEmptyish(new String('test'))).toBe(false);\n  });\n});\n\ndescribe('arrays', () => {\n  it('simple', () => {\n    expect(isEmptyish([])).toBe(true);\n    expect(isEmptyish([1, 2, 3])).toBe(false);\n  });\n\n  it('sparse', () => {\n    // eslint-disable-next-line no-sparse-arrays\n    expect(isEmptyish([, ,])).toBe(false);\n  });\n\n  it('via Array.from', () => {\n    expect(isEmptyish(Array.from({ length: 0 }))).toBe(true);\n    expect(isEmptyish(Array.from({ length: 10 }))).toBe(false);\n  });\n\n  it('typed arrays', () => {\n    expect(isEmptyish(new Int8Array())).toBe(true);\n    expect(isEmptyish(new Int8Array([1, 2, 3]))).toBe(false);\n  });\n\n  it('buffers', () => {\n    expect(isEmptyish(Buffer.alloc(0))).toBe(true);\n    expect(isEmptyish(Buffer.alloc(3))).toBe(false);\n  });\n\n  it('sets', () => {\n    expect(isEmptyish(new Set())).toBe(true);\n    expect(isEmptyish(new Set([1, 2, 3]))).toBe(false);\n  });\n\n  it('array-like (e.g., `arguments`)', () => {\n    function empty(): void {\n      // eslint-disable-next-line prefer-rest-params\n      expect(isEmptyish(arguments)).toBe(true);\n    }\n    empty();\n\n    function nonEmpty(_p0: string, _p1: number, _p2: boolean): void {\n      // eslint-disable-next-line prefer-rest-params\n      expect(isEmptyish(arguments)).toBe(false);\n    }\n    nonEmpty('test', 123, true);\n  });\n});\n\ndescribe('keyed collections', () => {\n  it('plain objects', () => {\n    expect(isEmptyish({})).toBe(true);\n    expect(isEmptyish({ key: 'value' })).toBe(false);\n  });\n\n  it('null-prototyped objects', () => {\n    const object: { key?: string } = Object.create(null);\n\n    expect(isEmptyish(object)).toBe(true);\n\n    object.key = 'hello, world!';\n\n    expect(isEmptyish(object)).toBe(false);\n  });\n\n  it('symbol props', () => {\n    expect(isEmptyish({ [Symbol('hello')]: 'world' })).toBe(false);\n  });\n\n  it('maps', () => {\n    expect(isEmptyish(new Map())).toBe(true);\n    expect(isEmptyish(new Map([['key', 'value']]))).toBe(false);\n  });\n\n  it('url search params', () => {\n    expect(isEmptyish(new URLSearchParams())).toBe(true);\n    expect(isEmptyish(new URLSearchParams(''))).toBe(true);\n    expect(isEmptyish(new URLSearchParams('?'))).toBe(true);\n    expect(isEmptyish(new URLSearchParams('hello'))).toBe(false);\n    expect(isEmptyish(new URLSearchParams({ hello: 'world ' }))).toBe(false);\n  });\n\n  it('prototype chains', () => {\n    // Verifying chained prototypes would add complexity the implementation and\n    // incur performance costs, and the real-life practical use for such a chain\n    // is minimal.\n\n    expect(isEmptyish(Object.create(Object.create({})))).toBe(true);\n\n    expect(isEmptyish(Object.create(Object.create({ a: 123 })))).toBe(false);\n  });\n});\n\ndescribe('self-declared sizes', () => {\n  it('length', () => {\n    expect(isEmptyish({ length: 0 })).toBe(true);\n    expect(isEmptyish({ length: 1 })).toBe(false);\n  });\n\n  it('size', () => {\n    expect(isEmptyish({ size: 0 })).toBe(true);\n    expect(isEmptyish({ size: 1 })).toBe(false);\n  });\n\n  it('props are not coerced', () => {\n    expect(isEmptyish({ length: '0' })).toBe(false);\n    expect(isEmptyish({ size: null })).toBe(false);\n  });\n\n  it('length has precedence over size', () => {\n    expect(isEmptyish({ length: 0, size: 5 })).toBe(true);\n    expect(isEmptyish({ length: 1, size: 0 })).toBe(false);\n  });\n});\n\ndescribe('unsupported types', () => {\n  // Most assertions in this section return the wrong value semantically and are\n  // here to document the expected outputs in those cases for the current\n  // implementation. If any of these break due to a change in the runtime\n  // implementation they should be fixed and possibly extracted out of this\n  // section!\n\n  describe('always false', () => {\n    // Empty !== Falsy...\n\n    it('numbers', () => {\n      expect(isEmptyish(0)).toBe(false);\n      expect(isEmptyish(-0)).toBe(false);\n      expect(isEmptyish(Number.NaN)).toBe(false);\n      expect(isEmptyish(Infinity)).toBe(false);\n      expect(isEmptyish(100)).toBe(false);\n      expect(isEmptyish(12.34)).toBe(false);\n    });\n\n    it('bigints', () => {\n      expect(isEmptyish(0n)).toBe(false);\n      expect(isEmptyish(1n)).toBe(false);\n    });\n\n    it('booleans', () => {\n      expect(isEmptyish(false)).toBe(false);\n      expect(isEmptyish(true)).toBe(false);\n    });\n\n    it('symbols', () => {\n      // Using an empty string in a symbol results in the same \"kind\" of\n      // symbol as ones created with a non-empty string. It's unlikely that the\n      // actual value of a symbol would be checked (and not its identity), and\n      // that that value would be checked for emptiness explicitly.\n\n      expect(isEmptyish(Symbol(''))).toBe(false);\n      expect(isEmptyish(Symbol('something'))).toBe(false);\n    });\n\n    it('functions', () => {\n      // It's not possible to check the contents of a function at runtime, and\n      // even if it were, there's a semantic difference between a purely empty\n      // function and one that doesn't do anything useful (but can still log,\n      // for example).\n\n      expect(isEmptyish(() => {})).toBe(false);\n      expect(\n        isEmptyish(() => {\n          // eslint-disable-next-line no-console\n          console.log('hello');\n        }),\n      ).toBe(false);\n    });\n  });\n\n  it('classes', () => {\n    // It's hard to define what an empty class is; does it have private members?\n    // are we considering it empty if one of it's fields is empty?\n\n    // eslint-disable-next-line ts/no-extraneous-class\n    class Empty {}\n    class NonEmpty {\n      public a = 'hello';\n    }\n    class NonEmptyButPrivate {\n      readonly #a = 'hello';\n\n      public get a(): string {\n        return this.#a;\n      }\n    }\n    class ContainerWrapper {\n      public data: Array<unknown> = [];\n    }\n\n    expect(isEmptyish(new Empty())).toBe(true);\n    expect(isEmptyish(new NonEmpty())).toBe(false);\n    expect(isEmptyish(new NonEmptyButPrivate())).toBe(true);\n    expect(isEmptyish(new ContainerWrapper())).toBe(false);\n  });\n\n  it('errors', () => {\n    // Errors are just classes! We don't special-case errors to check the length\n    // of the message because errors could be designed so that the message is\n    // not important and they hold information in other properties, and they\n    // wouldn't be semantically empty because of that.\n\n    class MyError extends Error {\n      public constructor(public data = 'hello') {\n        super();\n      }\n    }\n\n    // eslint-disable-next-line unicorn/error-message\n    expect(isEmptyish(new Error())).toBe(true);\n    expect(isEmptyish(new Error('hello world!'))).toBe(true);\n    expect(isEmptyish(new MyError())).toBe(false);\n  });\n\n  describe('always true', () => {\n    // These are built-in classes that would be assessed the same way we\n    // assess objects; for the most part they come up as empty because they\n    // don't have any public properties. We don't special-case them for\n    // performance reasons (they would add redundant checks).\n\n    it('regexp', () => {\n      // There is no value in an empty regexp because it catches nothing so it's\n      // unlikely that this would be needed.\n\n      // eslint-disable-next-line prefer-regex-literals, sonar/no-empty-group\n      expect(isEmptyish(new RegExp(''))).toBe(true);\n      expect(isEmptyish(/abc/u)).toBe(true);\n    });\n\n    it('dates', () => {\n      // Dates are wrapped numbers, even if we special-case them there is no\n      // clear semantic for what an \"empty\" date would be.\n\n      expect(isEmptyish(new Date(0))).toBe(true);\n      expect(isEmptyish(new Date())).toBe(true);\n    });\n\n    it('weak collections', () => {\n      // Weak collections don't have a mechanism that allows tracking its size\n      // or enumerating its entries.\n\n      expect(isEmptyish(new WeakMap())).toBe(true);\n      expect(isEmptyish(new WeakSet())).toBe(true);\n    });\n  });\n});\n"],"mappings":"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"}

package/dist/is-error.cjs

@@ -1 +1 @@
-const e=require(`./is-error-bQ2IwWHj.cjs`);exports.isError=e.isError;
+function e(e){return e instanceof Error}exports.isError=e;

package/dist/is-error.d.cts

@@ -1,2 +1,18 @@
-import { isError } from "./is-error-7hLjNT9B.cjs";
-export { isError };
+//#region src/is-error.d.ts
+type DefinitelyError<T> = Extract<T, Error> extends never ? Error : Extract<T, Error>;
+/**
+ * A function that checks if the passed parameter is an Error and narrows its type accordingly.
+ *
+ * @param data - The variable to check.
+ * @returns True if the passed input is an Error, false otherwise.
+ * @signature
+ *    P.isError(data)
+ * @example
+ *    P.isError(new Error('message')) //=> true
+ *    P.isError('somethingElse') //=> false
+ * @category Guard
+ */
+declare function isError<T>(data: Error | T): data is DefinitelyError<T>;
+//#endregion
+export { isError };
+//# sourceMappingURL=is-error.d.cts.map

package/dist/is-error.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-error.d.cts","names":[],"sources":["../src/is-error.ts"],"sourcesContent":[],"mappings":";KAAK,qBACD,QAAQ,GAAG,uBAAuB,QAAQ,QAAQ,GAAG;;;;;;;;;;AAazD;;;AAAqE,iBAArD,OAAqD,CAAA,CAAA,CAAA,CAAA,IAAA,EAApC,KAAoC,GAA5B,CAA4B,CAAA,EAAA,IAAA,IAAhB,eAAgB,CAAA,CAAA,CAAA"}

package/dist/is-error.d.ts

@@ -1,2 +1,18 @@
-import { isError } from "./is-error-CjiajQ5C.js";
-export { isError };
+//#region src/is-error.d.ts
+type DefinitelyError<T> = Extract<T, Error> extends never ? Error : Extract<T, Error>;
+/**
+ * A function that checks if the passed parameter is an Error and narrows its type accordingly.
+ *
+ * @param data - The variable to check.
+ * @returns True if the passed input is an Error, false otherwise.
+ * @signature
+ *    P.isError(data)
+ * @example
+ *    P.isError(new Error('message')) //=> true
+ *    P.isError('somethingElse') //=> false
+ * @category Guard
+ */
+declare function isError<T>(data: Error | T): data is DefinitelyError<T>;
+//#endregion
+export { isError };
+//# sourceMappingURL=is-error.d.ts.map

package/dist/is-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-error.d.ts","names":[],"sources":["../src/is-error.ts"],"sourcesContent":[],"mappings":";KAAK,qBACD,QAAQ,GAAG,uBAAuB,QAAQ,QAAQ,GAAG;;;;;;;;;;AAazD;;;AAAqE,iBAArD,OAAqD,CAAA,CAAA,CAAA,CAAA,IAAA,EAApC,KAAoC,GAA5B,CAA4B,CAAA,EAAA,IAAA,IAAhB,eAAgB,CAAA,CAAA,CAAA"}

package/dist/is-error.js

@@ -1 +1,2 @@
-import{isError as e}from"./is-error-C0Qr0E3U.js";export{e as isError};
+function e(e){return e instanceof Error}export{e as isError};
+//# sourceMappingURL=is-error.js.map

package/dist/is-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-error.js","names":[],"sources":["../src/is-error.ts"],"sourcesContent":["type DefinitelyError<T>\n  = Extract<T, Error> extends never ? Error : Extract<T, Error>;\n/**\n * A function that checks if the passed parameter is an Error and narrows its type accordingly.\n *\n * @param data - The variable to check.\n * @returns True if the passed input is an Error, false otherwise.\n * @signature\n *    P.isError(data)\n * @example\n *    P.isError(new Error('message')) //=> true\n *    P.isError('somethingElse') //=> false\n * @category Guard\n */\nexport function isError<T>(data: Error | T): data is DefinitelyError<T> {\n  return data instanceof Error;\n}\n"],"mappings":"AAcA,SAAgB,EAAW,EAA6C,CACtE,OAAO,aAAgB"}

package/dist/is-function.cjs

@@ -1 +1 @@
-const e=require(`./is-function-DaoOpTFE.cjs`);exports.isFunction=e.isFunction;
+function e(e){return typeof e==`function`}exports.isFunction=e;

package/dist/is-function.d.cts

@@ -1,2 +1,18 @@
-import { isFunction } from "./is-function-o1ixw9eS.cjs";
-export { isFunction };
+//#region src/is-function.d.ts
+type DefinitelyFunction<T> = Extract<T, Function> extends never ? Function : Extract<T, Function>;
+/**
+ * A function that checks if the passed parameter is a Function and narrows its type accordingly.
+ *
+ * @param data - The variable to check.
+ * @returns True if the passed input is a Function, false otherwise.
+ * @signature
+ *    P.isFunction(data)
+ * @example
+ *    P.isFunction(() => {}) //=> true
+ *    P.isFunction('somethingElse') //=> false
+ * @category Guard
+ */
+declare function isFunction<T>(data: Function | T): data is DefinitelyFunction<T>;
+//#endregion
+export { isFunction };
+//# sourceMappingURL=is-function.d.cts.map

package/dist/is-function.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-function.d.cts","names":[],"sources":["../src/is-function.ts"],"sourcesContent":[],"mappings":";KAIK,wBACD,QAAQ,GAAG,0BAA0B,WAAW,QAAQ,GAAG;;;;;;;;;;AAa/D;;;AAE8B,iBAFd,UAEc,CAAA,CAAA,CAAA,CAAA,IAAA,EADtB,QACsB,GADX,CACW,CAAA,EAAA,IAAA,IAAnB,kBAAmB,CAAA,CAAA,CAAA"}

package/dist/is-function.d.ts

@@ -1,2 +1,18 @@
-import { isFunction } from "./is-function-DpNu_iYN.js";
-export { isFunction };
+//#region src/is-function.d.ts
+type DefinitelyFunction<T> = Extract<T, Function> extends never ? Function : Extract<T, Function>;
+/**
+ * A function that checks if the passed parameter is a Function and narrows its type accordingly.
+ *
+ * @param data - The variable to check.
+ * @returns True if the passed input is a Function, false otherwise.
+ * @signature
+ *    P.isFunction(data)
+ * @example
+ *    P.isFunction(() => {}) //=> true
+ *    P.isFunction('somethingElse') //=> false
+ * @category Guard
+ */
+declare function isFunction<T>(data: Function | T): data is DefinitelyFunction<T>;
+//#endregion
+export { isFunction };
+//# sourceMappingURL=is-function.d.ts.map

package/dist/is-function.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-function.d.ts","names":[],"sources":["../src/is-function.ts"],"sourcesContent":[],"mappings":";KAIK,wBACD,QAAQ,GAAG,0BAA0B,WAAW,QAAQ,GAAG;;;;;;;;;;AAa/D;;;AAE8B,iBAFd,UAEc,CAAA,CAAA,CAAA,CAAA,IAAA,EADtB,QACsB,GADX,CACW,CAAA,EAAA,IAAA,IAAnB,kBAAmB,CAAA,CAAA,CAAA"}

package/dist/is-function.js

@@ -1 +1,2 @@
-import{isFunction as e}from"./is-function-r9PVEQ1p.js";export{e as isFunction};
+function e(e){return typeof e==`function`}export{e as isFunction};
+//# sourceMappingURL=is-function.js.map

package/dist/is-function.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-function.js","names":[],"sources":["../src/is-function.ts"],"sourcesContent":["/* eslint-disable ts/no-unsafe-function-type --\n * Function is used generically in this file to define any type of function, so\n * this lint error is not relevant for it.\n */\ntype DefinitelyFunction<T>\n  = Extract<T, Function> extends never ? Function : Extract<T, Function>;\n/**\n * A function that checks if the passed parameter is a Function and narrows its type accordingly.\n *\n * @param data - The variable to check.\n * @returns True if the passed input is a Function, false otherwise.\n * @signature\n *    P.isFunction(data)\n * @example\n *    P.isFunction(() => {}) //=> true\n *    P.isFunction('somethingElse') //=> false\n * @category Guard\n */\nexport function isFunction<T>(\n  data: Function | T,\n): data is DefinitelyFunction<T> {\n  return typeof data === 'function';\n}\n"],"mappings":"AAkBA,SAAgB,EACd,EAC+B,CAC/B,OAAO,OAAO,GAAS"}

package/dist/is-included-in.cjs

@@ -1 +1 @@
-const e=require(`./is-included-in-B1CoqHXo.cjs`);exports.isIncludedIn=e.isIncludedIn;
+function e(e,t){if(t===void 0){let t=new Set(e);return e=>t.has(e)}return t.includes(e)}exports.isIncludedIn=e;

package/dist/is-included-in.d.cts

@@ -1,4 +1,110 @@
-import "./is-union-BEGCMhOi.cjs";
-import "./iterable-container-V5sa0V_H.cjs";
-import { isIncludedIn } from "./is-included-in-ciZ0ThQh.cjs";
-export { isIncludedIn };
+import { t as IsUnion } from "./is-union-Dp9mCo1b.cjs";
+import { t as IterableContainer } from "./iterable-container-OFsaw8WL.cjs";
+import { IsLiteral } from "type-fest";
+
+//#region src/is-included-in.d.ts
+
+/**
+ * A "constant" tuple is a type that has a single runtime value that can fulfil
+ * it. This means that it doesn't have any variadic/rest/spread/array parts, and
+ * that all it's values are singular (non-union) literals.
+ *
+ * We use this type to allow narrowing when checking against a set of values
+ * defined as a const.
+ *
+ * @example
+ *   type T1 = IsConstantTuple<["cat", "dog", 3, true]>; // => true;
+ *   type T2 = IsConstantTuple<["cat" | "dog"]>; // false;
+ *   type T2 = IsConstantTuple<["cat", ...Array<"cat">]>; // false;
+ */
+type IsConstantTuple<T extends IterableContainer> = T extends readonly [] ? true : T extends readonly [infer Head, ...infer Rest] ? IsUnion<Head> extends true ? false : IsConstantTuple<Rest> : false;
+/**
+ * There is no way to tell Typescript to only narrow the "accepted" side of a
+ * type-predicate and so in many cases the negated side is also affected, this
+ * results in over-narrowing in many cases, breaking typing. For this reason we
+ * only want to use the type-predicate variant of `isIncludedIn` when we can
+ * assume the result represents the expected types (closely enough). This is not
+ * and ideal solution and we will still generate wrong types in some cases (see
+ * tests), but it reduces the surface of this problem significantly, while still
+ * keeping the utility of `isIncludedIn` for the common cases.
+ *
+ * TL;DR - The types are narrowable when: T is literal and S is a pure tuple, or
+ * when T isn't a literal, but S is.
+ *
+ * @example
+ *   const data = 1 as 1 | 2 | 3;
+ *   const container = [] as Array<1 | 2>;
+ *   if (isIncludedIn(data, container)) {
+ *     ... it makes sense to narrow data to `1 | 2` as the value `3` is not part
+ *     ... of the typing of container, so will never result in being true.
+ *   } else {
+ *     ... but it doesn't make sense to narrow the value to 3 here, because 1
+ *     ... and 2 are still valid values for data, when container doesn't include
+ *     ... them **at runtime**.
+ *     ... Typescript narrows the _rejected_ branch based on how it narrowed the
+ *     ... _accepted_ clause, and we can't control that; because our input type
+ *     ... is `1 | 2 | 3` and the accepted side is `1 | 2`, the rejected side is
+ *     ... typed `Exclude<1 | 2 | 3, 1 | 2>`, which is `3`.
+ *   }
+ * }
+ */
+type IsNarrowable<T, S extends IterableContainer<T>> = IsLiteral<T> extends true ? IsConstantTuple<S> : IsLiteral<S[number]>;
+/**
+ * Checks if the item is included in the container. This is a wrapper around
+ * `Array.prototype.includes` and `Set.prototype.has` and thus relies on the
+ * same equality checks that those functions do (which is reference equality,
+ * e.g. `===`). In some cases the input's type is also narrowed to the
+ * container's item types.
+ *
+ * Notice that unlike most functions, this function takes a generic item as it's
+ * data and **an array** as it's parameter.
+ *
+ * @param data - The item that is checked.
+ * @param container - The items that are checked against.
+ * @returns `true` if the item is in the container, or `false` otherwise. In
+ * cases the type of `data` is also narrowed down.
+ * @signature
+ *   P.isIncludedIn(data, container);
+ * @example
+ *   P.isIncludedIn(2, [1, 2, 3]); // => true
+ *   P.isIncludedIn(4, [1, 2, 3]); // => false
+ *
+ *   const data = "cat" as "cat" | "dog" | "mouse";
+ *   P.isIncludedIn(data, ["cat", "dog"] as const); // true (typed "cat" | "dog");
+ * @dataFirst
+ * @category Guard
+ */
+declare function isIncludedIn<T, S extends IterableContainer<T>>(data: T, container: IsNarrowable<T, S> extends true ? S : never): data is S[number];
+declare function isIncludedIn<T, S extends T>(data: T, container: IterableContainer<S>): boolean;
+/**
+ * Checks if the item is included in the container. This is a wrapper around
+ * `Array.prototype.includes` and `Set.prototype.has` and thus relies on the
+ * same equality checks that those functions do (which is reference equality,
+ * e.g. `===`). In some cases the input's type is also narrowed to the
+ * container's item types.
+ *
+ * Notice that unlike most functions, this function takes a generic item as it's
+ * data and **an array** as it's parameter.
+ *
+ * @param container - The items that are checked against.
+ * @returns `true` if the item is in the container, or `false` otherwise. In
+ * cases the type of `data` is also narrowed down.
+ * @signature
+ *   P.isIncludedIn(container)(data);
+ * @example
+ *   P.pipe(2, P.isIncludedIn([1, 2, 3])); // => true
+ *   P.pipe(4, P.isIncludedIn([1, 2, 3])); // => false
+ *
+ *   const data = "cat" as "cat" | "dog" | "mouse";
+ *   P.pipe(
+ *     data,
+ *     P.isIncludedIn(["cat", "dog"] as const),
+ *   ); // => true (typed "cat" | "dog");
+ * @dataLast
+ * @category Guard
+ */
+declare function isIncludedIn<T, S extends IterableContainer<T>>(container: IsNarrowable<T, S> extends true ? S : never): (data: T) => data is S[number];
+declare function isIncludedIn<T, S extends T>(container: IterableContainer<S>): (data: T) => boolean;
+//#endregion
+export { isIncludedIn };
+//# sourceMappingURL=is-included-in.d.cts.map

package/dist/is-included-in.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-included-in.d.cts","names":[],"sources":["../src/is-included-in.ts"],"sourcesContent":[],"mappings":";;;;;;;;AAE6E;;;;;;;;;AAoBtD;;KALlB,eAsC0B,CAAA,UAtCA,iBAsCA,CAAA,GAtCqB,CAsCrB,SAAA,SAAA,EAAA,GAAA,IAAA,GApC3B,CAoC2B,SAAA,SAAA,CAAA,KAAA,KAAA,EAAA,GAAA,KAAA,KAAA,CAAA,GAnCzB,OAmCyB,CAnCjB,IAmCiB,CAAA,SAAA,IAAA,GAAA,KAAA,GAjCvB,eAiCuB,CAjCP,IAiCO,CAAA,GAAA,KAAA;;;;;;;;AAwC/B;;;;;;;;;;AAIA;;;;;;AAgCA;;;;;;;KA5EK,YA8EK,CAAA,CAAA,EAAA,UA9EqB,iBA8ErB,CA9EuC,CA8EvC,CAAA,CAAA,GA7EN,SA6EM,CA7EI,CA6EJ,CAAA,SAAA,IAAA,GArEJ,eAqEI,CArEY,CAqEZ,CAAA,GAjEJ,SAiEI,CAjEM,CAiEN,CAAA,MAAA,CAAA,CAAA;;;AACV;;;;;;;;;;;;;;;;;;;;;;;iBAvCgB,0BAA0B,kBAAkB,UACpD,cACK,aAAa,GAAG,kBAAkB,oBACpC;iBACK,0BAA0B,SAClC,cACK,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA8Bf,0BAA0B,kBAAkB,eAC/C,aAAa,GAAG,kBAAkB,mBACrC,cAAc;iBACR,0BAA0B,cAC7B,kBAAkB,YACrB"}

package/dist/is-included-in.d.ts

@@ -1,4 +1,110 @@
-import "./is-union-CBVcM_uW.js";
-import "./iterable-container-wtkYslN_.js";
-import { isIncludedIn } from "./is-included-in-CPnrdiNI.js";
-export { isIncludedIn };
+import { t as IsUnion } from "./is-union-Bu19sEkP.js";
+import { t as IterableContainer } from "./iterable-container-BdjPuIjL.js";
+import { IsLiteral } from "type-fest";
+
+//#region src/is-included-in.d.ts
+
+/**
+ * A "constant" tuple is a type that has a single runtime value that can fulfil
+ * it. This means that it doesn't have any variadic/rest/spread/array parts, and
+ * that all it's values are singular (non-union) literals.
+ *
+ * We use this type to allow narrowing when checking against a set of values
+ * defined as a const.
+ *
+ * @example
+ *   type T1 = IsConstantTuple<["cat", "dog", 3, true]>; // => true;
+ *   type T2 = IsConstantTuple<["cat" | "dog"]>; // false;
+ *   type T2 = IsConstantTuple<["cat", ...Array<"cat">]>; // false;
+ */
+type IsConstantTuple<T extends IterableContainer> = T extends readonly [] ? true : T extends readonly [infer Head, ...infer Rest] ? IsUnion<Head> extends true ? false : IsConstantTuple<Rest> : false;
+/**
+ * There is no way to tell Typescript to only narrow the "accepted" side of a
+ * type-predicate and so in many cases the negated side is also affected, this
+ * results in over-narrowing in many cases, breaking typing. For this reason we
+ * only want to use the type-predicate variant of `isIncludedIn` when we can
+ * assume the result represents the expected types (closely enough). This is not
+ * and ideal solution and we will still generate wrong types in some cases (see
+ * tests), but it reduces the surface of this problem significantly, while still
+ * keeping the utility of `isIncludedIn` for the common cases.
+ *
+ * TL;DR - The types are narrowable when: T is literal and S is a pure tuple, or
+ * when T isn't a literal, but S is.
+ *
+ * @example
+ *   const data = 1 as 1 | 2 | 3;
+ *   const container = [] as Array<1 | 2>;
+ *   if (isIncludedIn(data, container)) {
+ *     ... it makes sense to narrow data to `1 | 2` as the value `3` is not part
+ *     ... of the typing of container, so will never result in being true.
+ *   } else {
+ *     ... but it doesn't make sense to narrow the value to 3 here, because 1
+ *     ... and 2 are still valid values for data, when container doesn't include
+ *     ... them **at runtime**.
+ *     ... Typescript narrows the _rejected_ branch based on how it narrowed the
+ *     ... _accepted_ clause, and we can't control that; because our input type
+ *     ... is `1 | 2 | 3` and the accepted side is `1 | 2`, the rejected side is
+ *     ... typed `Exclude<1 | 2 | 3, 1 | 2>`, which is `3`.
+ *   }
+ * }
+ */
+type IsNarrowable<T, S extends IterableContainer<T>> = IsLiteral<T> extends true ? IsConstantTuple<S> : IsLiteral<S[number]>;
+/**
+ * Checks if the item is included in the container. This is a wrapper around
+ * `Array.prototype.includes` and `Set.prototype.has` and thus relies on the
+ * same equality checks that those functions do (which is reference equality,
+ * e.g. `===`). In some cases the input's type is also narrowed to the
+ * container's item types.
+ *
+ * Notice that unlike most functions, this function takes a generic item as it's
+ * data and **an array** as it's parameter.
+ *
+ * @param data - The item that is checked.
+ * @param container - The items that are checked against.
+ * @returns `true` if the item is in the container, or `false` otherwise. In
+ * cases the type of `data` is also narrowed down.
+ * @signature
+ *   P.isIncludedIn(data, container);
+ * @example
+ *   P.isIncludedIn(2, [1, 2, 3]); // => true
+ *   P.isIncludedIn(4, [1, 2, 3]); // => false
+ *
+ *   const data = "cat" as "cat" | "dog" | "mouse";
+ *   P.isIncludedIn(data, ["cat", "dog"] as const); // true (typed "cat" | "dog");
+ * @dataFirst
+ * @category Guard
+ */
+declare function isIncludedIn<T, S extends IterableContainer<T>>(data: T, container: IsNarrowable<T, S> extends true ? S : never): data is S[number];
+declare function isIncludedIn<T, S extends T>(data: T, container: IterableContainer<S>): boolean;
+/**
+ * Checks if the item is included in the container. This is a wrapper around
+ * `Array.prototype.includes` and `Set.prototype.has` and thus relies on the
+ * same equality checks that those functions do (which is reference equality,
+ * e.g. `===`). In some cases the input's type is also narrowed to the
+ * container's item types.
+ *
+ * Notice that unlike most functions, this function takes a generic item as it's
+ * data and **an array** as it's parameter.
+ *
+ * @param container - The items that are checked against.
+ * @returns `true` if the item is in the container, or `false` otherwise. In
+ * cases the type of `data` is also narrowed down.
+ * @signature
+ *   P.isIncludedIn(container)(data);
+ * @example
+ *   P.pipe(2, P.isIncludedIn([1, 2, 3])); // => true
+ *   P.pipe(4, P.isIncludedIn([1, 2, 3])); // => false
+ *
+ *   const data = "cat" as "cat" | "dog" | "mouse";
+ *   P.pipe(
+ *     data,
+ *     P.isIncludedIn(["cat", "dog"] as const),
+ *   ); // => true (typed "cat" | "dog");
+ * @dataLast
+ * @category Guard
+ */
+declare function isIncludedIn<T, S extends IterableContainer<T>>(container: IsNarrowable<T, S> extends true ? S : never): (data: T) => data is S[number];
+declare function isIncludedIn<T, S extends T>(container: IterableContainer<S>): (data: T) => boolean;
+//#endregion
+export { isIncludedIn };
+//# sourceMappingURL=is-included-in.d.ts.map

package/dist/is-included-in.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-included-in.d.ts","names":[],"sources":["../src/is-included-in.ts"],"sourcesContent":[],"mappings":";;;;;;;;AAE6E;;;;;;;;;AAoBtD;;KALlB,eAsC0B,CAAA,UAtCA,iBAsCA,CAAA,GAtCqB,CAsCrB,SAAA,SAAA,EAAA,GAAA,IAAA,GApC3B,CAoC2B,SAAA,SAAA,CAAA,KAAA,KAAA,EAAA,GAAA,KAAA,KAAA,CAAA,GAnCzB,OAmCyB,CAnCjB,IAmCiB,CAAA,SAAA,IAAA,GAAA,KAAA,GAjCvB,eAiCuB,CAjCP,IAiCO,CAAA,GAAA,KAAA;;;;;;;;AAwC/B;;;;;;;;;;AAIA;;;;;;AAgCA;;;;;;;KA5EK,YA8EK,CAAA,CAAA,EAAA,UA9EqB,iBA8ErB,CA9EuC,CA8EvC,CAAA,CAAA,GA7EN,SA6EM,CA7EI,CA6EJ,CAAA,SAAA,IAAA,GArEJ,eAqEI,CArEY,CAqEZ,CAAA,GAjEJ,SAiEI,CAjEM,CAiEN,CAAA,MAAA,CAAA,CAAA;;;AACV;;;;;;;;;;;;;;;;;;;;;;;iBAvCgB,0BAA0B,kBAAkB,UACpD,cACK,aAAa,GAAG,kBAAkB,oBACpC;iBACK,0BAA0B,SAClC,cACK,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA8Bf,0BAA0B,kBAAkB,eAC/C,aAAa,GAAG,kBAAkB,mBACrC,cAAc;iBACR,0BAA0B,cAC7B,kBAAkB,YACrB"}

package/dist/is-included-in.js

@@ -1 +1,2 @@
-import{isIncludedIn as e}from"./is-included-in-BeJz7gyj.js";export{e as isIncludedIn};
+function e(e,t){if(t===void 0){let t=new Set(e);return e=>t.has(e)}return t.includes(e)}export{e as isIncludedIn};
+//# sourceMappingURL=is-included-in.js.map