tools-node

@rnx-kit/tools-node is a collection of supplemental NodeJS functions and types.

You can import the entire package, or, to save space, import individual categories:

import * as tools from "@rnx-kit/tools-node";

// Alternatively...
import * as moduleTools from "@rnx-kit/tools-node/module";
import * as packageTools from "@rnx-kit/tools-node/package";
import * as pathTools from "@rnx-kit/tools-node/path";

Category	Type Name	Description
module	FileModuleRef	Module reference rooted to a file system location, either relative to a directory, or as an absolute path. For example, `./index` or `/repos/rnx-kit/packages/tools/src/index`.
module	PackageModuleRef	Module reference relative to a package, such as `react-native` or `@rnx-kit/tools/node/index`.
package	FindPackageDependencyOptions	Options which control how package dependecies are located.
package	PackageManifest	Schema for the contents of a `package.json` manifest file.
package	PackagePerson	Schema for a reference to a person in `package.json`.
package	PackageRef	Components of a package reference.

Category	Function	Description
module	`getPackageModuleRefFromModulePath(modulePath)`	Convert a module path to a package module reference.
module	`isFileModuleRef(r)`	Is the module reference relative to a file location?
module	`isPackageModuleRef(r)`	Is the module reference a package module reference?
module	`parseModuleRef(r)`	Parse a module reference into either a package module reference or a file module reference.
package	`findPackage(startDir)`	Find the nearest `package.json` manifest file. Search upward through all parent directories.
package	`findPackageDependencyDir(ref, options)`	Find the package dependency's directory, starting from the given directory and moving outward, through all parent directories.
package	`findPackageDir(startDir)`	Find the parent directory of the nearest `package.json` manifest file. Search upward through all parent directories.
package	`parsePackageRef(r)`	Parse a package reference string. An example reference is the `name` property found in `package.json`.
package	`readPackage(pkgPath)`	Read a `package.json` manifest from a file.
package	`resolveDependencyChain(chain, startDir)`	Resolve the path to a dependency given a chain of dependencies leading up to it.
package	`writePackage(pkgPath, manifest, space)`	Write a `package.json` manifest to a file.
path	`findUp(names, options)`	Finds the specified file(s) or directory(s) by walking up parent directories.
path	`normalizePath(p)`	Normalize the separators in a path, converting each backslash ('\') to a foreward slash ('/').