@ts-fns/stdlib 0.1.0 → 0.2.1

package/dist/string/index.mjs

@@ -1,7 +1,7 @@
-import { t as orThrow } from "../orThrow-V91Jw2lF.mjs";
-import { t as purry } from "../purry-BOWmqwDB.mjs";
+import { p as orThrow } from "../function-CYHPhQCQ.mjs";
+import { t as purry } from "../purry-DXnhXie9.mjs";
 import { a as NotYetImplementedError, i as NotFoundError } from "../errors-Dw1kitu_.mjs";
-import "../function-DnI2v0p3.mjs";
+import "../order/index.mjs";
 //#region src/string/at.ts
 function atImplementation(str, index) {
 	if (index >= str.length || index < -str.length) return /* @__PURE__ */ new RangeError(`Str.at() :: Invalid index : ${index}`);
@@ -13,6 +13,15 @@ function at(...args) {
 function atAssert(...args) {
 	return purry(orThrow(atImplementation), args);
 }
+/**
+* Like `at`, but throws when the index is out of bounds.
+*
+* @example
+* ```ts
+* at.assert('hello', 1); // 'e'
+* at.assert('hello', 10); // throws RangeError
+* ```
+*/
 at.assert = atAssert;
 //#endregion
 //#region src/string/charCodeAt.ts
@@ -27,6 +36,15 @@ function charCodeAt(...args) {
 function charCodeAtAssert(...args) {
 	return purry(orThrow(charCodeAtImplementation), args);
 }
+/**
+* Like `charCodeAt`, but throws when the index is out of bounds.
+*
+* @example
+* ```ts
+* charCodeAt.assert('hello', 0); // 104
+* charCodeAt.assert('hello', 10); // throws RangeError
+* ```
+*/
 charCodeAt.assert = charCodeAtAssert;
 //#endregion
 //#region src/string/codePointAt.ts
@@ -41,9 +59,43 @@ function codePointAt(...args) {
 function codePointAtAssert(...args) {
 	return purry(orThrow(codePointAtImplementation), args);
 }
+/**
+* Like `codePointAt`, but throws when the index is out of bounds.
+*
+* @example
+* ```ts
+* codePointAt.assert('hello', 0); // 104
+* codePointAt.assert('hello', 10); // throws RangeError
+* ```
+*/
 codePointAt.assert = codePointAtAssert;
 //#endregion
+//#region src/string/compare.ts
+/**
+* Compares two strings lexicographically and returns their ordering.
+*
+* @example
+* ```ts
+* compare('a', 'b'); // -1
+* compare('b', 'b'); // 0
+* compare('c', 'b'); // 1
+* ```
+*/
+function compare(left, right) {
+	if (left < right) return -1;
+	if (left > right) return 1;
+	return 0;
+}
+//#endregion
 //#region src/string/concat.ts
+/**
+* Concatenates two strings.
+*
+* @example
+* ```ts
+* concat('hello', ' world'); // throws NotYetImplementedError
+* ```
+*/
 function concat(str, other) {
 	throw new NotYetImplementedError("Str.concat not yet implemented");
 }
@@ -88,6 +140,15 @@ function indexOf(...args) {
 function indexOfAssert(...args) {
 	return purry(orThrow(indexOfImplementation), args);
 }
+/**
+* Like `indexOf`, but throws when the search string is absent.
+*
+* @example
+* ```ts
+* indexOf.assert('hello world', 'world'); // 6
+* indexOf.assert('hello world', 'xyz'); // throws NotFoundError
+* ```
+*/
 indexOf.assert = indexOfAssert;
 function indexOfPositionImplementation(str, search, position) {
 	return str.indexOf(search, position);
@@ -98,19 +159,125 @@ function indexOfPosition(...args) {
 function indexOfPositionAssert(...args) {
 	return purry(orThrow(indexOfPositionImplementation), args);
 }
+/**
+* Like `indexOfPosition`, but throws when the result is an error.
+*
+* @example
+* ```ts
+* indexOfPosition.assert('hello world', 'o', 5); // 7
+* indexOfPosition.assert('hello world', 'o', 8); // throws
+* ```
+*/
 indexOfPosition.assert = indexOfPositionAssert;
 //#endregion
+//#region src/string/isEmpty.ts
+/**
+* Returns whether a string has no characters.
+*
+* @example
+* ```ts
+* isEmpty(''); // true
+* isEmpty('hello'); // false
+* ```
+*/
+function isEmpty(str) {
+	return str.length === 0;
+}
+//#endregion
 //#region src/string/isWellFormed.ts
+/**
+* Returns whether a string is a well-formed Unicode string with no lone surrogates.
+*
+* @example
+* ```ts
+* isWellFormed('hello'); // true
+* isWellFormed('\uD800'); // false
+* ```
+*/
 function isWellFormed(str) {
 	return str.isWellFormed();
 }
 //#endregion
+//#region src/string/lastIndexOf.ts
+function lastIndexOfImplementation(str, search) {
+	const result = str.lastIndexOf(search);
+	if (result === -1) return new NotFoundError(`Str.lastIndexOf() :: "${search}" not found in "${str}"`);
+	return result;
+}
+function lastIndexOf(...args) {
+	return purry(lastIndexOfImplementation, args);
+}
+function lastIndexOfAssert(...args) {
+	return purry(orThrow(lastIndexOfImplementation), args);
+}
+/**
+* Like `lastIndexOf`, but throws when the search string is absent.
+*
+* @example
+* ```ts
+* lastIndexOf.assert('hello world', 'o'); // 7
+* lastIndexOf.assert('hello world', 'xyz'); // throws NotFoundError
+* ```
+*/
+lastIndexOf.assert = lastIndexOfAssert;
+function lastIndexOfPositionImplementation(str, search, position) {
+	const result = str.lastIndexOf(search, position);
+	if (result === -1) return new NotFoundError(`Str.lastIndexOf() :: "${search}" not found in "${str}" at position ${position}`);
+	return result;
+}
+function lastIndexOfPosition(...args) {
+	return purry(lastIndexOfPositionImplementation, args);
+}
+function lastIndexOfPositionAssert(...args) {
+	return purry(orThrow(lastIndexOfPositionImplementation), args);
+}
+/**
+* Like `lastIndexOfPosition`, but throws when the search string is absent.
+*
+* @example
+* ```ts
+* lastIndexOfPosition.assert('hello world', 'o', 6); // 4
+* lastIndexOfPosition.assert('hello world', 'o', 3); // throws NotFoundError
+* ```
+*/
+lastIndexOfPosition.assert = lastIndexOfPositionAssert;
+//#endregion
+//#region src/string/length.ts
+/**
+* Returns the length of a string in UTF-16 code units.
+*
+* @example
+* ```ts
+* length('hello'); // 5
+* length(''); // 0
+* ```
+*/
+function length(str) {
+	return str.length;
+}
+//#endregion
 //#region src/string/localeCompare.ts
+/**
+* Compares two strings using locale-aware rules and returns a sort order number.
+*
+* @example
+* ```ts
+* localeCompare('a', 'b'); // throws NotYetImplementedError
+* ```
+*/
 function localeCompare(left, right) {
 	throw new NotYetImplementedError("Str.localeCompare not yet implemented");
 }
 //#endregion
 //#region src/string/normalize.ts
+/**
+* Returns a Unicode-normalized string using NFC form.
+*
+* @example
+* ```ts
+* normalize('café'); // 'café'
+* ```
+*/
 function normalize(str) {
 	return str.normalize();
 }
@@ -146,9 +313,25 @@ function repeat(...args) {
 }
 //#endregion
 //#region src/string/replace.ts
+/**
+* Replaces the first match of a search value in a string.
+*
+* @example
+* ```ts
+* replace('hello world', 'world', 'there'); // throws NotYetImplementedError
+* ```
+*/
 function replace(str, searchValue, replaceValue) {
 	throw new NotYetImplementedError("Str.replace not yet implemented");
 }
+/**
+* Replaces all matches of a search value in a string.
+*
+* @example
+* ```ts
+* replaceAll('hello world', 'l', 'L'); // throws NotYetImplementedError
+* ```
+*/
 function replaceAll(str, searchValue, replacement) {
 	throw new NotYetImplementedError("Str.replace not yet implemented");
 }
@@ -165,6 +348,15 @@ function search(...args) {
 function searchAssert(...args) {
 	return purry(orThrow(searchImplementation), args);
 }
+/**
+* Like `search`, but throws when there is no match.
+*
+* @example
+* ```ts
+* search.assert('hello world', /world/); // 6
+* search.assert('hello world', /xyz/); // throws NotFoundError
+* ```
+*/
 search.assert = searchAssert;
 //#endregion
 //#region src/string/slice.ts
@@ -223,32 +415,107 @@ function substringEnd(...args) {
 	return purry(substringEndImplementation, args);
 }
 //#endregion
+//#region src/string/toLocaleLowerCase.ts
+/**
+* Returns a string with all characters converted to locale-aware lowercase.
+*
+* @example
+* ```ts
+* toLocaleLowerCase('STRASSE'); // throws NotYetImplementedError
+* ```
+*/
+function toLocaleLowerCase(str) {
+	throw new NotYetImplementedError("Str.toLocaleLowerCase not yet implemented");
+}
+//#endregion
+//#region src/string/toLocaleUpperCase.ts
+/**
+* Returns a string with all characters converted to locale-aware uppercase.
+*
+* @example
+* ```ts
+* toLocaleUpperCase('straße'); // throws NotYetImplementedError
+* ```
+*/
+function toLocaleUpperCase(str) {
+	throw new NotYetImplementedError("Str.toLocaleUpperCase not yet implemented");
+}
+//#endregion
 //#region src/string/toLowerCase.ts
+/**
+* Returns a string with all characters converted to lowercase.
+*
+* @example
+* ```ts
+* toLowerCase('HELLO'); // 'hello'
+* ```
+*/
 function toLowerCase(str) {
 	return str.toLowerCase();
 }
 //#endregion
 //#region src/string/toUpperCase.ts
+/**
+* Returns a string with all characters converted to uppercase.
+*
+* @example
+* ```ts
+* toUpperCase('hello'); // 'HELLO'
+* ```
+*/
 function toUpperCase(str) {
 	return str.toUpperCase();
 }
 //#endregion
 //#region src/string/toWellFormed.ts
+/**
+* Returns a well-formed Unicode string by replacing lone surrogates with replacement characters.
+*
+* @example
+* ```ts
+* toWellFormed('\uD800'); // '\uFFFD'
+* toWellFormed('hello'); // 'hello'
+* ```
+*/
 function toWellFormed(str) {
 	return str.toWellFormed();
 }
 //#endregion
 //#region src/string/trim.ts
+/**
+* Removes leading and trailing whitespace from a string.
+*
+* @example
+* ```ts
+* trim('  hello  '); // 'hello'
+* ```
+*/
 function trim(str) {
 	return str.trim();
 }
+/**
+* Removes trailing whitespace from a string.
+*
+* @example
+* ```ts
+* trimEnd('  hello  '); // '  hello'
+* ```
+*/
 function trimEnd(str) {
 	return str.trimEnd();
 }
+/**
+* Removes leading whitespace from a string.
+*
+* @example
+* ```ts
+* trimStart('  hello  '); // 'hello  '
+* ```
+*/
 function trimStart(str) {
 	return str.trimStart();
 }
 //#endregion
-export { at, charCodeAt, codePointAt, concat, endsWith, endsWithPosition, includes, includesPosition, indexOf, indexOfPosition, isWellFormed, localeCompare, normalize, normalizeForm, padEnd, padStart, repeat, replace, replaceAll, search, slice, sliceEnd, split, splitLimit, startsWith, startsWithPosition, substring, substringEnd, toLowerCase, toUpperCase, toWellFormed, trim, trimEnd, trimStart };
+export { at, charCodeAt, codePointAt, compare, concat, endsWith, endsWithPosition, includes, includesPosition, indexOf, indexOfPosition, isEmpty, isWellFormed, lastIndexOf, lastIndexOfPosition, length, localeCompare, normalize, normalizeForm, padEnd, padStart, repeat, replace, replaceAll, search, slice, sliceEnd, split, splitLimit, startsWith, startsWithPosition, substring, substringEnd, toLocaleLowerCase, toLocaleUpperCase, toLowerCase, toUpperCase, toWellFormed, trim, trimEnd, trimStart };
 
 //# sourceMappingURL=index.mjs.map

package/dist/string/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":[],"sources":["../../src/string/at.ts","../../src/string/charCodeAt.ts","../../src/string/codePointAt.ts","../../src/string/concat.ts","../../src/string/endsWith.ts","../../src/string/includes.ts","../../src/string/indexOf.ts","../../src/string/isWellFormed.ts","../../src/string/localeCompare.ts","../../src/string/normalize.ts","../../src/string/padEnd.ts","../../src/string/padStart.ts","../../src/string/repeat.ts","../../src/string/replace.ts","../../src/string/search.ts","../../src/string/slice.ts","../../src/string/split.ts","../../src/string/startsWith.ts","../../src/string/substring.ts","../../src/string/toLowerCase.ts","../../src/string/toUpperCase.ts","../../src/string/toWellFormed.ts","../../src/string/trim.ts"],"sourcesContent":["import { orThrow } from '../function/orThrow';\nimport { purry } from '../function/purry';\n\nfunction atImplementation(str: string, index: number): RangeError | string {\n  if (index >= str.length || index < -str.length) {\n    return new RangeError(`Str.at() :: Invalid index : ${index}`);\n  }\n\n  return str.at(index)!;\n}\n\nexport function at(index: number): (str: string) => RangeError | string;\nexport function at(str: string, index: number): RangeError | string;\nexport function at(...args: unknown[]): unknown {\n  return purry(atImplementation, args);\n}\n\nfunction atAssert(index: number): (str: string) => string;\nfunction atAssert(str: string, index: number): string;\nfunction atAssert(...args: unknown[]): unknown {\n  return purry(orThrow(atImplementation), args);\n}\n\nat.assert = atAssert;\n","import { orThrow } from '../function/orThrow';\nimport { purry } from '../function/purry';\n\nfunction charCodeAtImplementation(str: string, index: number): RangeError | number {\n  if (index >= str.length || index < -str.length) {\n    return new RangeError(`Str.charCodeAt() :: Invalid index : ${index}`);\n  }\n\n  const adjustedIndex = index < 0 ? str.length + index : index;\n\n  return str.charCodeAt(adjustedIndex);\n}\n\nexport function charCodeAt(index: number): (str: string) => RangeError | number;\nexport function charCodeAt(str: string, index: number): RangeError | number;\nexport function charCodeAt(...args: unknown[]): unknown {\n  return purry(charCodeAtImplementation, args);\n}\n\nfunction charCodeAtAssert(index: number): (str: string) => number;\nfunction charCodeAtAssert(str: string, index: number): number;\nfunction charCodeAtAssert(...args: unknown[]): unknown {\n  return purry(orThrow(charCodeAtImplementation), args);\n}\n\ncharCodeAt.assert = charCodeAtAssert;\n","import { orThrow } from '../function/orThrow';\nimport { purry } from '../function/purry';\n\nfunction codePointAtImplementation(str: string, index: number): RangeError | number {\n  if (index >= str.length || index < -str.length) {\n    return new RangeError(`Str.codePointAt() :: Invalid index : ${index}`);\n  }\n\n  const adjustedIndex = index < 0 ? str.length + index : index;\n\n  return str.codePointAt(adjustedIndex)!;\n}\n\nexport function codePointAt(index: number): (str: string) => RangeError | number;\nexport function codePointAt(str: string, index: number): RangeError | number;\nexport function codePointAt(...args: unknown[]): unknown {\n  return purry(codePointAtImplementation, args);\n}\n\nfunction codePointAtAssert(index: number): (str: string) => number;\nfunction codePointAtAssert(str: string, index: number): number;\nfunction codePointAtAssert(...args: unknown[]): unknown {\n  return purry(orThrow(codePointAtImplementation), args);\n}\n\ncodePointAt.assert = codePointAtAssert;\n","import { NotYetImplementedError } from '../errors';\n\n// eslint-disable-next-line @typescript-eslint/no-unused-vars\nexport function concat(str: string, other: string): string {\n  // TODO: need to think about how to handle the native's variable argument length\n  throw new NotYetImplementedError('Str.concat not yet implemented');\n}\n","import { purry } from '../function/purry';\n\nfunction endsWithImplementation(str: string, search: string): boolean {\n  return str.endsWith(search);\n}\n\nexport function endsWith(search: string): (str: string) => boolean;\nexport function endsWith(str: string, search: string): boolean;\nexport function endsWith(...args: unknown[]): unknown {\n  return purry(endsWithImplementation, args);\n}\n\nfunction endsWithPositionImplementation(str: string, search: string, position: number): boolean {\n  return str.endsWith(search, position);\n}\n\nexport function endsWithPosition(search: string, position: number): (str: string) => boolean;\nexport function endsWithPosition(str: string, search: string, position: number): boolean;\nexport function endsWithPosition(...args: unknown[]): unknown {\n  return purry(endsWithPositionImplementation, args);\n}\n","import { purry } from '../function/purry';\n\nfunction includesImplementation(str: string, search: string): boolean {\n  return str.includes(search);\n}\n\nexport function includes(search: string): (str: string) => boolean;\nexport function includes(str: string, search: string): boolean;\nexport function includes(...args: unknown[]): unknown {\n  return purry(includesImplementation, args);\n}\n\nfunction includesPositionImplementation(str: string, search: string, position: number): boolean {\n  return str.includes(search, position);\n}\n\nexport function includesPosition(position: number, search: string): (str: string) => boolean;\nexport function includesPosition(str: string, search: string, position: number): boolean;\nexport function includesPosition(...args: unknown[]): unknown {\n  return purry(includesPositionImplementation, args);\n}\n","import { NotFoundError } from '../errors';\nimport { orThrow } from '../function/orThrow';\nimport { purry } from '../function/purry';\n\nfunction indexOfImplementation(str: string, search: string): NotFoundError | number {\n  const result = str.indexOf(search);\n  if (result === -1) {\n    return new NotFoundError(`Str.indexOf() :: \"${search}\" not found in \"${str}\"`);\n  }\n  return result;\n}\n\nexport function indexOf(search: string): (str: string) => NotFoundError | number;\nexport function indexOf(str: string, search: string): NotFoundError | number;\nexport function indexOf(...args: unknown[]): unknown {\n  return purry(indexOfImplementation, args);\n}\n\nfunction indexOfAssert(search: string): (str: string) => number;\nfunction indexOfAssert(str: string, search: string): number;\nfunction indexOfAssert(...args: unknown[]): unknown {\n  return purry(orThrow(indexOfImplementation), args);\n}\n\nindexOf.assert = indexOfAssert;\n\nfunction indexOfPositionImplementation(str: string, search: string, position: number): NotFoundError | number {\n  return str.indexOf(search, position);\n}\n\nexport function indexOfPosition(position: number, search: string): (str: string) => NotFoundError | number;\nexport function indexOfPosition(str: string, search: string, position: number): NotFoundError | number;\nexport function indexOfPosition(...args: unknown[]): unknown {\n  return purry(indexOfPositionImplementation, args);\n}\n\nfunction indexOfPositionAssert(position: number, search: string): (str: string) => number;\nfunction indexOfPositionAssert(str: string, search: string, position: number): number;\nfunction indexOfPositionAssert(...args: unknown[]): unknown {\n  return purry(orThrow(indexOfPositionImplementation), args);\n}\n\nindexOfPosition.assert = indexOfPositionAssert;\n","export function isWellFormed(str: string): boolean {\n  return str.isWellFormed();\n}\n","import { NotYetImplementedError } from '../errors';\n\n// eslint-disable-next-line @typescript-eslint/no-unused-vars\nexport function localeCompare(left: string, right: string): number {\n  throw new NotYetImplementedError('Str.localeCompare not yet implemented');\n}\n","import { purry } from '../function/purry';\n\nexport function normalize(str: string): string {\n  return str.normalize();\n}\n\nfunction normalizeFormImplementation(str: string, form: 'NFC' | 'NFD' | 'NFKC' | 'NFKD'): string {\n  return str.normalize(form);\n}\n\nexport function normalizeForm(form: 'NFC' | 'NFD' | 'NFKC' | 'NFKD'): (str: string) => string;\nexport function normalizeForm(str: string, form: 'NFC' | 'NFD' | 'NFKC' | 'NFKD'): string;\nexport function normalizeForm(...args: unknown[]): unknown {\n  return purry(normalizeFormImplementation, args);\n}\n","import { purry } from '../function/purry';\n\nfunction padEndImplementation(str: string, targetLength: number, padString: string): string {\n  return str.padEnd(targetLength, padString);\n}\n\nexport function padEnd(targetLength: number, padString: string): (str: string) => string;\nexport function padEnd(str: string, targetLength: number, padString: string): string;\nexport function padEnd(...args: unknown[]): unknown {\n  return purry(padEndImplementation, args);\n}\n","import { purry } from '../function/purry';\n\nfunction padStartImplementation(str: string, targetLength: number, padString: string): string {\n  return str.padStart(targetLength, padString);\n}\n\nexport function padStart(targetLength: number, padString: string): (str: string) => string;\nexport function padStart(str: string, targetLength: number, padString: string): string;\nexport function padStart(...args: unknown[]): unknown {\n  return purry(padStartImplementation, args);\n}\n","import { purry } from '../function/purry';\n\nfunction repeatImplementation(str: string, count: number): string {\n  return str.repeat(count);\n}\n\nexport function repeat(count: number): (str: string) => string;\nexport function repeat(str: string, count: number): string;\nexport function repeat(...args: unknown[]): unknown {\n  return purry(repeatImplementation, args);\n}\n","import { NotYetImplementedError } from '../errors';\n\n// eslint-disable-next-line @typescript-eslint/no-unused-vars\nexport function replace(str: string, searchValue: RegExp | string, replaceValue: string): string {\n  throw new NotYetImplementedError('Str.replace not yet implemented');\n}\n\n// eslint-disable-next-line @typescript-eslint/no-unused-vars\nexport function replaceAll(str: string, searchValue: RegExp | string, replacement: string): string {\n  throw new NotYetImplementedError('Str.replace not yet implemented');\n}\n","import { NotFoundError } from '../errors';\nimport { purry } from '../function';\nimport { orThrow } from '../function/orThrow';\n\nfunction searchImplementation(\n  str: string,\n  searcher: { [Symbol.search](string: string): number },\n): NotFoundError | number {\n  const result = str.search(searcher);\n  if (result === -1) {\n    // eslint-disable-next-line @typescript-eslint/no-base-to-string, @typescript-eslint/restrict-template-expressions\n    return new NotFoundError(`Str.search() :: \"${searcher}\" not found in \"${str}\"`);\n  }\n  return result;\n}\n\nexport function search(searcher: { [Symbol.search](string: string): number }): (str: string) => NotFoundError | number;\nexport function search(str: string, searcher: { [Symbol.search](string: string): number }): NotFoundError | number;\nexport function search(...args: unknown[]): unknown {\n  return purry(searchImplementation, args);\n}\n\nfunction searchAssert(searcher: { [Symbol.search](string: string): number }): (str: string) => number;\nfunction searchAssert(str: string, searcher: { [Symbol.search](string: string): number }): number;\nfunction searchAssert(...args: unknown[]): unknown {\n  return purry(orThrow(searchImplementation), args);\n}\n\nsearch.assert = searchAssert;\n","import { purry } from '../function/purry';\n\nfunction sliceImplementation(str: string, start: number): string {\n  return str.slice(start);\n}\n\nexport function slice(start: number): (str: string) => string;\nexport function slice(str: string, start: number): string;\nexport function slice(...args: unknown[]): unknown {\n  return purry(sliceImplementation, args);\n}\n\nfunction sliceEndImplementation(str: string, start: number, end: number): string {\n  return str.slice(start, end);\n}\n\nexport function sliceEnd(end: number): (str: string, start: number) => string;\nexport function sliceEnd(str: string, start: number, end: number): string;\nexport function sliceEnd(...args: unknown[]): unknown {\n  return purry(sliceEndImplementation, args);\n}\n","import { purry } from '../function/purry';\n\nfunction splitImplementation(str: string, separator: string): string[] {\n  return str.split(separator);\n}\n\nexport function split(separator: string): (str: string) => string[];\nexport function split(str: string, separator: string): string[];\nexport function split(...args: unknown[]): unknown {\n  return purry(splitImplementation, args);\n}\n\nfunction splitLimitImplementation(str: string, separator: string, limit: number): string[] {\n  return str.split(separator, limit);\n}\n\nexport function splitLimit(separator: string, limit: number): (str: string) => string[];\nexport function splitLimit(str: string, separator: string, limit: number): string[];\nexport function splitLimit(...args: unknown[]): unknown {\n  return purry(splitLimitImplementation, args);\n}\n","import { purry } from '../function/purry';\n\nfunction startsWithImplementation(str: string, search: string): boolean {\n  return str.startsWith(search);\n}\n\nexport function startsWith(search: string): (str: string) => boolean;\nexport function startsWith(str: string, search: string): boolean;\nexport function startsWith(...args: unknown[]): unknown {\n  return purry(startsWithImplementation, args);\n}\n\nfunction startsWithPositionImplementation(str: string, search: string, position: number): boolean {\n  return str.startsWith(search, position);\n}\n\nexport function startsWithPosition(search: string, position: number): (str: string) => boolean;\nexport function startsWithPosition(str: string, search: string, position: number): boolean;\nexport function startsWithPosition(...args: unknown[]): unknown {\n  return purry(startsWithPositionImplementation, args);\n}\n","import { purry } from '../function/purry';\n\nfunction substringImplementation(str: string, start: number, end: number): string {\n  return str.substring(start, end);\n}\n\nexport function substring(start: number, end: number): (str: string) => string;\nexport function substring(str: string, start: number, end: number): string;\nexport function substring(...args: unknown[]): unknown {\n  return purry(substringImplementation, args);\n}\n\nfunction substringEndImplementation(str: string, start: number, end: number): string {\n  return str.substring(start, end);\n}\n\nexport function substringEnd(start: number, end: number): (str: string) => string;\nexport function substringEnd(str: string, start: number, end: number): string;\nexport function substringEnd(...args: unknown[]): unknown {\n  return purry(substringEndImplementation, args);\n}\n","export function toLowerCase(str: string): string {\n  return str.toLowerCase();\n}\n","export function toUpperCase(str: string): string {\n  return str.toUpperCase();\n}\n","export function toWellFormed(str: string): string {\n  return str.toWellFormed();\n}\n","export function trim(str: string): string {\n  return str.trim();\n}\n\nexport function trimEnd(str: string): string {\n  return str.trimEnd();\n}\n\nexport function trimStart(str: string): string {\n  return str.trimStart();\n}\n"],"mappings":"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"}
+{"version":3,"file":"index.mjs","names":[],"sources":["../../src/string/at.ts","../../src/string/charCodeAt.ts","../../src/string/codePointAt.ts","../../src/string/compare.ts","../../src/string/concat.ts","../../src/string/endsWith.ts","../../src/string/includes.ts","../../src/string/indexOf.ts","../../src/string/isEmpty.ts","../../src/string/isWellFormed.ts","../../src/string/lastIndexOf.ts","../../src/string/length.ts","../../src/string/localeCompare.ts","../../src/string/normalize.ts","../../src/string/padEnd.ts","../../src/string/padStart.ts","../../src/string/repeat.ts","../../src/string/replace.ts","../../src/string/search.ts","../../src/string/slice.ts","../../src/string/split.ts","../../src/string/startsWith.ts","../../src/string/substring.ts","../../src/string/toLocaleLowerCase.ts","../../src/string/toLocaleUpperCase.ts","../../src/string/toLowerCase.ts","../../src/string/toUpperCase.ts","../../src/string/toWellFormed.ts","../../src/string/trim.ts"],"sourcesContent":["import { orThrow } from '../function/orThrow';\nimport { purry } from '../function/purry';\n\nfunction atImplementation(str: string, index: number): RangeError | string {\n  if (index >= str.length || index < -str.length) {\n    return new RangeError(`Str.at() :: Invalid index : ${index}`);\n  }\n\n  return str.at(index)!;\n}\n\n/**\n * Returns the character at an index, supporting negative indices from the end.\n * Returns a range error when the index is out of bounds.\n *\n * @example\n * ```ts\n * at('hello', 1); // 'e'\n * at(-1)('hello'); // 'o'\n * at('hello', 10); // RangeError\n * ```\n */\nexport function at(index: number): (str: string) => RangeError | string;\nexport function at(str: string, index: number): RangeError | string;\nexport function at(...args: unknown[]): unknown {\n  return purry(atImplementation, args);\n}\n\nfunction atAssert(index: number): (str: string) => string;\nfunction atAssert(str: string, index: number): string;\nfunction atAssert(...args: unknown[]): unknown {\n  return purry(orThrow(atImplementation), args);\n}\n\n/**\n * Like `at`, but throws when the index is out of bounds.\n *\n * @example\n * ```ts\n * at.assert('hello', 1); // 'e'\n * at.assert('hello', 10); // throws RangeError\n * ```\n */\nat.assert = atAssert;\n","import { orThrow } from '../function/orThrow';\nimport { purry } from '../function/purry';\n\nfunction charCodeAtImplementation(str: string, index: number): RangeError | number {\n  if (index >= str.length || index < -str.length) {\n    return new RangeError(`Str.charCodeAt() :: Invalid index : ${index}`);\n  }\n\n  const adjustedIndex = index < 0 ? str.length + index : index;\n\n  return str.charCodeAt(adjustedIndex);\n}\n\n/**\n * Returns the UTF-16 code unit at an index, supporting negative indices from the end.\n * Returns a range error when the index is out of bounds.\n *\n * @example\n * ```ts\n * charCodeAt('hello', 0); // 104\n * charCodeAt(-1)('hello'); // 111\n * charCodeAt('hello', 10); // RangeError\n * ```\n */\nexport function charCodeAt(index: number): (str: string) => RangeError | number;\nexport function charCodeAt(str: string, index: number): RangeError | number;\nexport function charCodeAt(...args: unknown[]): unknown {\n  return purry(charCodeAtImplementation, args);\n}\n\nfunction charCodeAtAssert(index: number): (str: string) => number;\nfunction charCodeAtAssert(str: string, index: number): number;\nfunction charCodeAtAssert(...args: unknown[]): unknown {\n  return purry(orThrow(charCodeAtImplementation), args);\n}\n\n/**\n * Like `charCodeAt`, but throws when the index is out of bounds.\n *\n * @example\n * ```ts\n * charCodeAt.assert('hello', 0); // 104\n * charCodeAt.assert('hello', 10); // throws RangeError\n * ```\n */\ncharCodeAt.assert = charCodeAtAssert;\n","import { orThrow } from '../function/orThrow';\nimport { purry } from '../function/purry';\n\nfunction codePointAtImplementation(str: string, index: number): RangeError | number {\n  if (index >= str.length || index < -str.length) {\n    return new RangeError(`Str.codePointAt() :: Invalid index : ${index}`);\n  }\n\n  const adjustedIndex = index < 0 ? str.length + index : index;\n\n  return str.codePointAt(adjustedIndex)!;\n}\n\n/**\n * Returns the Unicode code point at an index, supporting negative indices from the end.\n * Returns a range error when the index is out of bounds.\n *\n * @example\n * ```ts\n * codePointAt('hello', 0); // 104\n * codePointAt(-1)('hello'); // 111\n * codePointAt('hello', 10); // RangeError\n * ```\n */\nexport function codePointAt(index: number): (str: string) => RangeError | number;\nexport function codePointAt(str: string, index: number): RangeError | number;\nexport function codePointAt(...args: unknown[]): unknown {\n  return purry(codePointAtImplementation, args);\n}\n\nfunction codePointAtAssert(index: number): (str: string) => number;\nfunction codePointAtAssert(str: string, index: number): number;\nfunction codePointAtAssert(...args: unknown[]): unknown {\n  return purry(orThrow(codePointAtImplementation), args);\n}\n\n/**\n * Like `codePointAt`, but throws when the index is out of bounds.\n *\n * @example\n * ```ts\n * codePointAt.assert('hello', 0); // 104\n * codePointAt.assert('hello', 10); // throws RangeError\n * ```\n */\ncodePointAt.assert = codePointAtAssert;\n","import type { Order } from '../order';\nimport { eq, gt, lt } from '../order';\n\n/**\n * Compares two strings lexicographically and returns their ordering.\n *\n * @example\n * ```ts\n * compare('a', 'b'); // -1\n * compare('b', 'b'); // 0\n * compare('c', 'b'); // 1\n * ```\n */\nexport function compare(left: string, right: string): Order {\n  if (left < right) return lt;\n  if (left > right) return gt;\n  return eq;\n}\n","import { NotYetImplementedError } from '../errors';\n\n/**\n * Concatenates two strings.\n *\n * @example\n * ```ts\n * concat('hello', ' world'); // throws NotYetImplementedError\n * ```\n */\n// eslint-disable-next-line @typescript-eslint/no-unused-vars\nexport function concat(str: string, other: string): string {\n  // TODO: need to think about how to handle the native's variable argument length\n  throw new NotYetImplementedError('Str.concat not yet implemented');\n}\n","import { purry } from '../function/purry';\n\nfunction endsWithImplementation(str: string, search: string): boolean {\n  return str.endsWith(search);\n}\n\n/**\n * Returns whether a string ends with a search string.\n *\n * @example\n * ```ts\n * endsWith('hello world', 'world'); // true\n * endsWith('hello')('hello world'); // false\n * ```\n */\nexport function endsWith(search: string): (str: string) => boolean;\nexport function endsWith(str: string, search: string): boolean;\nexport function endsWith(...args: unknown[]): unknown {\n  return purry(endsWithImplementation, args);\n}\n\nfunction endsWithPositionImplementation(str: string, search: string, position: number): boolean {\n  return str.endsWith(search, position);\n}\n\n/**\n * Returns whether a string ends with a search string at or before a position.\n *\n * @example\n * ```ts\n * endsWithPosition('hello world', 'hello', 5); // true\n * endsWithPosition(5, 'hello')('hello world'); // true\n * ```\n */\nexport function endsWithPosition(search: string, position: number): (str: string) => boolean;\nexport function endsWithPosition(str: string, search: string, position: number): boolean;\nexport function endsWithPosition(...args: unknown[]): unknown {\n  return purry(endsWithPositionImplementation, args);\n}\n","import { purry } from '../function/purry';\n\nfunction includesImplementation(str: string, search: string): boolean {\n  return str.includes(search);\n}\n\n/**\n * Returns whether a string contains a search string.\n *\n * @example\n * ```ts\n * includes('hello world', 'world'); // true\n * includes('xyz')('hello world'); // false\n * ```\n */\nexport function includes(search: string): (str: string) => boolean;\nexport function includes(str: string, search: string): boolean;\nexport function includes(...args: unknown[]): unknown {\n  return purry(includesImplementation, args);\n}\n\nfunction includesPositionImplementation(str: string, search: string, position: number): boolean {\n  return str.includes(search, position);\n}\n\n/**\n * Returns whether a string contains a search string at or after a position.\n *\n * @example\n * ```ts\n * includesPosition('hello world', 'world', 6); // true\n * includesPosition(6, 'world')('hello world'); // true\n * ```\n */\nexport function includesPosition(position: number, search: string): (str: string) => boolean;\nexport function includesPosition(str: string, search: string, position: number): boolean;\nexport function includesPosition(...args: unknown[]): unknown {\n  return purry(includesPositionImplementation, args);\n}\n","import { NotFoundError } from '../errors';\nimport { orThrow } from '../function/orThrow';\nimport { purry } from '../function/purry';\n\nfunction indexOfImplementation(str: string, search: string): NotFoundError | number {\n  const result = str.indexOf(search);\n  if (result === -1) {\n    return new NotFoundError(`Str.indexOf() :: \"${search}\" not found in \"${str}\"`);\n  }\n  return result;\n}\n\n/**\n * Returns the index of the first occurrence of a search string.\n * Returns a not-found error when the search string is absent.\n *\n * @example\n * ```ts\n * indexOf('hello world', 'world'); // 6\n * indexOf('world')('hello world'); // 6\n * indexOf('hello world', 'xyz'); // NotFoundError\n * ```\n */\nexport function indexOf(search: string): (str: string) => NotFoundError | number;\nexport function indexOf(str: string, search: string): NotFoundError | number;\nexport function indexOf(...args: unknown[]): unknown {\n  return purry(indexOfImplementation, args);\n}\n\nfunction indexOfAssert(search: string): (str: string) => number;\nfunction indexOfAssert(str: string, search: string): number;\nfunction indexOfAssert(...args: unknown[]): unknown {\n  return purry(orThrow(indexOfImplementation), args);\n}\n\n/**\n * Like `indexOf`, but throws when the search string is absent.\n *\n * @example\n * ```ts\n * indexOf.assert('hello world', 'world'); // 6\n * indexOf.assert('hello world', 'xyz'); // throws NotFoundError\n * ```\n */\nindexOf.assert = indexOfAssert;\n\nfunction indexOfPositionImplementation(str: string, search: string, position: number): NotFoundError | number {\n  return str.indexOf(search, position);\n}\n\n/**\n * Returns the index of the first occurrence of a search string at or after a position.\n *\n * @example\n * ```ts\n * indexOfPosition('hello world', 'o', 5); // 7\n * indexOfPosition(5, 'o')('hello world'); // 7\n * indexOfPosition('hello world', 'o', 8); // -1\n * ```\n */\nexport function indexOfPosition(position: number, search: string): (str: string) => NotFoundError | number;\nexport function indexOfPosition(str: string, search: string, position: number): NotFoundError | number;\nexport function indexOfPosition(...args: unknown[]): unknown {\n  return purry(indexOfPositionImplementation, args);\n}\n\nfunction indexOfPositionAssert(position: number, search: string): (str: string) => number;\nfunction indexOfPositionAssert(str: string, search: string, position: number): number;\nfunction indexOfPositionAssert(...args: unknown[]): unknown {\n  return purry(orThrow(indexOfPositionImplementation), args);\n}\n\n/**\n * Like `indexOfPosition`, but throws when the result is an error.\n *\n * @example\n * ```ts\n * indexOfPosition.assert('hello world', 'o', 5); // 7\n * indexOfPosition.assert('hello world', 'o', 8); // throws\n * ```\n */\nindexOfPosition.assert = indexOfPositionAssert;\n","/**\n * Returns whether a string has no characters.\n *\n * @example\n * ```ts\n * isEmpty(''); // true\n * isEmpty('hello'); // false\n * ```\n */\nexport function isEmpty(str: string): boolean {\n  return str.length === 0;\n}\n","/**\n * Returns whether a string is a well-formed Unicode string with no lone surrogates.\n *\n * @example\n * ```ts\n * isWellFormed('hello'); // true\n * isWellFormed('\\uD800'); // false\n * ```\n */\nexport function isWellFormed(str: string): boolean {\n  return str.isWellFormed();\n}\n","import { NotFoundError } from '../errors';\nimport { orThrow } from '../function/orThrow';\nimport { purry } from '../function/purry';\n\nfunction lastIndexOfImplementation(str: string, search: string): NotFoundError | number {\n  const result = str.lastIndexOf(search);\n  if (result === -1) {\n    return new NotFoundError(`Str.lastIndexOf() :: \"${search}\" not found in \"${str}\"`);\n  }\n  return result;\n}\n\n/**\n * Returns the index of the last occurrence of a search string.\n * Returns a not-found error when the search string is absent.\n *\n * @example\n * ```ts\n * lastIndexOf('hello world', 'o'); // 7\n * lastIndexOf('o')('hello world'); // 7\n * lastIndexOf('hello world', 'xyz'); // NotFoundError\n * ```\n */\nexport function lastIndexOf(search: string): (str: string) => NotFoundError | number;\nexport function lastIndexOf(str: string, search: string): NotFoundError | number;\nexport function lastIndexOf(...args: unknown[]): unknown {\n  return purry(lastIndexOfImplementation, args);\n}\n\nfunction lastIndexOfAssert(search: string): (str: string) => number;\nfunction lastIndexOfAssert(str: string, search: string): number;\nfunction lastIndexOfAssert(...args: unknown[]): unknown {\n  return purry(orThrow(lastIndexOfImplementation), args);\n}\n\n/**\n * Like `lastIndexOf`, but throws when the search string is absent.\n *\n * @example\n * ```ts\n * lastIndexOf.assert('hello world', 'o'); // 7\n * lastIndexOf.assert('hello world', 'xyz'); // throws NotFoundError\n * ```\n */\nlastIndexOf.assert = lastIndexOfAssert;\n\nfunction lastIndexOfPositionImplementation(str: string, search: string, position: number): NotFoundError | number {\n  const result = str.lastIndexOf(search, position);\n  if (result === -1) {\n    return new NotFoundError(`Str.lastIndexOf() :: \"${search}\" not found in \"${str}\" at position ${position}`);\n  }\n  return result;\n}\n\n/**\n * Returns the index of the last occurrence of a search string at or before a position.\n * Returns a not-found error when the search string is absent.\n *\n * @example\n * ```ts\n * lastIndexOfPosition('hello world', 'o', 6); // 4\n * lastIndexOfPosition(6, 'o')('hello world'); // 4\n * lastIndexOfPosition('hello world', 'o', 3); // NotFoundError\n * ```\n */\nexport function lastIndexOfPosition(position: number, search: string): (str: string) => NotFoundError | number;\nexport function lastIndexOfPosition(str: string, search: string, position: number): NotFoundError | number;\nexport function lastIndexOfPosition(...args: unknown[]): unknown {\n  return purry(lastIndexOfPositionImplementation, args);\n}\n\nfunction lastIndexOfPositionAssert(position: number, search: string): (str: string) => number;\nfunction lastIndexOfPositionAssert(str: string, search: string, position: number): number;\nfunction lastIndexOfPositionAssert(...args: unknown[]): unknown {\n  return purry(orThrow(lastIndexOfPositionImplementation), args);\n}\n\n/**\n * Like `lastIndexOfPosition`, but throws when the search string is absent.\n *\n * @example\n * ```ts\n * lastIndexOfPosition.assert('hello world', 'o', 6); // 4\n * lastIndexOfPosition.assert('hello world', 'o', 3); // throws NotFoundError\n * ```\n */\nlastIndexOfPosition.assert = lastIndexOfPositionAssert;\n","/**\n * Returns the length of a string in UTF-16 code units.\n *\n * @example\n * ```ts\n * length('hello'); // 5\n * length(''); // 0\n * ```\n */\nexport function length(str: string): number {\n  return str.length;\n}\n","import { NotYetImplementedError } from '../errors';\n\n/**\n * Compares two strings using locale-aware rules and returns a sort order number.\n *\n * @example\n * ```ts\n * localeCompare('a', 'b'); // throws NotYetImplementedError\n * ```\n */\n// eslint-disable-next-line @typescript-eslint/no-unused-vars\nexport function localeCompare(left: string, right: string): number {\n  throw new NotYetImplementedError('Str.localeCompare not yet implemented');\n}\n","import { purry } from '../function/purry';\n\n/**\n * Returns a Unicode-normalized string using NFC form.\n *\n * @example\n * ```ts\n * normalize('café'); // 'café'\n * ```\n */\nexport function normalize(str: string): string {\n  return str.normalize();\n}\n\nfunction normalizeFormImplementation(str: string, form: 'NFC' | 'NFD' | 'NFKC' | 'NFKD'): string {\n  return str.normalize(form);\n}\n\n/**\n * Returns a Unicode-normalized string using the given normalization form.\n *\n * @example\n * ```ts\n * normalizeForm('café', 'NFD'); // decomposed form\n * normalizeForm('NFD')('café'); // decomposed form\n * ```\n */\nexport function normalizeForm(form: 'NFC' | 'NFD' | 'NFKC' | 'NFKD'): (str: string) => string;\nexport function normalizeForm(str: string, form: 'NFC' | 'NFD' | 'NFKC' | 'NFKD'): string;\nexport function normalizeForm(...args: unknown[]): unknown {\n  return purry(normalizeFormImplementation, args);\n}\n","import { purry } from '../function/purry';\n\nfunction padEndImplementation(str: string, targetLength: number, padString: string): string {\n  return str.padEnd(targetLength, padString);\n}\n\n/**\n * Pads the end of a string until it reaches a target length.\n *\n * @example\n * ```ts\n * padEnd('5', 3, '0'); // '500'\n * padEnd(3, '0')('5'); // '500'\n * ```\n */\nexport function padEnd(targetLength: number, padString: string): (str: string) => string;\nexport function padEnd(str: string, targetLength: number, padString: string): string;\nexport function padEnd(...args: unknown[]): unknown {\n  return purry(padEndImplementation, args);\n}\n","import { purry } from '../function/purry';\n\nfunction padStartImplementation(str: string, targetLength: number, padString: string): string {\n  return str.padStart(targetLength, padString);\n}\n\n/**\n * Pads the start of a string until it reaches a target length.\n *\n * @example\n * ```ts\n * padStart('5', 3, '0'); // '005'\n * padStart(3, '0')('5'); // '005'\n * ```\n */\nexport function padStart(targetLength: number, padString: string): (str: string) => string;\nexport function padStart(str: string, targetLength: number, padString: string): string;\nexport function padStart(...args: unknown[]): unknown {\n  return purry(padStartImplementation, args);\n}\n","import { purry } from '../function/purry';\n\nfunction repeatImplementation(str: string, count: number): string {\n  return str.repeat(count);\n}\n\n/**\n * Returns a string repeated a given number of times.\n *\n * @example\n * ```ts\n * repeat('ab', 3); // 'ababab'\n * repeat(3)('ab'); // 'ababab'\n * ```\n */\nexport function repeat(count: number): (str: string) => string;\nexport function repeat(str: string, count: number): string;\nexport function repeat(...args: unknown[]): unknown {\n  return purry(repeatImplementation, args);\n}\n","import { NotYetImplementedError } from '../errors';\n\n/**\n * Replaces the first match of a search value in a string.\n *\n * @example\n * ```ts\n * replace('hello world', 'world', 'there'); // throws NotYetImplementedError\n * ```\n */\n// eslint-disable-next-line @typescript-eslint/no-unused-vars\nexport function replace(str: string, searchValue: RegExp | string, replaceValue: string): string {\n  throw new NotYetImplementedError('Str.replace not yet implemented');\n}\n\n/**\n * Replaces all matches of a search value in a string.\n *\n * @example\n * ```ts\n * replaceAll('hello world', 'l', 'L'); // throws NotYetImplementedError\n * ```\n */\n// eslint-disable-next-line @typescript-eslint/no-unused-vars\nexport function replaceAll(str: string, searchValue: RegExp | string, replacement: string): string {\n  throw new NotYetImplementedError('Str.replace not yet implemented');\n}\n","import { NotFoundError } from '../errors';\nimport { purry } from '../function';\nimport { orThrow } from '../function/orThrow';\n\nfunction searchImplementation(\n  str: string,\n  searcher: { [Symbol.search](string: string): number },\n): NotFoundError | number {\n  const result = str.search(searcher);\n  if (result === -1) {\n    // eslint-disable-next-line @typescript-eslint/no-base-to-string, @typescript-eslint/restrict-template-expressions\n    return new NotFoundError(`Str.search() :: \"${searcher}\" not found in \"${str}\"`);\n  }\n  return result;\n}\n\n/**\n * Returns the index of the first match for a searcher (string or regular expression).\n * Returns a not-found error when there is no match.\n *\n * @example\n * ```ts\n * search('hello world', /world/); // 6\n * search(/world/)('hello world'); // 6\n * search('hello world', /xyz/); // NotFoundError\n * ```\n */\nexport function search(searcher: { [Symbol.search](string: string): number }): (str: string) => NotFoundError | number;\nexport function search(str: string, searcher: { [Symbol.search](string: string): number }): NotFoundError | number;\nexport function search(...args: unknown[]): unknown {\n  return purry(searchImplementation, args);\n}\n\nfunction searchAssert(searcher: { [Symbol.search](string: string): number }): (str: string) => number;\nfunction searchAssert(str: string, searcher: { [Symbol.search](string: string): number }): number;\nfunction searchAssert(...args: unknown[]): unknown {\n  return purry(orThrow(searchImplementation), args);\n}\n\n/**\n * Like `search`, but throws when there is no match.\n *\n * @example\n * ```ts\n * search.assert('hello world', /world/); // 6\n * search.assert('hello world', /xyz/); // throws NotFoundError\n * ```\n */\nsearch.assert = searchAssert;\n","import { purry } from '../function/purry';\n\nfunction sliceImplementation(str: string, start: number): string {\n  return str.slice(start);\n}\n\n/**\n * Returns a substring from a start index to the end.\n *\n * @example\n * ```ts\n * slice('hello', 1); // 'ello'\n * slice(1)('hello'); // 'ello'\n * ```\n */\nexport function slice(start: number): (str: string) => string;\nexport function slice(str: string, start: number): string;\nexport function slice(...args: unknown[]): unknown {\n  return purry(sliceImplementation, args);\n}\n\nfunction sliceEndImplementation(str: string, start: number, end: number): string {\n  return str.slice(start, end);\n}\n\n/**\n * Returns a substring between start and end indices.\n *\n * @example\n * ```ts\n * sliceEnd('hello', 1, 4); // 'ell'\n * sliceEnd(4)(1)('hello'); // 'ell'\n * ```\n */\nexport function sliceEnd(end: number): (str: string, start: number) => string;\nexport function sliceEnd(str: string, start: number, end: number): string;\nexport function sliceEnd(...args: unknown[]): unknown {\n  return purry(sliceEndImplementation, args);\n}\n","import { purry } from '../function/purry';\n\nfunction splitImplementation(str: string, separator: string): string[] {\n  return str.split(separator);\n}\n\n/**\n * Splits a string into substrings using a separator.\n *\n * @example\n * ```ts\n * split('a,b,c', ','); // ['a', 'b', 'c']\n * split(',')('a,b,c'); // ['a', 'b', 'c']\n * ```\n */\nexport function split(separator: string): (str: string) => string[];\nexport function split(str: string, separator: string): string[];\nexport function split(...args: unknown[]): unknown {\n  return purry(splitImplementation, args);\n}\n\nfunction splitLimitImplementation(str: string, separator: string, limit: number): string[] {\n  return str.split(separator, limit);\n}\n\n/**\n * Splits a string into at most `limit` substrings using a separator.\n *\n * @example\n * ```ts\n * splitLimit('a,b,c', ',', 2); // ['a', 'b']\n * splitLimit(',', 2)('a,b,c'); // ['a', 'b']\n * ```\n */\nexport function splitLimit(separator: string, limit: number): (str: string) => string[];\nexport function splitLimit(str: string, separator: string, limit: number): string[];\nexport function splitLimit(...args: unknown[]): unknown {\n  return purry(splitLimitImplementation, args);\n}\n","import { purry } from '../function/purry';\n\nfunction startsWithImplementation(str: string, search: string): boolean {\n  return str.startsWith(search);\n}\n\n/**\n * Returns whether a string starts with a search string.\n *\n * @example\n * ```ts\n * startsWith('hello world', 'hello'); // true\n * startsWith('world')('hello world'); // false\n * ```\n */\nexport function startsWith(search: string): (str: string) => boolean;\nexport function startsWith(str: string, search: string): boolean;\nexport function startsWith(...args: unknown[]): unknown {\n  return purry(startsWithImplementation, args);\n}\n\nfunction startsWithPositionImplementation(str: string, search: string, position: number): boolean {\n  return str.startsWith(search, position);\n}\n\n/**\n * Returns whether a string starts with a search string at or after a position.\n *\n * @example\n * ```ts\n * startsWithPosition('hello world', 'world', 6); // true\n * startsWithPosition(6, 'world')('hello world'); // true\n * ```\n */\nexport function startsWithPosition(search: string, position: number): (str: string) => boolean;\nexport function startsWithPosition(str: string, search: string, position: number): boolean;\nexport function startsWithPosition(...args: unknown[]): unknown {\n  return purry(startsWithPositionImplementation, args);\n}\n","import { purry } from '../function/purry';\n\nfunction substringImplementation(str: string, start: number, end: number): string {\n  return str.substring(start, end);\n}\n\n/**\n * Returns the substring between start and end indices.\n *\n * @example\n * ```ts\n * substring('hello', 1, 4); // 'ell'\n * substring(1, 4)('hello'); // 'ell'\n * ```\n */\nexport function substring(start: number, end: number): (str: string) => string;\nexport function substring(str: string, start: number, end: number): string;\nexport function substring(...args: unknown[]): unknown {\n  return purry(substringImplementation, args);\n}\n\nfunction substringEndImplementation(str: string, start: number, end: number): string {\n  return str.substring(start, end);\n}\n\n/**\n * Returns the substring between start and end indices.\n *\n * @example\n * ```ts\n * substringEnd('hello', 1, 4); // 'ell'\n * substringEnd(1, 4)('hello'); // 'ell'\n * ```\n */\nexport function substringEnd(start: number, end: number): (str: string) => string;\nexport function substringEnd(str: string, start: number, end: number): string;\nexport function substringEnd(...args: unknown[]): unknown {\n  return purry(substringEndImplementation, args);\n}\n","import { NotYetImplementedError } from '../errors';\n\n/**\n * Returns a string with all characters converted to locale-aware lowercase.\n *\n * @example\n * ```ts\n * toLocaleLowerCase('STRASSE'); // throws NotYetImplementedError\n * ```\n */\n// eslint-disable-next-line @typescript-eslint/no-unused-vars\nexport function toLocaleLowerCase(str: string): string {\n  throw new NotYetImplementedError('Str.toLocaleLowerCase not yet implemented');\n}\n","import { NotYetImplementedError } from '../errors';\n\n/**\n * Returns a string with all characters converted to locale-aware uppercase.\n *\n * @example\n * ```ts\n * toLocaleUpperCase('straße'); // throws NotYetImplementedError\n * ```\n */\n// eslint-disable-next-line @typescript-eslint/no-unused-vars\nexport function toLocaleUpperCase(str: string): string {\n  throw new NotYetImplementedError('Str.toLocaleUpperCase not yet implemented');\n}\n","/**\n * Returns a string with all characters converted to lowercase.\n *\n * @example\n * ```ts\n * toLowerCase('HELLO'); // 'hello'\n * ```\n */\nexport function toLowerCase(str: string): string {\n  return str.toLowerCase();\n}\n","/**\n * Returns a string with all characters converted to uppercase.\n *\n * @example\n * ```ts\n * toUpperCase('hello'); // 'HELLO'\n * ```\n */\nexport function toUpperCase(str: string): string {\n  return str.toUpperCase();\n}\n","/**\n * Returns a well-formed Unicode string by replacing lone surrogates with replacement characters.\n *\n * @example\n * ```ts\n * toWellFormed('\\uD800'); // '\\uFFFD'\n * toWellFormed('hello'); // 'hello'\n * ```\n */\nexport function toWellFormed(str: string): string {\n  return str.toWellFormed();\n}\n","/**\n * Removes leading and trailing whitespace from a string.\n *\n * @example\n * ```ts\n * trim('  hello  '); // 'hello'\n * ```\n */\nexport function trim(str: string): string {\n  return str.trim();\n}\n\n/**\n * Removes trailing whitespace from a string.\n *\n * @example\n * ```ts\n * trimEnd('  hello  '); // '  hello'\n * ```\n */\nexport function trimEnd(str: string): string {\n  return str.trimEnd();\n}\n\n/**\n * Removes leading whitespace from a string.\n *\n * @example\n * ```ts\n * trimStart('  hello  '); // 'hello  '\n * ```\n */\nexport function trimStart(str: string): string {\n  return str.trimStart();\n}\n"],"mappings":";;;;;AAGA,SAAS,iBAAiB,KAAa,OAAoC;CACzE,IAAI,SAAS,IAAI,UAAU,QAAQ,CAAC,IAAI,QACtC,uBAAO,IAAI,WAAW,+BAA+B,OAAO;CAG9D,OAAO,IAAI,GAAG,KAAK;AACrB;AAeA,SAAgB,GAAG,GAAG,MAA0B;CAC9C,OAAO,MAAM,kBAAkB,IAAI;AACrC;AAIA,SAAS,SAAS,GAAG,MAA0B;CAC7C,OAAO,MAAM,QAAQ,gBAAgB,GAAG,IAAI;AAC9C;;;;;;;;;;AAWA,GAAG,SAAS;;;ACxCZ,SAAS,yBAAyB,KAAa,OAAoC;CACjF,IAAI,SAAS,IAAI,UAAU,QAAQ,CAAC,IAAI,QACtC,uBAAO,IAAI,WAAW,uCAAuC,OAAO;CAGtE,MAAM,gBAAgB,QAAQ,IAAI,IAAI,SAAS,QAAQ;CAEvD,OAAO,IAAI,WAAW,aAAa;AACrC;AAeA,SAAgB,WAAW,GAAG,MAA0B;CACtD,OAAO,MAAM,0BAA0B,IAAI;AAC7C;AAIA,SAAS,iBAAiB,GAAG,MAA0B;CACrD,OAAO,MAAM,QAAQ,wBAAwB,GAAG,IAAI;AACtD;;;;;;;;;;AAWA,WAAW,SAAS;;;AC1CpB,SAAS,0BAA0B,KAAa,OAAoC;CAClF,IAAI,SAAS,IAAI,UAAU,QAAQ,CAAC,IAAI,QACtC,uBAAO,IAAI,WAAW,wCAAwC,OAAO;CAGvE,MAAM,gBAAgB,QAAQ,IAAI,IAAI,SAAS,QAAQ;CAEvD,OAAO,IAAI,YAAY,aAAa;AACtC;AAeA,SAAgB,YAAY,GAAG,MAA0B;CACvD,OAAO,MAAM,2BAA2B,IAAI;AAC9C;AAIA,SAAS,kBAAkB,GAAG,MAA0B;CACtD,OAAO,MAAM,QAAQ,yBAAyB,GAAG,IAAI;AACvD;;;;;;;;;;AAWA,YAAY,SAAS;;;;;;;;;;;;;AChCrB,SAAgB,QAAQ,MAAc,OAAsB;CAC1D,IAAI,OAAO,OAAO,OAAA;CAClB,IAAI,OAAO,OAAO,OAAA;CAClB,OAAA;AACF;;;;;;;;;;;ACNA,SAAgB,OAAO,KAAa,OAAuB;CAEzD,MAAM,IAAI,uBAAuB,gCAAgC;AACnE;;;ACZA,SAAS,uBAAuB,KAAa,QAAyB;CACpE,OAAO,IAAI,SAAS,MAAM;AAC5B;AAaA,SAAgB,SAAS,GAAG,MAA0B;CACpD,OAAO,MAAM,wBAAwB,IAAI;AAC3C;AAEA,SAAS,+BAA+B,KAAa,QAAgB,UAA2B;CAC9F,OAAO,IAAI,SAAS,QAAQ,QAAQ;AACtC;AAaA,SAAgB,iBAAiB,GAAG,MAA0B;CAC5D,OAAO,MAAM,gCAAgC,IAAI;AACnD;;;ACpCA,SAAS,uBAAuB,KAAa,QAAyB;CACpE,OAAO,IAAI,SAAS,MAAM;AAC5B;AAaA,SAAgB,SAAS,GAAG,MAA0B;CACpD,OAAO,MAAM,wBAAwB,IAAI;AAC3C;AAEA,SAAS,+BAA+B,KAAa,QAAgB,UAA2B;CAC9F,OAAO,IAAI,SAAS,QAAQ,QAAQ;AACtC;AAaA,SAAgB,iBAAiB,GAAG,MAA0B;CAC5D,OAAO,MAAM,gCAAgC,IAAI;AACnD;;;AClCA,SAAS,sBAAsB,KAAa,QAAwC;CAClF,MAAM,SAAS,IAAI,QAAQ,MAAM;CACjC,IAAI,WAAW,IACb,OAAO,IAAI,cAAc,qBAAqB,OAAO,kBAAkB,IAAI,EAAE;CAE/E,OAAO;AACT;AAeA,SAAgB,QAAQ,GAAG,MAA0B;CACnD,OAAO,MAAM,uBAAuB,IAAI;AAC1C;AAIA,SAAS,cAAc,GAAG,MAA0B;CAClD,OAAO,MAAM,QAAQ,qBAAqB,GAAG,IAAI;AACnD;;;;;;;;;;AAWA,QAAQ,SAAS;AAEjB,SAAS,8BAA8B,KAAa,QAAgB,UAA0C;CAC5G,OAAO,IAAI,QAAQ,QAAQ,QAAQ;AACrC;AAcA,SAAgB,gBAAgB,GAAG,MAA0B;CAC3D,OAAO,MAAM,+BAA+B,IAAI;AAClD;AAIA,SAAS,sBAAsB,GAAG,MAA0B;CAC1D,OAAO,MAAM,QAAQ,6BAA6B,GAAG,IAAI;AAC3D;;;;;;;;;;AAWA,gBAAgB,SAAS;;;;;;;;;;;;ACxEzB,SAAgB,QAAQ,KAAsB;CAC5C,OAAO,IAAI,WAAW;AACxB;;;;;;;;;;;;ACFA,SAAgB,aAAa,KAAsB;CACjD,OAAO,IAAI,aAAa;AAC1B;;;ACPA,SAAS,0BAA0B,KAAa,QAAwC;CACtF,MAAM,SAAS,IAAI,YAAY,MAAM;CACrC,IAAI,WAAW,IACb,OAAO,IAAI,cAAc,yBAAyB,OAAO,kBAAkB,IAAI,EAAE;CAEnF,OAAO;AACT;AAeA,SAAgB,YAAY,GAAG,MAA0B;CACvD,OAAO,MAAM,2BAA2B,IAAI;AAC9C;AAIA,SAAS,kBAAkB,GAAG,MAA0B;CACtD,OAAO,MAAM,QAAQ,yBAAyB,GAAG,IAAI;AACvD;;;;;;;;;;AAWA,YAAY,SAAS;AAErB,SAAS,kCAAkC,KAAa,QAAgB,UAA0C;CAChH,MAAM,SAAS,IAAI,YAAY,QAAQ,QAAQ;CAC/C,IAAI,WAAW,IACb,OAAO,IAAI,cAAc,yBAAyB,OAAO,kBAAkB,IAAI,gBAAgB,UAAU;CAE3G,OAAO;AACT;AAeA,SAAgB,oBAAoB,GAAG,MAA0B;CAC/D,OAAO,MAAM,mCAAmC,IAAI;AACtD;AAIA,SAAS,0BAA0B,GAAG,MAA0B;CAC9D,OAAO,MAAM,QAAQ,iCAAiC,GAAG,IAAI;AAC/D;;;;;;;;;;AAWA,oBAAoB,SAAS;;;;;;;;;;;;AC7E7B,SAAgB,OAAO,KAAqB;CAC1C,OAAO,IAAI;AACb;;;;;;;;;;;ACAA,SAAgB,cAAc,MAAc,OAAuB;CACjE,MAAM,IAAI,uBAAuB,uCAAuC;AAC1E;;;;;;;;;;;ACHA,SAAgB,UAAU,KAAqB;CAC7C,OAAO,IAAI,UAAU;AACvB;AAEA,SAAS,4BAA4B,KAAa,MAA+C;CAC/F,OAAO,IAAI,UAAU,IAAI;AAC3B;AAaA,SAAgB,cAAc,GAAG,MAA0B;CACzD,OAAO,MAAM,6BAA6B,IAAI;AAChD;;;AC7BA,SAAS,qBAAqB,KAAa,cAAsB,WAA2B;CAC1F,OAAO,IAAI,OAAO,cAAc,SAAS;AAC3C;AAaA,SAAgB,OAAO,GAAG,MAA0B;CAClD,OAAO,MAAM,sBAAsB,IAAI;AACzC;;;ACjBA,SAAS,uBAAuB,KAAa,cAAsB,WAA2B;CAC5F,OAAO,IAAI,SAAS,cAAc,SAAS;AAC7C;AAaA,SAAgB,SAAS,GAAG,MAA0B;CACpD,OAAO,MAAM,wBAAwB,IAAI;AAC3C;;;ACjBA,SAAS,qBAAqB,KAAa,OAAuB;CAChE,OAAO,IAAI,OAAO,KAAK;AACzB;AAaA,SAAgB,OAAO,GAAG,MAA0B;CAClD,OAAO,MAAM,sBAAsB,IAAI;AACzC;;;;;;;;;;;ACRA,SAAgB,QAAQ,KAAa,aAA8B,cAA8B;CAC/F,MAAM,IAAI,uBAAuB,iCAAiC;AACpE;;;;;;;;;AAWA,SAAgB,WAAW,KAAa,aAA8B,aAA6B;CACjG,MAAM,IAAI,uBAAuB,iCAAiC;AACpE;;;ACtBA,SAAS,qBACP,KACA,UACwB;CACxB,MAAM,SAAS,IAAI,OAAO,QAAQ;CAClC,IAAI,WAAW,IAEb,OAAO,IAAI,cAAc,oBAAoB,SAAS,kBAAkB,IAAI,EAAE;CAEhF,OAAO;AACT;AAeA,SAAgB,OAAO,GAAG,MAA0B;CAClD,OAAO,MAAM,sBAAsB,IAAI;AACzC;AAIA,SAAS,aAAa,GAAG,MAA0B;CACjD,OAAO,MAAM,QAAQ,oBAAoB,GAAG,IAAI;AAClD;;;;;;;;;;AAWA,OAAO,SAAS;;;AC9ChB,SAAS,oBAAoB,KAAa,OAAuB;CAC/D,OAAO,IAAI,MAAM,KAAK;AACxB;AAaA,SAAgB,MAAM,GAAG,MAA0B;CACjD,OAAO,MAAM,qBAAqB,IAAI;AACxC;AAEA,SAAS,uBAAuB,KAAa,OAAe,KAAqB;CAC/E,OAAO,IAAI,MAAM,OAAO,GAAG;AAC7B;AAaA,SAAgB,SAAS,GAAG,MAA0B;CACpD,OAAO,MAAM,wBAAwB,IAAI;AAC3C;;;ACpCA,SAAS,oBAAoB,KAAa,WAA6B;CACrE,OAAO,IAAI,MAAM,SAAS;AAC5B;AAaA,SAAgB,MAAM,GAAG,MAA0B;CACjD,OAAO,MAAM,qBAAqB,IAAI;AACxC;AAEA,SAAS,yBAAyB,KAAa,WAAmB,OAAyB;CACzF,OAAO,IAAI,MAAM,WAAW,KAAK;AACnC;AAaA,SAAgB,WAAW,GAAG,MAA0B;CACtD,OAAO,MAAM,0BAA0B,IAAI;AAC7C;;;ACpCA,SAAS,yBAAyB,KAAa,QAAyB;CACtE,OAAO,IAAI,WAAW,MAAM;AAC9B;AAaA,SAAgB,WAAW,GAAG,MAA0B;CACtD,OAAO,MAAM,0BAA0B,IAAI;AAC7C;AAEA,SAAS,iCAAiC,KAAa,QAAgB,UAA2B;CAChG,OAAO,IAAI,WAAW,QAAQ,QAAQ;AACxC;AAaA,SAAgB,mBAAmB,GAAG,MAA0B;CAC9D,OAAO,MAAM,kCAAkC,IAAI;AACrD;;;ACpCA,SAAS,wBAAwB,KAAa,OAAe,KAAqB;CAChF,OAAO,IAAI,UAAU,OAAO,GAAG;AACjC;AAaA,SAAgB,UAAU,GAAG,MAA0B;CACrD,OAAO,MAAM,yBAAyB,IAAI;AAC5C;AAEA,SAAS,2BAA2B,KAAa,OAAe,KAAqB;CACnF,OAAO,IAAI,UAAU,OAAO,GAAG;AACjC;AAaA,SAAgB,aAAa,GAAG,MAA0B;CACxD,OAAO,MAAM,4BAA4B,IAAI;AAC/C;;;;;;;;;;;AC3BA,SAAgB,kBAAkB,KAAqB;CACrD,MAAM,IAAI,uBAAuB,2CAA2C;AAC9E;;;;;;;;;;;ACFA,SAAgB,kBAAkB,KAAqB;CACrD,MAAM,IAAI,uBAAuB,2CAA2C;AAC9E;;;;;;;;;;;ACLA,SAAgB,YAAY,KAAqB;CAC/C,OAAO,IAAI,YAAY;AACzB;;;;;;;;;;;ACFA,SAAgB,YAAY,KAAqB;CAC/C,OAAO,IAAI,YAAY;AACzB;;;;;;;;;;;;ACDA,SAAgB,aAAa,KAAqB;CAChD,OAAO,IAAI,aAAa;AAC1B;;;;;;;;;;;ACHA,SAAgB,KAAK,KAAqB;CACxC,OAAO,IAAI,KAAK;AAClB;;;;;;;;;AAUA,SAAgB,QAAQ,KAAqB;CAC3C,OAAO,IAAI,QAAQ;AACrB;;;;;;;;;AAUA,SAAgB,UAAU,KAAqB;CAC7C,OAAO,IAAI,UAAU;AACvB"}

package/dist/tuple/index.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_purry = require("../purry-B2_0DGLV.cjs");
+const require_purry = require("../purry-Dqp_F64t.cjs");
 //#region src/tuple/at.ts
 function at2Implementation(tuple, index) {
 	if (index < 0) throw new RangeError(`Tuple.at() :: ${index} must be a positive integer`);
@@ -18,19 +18,29 @@ function fanOut(...args) {
 	return require_purry.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");
@@ -46,9 +56,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])];
 }
@@ -65,9 +72,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]];
 }
@@ -86,16 +90,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");
@@ -106,9 +107,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]
@@ -122,6 +120,7 @@ exports.at = at;
 exports.fanOut = fanOut;
 exports.fanOutImplementation = fanOutImplementation;
 exports.first = first;
+exports.from = from;
 exports.insert = insert;
 exports.mapBoth = mapBoth;
 exports.mapBothImplementation = mapBothImplementation;