@pithos/core 2.0.0

package/dist/taphos/collection/every.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Checks if predicate returns truthy for all elements of collection.
+ *
+ * @template T - The type of elements in the array, or the object type.
+ * @param collection - The collection to iterate over.
+ * @param predicate - The function invoked per iteration.
+ * @returns `true` if all elements pass the predicate check, else `false`.
+ * @deprecated Use `array.every()` or `Object.values().every()` directly instead.
+ * @see {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/every | Array.every() - MDN}
+ * @see {@link https://caniuse.com/mdn-javascript_builtins_array_every | Browser support - Can I Use}
+ * @see {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object/values | Object.values() - MDN}
+ * @see {@link https://caniuse.com/mdn-javascript_builtins_object_values | Browser support - Can I Use}
+ * @since 2.0.0
+ *
+ * @example
+ * ```typescript
+ * const numbers = [1, 2, 3, 4, 5];
+ *
+ * // ❌ Deprecated approach
+ * const allPositive = every(numbers, n => n > 0);
+ * console.log(allPositive); // true
+ *
+ * // ✅ Recommended approach (for arrays)
+ * const allPositiveNative = numbers.every(n => n > 0);
+ * console.log(allPositiveNative); // true
+ *
+ * // ✅ Recommended approach (for objects)
+ * const obj = { a: 1, b: 2, c: 3 };
+ * const allPositiveObj = Object.values(obj).every(n => n > 0);
+ * console.log(allPositiveObj); // true
+ * ```
+ */
+export declare function every<T>(collection: T[], predicate: (value: T, index: number, array: T[]) => boolean): boolean;
+export declare function every<T extends Record<string, unknown>>(collection: T, predicate: (value: T[keyof T], key: keyof T, object: T) => boolean): boolean;
+//# sourceMappingURL=every.d.ts.map

package/dist/taphos/collection/every.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"every.d.ts","sourceRoot":"","sources":["../../../src/taphos/collection/every.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAEH,wBAAgB,KAAK,CAAC,CAAC,EACrB,UAAU,EAAE,CAAC,EAAE,EACf,SAAS,EAAE,CAAC,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,OAAO,GAC1D,OAAO,CAAC;AACX,wBAAgB,KAAK,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACrD,UAAU,EAAE,CAAC,EACb,SAAS,EAAE,CAAC,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC,KAAK,OAAO,GACjE,OAAO,CAAC"}

package/dist/taphos/collection/every.js

@@ -0,0 +1,41 @@
+/**
+ * Checks if predicate returns truthy for all elements of collection.
+ *
+ * @template T - The type of elements in the array, or the object type.
+ * @param collection - The collection to iterate over.
+ * @param predicate - The function invoked per iteration.
+ * @returns `true` if all elements pass the predicate check, else `false`.
+ * @deprecated Use `array.every()` or `Object.values().every()` directly instead.
+ * @see {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/every | Array.every() - MDN}
+ * @see {@link https://caniuse.com/mdn-javascript_builtins_array_every | Browser support - Can I Use}
+ * @see {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object/values | Object.values() - MDN}
+ * @see {@link https://caniuse.com/mdn-javascript_builtins_object_values | Browser support - Can I Use}
+ * @since 2.0.0
+ *
+ * @example
+ * ```typescript
+ * const numbers = [1, 2, 3, 4, 5];
+ *
+ * // ❌ Deprecated approach
+ * const allPositive = every(numbers, n => n > 0);
+ * console.log(allPositive); // true
+ *
+ * // ✅ Recommended approach (for arrays)
+ * const allPositiveNative = numbers.every(n => n > 0);
+ * console.log(allPositiveNative); // true
+ *
+ * // ✅ Recommended approach (for objects)
+ * const obj = { a: 1, b: 2, c: 3 };
+ * const allPositiveObj = Object.values(obj).every(n => n > 0);
+ * console.log(allPositiveObj); // true
+ * ```
+ */
+// INTENTIONAL: Implementation signature uses `unknown` to satisfy both overloads - public API is type-safe via overloads
+export function every(collection, predicate) {
+    if (Array.isArray(collection)) {
+        return collection.every(predicate);
+    }
+    const obj = collection;
+    return Object.entries(obj).every(([key, value]) => predicate(value, key, obj));
+}
+//# sourceMappingURL=every.js.map

package/dist/taphos/collection/every.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"every.js","sourceRoot":"","sources":["../../../src/taphos/collection/every.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAUH,yHAAyH;AACzH,MAAM,UAAU,KAAK,CACnB,UAAmB,EACnB,SAAkB;IAElB,IAAI,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC;QAC9B,OAAO,UAAU,CAAC,KAAK,CAAC,SAAyE,CAAC,CAAC;IACrG,CAAC;IAED,MAAM,GAAG,GAAG,UAAqC,CAAC;IAClD,OAAO,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CAC/C,SAAuF,CAAC,KAAK,EAAE,GAAG,EAAE,GAAG,CAAC,CAC1G,CAAC;AACJ,CAAC"}

package/dist/taphos/collection/filter.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Iterates over elements of collection, returning an array of all elements predicate returns truthy for.
+ *
+ * @template T - The type of elements in the array, or the object type.
+ * @param collection - The collection to iterate over.
+ * @param predicate - The function invoked per iteration.
+ * @returns The new filtered array or object.
+ * @deprecated Use `array.filter()` or `Object.entries().filter()` directly instead.
+ * @see {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/filter | Array.filter() - MDN}
+ * @see {@link https://caniuse.com/mdn-javascript_builtins_array_filter | Browser support - Can I Use}
+ * @see {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object/entries | Object.entries() - MDN}
+ * @see {@link https://caniuse.com/mdn-javascript_builtins_object_entries | Browser support - Can I Use}
+ * @since 2.0.0
+ *
+ * @example
+ * ```typescript
+ * const numbers = [1, 2, 3, 4, 5];
+ *
+ * // ❌ Deprecated approach
+ * const evenNumbers = filter(numbers, n => n % 2 === 0);
+ * console.log(evenNumbers); // [2, 4]
+ *
+ * // ✅ Recommended approach (for arrays)
+ * const evenNumbersNative = numbers.filter(n => n % 2 === 0);
+ * console.log(evenNumbersNative); // [2, 4]
+ *
+ * // ✅ Recommended approach (for objects)
+ * const obj = { a: 1, b: 2, c: 3 };
+ * const evenEntries = Object.fromEntries(
+ *   Object.entries(obj).filter(([, value]) => value % 2 === 0)
+ * );
+ * console.log(evenEntries); // { b: 2 }
+ * ```
+ */
+export declare function filter<T>(collection: T[], predicate: (value: T, index: number, array: T[]) => boolean): T[];
+export declare function filter<T extends Record<string, unknown>>(collection: T, predicate: (value: T[keyof T], key: keyof T, object: T) => boolean): Partial<T>;
+//# sourceMappingURL=filter.d.ts.map

package/dist/taphos/collection/filter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"filter.d.ts","sourceRoot":"","sources":["../../../src/taphos/collection/filter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAEH,wBAAgB,MAAM,CAAC,CAAC,EACtB,UAAU,EAAE,CAAC,EAAE,EACf,SAAS,EAAE,CAAC,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,OAAO,GAC1D,CAAC,EAAE,CAAC;AACP,wBAAgB,MAAM,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACtD,UAAU,EAAE,CAAC,EACb,SAAS,EAAE,CAAC,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC,KAAK,OAAO,GACjE,OAAO,CAAC,CAAC,CAAC,CAAC"}

package/dist/taphos/collection/filter.js

@@ -0,0 +1,44 @@
+/**
+ * Iterates over elements of collection, returning an array of all elements predicate returns truthy for.
+ *
+ * @template T - The type of elements in the array, or the object type.
+ * @param collection - The collection to iterate over.
+ * @param predicate - The function invoked per iteration.
+ * @returns The new filtered array or object.
+ * @deprecated Use `array.filter()` or `Object.entries().filter()` directly instead.
+ * @see {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/filter | Array.filter() - MDN}
+ * @see {@link https://caniuse.com/mdn-javascript_builtins_array_filter | Browser support - Can I Use}
+ * @see {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object/entries | Object.entries() - MDN}
+ * @see {@link https://caniuse.com/mdn-javascript_builtins_object_entries | Browser support - Can I Use}
+ * @since 2.0.0
+ *
+ * @example
+ * ```typescript
+ * const numbers = [1, 2, 3, 4, 5];
+ *
+ * // ❌ Deprecated approach
+ * const evenNumbers = filter(numbers, n => n % 2 === 0);
+ * console.log(evenNumbers); // [2, 4]
+ *
+ * // ✅ Recommended approach (for arrays)
+ * const evenNumbersNative = numbers.filter(n => n % 2 === 0);
+ * console.log(evenNumbersNative); // [2, 4]
+ *
+ * // ✅ Recommended approach (for objects)
+ * const obj = { a: 1, b: 2, c: 3 };
+ * const evenEntries = Object.fromEntries(
+ *   Object.entries(obj).filter(([, value]) => value % 2 === 0)
+ * );
+ * console.log(evenEntries); // { b: 2 }
+ * ```
+ */
+// INTENTIONAL: Implementation signature uses `unknown` to satisfy both overloads - public API is type-safe via overloads
+export function filter(collection, predicate) {
+    if (Array.isArray(collection)) {
+        return collection.filter(predicate);
+    }
+    const obj = collection;
+    const pred = predicate;
+    return Object.fromEntries(Object.entries(obj).filter(([key, value]) => pred(value, key, obj)));
+}
+//# sourceMappingURL=filter.js.map

package/dist/taphos/collection/filter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"filter.js","sourceRoot":"","sources":["../../../src/taphos/collection/filter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAUH,yHAAyH;AACzH,MAAM,UAAU,MAAM,CACpB,UAAmB,EACnB,SAAkB;IAElB,IAAI,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC;QAC9B,OAAO,UAAU,CAAC,MAAM,CAAC,SAAyE,CAAC,CAAC;IACtG,CAAC;IAED,MAAM,GAAG,GAAG,UAAqC,CAAC;IAClD,MAAM,IAAI,GAAG,SAAsF,CAAC;IACpG,OAAO,MAAM,CAAC,WAAW,CACvB,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,CACpE,CAAC;AACJ,CAAC"}

package/dist/taphos/collection/flatMap.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Creates a flattened array of values by running each element in collection
+ * thru iteratee and flattening the mapped results.
+ *
+ * @template T - The type of elements in the collection.
+ * @template Result - The type of elements in the result.
+ * @param collection - The collection to iterate over.
+ * @param iteratee - The function invoked per iteration.
+ * @returns The new flattened array.
+ * @deprecated Use `array.flatMap()` directly instead.
+ * @see {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/flatMap | Array.flatMap() - MDN}
+ * @see {@link https://caniuse.com/mdn-javascript_builtins_array_flatmap | Browser support - Can I Use}
+ * @since 2.0.0
+ *
+ * @example
+ * ```typescript
+ * // ❌ Deprecated approach
+ * flatMap([1, 2], n => [n, n]);
+ * // => [1, 1, 2, 2]
+ *
+ * // ✅ Recommended approach
+ * [1, 2].flatMap(n => [n, n]);
+ * // => [1, 1, 2, 2]
+ * ```
+ */
+export declare function flatMap<T, Result>(collection: readonly T[], iteratee: (value: T, index: number, collection: readonly T[]) => Result | readonly Result[]): Result[];
+//# sourceMappingURL=flatMap.d.ts.map

package/dist/taphos/collection/flatMap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flatMap.d.ts","sourceRoot":"","sources":["../../../src/taphos/collection/flatMap.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,OAAO,CAAC,CAAC,EAAE,MAAM,EAC/B,UAAU,EAAE,SAAS,CAAC,EAAE,EACxB,QAAQ,EAAE,CAAC,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,CAAC,EAAE,KAAK,MAAM,GAAG,SAAS,MAAM,EAAE,GAC1F,MAAM,EAAE,CAEV"}

package/dist/taphos/collection/flatMap.js

@@ -0,0 +1,29 @@
+/**
+ * Creates a flattened array of values by running each element in collection
+ * thru iteratee and flattening the mapped results.
+ *
+ * @template T - The type of elements in the collection.
+ * @template Result - The type of elements in the result.
+ * @param collection - The collection to iterate over.
+ * @param iteratee - The function invoked per iteration.
+ * @returns The new flattened array.
+ * @deprecated Use `array.flatMap()` directly instead.
+ * @see {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/flatMap | Array.flatMap() - MDN}
+ * @see {@link https://caniuse.com/mdn-javascript_builtins_array_flatmap | Browser support - Can I Use}
+ * @since 2.0.0
+ *
+ * @example
+ * ```typescript
+ * // ❌ Deprecated approach
+ * flatMap([1, 2], n => [n, n]);
+ * // => [1, 1, 2, 2]
+ *
+ * // ✅ Recommended approach
+ * [1, 2].flatMap(n => [n, n]);
+ * // => [1, 1, 2, 2]
+ * ```
+ */
+export function flatMap(collection, iteratee) {
+    return collection.flatMap(iteratee);
+}
+//# sourceMappingURL=flatMap.js.map

package/dist/taphos/collection/flatMap.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"flatMap.js","sourceRoot":"","sources":["../../../src/taphos/collection/flatMap.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,UAAU,OAAO,CACrB,UAAwB,EACxB,QAA2F;IAE3F,OAAO,UAAU,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;AACtC,CAAC"}

package/dist/taphos/collection/flatMapDeep.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Creates a flattened array of values by running each element in collection
+ * thru iteratee and recursively flattening the mapped results.
+ *
+ * @template T - The type of elements in the collection.
+ * @param collection - The collection to iterate over.
+ * @param iteratee - The function invoked per iteration.
+ * @returns The new flattened array.
+ * @deprecated Use `array.flatMap().flat(Infinity)` directly instead.
+ * @see {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/flat | Array.flat() - MDN}
+ * @see {@link https://caniuse.com/mdn-javascript_builtins_array_flat | Browser support - Can I Use}
+ * @since 2.0.0
+ *
+ * @example
+ * ```typescript
+ * // ❌ Deprecated approach
+ * flatMapDeep([1, 2], n => [[n, n]]);
+ * // => [1, 1, 2, 2]
+ *
+ * // ✅ Recommended approach
+ * [1, 2].flatMap(n => [[n, n]]).flat(Infinity);
+ * // => [1, 1, 2, 2]
+ * ```
+ */
+export declare function flatMapDeep<T>(collection: readonly T[], iteratee: (value: T, index: number, collection: readonly T[]) => unknown): unknown[];
+//# sourceMappingURL=flatMapDeep.d.ts.map

package/dist/taphos/collection/flatMapDeep.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flatMapDeep.d.ts","sourceRoot":"","sources":["../../../src/taphos/collection/flatMapDeep.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAC3B,UAAU,EAAE,SAAS,CAAC,EAAE,EACxB,QAAQ,EAAE,CAAC,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,CAAC,EAAE,KAAK,OAAO,GACvE,OAAO,EAAE,CAEX"}

package/dist/taphos/collection/flatMapDeep.js

@@ -0,0 +1,28 @@
+/**
+ * Creates a flattened array of values by running each element in collection
+ * thru iteratee and recursively flattening the mapped results.
+ *
+ * @template T - The type of elements in the collection.
+ * @param collection - The collection to iterate over.
+ * @param iteratee - The function invoked per iteration.
+ * @returns The new flattened array.
+ * @deprecated Use `array.flatMap().flat(Infinity)` directly instead.
+ * @see {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/flat | Array.flat() - MDN}
+ * @see {@link https://caniuse.com/mdn-javascript_builtins_array_flat | Browser support - Can I Use}
+ * @since 2.0.0
+ *
+ * @example
+ * ```typescript
+ * // ❌ Deprecated approach
+ * flatMapDeep([1, 2], n => [[n, n]]);
+ * // => [1, 1, 2, 2]
+ *
+ * // ✅ Recommended approach
+ * [1, 2].flatMap(n => [[n, n]]).flat(Infinity);
+ * // => [1, 1, 2, 2]
+ * ```
+ */
+export function flatMapDeep(collection, iteratee) {
+    return collection.flatMap(iteratee).flat(Infinity);
+}
+//# sourceMappingURL=flatMapDeep.js.map

package/dist/taphos/collection/flatMapDeep.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"flatMapDeep.js","sourceRoot":"","sources":["../../../src/taphos/collection/flatMapDeep.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,UAAU,WAAW,CACzB,UAAwB,EACxB,QAAwE;IAExE,OAAO,UAAU,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;AACrD,CAAC"}

package/dist/taphos/collection/flatMapDepth.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Creates a flattened array of values by running each element in collection
+ * thru iteratee and flattening the mapped results up to depth times.
+ *
+ * @template T - The type of elements in the collection.
+ * @param collection - The collection to iterate over.
+ * @param iteratee - The function invoked per iteration.
+ * @param depth - The maximum recursion depth. Defaults to 1.
+ * @returns The new flattened array.
+ * @deprecated Use `array.flatMap().flat(depth)` directly instead.
+ * @see {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/flat | Array.flat() - MDN}
+ * @see {@link https://caniuse.com/mdn-javascript_builtins_array_flat | Browser support - Can I Use}
+ * @since 2.0.0
+ *
+ * @example
+ * ```typescript
+ * // ❌ Deprecated approach
+ * flatMapDepth([1, 2], n => [[[n, n]]], 2);
+ * // => [[1, 1], [2, 2]]
+ *
+ * // ✅ Recommended approach
+ * [1, 2].flatMap(n => [[[n, n]]]).flat(2);
+ * // => [[1, 1], [2, 2]]
+ * ```
+ */
+export declare function flatMapDepth<T>(collection: readonly T[], iteratee: (value: T, index: number, collection: readonly T[]) => unknown, depth?: number): unknown[];
+//# sourceMappingURL=flatMapDepth.d.ts.map

package/dist/taphos/collection/flatMapDepth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flatMapDepth.d.ts","sourceRoot":"","sources":["../../../src/taphos/collection/flatMapDepth.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAC5B,UAAU,EAAE,SAAS,CAAC,EAAE,EACxB,QAAQ,EAAE,CAAC,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,CAAC,EAAE,KAAK,OAAO,EACxE,KAAK,SAAI,GACR,OAAO,EAAE,CAEX"}

package/dist/taphos/collection/flatMapDepth.js

@@ -0,0 +1,29 @@
+/**
+ * Creates a flattened array of values by running each element in collection
+ * thru iteratee and flattening the mapped results up to depth times.
+ *
+ * @template T - The type of elements in the collection.
+ * @param collection - The collection to iterate over.
+ * @param iteratee - The function invoked per iteration.
+ * @param depth - The maximum recursion depth. Defaults to 1.
+ * @returns The new flattened array.
+ * @deprecated Use `array.flatMap().flat(depth)` directly instead.
+ * @see {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/flat | Array.flat() - MDN}
+ * @see {@link https://caniuse.com/mdn-javascript_builtins_array_flat | Browser support - Can I Use}
+ * @since 2.0.0
+ *
+ * @example
+ * ```typescript
+ * // ❌ Deprecated approach
+ * flatMapDepth([1, 2], n => [[[n, n]]], 2);
+ * // => [[1, 1], [2, 2]]
+ *
+ * // ✅ Recommended approach
+ * [1, 2].flatMap(n => [[[n, n]]]).flat(2);
+ * // => [[1, 1], [2, 2]]
+ * ```
+ */
+export function flatMapDepth(collection, iteratee, depth = 1) {
+    return collection.flatMap(iteratee).flat(depth);
+}
+//# sourceMappingURL=flatMapDepth.js.map

package/dist/taphos/collection/flatMapDepth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"flatMapDepth.js","sourceRoot":"","sources":["../../../src/taphos/collection/flatMapDepth.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,UAAU,YAAY,CAC1B,UAAwB,EACxB,QAAwE,EACxE,KAAK,GAAG,CAAC;IAET,OAAO,UAAU,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AAClD,CAAC"}

package/dist/taphos/collection/includes.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Checks if value is in collection.
+ *
+ * @template T - The type of elements in the array, or the object type.
+ * @param collection - The collection to inspect.
+ * @param value - The value to search for.
+ * @param fromIndex - The index to search from.
+ * @returns `true` if value is found, else `false`.
+ * @deprecated Use `array.includes()` or `Object.values().includes()` directly instead.
+ * @see {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/includes | Array.includes() - MDN}
+ * @see {@link https://caniuse.com/mdn-javascript_builtins_array_includes | Browser support - Can I Use}
+ * @see {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object/values | Object.values() - MDN}
+ * @see {@link https://caniuse.com/mdn-javascript_builtins_object_values | Browser support - Can I Use}
+ * @since 2.0.0
+ *
+ * @example
+ * ```typescript
+ * const numbers = [1, 2, 3, 4, 5];
+ *
+ * // ❌ Deprecated approach
+ * const hasThree = includes(numbers, 3);
+ * console.log(hasThree); // true
+ *
+ * // ✅ Recommended approach (for arrays)
+ * const hasThreeNative = numbers.includes(3);
+ * console.log(hasThreeNative); // true
+ *
+ * // ✅ Recommended approach (for objects)
+ * const obj = { a: 1, b: 2, c: 3 };
+ * const hasThreeObj = Object.values(obj).includes(3);
+ * console.log(hasThreeObj); // true
+ * ```
+ */
+export declare function includes<T>(collection: T[], value: T, fromIndex?: number): boolean;
+export declare function includes<T extends Record<string, unknown>>(collection: T, value: T[keyof T]): boolean;
+//# sourceMappingURL=includes.d.ts.map

package/dist/taphos/collection/includes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"includes.d.ts","sourceRoot":"","sources":["../../../src/taphos/collection/includes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAEH,wBAAgB,QAAQ,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;AACpF,wBAAgB,QAAQ,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACxD,UAAU,EAAE,CAAC,EACb,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,GAChB,OAAO,CAAC"}

package/dist/taphos/collection/includes.js

@@ -0,0 +1,41 @@
+/**
+ * Checks if value is in collection.
+ *
+ * @template T - The type of elements in the array, or the object type.
+ * @param collection - The collection to inspect.
+ * @param value - The value to search for.
+ * @param fromIndex - The index to search from.
+ * @returns `true` if value is found, else `false`.
+ * @deprecated Use `array.includes()` or `Object.values().includes()` directly instead.
+ * @see {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/includes | Array.includes() - MDN}
+ * @see {@link https://caniuse.com/mdn-javascript_builtins_array_includes | Browser support - Can I Use}
+ * @see {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object/values | Object.values() - MDN}
+ * @see {@link https://caniuse.com/mdn-javascript_builtins_object_values | Browser support - Can I Use}
+ * @since 2.0.0
+ *
+ * @example
+ * ```typescript
+ * const numbers = [1, 2, 3, 4, 5];
+ *
+ * // ❌ Deprecated approach
+ * const hasThree = includes(numbers, 3);
+ * console.log(hasThree); // true
+ *
+ * // ✅ Recommended approach (for arrays)
+ * const hasThreeNative = numbers.includes(3);
+ * console.log(hasThreeNative); // true
+ *
+ * // ✅ Recommended approach (for objects)
+ * const obj = { a: 1, b: 2, c: 3 };
+ * const hasThreeObj = Object.values(obj).includes(3);
+ * console.log(hasThreeObj); // true
+ * ```
+ */
+// INTENTIONAL: Implementation signature uses `unknown` to satisfy both overloads - public API is type-safe via overloads
+export function includes(collection, value, fromIndex) {
+    if (Array.isArray(collection)) {
+        return collection.includes(value, fromIndex);
+    }
+    return Object.values(collection).includes(value);
+}
+//# sourceMappingURL=includes.js.map

package/dist/taphos/collection/includes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"includes.js","sourceRoot":"","sources":["../../../src/taphos/collection/includes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAOH,yHAAyH;AACzH,MAAM,UAAU,QAAQ,CACtB,UAAmB,EACnB,KAAc,EACd,SAAkB;IAElB,IAAI,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC;QAC9B,OAAO,UAAU,CAAC,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;IAC/C,CAAC;IAED,OAAO,MAAM,CAAC,MAAM,CAAC,UAAqC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC"}

package/dist/taphos/collection/map.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Creates an array of values by running each element in collection thru iteratee.
+ *
+ * @template T - The type of elements in the array, or the object type.
+ * @template Result - The type of the mapped result.
+ * @param collection - The collection to iterate over.
+ * @param iteratee - The function invoked per iteration.
+ * @returns The new mapped array.
+ * @deprecated Use `array.map()` or `Object.entries().map()` directly instead.
+ * @see {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/map | Array.map() - MDN}
+ * @see {@link https://caniuse.com/mdn-javascript_builtins_array_map | Browser support - Can I Use}
+ * @see {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object/entries | Object.entries() - MDN}
+ * @see {@link https://caniuse.com/mdn-javascript_builtins_object_entries | Browser support - Can I Use}
+ * @since 2.0.0
+ *
+ * @example
+ * ```typescript
+ * const numbers = [1, 2, 3, 4, 5];
+ *
+ * // ❌ Deprecated approach
+ * const doubled = map(numbers, n => n * 2);
+ * console.log(doubled); // [2, 4, 6, 8, 10]
+ *
+ * // ✅ Recommended approach (for arrays)
+ * const doubledNative = numbers.map(n => n * 2);
+ * console.log(doubledNative); // [2, 4, 6, 8, 10]
+ *
+ * // ✅ Recommended approach (for objects)
+ * const obj = { a: 1, b: 2, c: 3 };
+ * const doubledObj = Object.entries(obj).map(([key, value]) => [key, value * 2]);
+ * console.log(doubledObj); // [['a', 2], ['b', 4], ['c', 6]]
+ * ```
+ */
+export declare function map<T, Result>(collection: T[], iteratee: (value: T, index: number, array: T[]) => Result): Result[];
+export declare function map<T extends Record<string, unknown>, Result>(collection: T, iteratee: (value: T[keyof T], key: keyof T, object: T) => Result): Result[];
+//# sourceMappingURL=map.d.ts.map

package/dist/taphos/collection/map.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"map.d.ts","sourceRoot":"","sources":["../../../src/taphos/collection/map.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAEH,wBAAgB,GAAG,CAAC,CAAC,EAAE,MAAM,EAC3B,UAAU,EAAE,CAAC,EAAE,EACf,QAAQ,EAAE,CAAC,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,MAAM,GACxD,MAAM,EAAE,CAAC;AACZ,wBAAgB,GAAG,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,EAC3D,UAAU,EAAE,CAAC,EACb,QAAQ,EAAE,CAAC,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC,KAAK,MAAM,GAC/D,MAAM,EAAE,CAAC"}

package/dist/taphos/collection/map.js

@@ -0,0 +1,43 @@
+/**
+ * Creates an array of values by running each element in collection thru iteratee.
+ *
+ * @template T - The type of elements in the array, or the object type.
+ * @template Result - The type of the mapped result.
+ * @param collection - The collection to iterate over.
+ * @param iteratee - The function invoked per iteration.
+ * @returns The new mapped array.
+ * @deprecated Use `array.map()` or `Object.entries().map()` directly instead.
+ * @see {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/map | Array.map() - MDN}
+ * @see {@link https://caniuse.com/mdn-javascript_builtins_array_map | Browser support - Can I Use}
+ * @see {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object/entries | Object.entries() - MDN}
+ * @see {@link https://caniuse.com/mdn-javascript_builtins_object_entries | Browser support - Can I Use}
+ * @since 2.0.0
+ *
+ * @example
+ * ```typescript
+ * const numbers = [1, 2, 3, 4, 5];
+ *
+ * // ❌ Deprecated approach
+ * const doubled = map(numbers, n => n * 2);
+ * console.log(doubled); // [2, 4, 6, 8, 10]
+ *
+ * // ✅ Recommended approach (for arrays)
+ * const doubledNative = numbers.map(n => n * 2);
+ * console.log(doubledNative); // [2, 4, 6, 8, 10]
+ *
+ * // ✅ Recommended approach (for objects)
+ * const obj = { a: 1, b: 2, c: 3 };
+ * const doubledObj = Object.entries(obj).map(([key, value]) => [key, value * 2]);
+ * console.log(doubledObj); // [['a', 2], ['b', 4], ['c', 6]]
+ * ```
+ */
+// INTENTIONAL: Implementation signature uses `unknown` to satisfy both overloads - public API is type-safe via overloads
+export function map(collection, iteratee) {
+    if (Array.isArray(collection)) {
+        return collection.map(iteratee);
+    }
+    const obj = collection;
+    const iter = iteratee;
+    return Object.entries(obj).map(([key, value]) => iter(value, key, obj));
+}
+//# sourceMappingURL=map.js.map

package/dist/taphos/collection/map.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"map.js","sourceRoot":"","sources":["../../../src/taphos/collection/map.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAUH,yHAAyH;AACzH,MAAM,UAAU,GAAG,CACjB,UAAmB,EACnB,QAAiB;IAEjB,IAAI,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC;QAC9B,OAAO,UAAU,CAAC,GAAG,CAAC,QAAwE,CAAC,CAAC;IAClG,CAAC;IAED,MAAM,GAAG,GAAG,UAAqC,CAAC;IAClD,MAAM,IAAI,GAAG,QAAqF,CAAC;IACnG,OAAO,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC;AAC1E,CAAC"}

package/dist/taphos/collection/pluck.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Gets the value of property from all elements in collection.
+ *
+ * @template T - The type of elements in the array.
+ * @template Key - The key of the property to pluck.
+ * @param collection - The collection to iterate over.
+ * @param path - The path of the property to pluck.
+ * @returns The new array of property values.
+ * @deprecated Use `array.map(item => item.property)` directly instead.
+ * @see {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/map | Array.map() - MDN}
+ * @see {@link https://caniuse.com/mdn-javascript_builtins_array_map | Browser support - Can I Use}
+ * @since 2.0.0
+ *
+ * @example
+ * ```typescript
+ * const users = [
+ *   { name: 'John', age: 25 },
+ *   { name: 'Jane', age: 30 },
+ *   { name: 'Bob', age: 20 }
+ * ];
+ *
+ * // ❌ Deprecated approach
+ * const names = pluck(users, 'name');
+ * console.log(names); // ['John', 'Jane', 'Bob']
+ *
+ * // ✅ Recommended approach
+ * const namesNative = users.map(user => user.name);
+ * console.log(namesNative); // ['John', 'Jane', 'Bob']
+ * ```
+ */
+export declare function pluck<T, Key extends keyof T>(collection: T[] | Record<string, T>, path: Key): T[Key][];
+//# sourceMappingURL=pluck.d.ts.map

package/dist/taphos/collection/pluck.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pluck.d.ts","sourceRoot":"","sources":["../../../src/taphos/collection/pluck.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAgB,KAAK,CAAC,CAAC,EAAE,GAAG,SAAS,MAAM,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,GAAG,GAAG,CAAC,CAAC,GAAG,CAAC,EAAE,CAKtG"}

package/dist/taphos/collection/pluck.js

@@ -0,0 +1,37 @@
+/**
+ * Gets the value of property from all elements in collection.
+ *
+ * @template T - The type of elements in the array.
+ * @template Key - The key of the property to pluck.
+ * @param collection - The collection to iterate over.
+ * @param path - The path of the property to pluck.
+ * @returns The new array of property values.
+ * @deprecated Use `array.map(item => item.property)` directly instead.
+ * @see {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/map | Array.map() - MDN}
+ * @see {@link https://caniuse.com/mdn-javascript_builtins_array_map | Browser support - Can I Use}
+ * @since 2.0.0
+ *
+ * @example
+ * ```typescript
+ * const users = [
+ *   { name: 'John', age: 25 },
+ *   { name: 'Jane', age: 30 },
+ *   { name: 'Bob', age: 20 }
+ * ];
+ *
+ * // ❌ Deprecated approach
+ * const names = pluck(users, 'name');
+ * console.log(names); // ['John', 'Jane', 'Bob']
+ *
+ * // ✅ Recommended approach
+ * const namesNative = users.map(user => user.name);
+ * console.log(namesNative); // ['John', 'Jane', 'Bob']
+ * ```
+ */
+export function pluck(collection, path) {
+    const items = Array.isArray(collection)
+        ? collection
+        : Object.values(collection);
+    return items.map((item) => item[path]);
+}
+//# sourceMappingURL=pluck.js.map

package/dist/taphos/collection/pluck.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pluck.js","sourceRoot":"","sources":["../../../src/taphos/collection/pluck.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,MAAM,UAAU,KAAK,CAAyB,UAAmC,EAAE,IAAS;IAC1F,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC;QACrC,CAAC,CAAC,UAAU;QACZ,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,UAAiB,CAAQ,CAAC;IAC5C,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;AACzC,CAAC"}