@ts-fns/stdlib 0.1.0

package/dist/tuple/index.cjs

@@ -0,0 +1,135 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_purry = require("../purry-B2_0DGLV.cjs");
+//#region src/tuple/at.ts
+function at2Implementation(tuple, index) {
+	if (index < 0) throw new RangeError(`Tuple.at() :: ${index} must be a positive integer`);
+	if (index >= tuple.length) throw new RangeError(`Tuple.at() :: ${index} is out of bounds`);
+	return tuple[index];
+}
+function at(...args) {
+	return require_purry.purry(at2Implementation, args);
+}
+//#endregion
+//#region src/tuple/fanOut.ts
+function fanOutImplementation(value, fn1, fn2) {
+	return [fn1(value), fn2(value)];
+}
+function fanOut(...args) {
+	return require_purry.purry(fanOutImplementation, args);
+}
+//#endregion
+//#region src/tuple/first.ts
+/**
+* Returns the first element of a tuple with at least one element.
+*
+* @param tuple - A non-empty tuple.
+* @returns The element at index `0`.
+*
+* @example
+* ```ts
+* first([1, 2]); // 1
+* ```
+*
+* @throws {RangeError} When the tuple has fewer than one element.
+*/
+function first(tuple) {
+	if (tuple.length < 1) throw new RangeError("Tuple.first() :: received a tuple with less than 1 element");
+	return tuple[0];
+}
+//#endregion
+//#region src/tuple/insert.ts
+function updateImplementation(tuple, index, value) {
+	return tuple.with(index, value);
+}
+function insert(...args) {
+	return require_purry.purry(updateImplementation, args);
+}
+//#endregion
+//#region src/tuple/mapBoth.ts
+/**
+* Maps both elements of a homogeneous pair with the same function.
+*/
+function mapBothImplementation(tuple, fn) {
+	return [fn(tuple[0]), fn(tuple[1])];
+}
+function mapBoth(...args) {
+	return require_purry.purry(mapBothImplementation, args);
+}
+//#endregion
+//#region src/tuple/mapEach.ts
+function mapEachImplementation(tuple, fnA, fnB) {
+	return [fnA(tuple[0]), fnB(tuple[1])];
+}
+function mapEach(...args) {
+	return require_purry.purry(mapEachImplementation, args);
+}
+//#endregion
+//#region src/tuple/mapFirst.ts
+/**
+* Maps the first element of a pair; leaves the second unchanged.
+*/
+function mapFirstImplementation(tuple, fn) {
+	return [fn(tuple[0]), tuple[1]];
+}
+function mapFirst(...args) {
+	return require_purry.purry(mapFirstImplementation, args);
+}
+//#endregion
+//#region src/tuple/mapSecond.ts
+function mapSecondImplementation(tuple, fn) {
+	return [tuple[0], fn(tuple[1])];
+}
+function mapSecond(...args) {
+	return require_purry.purry(mapSecondImplementation, args);
+}
+//#endregion
+//#region src/tuple/second.ts
+/**
+* Returns the second element of a tuple with at least two elements.
+*
+* @param tuple - A tuple with at least two elements.
+* @returns The element at index `1`.
+*
+* @example
+* ```ts
+* second([1, 2]); // 2
+* ```
+*
+* @throws {RangeError} When the tuple has fewer than two elements.
+*/
+function second(tuple) {
+	if (tuple.length < 2) throw new RangeError("Tuple.second() :: received a tuple with less than 2 elements");
+	return tuple[1];
+}
+//#endregion
+//#region src/tuple/swap.ts
+/**
+* Swaps the two elements of a pair.
+*
+* @param data - A two-element tuple.
+* @returns The tuple with elements reversed.
+*
+* @example
+* ```ts
+* swap([1, 'a']); // ['a', 1]
+* ```
+*/
+function swap(data) {
+	return [data[1], data[0]];
+}
+//#endregion
+exports.at = at;
+exports.fanOut = fanOut;
+exports.fanOutImplementation = fanOutImplementation;
+exports.first = first;
+exports.insert = insert;
+exports.mapBoth = mapBoth;
+exports.mapBothImplementation = mapBothImplementation;
+exports.mapEach = mapEach;
+exports.mapFirst = mapFirst;
+exports.mapFirstImplementation = mapFirstImplementation;
+exports.mapSecond = mapSecond;
+exports.second = second;
+exports.swap = swap;
+
+//# sourceMappingURL=index.cjs.map

package/dist/tuple/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","names":["purry","purry","purry","purry","purry","purry","purry"],"sources":["../../src/tuple/at.ts","../../src/tuple/fanOut.ts","../../src/tuple/first.ts","../../src/tuple/insert.ts","../../src/tuple/mapBoth.ts","../../src/tuple/mapEach.ts","../../src/tuple/mapFirst.ts","../../src/tuple/mapSecond.ts","../../src/tuple/second.ts","../../src/tuple/swap.ts"],"sourcesContent":["import { purry } from '../function/purry';\n\nfunction at2Implementation<T>(tuple: T[], index: number): T {\n  if (index < 0) {\n    throw new RangeError(`Tuple.at() :: ${index} must be a positive integer`);\n  }\n  if (index >= tuple.length) {\n    throw new RangeError(`Tuple.at() :: ${index} is out of bounds`);\n  }\n\n  return tuple[index]!;\n}\n\n/**\n * Get an element from a tuple by index.\n *\n * @param tuple - The tuple to get the element from.\n * @param index - The index of the element to get.\n *\n * @example\n * ```ts\n * at(0, [1, 2, 3]) // 1\n * at(1, [1, 2, 3]) // 2\n * at([1, 2, 3], 0) // 1\n * at([1, 2, 3], 1) // 2\n * ```\n *\n * @throws {RangeError}\n */\nexport function at<T>(index: 0): (tuple: [T, ...unknown[]]) => T;\nexport function at<T>(index: 1): (tuple: [unknown, T, ...unknown[]]) => T;\nexport function at<T>(index: 2): (tuple: [unknown, unknown, T, ...unknown[]]) => T;\nexport function at<T>(index: 3): (tuple: [unknown, unknown, unknown, T, ...unknown[]]) => T;\nexport function at<T>(index: 4): (tuple: [unknown, unknown, unknown, unknown, T, ...unknown[]]) => T;\nexport function at<T>(index: 5): (tuple: [unknown, unknown, unknown, unknown, unknown, T, ...unknown[]]) => T;\nexport function at<T>(index: 6): (tuple: [unknown, unknown, unknown, unknown, unknown, unknown, T, ...unknown[]]) => T;\nexport function at<T>(tuple: [T, ...unknown[]], index: 0): T;\nexport function at<T>(tuple: [unknown, T, ...unknown[]], index: 1): T;\nexport function at<T>(tuple: [unknown, unknown, T, ...unknown[]], index: 2): T;\nexport function at<T>(tuple: [unknown, unknown, unknown, T, ...unknown[]], index: 3): T;\nexport function at<T>(tuple: [unknown, unknown, unknown, unknown, T, ...unknown[]], index: 4): T;\nexport function at<T>(tuple: [unknown, unknown, unknown, unknown, unknown, T, ...unknown[]], index: 5): T;\nexport function at<T>(tuple: [unknown, unknown, unknown, unknown, unknown, unknown, T, ...unknown[]], index: 6): T;\nexport function at(...args: readonly unknown[]): unknown {\n  return purry(at2Implementation, args);\n}\n","import { purry } from '../function/purry';\n\nexport function fanOutImplementation<A, C, D>(value: A, fn1: (value: A) => C, fn2: (value: A) => D): [C, D] {\n  return [fn1(value), fn2(value)];\n}\n\n/**\n * Takes a value and two functions and returns a tuple of the results of the functions.\n *\n * @public\n * @category Tuple\n * @param value - The value to apply the functions to.\n * @param fn1 - The first function to apply to the value.\n * @param fn2 - The second function to apply to the value.\n *\n * @example\n * ```ts\n * fanOut((x) => x * 2, (x) => x + 1, 2); // [4, 3]\n * ```\n */\nexport function fanOut<A, C, D>(fn1: (value: A) => C, fn2: (value: A) => D): (value: A) => [C, D];\nexport function fanOut<A, C, D>(value: A, fn1: (value: A) => C, fn2: (value: A) => D): [C, D];\nexport function fanOut(...args: readonly unknown[]): unknown {\n  return purry(fanOutImplementation, args);\n}\n","/**\n * Returns the first element of a tuple with at least one element.\n *\n * @param tuple - A non-empty tuple.\n * @returns The element at index `0`.\n *\n * @example\n * ```ts\n * first([1, 2]); // 1\n * ```\n *\n * @throws {RangeError} When the tuple has fewer than one element.\n */\nexport function first<T>(tuple: [T, ...unknown[]]): T {\n  if (tuple.length < 1) {\n    throw new RangeError('Tuple.first() :: received a tuple with less than 1 element');\n  }\n  return tuple[0];\n}\n","/* eslint-disable @typescript-eslint/unified-signatures */\nimport { purry } from '../function/purry';\n\nfunction updateImplementation<T>(tuple: T[], index: number, value: T): T[] {\n  return tuple.with(index, value);\n}\n\n/**\n * Returns a new tuple with the element at `index` replaced by `value`.\n *\n * @param index - Zero-based index of the element to replace.\n * @param value - Replacement value.\n * @param tuple - The source tuple.\n *\n * @example\n * ```ts\n * insert([1, 2, 3], 1, 99); // [1, 99, 3]\n * insert(1, 99)([1, 2, 3]); // [1, 99, 3]\n * ```\n *\n * @throws {RangeError} When `index` is negative or out of bounds (from the underlying `with` call).\n */\nexport function insert<T>(index: 0, value: T): <U extends readonly [T, ...unknown[]]>(tuple: U) => U;\nexport function insert<T>(index: 1, value: T): <U extends readonly [unknown, T, ...unknown[]]>(tuple: U) => U;\nexport function insert<T>(index: 2, value: T): <U extends readonly [unknown, unknown, T, ...unknown[]]>(tuple: U) => U;\nexport function insert<T>(\n  index: 3,\n  value: T,\n): <U extends readonly [unknown, unknown, unknown, T, ...unknown[]]>(tuple: U) => U;\nexport function insert<T>(\n  index: 4,\n  value: T,\n): <U extends readonly [unknown, unknown, unknown, unknown, T, ...unknown[]]>(tuple: U) => U;\nexport function insert<T>(\n  index: 5,\n  value: T,\n): <U extends readonly [unknown, unknown, unknown, unknown, unknown, T, ...unknown[]]>(tuple: U) => U;\nexport function insert<T>(\n  index: 6,\n  value: T,\n): <U extends readonly [unknown, unknown, unknown, unknown, unknown, unknown, T, ...unknown[]]>(tuple: U) => U;\nexport function insert<T>(\n  index: 7,\n  value: T,\n): <U extends readonly [unknown, unknown, unknown, unknown, unknown, unknown, unknown, T, ...unknown[]]>(tuple: U) => U;\nexport function insert<T>(\n  index: 8,\n  value: T,\n): <U extends readonly [unknown, unknown, unknown, unknown, unknown, unknown, unknown, unknown, T, ...unknown[]]>(\n  tuple: U,\n) => U;\nexport function insert<T, U extends readonly [T, ...unknown[]]>(tuple: U, index: 0, value: T): U;\nexport function insert<T, U extends readonly [unknown, T, ...unknown[]]>(tuple: U, index: 1, value: T): U;\nexport function insert<T, U extends readonly [unknown, unknown, T, ...unknown[]]>(tuple: U, index: 2, value: T): U;\nexport function insert<T, U extends readonly [unknown, unknown, unknown, T, ...unknown[]]>(\n  tuple: U,\n  index: 3,\n  value: T,\n): U;\nexport function insert<T, U extends readonly [unknown, unknown, unknown, unknown, T, ...unknown[]]>(\n  tuple: U,\n  index: 4,\n  value: T,\n): U;\nexport function insert<T, U extends readonly [unknown, unknown, unknown, unknown, unknown, T, ...unknown[]]>(\n  tuple: U,\n  index: 5,\n  value: T,\n): U;\nexport function insert<T, U extends readonly [unknown, unknown, unknown, unknown, unknown, unknown, T, ...unknown[]]>(\n  tuple: U,\n  index: 6,\n  value: T,\n): U;\nexport function insert<\n  T,\n  U extends readonly [unknown, unknown, unknown, unknown, unknown, unknown, unknown, T, ...unknown[]],\n>(tuple: U, index: 7, value: T): U;\nexport function insert<\n  T,\n  U extends readonly [unknown, unknown, unknown, unknown, unknown, unknown, unknown, unknown, T, ...unknown[]],\n>(tuple: U, index: 8, value: T): U;\nexport function insert(...args: readonly unknown[]): unknown {\n  return purry(updateImplementation, args);\n}\n","import { purry } from '../function/purry';\n\n/**\n * Maps both elements of a homogeneous pair with the same function.\n */\nexport function mapBothImplementation<T, U>(tuple: [T, T], fn: (value: T) => U): [U, U] {\n  return [fn(tuple[0]), fn(tuple[1])];\n}\n\n/**\n * Maps both elements of a homogeneous pair with the same function.\n *\n * @param fn - Function applied to each element\n * @param tuple - A two-element tuple of the same type\n *\n * @example\n * ```ts\n * mapBoth([1, 2], (n) => n * 2); // [2, 4]\n * mapBoth((n) => n * 2)([1, 2]); // [2, 4]\n * ```\n */\nexport function mapBoth<T, U>(fn: (value: T) => U): (tuple: [T, T]) => [U, U];\nexport function mapBoth<T, U>(tuple: [T, T], fn: (value: T) => U): [U, U];\nexport function mapBoth(...args: readonly unknown[]): unknown {\n  return purry(mapBothImplementation, args);\n}\n","import { purry } from '../function/purry';\n\nfunction mapEachImplementation<A, B, X, Y>(tuple: [A, B], fnA: (value: A) => X, fnB: (value: B) => Y): [X, Y] {\n  return [fnA(tuple[0]), fnB(tuple[1])];\n}\n\n/**\n * Maps the first and second elements of a pair with two functions.\n *\n * @param fnA - Function applied to the first element\n * @param fnB - Function applied to the second element\n * @param tuple - A two-element tuple\n *\n * @example\n * ```ts\n * mapEach([1, 'a'], String, (s) => s.toUpperCase()); // ['1', 'A']\n * mapEach(String, (s) => s.toUpperCase())([1, 'a']); // ['1', 'A']\n * ```\n */\nexport function mapEach<A, B, X, Y>(fnA: (value: A) => X, fnB: (value: B) => Y): (tuple: [A, B]) => [X, Y];\nexport function mapEach<A, B, X, Y>(tuple: [A, B], fnA: (value: A) => X, fnB: (value: B) => Y): [X, Y];\nexport function mapEach(...args: readonly unknown[]): unknown {\n  return purry(mapEachImplementation, args);\n}\n","import { purry } from '../function/purry';\n\n/**\n * Maps the first element of a pair; leaves the second unchanged.\n */\nexport function mapFirstImplementation<A, B, X>(tuple: [A, B], fn: (value: A) => X): [X, B] {\n  return [fn(tuple[0]), tuple[1]];\n}\n\n/**\n * Maps the first element of a pair; leaves the second unchanged.\n *\n * @param fn - Function applied to the first element\n * @param tuple - A two-element tuple\n *\n * @example\n * ```ts\n * mapFirst([1, 'a'], (n) => n + 1); // [2, 'a']\n * mapFirst((n) => n + 1)([1, 'a']); // [2, 'a']\n * ```\n */\nexport function mapFirst<A, B, X>(fn: (value: A) => X): (tuple: [A, B]) => [X, B];\nexport function mapFirst<A, B, X>(tuple: [A, B], fn: (value: A) => X): [X, B];\nexport function mapFirst(...args: readonly unknown[]): unknown {\n  return purry(mapFirstImplementation, args);\n}\n","import { purry } from '../function/purry';\n\nfunction mapSecondImplementation<A, B, Y>(tuple: [A, B], fn: (value: B) => Y): [A, Y] {\n  return [tuple[0], fn(tuple[1])];\n}\n\n/**\n * Maps the second element of a pair; leaves the first unchanged.\n *\n * @param fn - Function applied to the second element\n * @param tuple - A two-element tuple (data-first overload).\n *\n * @example\n * ```ts\n * mapSecond([1, 'a'], (s) => s.toUpperCase()); // [1, 'A']\n * mapSecond((s) => s.toUpperCase())([1, 'a']); // [1, 'A']\n * ```\n */\nexport function mapSecond<A, B, Y>(fn: (value: B) => Y): (tuple: [A, B]) => [A, Y];\nexport function mapSecond<A, B, Y>(tuple: [A, B], fn: (value: B) => Y): [A, Y];\nexport function mapSecond(...args: readonly unknown[]): unknown {\n  return purry(mapSecondImplementation, args);\n}\n","/**\n * Returns the second element of a tuple with at least two elements.\n *\n * @param tuple - A tuple with at least two elements.\n * @returns The element at index `1`.\n *\n * @example\n * ```ts\n * second([1, 2]); // 2\n * ```\n *\n * @throws {RangeError} When the tuple has fewer than two elements.\n */\nexport function second<T>(tuple: [unknown, T, ...unknown[]]): T {\n  if (tuple.length < 2) {\n    throw new RangeError('Tuple.second() :: received a tuple with less than 2 elements');\n  }\n  return tuple[1];\n}\n","/**\n * Swaps the two elements of a pair.\n *\n * @param data - A two-element tuple.\n * @returns The tuple with elements reversed.\n *\n * @example\n * ```ts\n * swap([1, 'a']); // ['a', 1]\n * ```\n */\nexport function swap<A, B>(data: [A, B]): [B, A] {\n  return [data[1], data[0]];\n}\n"],"mappings":";;;AAEA,SAAS,kBAAqB,OAAY,OAAkB;CAC1D,IAAI,QAAQ,GACV,MAAM,IAAI,WAAW,iBAAiB,MAAM,4BAA4B;CAE1E,IAAI,SAAS,MAAM,QACjB,MAAM,IAAI,WAAW,iBAAiB,MAAM,kBAAkB;CAGhE,OAAO,MAAM;AACf;AAgCA,SAAgB,GAAG,GAAG,MAAmC;CACvD,OAAOA,cAAAA,MAAM,mBAAmB,IAAI;AACtC;;;AC3CA,SAAgB,qBAA8B,OAAU,KAAsB,KAA8B;CAC1G,OAAO,CAAC,IAAI,KAAK,GAAG,IAAI,KAAK,CAAC;AAChC;AAkBA,SAAgB,OAAO,GAAG,MAAmC;CAC3D,OAAOC,cAAAA,MAAM,sBAAsB,IAAI;AACzC;;;;;;;;;;;;;;;;ACXA,SAAgB,MAAS,OAA6B;CACpD,IAAI,MAAM,SAAS,GACjB,MAAM,IAAI,WAAW,4DAA4D;CAEnF,OAAO,MAAM;AACf;;;ACfA,SAAS,qBAAwB,OAAY,OAAe,OAAe;CACzE,OAAO,MAAM,KAAK,OAAO,KAAK;AAChC;AA6EA,SAAgB,OAAO,GAAG,MAAmC;CAC3D,OAAOC,cAAAA,MAAM,sBAAsB,IAAI;AACzC;;;;;;AC/EA,SAAgB,sBAA4B,OAAe,IAA6B;CACtF,OAAO,CAAC,GAAG,MAAM,EAAE,GAAG,GAAG,MAAM,EAAE,CAAC;AACpC;AAgBA,SAAgB,QAAQ,GAAG,MAAmC;CAC5D,OAAOC,cAAAA,MAAM,uBAAuB,IAAI;AAC1C;;;ACvBA,SAAS,sBAAkC,OAAe,KAAsB,KAA8B;CAC5G,OAAO,CAAC,IAAI,MAAM,EAAE,GAAG,IAAI,MAAM,EAAE,CAAC;AACtC;AAiBA,SAAgB,QAAQ,GAAG,MAAmC;CAC5D,OAAOC,cAAAA,MAAM,uBAAuB,IAAI;AAC1C;;;;;;AClBA,SAAgB,uBAAgC,OAAe,IAA6B;CAC1F,OAAO,CAAC,GAAG,MAAM,EAAE,GAAG,MAAM,EAAE;AAChC;AAgBA,SAAgB,SAAS,GAAG,MAAmC;CAC7D,OAAOC,cAAAA,MAAM,wBAAwB,IAAI;AAC3C;;;ACvBA,SAAS,wBAAiC,OAAe,IAA6B;CACpF,OAAO,CAAC,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC;AAChC;AAgBA,SAAgB,UAAU,GAAG,MAAmC;CAC9D,OAAOC,cAAAA,MAAM,yBAAyB,IAAI;AAC5C;;;;;;;;;;;;;;;;ACTA,SAAgB,OAAU,OAAsC;CAC9D,IAAI,MAAM,SAAS,GACjB,MAAM,IAAI,WAAW,8DAA8D;CAErF,OAAO,MAAM;AACf;;;;;;;;;;;;;;ACPA,SAAgB,KAAW,MAAsB;CAC/C,OAAO,CAAC,KAAK,IAAI,KAAK,EAAE;AAC1B"}

package/dist/tuple/index.d.cts

@@ -0,0 +1,207 @@
+//#region src/tuple/at.d.ts
+/**
+ * Get an element from a tuple by index.
+ *
+ * @param tuple - The tuple to get the element from.
+ * @param index - The index of the element to get.
+ *
+ * @example
+ * ```ts
+ * at(0, [1, 2, 3]) // 1
+ * at(1, [1, 2, 3]) // 2
+ * at([1, 2, 3], 0) // 1
+ * at([1, 2, 3], 1) // 2
+ * ```
+ *
+ * @throws {RangeError}
+ */
+declare function at<T>(index: 0): (tuple: [T, ...unknown[]]) => T;
+declare function at<T>(index: 1): (tuple: [unknown, T, ...unknown[]]) => T;
+declare function at<T>(index: 2): (tuple: [unknown, unknown, T, ...unknown[]]) => T;
+declare function at<T>(index: 3): (tuple: [unknown, unknown, unknown, T, ...unknown[]]) => T;
+declare function at<T>(index: 4): (tuple: [unknown, unknown, unknown, unknown, T, ...unknown[]]) => T;
+declare function at<T>(index: 5): (tuple: [unknown, unknown, unknown, unknown, unknown, T, ...unknown[]]) => T;
+declare function at<T>(index: 6): (tuple: [unknown, unknown, unknown, unknown, unknown, unknown, T, ...unknown[]]) => T;
+declare function at<T>(tuple: [T, ...unknown[]], index: 0): T;
+declare function at<T>(tuple: [unknown, T, ...unknown[]], index: 1): T;
+declare function at<T>(tuple: [unknown, unknown, T, ...unknown[]], index: 2): T;
+declare function at<T>(tuple: [unknown, unknown, unknown, T, ...unknown[]], index: 3): T;
+declare function at<T>(tuple: [unknown, unknown, unknown, unknown, T, ...unknown[]], index: 4): T;
+declare function at<T>(tuple: [unknown, unknown, unknown, unknown, unknown, T, ...unknown[]], index: 5): T;
+declare function at<T>(tuple: [unknown, unknown, unknown, unknown, unknown, unknown, T, ...unknown[]], index: 6): T;
+//#endregion
+//#region src/tuple/fanOut.d.ts
+declare function fanOutImplementation<A, C, D>(value: A, fn1: (value: A) => C, fn2: (value: A) => D): [C, D];
+/**
+ * Takes a value and two functions and returns a tuple of the results of the functions.
+ *
+ * @public
+ * @category Tuple
+ * @param value - The value to apply the functions to.
+ * @param fn1 - The first function to apply to the value.
+ * @param fn2 - The second function to apply to the value.
+ *
+ * @example
+ * ```ts
+ * fanOut((x) => x * 2, (x) => x + 1, 2); // [4, 3]
+ * ```
+ */
+declare function fanOut<A, C, D>(fn1: (value: A) => C, fn2: (value: A) => D): (value: A) => [C, D];
+declare function fanOut<A, C, D>(value: A, fn1: (value: A) => C, fn2: (value: A) => D): [C, D];
+//#endregion
+//#region src/tuple/first.d.ts
+/**
+ * Returns the first element of a tuple with at least one element.
+ *
+ * @param tuple - A non-empty tuple.
+ * @returns The element at index `0`.
+ *
+ * @example
+ * ```ts
+ * first([1, 2]); // 1
+ * ```
+ *
+ * @throws {RangeError} When the tuple has fewer than one element.
+ */
+declare function first<T>(tuple: [T, ...unknown[]]): T;
+//#endregion
+//#region src/tuple/insert.d.ts
+/**
+ * Returns a new tuple with the element at `index` replaced by `value`.
+ *
+ * @param index - Zero-based index of the element to replace.
+ * @param value - Replacement value.
+ * @param tuple - The source tuple.
+ *
+ * @example
+ * ```ts
+ * insert([1, 2, 3], 1, 99); // [1, 99, 3]
+ * insert(1, 99)([1, 2, 3]); // [1, 99, 3]
+ * ```
+ *
+ * @throws {RangeError} When `index` is negative or out of bounds (from the underlying `with` call).
+ */
+declare function insert<T>(index: 0, value: T): <U extends readonly [T, ...unknown[]]>(tuple: U) => U;
+declare function insert<T>(index: 1, value: T): <U extends readonly [unknown, T, ...unknown[]]>(tuple: U) => U;
+declare function insert<T>(index: 2, value: T): <U extends readonly [unknown, unknown, T, ...unknown[]]>(tuple: U) => U;
+declare function insert<T>(index: 3, value: T): <U extends readonly [unknown, unknown, unknown, T, ...unknown[]]>(tuple: U) => U;
+declare function insert<T>(index: 4, value: T): <U extends readonly [unknown, unknown, unknown, unknown, T, ...unknown[]]>(tuple: U) => U;
+declare function insert<T>(index: 5, value: T): <U extends readonly [unknown, unknown, unknown, unknown, unknown, T, ...unknown[]]>(tuple: U) => U;
+declare function insert<T>(index: 6, value: T): <U extends readonly [unknown, unknown, unknown, unknown, unknown, unknown, T, ...unknown[]]>(tuple: U) => U;
+declare function insert<T>(index: 7, value: T): <U extends readonly [unknown, unknown, unknown, unknown, unknown, unknown, unknown, T, ...unknown[]]>(tuple: U) => U;
+declare function insert<T>(index: 8, value: T): <U extends readonly [unknown, unknown, unknown, unknown, unknown, unknown, unknown, unknown, T, ...unknown[]]>(tuple: U) => U;
+declare function insert<T, U extends readonly [T, ...unknown[]]>(tuple: U, index: 0, value: T): U;
+declare function insert<T, U extends readonly [unknown, T, ...unknown[]]>(tuple: U, index: 1, value: T): U;
+declare function insert<T, U extends readonly [unknown, unknown, T, ...unknown[]]>(tuple: U, index: 2, value: T): U;
+declare function insert<T, U extends readonly [unknown, unknown, unknown, T, ...unknown[]]>(tuple: U, index: 3, value: T): U;
+declare function insert<T, U extends readonly [unknown, unknown, unknown, unknown, T, ...unknown[]]>(tuple: U, index: 4, value: T): U;
+declare function insert<T, U extends readonly [unknown, unknown, unknown, unknown, unknown, T, ...unknown[]]>(tuple: U, index: 5, value: T): U;
+declare function insert<T, U extends readonly [unknown, unknown, unknown, unknown, unknown, unknown, T, ...unknown[]]>(tuple: U, index: 6, value: T): U;
+declare function insert<T, U extends readonly [unknown, unknown, unknown, unknown, unknown, unknown, unknown, T, ...unknown[]]>(tuple: U, index: 7, value: T): U;
+declare function insert<T, U extends readonly [unknown, unknown, unknown, unknown, unknown, unknown, unknown, unknown, T, ...unknown[]]>(tuple: U, index: 8, value: T): U;
+//#endregion
+//#region src/tuple/mapBoth.d.ts
+/**
+ * Maps both elements of a homogeneous pair with the same function.
+ */
+declare function mapBothImplementation<T, U>(tuple: [T, T], fn: (value: T) => U): [U, U];
+/**
+ * Maps both elements of a homogeneous pair with the same function.
+ *
+ * @param fn - Function applied to each element
+ * @param tuple - A two-element tuple of the same type
+ *
+ * @example
+ * ```ts
+ * mapBoth([1, 2], (n) => n * 2); // [2, 4]
+ * mapBoth((n) => n * 2)([1, 2]); // [2, 4]
+ * ```
+ */
+declare function mapBoth<T, U>(fn: (value: T) => U): (tuple: [T, T]) => [U, U];
+declare function mapBoth<T, U>(tuple: [T, T], fn: (value: T) => U): [U, U];
+//#endregion
+//#region src/tuple/mapEach.d.ts
+/**
+ * Maps the first and second elements of a pair with two functions.
+ *
+ * @param fnA - Function applied to the first element
+ * @param fnB - Function applied to the second element
+ * @param tuple - A two-element tuple
+ *
+ * @example
+ * ```ts
+ * mapEach([1, 'a'], String, (s) => s.toUpperCase()); // ['1', 'A']
+ * mapEach(String, (s) => s.toUpperCase())([1, 'a']); // ['1', 'A']
+ * ```
+ */
+declare function mapEach<A, B, X, Y>(fnA: (value: A) => X, fnB: (value: B) => Y): (tuple: [A, B]) => [X, Y];
+declare function mapEach<A, B, X, Y>(tuple: [A, B], fnA: (value: A) => X, fnB: (value: B) => Y): [X, Y];
+//#endregion
+//#region src/tuple/mapFirst.d.ts
+/**
+ * Maps the first element of a pair; leaves the second unchanged.
+ */
+declare function mapFirstImplementation<A, B, X>(tuple: [A, B], fn: (value: A) => X): [X, B];
+/**
+ * Maps the first element of a pair; leaves the second unchanged.
+ *
+ * @param fn - Function applied to the first element
+ * @param tuple - A two-element tuple
+ *
+ * @example
+ * ```ts
+ * mapFirst([1, 'a'], (n) => n + 1); // [2, 'a']
+ * mapFirst((n) => n + 1)([1, 'a']); // [2, 'a']
+ * ```
+ */
+declare function mapFirst<A, B, X>(fn: (value: A) => X): (tuple: [A, B]) => [X, B];
+declare function mapFirst<A, B, X>(tuple: [A, B], fn: (value: A) => X): [X, B];
+//#endregion
+//#region src/tuple/mapSecond.d.ts
+/**
+ * Maps the second element of a pair; leaves the first unchanged.
+ *
+ * @param fn - Function applied to the second element
+ * @param tuple - A two-element tuple (data-first overload).
+ *
+ * @example
+ * ```ts
+ * mapSecond([1, 'a'], (s) => s.toUpperCase()); // [1, 'A']
+ * mapSecond((s) => s.toUpperCase())([1, 'a']); // [1, 'A']
+ * ```
+ */
+declare function mapSecond<A, B, Y>(fn: (value: B) => Y): (tuple: [A, B]) => [A, Y];
+declare function mapSecond<A, B, Y>(tuple: [A, B], fn: (value: B) => Y): [A, Y];
+//#endregion
+//#region src/tuple/second.d.ts
+/**
+ * Returns the second element of a tuple with at least two elements.
+ *
+ * @param tuple - A tuple with at least two elements.
+ * @returns The element at index `1`.
+ *
+ * @example
+ * ```ts
+ * second([1, 2]); // 2
+ * ```
+ *
+ * @throws {RangeError} When the tuple has fewer than two elements.
+ */
+declare function second<T>(tuple: [unknown, T, ...unknown[]]): T;
+//#endregion
+//#region src/tuple/swap.d.ts
+/**
+ * Swaps the two elements of a pair.
+ *
+ * @param data - A two-element tuple.
+ * @returns The tuple with elements reversed.
+ *
+ * @example
+ * ```ts
+ * swap([1, 'a']); // ['a', 1]
+ * ```
+ */
+declare function swap<A, B>(data: [A, B]): [B, A];
+//#endregion
+export { at, fanOut, fanOutImplementation, first, insert, mapBoth, mapBothImplementation, mapEach, mapFirst, mapFirstImplementation, mapSecond, second, swap };
+//# sourceMappingURL=index.d.cts.map

package/dist/tuple/index.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.cts","names":[],"sources":["../../src/tuple/at.ts","../../src/tuple/fanOut.ts","../../src/tuple/first.ts","../../src/tuple/insert.ts","../../src/tuple/mapBoth.ts","../../src/tuple/mapEach.ts","../../src/tuple/mapFirst.ts","../../src/tuple/mapSecond.ts","../../src/tuple/second.ts","../../src/tuple/swap.ts"],"mappings":"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"}

package/dist/tuple/index.d.mts

@@ -0,0 +1,207 @@
+//#region src/tuple/at.d.ts
+/**
+ * Get an element from a tuple by index.
+ *
+ * @param tuple - The tuple to get the element from.
+ * @param index - The index of the element to get.
+ *
+ * @example
+ * ```ts
+ * at(0, [1, 2, 3]) // 1
+ * at(1, [1, 2, 3]) // 2
+ * at([1, 2, 3], 0) // 1
+ * at([1, 2, 3], 1) // 2
+ * ```
+ *
+ * @throws {RangeError}
+ */
+declare function at<T>(index: 0): (tuple: [T, ...unknown[]]) => T;
+declare function at<T>(index: 1): (tuple: [unknown, T, ...unknown[]]) => T;
+declare function at<T>(index: 2): (tuple: [unknown, unknown, T, ...unknown[]]) => T;
+declare function at<T>(index: 3): (tuple: [unknown, unknown, unknown, T, ...unknown[]]) => T;
+declare function at<T>(index: 4): (tuple: [unknown, unknown, unknown, unknown, T, ...unknown[]]) => T;
+declare function at<T>(index: 5): (tuple: [unknown, unknown, unknown, unknown, unknown, T, ...unknown[]]) => T;
+declare function at<T>(index: 6): (tuple: [unknown, unknown, unknown, unknown, unknown, unknown, T, ...unknown[]]) => T;
+declare function at<T>(tuple: [T, ...unknown[]], index: 0): T;
+declare function at<T>(tuple: [unknown, T, ...unknown[]], index: 1): T;
+declare function at<T>(tuple: [unknown, unknown, T, ...unknown[]], index: 2): T;
+declare function at<T>(tuple: [unknown, unknown, unknown, T, ...unknown[]], index: 3): T;
+declare function at<T>(tuple: [unknown, unknown, unknown, unknown, T, ...unknown[]], index: 4): T;
+declare function at<T>(tuple: [unknown, unknown, unknown, unknown, unknown, T, ...unknown[]], index: 5): T;
+declare function at<T>(tuple: [unknown, unknown, unknown, unknown, unknown, unknown, T, ...unknown[]], index: 6): T;
+//#endregion
+//#region src/tuple/fanOut.d.ts
+declare function fanOutImplementation<A, C, D>(value: A, fn1: (value: A) => C, fn2: (value: A) => D): [C, D];
+/**
+ * Takes a value and two functions and returns a tuple of the results of the functions.
+ *
+ * @public
+ * @category Tuple
+ * @param value - The value to apply the functions to.
+ * @param fn1 - The first function to apply to the value.
+ * @param fn2 - The second function to apply to the value.
+ *
+ * @example
+ * ```ts
+ * fanOut((x) => x * 2, (x) => x + 1, 2); // [4, 3]
+ * ```
+ */
+declare function fanOut<A, C, D>(fn1: (value: A) => C, fn2: (value: A) => D): (value: A) => [C, D];
+declare function fanOut<A, C, D>(value: A, fn1: (value: A) => C, fn2: (value: A) => D): [C, D];
+//#endregion
+//#region src/tuple/first.d.ts
+/**
+ * Returns the first element of a tuple with at least one element.
+ *
+ * @param tuple - A non-empty tuple.
+ * @returns The element at index `0`.
+ *
+ * @example
+ * ```ts
+ * first([1, 2]); // 1
+ * ```
+ *
+ * @throws {RangeError} When the tuple has fewer than one element.
+ */
+declare function first<T>(tuple: [T, ...unknown[]]): T;
+//#endregion
+//#region src/tuple/insert.d.ts
+/**
+ * Returns a new tuple with the element at `index` replaced by `value`.
+ *
+ * @param index - Zero-based index of the element to replace.
+ * @param value - Replacement value.
+ * @param tuple - The source tuple.
+ *
+ * @example
+ * ```ts
+ * insert([1, 2, 3], 1, 99); // [1, 99, 3]
+ * insert(1, 99)([1, 2, 3]); // [1, 99, 3]
+ * ```
+ *
+ * @throws {RangeError} When `index` is negative or out of bounds (from the underlying `with` call).
+ */
+declare function insert<T>(index: 0, value: T): <U extends readonly [T, ...unknown[]]>(tuple: U) => U;
+declare function insert<T>(index: 1, value: T): <U extends readonly [unknown, T, ...unknown[]]>(tuple: U) => U;
+declare function insert<T>(index: 2, value: T): <U extends readonly [unknown, unknown, T, ...unknown[]]>(tuple: U) => U;
+declare function insert<T>(index: 3, value: T): <U extends readonly [unknown, unknown, unknown, T, ...unknown[]]>(tuple: U) => U;
+declare function insert<T>(index: 4, value: T): <U extends readonly [unknown, unknown, unknown, unknown, T, ...unknown[]]>(tuple: U) => U;
+declare function insert<T>(index: 5, value: T): <U extends readonly [unknown, unknown, unknown, unknown, unknown, T, ...unknown[]]>(tuple: U) => U;
+declare function insert<T>(index: 6, value: T): <U extends readonly [unknown, unknown, unknown, unknown, unknown, unknown, T, ...unknown[]]>(tuple: U) => U;
+declare function insert<T>(index: 7, value: T): <U extends readonly [unknown, unknown, unknown, unknown, unknown, unknown, unknown, T, ...unknown[]]>(tuple: U) => U;
+declare function insert<T>(index: 8, value: T): <U extends readonly [unknown, unknown, unknown, unknown, unknown, unknown, unknown, unknown, T, ...unknown[]]>(tuple: U) => U;
+declare function insert<T, U extends readonly [T, ...unknown[]]>(tuple: U, index: 0, value: T): U;
+declare function insert<T, U extends readonly [unknown, T, ...unknown[]]>(tuple: U, index: 1, value: T): U;
+declare function insert<T, U extends readonly [unknown, unknown, T, ...unknown[]]>(tuple: U, index: 2, value: T): U;
+declare function insert<T, U extends readonly [unknown, unknown, unknown, T, ...unknown[]]>(tuple: U, index: 3, value: T): U;
+declare function insert<T, U extends readonly [unknown, unknown, unknown, unknown, T, ...unknown[]]>(tuple: U, index: 4, value: T): U;
+declare function insert<T, U extends readonly [unknown, unknown, unknown, unknown, unknown, T, ...unknown[]]>(tuple: U, index: 5, value: T): U;
+declare function insert<T, U extends readonly [unknown, unknown, unknown, unknown, unknown, unknown, T, ...unknown[]]>(tuple: U, index: 6, value: T): U;
+declare function insert<T, U extends readonly [unknown, unknown, unknown, unknown, unknown, unknown, unknown, T, ...unknown[]]>(tuple: U, index: 7, value: T): U;
+declare function insert<T, U extends readonly [unknown, unknown, unknown, unknown, unknown, unknown, unknown, unknown, T, ...unknown[]]>(tuple: U, index: 8, value: T): U;
+//#endregion
+//#region src/tuple/mapBoth.d.ts
+/**
+ * Maps both elements of a homogeneous pair with the same function.
+ */
+declare function mapBothImplementation<T, U>(tuple: [T, T], fn: (value: T) => U): [U, U];
+/**
+ * Maps both elements of a homogeneous pair with the same function.
+ *
+ * @param fn - Function applied to each element
+ * @param tuple - A two-element tuple of the same type
+ *
+ * @example
+ * ```ts
+ * mapBoth([1, 2], (n) => n * 2); // [2, 4]
+ * mapBoth((n) => n * 2)([1, 2]); // [2, 4]
+ * ```
+ */
+declare function mapBoth<T, U>(fn: (value: T) => U): (tuple: [T, T]) => [U, U];
+declare function mapBoth<T, U>(tuple: [T, T], fn: (value: T) => U): [U, U];
+//#endregion
+//#region src/tuple/mapEach.d.ts
+/**
+ * Maps the first and second elements of a pair with two functions.
+ *
+ * @param fnA - Function applied to the first element
+ * @param fnB - Function applied to the second element
+ * @param tuple - A two-element tuple
+ *
+ * @example
+ * ```ts
+ * mapEach([1, 'a'], String, (s) => s.toUpperCase()); // ['1', 'A']
+ * mapEach(String, (s) => s.toUpperCase())([1, 'a']); // ['1', 'A']
+ * ```
+ */
+declare function mapEach<A, B, X, Y>(fnA: (value: A) => X, fnB: (value: B) => Y): (tuple: [A, B]) => [X, Y];
+declare function mapEach<A, B, X, Y>(tuple: [A, B], fnA: (value: A) => X, fnB: (value: B) => Y): [X, Y];
+//#endregion
+//#region src/tuple/mapFirst.d.ts
+/**
+ * Maps the first element of a pair; leaves the second unchanged.
+ */
+declare function mapFirstImplementation<A, B, X>(tuple: [A, B], fn: (value: A) => X): [X, B];
+/**
+ * Maps the first element of a pair; leaves the second unchanged.
+ *
+ * @param fn - Function applied to the first element
+ * @param tuple - A two-element tuple
+ *
+ * @example
+ * ```ts
+ * mapFirst([1, 'a'], (n) => n + 1); // [2, 'a']
+ * mapFirst((n) => n + 1)([1, 'a']); // [2, 'a']
+ * ```
+ */
+declare function mapFirst<A, B, X>(fn: (value: A) => X): (tuple: [A, B]) => [X, B];
+declare function mapFirst<A, B, X>(tuple: [A, B], fn: (value: A) => X): [X, B];
+//#endregion
+//#region src/tuple/mapSecond.d.ts
+/**
+ * Maps the second element of a pair; leaves the first unchanged.
+ *
+ * @param fn - Function applied to the second element
+ * @param tuple - A two-element tuple (data-first overload).
+ *
+ * @example
+ * ```ts
+ * mapSecond([1, 'a'], (s) => s.toUpperCase()); // [1, 'A']
+ * mapSecond((s) => s.toUpperCase())([1, 'a']); // [1, 'A']
+ * ```
+ */
+declare function mapSecond<A, B, Y>(fn: (value: B) => Y): (tuple: [A, B]) => [A, Y];
+declare function mapSecond<A, B, Y>(tuple: [A, B], fn: (value: B) => Y): [A, Y];
+//#endregion
+//#region src/tuple/second.d.ts
+/**
+ * Returns the second element of a tuple with at least two elements.
+ *
+ * @param tuple - A tuple with at least two elements.
+ * @returns The element at index `1`.
+ *
+ * @example
+ * ```ts
+ * second([1, 2]); // 2
+ * ```
+ *
+ * @throws {RangeError} When the tuple has fewer than two elements.
+ */
+declare function second<T>(tuple: [unknown, T, ...unknown[]]): T;
+//#endregion
+//#region src/tuple/swap.d.ts
+/**
+ * Swaps the two elements of a pair.
+ *
+ * @param data - A two-element tuple.
+ * @returns The tuple with elements reversed.
+ *
+ * @example
+ * ```ts
+ * swap([1, 'a']); // ['a', 1]
+ * ```
+ */
+declare function swap<A, B>(data: [A, B]): [B, A];
+//#endregion
+export { at, fanOut, fanOutImplementation, first, insert, mapBoth, mapBothImplementation, mapEach, mapFirst, mapFirstImplementation, mapSecond, second, swap };
+//# sourceMappingURL=index.d.mts.map

package/dist/tuple/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../../src/tuple/at.ts","../../src/tuple/fanOut.ts","../../src/tuple/first.ts","../../src/tuple/insert.ts","../../src/tuple/mapBoth.ts","../../src/tuple/mapEach.ts","../../src/tuple/mapFirst.ts","../../src/tuple/mapSecond.ts","../../src/tuple/second.ts","../../src/tuple/swap.ts"],"mappings":"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"}