@pithos/core 2.0.0

package/dist/taphos/array/findIndex.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Returns the index of the first element predicate returns truthy for.
+ *
+ * Similar to `find`, but returns the index instead of the element itself.
+ *
+ * @template T - The type of elements in the array.
+ * @param array - The array to search.
+ * @param predicate - The function invoked per iteration.
+ * @returns The index of the found element, or `-1` if not found.
+ * @deprecated Use `array.findIndex(predicate)` directly instead.
+ * Reason: Native equivalent method now available
+ * @see {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/findIndex | Array.findIndex() - MDN}
+ * @see {@link https://caniuse.com/mdn-javascript_builtins_array_findindex | Browser support - Can I Use}
+ * @since 2.0.0
+ *
+ * @example
+ * ```typescript
+ * const users = [
+ *   { name: 'John', age: 25 },
+ *   { name: 'Jane', age: 30 },
+ *   { name: 'Bob', age: 35 }
+ * ];
+ *
+ * // ❌ Deprecated approach
+ * const index = findIndex(users, user => user.age > 28);
+ * console.log(index); // 1
+ *
+ * // ✅ Recommended approach
+ * const indexNative = users.findIndex(user => user.age > 28);
+ * console.log(indexNative); // 1
+ * ```
+ */
+export declare function findIndex<T>(array: T[], predicate: (value: T, index: number, array: T[]) => boolean): number;
+//# sourceMappingURL=findIndex.d.ts.map

package/dist/taphos/array/findIndex.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"findIndex.d.ts","sourceRoot":"","sources":["../../../src/taphos/array/findIndex.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,wBAAgB,SAAS,CAAC,CAAC,EACzB,KAAK,EAAE,CAAC,EAAE,EACV,SAAS,EAAE,CAAC,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,OAAO,GAC1D,MAAM,CAER"}

package/dist/taphos/array/findIndex.js

@@ -0,0 +1,36 @@
+/**
+ * Returns the index of the first element predicate returns truthy for.
+ *
+ * Similar to `find`, but returns the index instead of the element itself.
+ *
+ * @template T - The type of elements in the array.
+ * @param array - The array to search.
+ * @param predicate - The function invoked per iteration.
+ * @returns The index of the found element, or `-1` if not found.
+ * @deprecated Use `array.findIndex(predicate)` directly instead.
+ * Reason: Native equivalent method now available
+ * @see {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/findIndex | Array.findIndex() - MDN}
+ * @see {@link https://caniuse.com/mdn-javascript_builtins_array_findindex | Browser support - Can I Use}
+ * @since 2.0.0
+ *
+ * @example
+ * ```typescript
+ * const users = [
+ *   { name: 'John', age: 25 },
+ *   { name: 'Jane', age: 30 },
+ *   { name: 'Bob', age: 35 }
+ * ];
+ *
+ * // ❌ Deprecated approach
+ * const index = findIndex(users, user => user.age > 28);
+ * console.log(index); // 1
+ *
+ * // ✅ Recommended approach
+ * const indexNative = users.findIndex(user => user.age > 28);
+ * console.log(indexNative); // 1
+ * ```
+ */
+export function findIndex(array, predicate) {
+    return array.findIndex(predicate);
+}
+//# sourceMappingURL=findIndex.js.map

package/dist/taphos/array/findIndex.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"findIndex.js","sourceRoot":"","sources":["../../../src/taphos/array/findIndex.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,MAAM,UAAU,SAAS,CACvB,KAAU,EACV,SAA2D;IAE3D,OAAO,KAAK,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;AACpC,CAAC"}

package/dist/taphos/array/first.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Gets the first element of array.
+ *
+ * @template T - The type of elements in the array.
+ * @param array - The array to query.
+ * @returns The first element of the array, or `undefined` if empty.
+ * @deprecated Use `array[0]` or `array.at(0)` directly instead.
+ * Reason: Native equivalent method now available
+ * @see {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/at | Array.at() - MDN}
+ * @see {@link https://caniuse.com/mdn-javascript_builtins_array_at | Browser support - Can I Use}
+ * @since 2.0.0
+ *
+ * @example
+ * ```typescript
+ * const numbers = [1, 2, 3, 4, 5];
+ *
+ * // ❌ Deprecated approach
+ * const firstElement = first(numbers);
+ * console.log(firstElement); // 1
+ *
+ * // ✅ Recommended approach
+ * const firstNative = numbers[0];
+ * console.log(firstNative); // 1
+ *
+ * // ✅ Modern approach with ES2022
+ * const firstModern = numbers.at(0);
+ * console.log(firstModern); // 1
+ * ```
+ */
+export declare function first<T>(array: T[]): T | undefined;
+//# sourceMappingURL=first.d.ts.map

package/dist/taphos/array/first.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"first.d.ts","sourceRoot":"","sources":["../../../src/taphos/array/first.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAgB,KAAK,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,CAAC,GAAG,SAAS,CAElD"}

package/dist/taphos/array/first.js

@@ -0,0 +1,33 @@
+/**
+ * Gets the first element of array.
+ *
+ * @template T - The type of elements in the array.
+ * @param array - The array to query.
+ * @returns The first element of the array, or `undefined` if empty.
+ * @deprecated Use `array[0]` or `array.at(0)` directly instead.
+ * Reason: Native equivalent method now available
+ * @see {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/at | Array.at() - MDN}
+ * @see {@link https://caniuse.com/mdn-javascript_builtins_array_at | Browser support - Can I Use}
+ * @since 2.0.0
+ *
+ * @example
+ * ```typescript
+ * const numbers = [1, 2, 3, 4, 5];
+ *
+ * // ❌ Deprecated approach
+ * const firstElement = first(numbers);
+ * console.log(firstElement); // 1
+ *
+ * // ✅ Recommended approach
+ * const firstNative = numbers[0];
+ * console.log(firstNative); // 1
+ *
+ * // ✅ Modern approach with ES2022
+ * const firstModern = numbers.at(0);
+ * console.log(firstModern); // 1
+ * ```
+ */
+export function first(array) {
+    return array[0];
+}
+//# sourceMappingURL=first.js.map

package/dist/taphos/array/first.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"first.js","sourceRoot":"","sources":["../../../src/taphos/array/first.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,MAAM,UAAU,KAAK,CAAI,KAAU;IACjC,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC"}

package/dist/taphos/array/flatten.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Flattens array a single level deep.
+ *
+ * @template T - The type of elements in the array.
+ * @param array - The array to flatten.
+ * @returns A new flattened array.
+ * @deprecated Use `array.flat()` directly instead.
+ * Reason: Native equivalent method now available
+ * @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
+ * const nested = [1, [2, 3], [4, [5, 6]]];
+ *
+ * // ❌ Deprecated approach
+ * const flattened = flatten(nested);
+ * console.log(flattened); // [1, 2, 3, 4, [5, 6]]
+ *
+ * // ✅ Recommended approach
+ * const flattenedNative = nested.flat();
+ * console.log(flattenedNative); // [1, 2, 3, 4, [5, 6]]
+ * ```
+ */
+export declare function flatten<T>(array: (T | T[])[]): (T | T[])[];
+//# sourceMappingURL=flatten.d.ts.map

package/dist/taphos/array/flatten.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flatten.d.ts","sourceRoot":"","sources":["../../../src/taphos/array/flatten.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,OAAO,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAE1D"}

package/dist/taphos/array/flatten.js

@@ -0,0 +1,29 @@
+/**
+ * Flattens array a single level deep.
+ *
+ * @template T - The type of elements in the array.
+ * @param array - The array to flatten.
+ * @returns A new flattened array.
+ * @deprecated Use `array.flat()` directly instead.
+ * Reason: Native equivalent method now available
+ * @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
+ * const nested = [1, [2, 3], [4, [5, 6]]];
+ *
+ * // ❌ Deprecated approach
+ * const flattened = flatten(nested);
+ * console.log(flattened); // [1, 2, 3, 4, [5, 6]]
+ *
+ * // ✅ Recommended approach
+ * const flattenedNative = nested.flat();
+ * console.log(flattenedNative); // [1, 2, 3, 4, [5, 6]]
+ * ```
+ */
+export function flatten(array) {
+    return array.flat();
+}
+//# sourceMappingURL=flatten.js.map

package/dist/taphos/array/flatten.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"flatten.js","sourceRoot":"","sources":["../../../src/taphos/array/flatten.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,UAAU,OAAO,CAAI,KAAkB;IAC3C,OAAO,KAAK,CAAC,IAAI,EAAiB,CAAC;AACrC,CAAC"}

package/dist/taphos/array/flattenDeep.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Recursively flattens array.
+ *
+ * @template T - The type of the leaf elements in the array.
+ * @param array - The array to flatten.
+ * @returns A new deeply flattened array.
+ * @deprecated Use `array.flat(Infinity)` directly instead.
+ * Reason: Native equivalent method now available
+ * @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
+ * const deeplyNested = [1, [2, [3, [4, [5]]]]];
+ *
+ * // ❌ Deprecated approach
+ * const flattened = flattenDeep(deeplyNested);
+ * console.log(flattened); // [1, 2, 3, 4, 5]
+ *
+ * // ✅ Recommended approach
+ * const flattenedNative = deeplyNested.flat(Infinity);
+ * console.log(flattenedNative); // [1, 2, 3, 4, 5]
+ * ```
+ */
+export declare function flattenDeep<T>(array: unknown[]): T[];
+//# sourceMappingURL=flattenDeep.d.ts.map

package/dist/taphos/array/flattenDeep.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flattenDeep.d.ts","sourceRoot":"","sources":["../../../src/taphos/array/flattenDeep.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,CAAC,EAAE,CAEpD"}

package/dist/taphos/array/flattenDeep.js

@@ -0,0 +1,29 @@
+/**
+ * Recursively flattens array.
+ *
+ * @template T - The type of the leaf elements in the array.
+ * @param array - The array to flatten.
+ * @returns A new deeply flattened array.
+ * @deprecated Use `array.flat(Infinity)` directly instead.
+ * Reason: Native equivalent method now available
+ * @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
+ * const deeplyNested = [1, [2, [3, [4, [5]]]]];
+ *
+ * // ❌ Deprecated approach
+ * const flattened = flattenDeep(deeplyNested);
+ * console.log(flattened); // [1, 2, 3, 4, 5]
+ *
+ * // ✅ Recommended approach
+ * const flattenedNative = deeplyNested.flat(Infinity);
+ * console.log(flattenedNative); // [1, 2, 3, 4, 5]
+ * ```
+ */
+export function flattenDeep(array) {
+    return array.flat(Infinity);
+}
+//# sourceMappingURL=flattenDeep.js.map

package/dist/taphos/array/flattenDeep.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"flattenDeep.js","sourceRoot":"","sources":["../../../src/taphos/array/flattenDeep.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,UAAU,WAAW,CAAI,KAAgB;IAC7C,OAAO,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAQ,CAAC;AACrC,CAAC"}

package/dist/taphos/array/flattenDepth.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Recursively flattens array up to depth times.
+ *
+ * @template T - The type of the leaf elements in the array.
+ * @param array - The array to flatten.
+ * @param depth - The maximum recursion depth.
+ * @returns A new flattened array.
+ * @deprecated Use `array.flat(depth)` directly instead.
+ * Reason: Native equivalent method now available
+ * @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
+ * const nested = [1, [2, [3, [4]]]];
+ *
+ * // ❌ Deprecated approach
+ * const flattened = flattenDepth(nested, 2);
+ * console.log(flattened); // [1, 2, 3, [4]]
+ *
+ * // ✅ Recommended approach
+ * const flattenedNative = nested.flat(2);
+ * console.log(flattenedNative); // [1, 2, 3, [4]]
+ * ```
+ */
+export declare function flattenDepth<T>(array: unknown[], depth?: number): T[];
+//# sourceMappingURL=flattenDepth.d.ts.map

package/dist/taphos/array/flattenDepth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flattenDepth.d.ts","sourceRoot":"","sources":["../../../src/taphos/array/flattenDepth.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,KAAK,GAAE,MAAU,GAAG,CAAC,EAAE,CAExE"}

package/dist/taphos/array/flattenDepth.js

@@ -0,0 +1,30 @@
+/**
+ * Recursively flattens array up to depth times.
+ *
+ * @template T - The type of the leaf elements in the array.
+ * @param array - The array to flatten.
+ * @param depth - The maximum recursion depth.
+ * @returns A new flattened array.
+ * @deprecated Use `array.flat(depth)` directly instead.
+ * Reason: Native equivalent method now available
+ * @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
+ * const nested = [1, [2, [3, [4]]]];
+ *
+ * // ❌ Deprecated approach
+ * const flattened = flattenDepth(nested, 2);
+ * console.log(flattened); // [1, 2, 3, [4]]
+ *
+ * // ✅ Recommended approach
+ * const flattenedNative = nested.flat(2);
+ * console.log(flattenedNative); // [1, 2, 3, [4]]
+ * ```
+ */
+export function flattenDepth(array, depth = 1) {
+    return array.flat(depth);
+}
+//# sourceMappingURL=flattenDepth.js.map

package/dist/taphos/array/flattenDepth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"flattenDepth.js","sourceRoot":"","sources":["../../../src/taphos/array/flattenDepth.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,UAAU,YAAY,CAAI,KAAgB,EAAE,QAAgB,CAAC;IACjE,OAAO,KAAK,CAAC,IAAI,CAAC,KAAK,CAAQ,CAAC;AAClC,CAAC"}

package/dist/taphos/array/fromPairs.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Creates an object from an array of key-value pairs.
+ *
+ * @template Key - The type of object keys.
+ * @template Value - The type of object values.
+ * @param pairs - The key-value pairs.
+ * @returns A new object composed from the key-value pairs.
+ * @deprecated Use `Object.fromEntries(pairs)` directly instead.
+ * Reason: Native equivalent method now available
+ * @see {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object/fromEntries | Object.fromEntries() - MDN}
+ * @see {@link https://caniuse.com/mdn-javascript_builtins_object_fromentries | Browser support - Can I Use}
+ * @since 2.0.0
+ *
+ * @example
+ * ```typescript
+ * const pairs: [string, number][] = [['a', 1], ['b', 2], ['c', 3]];
+ *
+ * // ❌ Deprecated approach
+ * const obj = fromPairs(pairs);
+ * console.log(obj); // { a: 1, b: 2, c: 3 }
+ *
+ * // ✅ Recommended approach
+ * const objNative = Object.fromEntries(pairs);
+ * console.log(objNative); // { a: 1, b: 2, c: 3 }
+ * ```
+ */
+export declare function fromPairs<Key extends PropertyKey, Value>(pairs: [Key, Value][]): Record<Key, Value>;
+//# sourceMappingURL=fromPairs.d.ts.map

package/dist/taphos/array/fromPairs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fromPairs.d.ts","sourceRoot":"","sources":["../../../src/taphos/array/fromPairs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,SAAS,CAAC,GAAG,SAAS,WAAW,EAAE,KAAK,EACtD,KAAK,EAAE,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,GACpB,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,CAEpB"}

package/dist/taphos/array/fromPairs.js

@@ -0,0 +1,30 @@
+/**
+ * Creates an object from an array of key-value pairs.
+ *
+ * @template Key - The type of object keys.
+ * @template Value - The type of object values.
+ * @param pairs - The key-value pairs.
+ * @returns A new object composed from the key-value pairs.
+ * @deprecated Use `Object.fromEntries(pairs)` directly instead.
+ * Reason: Native equivalent method now available
+ * @see {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object/fromEntries | Object.fromEntries() - MDN}
+ * @see {@link https://caniuse.com/mdn-javascript_builtins_object_fromentries | Browser support - Can I Use}
+ * @since 2.0.0
+ *
+ * @example
+ * ```typescript
+ * const pairs: [string, number][] = [['a', 1], ['b', 2], ['c', 3]];
+ *
+ * // ❌ Deprecated approach
+ * const obj = fromPairs(pairs);
+ * console.log(obj); // { a: 1, b: 2, c: 3 }
+ *
+ * // ✅ Recommended approach
+ * const objNative = Object.fromEntries(pairs);
+ * console.log(objNative); // { a: 1, b: 2, c: 3 }
+ * ```
+ */
+export function fromPairs(pairs) {
+    return Object.fromEntries(pairs);
+}
+//# sourceMappingURL=fromPairs.js.map

package/dist/taphos/array/fromPairs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fromPairs.js","sourceRoot":"","sources":["../../../src/taphos/array/fromPairs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,UAAU,SAAS,CACvB,KAAqB;IAErB,OAAO,MAAM,CAAC,WAAW,CAAC,KAAK,CAAuB,CAAC;AACzD,CAAC"}

package/dist/taphos/array/head.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Gets the first element of array.
+ *
+ * Alias for {@link first}.
+ *
+ * @template T - The type of elements in the array.
+ * @param array - The array to query.
+ * @returns The first element of the array, or `undefined` if empty.
+ * @deprecated Use `array[0]` or `array.at(0)` directly instead.
+ * Reason: Alias of {@link first}
+ * @see {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/at | Array.at() - MDN}
+ * @see {@link https://caniuse.com/mdn-javascript_builtins_array_at | Browser support - Can I Use}
+ * @since 2.0.0
+ *
+ * @example
+ * ```typescript
+ * const numbers = [1, 2, 3, 4, 5];
+ *
+ * // ❌ Deprecated approach
+ * const firstElement = head(numbers);
+ * console.log(firstElement); // 1
+ *
+ * // ✅ Recommended approach
+ * const firstNative = numbers[0];
+ * console.log(firstNative); // 1
+ *
+ * // ✅ Modern approach with ES2022
+ * const firstModern = numbers.at(0);
+ * console.log(firstModern); // 1
+ * ```
+ */
+export declare function head<T>(array: T[]): T | undefined;
+//# sourceMappingURL=head.d.ts.map

package/dist/taphos/array/head.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"head.d.ts","sourceRoot":"","sources":["../../../src/taphos/array/head.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAgB,IAAI,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,CAAC,GAAG,SAAS,CAEjD"}

package/dist/taphos/array/head.js

@@ -0,0 +1,35 @@
+/**
+ * Gets the first element of array.
+ *
+ * Alias for {@link first}.
+ *
+ * @template T - The type of elements in the array.
+ * @param array - The array to query.
+ * @returns The first element of the array, or `undefined` if empty.
+ * @deprecated Use `array[0]` or `array.at(0)` directly instead.
+ * Reason: Alias of {@link first}
+ * @see {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/at | Array.at() - MDN}
+ * @see {@link https://caniuse.com/mdn-javascript_builtins_array_at | Browser support - Can I Use}
+ * @since 2.0.0
+ *
+ * @example
+ * ```typescript
+ * const numbers = [1, 2, 3, 4, 5];
+ *
+ * // ❌ Deprecated approach
+ * const firstElement = head(numbers);
+ * console.log(firstElement); // 1
+ *
+ * // ✅ Recommended approach
+ * const firstNative = numbers[0];
+ * console.log(firstNative); // 1
+ *
+ * // ✅ Modern approach with ES2022
+ * const firstModern = numbers.at(0);
+ * console.log(firstModern); // 1
+ * ```
+ */
+export function head(array) {
+    return array[0];
+}
+//# sourceMappingURL=head.js.map

package/dist/taphos/array/head.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"head.js","sourceRoot":"","sources":["../../../src/taphos/array/head.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,MAAM,UAAU,IAAI,CAAI,KAAU;IAC9B,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC;AACpB,CAAC"}

package/dist/taphos/array/indexOf.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Gets the index at which the first occurrence of value is found in array.
+ *
+ * @template T - The type of elements in the array.
+ * @param array - The array to search.
+ * @param value - The value to search for.
+ * @param fromIndex - The index to search from.
+ * @returns The index of the matched value, or `-1` if not found.
+ * @deprecated Use `array.indexOf(value)` directly instead.
+ * Reason: Native equivalent method now available
+ * @see {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/indexOf | Array.indexOf() - MDN}
+ * @see {@link https://caniuse.com/mdn-javascript_builtins_array_indexof | Browser support - Can I Use}
+ * @since 2.0.0
+ *
+ * @example
+ * ```typescript
+ * const numbers = [1, 2, 3, 2, 4];
+ *
+ * // ❌ Deprecated approach
+ * const index = indexOf(numbers, 2);
+ * console.log(index); // 1
+ *
+ * // ✅ Recommended approach
+ * const indexNative = numbers.indexOf(2);
+ * console.log(indexNative); // 1
+ * ```
+ */
+export declare function indexOf<T>(array: T[], value: T, fromIndex?: number): number;
+//# sourceMappingURL=indexOf.d.ts.map

package/dist/taphos/array/indexOf.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"indexOf.d.ts","sourceRoot":"","sources":["../../../src/taphos/array/indexOf.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,OAAO,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAE3E"}

package/dist/taphos/array/indexOf.js

@@ -0,0 +1,31 @@
+/**
+ * Gets the index at which the first occurrence of value is found in array.
+ *
+ * @template T - The type of elements in the array.
+ * @param array - The array to search.
+ * @param value - The value to search for.
+ * @param fromIndex - The index to search from.
+ * @returns The index of the matched value, or `-1` if not found.
+ * @deprecated Use `array.indexOf(value)` directly instead.
+ * Reason: Native equivalent method now available
+ * @see {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/indexOf | Array.indexOf() - MDN}
+ * @see {@link https://caniuse.com/mdn-javascript_builtins_array_indexof | Browser support - Can I Use}
+ * @since 2.0.0
+ *
+ * @example
+ * ```typescript
+ * const numbers = [1, 2, 3, 2, 4];
+ *
+ * // ❌ Deprecated approach
+ * const index = indexOf(numbers, 2);
+ * console.log(index); // 1
+ *
+ * // ✅ Recommended approach
+ * const indexNative = numbers.indexOf(2);
+ * console.log(indexNative); // 1
+ * ```
+ */
+export function indexOf(array, value, fromIndex) {
+    return array.indexOf(value, fromIndex);
+}
+//# sourceMappingURL=indexOf.js.map

package/dist/taphos/array/indexOf.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"indexOf.js","sourceRoot":"","sources":["../../../src/taphos/array/indexOf.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,UAAU,OAAO,CAAI,KAAU,EAAE,KAAQ,EAAE,SAAkB;IACjE,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;AACzC,CAAC"}

package/dist/taphos/array/initial.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Gets all but the last element of array.
+ *
+ * @template T - The type of elements in the array.
+ * @param array - The array to query.
+ * @returns A new array with all elements except the last.
+ * @deprecated Use `array.slice(0, -1)` directly instead.
+ * Reason: Native equivalent method now available
+ * @see {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/slice | Array.slice() - MDN}
+ * @see {@link https://caniuse.com/mdn-javascript_builtins_array_slice | Browser support - Can I Use}
+ * @since 2.0.0
+ *
+ * @example
+ * ```typescript
+ * const numbers = [1, 2, 3, 4, 5];
+ *
+ * // ❌ Deprecated approach
+ * const withoutLast = initial(numbers);
+ * console.log(withoutLast); // [1, 2, 3, 4]
+ *
+ * // ✅ Recommended approach
+ * const withoutLastNative = numbers.slice(0, -1);
+ * console.log(withoutLastNative); // [1, 2, 3, 4]
+ * ```
+ */
+export declare function initial<T>(array: T[]): T[];
+//# sourceMappingURL=initial.d.ts.map

package/dist/taphos/array/initial.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"initial.d.ts","sourceRoot":"","sources":["../../../src/taphos/array/initial.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,OAAO,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE,CAE1C"}

package/dist/taphos/array/initial.js

@@ -0,0 +1,29 @@
+/**
+ * Gets all but the last element of array.
+ *
+ * @template T - The type of elements in the array.
+ * @param array - The array to query.
+ * @returns A new array with all elements except the last.
+ * @deprecated Use `array.slice(0, -1)` directly instead.
+ * Reason: Native equivalent method now available
+ * @see {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/slice | Array.slice() - MDN}
+ * @see {@link https://caniuse.com/mdn-javascript_builtins_array_slice | Browser support - Can I Use}
+ * @since 2.0.0
+ *
+ * @example
+ * ```typescript
+ * const numbers = [1, 2, 3, 4, 5];
+ *
+ * // ❌ Deprecated approach
+ * const withoutLast = initial(numbers);
+ * console.log(withoutLast); // [1, 2, 3, 4]
+ *
+ * // ✅ Recommended approach
+ * const withoutLastNative = numbers.slice(0, -1);
+ * console.log(withoutLastNative); // [1, 2, 3, 4]
+ * ```
+ */
+export function initial(array) {
+    return array.slice(0, -1);
+}
+//# sourceMappingURL=initial.js.map

package/dist/taphos/array/initial.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"initial.js","sourceRoot":"","sources":["../../../src/taphos/array/initial.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,UAAU,OAAO,CAAI,KAAU;IACnC,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;AAC5B,CAAC"}