@sorrell/utilities 1.1.61 → 1.2.0

package/Distribution/Types/Miscellaneous/Utility.Internal.d.mts

@@ -0,0 +1,8 @@
+/**
+ * @file      Utility.Internal.ts
+ * @author    Gage Sorrell <gage@sorrell.sh>
+ * @copyright (c) 2026 Gage Sorrell
+ * @license   MIT
+ */
+export declare const NoOptions: unique symbol;
+//# sourceMappingURL=Utility.Internal.d.mts.map

package/Distribution/Types/Miscellaneous/Utility.Internal.d.mts.map

@@ -0,0 +1,10 @@
+{
+    "version": 3,
+    "file": "Utility.Internal.d.mts",
+    "sourceRoot": "",
+    "sources": [
+        "../../../Source/Miscellaneous/Utility.Internal.ts"
+    ],
+    "names": [],
+    "mappings": "AAAA;;;;;GAKG;AAEH,eAGA,MAAM,SAAS,EAAE,OAAO,MAA4B,CAAC"
+}

package/Distribution/Types/Miscellaneous/Utility.Types.d.cts

@@ -0,0 +1,100 @@
+/**
+ * @file      Utility.Types.ts
+ * @author    Gage Sorrell <gage@sorrell.sh>
+ * @copyright (c) 2026 Gage Sorrell
+ * @license   MIT
+ */
+import type * as TypeScript from "typescript";
+import type { NoOptions } from "./Utility.Internal.cjs";
+/**
+ * @deprecated Use {@link TMutable} instead.
+ *
+ * Defines a type that corresponds to {@link RecordLike}, such that every
+ * `readonly` modifier is removed, recursively.
+ *
+ * @template RecordLike - The type to make writeable.
+ */
+export type TDeepWriteable<RecordLike> = {
+    -readonly [Key in keyof RecordLike]: TDeepWriteable<RecordLike[Key]>;
+};
+/**
+ * Defines a type that corresponds to {@link RecordLike}, such that every
+ * `readonly` modifier is removed, recursively.
+ *
+ * @template RecordLike - The type to make writeable.
+ * @template ShallowOption - Whether the `readonly` modifier should be stripped recursively.
+ * If `true` (the default), then only the properties of the given type will have the `readonly`
+ * modifier stripped (that is, if any of these properties is a {@link Record} type with `readonly`
+ * modifiers, then those will *not* be removed if {@link ShallowOption} is `true`).
+ */
+export type TMutable<RecordLike, ShallowOption extends boolean = true> = ShallowOption extends false ? {
+    -readonly [Key in keyof RecordLike]: RecordLike[Key];
+} : ShallowOption extends true ? {
+    -readonly [Key in keyof RecordLike]: TMutable<RecordLike[Key]>;
+} : never;
+/**
+ * Given a {@link RecordLike | record-like type}, this type is the union
+ * of the values of all properties in the {@link RecordLike | record-like type}.
+ *
+ * @template RecordLike - The record-like type from which this type extracts value types.
+ */
+export type TValues<RecordLike> = RecordLike[keyof RecordLike];
+/**
+ * The union of a given {@link ElementType} and the array of a given {@link ElementType}.
+ *
+ * @template ElementType - The type of this, or the type of elements contained by this.
+ */
+export type TMaybeArray<ElementType> = ElementType | Array<ElementType>;
+/**
+ * The element type of the return value of `Object.entries()`.
+ *
+ * @template RecordLike - The record-like type of the argument of `Object.entries()`.
+ * @template KeyType - The subset of keys used by this type.
+ */
+export type TEntry<RecordLike, KeyType extends keyof RecordLike = keyof RecordLike> = [KeyType, RecordLike[KeyType]];
+/** The type used in `OptionsType`s when no options are specified. */
+export type NoOptions = typeof NoOptions;
+/**
+ * Define options for a given type as a union of `unique symbol` types.
+ * All options must be *optional* by the type that uses these options.
+ * The type that uses these options should have a type parameter `OptionsType`
+ * defined with `OptionsType extends TOptions = NoOptions`.  You will have to import
+ * {@link NoOptions}, but this should be done anyway, since making all options types
+ * optional should be optional.  For this reason {@link NoOptions} is exported from the
+ * same module as this type.
+ *
+ * @template OptionsType - The `unique symbol` types that act as options.
+ *
+ * @example * See the {@link Array.Options:type} type as an example.
+ */
+export type TOptions<OptionsType extends symbol = NoOptions> = OptionsType | NoOptions;
+export type TNullable<Type> = Type | null | undefined;
+export declare class AbstractMethodCallError extends Error {
+    constructor(ClassName?: string);
+}
+/** The type corresponding to the schema of `tsconfig.json`. */
+export interface FTsConfig {
+    extends?: string | Array<string>;
+    files?: Array<string>;
+    include?: Array<string>;
+    exclude?: Array<string>;
+    references?: Array<TypeScript.ProjectReference>;
+    compilerOptions?: FCompilerOptions;
+    watchOptions?: TypeScript.WatchOptions;
+    typeAcquisition?: TypeScript.TypeAcquisition;
+    compileOnSave?: boolean;
+}
+type FOverriddenCompilerOptions = "jsx" | "lib" | "module" | "moduleResolution" | "target";
+type FCompilerOptions = Omit<TypeScript.server.protocol.CompilerOptions, FOverriddenCompilerOptions> & Partial<{
+    jsx: JsxEmit;
+    lib: Array<string>;
+    module: FModuleKind;
+    moduleResolution: FModuleResolutionKind;
+    target: FTarget;
+}>;
+type JsxEmit = "none" | "preserve" | "react-native" | "react" | "react-jsx" | "react-jsxdev";
+type FModuleKind = "none" | "commonjs" | "amd" | "umd" | "system" | "es6" | "es2015" | "es2020" | "es2022" | "esnext" | "node16" | "node18" | "node20" | "nodenext" | "preserve";
+type FModuleResolutionKind = "classic" | "node" | "node" | "node10" | "node16" | "nodenext" | "bundler";
+export type FTarget = "es3" | "es5" | "es6" | "es2015" | "es2016" | "es2017" | "es2018" | "es2019" | "es2020" | "es2021" | "es2022" | "es2023" | "es2024" | "es2025" | "esnext" | "json" | "esnext" | "es2025";
+export {};
+//# sourceMappingURL=Utility.Types.d.cts.map

package/Distribution/Types/Miscellaneous/Utility.Types.d.cts.map

@@ -0,0 +1,10 @@
+{
+    "version": 3,
+    "file": "Utility.Types.d.cts",
+    "sourceRoot": "",
+    "sources": [
+        "../../../Source/Miscellaneous/Utility.Types.ts"
+    ],
+    "names": [],
+    "mappings": "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"
+}

package/Distribution/Types/Miscellaneous/Utility.Types.d.mts

@@ -0,0 +1,100 @@
+/**
+ * @file      Utility.Types.ts
+ * @author    Gage Sorrell <gage@sorrell.sh>
+ * @copyright (c) 2026 Gage Sorrell
+ * @license   MIT
+ */
+import type * as TypeScript from "typescript";
+import type { NoOptions } from "./Utility.Internal.mjs";
+/**
+ * @deprecated Use {@link TMutable} instead.
+ *
+ * Defines a type that corresponds to {@link RecordLike}, such that every
+ * `readonly` modifier is removed, recursively.
+ *
+ * @template RecordLike - The type to make writeable.
+ */
+export type TDeepWriteable<RecordLike> = {
+    -readonly [Key in keyof RecordLike]: TDeepWriteable<RecordLike[Key]>;
+};
+/**
+ * Defines a type that corresponds to {@link RecordLike}, such that every
+ * `readonly` modifier is removed, recursively.
+ *
+ * @template RecordLike - The type to make writeable.
+ * @template ShallowOption - Whether the `readonly` modifier should be stripped recursively.
+ * If `true` (the default), then only the properties of the given type will have the `readonly`
+ * modifier stripped (that is, if any of these properties is a {@link Record} type with `readonly`
+ * modifiers, then those will *not* be removed if {@link ShallowOption} is `true`).
+ */
+export type TMutable<RecordLike, ShallowOption extends boolean = true> = ShallowOption extends false ? {
+    -readonly [Key in keyof RecordLike]: RecordLike[Key];
+} : ShallowOption extends true ? {
+    -readonly [Key in keyof RecordLike]: TMutable<RecordLike[Key]>;
+} : never;
+/**
+ * Given a {@link RecordLike | record-like type}, this type is the union
+ * of the values of all properties in the {@link RecordLike | record-like type}.
+ *
+ * @template RecordLike - The record-like type from which this type extracts value types.
+ */
+export type TValues<RecordLike> = RecordLike[keyof RecordLike];
+/**
+ * The union of a given {@link ElementType} and the array of a given {@link ElementType}.
+ *
+ * @template ElementType - The type of this, or the type of elements contained by this.
+ */
+export type TMaybeArray<ElementType> = ElementType | Array<ElementType>;
+/**
+ * The element type of the return value of `Object.entries()`.
+ *
+ * @template RecordLike - The record-like type of the argument of `Object.entries()`.
+ * @template KeyType - The subset of keys used by this type.
+ */
+export type TEntry<RecordLike, KeyType extends keyof RecordLike = keyof RecordLike> = [KeyType, RecordLike[KeyType]];
+/** The type used in `OptionsType`s when no options are specified. */
+export type NoOptions = typeof NoOptions;
+/**
+ * Define options for a given type as a union of `unique symbol` types.
+ * All options must be *optional* by the type that uses these options.
+ * The type that uses these options should have a type parameter `OptionsType`
+ * defined with `OptionsType extends TOptions = NoOptions`.  You will have to import
+ * {@link NoOptions}, but this should be done anyway, since making all options types
+ * optional should be optional.  For this reason {@link NoOptions} is exported from the
+ * same module as this type.
+ *
+ * @template OptionsType - The `unique symbol` types that act as options.
+ *
+ * @example * See the {@link Array.Options:type} type as an example.
+ */
+export type TOptions<OptionsType extends symbol = NoOptions> = OptionsType | NoOptions;
+export type TNullable<Type> = Type | null | undefined;
+export declare class AbstractMethodCallError extends Error {
+    constructor(ClassName?: string);
+}
+/** The type corresponding to the schema of `tsconfig.json`. */
+export interface FTsConfig {
+    extends?: string | Array<string>;
+    files?: Array<string>;
+    include?: Array<string>;
+    exclude?: Array<string>;
+    references?: Array<TypeScript.ProjectReference>;
+    compilerOptions?: FCompilerOptions;
+    watchOptions?: TypeScript.WatchOptions;
+    typeAcquisition?: TypeScript.TypeAcquisition;
+    compileOnSave?: boolean;
+}
+type FOverriddenCompilerOptions = "jsx" | "lib" | "module" | "moduleResolution" | "target";
+type FCompilerOptions = Omit<TypeScript.server.protocol.CompilerOptions, FOverriddenCompilerOptions> & Partial<{
+    jsx: JsxEmit;
+    lib: Array<string>;
+    module: FModuleKind;
+    moduleResolution: FModuleResolutionKind;
+    target: FTarget;
+}>;
+type JsxEmit = "none" | "preserve" | "react-native" | "react" | "react-jsx" | "react-jsxdev";
+type FModuleKind = "none" | "commonjs" | "amd" | "umd" | "system" | "es6" | "es2015" | "es2020" | "es2022" | "esnext" | "node16" | "node18" | "node20" | "nodenext" | "preserve";
+type FModuleResolutionKind = "classic" | "node" | "node" | "node10" | "node16" | "nodenext" | "bundler";
+export type FTarget = "es3" | "es5" | "es6" | "es2015" | "es2016" | "es2017" | "es2018" | "es2019" | "es2020" | "es2021" | "es2022" | "es2023" | "es2024" | "es2025" | "esnext" | "json" | "esnext" | "es2025";
+export {};
+//# sourceMappingURL=Utility.Types.d.mts.map

package/Distribution/Types/Miscellaneous/Utility.Types.d.mts.map

@@ -0,0 +1,10 @@
+{
+    "version": 3,
+    "file": "Utility.Types.d.mts",
+    "sourceRoot": "",
+    "sources": [
+        "../../../Source/Miscellaneous/Utility.Types.ts"
+    ],
+    "names": [],
+    "mappings": "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"
+}

package/Distribution/Types/Miscellaneous/index.d.cts

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

package/Distribution/Types/Miscellaneous/index.d.cts.map

@@ -0,0 +1,10 @@
+{
+    "version": 3,
+    "file": "index.d.cts",
+    "sourceRoot": "",
+    "sources": [
+        "../../../Source/Miscellaneous/index.ts"
+    ],
+    "names": [],
+    "mappings": "AAAA;;;;;GAKG;AAEH,cAAc,oBAAoB,CAAC"
+}

package/Distribution/Types/Miscellaneous/index.d.mts

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

package/Distribution/Types/Miscellaneous/index.d.mts.map

@@ -0,0 +1,10 @@
+{
+    "version": 3,
+    "file": "index.d.mts",
+    "sourceRoot": "",
+    "sources": [
+        "../../../Source/Miscellaneous/index.ts"
+    ],
+    "names": [],
+    "mappings": "AAAA;;;;;GAKG;AAEH,cAAc,oBAAoB,CAAC"
+}

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

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

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

@@ -0,0 +1,10 @@
+{
+    "version": 3,
+    "file": "Index.Effect.d.cts",
+    "sourceRoot": "",
+    "sources": [
+        "../../../Source/Npm/Index.Effect.ts"
+    ],
+    "names": [],
+    "mappings": "AAAA;;;;;GAKG;AAEH,cAAc,iBAAiB,CAAC;AAChC,cAAc,uBAAuB,CAAC"
+}

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

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

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

@@ -0,0 +1,10 @@
+{
+    "version": 3,
+    "file": "Index.Effect.d.mts",
+    "sourceRoot": "",
+    "sources": [
+        "../../../Source/Npm/Index.Effect.ts"
+    ],
+    "names": [],
+    "mappings": "AAAA;;;;;GAKG;AAEH,cAAc,iBAAiB,CAAC;AAChC,cAAc,uBAAuB,CAAC"
+}

package/Distribution/Types/Npm/Npm.Effect.Internal.d.cts

@@ -0,0 +1,17 @@
+/**
+ * @file      Npm.Effect.Internal.ts
+ * @author    Gage Sorrell <gage@sorrell.sh>
+ * @copyright (c) 2026 Gage Sorrell
+ * @license   MIT
+ */
+/**
+ * Returns whether a given {@link Value} contains a `readonly` `string` `"code"`.
+ *
+ * @param Value - The value to test.
+ * @returns {Value is { readonly code: string }} Whether {@link Value} is a
+ * `{ readonly code: string }`.
+ */
+export declare function HasErrorCode(Value: unknown): Value is {
+    readonly code: string;
+};
+//# sourceMappingURL=Npm.Effect.Internal.d.cts.map

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

@@ -0,0 +1,10 @@
+{
+    "version": 3,
+    "file": "Npm.Effect.Internal.d.cts",
+    "sourceRoot": "",
+    "sources": [
+        "../../../Source/Npm/Npm.Effect.Internal.ts"
+    ],
+    "names": [],
+    "mappings": "AAAA;;;;;GAKG;AAIH;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAM/E"
+}

package/Distribution/Types/Npm/Npm.Effect.Internal.d.mts

@@ -0,0 +1,17 @@
+/**
+ * @file      Npm.Effect.Internal.ts
+ * @author    Gage Sorrell <gage@sorrell.sh>
+ * @copyright (c) 2026 Gage Sorrell
+ * @license   MIT
+ */
+/**
+ * Returns whether a given {@link Value} contains a `readonly` `string` `"code"`.
+ *
+ * @param Value - The value to test.
+ * @returns {Value is { readonly code: string }} Whether {@link Value} is a
+ * `{ readonly code: string }`.
+ */
+export declare function HasErrorCode(Value: unknown): Value is {
+    readonly code: string;
+};
+//# sourceMappingURL=Npm.Effect.Internal.d.mts.map

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

@@ -0,0 +1,10 @@
+{
+    "version": 3,
+    "file": "Npm.Effect.Internal.d.mts",
+    "sourceRoot": "",
+    "sources": [
+        "../../../Source/Npm/Npm.Effect.Internal.ts"
+    ],
+    "names": [],
+    "mappings": "AAAA;;;;;GAKG;AAIH;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAM/E"
+}

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

@@ -0,0 +1,12 @@
+/**
+ * @file      Npm.Effect.Types.ts
+ * @author    Gage Sorrell <gage@sorrell.sh>
+ * @copyright (c) 2026 Gage Sorrell
+ * @license   MIT
+ */
+import type { PackageJsonParseError, RootDirectoryNotFoundError } from "./Npm.Error.cjs";
+import type { Effect } from "effect";
+import type { IPackageJson } from "package-json-type";
+export type EGetPackageJson = Effect.Effect<IPackageJson, PackageJsonParseError | RootDirectoryNotFoundError, never>;
+export type EGetPackageRootDirectory = Effect.Effect<string, RootDirectoryNotFoundError, never>;
+//# sourceMappingURL=Npm.Effect.Types.d.cts.map

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

@@ -0,0 +1,10 @@
+{
+    "version": 3,
+    "file": "Npm.Effect.Types.d.cts",
+    "sourceRoot": "",
+    "sources": [
+        "../../../Source/Npm/Npm.Effect.Types.ts"
+    ],
+    "names": [],
+    "mappings": "AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,qBAAqB,EAAE,0BAA0B,EAAE,MAAM,gBAAgB,CAAC;AACxF,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AACrC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEtD,MAAM,MAAM,eAAe,GACvB,MAAM,CAAC,MAAM,CACT,YAAY,EACZ,qBAAqB,GAAG,0BAA0B,EAClD,KAAK,CACR,CAAC;AAEN,MAAM,MAAM,wBAAwB,GAChC,MAAM,CAAC,MAAM,CACT,MAAM,EACN,0BAA0B,EAC1B,KAAK,CACR,CAAC"
+}

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

@@ -0,0 +1,12 @@
+/**
+ * @file      Npm.Effect.Types.ts
+ * @author    Gage Sorrell <gage@sorrell.sh>
+ * @copyright (c) 2026 Gage Sorrell
+ * @license   MIT
+ */
+import type { PackageJsonParseError, RootDirectoryNotFoundError } from "./Npm.Error.mjs";
+import type { Effect } from "effect";
+import type { IPackageJson } from "package-json-type";
+export type EGetPackageJson = Effect.Effect<IPackageJson, PackageJsonParseError | RootDirectoryNotFoundError, never>;
+export type EGetPackageRootDirectory = Effect.Effect<string, RootDirectoryNotFoundError, never>;
+//# sourceMappingURL=Npm.Effect.Types.d.mts.map

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

@@ -0,0 +1,10 @@
+{
+    "version": 3,
+    "file": "Npm.Effect.Types.d.mts",
+    "sourceRoot": "",
+    "sources": [
+        "../../../Source/Npm/Npm.Effect.Types.ts"
+    ],
+    "names": [],
+    "mappings": "AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,qBAAqB,EAAE,0BAA0B,EAAE,MAAM,gBAAgB,CAAC;AACxF,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AACrC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEtD,MAAM,MAAM,eAAe,GACvB,MAAM,CAAC,MAAM,CACT,YAAY,EACZ,qBAAqB,GAAG,0BAA0B,EAClD,KAAK,CACR,CAAC;AAEN,MAAM,MAAM,wBAAwB,GAChC,MAAM,CAAC,MAAM,CACT,MAAM,EACN,0BAA0B,EAC1B,KAAK,CACR,CAAC"
+}

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

@@ -0,0 +1,92 @@
+/**
+ * @file      Npm.Effect.ts
+ * @author    Gage Sorrell <gage@sorrell.sh>
+ * @copyright (c) 2026 Gage Sorrell
+ * @license   MIT
+ */
+import type { EGetPackageJson, EGetPackageRootDirectory } from "./Npm.Effect.Types.cjs";
+/**
+ * Get the `package.json` of the Node.js project in which the
+ * given path, or the current working directory, resides.
+ *
+ * @param Path - The given path from which to look for a root directory.
+ *
+ * @returns {EGetPackageJson} An Effect that succeeds with the parsed `package.json`, or fails
+ * with {@link RootDirectoryNotFoundError} or {@link PackageJsonParseError}.
+ *
+ * @example
+ * Suppose `process.cwd() === "./MyPackage"`,
+ * ```typescript
+ * Effect.gen(function* ()
+ * {
+ *     const PackageJson: IPackageJson = yield* GetPackageJson();
+ *     // `PackageJson` <- *The parsed `package.json` of `MyPackage`.*
+ * }
+ * ```
+ */
+export declare function GetPackageJson(Path?: string): EGetPackageJson;
+/**
+ * Get the root directory of the Node.js project in which the
+ * current working directory resides.
+ *
+ * @param Path - *(Optional)* The given path from which to look for a root directory.
+ *
+ * @returns {EGetPackageRootDirectory} An Effect that succeeds with the package root
+ * directory, or fails with {@link RootDirectoryNotFoundError}.
+ *
+ * @example
+ * Suppose `process.cwd()` is any one of the following,
+ *   - `/home/alex/myPackage`,
+ *   - `/home/alex/myPackage/src/MyModule`,
+ *   - `/home/alex/myPackage/resource/Images`,
+ *
+ * then,
+ *
+ * ```typescript
+ * import { Effect } from "effect";
+ * const Root: string = await Effect.runPromise(GetPackageRootDirectory());
+ * // `Root` <- `"/home/alex/myPackage"`
+ * ```
+ *
+ * @example
+ * Suppose `TestPath === "/home/alex/Documents"` is *not* a NodeJS package root
+ * (of course, neither are `/home/alex` or `/home`).  Then,
+ *
+ * ```typescript
+ * import { Effect } from "effect";
+ * const TestPath: string = "/home/alex/Documents";
+ * let Root: string | undefined = undefined;
+ * try
+ * {
+ *     Root = await Effect.runPromise(
+ *         GetPackageRootDirectory(TestPath)
+ *     );
+ * }
+ * catch (Error: unknown)
+ * {
+ *      // `Error instanceof RootDirectoryNotFound`
+ * }
+ *
+ * // `Root` <- `undefined`
+ * ```
+ *
+ * @example
+ * Suppose `process.cwd() === /home/alex/Downloads`, which is *not* a NodeJS package
+ * (of course, neither are `/home/alex` or `/home`).  Then,
+ *
+ * ```typescript
+ * import { Effect } from "effect";
+ * let Root: string | undefined = undefined;
+ * try
+ * {
+ *     Root = await Effect.runPromise(GetPackageRootDirectory());
+ * }
+ * catch (Error: unknown)
+ * {
+ *      // `Error instanceof RootDirectoryNotFound`
+ * }
+ * // `Root` <- `undefined`
+ * ```
+ */
+export declare function GetPackageRootDirectory(Path?: string): EGetPackageRootDirectory;
+//# sourceMappingURL=Npm.Effect.d.cts.map

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

@@ -0,0 +1,10 @@
+{
+    "version": 3,
+    "file": "Npm.Effect.d.cts",
+    "sourceRoot": "",
+    "sources": [
+        "../../../Source/Npm/Npm.Effect.ts"
+    ],
+    "names": [],
+    "mappings": "AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,wBAAwB,EAAE,MAAM,uBAAuB,CAAC;AASvF;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,cAAc,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,eAAe,CAyB7D;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8DG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,wBAAwB,CA6C/E"
+}

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

@@ -0,0 +1,92 @@
+/**
+ * @file      Npm.Effect.ts
+ * @author    Gage Sorrell <gage@sorrell.sh>
+ * @copyright (c) 2026 Gage Sorrell
+ * @license   MIT
+ */
+import type { EGetPackageJson, EGetPackageRootDirectory } from "./Npm.Effect.Types.mjs";
+/**
+ * Get the `package.json` of the Node.js project in which the
+ * given path, or the current working directory, resides.
+ *
+ * @param Path - The given path from which to look for a root directory.
+ *
+ * @returns {EGetPackageJson} An Effect that succeeds with the parsed `package.json`, or fails
+ * with {@link RootDirectoryNotFoundError} or {@link PackageJsonParseError}.
+ *
+ * @example
+ * Suppose `process.cwd() === "./MyPackage"`,
+ * ```typescript
+ * Effect.gen(function* ()
+ * {
+ *     const PackageJson: IPackageJson = yield* GetPackageJson();
+ *     // `PackageJson` <- *The parsed `package.json` of `MyPackage`.*
+ * }
+ * ```
+ */
+export declare function GetPackageJson(Path?: string): EGetPackageJson;
+/**
+ * Get the root directory of the Node.js project in which the
+ * current working directory resides.
+ *
+ * @param Path - *(Optional)* The given path from which to look for a root directory.
+ *
+ * @returns {EGetPackageRootDirectory} An Effect that succeeds with the package root
+ * directory, or fails with {@link RootDirectoryNotFoundError}.
+ *
+ * @example
+ * Suppose `process.cwd()` is any one of the following,
+ *   - `/home/alex/myPackage`,
+ *   - `/home/alex/myPackage/src/MyModule`,
+ *   - `/home/alex/myPackage/resource/Images`,
+ *
+ * then,
+ *
+ * ```typescript
+ * import { Effect } from "effect";
+ * const Root: string = await Effect.runPromise(GetPackageRootDirectory());
+ * // `Root` <- `"/home/alex/myPackage"`
+ * ```
+ *
+ * @example
+ * Suppose `TestPath === "/home/alex/Documents"` is *not* a NodeJS package root
+ * (of course, neither are `/home/alex` or `/home`).  Then,
+ *
+ * ```typescript
+ * import { Effect } from "effect";
+ * const TestPath: string = "/home/alex/Documents";
+ * let Root: string | undefined = undefined;
+ * try
+ * {
+ *     Root = await Effect.runPromise(
+ *         GetPackageRootDirectory(TestPath)
+ *     );
+ * }
+ * catch (Error: unknown)
+ * {
+ *      // `Error instanceof RootDirectoryNotFound`
+ * }
+ *
+ * // `Root` <- `undefined`
+ * ```
+ *
+ * @example
+ * Suppose `process.cwd() === /home/alex/Downloads`, which is *not* a NodeJS package
+ * (of course, neither are `/home/alex` or `/home`).  Then,
+ *
+ * ```typescript
+ * import { Effect } from "effect";
+ * let Root: string | undefined = undefined;
+ * try
+ * {
+ *     Root = await Effect.runPromise(GetPackageRootDirectory());
+ * }
+ * catch (Error: unknown)
+ * {
+ *      // `Error instanceof RootDirectoryNotFound`
+ * }
+ * // `Root` <- `undefined`
+ * ```
+ */
+export declare function GetPackageRootDirectory(Path?: string): EGetPackageRootDirectory;
+//# sourceMappingURL=Npm.Effect.d.mts.map