@tempots/std 0.10.7 → 0.12.0

package/result-Czm7RKNP.js

@@ -0,0 +1,230 @@
+import { AsyncResult as l } from "./async-result.js";
+const t = {
+  /**
+   * Creates a valid `Validation`.
+   * @returns A `Validation` that is `Valid`.
+   */
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  valid: { type: "valid" },
+  /**
+   * Creates an invalid `Validation`.
+   * @param error - The error associated with the invalid value.
+   * @returns A `Validation` that is `Invalid`.
+   */
+  invalid(e) {
+    return { type: "invalid", error: e };
+  },
+  /**
+   * Checks if a `Validation` is `Valid`.
+   * @param r - The `Validation` to check.
+   * @returns `true` if the `Validation` is `Valid`, otherwise `false`.
+   */
+  isValid(e) {
+    return e.type === "valid";
+  },
+  /**
+   * Checks if a `Validation` is `Invalid`.
+   * @param r - The `Validation` to check.
+   * @returns `true` if the `Validation` is `Invalid`, otherwise `false`.
+   */
+  isInvalid(e) {
+    return e.type === "invalid";
+  },
+  /**
+   * 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: (e, s, r) => t.isValid(e) ? s() : r(e.error),
+  /**
+   * 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: (e, s) => t.match(
+    e,
+    () => u.success(s),
+    (r) => u.failure(r)
+  ),
+  /**
+   * 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, s) => (t.isValid(e) && s(), 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, s) => (t.isInvalid(e) && s(e.error), e)
+}, u = {
+  /**
+   * Creates a successful `Result`.
+   * @param value - The value to wrap in a `Success` type.
+   * @returns A `Result` that is a `Success`.
+   * @public
+   */
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  success(e) {
+    return { type: "Success", value: e };
+  },
+  /**
+   * Creates a failure `Result`.
+   * @param error - The error to wrap in a `Failure` type.
+   * @returns A `Result` that is a `Failure`.
+   * @public
+   */
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  failure(e) {
+    return { type: "Failure", error: e };
+  },
+  /**
+   * Maps the value of a `Result` to a new value.
+   * @param r - The `Result` to map.
+   * @param f - The mapping function.
+   * @returns A new `Result` with the mapped value.
+   * @public
+   */
+  map: (e, s) => e.type === "Success" ? u.success(s(e.value)) : e,
+  /**
+   * Maps the value of a `Result` to a new `Result`.
+   * @param r - The `Result` to map.
+   * @param f - The mapping function.
+   * @returns A new `Result` with the mapped value.
+   * @public
+   */
+  flatMap: (e, s) => e.type === "Success" ? s(e.value) : e,
+  /**
+   * Converts a `Result` to an `AsyncResult`.
+   * @param r - The `Result` to convert.
+   * @returns An `AsyncResult` that is equivalent to the input `Result`.
+   * @public
+   */
+  toAsync(e) {
+    return u.match(
+      e,
+      (s) => l.success(s),
+      (s) => l.failure(s)
+    );
+  },
+  /**
+   * Converts a `Result` to a `Validation`.
+   * @param r - The `Result` to convert.
+   * @returns A `Validation` that is equivalent to the input `Result`.
+   * @public
+   */
+  toValidation(e) {
+    return u.match(
+      e,
+      () => t.valid,
+      (s) => t.invalid(s)
+    );
+  },
+  /**
+   * Checks if a `Result` is a success.
+   * @param r - The `Result` to check.
+   * @returns `true` if the `Result` is a `Success`, `false` otherwise.
+   * @public
+   */
+  isSuccess(e) {
+    return e.type === "Success";
+  },
+  /**
+   * Checks if a `Result` is a failure.
+   * @param r - The `Result` to check.
+   * @returns `true` if the `Result` is a `Failure`, `false` otherwise.
+   * @public
+   */
+  isFailure(e) {
+    return e.type === "Failure";
+  },
+  /**
+   * Gets the value of a `Result` if it is a `Success`, otherwise returns the provided default value.
+   * @param r - The `Result` to get the value from.
+   * @param alt - The default value to return if the `Result` is a `Failure`.
+   * @returns The value of the `Result` if it is a `Success`, otherwise the default value.
+   * @public
+   */
+  getOrElse(e, s) {
+    return u.isSuccess(e) ? e.value : s;
+  },
+  /**
+   * Gets the value of a `Result` if it is a `Success`, otherwise returns the result of the provided function.
+   * @param r - The `Result` to get the value from.
+   * @param altf - The function to call if the `Result` is a `Failure`.
+   * @returns The value of the `Result` if it is a `Success`, otherwise the result of the function.
+   * @public
+   */
+  getOrElseLazy(e, s) {
+    return u.isSuccess(e) ? e.value : s();
+  },
+  /**
+   * Gets the value of a `Result` if it is a `Success`, otherwise returns `null`.
+   * @param r - The `Result` to get the value from.
+   * @returns The value of the `Result` if it is a `Success`, otherwise `null`.
+   * @public
+   */
+  getOrNull(e) {
+    return u.isSuccess(e) ? e.value : null;
+  },
+  /**
+   * Gets the value of a `Result` if it is a `Success`, otherwise returns `undefined`.
+   * @param r - The `Result` to get the value from.
+   * @returns The value of the `Result` if it is a `Success`, otherwise `undefined`.
+   * @public
+   */
+  getOrUndefined(e) {
+    return u.isSuccess(e) ? e.value : void 0;
+  },
+  /**
+   * Based on the state of the result, it picks the appropriate function to call and returns the result.
+   * @param success - The function to call if the result is a success.
+   * @param failure - The function to call if the result is a failure.
+   * @returns The result of calling the appropriate function based on the state of the result.
+   * @public
+   */
+  match: (e, s, r) => u.isSuccess(e) ? s(e.value) : r(e.error),
+  /**
+   * Calls the provided function if the result is a success.
+   * @param apply - The function to call if the result is a success.
+   * @returns A function that takes a `Result` and calls the provided function if the result is a success.
+   * @public
+   */
+  whenSuccess: (e, s) => (u.isSuccess(e) && s(e.value), e),
+  whenFailure: (e, s) => (u.isFailure(e) && s(e.error), e),
+  /**
+   * Combines two results into a single result.
+   * @param r1 - The first result.
+   * @param r2 - The second result.
+   * @param combineV - The function to combine two values.
+   * @param combineE - The function to combine two errors.
+   * @returns The combined result.
+   * @public
+   */
+  combine: (e, s, r, c) => u.match(
+    e,
+    (a) => u.match(
+      s,
+      (i) => u.success(r(a, i)),
+      (i) => u.failure(i)
+    ),
+    (a) => u.match(
+      s,
+      // eslint-disable-next-line @typescript-eslint/no-unused-vars
+      (i) => u.failure(a),
+      (i) => u.failure(c(a, i))
+    )
+  )
+};
+export {
+  u as R,
+  t as V
+};

package/result-DzdZiQoR.cjs

@@ -0,0 +1 @@
+"use strict";const a=require("./async-result.cjs"),i={valid:{type:"valid"},invalid(e){return{type:"invalid",error:e}},isValid(e){return e.type==="valid"},isInvalid(e){return e.type==="invalid"},match:(e,s,t)=>i.isValid(e)?s():t(e.error),toResult:(e,s)=>i.match(e,()=>u.success(s),t=>u.failure(t)),whenValid:(e,s)=>(i.isValid(e)&&s(),e),whenInvalid:(e,s)=>(i.isInvalid(e)&&s(e.error),e)},u={success(e){return{type:"Success",value:e}},failure(e){return{type:"Failure",error:e}},map:(e,s)=>e.type==="Success"?u.success(s(e.value)):e,flatMap:(e,s)=>e.type==="Success"?s(e.value):e,toAsync(e){return u.match(e,s=>a.AsyncResult.success(s),s=>a.AsyncResult.failure(s))},toValidation(e){return u.match(e,()=>i.valid,s=>i.invalid(s))},isSuccess(e){return e.type==="Success"},isFailure(e){return e.type==="Failure"},getOrElse(e,s){return u.isSuccess(e)?e.value:s},getOrElseLazy(e,s){return u.isSuccess(e)?e.value:s()},getOrNull(e){return u.isSuccess(e)?e.value:null},getOrUndefined(e){return u.isSuccess(e)?e.value:void 0},match:(e,s,t)=>u.isSuccess(e)?s(e.value):t(e.error),whenSuccess:(e,s)=>(u.isSuccess(e)&&s(e.value),e),whenFailure:(e,s)=>(u.isFailure(e)&&s(e.error),e),combine:(e,s,t,c)=>u.match(e,l=>u.match(s,r=>u.success(t(l,r)),r=>u.failure(r)),l=>u.match(s,r=>u.failure(l),r=>u.failure(c(l,r))))};exports.Result=u;exports.Validation=i;

package/result.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const u={success(e){return{type:"success",value:e}},failure(e){return{type:"failure",error:e}},cmap:e=>s=>s.type==="success"?u.success(e(s.value)):s,map:(e,s)=>e.type==="success"?u.success(s(e.value)):e,cflatMap:e=>s=>s.type==="success"?e(s.value):s,flatMap:(e,s)=>e.type==="success"?s(e.value):e,toAsync(e){return e},isSuccess(e){return e.type==="success"},isFailure(e){return e.type==="failure"},getOrElse(e,s){return u.isSuccess(e)?e.value:s},getOrElseLazy(e,s){return u.isSuccess(e)?e.value:s()},getOrNull(e){return u.isSuccess(e)?e.value:null},getOrUndefined(e){return u.isSuccess(e)?e.value:void 0},cmatch:(e,s)=>t=>u.isSuccess(t)?e(t.value):s(t.error),match:(e,s,t)=>u.isSuccess(e)?s(e.value):t(e.error),whenSuccess:e=>s=>(u.isSuccess(s)&&e(s.value),s),whenFailure:e=>s=>(u.isFailure(s)&&e(s.error),s),combine:(e,s,t,l)=>u.match(e,r=>u.match(s,c=>u.success(t(r,c)),c=>u.failure(c)),r=>u.match(s,c=>u.failure(r),c=>u.failure(l(r,c))))};exports.Result=u;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});require("./async-result.cjs");const e=require("./result-DzdZiQoR.cjs");exports.Result=e.Result;

package/result.d.ts

@@ -1,32 +1,156 @@
 import { AsyncResult } from './async-result';
+import { Maybe } from './domain';
+import { Validation } from './validation';
 
+/**
+ * Represents a successful result.
+ * @typeParam V - The type of the value.
+ * @public
+ */
 export interface Success<V> {
-    type: 'success';
+    type: 'Success';
     value: V;
 }
+/**
+ * Represents a failure result.
+ * @typeParam E - The type of the error.
+ * @public
+ */
 export interface Failure<E> {
-    type: 'failure';
+    type: 'Failure';
     error: E;
 }
+/**
+ * Represents a result that can either be a success or a failure.
+ * @typeParam V - The type of the value in case of success.
+ * @typeParam E - The type of the error in case of failure.
+ * @public
+ */
 export type Result<V, E> = Success<V> | Failure<E>;
+/**
+ * Represents a promise that resolves to a `Result` type.
+ * @typeParam V - The type of the value contained in the `Result`.
+ * @typeParam E - The type of the error contained in the `Result`.
+ * @public
+ */
 export type PromiseResult<V, E> = PromiseLike<Result<V, E>>;
+/**
+ * Utility functions for working with `Result` types.
+ * @public
+ */
 export declare const Result: {
+    /**
+     * Creates a successful `Result`.
+     * @param value - The value to wrap in a `Success` type.
+     * @returns A `Result` that is a `Success`.
+     * @public
+     */
     success<V>(value: V): Result<V, any>;
+    /**
+     * Creates a failure `Result`.
+     * @param error - The error to wrap in a `Failure` type.
+     * @returns A `Result` that is a `Failure`.
+     * @public
+     */
     failure<E>(error: E): Result<any, E>;
-    cmap: <V1, V2, E>(f: (value: V1) => V2) => (r: Result<V1, E>) => Result<V2, E>;
+    /**
+     * Maps the value of a `Result` to a new value.
+     * @param r - The `Result` to map.
+     * @param f - The mapping function.
+     * @returns A new `Result` with the mapped value.
+     * @public
+     */
     map: <V1, V2, E>(r: Result<V1, E>, f: (value: V1) => V2) => Result<V2, E>;
-    cflatMap: <V1, V2, E>(f: (value: V1) => Result<V2, E>) => (r: Result<V1, E>) => Result<V2, E>;
+    /**
+     * Maps the value of a `Result` to a new `Result`.
+     * @param r - The `Result` to map.
+     * @param f - The mapping function.
+     * @returns A new `Result` with the mapped value.
+     * @public
+     */
     flatMap: <V1, V2, E>(r: Result<V1, E>, f: (value: V1) => Result<V2, E>) => Result<V2, E>;
+    /**
+     * Converts a `Result` to an `AsyncResult`.
+     * @param r - The `Result` to convert.
+     * @returns An `AsyncResult` that is equivalent to the input `Result`.
+     * @public
+     */
     toAsync<V, E>(r: Result<V, E>): AsyncResult<V, E>;
+    /**
+     * Converts a `Result` to a `Validation`.
+     * @param r - The `Result` to convert.
+     * @returns A `Validation` that is equivalent to the input `Result`.
+     * @public
+     */
+    toValidation<V, E>(r: Result<V, E>): Validation<E>;
+    /**
+     * Checks if a `Result` is a success.
+     * @param r - The `Result` to check.
+     * @returns `true` if the `Result` is a `Success`, `false` otherwise.
+     * @public
+     */
     isSuccess<V, E>(r: Result<V, E>): r is Success<V>;
+    /**
+     * Checks if a `Result` is a failure.
+     * @param r - The `Result` to check.
+     * @returns `true` if the `Result` is a `Failure`, `false` otherwise.
+     * @public
+     */
     isFailure<V, E>(r: Result<V, E>): r is Failure<E>;
+    /**
+     * Gets the value of a `Result` if it is a `Success`, otherwise returns the provided default value.
+     * @param r - The `Result` to get the value from.
+     * @param alt - The default value to return if the `Result` is a `Failure`.
+     * @returns The value of the `Result` if it is a `Success`, otherwise the default value.
+     * @public
+     */
     getOrElse<V, E>(r: Result<V, E>, alt: V): V;
+    /**
+     * Gets the value of a `Result` if it is a `Success`, otherwise returns the result of the provided function.
+     * @param r - The `Result` to get the value from.
+     * @param altf - The function to call if the `Result` is a `Failure`.
+     * @returns The value of the `Result` if it is a `Success`, otherwise the result of the function.
+     * @public
+     */
     getOrElseLazy<V, E>(r: Result<V, E>, altf: () => V): V;
+    /**
+     * Gets the value of a `Result` if it is a `Success`, otherwise returns `null`.
+     * @param r - The `Result` to get the value from.
+     * @returns The value of the `Result` if it is a `Success`, otherwise `null`.
+     * @public
+     */
     getOrNull<V, E>(r: Result<V, E>): V | null;
-    getOrUndefined<V, E>(r: Result<V, E>): V | undefined;
-    cmatch: <V1, V2, E>(success: (value: V1) => V2, failure: (error: E) => V2) => (r: Result<V1, E>) => V2;
+    /**
+     * Gets the value of a `Result` if it is a `Success`, otherwise returns `undefined`.
+     * @param r - The `Result` to get the value from.
+     * @returns The value of the `Result` if it is a `Success`, otherwise `undefined`.
+     * @public
+     */
+    getOrUndefined<V, E>(r: Result<V, E>): Maybe<V>;
+    /**
+     * Based on the state of the result, it picks the appropriate function to call and returns the result.
+     * @param success - The function to call if the result is a success.
+     * @param failure - The function to call if the result is a failure.
+     * @returns The result of calling the appropriate function based on the state of the result.
+     * @public
+     */
     match: <V1, V2, E>(r: Result<V1, E>, success: (value: V1) => V2, failure: (error: E) => V2) => V2;
-    whenSuccess: <V, E>(apply: (v: V) => void) => (r: Result<V, E>) => Result<V, E>;
-    whenFailure: <V, E>(apply: (e: E) => void) => (r: Result<V, E>) => Result<V, E>;
+    /**
+     * Calls the provided function if the result is a success.
+     * @param apply - The function to call if the result is a success.
+     * @returns A function that takes a `Result` and calls the provided function if the result is a success.
+     * @public
+     */
+    whenSuccess: <V, E>(r: Result<V, E>, apply: (v: V) => void) => Result<V, E>;
+    whenFailure: <V, E>(r: Result<V, E>, apply: (e: E) => void) => Result<V, E>;
+    /**
+     * Combines two results into a single result.
+     * @param r1 - The first result.
+     * @param r2 - The second result.
+     * @param combineV - The function to combine two values.
+     * @param combineE - The function to combine two errors.
+     * @returns The combined result.
+     * @public
+     */
     combine: <V, E>(r1: Result<V, E>, r2: Result<V, E>, combineV: (v1: V, v2: V) => V, combineE: (e1: E, e2: E) => E) => Result<V, E>;
 };

package/result.js

@@ -1,56 +1,5 @@
-const u = {
-  // eslint-disable-next-line @typescript-eslint/no-explicit-any
-  success(e) {
-    return { type: "success", value: e };
-  },
-  // eslint-disable-next-line @typescript-eslint/no-explicit-any
-  failure(e) {
-    return { type: "failure", error: e };
-  },
-  cmap: (e) => (s) => s.type === "success" ? u.success(e(s.value)) : s,
-  map: (e, s) => e.type === "success" ? u.success(s(e.value)) : e,
-  cflatMap: (e) => (s) => s.type === "success" ? e(s.value) : s,
-  flatMap: (e, s) => e.type === "success" ? s(e.value) : e,
-  toAsync(e) {
-    return e;
-  },
-  isSuccess(e) {
-    return e.type === "success";
-  },
-  isFailure(e) {
-    return e.type === "failure";
-  },
-  getOrElse(e, s) {
-    return u.isSuccess(e) ? e.value : s;
-  },
-  getOrElseLazy(e, s) {
-    return u.isSuccess(e) ? e.value : s();
-  },
-  getOrNull(e) {
-    return u.isSuccess(e) ? e.value : null;
-  },
-  getOrUndefined(e) {
-    return u.isSuccess(e) ? e.value : void 0;
-  },
-  cmatch: (e, s) => (c) => u.isSuccess(c) ? e(c.value) : s(c.error),
-  match: (e, s, c) => u.isSuccess(e) ? s(e.value) : c(e.error),
-  whenSuccess: (e) => (s) => (u.isSuccess(s) && e(s.value), s),
-  whenFailure: (e) => (s) => (u.isFailure(s) && e(s.error), s),
-  combine: (e, s, c, l) => u.match(
-    e,
-    (t) => u.match(
-      s,
-      (r) => u.success(c(t, r)),
-      (r) => u.failure(r)
-    ),
-    (t) => u.match(
-      s,
-      // eslint-disable-next-line @typescript-eslint/no-unused-vars
-      (r) => u.failure(t),
-      (r) => u.failure(l(t, r))
-    )
-  )
-};
+import "./async-result.js";
+import { R as e } from "./result-Czm7RKNP.js";
 export {
-  u as Result
+  e as Result
 };

package/string.cjs

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