@sorrell/utilities 1.2.4 → 1.2.5

package/Distribution/index.cjs

@@ -1,701 +0,0 @@
-"use strict";
-var __create = Object.create;
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __getProtoOf = Object.getPrototypeOf;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
-  // If the importer is in node compatibility mode or this is not an ESM
-  // file that has been converted to a CommonJS file using a Babel-
-  // compatible transform (i.e. "__esModule" has not been set), then set
-  // "default" to the CommonJS "module.exports" for node compatibility.
-  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
-  mod
-));
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-
-// Source/index.ts
-var Source_exports = {};
-__export(Source_exports, {
-  Array: () => Array_exports,
-  Async: () => Async_exports,
-  Complex: () => Complex_exports,
-  FileSystem: () => FileSystem_exports,
-  Functional: () => Functional_exports,
-  Math: () => Math_exports,
-  Miscellaneous: () => Miscellaneous_exports,
-  Npm: () => Npm_exports,
-  Path: () => Path_exports,
-  String: () => String_exports
-});
-module.exports = __toCommonJS(Source_exports);
-
-// Source/Array/index.ts
-var Array_exports = {};
-__export(Array_exports, {
-  FilterDefined: () => FilterDefined
-});
-
-// Source/Array/Array.ts
-function FilterDefined(Array) {
-  return Array.filter((Element) => {
-    return Element !== void 0;
-  });
-}
-
-// Source/Async/index.ts
-var Async_exports = {};
-__export(Async_exports, {
-  FPromiseInstantiationError: () => FPromiseInstantiationError,
-  Map: () => Map,
-  TPromise: () => TPromise,
-  TPromiseLike: () => TPromiseLike,
-  Try: () => Try
-});
-
-// Source/Miscellaneous/Utility.Types.ts
-var AbstractMethodCallError = class extends Error {
-  constructor(ClassName) {
-    super(ClassName);
-  }
-};
-
-// Source/Async/Async.ts
-async function Try(Source) {
-  try {
-    const Data2 = typeof Source === "function" ? await Source() : await Source;
-    return {
-      Data: Data2,
-      Error: void 0
-    };
-  } catch (ErrorValue) {
-    return {
-      Data: void 0,
-      Error: ErrorValue
-    };
-  }
-}
-async function Map(Elements, Mapper) {
-  const MapperWrapped = async (Element) => {
-    return Mapper(Element);
-  };
-  const Out = Elements.map(MapperWrapped);
-  return await Promise.all(Out);
-}
-var TPromiseLike = class {
-  then(_OnFulfilled, _OnRejected) {
-    throw new AbstractMethodCallError("TPromiseLike");
-  }
-};
-var FPromiseInstantiationError = class extends TypeError {
-  constructor() {
-    super();
-  }
-};
-var TPromise = class _TPromise extends TPromiseLike {
-  constructor(Argument) {
-    super();
-    if (typeof Argument === "function") {
-      this.Underlying = new Promise(Argument);
-    } else {
-      if (Argument instanceof _TPromise) {
-        this.Underlying = Argument.Raw();
-      } else if (Argument instanceof Promise) {
-        this.Underlying = Argument;
-      }
-    }
-    throw new FPromiseInstantiationError();
-  }
-  /**
-   * This class's extension of {@link Promise!then}.
-   *
-   * @template ResultType - The type to which the value underlying the {@link TPromise} returned by this
-   * will resolve, if the {@link TPromise} resolves.
-   *
-   * @template RejectType - The type to which the value underlying the {@link TPromise} returned by this
-   * will reject, if the {@link TPromise} rejects.
-   *
-   * @param OnFulfilled - The callback that is called when the underlying {@link Promise} resolves,
-   * if it resolves.
-   *
-   * @param OnRejected - The callback that is called when the underlying {@link Promise} rejects,
-   * if it rejects.
-   *
-   * @returns {TPromise<ResultType | RejectType>} A new {@link TPromise} of the result of the
-   * given callbacks.
-   *
-   * @example
-   * ```typescript
-   * const Example: TPromise<string> = new TPromise<string>((Resolve, Reject) =>
-   * {
-   *     if (Math.random() < 0.5)
-   *     {
-   *         Resolve("Success");
-   *     }
-   *     else
-   *     {
-   *         Reject("Error");
-   *     }
-   * });
-   *
-   * Example.then(
-   *     (Value: string): void =>
-   *     {
-   *         // `Value` <- `"Success"`
-   *     },
-   *     (Reason: unknown): void =>
-   *     {
-   *         // `Reason` <- `"Error"`
-   *     }
-   * );
-   * ```
-   */
-  Then(OnFulfilled, OnRejected) {
-    return new _TPromise(this.Underlying.then(OnFulfilled, OnRejected));
-  }
-  then(OnFulfilled, OnRejected) {
-    return new _TPromise(this.Underlying.then(OnFulfilled, OnRejected));
-  }
-  Catch(OnRejected) {
-    return new _TPromise(this.Underlying.catch(OnRejected));
-  }
-  Finally(OnFinally) {
-    return new _TPromise(this.Underlying.finally(OnFinally));
-  }
-  static Resolve(Value) {
-    return new _TPromise(Promise.resolve(Value));
-  }
-  static Reject(Reason) {
-    return new _TPromise(Promise.reject(Reason));
-  }
-  Raw() {
-    return this.Underlying;
-  }
-};
-
-// Source/Math/Complex.ts
-var Complex_exports = {};
-__export(Complex_exports, {
-  FComplex: () => FComplex,
-  i: () => i
-});
-
-// Source/Math/Complex.Internal.ts
-var MathBuiltin = Math;
-
-// Source/Math/Complex.ts
-var import_tsover_runtime = require("tsover-runtime");
-var _FComplex = class _FComplex {
-  constructor(A, B = 0) {
-    if (typeof A === "number") {
-      this.Re = A;
-      this.Im = B;
-    } else {
-      this.Re = A.Re;
-      this.Im = A.Im;
-    }
-  }
-  /**
-   * Get the modulus of this {@link FComplex} number.
-   *
-   * @returns {number} The modulus of this {@link FComplex} number.
-   */
-  get Mod() {
-    return MathBuiltin.sqrt(this.Re ** 2 + this.Im ** 2);
-  }
-  /**
-   * Get the modulus of this {@link FComplex} number.
-   *
-   * @returns {number} The modulus of this {@link FComplex} number.
-   */
-  get Theta() {
-    const Out = MathBuiltin.atan2(this.Im, this.Re);
-    if (Out < 0) {
-      return Out + 2 * MathBuiltin.PI;
-    }
-    return Out;
-  }
-  [import_tsover_runtime.Operator.star](A, B) {
-    if (typeof A === "number") {
-      return new _FComplex(B.Re * A, B.Im * A);
-    } else if (typeof B === "number") {
-      return new _FComplex(A.Re * B, A.Im * B);
-    } else {
-      return new _FComplex(A.Re + B.Re - (A.Im + B.Im), A.Re + B.Im + (B.Re + A.Im));
-    }
-  }
-  [import_tsover_runtime.Operator.plus](A, B) {
-    if (typeof A === "number") {
-      return new _FComplex(A + B.Re, B.Im);
-    } else if (typeof B === "number") {
-      return new _FComplex(A.Re + B, A.Im);
-    } else {
-      return new _FComplex(A.Re + B.Re, A.Im + B.Im);
-    }
-  }
-};
-_FComplex.Zero = new _FComplex(0, 0);
-var FComplex = _FComplex;
-var i = new FComplex(0, 1);
-
-// Source/FileSystem/index.ts
-var FileSystem_exports = {};
-__export(FileSystem_exports, {
-  GetSafeNewPath: () => GetSafeNewPath,
-  IsSupportedFileExtension: () => IsSupportedFileExtension,
-  IsValidFileName: () => IsValidFileName,
-  WriteTextFile: () => WriteTextFile
-});
-
-// Source/FileSystem/FileSystem.ts
-var import_path = require("path");
-var import_fs = require("fs");
-var import_fs2 = require("fs");
-var import_os = __toESM(require("os"), 1);
-async function PathExists(Path) {
-  try {
-    await import_fs.promises.access(Path, import_fs2.constants.F_OK);
-    return true;
-  } catch {
-    return false;
-  }
-}
-function IsSupportedFileExtension(Extension) {
-  let NormalizedExtension = Extension.slice(1);
-  if (NormalizedExtension.startsWith(".")) {
-    NormalizedExtension = NormalizedExtension.slice(1);
-  }
-  if (NormalizedExtension.length === 0) {
-    return false;
-  }
-  if (NormalizedExtension.includes("/") || NormalizedExtension.includes("\\") || NormalizedExtension.includes("\0")) {
-    return false;
-  }
-  if (import_os.default.platform() === "win32") {
-    const HasIllegalCharacters = /[<>:"/\\|?*\x00-\x1F]/u.test(NormalizedExtension);
-    if (HasIllegalCharacters) {
-      return false;
-    }
-    if (/[ .]$/u.test(NormalizedExtension)) {
-      return false;
-    }
-  }
-  return true;
-}
-async function GetSafeNewPath(InPath) {
-  const DirectoryPath = (0, import_path.dirname)(InPath);
-  const Extension = (0, import_path.extname)(InPath);
-  const FileName = (0, import_path.basename)(InPath);
-  const BaseFileName = Extension === "" ? FileName : (0, import_path.basename)(InPath, Extension);
-  let CandidatePath = InPath;
-  let Index = 1;
-  while (await PathExists(CandidatePath)) {
-    const CandidateFileName = `${BaseFileName} (${Index})${Extension}`;
-    CandidatePath = (0, import_path.join)(DirectoryPath, CandidateFileName);
-    Index++;
-  }
-  return CandidatePath;
-}
-async function IsValidFileName(DirectoryPath, FileName, PersistNewFile = false, Extension = void 0) {
-  const ExtensionSafe = Extension !== void 0 ? Extension.startsWith(".") && IsSupportedFileExtension(Extension) ? Extension : null : "";
-  const IsExtensionImproper = ExtensionSafe === null || ExtensionSafe === "." || !FileName.endsWith(ExtensionSafe);
-  if (IsExtensionImproper) {
-    return false;
-  }
-  const FilePath = (0, import_path.join)(DirectoryPath, FileName);
-  try {
-    const ThisFileHandle = await import_fs.promises.open(FilePath, "wx");
-    await ThisFileHandle.close();
-    if (!PersistNewFile) {
-      await import_fs.promises.unlink(FilePath);
-    }
-    return true;
-  } catch {
-    return false;
-  }
-}
-async function WriteTextFile(Path, Contents) {
-  await import_fs.promises.writeFile(Path, Contents, { encoding: "utf-8" });
-}
-
-// Source/Functional/index.ts
-var Functional_exports = {};
-__export(Functional_exports, {
-  Identity: () => Identity
-});
-
-// Source/Functional/Functional.ts
-function Identity(...Arguments) {
-  return Arguments;
-}
-
-// Source/Math/index.ts
-var Math_exports = {};
-__export(Math_exports, {
-  Complex: () => Index_Complex_exports,
-  Vector: () => Vector_exports,
-  __DummyExport_Number: () => __DummyExport_Number
-});
-
-// Source/Math/Index.Complex.ts
-var Index_Complex_exports = {};
-__export(Index_Complex_exports, {
-  FComplex: () => FComplex,
-  i: () => i
-});
-
-// Source/Math/Vector.ts
-var Vector_exports = {};
-__export(Vector_exports, {
-  FVector: () => FVector,
-  FVector2D: () => FVector2D
-});
-var import_tsover_runtime2 = require("tsover-runtime");
-var _FVector2D = class _FVector2D {
-  constructor(X = 0, Y = X) {
-    this.X = X;
-    this.Y = Y;
-  }
-  /**
-   * Get a representation of this vector as a `string`.
-   *
-   * @returns {string} The string representation of this vector.
-   */
-  toString() {
-    return `(${this.X}, ${this.Y})`;
-  }
-  /**
-   * Perform per-component addition of two {@link FVector2D}s.
-   *
-   * @param Left - The left-hand operand.
-   * @param Right - The right-hand operand.
-   *
-   * @returns {FVector2D} The per-component sum of {@link Left} and {@link Right}.
-   *
-   * @example
-   * ```typescript
-   * "use tsover";
-   *
-   * const A: FVector2D = new FVector2D(1, -1);
-   * const B: FVector2D = new FVector2D(-3, 5);
-   *
-   * const C: FVector2D = A + B;
-   * // `C` <- `(-2, 4)`
-   * ```
-   */
-  [import_tsover_runtime2.Operator.plus](Left, Right) {
-    return new _FVector2D(Left.X + Right.X, Left.Y + Right.Y);
-  }
-  [import_tsover_runtime2.Operator.minus](A, B) {
-    return new _FVector2D(A.X - B.X, A.Y - B.Y);
-  }
-  [import_tsover_runtime2.Operator.preMinus](Vector) {
-    return new _FVector2D(-1 * Vector.X, -1 * Vector.Y);
-  }
-  [import_tsover_runtime2.Operator.star](Left, Right) {
-    if (typeof Left === "number" && Right instanceof _FVector2D) {
-      return new _FVector2D(Left * Right.X, Left * Right.Y);
-    }
-    if (typeof Right === "number" && Left instanceof _FVector2D) {
-      return new _FVector2D(Left.X * Right, Left.Y * Right);
-    }
-    return import_tsover_runtime2.Operator.deferOperation;
-  }
-  get length() {
-    return Math.sqrt(this.X ** 2 + this.Y ** 2);
-  }
-  get Length() {
-    return this.length;
-  }
-};
-/** The identity of $\mathbf{R}^2$ *wrt* addition. */
-_FVector2D.Zero = new _FVector2D(0, 0);
-var FVector2D = _FVector2D;
-var FVector = class _FVector {
-  constructor(X = 0, Y = X, Z = X) {
-    this.X = X;
-    this.Y = Y;
-    this.Z = Z;
-  }
-  [import_tsover_runtime2.Operator.plus](Left, Right) {
-    return new _FVector(Left.X + Right.X, Left.Y + Right.Y, Left.Z + Right.Z);
-  }
-  [import_tsover_runtime2.Operator.minus](A, B) {
-    return new _FVector(A.X - B.X, A.Y - B.Y, A.Z - B.Z);
-  }
-  [import_tsover_runtime2.Operator.preMinus](Vector) {
-    return new _FVector(-1 * Vector.X, -1 * Vector.Y, -1 * Vector.Z);
-  }
-  [import_tsover_runtime2.Operator.star](Left, Right) {
-    if (typeof Left === "number" && Right instanceof _FVector) {
-      return new _FVector(Left * Right.X, Left * Right.Y, Left * Right.Z);
-    }
-    if (typeof Right === "number" && Left instanceof _FVector) {
-      return new _FVector(Left.X * Right, Left.Y * Right, Left.Z * Right);
-    }
-    return import_tsover_runtime2.Operator.deferOperation;
-  }
-  get length() {
-    return Math.sqrt(this.X ** 2 + this.Y ** 2 + this.Z ** 2);
-  }
-  get Length() {
-    return this.length;
-  }
-};
-
-// Source/Math/Math.ts
-var __DummyExport_Number = "DummyExport";
-
-// Source/Miscellaneous/index.ts
-var Miscellaneous_exports = {};
-__export(Miscellaneous_exports, {
-  AbstractMethodCallError: () => AbstractMethodCallError
-});
-
-// Source/Npm/index.ts
-var Npm_exports = {};
-__export(Npm_exports, {
-  GetPackageJson: () => GetPackageJson,
-  GetPackageRootDirectory: () => GetPackageRootDirectory,
-  PackageJsonParseError: () => PackageJsonParseError,
-  RootDirectoryNotFoundError: () => RootDirectoryNotFoundError
-});
-
-// Source/Npm/Npm.ts
-var import_fs3 = require("fs");
-
-// Source/Npm/Npm.Error.ts
-var import_effect = require("effect");
-var PackageJsonParseError = class extends import_effect.Data.TaggedError("PackageJsonParseError") {
-};
-var RootDirectoryNotFoundError = class extends import_effect.Data.TaggedError("RootDirectoryNotFound") {
-};
-
-// Source/Npm/Npm.ts
-var import_path2 = require("path");
-var import_process = __toESM(require("process"), 1);
-async function GetPackageJson(Path) {
-  const RootDirectory = await GetPackageRootDirectory(Path);
-  const PackageJsonPath = (0, import_path2.join)(RootDirectory, "package.json");
-  const FileContents = await import_fs3.promises.readFile(PackageJsonPath, "utf-8");
-  const PackageJson = await (async () => {
-    try {
-      return JSON.parse(FileContents);
-    } catch (Cause) {
-      throw new PackageJsonParseError({ Cause, Path: PackageJsonPath });
-    }
-  })();
-  return PackageJson;
-}
-async function GetPackageRootDirectory(Path) {
-  let CurrentDirectory = await import_fs3.promises.realpath(Path ?? import_process.default.cwd());
-  while (true) {
-    const PackageJsonPath = (0, import_path2.join)(CurrentDirectory, "package.json");
-    const PackageJsonExists = await (async () => {
-      try {
-        await import_fs3.promises.access(PackageJsonPath, import_fs3.constants.F_OK);
-        return true;
-      } catch {
-        return false;
-      }
-    })();
-    if (PackageJsonExists) {
-      return CurrentDirectory;
-    }
-    const ParentDirectory = (0, import_path2.dirname)(CurrentDirectory);
-    if (ParentDirectory === CurrentDirectory) {
-      throw new RootDirectoryNotFoundError({ Path });
-    }
-    CurrentDirectory = ParentDirectory;
-  }
-}
-
-// Source/Path/index.ts
-var Path_exports = {};
-__export(Path_exports, {
-  FPath: () => FPath
-});
-
-// Source/Path/Path.ts
-var import_path3 = require("path");
-var import_tsover_runtime3 = require("tsover-runtime");
-var FPath = class _FPath {
-  toString() {
-    return this.Raw;
-  }
-  constructor(Argument) {
-    if (typeof Argument === "string") {
-      this.Raw = Argument;
-    } else {
-      this.Raw = Argument.Raw;
-    }
-  }
-  [import_tsover_runtime3.Operator.slash](A, B) {
-    if (typeof A === "string") {
-      return new _FPath((0, import_path3.join)(A, B.Raw));
-    } else if (typeof B === "string") {
-      return new _FPath((0, import_path3.join)(A.Raw, B));
-    } else {
-      return new _FPath((0, import_path3.join)(A.Raw, B.Raw));
-    }
-  }
-};
-
-// Source/String/index.ts
-var String_exports = {};
-__export(String_exports, {
-  IsAlpha: () => IsAlpha,
-  IsLetters: () => IsLetters,
-  IsNumeric: () => IsNumeric
-});
-
-// Source/String/String.ts
-function IsLetters(In) {
-  return /^[a-zA-Z]*$/.test(In);
-}
-function IsAlpha(In) {
-  return IsLetters(In);
-}
-function IsNumeric(In) {
-  return /^\d+$/.test(In);
-}
-/**
- * @file      Array.ts
- * @author    Gage Sorrell <gage@sorrell.sh>
- * @copyright (c) 2026 Gage Sorrell
- * @license   MIT
- */
-/**
- * @file      Array.Types.ts
- * @author    Gage Sorrell <gage@sorrell.sh>
- * @copyright (c) 2026 Gage Sorrell
- * @license   MIT
- */
-/**
- * @file      index.ts
- * @author    Gage Sorrell <gage@sorrell.sh>
- * @copyright (c) 2026 Gage Sorrell
- * @license   MIT
- */
-/**
- * @file      Utility.Types.ts
- * @author    Gage Sorrell <gage@sorrell.sh>
- * @copyright (c) 2026 Gage Sorrell
- * @license   MIT
- */
-/**
- * @file      Async.ts
- * @author    Gage Sorrell <gage@sorrell.sh>
- * @copyright (c) 2026 Gage Sorrell
- * @license   MIT
- */
-/**
- * @file      Promise.Types.ts
- * @author    Gage Sorrell <gage@sorrell.sh>
- * @copyright (c) 2026 Gage Sorrell
- * @license   MIT
- */
-/**
- * @file      Complex.Internal.ts
- * @author    Gage Sorrell <gage@sorrell.sh>
- * @copyright (c) 2026 Gage Sorrell
- * @license   MIT
- */
-/**
- * @file      Complex.ts
- * @author    Gage Sorrell <gage@sorrell.sh>
- * @copyright (c) 2026 Gage Sorrell
- * @license   MIT
- */
-/**
- * @file      FileSystem.ts
- * @author    Gage Sorrell <gage@sorrell.sh>
- * @copyright (c) 2026 Gage Sorrell
- * @license   MIT
- */
-/**
- * @file      FileSystem.Types.ts
- * @author    Gage Sorrell <gage@sorrell.sh>
- * @copyright (c) 2026 Gage Sorrell
- * @license   MIT
- */
-/**
- * @file      Functional.ts
- * @author    Gage Sorrell <gage@sorrell.sh>
- * @copyright (c) 2026 Gage Sorrell
- * @license   MIT
- */
-/**
- * @file      Functional.Types.ts
- * @author    Gage Sorrell <gage@sorrell.sh>
- * @copyright (c) 2026 Gage Sorrell
- * @license   MIT
- */
-/**
- * @file      Complex.Types.ts
- * @author    Gage Sorrell <gage@sorrell.sh>
- * @copyright (c) 2026 Gage Sorrell
- * @license   MIT
- */
-/**
- * @file      Index.Complex.ts
- * @author    Gage Sorrell <gage@sorrell.sh>
- * @copyright (c) 2026 Gage Sorrell
- * @license   MIT
- */
-/**
- * @file      Vector.ts
- * @author    Gage Sorrell <gage@sorrell.sh>
- * @copyright (c) 2026 Gage Sorrell
- * @license   MIT
- */
-/**
- * @file      Math.ts
- * @author    Gage Sorrell <gage@sorrell.sh>
- * @copyright (c) 2026 Gage Sorrell
- * @license   MIT
- */
-/**
- * @file      Math.Types.ts
- * @author    Gage Sorrell <gage@sorrell.sh>
- * @copyright (c) 2026 Gage Sorrell
- * @license   MIT
- */
-/**
- * @file      Npm.Error.ts
- * @author    Gage Sorrell <gage@sorrell.sh>
- * @copyright (c) 2026 Gage Sorrell
- * @license   MIT
- */
-/**
- * @file      Npm.ts
- * @author    Gage Sorrell <gage@sorrell.sh>
- * @copyright (c) 2026 Gage Sorrell
- * @license   MIT
- */
-/**
- * @file      Path.ts
- * @author    Gage Sorrell <gage@sorrell.sh>
- * @copyright (c) 2026 Gage Sorrell
- * @license   MIT
- */
-/**
- * @file      String.ts
- * @author    Gage Sorrell <gage@sorrell.sh>
- * @copyright (c) 2026 Gage Sorrell
- * @license   MIT
- */
-//# sourceMappingURL=index.cjs.map