@tempots/std 0.11.0 → 0.12.0

package/string.js

@@ -1,63 +1,63 @@
-import { any as l, all as C, range as A, fill as O } from "./array.js";
-import { map as p } from "./regexp.js";
+import { anyElement as l, allElements as C, generateArray as A, createFilledArray as S } from "./array.js";
+import { mapRegExp as h } from "./regexp.js";
 function c(n, t, r) {
   return n.split(t).join(r);
 }
-function V(n, t) {
+function J(n, t) {
   const r = n.indexOf(t);
   return r < 0 ? "" : n.substring(r + t.length);
 }
-function X(n, t) {
+function V(n, t) {
   const r = n.lastIndexOf(t);
   return r < 0 ? "" : n.substring(r + t.length);
 }
-function Y(n, t) {
+function X(n, t) {
   const r = n.indexOf(t);
   return r < 0 ? "" : n.substring(0, r);
 }
-function v(n, t) {
+function Y(n, t) {
   const r = n.lastIndexOf(t);
   return r < 0 ? "" : n.substring(0, r);
 }
-function h(n) {
+function p(n) {
   return n.substring(0, 1).toUpperCase() + n.substring(1);
 }
 const d = (n) => n.toUpperCase();
-function nn(n, t = !1) {
-  return t ? p(h(n), G, d) : p(h(n), Z, d);
+function v(n, t = !1) {
+  return t ? h(p(n), H, d) : h(p(n), R, d);
 }
-function tn(n) {
-  return n.replace(K, `
+function nn(n) {
+  return n.replace(Q, `
 `);
 }
-function rn(n, t) {
+function tn(n, t) {
   return n == null && t == null ? 0 : n == null ? -1 : t == null ? 1 : y(n.toLowerCase(), t.toLowerCase());
 }
 function L(n, t) {
   return n.substring(0, n.length - t.length) === t;
 }
-function en(n, t) {
+function rn(n, t) {
   return n.substring(0, n.length - t.length).toLowerCase() === t.toLowerCase();
 }
 function W(n, t) {
   return n.substring(0, t.length) === t;
 }
-function on(n, t) {
+function en(n, t) {
   return n.substring(0, t.length).toLowerCase() === t.toLowerCase();
 }
-function sn(n, t) {
-  return E(
+function on(n, t) {
+  return z(
     n.toLowerCase(),
     t.map((r) => r.toLowerCase())
   );
 }
 function un(n, t) {
-  return M(
+  return N(
     n.toLowerCase(),
     t.map((r) => r.toLowerCase())
   );
 }
-function fn(n) {
+function sn(n) {
   return n.trim().replace(m, " ");
 }
 function y(n, t) {
@@ -69,93 +69,94 @@ function w(n, t) {
 function a(n, t) {
   return n.includes(t);
 }
-function cn(n, t) {
+function fn(n, t) {
   return n.split(t).length - 1;
 }
-function ln(n, t) {
+function cn(n, t) {
   return l(t, (r) => w(n, r));
 }
-function an(n, t) {
+function ln(n, t) {
   return l(t, (r) => a(n, r));
 }
-function gn(n, t) {
+function an(n, t) {
   return C(t, (r) => w(n, r));
 }
-function pn(n, t) {
+function gn(n, t) {
   return C(t, (r) => a(n, r));
 }
 function hn(n) {
   return n.replace("_", "-");
 }
-function dn(n, t) {
+function pn(n, t) {
+  if (n === t) return -1;
   const r = Math.min(n.length, t.length);
   for (let e = 0; e < r; e++)
     if (n.substring(e, e + 1) !== t.substring(e, e + 1)) return e;
   return r;
 }
-function z(n, t = 20, r = "…") {
+function E(n, t = 20, r = "…") {
   const e = n.length, i = r.length;
   return e > t ? t < i ? r.substr(i - t, t) : n.substr(0, t - i) + r : n;
 }
-function bn(n, t = 20, r = "…") {
+function dn(n, t = 20, r = "…") {
   const e = n.length, i = r.length;
   if (e > t) {
     if (t <= i)
-      return z(n, t, r);
-    const u = Math.ceil((t - i) / 2), f = Math.floor((t - i) / 2);
-    return n.substr(0, u) + r + n.substr(e - f, f);
+      return E(n, t, r);
+    const s = Math.ceil((t - i) / 2), f = Math.floor((t - i) / 2);
+    return n.substr(0, s) + r + n.substr(e - f, f);
   } else return n;
 }
-function E(n, t) {
+function z(n, t) {
   return l(t, (r) => L(n, r));
 }
-function Cn(n, t) {
+function bn(n, t) {
   return g(n).filter(t).join("");
 }
-function An(n, t) {
-  return N(n).filter(t).map((e) => String.fromCharCode(e)).join("");
+function Cn(n, t) {
+  return U(n).filter(t).map((e) => String.fromCharCode(e)).join("");
 }
-function Ln(n, t) {
+function An(n, t) {
   const r = n.indexOf(t);
   return r < 0 ? "" : n.substring(r);
 }
-function wn(n, t = 2166136261) {
+function Ln(n, t = 2166136261) {
   let r = t;
   for (let e = 0, i = n.length; e < i; e++)
     r ^= n.charCodeAt(e), r += (r << 1) + (r << 4) + (r << 7) + (r << 8) + (r << 24);
   return r >>> 0;
 }
-function In(n) {
+function wn(n) {
   return n != null && n.length > 0;
 }
-function mn(n) {
+function In(n) {
   return c(k(n), "_", " ");
 }
-function Sn(n) {
+function mn(n) {
   return n.length > 0 && !D.test(n);
 }
 function On(n) {
-  return H.test(n);
+  return G.test(n);
 }
-function Wn(n) {
-  return !R.test(n);
+function Sn(n) {
+  return !T.test(n);
 }
-function yn(n) {
+function Wn(n) {
   return n.toLowerCase() === n;
 }
-function zn(n) {
+function yn(n) {
   return n.toUpperCase() === n;
 }
 function En(n, t) {
   return n != null && n !== "" ? n : t;
 }
-function Bn(n) {
-  return Q.test(n);
+function zn(n) {
+  return F.test(n);
 }
-function jn(n) {
+function Bn(n) {
   return n == null || n === "";
 }
-function _n(n) {
+function jn(n) {
   return n.substring(0, 1).toLowerCase() + n.substring(1);
 }
 function B(n, t = 1) {
@@ -167,7 +168,7 @@ function B(n, t = 1) {
 function j(n, t) {
   return A(t, () => B(n)).join("");
 }
-function $n(n) {
+function _n(n) {
   return j(P, n);
 }
 function Mn(n, t) {
@@ -176,94 +177,91 @@ function Mn(n, t) {
 function Nn(n, t) {
   return c(n, t, "");
 }
-function Tn(n, t) {
+function Un(n, t) {
   return L(n, t) ? n.substring(0, n.length - t.length) : n;
 }
-function Un(n, t, r) {
+function $n(n, t, r) {
   return n.substring(0, t) + n.substring(t + r);
 }
-function kn(n, t) {
+function xn(n, t) {
   return W(n, t) ? n.substring(t.length) : n;
 }
-function xn(n, t) {
+function kn(n, t) {
   const r = n.indexOf(t);
   return r < 0 ? n : n.substring(0, r) + n.substring(r + t.length);
 }
 function I(n, t) {
-  return O(t, n).join("");
+  return S(t, n).join("");
 }
-function Pn(n) {
+function Zn(n) {
   const t = g(n);
   return t.reverse(), t.join("");
 }
 function _(n, t = "'") {
   return t === "'" ? n.includes("'") ? n.includes('"') ? "'" + c(n, "'", "\\'") + "'" : '"' + n + '"' : "'" + n + "'" : n.includes('"') ? n.includes("'") ? '"' + c(n, '"', '\\"') + '"' : "'" + n + "'" : '"' + n + '"';
 }
-function $(n, t = "'") {
+function M(n, t = "'") {
   return t + c(n, t, "\\" + t) + t;
 }
-function Zn(n, t = "'") {
+function Pn(n, t = "'") {
   return n.indexOf(`
-`) >= 0 ? $(n, "`") : _(n, t);
+`) >= 0 ? M(n, "`") : _(n, t);
 }
 function Rn(n, t) {
   const r = n.indexOf(t);
   return r < 0 ? [n] : [n.substring(0, r), n.substring(r + t.length)];
 }
-function M(n, t) {
+function N(n, t) {
   return l(t, (r) => n.startsWith(r));
 }
-function Dn(n) {
-  return n.replace(F, "");
-}
-function Gn(n, t, r = t) {
+function Tn(n, t, r = t) {
   return `${t}${n}${r}`;
 }
 function g(n) {
   return n.split("");
 }
-function N(n) {
+function U(n) {
   return A(n.length, (t) => n.charCodeAt(t));
 }
-function Hn(n, t) {
+function Dn(n, t) {
   const r = [];
   for (; n.length > 0; )
     r.push(n.substring(0, t)), n = n.substr(t, n.length - t);
   return r;
 }
-function Qn(n) {
-  return n.split(S);
+function Hn(n) {
+  return n.split(O);
 }
-function Fn(n, t) {
-  return U(T(n, t), t);
+function Gn(n, t) {
+  return x($(n, t), t);
 }
-function T(n, t) {
+function $(n, t) {
   let r = 0;
   for (let e = 0; e < n.length && a(t, n.charAt(e)); e++)
     r++;
   return n.substring(r);
 }
-function U(n, t) {
+function x(n, t) {
   const r = n.length;
   let e = r, i;
-  for (let u = 0; u < r && (i = r - u - 1, a(t, n.charAt(i))); u++)
+  for (let s = 0; s < r && (i = r - s - 1, a(t, n.charAt(i))); s++)
     e = i;
   return n.substring(0, e);
 }
 function k(n) {
   return n = n.replace(/::/g, "/"), n = n.replace(/([A-Z]+)([A-Z][a-z])/g, "$1_$2"), n = n.replace(/([a-z\d])([A-Z])/g, "$1_$2"), n = n.replace(/-/g, "_"), n.toLowerCase();
 }
-function Kn(n) {
+function Fn(n) {
   return n.substring(0, 1).toUpperCase() + n.substring(1);
 }
-function qn(n, t) {
+function Qn(n, t) {
   const r = n.indexOf(t);
   return r < 0 ? n : n.substring(0, r);
 }
-function Jn(n, t = 78, r = "", e = `
+function Kn(n, t = 78, r = "", e = `
 `) {
-  return n.split(S).map(
-    (i) => x(i.replace(m, " ").trim(), t, r, e)
+  return n.split(O).map(
+    (i) => Z(i.replace(m, " ").trim(), t, r, e)
   ).join(e);
 }
 function b(n, t) {
@@ -271,135 +269,134 @@ function b(n, t) {
   const r = n.charCodeAt(t);
   return r === 9 || r === 10 || r === 11 || r === 12 || r === 13 || r === 32;
 }
-function Vn(n) {
+function qn(n) {
   if (typeof Buffer < "u")
     return Buffer.from(n).toString("base64");
   if (typeof btoa < "u")
     return btoa(n);
-  throw new Error("no implementation provided for base64 encoding");
+  throw new Error("no implementation found for base64 encoding");
 }
-function Xn(n) {
+function Jn(n) {
   if (typeof Buffer < "u")
     return Buffer.from(n, "base64").toString("utf8");
   if (typeof atob < "u")
     return atob(n);
-  throw new Error("no implementation provided for base64 decoding");
+  throw new Error("no implementation found for base64 decoding");
 }
-function x(n, t, r, e) {
-  const i = [], u = n.length, f = r.length;
-  let s = 0;
+function Z(n, t, r, e) {
+  const i = [], s = n.length, f = r.length;
+  let u = 0;
   for (t -= f; ; ) {
-    if (s + t >= u - f) {
-      i.push(n.substring(s));
+    if (u + t >= s - f) {
+      i.push(n.substring(u));
       break;
     }
     let o = 0;
-    for (; !b(n, s + t - o) && o < t; ) o++;
+    for (; !b(n, u + t - o) && o < t; ) o++;
     if (o === t) {
-      for (o = 0; !b(n, s + t + o) && s + t + o < u; ) o++;
-      i.push(n.substring(s, s + t + o)), s += t + o + 1;
+      for (o = 0; !b(n, u + t + o) && u + t + o < s; ) o++;
+      i.push(n.substring(u, u + t + o)), u += t + o + 1;
     } else
-      i.push(n.substring(s, s + t - o)), s += t - o + 1;
+      i.push(n.substring(u, u + t - o)), u += t - o + 1;
   }
   return r + i.join(e + r);
 }
-function Yn(n, t, r) {
+function Vn(n, t, r) {
   const e = r - n.length;
   return e > 0 ? I(t, e) + n : n;
 }
-function vn(n, t, r) {
+function Xn(n, t, r) {
   const e = r - n.length;
   return e > 0 ? n + I(t, e) : n;
 }
-function nt(n, t) {
+function Yn(n, t) {
   const r = n.lastIndexOf(t);
   return r >= 0 ? [n.substring(0, r), n.substring(r + t.length)] : [n];
 }
-function tt(n, t) {
+function vn(n, t) {
   const r = n.indexOf(t);
   return r >= 0 ? [n.substring(0, r), n.substring(r + t.length)] : [n];
 }
-const P = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/", Z = /[^a-zA-Z]([a-z])/g, R = /[^\t\n\r ]/, D = /[^a-zA-Z]/, G = /[ \t\r\n][a-z]/g, H = /^[a-z0-9]+$/i, Q = /^[0-9]+$/, F = /<\/?[a-z]+[^>]*>/gi, m = /[ \t\r\n]+/g, S = /\r\n|\n\r|\n|\r/g, K = /\r\n|\n\r|\r/g;
+const P = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/", R = /[^a-zA-Z]([a-z])/g, T = /[^\t\n\r ]/, D = /[^a-zA-Z]/, H = /[ \t\r\n][a-z]/g, G = /^[a-z0-9]+$/i, F = /^[0-9]+$/, m = /[ \t\r\n]+/g, O = /\r\n|\n\r|\n|\r/g, Q = /\r\n|\n\r|\r/g;
 export {
-  V as after,
-  X as afterLast,
-  Y as before,
-  v as beforeLast,
-  tn as canonicalizeNewlines,
-  h as capitalize,
-  nn as capitalizeWords,
-  fn as collapse,
-  y as compare,
-  rn as compareCaseInsensitive,
+  J as after,
+  V as afterLast,
+  X as before,
+  Y as beforeLast,
+  nn as canonicalizeNewlines,
+  p as capitalize,
+  v as capitalizeWords,
+  sn as collapse,
+  tn as compareCaseInsensitive,
+  y as compareStrings,
   a as contains,
-  pn as containsAll,
-  gn as containsAllCaseInsensitive,
-  an as containsAny,
-  ln as containsAnyCaseInsensitive,
+  gn as containsAll,
+  an as containsAllCaseInsensitive,
+  ln as containsAny,
+  cn as containsAnyCaseInsensitive,
   w as containsCaseInsensitive,
-  cn as count,
+  fn as count,
   hn as dasherize,
-  Xn as decodeBase64,
-  dn as diffIndex,
-  z as ellipsis,
-  bn as ellipsisMiddle,
-  Vn as encodeBase64,
+  Jn as decodeBase64,
+  pn as diffIndex,
+  E as ellipsis,
+  dn as ellipsisMiddle,
+  qn as encodeBase64,
   L as endsWith,
-  E as endsWithAny,
-  sn as endsWithAnyCaseInsensitive,
-  en as endsWithCaseInsensitive,
-  Cn as filter,
-  An as filterCharcode,
-  Ln as from,
-  In as hasContent,
-  wn as hashCode,
-  mn as humanize,
+  z as endsWithAny,
+  on as endsWithAnyCaseInsensitive,
+  rn as endsWithCaseInsensitive,
+  bn as filter,
+  Cn as filterCharcode,
+  An as from,
+  wn as hasContent,
+  Ln as hashCode,
+  In as humanize,
   En as ifEmpty,
-  Sn as isAlpha,
+  mn as isAlpha,
   On as isAlphaNum,
-  Wn as isBreakingWhitespace,
-  Bn as isDigitsOnly,
-  jn as isEmpty,
-  yn as isLowerCase,
+  Sn as isBreakingWhitespace,
+  zn as isDigitsOnly,
+  Bn as isEmpty,
+  Wn as isLowerCase,
   b as isSpaceAt,
-  zn as isUpperCase,
-  Zn as jsQuote,
-  _n as lowerCaseFirst,
-  Yn as lpad,
+  yn as isUpperCase,
+  Pn as jsQuote,
+  jn as lowerCaseFirst,
+  Vn as lpad,
   Mn as map,
-  $ as quote,
+  M as quote,
   B as random,
   j as randomSequence,
-  $n as randomSequence64,
+  _n as randomSequence64,
   Nn as remove,
-  Tn as removeAfter,
-  Un as removeAt,
-  kn as removeBefore,
-  xn as removeOne,
+  Un as removeAfter,
+  $n as removeAt,
+  xn as removeBefore,
+  kn as removeOne,
   I as repeat,
   c as replace,
-  Pn as reverse,
-  vn as rpad,
+  Zn as reverse,
+  Xn as rpad,
   _ as smartQuote,
-  tt as splitOnFirst,
-  nt as splitOnLast,
+  vn as splitOnFirst,
+  Yn as splitOnLast,
   Rn as splitOnce,
   W as startsWith,
-  M as startsWithAny,
+  N as startsWithAny,
   un as startsWithAnyCaseInsensitive,
-  on as startsWithCaseInsensitive,
-  Dn as stripTags,
-  Gn as surround,
+  en as startsWithCaseInsensitive,
+  Tn as surround,
   g as toArray,
-  N as toCharcodes,
-  Hn as toChunks,
-  Qn as toLines,
-  Fn as trimChars,
-  T as trimCharsLeft,
-  U as trimCharsRight,
+  U as toCharcodes,
+  Dn as toChunks,
+  Hn as toLines,
+  Gn as trimChars,
+  $ as trimCharsLeft,
+  x as trimCharsRight,
   k as underscore,
-  qn as upTo,
-  Kn as upperCaseFirst,
-  Jn as wrapColumns,
-  x as wrapLine
+  Qn as upTo,
+  Fn as upperCaseFirst,
+  Kn as wrapColumns,
+  Z as wrapLine
 };

package/validation.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const l=require("./result.cjs"),t={valid:{type:"valid"},invalid(e){return{type:"invalid",error:e}},isValid(e){return e.type==="valid"},isInvalid(e){return e.type==="invalid"},cmatch:(e,i)=>r=>t.isValid(r)?e():i(r.error),match:(e,i,r)=>t.isValid(e)?i():r(e.error),toResult:e=>t.cmatch(()=>l.Result.success(e),i=>l.Result.failure(i)),whenValid:e=>i=>(t.isValid(i)&&e(),i),whenInvalid:e=>i=>(t.isInvalid(i)&&e(i.error),i)};exports.Validation=t;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const i=require("./result-DzdZiQoR.cjs");exports.Validation=i.Validation;

package/validation.d.ts

@@ -1,24 +1,92 @@
 import { Result } from './result';
 
+/**
+ * Represents a valid result.
+ * @public
+ */
 export interface Valid {
     type: 'valid';
 }
+/**
+ * Represents an invalid value with an associated error.
+ * @typeParam E - The type of the error.
+ * @public
+ */
 export interface Invalid<E> {
     type: 'invalid';
     error: E;
 }
+/**
+ * Represents a type that can either be `Valid` or `Invalid`.
+ * @typeParam E - The type of the error associated with an `Invalid` value.
+ * @public
+ */
 export type Validation<E> = Valid | Invalid<E>;
+/**
+ * Represents a promise that resolves to a `Validation` object.
+ * @typeParam E - The type of the error value in the `Validation` object.
+ * @public
+ */
 export type PromiseValidation<E> = PromiseLike<Validation<E>>;
+/**
+ * Utility functions for working with `Validation` types.
+ * @public
+ */
 export declare const Validation: {
+    /**
+     * Creates a valid `Validation`.
+     * @returns A `Validation` that is `Valid`.
+     */
     valid: {
         type: "valid";
     };
+    /**
+     * Creates an invalid `Validation`.
+     * @param error - The error associated with the invalid value.
+     * @returns A `Validation` that is `Invalid`.
+     */
     invalid<E>(error: E): Validation<E>;
+    /**
+     * Checks if a `Validation` is `Valid`.
+     * @param r - The `Validation` to check.
+     * @returns `true` if the `Validation` is `Valid`, otherwise `false`.
+     */
     isValid<E>(r: Validation<E>): r is Valid;
+    /**
+     * Checks if a `Validation` is `Invalid`.
+     * @param r - The `Validation` to check.
+     * @returns `true` if the `Validation` is `Invalid`, otherwise `false`.
+     */
     isInvalid<E>(r: Validation<E>): r is Invalid<E>;
-    cmatch: <V, E>(valid: () => V, invalid: (error: E) => V) => (r: Validation<E>) => V;
+    /**
+     * Maps the value of a `Validation` to a new value.
+     * @param r - The `Validation` to map.
+     * @param valid - The mapping function for a valid value.
+     * @param invalid - The mapping function for an invalid value.
+     * @returns The mapped value.
+     */
     match: <V, E>(r: Validation<E>, valid: () => V, invalid: (error: E) => V) => V;
-    toResult: <T, E>(value: T) => ((validation: Validation<E>) => Result<T, E>);
-    whenValid: <E>(apply: () => void) => (r: Validation<E>) => Validation<E>;
-    whenInvalid: <E>(apply: (e: E) => void) => (r: Validation<E>) => Validation<E>;
+    /**
+     * Maps the value of a `Validation` to a new `Validation`.
+     * @param validation - The `Validation` to map.
+     * @param value - The value to map.
+     * @returns A new `Validation` with the mapped value.
+     */
+    toResult: <T, E>(validation: Validation<E>, value: T) => Result<T, E>;
+    /**
+     * Execute a function when the `Validation` is valid.
+     *
+     * @param r - The `Validation` to check.
+     * @param apply - The function to execute when the `Validation` is valid.
+     * @returns The `Validation` object.
+     */
+    whenValid: <E>(r: Validation<E>, apply: () => void) => Validation<E>;
+    /**
+     * Execute a function when the `Validation` is invalid.
+     *
+     * @param r - The `Validation` to check.
+     * @param apply - The function to execute when the `Validation` is invalid.
+     * @returns The `Validation` object.
+     */
+    whenInvalid: <E>(r: Validation<E>, apply: (e: E) => void) => Validation<E>;
 };

package/validation.js

@@ -1,25 +1,4 @@
-import { Result as a } from "./result.js";
-const r = {
-  // eslint-disable-next-line @typescript-eslint/no-explicit-any
-  valid: { type: "valid" },
-  invalid(i) {
-    return { type: "invalid", error: i };
-  },
-  isValid(i) {
-    return i.type === "valid";
-  },
-  isInvalid(i) {
-    return i.type === "invalid";
-  },
-  cmatch: (i, e) => (t) => r.isValid(t) ? i() : e(t.error),
-  match: (i, e, t) => r.isValid(i) ? e() : t(i.error),
-  toResult: (i) => r.cmatch(
-    () => a.success(i),
-    (e) => a.failure(e)
-  ),
-  whenValid: (i) => (e) => (r.isValid(e) && i(), e),
-  whenInvalid: (i) => (e) => (r.isInvalid(e) && i(e.error), e)
-};
+import { V as i } from "./result-Czm7RKNP.js";
 export {
-  r as Validation
+  i as Validation
 };

package/maybe.cjs

@@ -1 +0,0 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e={nothing:void 0,just:t=>t,isNothing:t=>t==null,isJust:t=>t!=null};exports.Maybe=e;