@sorrell/utilities 1.2.5 → 1.2.6

package/Distribution/math.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../Source/Math/Index.Complex.ts", "../Source/Math/Complex.Internal.ts", "../Source/Math/Complex.ts", "../Source/Math/Vector.ts", "../Source/Math/Math.ts"],
+  "sourcesContent": ["/**\n * @file      Index.Complex.ts\n * @author    Gage Sorrell <gage@sorrell.sh>\n * @copyright (c) 2026 Gage Sorrell\n * @license   MIT\n */\nexport * from \"./Complex.ts\";\nexport * from \"./Complex.Types.ts\";\n", "/**\n * @file      Complex.Internal.ts\n * @author    Gage Sorrell <gage@sorrell.sh>\n * @copyright (c) 2026 Gage Sorrell\n * @license   MIT\n */\nexport const MathBuiltin: typeof Math = Math;\n", "/**\n * @file      Complex.ts\n * @author    Gage Sorrell <gage@sorrell.sh>\n * @copyright (c) 2026 Gage Sorrell\n * @license   MIT\n */\nimport { MathBuiltin } from \"./Complex.Internal\";\nimport { Operator } from \"tsover-runtime\";\n/**\n * Elements of the complex plane, $\\mathbf{C} = \\mathbf{R}[x] / [ x^2 + 1 ]$.\n */\nexport class FComplex {\n    public readonly Re: number;\n    public readonly Im: number;\n    public static Zero: FComplex = new FComplex(0, 0);\n    /**\n     * The copy constructor for {@link FComplex} numbers.\n     *\n     * @param Z - The existing {@link FComplex} number to copy.\n     *\n     * @example\n     * ```typescript\n     * const Z: FComplex = 3 + 2 * i;\n     * const W: FComplex = new FComplex(Z);\n     * // `W.Re === Z.Re` <- `true`\n     * // `W.Im === Z.Im` <- `true`\n     * ```\n     */\n    public constructor(Z: FComplex);\n    /**\n     * Construct an {@link FComplex} number by specifying the real\n     * and imaginary components.\n     *\n     * @param A - The real component of the {@link FComplex} number.\n     * @param B - The imaginary component of the {@link FComplex} number.\n     *\n     * @example\n     * ```typescript\n     * const Theta: number = 0.5;\n     * const OnUnitDisk: FComplex = new FComplex(Math.sin(Theta), Math.cos(Theta));\n     * ```\n     */\n    public constructor(A: number, B: number);\n    public constructor(A: FComplex | number, B: number = 0) {\n        if (typeof A === \"number\") {\n            this.Re = A;\n            this.Im = B;\n        }\n        else {\n            this.Re = A.Re;\n            this.Im = A.Im;\n        }\n    }\n    /**\n     * Get the modulus of this {@link FComplex} number.\n     *\n     * @returns {number} The modulus of this {@link FComplex} number.\n     */\n    public get Mod(): number {\n        return MathBuiltin.sqrt((this.Re ** 2) + (this.Im ** 2));\n    }\n    /**\n     * Get the modulus of this {@link FComplex} number.\n     *\n     * @returns {number} The modulus of this {@link FComplex} number.\n     */\n    public get Theta(): number {\n        const Out: number = MathBuiltin.atan2(this.Im, this.Re);\n        if (Out < 0) {\n            return Out + 2 * MathBuiltin.PI;\n        }\n        return Out;\n    }\n    [Operator.star](A: FComplex, B: FComplex): FComplex;\n    [Operator.star](A: FComplex, B: number): FComplex;\n    [Operator.star](A: number, B: FComplex): FComplex;\n    [Operator.star](A: FComplex | number, B: number | FComplex): FComplex {\n        if (typeof A === \"number\") {\n            return new FComplex((B as FComplex).Re * A, (B as FComplex).Im * A);\n        }\n        else if (typeof B === \"number\") {\n            return new FComplex((A as FComplex).Re * B, (A as FComplex).Im * B);\n        }\n        else {\n            return new FComplex((((A as FComplex).Re + (B as FComplex).Re) -\n                ((A as FComplex).Im + (B as FComplex).Im)), (((A as FComplex).Re + (B as FComplex).Im) +\n                ((B as FComplex).Re + (A as FComplex).Im)));\n        }\n    }\n    [Operator.plus](A: FComplex, B: FComplex): FComplex;\n    [Operator.plus](A: FComplex, B: number): FComplex;\n    [Operator.plus](A: number, B: FComplex): FComplex;\n    [Operator.plus](A: FComplex | number, B: number | FComplex): FComplex {\n        if (typeof A === \"number\") {\n            return new FComplex(A + (B as FComplex).Re, (B as FComplex).Im);\n        }\n        else if (typeof B === \"number\") {\n            return new FComplex((A as FComplex).Re + B, (A as FComplex).Im);\n        }\n        else {\n            return new FComplex((A as FComplex).Re + (B as FComplex).Re, (A as FComplex).Im + (B as FComplex).Im);\n        }\n    }\n}\nexport /**\n       * The imaginary unit.\n       */ const i: FComplex = new FComplex(0, 1);\n", "/**\n * @file      Vector.ts\n * @author    Gage Sorrell <gage@sorrell.sh>\n * @copyright (c) 2026 Gage Sorrell\n * @license   MIT\n */\nimport { Operator } from \"tsover-runtime\";\n/** A representation of elements in $\\mathbf{R}^2$. */\nexport class FVector2D {\n    /** The $x$-component of this vector. */\n    public readonly X: number;\n    /** The $y$-component of this vector. */\n    public readonly Y: number;\n    /** The identity of $\\mathbf{R}^2$ *wrt* addition. */\n    public static Zero: FVector2D = new FVector2D(0, 0);\n    /**\n     * Construct a vector by specifying both components.\n     *\n     * @param Value - The value of both the {@link FVector2D!X | x}- and\n     * {@link FVector2D!Y ? y}-components.\n     */\n    public constructor(Value: number);\n    /**\n     * Construct a vector by specifying both components.\n     *\n     * @param X - The value of the {@link FVector2D!X} component.\n     * @param Y - The value of the {@link FVector2D!Y} component.\n     */\n    public constructor(X: number, Y: number);\n    public constructor(X: number = 0, Y: number = X) {\n        this.X = X;\n        this.Y = Y;\n    }\n    /**\n     * Get a representation of this vector as a `string`.\n     *\n     * @returns {string} The string representation of this vector.\n     */\n    public toString(): string {\n        return `(${this.X}, ${this.Y})`;\n    }\n    /**\n     * Perform per-component addition of two {@link FVector2D}s.\n     *\n     * @param Left - The left-hand operand.\n     * @param Right - The right-hand operand.\n     *\n     * @returns {FVector2D} The per-component sum of {@link Left} and {@link Right}.\n     *\n     * @example\n     * ```typescript\n     * \"use tsover\";\n     *\n     * const A: FVector2D = new FVector2D(1, -1);\n     * const B: FVector2D = new FVector2D(-3, 5);\n     *\n     * const C: FVector2D = A + B;\n     * // `C` <- `(-2, 4)`\n     * ```\n     */\n    [Operator.plus](Left: FVector2D, Right: FVector2D): FVector2D {\n        return new FVector2D(Left.X + Right.X, Left.Y + Right.Y);\n    }\n    [Operator.minus](A: FVector2D, B: FVector2D): FVector2D {\n        return new FVector2D(A.X - B.X, A.Y - B.Y);\n    }\n    [Operator.preMinus](Vector: FVector2D): FVector2D {\n        return new FVector2D(-1 * Vector.X, -1 * Vector.Y);\n    }\n    /**\n     * Perform scalar multiplication of an {@link FVector2D} and a `number` value.\n     * Exactly one of the two arguments must be a `number`, and the other an\n     * {@link FVector2D}.\n     *\n     * @param Left - The left-hand operand (either a `number` or an {@link FVector2D}).\n     * @param Left - The right-hand operand (either a `number` or an {@link FVector2D}).\n     *\n     * @returns {FVector2D} The per-component sum of {@link Left} and {@link Right}.\n     */\n    [Operator.star](Left: number, Right: FVector2D): FVector2D;\n    [Operator.star](Left: FVector2D, Right: number): FVector2D;\n    [Operator.star](Left: FVector2D | number, Right: FVector2D | number): FVector2D | typeof Operator.deferOperation {\n        if (typeof Left === \"number\" && Right instanceof FVector2D) {\n            return new FVector2D(Left * Right.X, Left * Right.Y);\n        }\n        if (typeof Right === \"number\" && Left instanceof FVector2D) {\n            return new FVector2D(Left.X * Right, Left.Y * Right);\n        }\n        return Operator.deferOperation;\n    }\n    public get length(): number {\n        return Math.sqrt((this.X ** 2) + (this.Y ** 2));\n    }\n    public get Length(): number {\n        return this.length;\n    }\n}\n/** A representation of elements in $\\mathbf{R}^3$. */\nexport class FVector {\n    public readonly X: number;\n    public readonly Y: number;\n    public readonly Z: number;\n    /** Constructs the zero {@link FVector}. */\n    public constructor();\n    /**\n     * Constructs an {@link FVector} with all components set to {@link Value}.\n     *\n     * @param Value - The value of all components of the new {@link FVector}.\n     */\n    public constructor(Value: number);\n    /**\n     * Constructs an {@link FVector} with all components set to {@link Value}.\n     *\n     * @param X - The value of the {@link FVector!X} component.\n     * @param Y - The value of the {@link FVector!Y} component.\n     * @param Z - The value of the {@link FVector!Z} component.\n     */\n    public constructor(X: number, Y: number, Z: number);\n    public constructor(X: number = 0, Y: number = X, Z: number = X) {\n        this.X = X;\n        this.Y = Y;\n        this.Z = Z;\n    }\n    [Operator.plus](Left: FVector, Right: FVector): FVector {\n        return new FVector(Left.X + Right.X, Left.Y + Right.Y, Left.Z + Right.Z);\n    }\n    [Operator.minus](A: FVector, B: FVector): FVector {\n        return new FVector(A.X - B.X, A.Y - B.Y, A.Z - B.Z);\n    }\n    [Operator.preMinus](Vector: FVector): FVector {\n        return new FVector(-1 * Vector.X, -1 * Vector.Y, -1 * Vector.Z);\n    }\n    [Operator.star](Left: number, Right: FVector): FVector;\n    [Operator.star](Left: FVector, Right: number): FVector;\n    [Operator.star](Left: FVector | number, Right: FVector | number): FVector | typeof Operator.deferOperation {\n        if (typeof Left === \"number\" && Right instanceof FVector) {\n            return new FVector(Left * Right.X, Left * Right.Y, Left * Right.Z);\n        }\n        if (typeof Right === \"number\" && Left instanceof FVector) {\n            return new FVector(Left.X * Right, Left.Y * Right, Left.Z * Right);\n        }\n        return Operator.deferOperation;\n    }\n    public get length(): number {\n        return Math.sqrt((this.X ** 2) + (this.Y ** 2) + (this.Z ** 2));\n    }\n    public get Length(): number {\n        return this.length;\n    }\n}\n", "/**\n * @file      Math.ts\n * @author    Gage Sorrell <gage@sorrell.sh>\n * @copyright (c) 2026 Gage Sorrell\n * @license   MIT\n */\n/* eslint-disable */\nexport const __DummyExport_Number: \"DummyExport\" = \"DummyExport\" as const;\n"],
+  "mappings": "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",
+  "names": ["Operator"]
+}

package/Distribution/misc.cjs

@@ -0,0 +1,45 @@
+"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/Miscellaneous/index.ts
+var Miscellaneous_exports = {};
+__export(Miscellaneous_exports, {
+  AbstractMethodCallError: () => AbstractMethodCallError
+});
+module.exports = __toCommonJS(Miscellaneous_exports);
+
+// Source/Miscellaneous/Utility.Types.ts
+var AbstractMethodCallError = class extends Error {
+  constructor(ClassName) {
+    super(ClassName);
+  }
+};
+/**
+ * @file      Utility.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=misc.cjs.map

package/Distribution/misc.cjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../Source/Miscellaneous/index.ts", "../Source/Miscellaneous/Utility.Types.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 \"./Utility.Types.ts\";\n", "/**\n * @file      Utility.Types.ts\n * @author    Gage Sorrell <gage@sorrell.sh>\n * @copyright (c) 2026 Gage Sorrell\n * @license   MIT\n */\nimport type { NoOptions } from \"./Utility.Internal.ts\";\nimport type TypeScript from \"typescript\";\n/**\n * @deprecated Use {@link TMutable} instead.\n *\n * Defines a type that corresponds to {@link RecordLike}, such that every\n * `readonly` modifier is removed, recursively.\n *\n * @template RecordLike - The type to make writeable.\n */\nexport type TDeepWriteable<RecordLike> = {\n    -readonly [Key in keyof RecordLike]: TDeepWriteable<RecordLike[Key]>;\n};\n/**\n * Defines a type that corresponds to {@link RecordLike}, such that every\n * `readonly` modifier is removed, recursively.\n *\n * @template RecordLike - The type to make writeable.\n * @template ShallowOption - Whether the `readonly` modifier should be stripped recursively.\n * If `true` (the default), then only the properties of the given type will have the `readonly`\n * modifier stripped (that is, if any of these properties is a {@link Record} type with `readonly`\n * modifiers, then those will *not* be removed if {@link ShallowOption} is `true`).\n */\nexport type TMutable<RecordLike, ShallowOption extends boolean = true> = ShallowOption extends false ? {\n    -readonly [Key in keyof RecordLike]: RecordLike[Key];\n} : ShallowOption extends true ? {\n    -readonly [Key in keyof RecordLike]: TMutable<RecordLike[Key]>;\n} : never;\n/**\n * Given a {@link RecordLike | record-like type}, this type is the union\n * of the values of all properties in the {@link RecordLike | record-like type}.\n *\n * @template RecordLike - The record-like type from which this type extracts value types.\n */\nexport type TValues<RecordLike> = RecordLike[keyof RecordLike];\n/**\n * The element type of the return value of `Object.entries()`.\n *\n * @template RecordLike - The record-like type of the argument of `Object.entries()`.\n * @template KeyType - The subset of keys used by this type.\n */\nexport type TEntry<RecordLike, KeyType extends keyof RecordLike = keyof RecordLike> = [\n    KeyType,\n    RecordLike[KeyType]\n];\n/** The type used in `OptionsType`s when no options are specified. */\nexport type NoOptions = typeof NoOptions;\n/**\n * Define options for a given type as a union of `unique symbol` types.\n * All options must be *optional* by the type that uses these options.\n * The type that uses these options should have a type parameter `OptionsType`\n * defined with `OptionsType extends TOptions = NoOptions`.  You will have to import\n * {@link NoOptions}, but this should be done anyway, since making all options types\n * optional should be optional.  For this reason {@link NoOptions} is exported from the\n * same module as this type.\n *\n * @template OptionsType - The `unique symbol` types that act as options.\n *\n * @example * See the {@link Array.Options:type} type as an example.\n */\nexport type TOptions<OptionsType extends symbol = NoOptions> = OptionsType | NoOptions;\nexport type TNullable<Type> = Type | null | undefined;\n/** An error that is thrown in default implementations of `abstract` `class`es. */\nexport class AbstractMethodCallError extends Error {\n    public constructor(ClassName?: string) {\n        super(ClassName);\n    }\n}\n/** The type corresponding to the schema of `tsconfig.json`. */\nexport interface FTsConfig {\n    extends?: string | Array<string>;\n    files?: Array<string>;\n    include?: Array<string>;\n    exclude?: Array<string>;\n    references?: Array<TypeScript.ProjectReference>;\n    compilerOptions?: FCompilerOptions;\n    watchOptions?: TypeScript.WatchOptions;\n    typeAcquisition?: TypeScript.TypeAcquisition;\n    compileOnSave?: boolean;\n}\ntype FOverriddenCompilerOptions = \"jsx\" | \"lib\" | \"module\" | \"moduleResolution\" | \"target\";\ntype FCompilerOptions = Omit<TypeScript.server.protocol.CompilerOptions, FOverriddenCompilerOptions> & Partial<{\n    jsx: JsxEmit;\n    lib: Array<string>;\n    module: FModuleKind;\n    moduleResolution: FModuleResolutionKind;\n    target: FTarget;\n}>;\ntype JsxEmit = \"none\" | \"preserve\" | \"react-native\" | \"react\" | \"react-jsx\" | \"react-jsxdev\";\ntype FModuleKind = \"none\" | \"commonjs\" | \"amd\" | \"umd\" | \"system\" | \"es6\" | \"es2015\" | \"es2020\" | \"es2022\" | \"esnext\" | \"node16\" | \"node18\" | \"node20\" | \"nodenext\" | \"preserve\";\ntype FModuleResolutionKind = \"classic\" | \"node\" | \"node\" | \"node10\" | \"node16\" | \"nodenext\" | \"bundler\";\ntype FTarget = \"es3\" | \"es5\" | \"es6\" | \"es2015\" | \"es2016\" | \"es2017\" | \"es2018\" | \"es2019\" | \"es2020\" | \"es2021\" | \"es2022\" | \"es2023\" | \"es2024\" | \"es2025\" | \"esnext\" | \"json\" | \"esnext\" | \"es2025\";\n/**\n * Maps a given {@link RecordLike} type to an identical {@link Record} type, but\n * the properties are wrapped with {@link NonNullable}.\n *\n * @template RecordLike - The `Record`-like type from which this type is defined.\n */\nexport type TRecordNonNullable<RecordLike> = {\n    [Key in keyof RecordLike]: NonNullable<RecordLike[Key]>;\n};\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACqEO,IAAM,0BAAN,cAAsC,MAAM;AAAA,EACxC,YAAY,WAAoB;AACnC,UAAM,SAAS;AAAA,EACnB;AACJ;",
+  "names": []
+}

package/Distribution/misc.js

@@ -0,0 +1,22 @@
+// Source/Miscellaneous/Utility.Types.ts
+var AbstractMethodCallError = class extends Error {
+  constructor(ClassName) {
+    super(ClassName);
+  }
+};
+export {
+  AbstractMethodCallError
+};
+/**
+ * @file      Utility.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=misc.js.map

package/Distribution/misc.js.map

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

package/Distribution/npm-effect.cjs

@@ -0,0 +1,130 @@
+"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/Npm/Index.Effect.ts
+var Index_Effect_exports = {};
+__export(Index_Effect_exports, {
+  GetPackageJson: () => GetPackageJson,
+  GetPackageRootDirectory: () => GetPackageRootDirectory
+});
+module.exports = __toCommonJS(Index_Effect_exports);
+
+// Source/Npm/Npm.Effect.ts
+var import_fs = 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.Effect.ts
+var import_path = require("path");
+var import_effect2 = require("effect");
+
+// Source/Npm/Npm.Effect.Internal.ts
+function HasErrorCode(Value) {
+  return typeof Value === "object" && Value !== null && "code" in Value && typeof Value.code === "string";
+}
+
+// Source/Npm/Npm.Effect.ts
+var import_process = __toESM(require("process"), 1);
+function GetPackageJson(Path) {
+  return import_effect2.Effect.gen(function* () {
+    const RootDirectory = yield* GetPackageRootDirectory(Path);
+    const PackageJsonPath = (0, import_path.join)(RootDirectory, "package.json");
+    const FileContents = yield* import_effect2.Effect.tryPromise({
+      catch: (Cause) => Cause,
+      try: () => import_fs.promises.readFile(PackageJsonPath, "utf-8")
+    }).pipe(import_effect2.Effect.catchAll((Cause) => import_effect2.Effect.die(Cause)));
+    const PackageJson = yield* import_effect2.Effect.try({
+      catch: (Cause) => new PackageJsonParseError({
+        Cause,
+        Path: PackageJsonPath
+      }),
+      try: () => JSON.parse(FileContents)
+    });
+    return PackageJson;
+  });
+}
+function GetPackageRootDirectory(Path) {
+  return import_effect2.Effect.gen(function* () {
+    let CurrentDirectory = yield* import_effect2.Effect.tryPromise({
+      catch: (Cause) => Cause,
+      try: () => import_fs.promises.realpath(Path ?? import_process.default.cwd())
+    }).pipe(import_effect2.Effect.catchAll((Cause) => import_effect2.Effect.die(Cause)));
+    while (true) {
+      const PackageJsonPath = (0, import_path.join)(CurrentDirectory, "package.json");
+      const PackageJsonExists = yield* import_effect2.Effect.tryPromise({
+        catch: (Cause) => Cause,
+        try: () => import_fs.promises.access(PackageJsonPath, import_fs.constants.F_OK)
+      }).pipe(import_effect2.Effect.as(true), import_effect2.Effect.catchIf((Cause) => HasErrorCode(Cause) && Cause.code === "ENOENT", () => import_effect2.Effect.succeed(false)), import_effect2.Effect.catchAll((Cause) => import_effect2.Effect.die(Cause)));
+      if (PackageJsonExists) {
+        return CurrentDirectory;
+      }
+      const ParentDirectory = (0, import_path.dirname)(CurrentDirectory);
+      if (ParentDirectory === CurrentDirectory) {
+        return yield* import_effect2.Effect.fail(new RootDirectoryNotFoundError({ Path }));
+      }
+      CurrentDirectory = ParentDirectory;
+    }
+  });
+}
+/**
+ * @file      Npm.Error.ts
+ * @author    Gage Sorrell <gage@sorrell.sh>
+ * @copyright (c) 2026 Gage Sorrell
+ * @license   MIT
+ */
+/**
+ * @file      Npm.Effect.Internal.ts
+ * @author    Gage Sorrell <gage@sorrell.sh>
+ * @copyright (c) 2026 Gage Sorrell
+ * @license   MIT
+ */
+/**
+ * @file      Npm.Effect.ts
+ * @author    Gage Sorrell <gage@sorrell.sh>
+ * @copyright (c) 2026 Gage Sorrell
+ * @license   MIT
+ */
+/**
+ * @file      Npm.Effect.Types.ts
+ * @author    Gage Sorrell <gage@sorrell.sh>
+ * @copyright (c) 2026 Gage Sorrell
+ * @license   MIT
+ */
+/**
+ * @file      Index.Effect.ts
+ * @author    Gage Sorrell <gage@sorrell.sh>
+ * @copyright (c) 2026 Gage Sorrell
+ * @license   MIT
+ */
+//# sourceMappingURL=npm-effect.cjs.map

package/Distribution/npm-effect.cjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../Source/Npm/Index.Effect.ts", "../Source/Npm/Npm.Effect.ts", "../Source/Npm/Npm.Error.ts", "../Source/Npm/Npm.Effect.Internal.ts"],
+  "sourcesContent": ["/**\n * @file      Index.Effect.ts\n * @author    Gage Sorrell <gage@sorrell.sh>\n * @copyright (c) 2026 Gage Sorrell\n * @license   MIT\n */\nexport * from \"./Npm.Effect.ts\";\nexport * from \"./Npm.Effect.Types.ts\";\n", "/**\n * @file      Npm.Effect.ts\n * @author    Gage Sorrell <gage@sorrell.sh>\n * @copyright (c) 2026 Gage Sorrell\n * @license   MIT\n */\nimport type { EGetPackageJson, EGetPackageRootDirectory } from \"./Npm.Effect.Types.ts\";\nimport { promises as Fs, constants as FsConstants } from \"fs\";\nimport { PackageJsonParseError, RootDirectoryNotFoundError } from \"./Npm.Error.ts\";\nimport { dirname, join } from \"path\";\nimport { Effect } from \"effect\";\nimport { HasErrorCode } from \"./Npm.Effect.Internal.ts\";\nimport type { IPackageJson } from \"package-json-type\";\nimport Process from \"process\";\n/**\n * Get the `package.json` of the Node.js project in which the\n * given path, or the current working directory, resides.\n *\n * @param Path - The given path from which to look for a root directory.\n *\n * @returns {EGetPackageJson} An Effect that succeeds with the parsed `package.json`, or fails\n * with {@link RootDirectoryNotFoundError} or {@link PackageJsonParseError}.\n *\n * @example\n * Suppose `process.cwd() === \"./MyPackage\"`,\n * ```typescript\n * Effect.gen(function* ()\n * {\n *     const PackageJson: IPackageJson = yield* GetPackageJson();\n *     // `PackageJson` <- *The parsed `package.json` of `MyPackage`.*\n * }\n * ```\n */\nexport function GetPackageJson(Path?: string): EGetPackageJson {\n    return Effect.gen(function* () {\n        const RootDirectory: string = yield* GetPackageRootDirectory(Path);\n        const PackageJsonPath: string = join(RootDirectory, \"package.json\");\n        const FileContents: string = yield* Effect.tryPromise({\n            catch: (Cause: unknown) => Cause,\n            try: () => Fs.readFile(PackageJsonPath, \"utf-8\")\n        }).pipe(Effect.catchAll((Cause: unknown) => Effect.die(Cause)));\n        const PackageJson: IPackageJson = yield* Effect.try({\n            catch: (Cause: unknown) => new PackageJsonParseError({\n                Cause,\n                Path: PackageJsonPath\n            }),\n            try: () => JSON.parse(FileContents) as IPackageJson\n        });\n        return PackageJson;\n    });\n}\n/**\n * Get the root directory of the Node.js project in which the\n * current working directory resides.\n *\n * @param Path - *(Optional)* The given path from which to look for a root directory.\n *\n * @returns {EGetPackageRootDirectory} An Effect that succeeds with the package root\n * directory, or fails with {@link RootDirectoryNotFoundError}.\n *\n * @example\n * Suppose `process.cwd()` is any one of the following,\n *   - `/home/alex/myPackage`,\n *   - `/home/alex/myPackage/src/MyModule`,\n *   - `/home/alex/myPackage/resource/Images`,\n *\n * then,\n *\n * ```typescript\n * import { Effect } from \"effect\";\n * const Root: string = await Effect.runPromise(GetPackageRootDirectory());\n * // `Root` <- `\"/home/alex/myPackage\"`\n * ```\n *\n * @example\n * Suppose `TestPath === \"/home/alex/Documents\"` is *not* a NodeJS package root\n * (of course, neither are `/home/alex` or `/home`).  Then,\n *\n * ```typescript\n * import { Effect } from \"effect\";\n * const TestPath: string = \"/home/alex/Documents\";\n * let Root: string | undefined = undefined;\n * try\n * {\n *     Root = await Effect.runPromise(\n *         GetPackageRootDirectory(TestPath)\n *     );\n * }\n * catch (Error: unknown)\n * {\n *      // `Error instanceof RootDirectoryNotFound`\n * }\n *\n * // `Root` <- `undefined`\n * ```\n *\n * @example\n * Suppose `process.cwd() === /home/alex/Downloads`, which is *not* a NodeJS package\n * (of course, neither are `/home/alex` or `/home`).  Then,\n *\n * ```typescript\n * import { Effect } from \"effect\";\n * let Root: string | undefined = undefined;\n * try\n * {\n *     Root = await Effect.runPromise(GetPackageRootDirectory());\n * }\n * catch (Error: unknown)\n * {\n *      // `Error instanceof RootDirectoryNotFound`\n * }\n * // `Root` <- `undefined`\n * ```\n */\nexport function GetPackageRootDirectory(Path?: string): EGetPackageRootDirectory {\n    return Effect.gen(function* () {\n        let CurrentDirectory: string = yield* Effect.tryPromise({\n            catch: (Cause: unknown) => Cause,\n            try: () => Fs.realpath(Path ?? Process.cwd())\n        }).pipe(Effect.catchAll((Cause: unknown) => Effect.die(Cause)));\n        while (true) {\n            const PackageJsonPath: string = join(CurrentDirectory, \"package.json\");\n            const PackageJsonExists: boolean = yield* Effect.tryPromise({\n                catch: (Cause: unknown) => Cause,\n                try: () => Fs.access(PackageJsonPath, FsConstants.F_OK)\n            }).pipe(Effect.as(true), Effect.catchIf((Cause: unknown): Cause is {\n                readonly code: string;\n            } => HasErrorCode(Cause) && Cause.code === \"ENOENT\", () => Effect.succeed(false)), Effect.catchAll((Cause: unknown) => Effect.die(Cause)));\n            if (PackageJsonExists) {\n                return CurrentDirectory;\n            }\n            const ParentDirectory: string = dirname(CurrentDirectory);\n            if (ParentDirectory === CurrentDirectory) {\n                return yield* Effect.fail(new RootDirectoryNotFoundError({ Path }));\n            }\n            CurrentDirectory = ParentDirectory;\n        }\n    });\n}\n", "/**\n * @file      Npm.Error.ts\n * @author    Gage Sorrell <gage@sorrell.sh>\n * @copyright (c) 2026 Gage Sorrell\n * @license   MIT\n */\nimport { Data } from \"effect\";\n/**\n * An error describing that {@link GetPackageJson} failed to parse the discovered `package.json` file.\n *\n * @property {string | undefined} Path - The `Path` argument passed to the effect returning this error,\n * if one was given.\n * @property {unknown} Cause - The cause of this error.\n */\nexport class PackageJsonParseError extends Data.TaggedError(\"PackageJsonParseError\")<{\n    readonly Path: string | undefined;\n    readonly Cause: unknown;\n}> {\n}\n/**\n * An error describing that {@link GetPackageRootDirectory} failed.\n *\n * @property {string | undefined} Path - The `Path` argument passed to the effect returning\n * this error, if one was given.\n */\nexport class RootDirectoryNotFoundError extends Data.TaggedError(\"RootDirectoryNotFound\")<{\n    readonly Path: string | undefined;\n}> {\n}\n", "/**\n * @file      Npm.Effect.Internal.ts\n * @author    Gage Sorrell <gage@sorrell.sh>\n * @copyright (c) 2026 Gage Sorrell\n * @license   MIT\n */\n/* eslint-disable jsdoc/require-example */\n/**\n * Returns whether a given {@link Value} contains a `readonly` `string` `\"code\"`.\n *\n * @param Value - The value to test.\n * @returns {Value is { readonly code: string }} Whether {@link Value} is a\n * `{ readonly code: string }`.\n */\nexport function HasErrorCode(Value: unknown): Value is {\n    readonly code: string;\n} {\n    return typeof Value === \"object\"\n        && Value !== null\n        && \"code\" in Value\n        && typeof (Value as {\n            readonly code: unknown;\n        }).code === \"string\";\n}\n/* eslint-enable jsdoc/require-example */\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACOA,gBAAyD;;;ACDzD,oBAAqB;AAQd,IAAM,wBAAN,cAAoC,mBAAK,YAAY,uBAAuB,EAGhF;AACH;AAOO,IAAM,6BAAN,cAAyC,mBAAK,YAAY,uBAAuB,EAErF;AACH;;;ADnBA,kBAA8B;AAC9B,IAAAA,iBAAuB;;;AEIhB,SAAS,aAAa,OAE3B;AACE,SAAO,OAAO,UAAU,YACjB,UAAU,QACV,UAAU,SACV,OAAQ,MAER,SAAS;AACpB;;;AFVA,qBAAoB;AAoBb,SAAS,eAAe,MAAgC;AAC3D,SAAO,sBAAO,IAAI,aAAa;AAC3B,UAAM,gBAAwB,OAAO,wBAAwB,IAAI;AACjE,UAAM,sBAA0B,kBAAK,eAAe,cAAc;AAClE,UAAM,eAAuB,OAAO,sBAAO,WAAW;AAAA,MAClD,OAAO,CAAC,UAAmB;AAAA,MAC3B,KAAK,MAAM,UAAAC,SAAG,SAAS,iBAAiB,OAAO;AAAA,IACnD,CAAC,EAAE,KAAK,sBAAO,SAAS,CAAC,UAAmB,sBAAO,IAAI,KAAK,CAAC,CAAC;AAC9D,UAAM,cAA4B,OAAO,sBAAO,IAAI;AAAA,MAChD,OAAO,CAAC,UAAmB,IAAI,sBAAsB;AAAA,QACjD;AAAA,QACA,MAAM;AAAA,MACV,CAAC;AAAA,MACD,KAAK,MAAM,KAAK,MAAM,YAAY;AAAA,IACtC,CAAC;AACD,WAAO;AAAA,EACX,CAAC;AACL;AAgEO,SAAS,wBAAwB,MAAyC;AAC7E,SAAO,sBAAO,IAAI,aAAa;AAC3B,QAAI,mBAA2B,OAAO,sBAAO,WAAW;AAAA,MACpD,OAAO,CAAC,UAAmB;AAAA,MAC3B,KAAK,MAAM,UAAAA,SAAG,SAAS,QAAQ,eAAAC,QAAQ,IAAI,CAAC;AAAA,IAChD,CAAC,EAAE,KAAK,sBAAO,SAAS,CAAC,UAAmB,sBAAO,IAAI,KAAK,CAAC,CAAC;AAC9D,WAAO,MAAM;AACT,YAAM,sBAA0B,kBAAK,kBAAkB,cAAc;AACrE,YAAM,oBAA6B,OAAO,sBAAO,WAAW;AAAA,QACxD,OAAO,CAAC,UAAmB;AAAA,QAC3B,KAAK,MAAM,UAAAD,SAAG,OAAO,iBAAiB,UAAAE,UAAY,IAAI;AAAA,MAC1D,CAAC,EAAE,KAAK,sBAAO,GAAG,IAAI,GAAG,sBAAO,QAAQ,CAAC,UAEpC,aAAa,KAAK,KAAK,MAAM,SAAS,UAAU,MAAM,sBAAO,QAAQ,KAAK,CAAC,GAAG,sBAAO,SAAS,CAAC,UAAmB,sBAAO,IAAI,KAAK,CAAC,CAAC;AACzI,UAAI,mBAAmB;AACnB,eAAO;AAAA,MACX;AACA,YAAM,sBAA0B,qBAAQ,gBAAgB;AACxD,UAAI,oBAAoB,kBAAkB;AACtC,eAAO,OAAO,sBAAO,KAAK,IAAI,2BAA2B,EAAE,KAAK,CAAC,CAAC;AAAA,MACtE;AACA,yBAAmB;AAAA,IACvB;AAAA,EACJ,CAAC;AACL;",
+  "names": ["import_effect", "Fs", "Process", "FsConstants"]
+}

package/Distribution/npm-effect.js

@@ -0,0 +1,97 @@
+// Source/Npm/Npm.Effect.ts
+import { promises as Fs, constants as FsConstants } from "fs";
+
+// Source/Npm/Npm.Error.ts
+import { Data } from "effect";
+var PackageJsonParseError = class extends Data.TaggedError("PackageJsonParseError") {
+};
+var RootDirectoryNotFoundError = class extends Data.TaggedError("RootDirectoryNotFound") {
+};
+
+// Source/Npm/Npm.Effect.ts
+import { dirname, join } from "path";
+import { Effect } from "effect";
+
+// Source/Npm/Npm.Effect.Internal.ts
+function HasErrorCode(Value) {
+  return typeof Value === "object" && Value !== null && "code" in Value && typeof Value.code === "string";
+}
+
+// Source/Npm/Npm.Effect.ts
+import Process from "process";
+function GetPackageJson(Path) {
+  return Effect.gen(function* () {
+    const RootDirectory = yield* GetPackageRootDirectory(Path);
+    const PackageJsonPath = join(RootDirectory, "package.json");
+    const FileContents = yield* Effect.tryPromise({
+      catch: (Cause) => Cause,
+      try: () => Fs.readFile(PackageJsonPath, "utf-8")
+    }).pipe(Effect.catchAll((Cause) => Effect.die(Cause)));
+    const PackageJson = yield* Effect.try({
+      catch: (Cause) => new PackageJsonParseError({
+        Cause,
+        Path: PackageJsonPath
+      }),
+      try: () => JSON.parse(FileContents)
+    });
+    return PackageJson;
+  });
+}
+function GetPackageRootDirectory(Path) {
+  return Effect.gen(function* () {
+    let CurrentDirectory = yield* Effect.tryPromise({
+      catch: (Cause) => Cause,
+      try: () => Fs.realpath(Path ?? Process.cwd())
+    }).pipe(Effect.catchAll((Cause) => Effect.die(Cause)));
+    while (true) {
+      const PackageJsonPath = join(CurrentDirectory, "package.json");
+      const PackageJsonExists = yield* Effect.tryPromise({
+        catch: (Cause) => Cause,
+        try: () => Fs.access(PackageJsonPath, FsConstants.F_OK)
+      }).pipe(Effect.as(true), Effect.catchIf((Cause) => HasErrorCode(Cause) && Cause.code === "ENOENT", () => Effect.succeed(false)), Effect.catchAll((Cause) => Effect.die(Cause)));
+      if (PackageJsonExists) {
+        return CurrentDirectory;
+      }
+      const ParentDirectory = dirname(CurrentDirectory);
+      if (ParentDirectory === CurrentDirectory) {
+        return yield* Effect.fail(new RootDirectoryNotFoundError({ Path }));
+      }
+      CurrentDirectory = ParentDirectory;
+    }
+  });
+}
+export {
+  GetPackageJson,
+  GetPackageRootDirectory
+};
+/**
+ * @file      Npm.Error.ts
+ * @author    Gage Sorrell <gage@sorrell.sh>
+ * @copyright (c) 2026 Gage Sorrell
+ * @license   MIT
+ */
+/**
+ * @file      Npm.Effect.Internal.ts
+ * @author    Gage Sorrell <gage@sorrell.sh>
+ * @copyright (c) 2026 Gage Sorrell
+ * @license   MIT
+ */
+/**
+ * @file      Npm.Effect.ts
+ * @author    Gage Sorrell <gage@sorrell.sh>
+ * @copyright (c) 2026 Gage Sorrell
+ * @license   MIT
+ */
+/**
+ * @file      Npm.Effect.Types.ts
+ * @author    Gage Sorrell <gage@sorrell.sh>
+ * @copyright (c) 2026 Gage Sorrell
+ * @license   MIT
+ */
+/**
+ * @file      Index.Effect.ts
+ * @author    Gage Sorrell <gage@sorrell.sh>
+ * @copyright (c) 2026 Gage Sorrell
+ * @license   MIT
+ */
+//# sourceMappingURL=npm-effect.js.map

package/Distribution/npm-effect.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../Source/Npm/Npm.Effect.ts", "../Source/Npm/Npm.Error.ts", "../Source/Npm/Npm.Effect.Internal.ts"],
+  "sourcesContent": ["/**\n * @file      Npm.Effect.ts\n * @author    Gage Sorrell <gage@sorrell.sh>\n * @copyright (c) 2026 Gage Sorrell\n * @license   MIT\n */\nimport type { EGetPackageJson, EGetPackageRootDirectory } from \"./Npm.Effect.Types.ts\";\nimport { promises as Fs, constants as FsConstants } from \"fs\";\nimport { PackageJsonParseError, RootDirectoryNotFoundError } from \"./Npm.Error.ts\";\nimport { dirname, join } from \"path\";\nimport { Effect } from \"effect\";\nimport { HasErrorCode } from \"./Npm.Effect.Internal.ts\";\nimport type { IPackageJson } from \"package-json-type\";\nimport Process from \"process\";\n/**\n * Get the `package.json` of the Node.js project in which the\n * given path, or the current working directory, resides.\n *\n * @param Path - The given path from which to look for a root directory.\n *\n * @returns {EGetPackageJson} An Effect that succeeds with the parsed `package.json`, or fails\n * with {@link RootDirectoryNotFoundError} or {@link PackageJsonParseError}.\n *\n * @example\n * Suppose `process.cwd() === \"./MyPackage\"`,\n * ```typescript\n * Effect.gen(function* ()\n * {\n *     const PackageJson: IPackageJson = yield* GetPackageJson();\n *     // `PackageJson` <- *The parsed `package.json` of `MyPackage`.*\n * }\n * ```\n */\nexport function GetPackageJson(Path?: string): EGetPackageJson {\n    return Effect.gen(function* () {\n        const RootDirectory: string = yield* GetPackageRootDirectory(Path);\n        const PackageJsonPath: string = join(RootDirectory, \"package.json\");\n        const FileContents: string = yield* Effect.tryPromise({\n            catch: (Cause: unknown) => Cause,\n            try: () => Fs.readFile(PackageJsonPath, \"utf-8\")\n        }).pipe(Effect.catchAll((Cause: unknown) => Effect.die(Cause)));\n        const PackageJson: IPackageJson = yield* Effect.try({\n            catch: (Cause: unknown) => new PackageJsonParseError({\n                Cause,\n                Path: PackageJsonPath\n            }),\n            try: () => JSON.parse(FileContents) as IPackageJson\n        });\n        return PackageJson;\n    });\n}\n/**\n * Get the root directory of the Node.js project in which the\n * current working directory resides.\n *\n * @param Path - *(Optional)* The given path from which to look for a root directory.\n *\n * @returns {EGetPackageRootDirectory} An Effect that succeeds with the package root\n * directory, or fails with {@link RootDirectoryNotFoundError}.\n *\n * @example\n * Suppose `process.cwd()` is any one of the following,\n *   - `/home/alex/myPackage`,\n *   - `/home/alex/myPackage/src/MyModule`,\n *   - `/home/alex/myPackage/resource/Images`,\n *\n * then,\n *\n * ```typescript\n * import { Effect } from \"effect\";\n * const Root: string = await Effect.runPromise(GetPackageRootDirectory());\n * // `Root` <- `\"/home/alex/myPackage\"`\n * ```\n *\n * @example\n * Suppose `TestPath === \"/home/alex/Documents\"` is *not* a NodeJS package root\n * (of course, neither are `/home/alex` or `/home`).  Then,\n *\n * ```typescript\n * import { Effect } from \"effect\";\n * const TestPath: string = \"/home/alex/Documents\";\n * let Root: string | undefined = undefined;\n * try\n * {\n *     Root = await Effect.runPromise(\n *         GetPackageRootDirectory(TestPath)\n *     );\n * }\n * catch (Error: unknown)\n * {\n *      // `Error instanceof RootDirectoryNotFound`\n * }\n *\n * // `Root` <- `undefined`\n * ```\n *\n * @example\n * Suppose `process.cwd() === /home/alex/Downloads`, which is *not* a NodeJS package\n * (of course, neither are `/home/alex` or `/home`).  Then,\n *\n * ```typescript\n * import { Effect } from \"effect\";\n * let Root: string | undefined = undefined;\n * try\n * {\n *     Root = await Effect.runPromise(GetPackageRootDirectory());\n * }\n * catch (Error: unknown)\n * {\n *      // `Error instanceof RootDirectoryNotFound`\n * }\n * // `Root` <- `undefined`\n * ```\n */\nexport function GetPackageRootDirectory(Path?: string): EGetPackageRootDirectory {\n    return Effect.gen(function* () {\n        let CurrentDirectory: string = yield* Effect.tryPromise({\n            catch: (Cause: unknown) => Cause,\n            try: () => Fs.realpath(Path ?? Process.cwd())\n        }).pipe(Effect.catchAll((Cause: unknown) => Effect.die(Cause)));\n        while (true) {\n            const PackageJsonPath: string = join(CurrentDirectory, \"package.json\");\n            const PackageJsonExists: boolean = yield* Effect.tryPromise({\n                catch: (Cause: unknown) => Cause,\n                try: () => Fs.access(PackageJsonPath, FsConstants.F_OK)\n            }).pipe(Effect.as(true), Effect.catchIf((Cause: unknown): Cause is {\n                readonly code: string;\n            } => HasErrorCode(Cause) && Cause.code === \"ENOENT\", () => Effect.succeed(false)), Effect.catchAll((Cause: unknown) => Effect.die(Cause)));\n            if (PackageJsonExists) {\n                return CurrentDirectory;\n            }\n            const ParentDirectory: string = dirname(CurrentDirectory);\n            if (ParentDirectory === CurrentDirectory) {\n                return yield* Effect.fail(new RootDirectoryNotFoundError({ Path }));\n            }\n            CurrentDirectory = ParentDirectory;\n        }\n    });\n}\n", "/**\n * @file      Npm.Error.ts\n * @author    Gage Sorrell <gage@sorrell.sh>\n * @copyright (c) 2026 Gage Sorrell\n * @license   MIT\n */\nimport { Data } from \"effect\";\n/**\n * An error describing that {@link GetPackageJson} failed to parse the discovered `package.json` file.\n *\n * @property {string | undefined} Path - The `Path` argument passed to the effect returning this error,\n * if one was given.\n * @property {unknown} Cause - The cause of this error.\n */\nexport class PackageJsonParseError extends Data.TaggedError(\"PackageJsonParseError\")<{\n    readonly Path: string | undefined;\n    readonly Cause: unknown;\n}> {\n}\n/**\n * An error describing that {@link GetPackageRootDirectory} failed.\n *\n * @property {string | undefined} Path - The `Path` argument passed to the effect returning\n * this error, if one was given.\n */\nexport class RootDirectoryNotFoundError extends Data.TaggedError(\"RootDirectoryNotFound\")<{\n    readonly Path: string | undefined;\n}> {\n}\n", "/**\n * @file      Npm.Effect.Internal.ts\n * @author    Gage Sorrell <gage@sorrell.sh>\n * @copyright (c) 2026 Gage Sorrell\n * @license   MIT\n */\n/* eslint-disable jsdoc/require-example */\n/**\n * Returns whether a given {@link Value} contains a `readonly` `string` `\"code\"`.\n *\n * @param Value - The value to test.\n * @returns {Value is { readonly code: string }} Whether {@link Value} is a\n * `{ readonly code: string }`.\n */\nexport function HasErrorCode(Value: unknown): Value is {\n    readonly code: string;\n} {\n    return typeof Value === \"object\"\n        && Value !== null\n        && \"code\" in Value\n        && typeof (Value as {\n            readonly code: unknown;\n        }).code === \"string\";\n}\n/* eslint-enable jsdoc/require-example */\n"],
+  "mappings": ";AAOA,SAAS,YAAY,IAAI,aAAa,mBAAmB;;;ACDzD,SAAS,YAAY;AAQd,IAAM,wBAAN,cAAoC,KAAK,YAAY,uBAAuB,EAGhF;AACH;AAOO,IAAM,6BAAN,cAAyC,KAAK,YAAY,uBAAuB,EAErF;AACH;;;ADnBA,SAAS,SAAS,YAAY;AAC9B,SAAS,cAAc;;;AEIhB,SAAS,aAAa,OAE3B;AACE,SAAO,OAAO,UAAU,YACjB,UAAU,QACV,UAAU,SACV,OAAQ,MAER,SAAS;AACpB;;;AFVA,OAAO,aAAa;AAoBb,SAAS,eAAe,MAAgC;AAC3D,SAAO,OAAO,IAAI,aAAa;AAC3B,UAAM,gBAAwB,OAAO,wBAAwB,IAAI;AACjE,UAAM,kBAA0B,KAAK,eAAe,cAAc;AAClE,UAAM,eAAuB,OAAO,OAAO,WAAW;AAAA,MAClD,OAAO,CAAC,UAAmB;AAAA,MAC3B,KAAK,MAAM,GAAG,SAAS,iBAAiB,OAAO;AAAA,IACnD,CAAC,EAAE,KAAK,OAAO,SAAS,CAAC,UAAmB,OAAO,IAAI,KAAK,CAAC,CAAC;AAC9D,UAAM,cAA4B,OAAO,OAAO,IAAI;AAAA,MAChD,OAAO,CAAC,UAAmB,IAAI,sBAAsB;AAAA,QACjD;AAAA,QACA,MAAM;AAAA,MACV,CAAC;AAAA,MACD,KAAK,MAAM,KAAK,MAAM,YAAY;AAAA,IACtC,CAAC;AACD,WAAO;AAAA,EACX,CAAC;AACL;AAgEO,SAAS,wBAAwB,MAAyC;AAC7E,SAAO,OAAO,IAAI,aAAa;AAC3B,QAAI,mBAA2B,OAAO,OAAO,WAAW;AAAA,MACpD,OAAO,CAAC,UAAmB;AAAA,MAC3B,KAAK,MAAM,GAAG,SAAS,QAAQ,QAAQ,IAAI,CAAC;AAAA,IAChD,CAAC,EAAE,KAAK,OAAO,SAAS,CAAC,UAAmB,OAAO,IAAI,KAAK,CAAC,CAAC;AAC9D,WAAO,MAAM;AACT,YAAM,kBAA0B,KAAK,kBAAkB,cAAc;AACrE,YAAM,oBAA6B,OAAO,OAAO,WAAW;AAAA,QACxD,OAAO,CAAC,UAAmB;AAAA,QAC3B,KAAK,MAAM,GAAG,OAAO,iBAAiB,YAAY,IAAI;AAAA,MAC1D,CAAC,EAAE,KAAK,OAAO,GAAG,IAAI,GAAG,OAAO,QAAQ,CAAC,UAEpC,aAAa,KAAK,KAAK,MAAM,SAAS,UAAU,MAAM,OAAO,QAAQ,KAAK,CAAC,GAAG,OAAO,SAAS,CAAC,UAAmB,OAAO,IAAI,KAAK,CAAC,CAAC;AACzI,UAAI,mBAAmB;AACnB,eAAO;AAAA,MACX;AACA,YAAM,kBAA0B,QAAQ,gBAAgB;AACxD,UAAI,oBAAoB,kBAAkB;AACtC,eAAO,OAAO,OAAO,KAAK,IAAI,2BAA2B,EAAE,KAAK,CAAC,CAAC;AAAA,MACtE;AACA,yBAAmB;AAAA,IACvB;AAAA,EACJ,CAAC;AACL;",
+  "names": []
+}

package/Distribution/npm.cjs

@@ -0,0 +1,106 @@
+"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/Npm/index.ts
+var Npm_exports = {};
+__export(Npm_exports, {
+  GetPackageJson: () => GetPackageJson,
+  GetPackageRootDirectory: () => GetPackageRootDirectory,
+  PackageJsonParseError: () => PackageJsonParseError,
+  RootDirectoryNotFoundError: () => RootDirectoryNotFoundError
+});
+module.exports = __toCommonJS(Npm_exports);
+
+// Source/Npm/Npm.ts
+var import_fs = 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_path = require("path");
+var import_process = __toESM(require("process"), 1);
+async function GetPackageJson(Path) {
+  const RootDirectory = await GetPackageRootDirectory(Path);
+  const PackageJsonPath = (0, import_path.join)(RootDirectory, "package.json");
+  const FileContents = await import_fs.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_fs.promises.realpath(Path ?? import_process.default.cwd());
+  while (true) {
+    const PackageJsonPath = (0, import_path.join)(CurrentDirectory, "package.json");
+    const PackageJsonExists = await (async () => {
+      try {
+        await import_fs.promises.access(PackageJsonPath, import_fs.constants.F_OK);
+        return true;
+      } catch {
+        return false;
+      }
+    })();
+    if (PackageJsonExists) {
+      return CurrentDirectory;
+    }
+    const ParentDirectory = (0, import_path.dirname)(CurrentDirectory);
+    if (ParentDirectory === CurrentDirectory) {
+      throw new RootDirectoryNotFoundError({ Path });
+    }
+    CurrentDirectory = ParentDirectory;
+  }
+}
+/**
+ * @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      index.ts
+ * @author    Gage Sorrell <gage@sorrell.sh>
+ * @copyright (c) 2026 Gage Sorrell
+ * @license   MIT
+ */
+//# sourceMappingURL=npm.cjs.map

package/Distribution/npm.cjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../Source/Npm/index.ts", "../Source/Npm/Npm.ts", "../Source/Npm/Npm.Error.ts"],
+  "sourcesContent": ["/**\n * @file      index.ts\n * @author    Gage Sorrell <gage@sorrell.sh>\n * @copyright (c) 2026 Gage Sorrell\n * @license   MIT\n */\n/**\n * @module Npm\n * Utilities for working with `npm` (NodeJS) packages.\n * Many of these likely work with packages of other NodeJS\n * package managers and adjacent runtimes (*e.g.*, `bun` or `deno`).\n */\nexport * from \"./Npm.ts\";\nexport * from \"./Npm.Error.ts\";\n", "/**\n * @file      Npm.ts\n * @author    Gage Sorrell <gage@sorrell.sh>\n * @copyright (c) 2026 Gage Sorrell\n * @license   MIT\n */\nimport { promises as Fs, constants as FsConstants } from \"fs\";\nimport { PackageJsonParseError, RootDirectoryNotFoundError } from \"./Npm.Error.ts\";\nimport { dirname, join } from \"path\";\nimport type { IPackageJson } from \"package-json-type\";\nimport Process from \"process\";\n/**\n * Get the `package.json` of the Node.js project in which the\n * given path, or the current working directory, resides.\n *\n * @param Path - The given path from which to look for a root directory.\n *\n * @throws {RootDirectoryNotFoundError | PackageJsonParseError} An error\n * describing either failure to identify a root directory, or failing to\n * parse the discovered `package.json`.\n *\n * @returns {Promise<IPackageJson>} The {@link IPackageJson} of {@link Path}\n * if provided, otherwise of `process.cwd()`.\n *\n * @example\n * Suppose `process.cwd() === \"./MyPackage\"`,\n * ```typescript\n * const PackageJson: IPackageJson = await GetPackageJson();\n * // `PackageJson` <- *The parsed `package.json` of `MyPackage`.*\n * ```\n */\nexport async function GetPackageJson(Path?: string): Promise<IPackageJson> {\n    const RootDirectory: string = await GetPackageRootDirectory(Path);\n    const PackageJsonPath: string = join(RootDirectory, \"package.json\");\n    const FileContents: string = await Fs.readFile(PackageJsonPath, \"utf-8\");\n    const PackageJson: IPackageJson = await (async (): Promise<IPackageJson> => {\n        try {\n            return JSON.parse(FileContents) as IPackageJson;\n        }\n        catch (Cause: unknown) {\n            throw new PackageJsonParseError({ Cause, Path: PackageJsonPath });\n        }\n    })();\n    return PackageJson;\n}\n/**\n * Get the root directory of the Node.js project in which the\n * current working directory resides.\n *\n * @param Path - The given path from which to look for a root directory.\n *\n * @throws {RootDirectoryNotFoundError} An error iff the root directory\n * of a NodeJS package could not be found.\n *\n * @returns {Promise<string>} The path to the root directory of the package\n * containing {@link Path} if specified, otherwise containing `process.cwd()`.\n *\n * @example\n * Suppose `process.cwd()` is any one of the following,\n *   - `/home/alex/myPackage`,\n *   - `/home/alex/myPackage/src/MyModule`,\n *   - `/home/alex/myPackage/resource/Images`,\n *\n * then,\n *\n * ```typescript\n * const Root: string = await GetPackageRootDirectory();\n * // `Root` <- `\"/home/alex/myPackage\"`\n * ```\n *\n * @example\n * Suppose `TestPath === \"/home/alex/Documents\"` is *not* a NodeJS package root\n * (of course, neither are `/home/alex` or `/home`).  Then,\n *\n * ```typescript\n * const TestPath: string = \"/home/alex/Documents\";\n * let Root: string | undefined = undefined;\n * try\n * {\n *     Root = await GetPackageRootDirectory(TestPath);\n * }\n * catch (Error: unknown)\n * {\n *      // `Error instanceof RootDirectoryNotFound`\n * }\n *\n * // `Root` <- `undefined`\n * ```\n *\n * @example\n * Suppose `process.cwd() === /home/alex/Downloads`, which is *not* a NodeJS package\n * (of course, neither are `/home/alex` or `/home`).  Then,\n *\n * ```typescript\n * let Root: string | undefined = undefined;\n * try\n * {\n *     Root = await GetPackageRootDirectory();\n * }\n * catch (Error: unknown)\n * {\n *      // `Error instanceof RootDirectoryNotFound`\n * }\n * // `Root` <- `undefined`\n * ```\n */\nexport async function GetPackageRootDirectory(Path?: string): Promise<string> {\n    let CurrentDirectory: string = await Fs.realpath(Path ?? Process.cwd());\n    while (true) {\n        const PackageJsonPath: string = join(CurrentDirectory, \"package.json\");\n        const PackageJsonExists: boolean = await (async (): Promise<boolean> => {\n            try {\n                await Fs.access(PackageJsonPath, FsConstants.F_OK);\n                return true;\n            }\n            catch {\n                return false;\n            }\n        })();\n        if (PackageJsonExists) {\n            return CurrentDirectory;\n        }\n        const ParentDirectory: string = dirname(CurrentDirectory);\n        if (ParentDirectory === CurrentDirectory) {\n            throw new RootDirectoryNotFoundError({ Path });\n        }\n        CurrentDirectory = ParentDirectory;\n    }\n}\n", "/**\n * @file      Npm.Error.ts\n * @author    Gage Sorrell <gage@sorrell.sh>\n * @copyright (c) 2026 Gage Sorrell\n * @license   MIT\n */\nimport { Data } from \"effect\";\n/**\n * An error describing that {@link GetPackageJson} failed to parse the discovered `package.json` file.\n *\n * @property {string | undefined} Path - The `Path` argument passed to the effect returning this error,\n * if one was given.\n * @property {unknown} Cause - The cause of this error.\n */\nexport class PackageJsonParseError extends Data.TaggedError(\"PackageJsonParseError\")<{\n    readonly Path: string | undefined;\n    readonly Cause: unknown;\n}> {\n}\n/**\n * An error describing that {@link GetPackageRootDirectory} failed.\n *\n * @property {string | undefined} Path - The `Path` argument passed to the effect returning\n * this error, if one was given.\n */\nexport class RootDirectoryNotFoundError extends Data.TaggedError(\"RootDirectoryNotFound\")<{\n    readonly Path: string | undefined;\n}> {\n}\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACMA,gBAAyD;;;ACAzD,oBAAqB;AAQd,IAAM,wBAAN,cAAoC,mBAAK,YAAY,uBAAuB,EAGhF;AACH;AAOO,IAAM,6BAAN,cAAyC,mBAAK,YAAY,uBAAuB,EAErF;AACH;;;ADpBA,kBAA8B;AAE9B,qBAAoB;AAqBpB,eAAsB,eAAe,MAAsC;AACvE,QAAM,gBAAwB,MAAM,wBAAwB,IAAI;AAChE,QAAM,sBAA0B,kBAAK,eAAe,cAAc;AAClE,QAAM,eAAuB,MAAM,UAAAA,SAAG,SAAS,iBAAiB,OAAO;AACvE,QAAM,cAA4B,OAAO,YAAmC;AACxE,QAAI;AACA,aAAO,KAAK,MAAM,YAAY;AAAA,IAClC,SACO,OAAgB;AACnB,YAAM,IAAI,sBAAsB,EAAE,OAAO,MAAM,gBAAgB,CAAC;AAAA,IACpE;AAAA,EACJ,GAAG;AACH,SAAO;AACX;AA8DA,eAAsB,wBAAwB,MAAgC;AAC1E,MAAI,mBAA2B,MAAM,UAAAA,SAAG,SAAS,QAAQ,eAAAC,QAAQ,IAAI,CAAC;AACtE,SAAO,MAAM;AACT,UAAM,sBAA0B,kBAAK,kBAAkB,cAAc;AACrE,UAAM,oBAA6B,OAAO,YAA8B;AACpE,UAAI;AACA,cAAM,UAAAD,SAAG,OAAO,iBAAiB,UAAAE,UAAY,IAAI;AACjD,eAAO;AAAA,MACX,QACM;AACF,eAAO;AAAA,MACX;AAAA,IACJ,GAAG;AACH,QAAI,mBAAmB;AACnB,aAAO;AAAA,IACX;AACA,UAAM,sBAA0B,qBAAQ,gBAAgB;AACxD,QAAI,oBAAoB,kBAAkB;AACtC,YAAM,IAAI,2BAA2B,EAAE,KAAK,CAAC;AAAA,IACjD;AACA,uBAAmB;AAAA,EACvB;AACJ;",
+  "names": ["Fs", "Process", "FsConstants"]
+}

package/Distribution/npm.js

@@ -0,0 +1,73 @@
+// Source/Npm/Npm.ts
+import { promises as Fs, constants as FsConstants } from "fs";
+
+// Source/Npm/Npm.Error.ts
+import { Data } from "effect";
+var PackageJsonParseError = class extends Data.TaggedError("PackageJsonParseError") {
+};
+var RootDirectoryNotFoundError = class extends Data.TaggedError("RootDirectoryNotFound") {
+};
+
+// Source/Npm/Npm.ts
+import { dirname, join } from "path";
+import Process from "process";
+async function GetPackageJson(Path) {
+  const RootDirectory = await GetPackageRootDirectory(Path);
+  const PackageJsonPath = join(RootDirectory, "package.json");
+  const FileContents = await Fs.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 Fs.realpath(Path ?? Process.cwd());
+  while (true) {
+    const PackageJsonPath = join(CurrentDirectory, "package.json");
+    const PackageJsonExists = await (async () => {
+      try {
+        await Fs.access(PackageJsonPath, FsConstants.F_OK);
+        return true;
+      } catch {
+        return false;
+      }
+    })();
+    if (PackageJsonExists) {
+      return CurrentDirectory;
+    }
+    const ParentDirectory = dirname(CurrentDirectory);
+    if (ParentDirectory === CurrentDirectory) {
+      throw new RootDirectoryNotFoundError({ Path });
+    }
+    CurrentDirectory = ParentDirectory;
+  }
+}
+export {
+  GetPackageJson,
+  GetPackageRootDirectory,
+  PackageJsonParseError,
+  RootDirectoryNotFoundError
+};
+/**
+ * @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      index.ts
+ * @author    Gage Sorrell <gage@sorrell.sh>
+ * @copyright (c) 2026 Gage Sorrell
+ * @license   MIT
+ */
+//# sourceMappingURL=npm.js.map