@sorrell/utilities 1.2.9 → 1.2.12

package/Distribution/string.cjs

@@ -0,0 +1,70 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+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 __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// Source/String/index.ts
+var String_exports = {};
+__export(String_exports, {
+  Dedent: () => Dedent,
+  IsAlpha: () => IsAlpha,
+  IsLetters: () => IsLetters,
+  IsNumeric: () => IsNumeric
+});
+module.exports = __toCommonJS(String_exports);
+
+// Source/String/String.ts
+function IsLetters(TestString) {
+  return /^[a-zA-Z]*$/.test(TestString);
+}
+function IsAlpha(TestString) {
+  return IsLetters(TestString);
+}
+function IsNumeric(TestString) {
+  return /^\d+$/.test(TestString);
+}
+function Dedent(Content, IndentLength) {
+  const WhitespaceSubstring = (() => {
+    if (IndentLength !== void 0) {
+      return "\n" + " ".repeat(IndentLength);
+    }
+    let WhitespaceSubstring2 = "\n";
+    while (true) {
+      const TestString = WhitespaceSubstring2 + "  ";
+      if (Content.includes(TestString)) {
+        WhitespaceSubstring2 = TestString;
+      } else {
+        break;
+      }
+    }
+    return WhitespaceSubstring2;
+  })();
+  return Content.replaceAll(WhitespaceSubstring, "");
+}
+/**
+ * @file      String.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
+ */
+//# sourceMappingURL=string.cjs.map

package/Distribution/string.cjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../Source/String/index.ts", "../Source/String/String.ts"],
+  "sourcesContent": ["/**\n * @file      index.ts\n * @author    Gage Sorrell <gage@sorrell.sh>\n * @copyright (c) 2026 Gage Sorrell\n * @license   MIT\n */\nexport * from \"./String.ts\";\n", "/**\n * @file      String.ts\n * @author    Gage Sorrell <gage@sorrell.sh>\n * @copyright (c) 2026 Gage Sorrell\n * @license   MIT\n */\n/**\n * @module String\n * Functions for manipulating strings.\n */\n// @TODO TEMPORARY.\n/* eslint-disable jsdoc/require-example */\n/**\n * Does the given {@link TestString} contain only letters?\n * This is equivalent to Python's\n * {@link https://docs.python.org/3/library/stdtypes.html#str.isalpha | isalpha} function.\n *\n * @remarks This is an alias for {@link IsAlpha}.\n *\n * @param TestString - The string that you wish to test.\n *\n * @returns {boolean} Whether the given string contains *only* (Latin alphabet) letters.\n */\nexport function IsLetters(TestString: string): boolean {\n    return /^[a-zA-Z]*$/.test(TestString);\n}\n/**\n * Does the given {@link TestString} contain only letters?\n * This is equivalent to Python's\n * {@link https://docs.python.org/3/library/stdtypes.html#str.isalpha | isalpha} function.\n *\n * @param TestString - The string that you wish to test.\n *\n * @returns {boolean} Whether the given string contains *only* (Latin alphabet) letters.\n */\nexport function IsAlpha(TestString: string): boolean {\n    return IsLetters(TestString);\n}\n/**\n * Does the given {@link TestString} contain only digits?\n *\n * This is equivalent to Python's\n * {@link https://docs.python.org/3/library/stdtypes.html#str.isnumeric | isnumeric} function.\n *\n * @param TestString - The string that you wish to test.\n *\n * @returns {boolean} Whether the given string contains *only* numeric digits.\n */\nexport function IsNumeric(TestString: string): boolean {\n    return /^\\d+$/.test(TestString);\n}\n/**\n * This function provides a convenient way to define long strings across multiple lines.\n * The linebreaks and leading indentation are removed from the final string.\n * Please see the example below for how this is to be done.\n *\n * @param Content - The given string to dedent.\n * @param IndentLength - The number of spaces for which this function will check.  This\n * is necessary only if the number of spaces used in the {@link Content} is not a multiple\n * of two.\n *\n * @returns {string} The given {@link Content}, but with the spaces at the beginning\n * of each line (excluding the first line if no spaces exist in the first line) removed.\n *\n * @example\n * ```typescript\n * import { Dedent } from \"@sorrell/utilities/string\";\n *\n * const MyLongString: string = Dedent(`Lorem ipsum dolor sit amet, consectetur adipiscing elit,\n *             sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad\n *                 minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea\n *             commodo consequat.`);\n *\n * // `MyLongString` <- `\"Lorem ipsum dolor sit amet, consectetur adipiscing elit, \\\n * sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad \\\n *     minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea \\\n * commodo consequat.\"`\n * ```\n */\nexport function Dedent(Content: string, IndentLength?: number): string {\n    const WhitespaceSubstring: string = ((): string => {\n        if (IndentLength !== undefined) {\n            return \"\\n\" + \" \".repeat(IndentLength);\n        }\n        let WhitespaceSubstring: string = \"\\n\";\n        while (true) {\n            const TestString: string = WhitespaceSubstring + \"  \";\n            if (Content.includes(TestString)) {\n                WhitespaceSubstring = TestString;\n            }\n            else {\n                break;\n            }\n        }\n        return WhitespaceSubstring;\n    })();\n    return Content.replaceAll(WhitespaceSubstring, \"\");\n}\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACuBO,SAAS,UAAU,YAA6B;AACnD,SAAO,cAAc,KAAK,UAAU;AACxC;AAUO,SAAS,QAAQ,YAA6B;AACjD,SAAO,UAAU,UAAU;AAC/B;AAWO,SAAS,UAAU,YAA6B;AACnD,SAAO,QAAQ,KAAK,UAAU;AAClC;AA6BO,SAAS,OAAO,SAAiB,cAA+B;AACnE,QAAM,uBAA+B,MAAc;AAC/C,QAAI,iBAAiB,QAAW;AAC5B,aAAO,OAAO,IAAI,OAAO,YAAY;AAAA,IACzC;AACA,QAAIA,uBAA8B;AAClC,WAAO,MAAM;AACT,YAAM,aAAqBA,uBAAsB;AACjD,UAAI,QAAQ,SAAS,UAAU,GAAG;AAC9B,QAAAA,uBAAsB;AAAA,MAC1B,OACK;AACD;AAAA,MACJ;AAAA,IACJ;AACA,WAAOA;AAAA,EACX,GAAG;AACH,SAAO,QAAQ,WAAW,qBAAqB,EAAE;AACrD;",
+  "names": ["WhitespaceSubstring"]
+}

package/Distribution/string.js

@@ -0,0 +1,47 @@
+// Source/String/String.ts
+function IsLetters(TestString) {
+  return /^[a-zA-Z]*$/.test(TestString);
+}
+function IsAlpha(TestString) {
+  return IsLetters(TestString);
+}
+function IsNumeric(TestString) {
+  return /^\d+$/.test(TestString);
+}
+function Dedent(Content, IndentLength) {
+  const WhitespaceSubstring = (() => {
+    if (IndentLength !== void 0) {
+      return "\n" + " ".repeat(IndentLength);
+    }
+    let WhitespaceSubstring2 = "\n";
+    while (true) {
+      const TestString = WhitespaceSubstring2 + "  ";
+      if (Content.includes(TestString)) {
+        WhitespaceSubstring2 = TestString;
+      } else {
+        break;
+      }
+    }
+    return WhitespaceSubstring2;
+  })();
+  return Content.replaceAll(WhitespaceSubstring, "");
+}
+export {
+  Dedent,
+  IsAlpha,
+  IsLetters,
+  IsNumeric
+};
+/**
+ * @file      String.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
+ */
+//# sourceMappingURL=string.js.map

package/Distribution/string.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../Source/String/String.ts"],
+  "sourcesContent": ["/**\n * @file      String.ts\n * @author    Gage Sorrell <gage@sorrell.sh>\n * @copyright (c) 2026 Gage Sorrell\n * @license   MIT\n */\n/**\n * @module String\n * Functions for manipulating strings.\n */\n// @TODO TEMPORARY.\n/* eslint-disable jsdoc/require-example */\n/**\n * Does the given {@link TestString} contain only letters?\n * This is equivalent to Python's\n * {@link https://docs.python.org/3/library/stdtypes.html#str.isalpha | isalpha} function.\n *\n * @remarks This is an alias for {@link IsAlpha}.\n *\n * @param TestString - The string that you wish to test.\n *\n * @returns {boolean} Whether the given string contains *only* (Latin alphabet) letters.\n */\nexport function IsLetters(TestString: string): boolean {\n    return /^[a-zA-Z]*$/.test(TestString);\n}\n/**\n * Does the given {@link TestString} contain only letters?\n * This is equivalent to Python's\n * {@link https://docs.python.org/3/library/stdtypes.html#str.isalpha | isalpha} function.\n *\n * @param TestString - The string that you wish to test.\n *\n * @returns {boolean} Whether the given string contains *only* (Latin alphabet) letters.\n */\nexport function IsAlpha(TestString: string): boolean {\n    return IsLetters(TestString);\n}\n/**\n * Does the given {@link TestString} contain only digits?\n *\n * This is equivalent to Python's\n * {@link https://docs.python.org/3/library/stdtypes.html#str.isnumeric | isnumeric} function.\n *\n * @param TestString - The string that you wish to test.\n *\n * @returns {boolean} Whether the given string contains *only* numeric digits.\n */\nexport function IsNumeric(TestString: string): boolean {\n    return /^\\d+$/.test(TestString);\n}\n/**\n * This function provides a convenient way to define long strings across multiple lines.\n * The linebreaks and leading indentation are removed from the final string.\n * Please see the example below for how this is to be done.\n *\n * @param Content - The given string to dedent.\n * @param IndentLength - The number of spaces for which this function will check.  This\n * is necessary only if the number of spaces used in the {@link Content} is not a multiple\n * of two.\n *\n * @returns {string} The given {@link Content}, but with the spaces at the beginning\n * of each line (excluding the first line if no spaces exist in the first line) removed.\n *\n * @example\n * ```typescript\n * import { Dedent } from \"@sorrell/utilities/string\";\n *\n * const MyLongString: string = Dedent(`Lorem ipsum dolor sit amet, consectetur adipiscing elit,\n *             sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad\n *                 minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea\n *             commodo consequat.`);\n *\n * // `MyLongString` <- `\"Lorem ipsum dolor sit amet, consectetur adipiscing elit, \\\n * sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad \\\n *     minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea \\\n * commodo consequat.\"`\n * ```\n */\nexport function Dedent(Content: string, IndentLength?: number): string {\n    const WhitespaceSubstring: string = ((): string => {\n        if (IndentLength !== undefined) {\n            return \"\\n\" + \" \".repeat(IndentLength);\n        }\n        let WhitespaceSubstring: string = \"\\n\";\n        while (true) {\n            const TestString: string = WhitespaceSubstring + \"  \";\n            if (Content.includes(TestString)) {\n                WhitespaceSubstring = TestString;\n            }\n            else {\n                break;\n            }\n        }\n        return WhitespaceSubstring;\n    })();\n    return Content.replaceAll(WhitespaceSubstring, \"\");\n}\n"],
+  "mappings": ";AAuBO,SAAS,UAAU,YAA6B;AACnD,SAAO,cAAc,KAAK,UAAU;AACxC;AAUO,SAAS,QAAQ,YAA6B;AACjD,SAAO,UAAU,UAAU;AAC/B;AAWO,SAAS,UAAU,YAA6B;AACnD,SAAO,QAAQ,KAAK,UAAU;AAClC;AA6BO,SAAS,OAAO,SAAiB,cAA+B;AACnE,QAAM,uBAA+B,MAAc;AAC/C,QAAI,iBAAiB,QAAW;AAC5B,aAAO,OAAO,IAAI,OAAO,YAAY;AAAA,IACzC;AACA,QAAIA,uBAA8B;AAClC,WAAO,MAAM;AACT,YAAM,aAAqBA,uBAAsB;AACjD,UAAI,QAAQ,SAAS,UAAU,GAAG;AAC9B,QAAAA,uBAAsB;AAAA,MAC1B,OACK;AACD;AAAA,MACJ;AAAA,IACJ;AACA,WAAOA;AAAA,EACX,GAAG;AACH,SAAO,QAAQ,WAAW,qBAAqB,EAAE;AACrD;",
+  "names": ["WhitespaceSubstring"]
+}

package/Distribution/tsconfig.cjs

@@ -0,0 +1,31 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+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 __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// Source/TsConfig/index.ts
+var TsConfig_exports = {};
+module.exports = __toCommonJS(TsConfig_exports);
+/**
+ * @file      TsConfig.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
+ */
+//# sourceMappingURL=tsconfig.cjs.map

package/Distribution/tsconfig.cjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../Source/TsConfig/index.ts"],
+  "sourcesContent": ["/**\n * @file      index.ts\n * @author    Gage Sorrell <gage@sorrell.sh>\n * @copyright (c) 2026 Gage Sorrell\n * @license   MIT\n */\nexport * from \"./TsConfig.Types.ts\";\n"],
+  "mappings": ";;;;;;;;;;;;;;;;AAAA;AAAA;",
+  "names": []
+}

package/Distribution/tsconfig.js

@@ -0,0 +1,13 @@
+/**
+ * @file      TsConfig.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
+ */
+//# sourceMappingURL=tsconfig.js.map

package/Distribution/tsconfig.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [],
+  "mappings": "",
+  "names": []
+}

package/package.json

@@ -1,13 +1,19 @@
 {
     "name": "@sorrell/utilities",
-    "version": "1.2.9",
+    "version": "1.2.12",
     "private": false,
     "description": "Various TypeScript utilities.",
     "keywords": [
         "utility",
         "utilities",
+        "effect",
         "typescript",
-        "ts"
+        "ts",
+        "sorrell",
+        "git",
+        "file-system",
+        "fs",
+        "math"
     ],
     "homepage": "https://utilities.sorrell.sh",
     "bugs": {
@@ -26,9 +32,11 @@
     },
     "type": "module",
     "files": [
-        "./Distribution/**/*",
-        "./ReadMe.md",
-        "./package.json"
+        "Distribution",
+        "Distribution/**/*",
+        "ReadMe.md",
+        "License.md",
+        "package.json"
     ],
     "exports": {
         ".": {
@@ -101,6 +109,16 @@
                 "default": "./Distribution/functional.cjs"
             }
         },
+        "./higher-kind": {
+            "import": {
+                "types": "./Distribution/Types/HigherKind/index.d.mts",
+                "default": "./Distribution/higher-kind.js"
+            },
+            "require": {
+                "types": "./Distribution/Types/HigherKind/index.d.cts",
+                "default": "./Distribution/higher-kind.cjs"
+            }
+        },
         "./dependency": {
             "import": {
                 "types": "./Distribution/Types/Dependency/index.d.mts",
@@ -180,6 +198,26 @@
                 "types": "./Distribution/Types/Record/index.d.cts",
                 "default": "./Distribution/record.cjs"
             }
+        },
+        "./string": {
+            "import": {
+                "types": "./Distribution/Types/String/index.d.mts",
+                "default": "./Distribution/string.js"
+            },
+            "require": {
+                "types": "./Distribution/Types/String/index.d.cts",
+                "default": "./Distribution/string.cjs"
+            }
+        },
+        "./tsconfig": {
+            "import": {
+                "types": "./Distribution/Types/TsConfig/index.d.mts",
+                "default": "./Distribution/tsconfig.js"
+            },
+            "require": {
+                "types": "./Distribution/Types/TsConfig/index.d.cts",
+                "default": "./Distribution/tsconfig.cjs"
+            }
         }
     },
     "overrides": {
@@ -208,7 +246,7 @@
         "ts-node": "^10.9.2",
         "tslib": "^2.8.1",
         "tsover": "^6.0.0",
-        "tsover-runtime": "0.0.6"
+        "tsover-runtime": "0.0.7"
     },
     "dependencies": {
         "chalk": "^5.6.2",
@@ -217,6 +255,6 @@
     },
     "peerDependencies": {
         "tsover": "^6.0.0",
-        "tsover-runtime": "^0.0.6"
+        "tsover-runtime": "^0.0.7"
     }
 }

package/Distribution/Types/Effect/Effect.d.cts.map

@@ -1,10 +0,0 @@
-{
-    "version": 3,
-    "file": "Effect.d.cts",
-    "sourceRoot": "",
-    "sources": [
-        "../../../Source/Effect/Effect.ts"
-    ],
-    "names": [],
-    "mappings": "AAAA;;;;;GAKG;AAEH,eAAO,MAAM,SAAS,EAAE,MAAW,CAAC"
-}

package/Distribution/Types/Effect/Effect.d.mts.map

@@ -1,10 +0,0 @@
-{
-    "version": 3,
-    "file": "Effect.d.mts",
-    "sourceRoot": "",
-    "sources": [
-        "../../../Source/Effect/Effect.ts"
-    ],
-    "names": [],
-    "mappings": "AAAA;;;;;GAKG;AAEH,eAAO,MAAM,SAAS,EAAE,MAAW,CAAC"
-}

package/Distribution/Types/Effect/Effect.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"Effect.d.ts","sourceRoot":"","sources":["../../../Source/Effect/Effect.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,eAAO,MAAM,SAAS,EAAE,MAAW,CAAC"}

package/Distribution/Types/Effect/Index.Effect.d.cts

@@ -1,10 +0,0 @@
-/**
- * @file      Index.Effect.ts
- * @author    Gage Sorrell <gage@sorrell.sh>
- * @copyright (c) 2026 Gage Sorrell
- * @license   MIT
- */
-export * from "./Effect.cjs";
-export * from "./Effect.Types.cjs";
-export * from "effect";
-//# sourceMappingURL=Index.Effect.d.cts.map

package/Distribution/Types/Effect/Index.Effect.d.cts.map

@@ -1,10 +0,0 @@
-{
-    "version": 3,
-    "file": "Index.Effect.d.cts",
-    "sourceRoot": "",
-    "sources": [
-        "../../../Source/Effect/Index.Effect.ts"
-    ],
-    "names": [],
-    "mappings": "AAAA;;;;;GAKG;AAEH,cAAc,aAAa,CAAC;AAC5B,cAAc,mBAAmB,CAAC;AAClC,cAAc,QAAQ,CAAC"
-}

package/Distribution/Types/Effect/Index.Effect.d.mts

@@ -1,10 +0,0 @@
-/**
- * @file      Index.Effect.ts
- * @author    Gage Sorrell <gage@sorrell.sh>
- * @copyright (c) 2026 Gage Sorrell
- * @license   MIT
- */
-export * from "./Effect.mjs";
-export * from "./Effect.Types.mjs";
-export * from "effect";
-//# sourceMappingURL=Index.Effect.d.mts.map

package/Distribution/Types/Effect/Index.Effect.d.mts.map

@@ -1,10 +0,0 @@
-{
-    "version": 3,
-    "file": "Index.Effect.d.mts",
-    "sourceRoot": "",
-    "sources": [
-        "../../../Source/Effect/Index.Effect.ts"
-    ],
-    "names": [],
-    "mappings": "AAAA;;;;;GAKG;AAEH,cAAc,aAAa,CAAC;AAC5B,cAAc,mBAAmB,CAAC;AAClC,cAAc,QAAQ,CAAC"
-}

package/Distribution/Types/Effect/Index.Effect.d.ts

@@ -1,10 +0,0 @@
-/**
- * @file      Index.Effect.ts
- * @author    Gage Sorrell <gage@sorrell.sh>
- * @copyright (c) 2026 Gage Sorrell
- * @license   MIT
- */
-export * from "./Effect.ts";
-export * from "./Effect.Types.ts";
-export * from "effect";
-//# sourceMappingURL=Index.Effect.d.ts.map

package/Distribution/Types/Effect/Index.Effect.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"Index.Effect.d.ts","sourceRoot":"","sources":["../../../Source/Effect/Index.Effect.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,cAAc,aAAa,CAAC;AAC5B,cAAc,mBAAmB,CAAC;AAClC,cAAc,QAAQ,CAAC"}