effect 2.0.0-next.41 → 2.0.0-next.43

package/dist/String-830aaa3e.cjs.dev.js

@@ -1,694 +0,0 @@
-'use strict';
-
-var Equivalence_dist_effectEquivalence = require('./Equivalence-de7a0d51.cjs.dev.js');
-var Function_dist_effectFunction = require('./Function-41ce433d.cjs.dev.js');
-var ReadonlyArray = require('./ReadonlyArray-9a1474f6.cjs.dev.js');
-var Number_dist_effectNumber = require('./Number-588f6483.cjs.dev.js');
-var Option_dist_effectOption = require('./Option-03997d77.cjs.dev.js');
-var Order_dist_effectOrder = require('./Order-28bdebd2.cjs.dev.js');
-var Predicate_dist_effectPredicate = require('./Predicate-9e859c9c.cjs.dev.js');
-
-/**
- * This module provides utility functions and type class instances for working with the `string` type in TypeScript.
- * It includes functions for basic string manipulation, as well as type class instances for
- * `Equivalence`, `Order`, `Semigroup`, and `Monoid`.
- *
- * @since 2.0.0
- */
-/**
- * Tests if a value is a `string`.
- *
- * @param input - The value to test.
- *
- * @example
- * import { isString } from 'effect/String'
- *
- * assert.deepStrictEqual(isString("a"), true)
- * assert.deepStrictEqual(isString(1), false)
- *
- * @category guards
- * @since 2.0.0
- */
-const isString = Predicate_dist_effectPredicate.isString;
-
-/**
- * @category instances
- * @since 2.0.0
- */
-const Equivalence = Equivalence_dist_effectEquivalence.string;
-
-/**
- * @category instances
- * @since 2.0.0
- */
-const Order = Order_dist_effectOrder.string;
-
-/**
- * The empty string `""`.
- *
- * @since 2.0.0
- */
-const empty = "";
-
-/**
- * Concatenates two strings at the type level.
- *
- * @since 2.0.0
- */
-
-/**
- * Concatenates two strings at runtime.
- *
- * @since 2.0.0
- */
-const concat = /*#__PURE__*/Function_dist_effectFunction.dual(2, (self, that) => self + that);
-
-/**
- * @example
- * import * as S from 'effect/String'
- * import { pipe } from 'effect/Function'
- *
- * assert.deepStrictEqual(pipe('a', S.toUpperCase), 'A')
- *
- * @since 2.0.0
- */
-const toUpperCase = self => self.toUpperCase();
-
-/**
- * @example
- * import * as S from 'effect/String'
- * import { pipe } from 'effect/Function'
- *
- * assert.deepStrictEqual(pipe('A', S.toLowerCase), 'a')
- *
- * @since 2.0.0
- */
-const toLowerCase = self => self.toLowerCase();
-
-/**
- * @example
- * import * as S from 'effect/String'
- * import { pipe } from 'effect/Function'
- *
- * assert.deepStrictEqual(pipe('abc', S.capitalize), 'Abc')
- *
- * @since 2.0.0
- */
-const capitalize = self => {
-  if (self.length === 0) return self;
-  return toUpperCase(self[0]) + self.slice(1);
-};
-
-/**
- * @example
- * import * as S from 'effect/String'
- * import { pipe } from 'effect/Function'
- *
- * assert.deepStrictEqual(pipe('ABC', S.uncapitalize), 'aBC')
- *
- * @since 2.0.0
- */
-const uncapitalize = self => {
-  if (self.length === 0) return self;
-  return toLowerCase(self[0]) + self.slice(1);
-};
-
-/**
- * @example
- * import * as S from 'effect/String'
- * import { pipe } from 'effect/Function'
- *
- * assert.deepStrictEqual(pipe('abc', S.replace('b', 'd')), 'adc')
- *
- * @since 2.0.0
- */
-const replace = (searchValue, replaceValue) => self => self.replace(searchValue, replaceValue);
-
-/**
- * @since 2.0.0
- */
-
-/**
- * @example
- * import * as S from 'effect/String'
- *
- * assert.deepStrictEqual(S.trim(' a '), 'a')
- *
- * @since 2.0.0
- */
-const trim = self => self.trim();
-
-/**
- * @since 2.0.0
- */
-
-/**
- * @example
- * import * as S from 'effect/String'
- *
- * assert.deepStrictEqual(S.trimStart(' a '), 'a ')
- *
- * @since 2.0.0
- */
-const trimStart = self => self.trimStart();
-
-/**
- * @since 2.0.0
- */
-
-/**
- * @example
- * import * as S from 'effect/String'
- *
- * assert.deepStrictEqual(S.trimEnd(' a '), ' a')
- *
- * @since 2.0.0
- */
-const trimEnd = self => self.trimEnd();
-
-/**
- * @example
- * import * as S from 'effect/String'
- * import { pipe } from 'effect/Function'
- *
- * assert.deepStrictEqual(pipe('abcd', S.slice(1, 3)), 'bc')
- *
- * @since 2.0.0
- */
-const slice = (start, end) => self => self.slice(start, end);
-
-/**
- * Test whether a `string` is empty.
- *
- * @example
- * import * as S from 'effect/String'
- *
- * assert.deepStrictEqual(S.isEmpty(''), true)
- * assert.deepStrictEqual(S.isEmpty('a'), false)
- *
- * @since 2.0.0
- */
-const isEmpty = self => self.length === 0;
-
-/**
- * Test whether a `string` is non empty.
- *
- * @since 2.0.0
- */
-const isNonEmpty = self => self.length > 0;
-
-/**
- * Calculate the number of characters in a `string`.
- *
- * @example
- * import * as S from 'effect/String'
- *
- * assert.deepStrictEqual(S.length('abc'), 3)
- *
- * @since 2.0.0
- */
-const length = self => self.length;
-
-/**
- * @example
- * import * as S from 'effect/String'
- * import { pipe } from 'effect/Function'
- *
- * assert.deepStrictEqual(pipe('abc', S.split('')), ['a', 'b', 'c'])
- * assert.deepStrictEqual(pipe('', S.split('')), [''])
- *
- * @since 2.0.0
- */
-const split = /*#__PURE__*/Function_dist_effectFunction.dual(2, (self, separator) => {
-  const out = self.split(separator);
-  return ReadonlyArray.isNonEmptyArray(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`.
- *
- * @since 2.0.0
- */
-const includes = (searchString, position) => self => self.includes(searchString, position);
-
-/**
- * @since 2.0.0
- */
-const startsWith = (searchString, position) => self => self.startsWith(searchString, position);
-
-/**
- * @since 2.0.0
- */
-const endsWith = (searchString, position) => self => self.endsWith(searchString, position);
-
-/**
- * @example
- * import * as S from 'effect/String'
- * import * as Option from 'effect/Option'
- * import { pipe } from 'effect/Function'
- *
- * assert.deepStrictEqual(pipe("abc", S.charCodeAt(1)), Option.some(98))
- * assert.deepStrictEqual(pipe("abc", S.charCodeAt(4)), Option.none())
- *
- * @since 2.0.0
- */
-const charCodeAt = /*#__PURE__*/Function_dist_effectFunction.dual(2, (self, index) => Option_dist_effectOption.filter(Option_dist_effectOption.some(self.charCodeAt(index)), charCode => !isNaN(charCode)));
-
-/**
- * @example
- * import * as S from 'effect/String'
- * import { pipe } from 'effect/Function'
- *
- * assert.deepStrictEqual(pipe("abcd", S.substring(1)), "bcd")
- * assert.deepStrictEqual(pipe("abcd", S.substring(1, 3)), "bc")
- *
- * @since 2.0.0
- */
-const substring = (start, end) => self => self.substring(start, end);
-
-/**
- * @example
- * import * as S from 'effect/String'
- * import * as Option from 'effect/Option'
- * import { pipe } from 'effect/Function'
- *
- * assert.deepStrictEqual(pipe("abc", S.at(1)), Option.some("b"))
- * assert.deepStrictEqual(pipe("abc", S.at(4)), Option.none())
- *
- * @since 2.0.0
- */
-const at = /*#__PURE__*/Function_dist_effectFunction.dual(2, (self, index) => Option_dist_effectOption.fromNullable(self.at(index)));
-
-/**
- * @example
- * import * as S from 'effect/String'
- * import * as Option from 'effect/Option'
- * import { pipe } from 'effect/Function'
- *
- * assert.deepStrictEqual(pipe("abc", S.charAt(1)), Option.some("b"))
- * assert.deepStrictEqual(pipe("abc", S.charAt(4)), Option.none())
- *
- * @since 2.0.0
- */
-const charAt = /*#__PURE__*/Function_dist_effectFunction.dual(2, (self, index) => Option_dist_effectOption.filter(Option_dist_effectOption.some(self.charAt(index)), isNonEmpty));
-
-/**
- * @example
- * import * as S from 'effect/String'
- * import * as Option from 'effect/Option'
- * import { pipe } from 'effect/Function'
- *
- * assert.deepStrictEqual(pipe("abc", S.codePointAt(1)), Option.some(98))
- *
- * @since 2.0.0
- */
-const codePointAt = /*#__PURE__*/Function_dist_effectFunction.dual(2, (self, index) => Option_dist_effectOption.fromNullable(self.codePointAt(index)));
-
-/**
- * @example
- * import * as S from 'effect/String'
- * import * as Option from 'effect/Option'
- * import { pipe } from 'effect/Function'
- *
- * assert.deepStrictEqual(pipe("abbbc", S.indexOf("b")), Option.some(1))
- *
- * @since 2.0.0
- */
-const indexOf = searchString => self => Option_dist_effectOption.filter(Option_dist_effectOption.some(self.indexOf(searchString)), Number_dist_effectNumber.greaterThanOrEqualTo(0));
-
-/**
- * @example
- * import * as S from 'effect/String'
- * import * as Option from 'effect/Option'
- * import { pipe } from 'effect/Function'
- *
- * assert.deepStrictEqual(pipe("abbbc", S.lastIndexOf("b")), Option.some(3))
- * assert.deepStrictEqual(pipe("abbbc", S.lastIndexOf("d")), Option.none())
- *
- * @since 2.0.0
- */
-const lastIndexOf = searchString => self => Option_dist_effectOption.filter(Option_dist_effectOption.some(self.lastIndexOf(searchString)), Number_dist_effectNumber.greaterThanOrEqualTo(0));
-
-/**
- * @example
- * import * as S from 'effect/String'
- * import { pipe } from 'effect/Function'
- *
- * assert.deepStrictEqual(pipe("a", S.localeCompare("b")), -1)
- * assert.deepStrictEqual(pipe("b", S.localeCompare("a")), 1)
- * assert.deepStrictEqual(pipe("a", S.localeCompare("a")), 0)
- *
- * @since 2.0.0
- */
-const localeCompare = (that, locales, options) => self => Number_dist_effectNumber.sign(self.localeCompare(that, locales, options));
-
-/**
- * It is the `pipe`-able version of the native `match` method.
- *
- * @since 2.0.0
- */
-const match = regexp => self => Option_dist_effectOption.fromNullable(self.match(regexp));
-
-/**
- * It is the `pipe`-able version of the native `matchAll` method.
- *
- * @since 2.0.0
- */
-const matchAll = regexp => self => self.matchAll(regexp);
-
-/**
- * @example
- * import * as S from 'effect/String'
- * import { pipe } from 'effect/Function'
- *
- * const str = "\u1E9B\u0323";
- * assert.deepStrictEqual(pipe(str, S.normalize()), "\u1E9B\u0323")
- * assert.deepStrictEqual(pipe(str, S.normalize("NFC")), "\u1E9B\u0323")
- * assert.deepStrictEqual(pipe(str, S.normalize("NFD")), "\u017F\u0323\u0307")
- * assert.deepStrictEqual(pipe(str, S.normalize("NFKC")), "\u1E69")
- * assert.deepStrictEqual(pipe(str, S.normalize("NFKD")), "\u0073\u0323\u0307")
- *
- * @since 2.0.0
- */
-const normalize = form => self => self.normalize(form);
-
-/**
- * @example
- * import * as S from 'effect/String'
- * import { pipe } from 'effect/Function'
- *
- * assert.deepStrictEqual(pipe("a", S.padEnd(5)), "a    ")
- * assert.deepStrictEqual(pipe("a", S.padEnd(5, "_")), "a____")
- *
- * @since 2.0.0
- */
-const padEnd = (maxLength, fillString) => self => self.padEnd(maxLength, fillString);
-
-/**
- * @example
- * import * as S from 'effect/String'
- * import { pipe } from 'effect/Function'
- *
- * assert.deepStrictEqual(pipe("a", S.padStart(5)), "    a")
- * assert.deepStrictEqual(pipe("a", S.padStart(5, "_")), "____a")
- *
- * @since 2.0.0
- */
-const padStart = (maxLength, fillString) => self => self.padStart(maxLength, fillString);
-
-/**
- * @example
- * import * as S from 'effect/String'
- * import { pipe } from 'effect/Function'
- *
- * assert.deepStrictEqual(pipe("a", S.repeat(5)), "aaaaa")
- *
- * @since 2.0.0
- */
-const repeat = count => self => self.repeat(count);
-
-/**
- * @example
- * import * as S from 'effect/String'
- * import { pipe } from 'effect/Function'
- *
- * assert.deepStrictEqual(pipe("ababb", S.replaceAll("b", "c")), "acacc")
- * assert.deepStrictEqual(pipe("ababb", S.replaceAll(/ba/g, "cc")), "accbb")
- *
- * @since 2.0.0
- */
-const replaceAll = (searchValue, replaceValue) => self => self.replaceAll(searchValue, replaceValue);
-
-/**
- * @example
- * import * as S from 'effect/String'
- * import * as Option from 'effect/Option'
- * import { pipe } from 'effect/Function'
- *
- * assert.deepStrictEqual(pipe("ababb", S.search("b")), Option.some(1))
- * assert.deepStrictEqual(pipe("ababb", S.search(/abb/)), Option.some(2))
- * assert.deepStrictEqual(pipe("ababb", S.search("d")), Option.none())
- *
- * @since 2.0.0
- */
-const search = /*#__PURE__*/Function_dist_effectFunction.dual(2, (self, regexp) => Option_dist_effectOption.filter(Option_dist_effectOption.some(self.search(regexp)), Number_dist_effectNumber.greaterThanOrEqualTo(0)));
-
-/**
- * @example
- * import * as S from 'effect/String'
- * import { pipe } from 'effect/Function'
- *
- * const str = "\u0130"
- * assert.deepStrictEqual(pipe(str, S.toLocaleLowerCase("tr")), "i")
- *
- * @since 2.0.0
- */
-const toLocaleLowerCase = locale => self => self.toLocaleLowerCase(locale);
-
-/**
- * @example
- * import * as S from 'effect/String'
- * import { pipe } from 'effect/Function'
- *
- * const str = "i\u0307"
- * assert.deepStrictEqual(pipe(str, S.toLocaleUpperCase("lt-LT")), "I")
- *
- * @since 2.0.0
- */
-const toLocaleUpperCase = locale => self => self.toLocaleUpperCase(locale);
-
-/**
- * Keep the specified number of characters from the start of a string.
- *
- * If `n` is larger than the available number of characters, the string will
- * be returned whole.
- *
- * If `n` is not a positive number, an empty string will be returned.
- *
- * If `n` is a float, it will be rounded down to the nearest integer.
- *
- * @example
- * import * as S from 'effect/String'
- *
- * assert.deepStrictEqual(S.takeLeft("Hello World", 5), "Hello")
- *
- * @since 2.0.0
- */
-const takeLeft = /*#__PURE__*/Function_dist_effectFunction.dual(2, (self, n) => self.slice(0, Math.max(n, 0)));
-
-/**
- * Keep the specified number of characters from the end of a string.
- *
- * If `n` is larger than the available number of characters, the string will
- * be returned whole.
- *
- * If `n` is not a positive number, an empty string will be returned.
- *
- * If `n` is a float, it will be rounded down to the nearest integer.
- *
- * @example
- * import * as S from 'effect/String'
- *
- * assert.deepStrictEqual(S.takeRight("Hello World", 5), "World")
- *
- * @since 2.0.0
- */
-const takeRight = /*#__PURE__*/Function_dist_effectFunction.dual(2, (self, n) => self.slice(Math.max(0, self.length - Math.floor(n)), Infinity));
-const CR = 0x0d;
-const LF = 0x0a;
-
-/**
- * Returns an `IterableIterator` which yields each line contained within the
- * string, trimming off the trailing newline character.
- *
- * @since 2.0.0
- */
-// export const linesIterator = (self: string): LinesIterator => linesSeparated(self, true)
-
-/**
- * Returns an `IterableIterator` which yields each line contained within the
- * string as well as the trailing newline character.
- *
- * @since 2.0.0
- */
-const linesWithSeparators = s => linesSeparated(s, false);
-
-/**
- * For every line in this string, strip a leading prefix consisting of blanks
- * or control characters followed by the character specified by `marginChar`
- * from the line.
- *
- * @since 2.0.0
- */
-const stripMarginWith = /*#__PURE__*/Function_dist_effectFunction.dual(2, (self, marginChar) => {
-  let out = "";
-  for (const line of linesWithSeparators(self)) {
-    let index = 0;
-    while (index < line.length && line.charAt(index) <= " ") {
-      index = index + 1;
-    }
-    const stripped = index < line.length && line.charAt(index) === marginChar ? line.substring(index + 1) : line;
-    out = out + stripped;
-  }
-  return out;
-});
-
-/**
- * For every line in this string, strip a leading prefix consisting of blanks
- * or control characters followed by the `"|"` character from the line.
- *
- * @since 2.0.0
- */
-const stripMargin = self => stripMarginWith(self, "|");
-class LinesIterator {
-  constructor(s, stripped = false) {
-    this.s = s;
-    this.stripped = stripped;
-    this.index = 0;
-    this.length = s.length;
-  }
-  next() {
-    if (this.done) {
-      return {
-        done: true,
-        value: undefined
-      };
-    }
-    const start = this.index;
-    while (!this.done && !isLineBreak(this.s[this.index])) {
-      this.index = this.index + 1;
-    }
-    let end = this.index;
-    if (!this.done) {
-      const char = this.s[this.index];
-      this.index = this.index + 1;
-      if (!this.done && isLineBreak2(char, this.s[this.index])) {
-        this.index = this.index + 1;
-      }
-      if (!this.stripped) {
-        end = this.index;
-      }
-    }
-    return {
-      done: false,
-      value: this.s.substring(start, end)
-    };
-  }
-  [Symbol.iterator]() {
-    return new LinesIterator(this.s, this.stripped);
-  }
-  get done() {
-    return this.index >= this.length;
-  }
-}
-
-/**
- * Test if the provided character is a line break character (i.e. either `"\r"`
- * or `"\n"`).
- */
-const isLineBreak = char => {
-  const code = char.charCodeAt(0);
-  return code === CR || code === LF;
-};
-
-/**
- * Test if the provided characters combine to form a carriage return/line-feed
- * (i.e. `"\r\n"`).
- */
-const isLineBreak2 = (char0, char1) => char0.charCodeAt(0) === CR && char1.charCodeAt(0) === LF;
-const linesSeparated = (self, stripped) => new LinesIterator(self, stripped);
-
-var String = /*#__PURE__*/Object.freeze({
-  __proto__: null,
-  isString: isString,
-  Equivalence: Equivalence,
-  Order: Order,
-  empty: empty,
-  concat: concat,
-  toUpperCase: toUpperCase,
-  toLowerCase: toLowerCase,
-  capitalize: capitalize,
-  uncapitalize: uncapitalize,
-  replace: replace,
-  trim: trim,
-  trimStart: trimStart,
-  trimEnd: trimEnd,
-  slice: slice,
-  isEmpty: isEmpty,
-  isNonEmpty: isNonEmpty,
-  length: length,
-  split: split,
-  includes: includes,
-  startsWith: startsWith,
-  endsWith: endsWith,
-  charCodeAt: charCodeAt,
-  substring: substring,
-  at: at,
-  charAt: charAt,
-  codePointAt: codePointAt,
-  indexOf: indexOf,
-  lastIndexOf: lastIndexOf,
-  localeCompare: localeCompare,
-  match: match,
-  matchAll: matchAll,
-  normalize: normalize,
-  padEnd: padEnd,
-  padStart: padStart,
-  repeat: repeat,
-  replaceAll: replaceAll,
-  search: search,
-  toLocaleLowerCase: toLocaleLowerCase,
-  toLocaleUpperCase: toLocaleUpperCase,
-  takeLeft: takeLeft,
-  takeRight: takeRight,
-  linesWithSeparators: linesWithSeparators,
-  stripMarginWith: stripMarginWith,
-  stripMargin: stripMargin
-});
-
-exports.Equivalence = Equivalence;
-exports.Order = Order;
-exports.String = String;
-exports.at = at;
-exports.capitalize = capitalize;
-exports.charAt = charAt;
-exports.charCodeAt = charCodeAt;
-exports.codePointAt = codePointAt;
-exports.concat = concat;
-exports.empty = empty;
-exports.endsWith = endsWith;
-exports.includes = includes;
-exports.indexOf = indexOf;
-exports.isEmpty = isEmpty;
-exports.isNonEmpty = isNonEmpty;
-exports.isString = isString;
-exports.lastIndexOf = lastIndexOf;
-exports.length = length;
-exports.linesWithSeparators = linesWithSeparators;
-exports.localeCompare = localeCompare;
-exports.match = match;
-exports.matchAll = matchAll;
-exports.normalize = normalize;
-exports.padEnd = padEnd;
-exports.padStart = padStart;
-exports.repeat = repeat;
-exports.replace = replace;
-exports.replaceAll = replaceAll;
-exports.search = search;
-exports.slice = slice;
-exports.split = split;
-exports.startsWith = startsWith;
-exports.stripMargin = stripMargin;
-exports.stripMarginWith = stripMarginWith;
-exports.substring = substring;
-exports.takeLeft = takeLeft;
-exports.takeRight = takeRight;
-exports.toLocaleLowerCase = toLocaleLowerCase;
-exports.toLocaleUpperCase = toLocaleUpperCase;
-exports.toLowerCase = toLowerCase;
-exports.toUpperCase = toUpperCase;
-exports.trim = trim;
-exports.trimEnd = trimEnd;
-exports.trimStart = trimStart;
-exports.uncapitalize = uncapitalize;