@ts-fns/stdlib 0.1.0 → 0.2.0

package/dist/tuple/index.cjs.map

@@ -1 +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"}
+{"version":3,"file":"index.cjs","names":["purry","purry","purry","purry","purry","purry","purry"],"sources":["../../src/tuple/at.ts","../../src/tuple/fanOut.ts","../../src/tuple/from.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 * Gets an element from a tuple by zero-based index.\n * Throws a range error when the index is negative or out of bounds.\n *\n * @example\n * ```ts\n * at(0, [1, 2, 3]); // 1\n * at(1)([1, 2, 3]); // 2\n * at([1, 2, 3], 10); // throws RangeError\n * ```\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 * Applies two functions to the same value and returns the results as a pair.\n *\n * @example\n * ```ts\n * fanOut((x) => x * 2, (x) => x + 1, 2); // [4, 3]\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 * Builds a two-element tuple from two values.\n *\n * @example\n * ```ts\n * from(1, 'a'); // [1, 'a']\n * ```\n */\nexport function from<A, B>(arg1: A, arg2: B): [A, B] {\n  return [arg1, arg2] as const;\n}\n","/**\n * Returns the first element of a non-empty tuple.\n * Throws a range error when the tuple has fewer than one element.\n *\n * @example\n * ```ts\n * first([1, 2]); // 1\n * first([]); // throws RangeError\n * ```\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 * Throws a range error when `index` is negative or out of bounds.\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 * insert([1, 2, 3], 10, 99); // throws RangeError\n * ```\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\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 * @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 separate functions.\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\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 * @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 * @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 * Throws a range error when the tuple has fewer than two elements.\n *\n * @example\n * ```ts\n * second([1, 2]); // 2\n * second([1]); // throws RangeError\n * ```\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 * @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;AA2BA,SAAgB,GAAG,GAAG,MAAmC;CACvD,OAAOA,cAAAA,MAAM,mBAAmB,IAAI;AACtC;;;ACtCA,SAAgB,qBAA8B,OAAU,KAAsB,KAA8B;CAC1G,OAAO,CAAC,IAAI,KAAK,GAAG,IAAI,KAAK,CAAC;AAChC;AAaA,SAAgB,OAAO,GAAG,MAAmC;CAC3D,OAAOC,cAAAA,MAAM,sBAAsB,IAAI;AACzC;;;;;;;;;;;ACXA,SAAgB,KAAW,MAAS,MAAiB;CACnD,OAAO,CAAC,MAAM,IAAI;AACpB;;;;;;;;;;;;;ACAA,SAAgB,MAAS,OAA6B;CACpD,IAAI,MAAM,SAAS,GACjB,MAAM,IAAI,WAAW,4DAA4D;CAEnF,OAAO,MAAM;AACf;;;ACZA,SAAS,qBAAwB,OAAY,OAAe,OAAe;CACzE,OAAO,MAAM,KAAK,OAAO,KAAK;AAChC;AAyEA,SAAgB,OAAO,GAAG,MAAmC;CAC3D,OAAOC,cAAAA,MAAM,sBAAsB,IAAI;AACzC;;;AC9EA,SAAgB,sBAA4B,OAAe,IAA6B;CACtF,OAAO,CAAC,GAAG,MAAM,EAAE,GAAG,GAAG,MAAM,EAAE,CAAC;AACpC;AAaA,SAAgB,QAAQ,GAAG,MAAmC;CAC5D,OAAOC,cAAAA,MAAM,uBAAuB,IAAI;AAC1C;;;ACjBA,SAAS,sBAAkC,OAAe,KAAsB,KAA8B;CAC5G,OAAO,CAAC,IAAI,MAAM,EAAE,GAAG,IAAI,MAAM,EAAE,CAAC;AACtC;AAaA,SAAgB,QAAQ,GAAG,MAAmC;CAC5D,OAAOC,cAAAA,MAAM,uBAAuB,IAAI;AAC1C;;;ACjBA,SAAgB,uBAAgC,OAAe,IAA6B;CAC1F,OAAO,CAAC,GAAG,MAAM,EAAE,GAAG,MAAM,EAAE;AAChC;AAaA,SAAgB,SAAS,GAAG,MAAmC;CAC7D,OAAOC,cAAAA,MAAM,wBAAwB,IAAI;AAC3C;;;ACjBA,SAAS,wBAAiC,OAAe,IAA6B;CACpF,OAAO,CAAC,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC;AAChC;AAaA,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

@@ -1,19 +1,14 @@
 //#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.
+ * Gets an element from a tuple by zero-based index.
+ * Throws a range error when the index is negative or out of bounds.
  *
  * @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
+ * at(0, [1, 2, 3]); // 1
+ * at(1)([1, 2, 3]); // 2
+ * at([1, 2, 3], 10); // throws RangeError
  * ```
- *
- * @throws {RangeError}
  */
 declare function at<T>(index: 0): (tuple: [T, ...unknown[]]) => T;
 declare function at<T>(index: 1): (tuple: [unknown, T, ...unknown[]]) => T;
@@ -33,53 +28,52 @@ declare function at<T>(tuple: [unknown, unknown, unknown, unknown, unknown, unkn
 //#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.
+ * Applies two functions to the same value and returns the results as a pair.
  *
  * @example
  * ```ts
  * fanOut((x) => x * 2, (x) => x + 1, 2); // [4, 3]
+ * 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
+//#region src/tuple/from.d.ts
 /**
- * Returns the first element of a tuple with at least one element.
+ * Builds a two-element tuple from two values.
  *
- * @param tuple - A non-empty tuple.
- * @returns The element at index `0`.
+ * @example
+ * ```ts
+ * from(1, 'a'); // [1, 'a']
+ * ```
+ */
+declare function from<A, B>(arg1: A, arg2: B): [A, B];
+//#endregion
+//#region src/tuple/first.d.ts
+/**
+ * Returns the first element of a non-empty tuple.
+ * Throws a range error when the tuple has fewer than one element.
  *
  * @example
  * ```ts
  * first([1, 2]); // 1
+ * first([]); // throws RangeError
  * ```
- *
- * @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.
+ * Throws a range error when `index` is negative or out of bounds.
  *
  * @example
  * ```ts
  * insert([1, 2, 3], 1, 99); // [1, 99, 3]
  * insert(1, 99)([1, 2, 3]); // [1, 99, 3]
+ * insert([1, 2, 3], 10, 99); // throws RangeError
  * ```
- *
- * @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;
@@ -101,16 +95,10 @@ declare function insert<T, U extends readonly [unknown, unknown, unknown, unknow
 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]
@@ -122,11 +110,7 @@ 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
+ * Maps the first and second elements of a pair with separate functions.
  *
  * @example
  * ```ts
@@ -138,16 +122,10 @@ declare function mapEach<A, B, X, Y>(fnA: (value: A) => X, fnB: (value: B) => 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']
@@ -161,9 +139,6 @@ declare function mapFirst<A, B, X>(tuple: [A, B], fn: (value: A) => X): [X, B];
 /**
  * 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']
@@ -176,16 +151,13 @@ declare function mapSecond<A, B, Y>(tuple: [A, B], fn: (value: B) => Y): [A, Y];
 //#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`.
+ * Throws a range error when the tuple has fewer than two elements.
  *
  * @example
  * ```ts
  * second([1, 2]); // 2
+ * second([1]); // throws RangeError
  * ```
- *
- * @throws {RangeError} When the tuple has fewer than two elements.
  */
 declare function second<T>(tuple: [unknown, T, ...unknown[]]): T;
 //#endregion
@@ -193,9 +165,6 @@ declare function second<T>(tuple: [unknown, T, ...unknown[]]): T;
 /**
  * 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]
@@ -203,5 +172,5 @@ declare function second<T>(tuple: [unknown, T, ...unknown[]]): T;
  */
 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 };
+export { at, fanOut, fanOutImplementation, first, from, insert, mapBoth, mapBothImplementation, mapEach, mapFirst, mapFirstImplementation, mapSecond, second, swap };
 //# sourceMappingURL=index.d.cts.map

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

@@ -1 +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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"}
+{"version":3,"file":"index.d.cts","names":[],"sources":["../../src/tuple/at.ts","../../src/tuple/fanOut.ts","../../src/tuple/from.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":";;AAwBA;;;;;;;;;;iBAAgB,EAAA,IAAM,KAAA,OAAY,KAAA,GAAQ,CAAA,oBAAqB,CAAC;AAAA,iBAChD,EAAA,IAAM,KAAA,OAAY,KAAA,YAAiB,CAAA,oBAAqB,CAAC;AAAA,iBACzD,EAAA,IAAM,KAAA,OAAY,KAAA,qBAA0B,CAAA,oBAAqB,CAAC;AAAA,iBAClE,EAAA,IAAM,KAAA,OAAY,KAAA,8BAAmC,CAAA,oBAAqB,CAAC;AAAA,iBAC3E,EAAA,IAAM,KAAA,OAAY,KAAA,uCAA4C,CAAA,oBAAqB,CAAC;AAAA,iBACpF,EAAA,IAAM,KAAA,OAAY,KAAA,gDAAqD,CAAA,oBAAqB,CAAC;AAAA,iBAC7F,EAAA,IAAM,KAAA,OAAY,KAAA,yDAA8D,CAAA,oBAAqB,CAAC;AAAA,iBACtG,EAAA,IAAM,KAAA,GAAQ,CAAA,iBAAkB,KAAA,MAAW,CAAC;AAAA,iBAC5C,EAAA,IAAM,KAAA,YAAiB,CAAA,iBAAkB,KAAA,MAAW,CAAC;AAAA,iBACrD,EAAA,IAAM,KAAA,qBAA0B,CAAA,iBAAkB,KAAA,MAAW,CAAC;AAAA,iBAC9D,EAAA,IAAM,KAAA,8BAAmC,CAAA,iBAAkB,KAAA,MAAW,CAAC;AAAA,iBACvE,EAAA,IAAM,KAAA,uCAA4C,CAAA,iBAAkB,KAAA,MAAW,CAAC;AAAA,iBAChF,EAAA,IAAM,KAAA,gDAAqD,CAAA,iBAAkB,KAAA,MAAW,CAAC;AAAA,iBACzF,EAAA,IAAM,KAAA,yDAA8D,CAAA,iBAAkB,KAAA,MAAW,CAAC;;;iBCnClG,oBAAA,UAA8B,KAAA,EAAO,CAAA,EAAG,GAAA,GAAM,KAAA,EAAO,CAAA,KAAM,CAAA,EAAG,GAAA,GAAM,KAAA,EAAO,CAAA,KAAM,CAAA,IAAK,CAAA,EAAG,CAAA;ADsBzG;;;;;;;;;AAAA,iBCTgB,MAAA,UAAgB,GAAA,GAAM,KAAA,EAAO,CAAA,KAAM,CAAA,EAAG,GAAA,GAAM,KAAA,EAAO,CAAA,KAAM,CAAA,IAAK,KAAA,EAAO,CAAA,MAAO,CAAA,EAAG,CAAA;AAAA,iBAC/E,MAAA,UAAgB,KAAA,EAAO,CAAA,EAAG,GAAA,GAAM,KAAA,EAAO,CAAA,KAAM,CAAA,EAAG,GAAA,GAAM,KAAA,EAAO,CAAA,KAAM,CAAA,IAAK,CAAA,EAAG,CAAA;;;;ADQ3F;;;;;;;iBEhBgB,IAAA,OAAW,IAAA,EAAM,CAAA,EAAG,IAAA,EAAM,CAAA,IAAK,CAAA,EAAG,CAAA;;;;AFgBlD;;;;;;;;;iBGdgB,KAAA,IAAS,KAAA,GAAQ,CAAA,kBAAmB,CAAC;;;;AHcrD;;;;;;;;;;iBINgB,MAAA,IAAU,KAAA,KAAU,KAAA,EAAO,CAAA,wBAAyB,CAAA,iBAAkB,KAAA,EAAO,CAAA,KAAM,CAAA;AAAA,iBACnF,MAAA,IAAU,KAAA,KAAU,KAAA,EAAO,CAAA,iCAAkC,CAAA,iBAAkB,KAAA,EAAO,CAAA,KAAM,CAAA;AAAA,iBAC5F,MAAA,IAAU,KAAA,KAAU,KAAA,EAAO,CAAA,0CAA2C,CAAA,iBAAkB,KAAA,EAAO,CAAA,KAAM,CAAA;AAAA,iBACrG,MAAA,IACd,KAAA,KACA,KAAA,EAAO,CAAA,mDAC0C,CAAA,iBAAkB,KAAA,EAAO,CAAA,KAAM,CAAA;AAAA,iBAClE,MAAA,IACd,KAAA,KACA,KAAA,EAAO,CAAA,4DACmD,CAAA,iBAAkB,KAAA,EAAO,CAAA,KAAM,CAAA;AAAA,iBAC3E,MAAA,IACd,KAAA,KACA,KAAA,EAAO,CAAA,qEAC4D,CAAA,iBAAkB,KAAA,EAAO,CAAA,KAAM,CAAA;AAAA,iBACpF,MAAA,IACd,KAAA,KACA,KAAA,EAAO,CAAA,8EACqE,CAAA,iBAAkB,KAAA,EAAO,CAAA,KAAM,CAAA;AAAA,iBAC7F,MAAA,IACd,KAAA,KACA,KAAA,EAAO,CAAA,uFAC8E,CAAA,iBAAkB,KAAA,EAAO,CAAA,KAAM,CAAA;AAAA,iBACtG,MAAA,IACd,KAAA,KACA,KAAA,EAAO,CAAA,gGACuF,CAAA,iBAC9F,KAAA,EAAO,CAAA,KACJ,CAAA;AAAA,iBACW,MAAA,wBAA8B,CAAA,iBAAkB,KAAA,EAAO,CAAA,EAAG,KAAA,KAAU,KAAA,EAAO,CAAA,GAAI,CAAA;AAAA,iBAC/E,MAAA,iCAAuC,CAAA,iBAAkB,KAAA,EAAO,CAAA,EAAG,KAAA,KAAU,KAAA,EAAO,CAAA,GAAI,CAAA;AAAA,iBACxF,MAAA,0CAAgD,CAAA,iBAAkB,KAAA,EAAO,CAAA,EAAG,KAAA,KAAU,KAAA,EAAO,CAAA,GAAI,CAAA;AAAA,iBACjG,MAAA,mDAAyD,CAAA,iBACvE,KAAA,EAAO,CAAA,EACP,KAAA,KACA,KAAA,EAAO,CAAA,GACN,CAAA;AAAA,iBACa,MAAA,4DAAkE,CAAA,iBAChF,KAAA,EAAO,CAAA,EACP,KAAA,KACA,KAAA,EAAO,CAAA,GACN,CAAA;AAAA,iBACa,MAAA,qEAA2E,CAAA,iBACzF,KAAA,EAAO,CAAA,EACP,KAAA,KACA,KAAA,EAAO,CAAA,GACN,CAAA;AAAA,iBACa,MAAA,8EAAoF,CAAA,iBAClG,KAAA,EAAO,CAAA,EACP,KAAA,KACA,KAAA,EAAO,CAAA,GACN,CAAA;AAAA,iBACa,MAAA,uFAEqE,CAAA,iBACnF,KAAA,EAAO,CAAA,EAAG,KAAA,KAAU,KAAA,EAAO,CAAA,GAAI,CAAA;AAAA,iBACjB,MAAA,gGAE8E,CAAA,iBAC5F,KAAA,EAAO,CAAA,EAAG,KAAA,KAAU,KAAA,EAAO,CAAA,GAAI,CAAA;;;iBC3EjB,qBAAA,OAA4B,KAAA,GAAQ,CAAA,EAAG,CAAA,GAAI,EAAA,GAAK,KAAA,EAAO,CAAA,KAAM,CAAA,IAAK,CAAA,EAAG,CAAA;ALsBrF;;;;;;;;;AAAA,iBKTgB,OAAA,OAAc,EAAA,GAAK,KAAA,EAAO,CAAA,KAAM,CAAA,IAAK,KAAA,GAAQ,CAAA,EAAG,CAAA,OAAQ,CAAA,EAAG,CAAA;AAAA,iBAC3D,OAAA,OAAc,KAAA,GAAQ,CAAA,EAAG,CAAA,GAAI,EAAA,GAAK,KAAA,EAAO,CAAA,KAAM,CAAA,IAAK,CAAA,EAAG,CAAA;;;;ALQvE;;;;;;;;iBMTgB,OAAA,aAAoB,GAAA,GAAM,KAAA,EAAO,CAAA,KAAM,CAAA,EAAG,GAAA,GAAM,KAAA,EAAO,CAAA,KAAM,CAAA,IAAK,KAAA,GAAQ,CAAA,EAAG,CAAA,OAAQ,CAAA,EAAG,CAAA;AAAA,iBACxF,OAAA,aAAoB,KAAA,GAAQ,CAAA,EAAG,CAAA,GAAI,GAAA,GAAM,KAAA,EAAO,CAAA,KAAM,CAAA,EAAG,GAAA,GAAM,KAAA,EAAO,CAAA,KAAM,CAAA,IAAK,CAAA,EAAG,CAAA;;;iBCdpF,sBAAA,UAAgC,KAAA,GAAQ,CAAA,EAAG,CAAA,GAAI,EAAA,GAAK,KAAA,EAAO,CAAA,KAAM,CAAA,IAAK,CAAA,EAAG,CAAA;APsBzF;;;;;;;;;AAAA,iBOTgB,QAAA,UAAkB,EAAA,GAAK,KAAA,EAAO,CAAA,KAAM,CAAA,IAAK,KAAA,GAAQ,CAAA,EAAG,CAAA,OAAQ,CAAA,EAAG,CAAA;AAAA,iBAC/D,QAAA,UAAkB,KAAA,GAAQ,CAAA,EAAG,CAAA,GAAI,EAAA,GAAK,KAAA,EAAO,CAAA,KAAM,CAAA,IAAK,CAAA,EAAG,CAAA;;;;APQ3E;;;;;;;;iBQTgB,SAAA,UAAmB,EAAA,GAAK,KAAA,EAAO,CAAA,KAAM,CAAA,IAAK,KAAA,GAAQ,CAAA,EAAG,CAAA,OAAQ,CAAA,EAAG,CAAA;AAAA,iBAChE,SAAA,UAAmB,KAAA,GAAQ,CAAA,EAAG,CAAA,GAAI,EAAA,GAAK,KAAA,EAAO,CAAA,KAAM,CAAA,IAAK,CAAA,EAAG,CAAA;;;;ARQ5E;;;;;;;;;iBSdgB,MAAA,IAAU,KAAA,YAAiB,CAAA,kBAAmB,CAAC;;;;ATc/D;;;;;;;iBUhBgB,IAAA,OAAW,IAAA,GAAO,CAAA,EAAG,CAAA,KAAM,CAAA,EAAG,CAAA"}

package/dist/tuple/index.d.mts

@@ -1,19 +1,14 @@
 //#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.
+ * Gets an element from a tuple by zero-based index.
+ * Throws a range error when the index is negative or out of bounds.
  *
  * @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
+ * at(0, [1, 2, 3]); // 1
+ * at(1)([1, 2, 3]); // 2
+ * at([1, 2, 3], 10); // throws RangeError
  * ```
- *
- * @throws {RangeError}
  */
 declare function at<T>(index: 0): (tuple: [T, ...unknown[]]) => T;
 declare function at<T>(index: 1): (tuple: [unknown, T, ...unknown[]]) => T;
@@ -33,53 +28,52 @@ declare function at<T>(tuple: [unknown, unknown, unknown, unknown, unknown, unkn
 //#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.
+ * Applies two functions to the same value and returns the results as a pair.
  *
  * @example
  * ```ts
  * fanOut((x) => x * 2, (x) => x + 1, 2); // [4, 3]
+ * 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
+//#region src/tuple/from.d.ts
 /**
- * Returns the first element of a tuple with at least one element.
+ * Builds a two-element tuple from two values.
  *
- * @param tuple - A non-empty tuple.
- * @returns The element at index `0`.
+ * @example
+ * ```ts
+ * from(1, 'a'); // [1, 'a']
+ * ```
+ */
+declare function from<A, B>(arg1: A, arg2: B): [A, B];
+//#endregion
+//#region src/tuple/first.d.ts
+/**
+ * Returns the first element of a non-empty tuple.
+ * Throws a range error when the tuple has fewer than one element.
  *
  * @example
  * ```ts
  * first([1, 2]); // 1
+ * first([]); // throws RangeError
  * ```
- *
- * @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.
+ * Throws a range error when `index` is negative or out of bounds.
  *
  * @example
  * ```ts
  * insert([1, 2, 3], 1, 99); // [1, 99, 3]
  * insert(1, 99)([1, 2, 3]); // [1, 99, 3]
+ * insert([1, 2, 3], 10, 99); // throws RangeError
  * ```
- *
- * @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;
@@ -101,16 +95,10 @@ declare function insert<T, U extends readonly [unknown, unknown, unknown, unknow
 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]
@@ -122,11 +110,7 @@ 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
+ * Maps the first and second elements of a pair with separate functions.
  *
  * @example
  * ```ts
@@ -138,16 +122,10 @@ declare function mapEach<A, B, X, Y>(fnA: (value: A) => X, fnB: (value: B) => 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']
@@ -161,9 +139,6 @@ declare function mapFirst<A, B, X>(tuple: [A, B], fn: (value: A) => X): [X, B];
 /**
  * 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']
@@ -176,16 +151,13 @@ declare function mapSecond<A, B, Y>(tuple: [A, B], fn: (value: B) => Y): [A, Y];
 //#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`.
+ * Throws a range error when the tuple has fewer than two elements.
  *
  * @example
  * ```ts
  * second([1, 2]); // 2
+ * second([1]); // throws RangeError
  * ```
- *
- * @throws {RangeError} When the tuple has fewer than two elements.
  */
 declare function second<T>(tuple: [unknown, T, ...unknown[]]): T;
 //#endregion
@@ -193,9 +165,6 @@ declare function second<T>(tuple: [unknown, T, ...unknown[]]): T;
 /**
  * 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]
@@ -203,5 +172,5 @@ declare function second<T>(tuple: [unknown, T, ...unknown[]]): T;
  */
 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 };
+export { at, fanOut, fanOutImplementation, first, from, insert, mapBoth, mapBothImplementation, mapEach, mapFirst, mapFirstImplementation, mapSecond, second, swap };
 //# sourceMappingURL=index.d.mts.map

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

@@ -1 +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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"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../../src/tuple/at.ts","../../src/tuple/fanOut.ts","../../src/tuple/from.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.mjs

@@ -1,4 +1,4 @@
-import { t as purry } from "../purry-BOWmqwDB.mjs";
+import { t as purry } from "../purry-DXnhXie9.mjs";
 //#region src/tuple/at.ts
 function at2Implementation(tuple, index) {
 	if (index < 0) throw new RangeError(`Tuple.at() :: ${index} must be a positive integer`);
@@ -17,19 +17,29 @@ function fanOut(...args) {
 	return purry(fanOutImplementation, args);
 }
 //#endregion
-//#region src/tuple/first.ts
+//#region src/tuple/from.ts
 /**
-* Returns the first element of a tuple with at least one element.
+* Builds a two-element tuple from two values.
 *
-* @param tuple - A non-empty tuple.
-* @returns The element at index `0`.
+* @example
+* ```ts
+* from(1, 'a'); // [1, 'a']
+* ```
+*/
+function from(arg1, arg2) {
+	return [arg1, arg2];
+}
+//#endregion
+//#region src/tuple/first.ts
+/**
+* Returns the first element of a non-empty tuple.
+* Throws a range error when the tuple has fewer than one element.
 *
 * @example
 * ```ts
 * first([1, 2]); // 1
+* first([]); // throws RangeError
 * ```
-*
-* @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");
@@ -45,9 +55,6 @@ function insert(...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])];
 }
@@ -64,9 +71,6 @@ function mapEach(...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]];
 }
@@ -85,16 +89,13 @@ function mapSecond(...args) {
 //#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`.
+* Throws a range error when the tuple has fewer than two elements.
 *
 * @example
 * ```ts
 * second([1, 2]); // 2
+* second([1]); // throws RangeError
 * ```
-*
-* @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");
@@ -105,9 +106,6 @@ function second(tuple) {
 /**
 * 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]
@@ -117,6 +115,6 @@ function swap(data) {
 	return [data[1], data[0]];
 }
 //#endregion
-export { at, fanOut, fanOutImplementation, first, insert, mapBoth, mapBothImplementation, mapEach, mapFirst, mapFirstImplementation, mapSecond, second, swap };
+export { at, fanOut, fanOutImplementation, first, from, insert, mapBoth, mapBothImplementation, mapEach, mapFirst, mapFirstImplementation, mapSecond, second, swap };
 
 //# sourceMappingURL=index.mjs.map