@akterjs/cli 0.0.0-stage → 0.1.0

package/dist/String-q5dcsVe4.mjs

@@ -0,0 +1,351 @@
+import { bn as dual, i as filter, w as some } from "./Option-DkxSnBhp.mjs";
+import { lt as isArrayNonEmpty } from "./Array-B4kuTQeW.mjs";
+import { t as isGreaterThanOrEqualTo } from "./Number-BvkRkfc-.mjs";
+import { a as String$1 } from "./Order-C1JC991I.mjs";
+globalThis.String;
+/**
+* Provides an `Order` instance for comparing strings using lexicographic
+* ordering.
+*
+* **Example** (Comparing strings lexicographically)
+*
+* ```ts import.meta.vitest
+* import { String } from "effect"
+*
+* String.Order("apple", "banana") // => -1
+* String.Order("banana", "apple") // => 1
+* String.Order("apple", "apple") // => 0
+* ```
+*
+* @stability stable
+* @category instances
+* @since 2.0.0
+*/
+const Order = String$1;
+/**
+* Converts a string to uppercase.
+*
+* **Example** (Converting strings to uppercase)
+*
+* ```ts import.meta.vitest
+* import { pipe, String } from "effect"
+*
+* pipe("a", String.toUpperCase) // => "A"
+* String.toUpperCase("hello") // => "HELLO"
+* ```
+*
+* @stability stable
+* @category transforming
+* @since 2.0.0
+*/
+const toUpperCase = (self) => self.toUpperCase();
+/**
+* Converts a string to lowercase.
+*
+* **Example** (Converting strings to lowercase)
+*
+* ```ts import.meta.vitest
+* import { pipe, String } from "effect"
+*
+* pipe("A", String.toLowerCase) // => "a"
+* String.toLowerCase("HELLO") // => "hello"
+* ```
+*
+* @stability stable
+* @category transforming
+* @since 2.0.0
+*/
+const toLowerCase = (self) => self.toLowerCase();
+/**
+* Replaces matches in a string using `String.prototype.replace`.
+*
+* **Details**
+*
+* String search values and non-global regular expressions replace the first
+* match; global regular expressions replace every match.
+*
+* **Example** (Replacing a substring)
+*
+* ```ts import.meta.vitest
+* import { pipe, String } from "effect"
+*
+* pipe("abc", String.replace("b", "d")) // => "adc"
+* pipe("hello world", String.replace("world", "Effect")) // => "hello Effect"
+* ```
+*
+* @stability stable
+* @category transforming
+* @since 2.0.0
+*/
+const replace = (searchValue, replaceValue) => (self) => self.replace(searchValue, replaceValue);
+/**
+* Removes whitespace from both ends of a string.
+*
+* **Example** (Trimming whitespace)
+*
+* ```ts import.meta.vitest
+* import { String } from "effect"
+*
+* String.trim(" a ") // => "a"
+* String.trim("  hello world  ") // => "hello world"
+* ```
+*
+* @stability stable
+* @category transforming
+* @since 2.0.0
+*/
+const trim = (self) => self.trim();
+/**
+* Removes whitespace from the end of a string.
+*
+* **Example** (Trimming trailing whitespace)
+*
+* ```ts import.meta.vitest
+* import { String } from "effect"
+*
+* String.trimEnd(" a ") // => " a"
+* String.trimEnd("hello world  ") // => "hello world"
+* ```
+*
+* @stability stable
+* @category transforming
+* @since 2.0.0
+*/
+const trimEnd = (self) => self.trimEnd();
+/**
+* Extracts a section of a string and returns it as a new string.
+*
+* **Example** (Slicing strings)
+*
+* ```ts import.meta.vitest
+* import { pipe, String } from "effect"
+*
+* pipe("abcd", String.slice(1, 3)) // => "bc"
+* pipe("hello world", String.slice(0, 5)) // => "hello"
+* ```
+*
+* @stability stable
+* @category transforming
+* @since 2.0.0
+*/
+const slice = (start, end) => (self) => self.slice(start, end);
+/**
+* Checks whether a `string` is empty.
+*
+* **Example** (Checking for empty strings)
+*
+* ```ts import.meta.vitest
+* import { String } from "effect"
+*
+* String.isEmpty("") // => true
+* String.isEmpty("a") // => false
+* ```
+*
+* @stability stable
+* @category guards
+* @since 2.0.0
+*/
+const isEmpty = (self) => self.length === 0;
+/**
+* Checks whether a `string` is non-empty.
+*
+* **Example** (Checking for non-empty strings)
+*
+* ```ts import.meta.vitest
+* import { String } from "effect"
+*
+* String.isNonEmpty("") // => false
+* String.isNonEmpty("a") // => true
+* ```
+*
+* @stability stable
+* @category predicates
+* @since 2.0.0
+*/
+const isNonEmpty = (self) => self.length > 0;
+/**
+* Splits a string into an array of substrings using a separator.
+*
+* **Example** (Splitting strings)
+*
+* ```ts import.meta.vitest
+* import { pipe, String } from "effect"
+*
+* pipe("abc", String.split("")) // => ["a", "b", "c"]
+* pipe("", String.split("")) // => [""]
+* String.split("hello,world", ",") // => ["hello", "world"]
+* ```
+*
+* @stability stable
+* @category transforming
+* @since 2.0.0
+*/
+const split = /*#__PURE__*/ dual(2, (self, separator) => {
+	const out = self.split(separator);
+	return isArrayNonEmpty(out) ? out : [self];
+});
+/**
+* Returns `true` if `searchString` appears as a substring of `self`, at one or more positions that are
+* greater than or equal to `position`; otherwise, returns `false`.
+*
+* **Example** (Checking for substrings)
+*
+* ```ts import.meta.vitest
+* import { pipe, String } from "effect"
+*
+* pipe("hello world", String.includes("world")) // => true
+* pipe("hello world", String.includes("foo")) // => false
+* ```
+*
+* @stability stable
+* @category predicates
+* @since 2.0.0
+*/
+const includes = (searchString, position) => (self) => self.includes(searchString, position);
+/**
+* Returns `true` if the string starts with the specified search string.
+*
+* **Example** (Checking string prefixes)
+*
+* ```ts import.meta.vitest
+* import { pipe, String } from "effect"
+*
+* pipe("hello world", String.startsWith("hello")) // => true
+* pipe("hello world", String.startsWith("world")) // => false
+* ```
+*
+* @stability stable
+* @category predicates
+* @since 2.0.0
+*/
+const startsWith = (searchString, position) => (self) => self.startsWith(searchString, position);
+/**
+* Returns `true` if the string ends with the specified search string.
+*
+* **Example** (Checking string suffixes)
+*
+* ```ts import.meta.vitest
+* import { pipe, String } from "effect"
+*
+* pipe("hello world", String.endsWith("world")) // => true
+* pipe("hello world", String.endsWith("hello")) // => false
+* ```
+*
+* @stability stable
+* @category predicates
+* @since 2.0.0
+*/
+const endsWith = (searchString, position) => (self) => self.endsWith(searchString, position);
+/**
+* Returns the index of the first occurrence of a substring safely, or `None` if not found.
+*
+* **Example** (Finding the first substring index)
+*
+* ```ts import.meta.vitest
+* import { Option, pipe, String } from "effect"
+*
+* pipe("abbbc", String.indexOf("b")) // => Option.some(1)
+* pipe("abbbc", String.indexOf("z")) // => Option.none()
+* ```
+*
+* @stability stable
+* @category searching
+* @since 2.0.0
+*/
+const indexOf = (searchString) => (self) => filter(some(self.indexOf(searchString)), isGreaterThanOrEqualTo(0));
+/**
+* Normalizes a string according to the specified Unicode normalization form.
+*
+* **Example** (Normalizing Unicode strings)
+*
+* ```ts import.meta.vitest
+* import { pipe, String } from "effect"
+*
+* const str = "\u1E9B\u0323"
+* Array.from(pipe(str, String.normalize()), (character) => character.codePointAt(0)) // => [0x1e9b, 0x323]
+* Array.from(pipe(str, String.normalize("NFC")), (character) => character.codePointAt(0)) // => [0x1e9b, 0x323]
+* Array.from(
+*   pipe(str, String.normalize("NFD")),
+*   (character) => character.codePointAt(0)
+* ) // => [0x17f, 0x323, 0x307]
+* Array.from(pipe(str, String.normalize("NFKC")), (character) => character.codePointAt(0)) // => [0x1e69]
+* Array.from(
+*   pipe(str, String.normalize("NFKD")),
+*   (character) => character.codePointAt(0)
+* ) // => [0x73, 0x323, 0x307]
+* ```
+*
+* @stability stable
+* @category transforming
+* @since 2.0.0
+*/
+const normalize = (form) => (self) => self.normalize(form);
+/**
+* Pads the string from the end with a given fill string to a specified length.
+*
+* **Example** (Padding strings at the end)
+*
+* ```ts import.meta.vitest
+* import { pipe, String } from "effect"
+*
+* pipe("a", String.padEnd(5)) // => "a    "
+* pipe("a", String.padEnd(5, "_")) // => "a____"
+* ```
+*
+* @stability stable
+* @category transforming
+* @since 2.0.0
+*/
+const padEnd = (maxLength, fillString) => (self) => self.padEnd(maxLength, fillString);
+/**
+* Pads the string from the start with a given fill string to a specified length.
+*
+* **Example** (Padding strings at the start)
+*
+* ```ts import.meta.vitest
+* import { pipe, String } from "effect"
+*
+* pipe("a", String.padStart(5)) // => "    a"
+* pipe("a", String.padStart(5, "_")) // => "____a"
+* ```
+*
+* @stability stable
+* @category transforming
+* @since 2.0.0
+*/
+const padStart = (maxLength, fillString) => (self) => self.padStart(maxLength, fillString);
+/**
+* Replaces all occurrences of a substring or pattern in a string.
+*
+* **Example** (Replacing all matches)
+*
+* ```ts import.meta.vitest
+* import { pipe, String } from "effect"
+*
+* pipe("ababb", String.replaceAll("b", "c")) // => "acacc"
+* pipe("ababb", String.replaceAll(/ba/g, "cc")) // => "accbb"
+* ```
+*
+* @stability stable
+* @category transforming
+* @since 2.0.0
+*/
+const replaceAll = (searchValue, replaceValue) => (self) => self.replaceAll(searchValue, replaceValue);
+/**
+* Converts a camelCase string to snake_case.
+*
+* **Example** (Converting camelCase to snake_case)
+*
+* ```ts import.meta.vitest
+* import { String } from "effect"
+*
+* String.camelToSnake("helloWorld") // => "hello_world"
+* String.camelToSnake("fooBarBaz") // => "foo_bar_baz"
+* ```
+*
+* @stability stable
+* @category transforming
+* @since 2.0.0
+*/
+const camelToSnake = (self) => self.replace(/([A-Z])/g, "_$1").toLowerCase();
+export { toUpperCase as _, indexOf as a, normalize as c, replace as d, replaceAll as f, toLowerCase as g, startsWith as h, includes as i, padEnd as l, split as m, camelToSnake as n, isEmpty as o, slice as p, endsWith as r, isNonEmpty as s, Order as t, padStart as u, trim as v, trimEnd as y };