@mnaoumov/typescript-lib 0.0.0 → 1.0.0

package/dist/lib/cjs/object-utils.d.cts

@@ -0,0 +1,298 @@
+/// <reference path="./library.d.cts" />
+/**
+ * @file
+ *
+ * Contains utility functions for Objects.
+ */
+import type { RequiredKeysOf, UndefinedOnPartialDeep } from 'type-fest' with { 'resolution-mode': 'import' };
+import type { GenericObject } from './type-guards.cjs';
+import type { ExactMembers, StringKeys } from './type.cjs';
+/**
+ * Specifies how functions should be handled in the JSON output.
+ */
+export declare enum FunctionHandlingMode {
+    /**
+     * Excludes functions from the JSON output.
+     */
+    Exclude = "exclude",
+    /**
+     * Includes the full function definition in the JSON output.
+     */
+    Full = "full",
+    /**
+     * Includes only the function name in the JSON output.
+     */
+    NameOnly = "nameOnly"
+}
+/**
+ * Options for {@link toJson}.
+ */
+export interface ToJsonOptions {
+    /**
+     * Specifies how functions should be handled in the JSON output.
+     *
+     * @default {@link FunctionHandlingMode.Exclude}
+     */
+    readonly functionHandlingMode: FunctionHandlingMode;
+    /**
+     * Specifies the maximum depth of nested objects to include in the JSON output.
+     * Use `-1` for no limit.
+     *
+     * @default `-1`
+     */
+    readonly maxDepth: number;
+    /**
+     * Specifies whether to catch errors in `toJSON()` and replace them with a placeholder.
+     *
+     * @default `false`
+     */
+    readonly shouldCatchToJSONErrors: boolean;
+    /**
+     * Specifies whether to handle circular references in the JSON output.
+     *
+     * @default `false`
+     */
+    readonly shouldHandleCircularReferences: boolean;
+    /**
+     * Specifies whether to handle errors in the JSON output.
+     *
+     * @default `false`
+     */
+    readonly shouldHandleErrors: boolean;
+    /**
+     * Specifies whether to handle `undefined` values in the JSON output.
+     *
+     * @default `false`
+     */
+    readonly shouldHandleUndefined: boolean;
+    /**
+     * Specifies whether to sort the keys of the JSON output.
+     *
+     * @default `false`
+     */
+    readonly shouldSortKeys: boolean;
+    /**
+     * Specifies the indentation of the JSON output. This can be a number of spaces or a string.
+     *
+     * @default `2`
+     */
+    readonly space: number | string;
+    /**
+     * Specifies the substitutions to use in the JSON output.
+     */
+    readonly tokenSubstitutions: Partial<TokenSubstitutions>;
+}
+interface ModuleWithDefaultExport<T> {
+    default: T;
+}
+interface TokenSubstitutions {
+    circularReference: string;
+    maxDepthLimitReached: string;
+    toJSONFailed: string;
+}
+/**
+ * Parameters for {@link setNestedPropertyValue}.
+ */
+export interface SetNestedPropertyValueParams {
+    /**
+     * The object to set the nested property value in.
+     */
+    readonly $object: GenericObject;
+    /**
+     * The path to the nested property.
+     */
+    readonly path: string;
+    /**
+     * The value to set.
+     */
+    readonly value: unknown;
+}
+type KeysWithUndefined<T> = KeysWithUndefinedMap<T>[keyof T];
+type KeysWithUndefinedMap<T> = {
+    [K in keyof T]-?: undefined extends T[K] ? K : never;
+};
+type MandatoryKeysWithUndefined<T extends object> = Extract<RequiredKeysOf<T> & StringKeys<T>, KeysWithUndefined<T>>;
+type RemoveUndefinedOverload<T extends object> = MandatoryKeysWithUndefined<T> extends never ? [obj: T] : never;
+type RemoveUndefinedWithKeysOverload<T extends object, K extends readonly string[]> = [obj: T, keysToKeep: ExactMembers<MandatoryKeysWithUndefined<T>, K>];
+/**
+ * Assigns properties from one or more source objects to a target object, including non-enumerable properties.
+ *
+ * @typeParam T - The target object type.
+ * @typeParam U - The source object type.
+ * @param target - The target object to assign properties to.
+ * @param source - The source object to assign properties from.
+ * @returns The target object with the assigned properties.
+ */
+export declare function assignWithNonEnumerableProperties<T extends object, U>(target: T, source: U): T & U;
+/**
+ * Assigns properties from one or more source objects to a target object, including non-enumerable properties.
+ *
+ * @typeParam T - The target object type.
+ * @typeParam U - The first source object type.
+ * @typeParam V - The second source object type.
+ * @param target - The target object to assign properties to.
+ * @param source1 - The first source object to assign properties from.
+ * @param source2 - The second source object to assign properties from.
+ * @returns The target object with the assigned properties.
+ */
+export declare function assignWithNonEnumerableProperties<T extends object, U, V>(target: T, source1: U, source2: V): T & U & V;
+/**
+ * Assigns properties from one or more source objects to a target object, including non-enumerable properties.
+ *
+ * @typeParam T - The target object type.
+ * @typeParam U - The first source object type.
+ * @typeParam V - The second source object type.
+ * @typeParam W - The third source object type.
+ * @param target - The target object to assign properties to.
+ * @param source1 - The first source object to assign properties from.
+ * @param source2 - The second source object to assign properties from.
+ * @param source3 - The third source object to assign properties from.
+ * @returns The target object with the assigned properties.
+ */
+export declare function assignWithNonEnumerableProperties<T extends object, U, V, W>(target: T, source1: U, source2: V, source3: W): T & U & V & W;
+/**
+ * Casts a value to a specific type.
+ *
+ * @typeParam T - The target type to cast to.
+ * @param value - The value to cast.
+ * @returns The value as the specified type.
+ */
+export declare function castTo<T>(value: unknown): T;
+/**
+ * Clones an object, including non-enumerable properties.
+ *
+ * @typeParam T - The type of the object.
+ * @param $object - The object to clone.
+ * @returns A new object with the same properties as the original object, including non-enumerable properties.
+ */
+export declare function cloneWithNonEnumerableProperties<T extends object>($object: T): T;
+/**
+ * Deletes multiple properties from an object.
+ *
+ * @typeParam T - The type of the object.
+ * @param $object - The object to delete the properties from.
+ * @param propertyNames - The names of the properties to delete.
+ * @returns `true` if any of the properties were present, otherwise `false`.
+ */
+export declare function deleteProperties<T extends object>($object: T, propertyNames: (keyof T)[]): boolean;
+/**
+ * Deletes a property from an object.
+ *
+ * @typeParam T - The type of the object.
+ * @param $object - The object to delete the property from.
+ * @param propertyName - The name of the property to delete.
+ * @returns `true` if the property was present, otherwise `false`.
+ */
+export declare function deleteProperty<T extends object>($object: T, propertyName: keyof T): boolean;
+/**
+ * Extracts the default export from a module.
+ *
+ * Useful to handle incorrect default export interop between ESM and CJS.
+ *
+ * @typeParam T - The type of the default export.
+ * @param module - The module to extract the default export from.
+ * @returns The default export.
+ */
+export declare function extractDefaultExportInterop<T>(module: ModuleWithDefaultExport<T> | T): T;
+/**
+ * Gets all entries of an object.
+ *
+ * @typeParam T - The type of the object.
+ * @param $object - The object to get the entries of.
+ * @returns An array of all entries of the object.
+ */
+export declare function getAllEntries<T extends object>($object: T): [StringKeys<T>, T[StringKeys<T>]][];
+/**
+ * Gets all keys of an object.
+ * Includes fields and properties.
+ *
+ * @typeParam T - The type of the object.
+ * @param $object - The object to get the keys of.
+ * @returns An array of all keys of the object.
+ */
+export declare function getAllKeys<T extends object>($object: T): StringKeys<T>[];
+/**
+ * Gets the value of a nested property from an object.
+ *
+ * @param $object - The object to get the nested property value from.
+ * @param path - The path to the nested property.
+ * @returns The value of the nested property.
+ */
+export declare function getNestedPropertyValue($object: GenericObject, path: string): unknown;
+/**
+ * Gets the prototype of the specified object.
+ *
+ * @typeParam T - The type of the object.
+ * @param instance - The object instance to retrieve the prototype of.
+ * @returns The prototype of the object.
+ */
+export declare function getPrototypeOf<T>(instance: T): T;
+/**
+ * Compares two values to determine if they are deeply equal.
+ *
+ * @param a - The first value to compare.
+ * @param b - The second value to compare.
+ * @returns `true` if the values are deeply equal, otherwise `false`.
+ */
+export declare function isDeepEqual(a: unknown, b: unknown): boolean;
+/**
+ * Retrieves the name of a property of a given type `T`.
+ *
+ * @typeParam T - The type of the object containing the property.
+ * @param name - The name of the property as a string.
+ * @returns The name of the property.
+ */
+export declare function nameof<T extends object>(name: StringKeys<T>): StringKeys<T>;
+/**
+ * Normalizes optional properties to allow `undefined` assignment in strict mode.
+ *
+ * This utility provides a workaround for the `exactOptionalPropertyTypes` TypeScript flag,
+ * which prohibits directly assigning `undefined` to optional properties when the type
+ * explicitly omits `undefined`.
+ *
+ * Example:
+ * ```typescript
+ * // With `exactOptionalPropertyTypes: true`
+ * const x: { prop?: string } = { prop: undefined }; // Compiler error
+ *
+ * // Using this utility:
+ * const y: { prop?: string } = normalizeOptionalProperties<{ prop?: string }>({ prop: undefined }); // Works
+ * ```
+ *
+ * @typeParam T - The target type with optional properties to normalize.
+ * @param $object - The object to normalize, allowing explicit `undefined` for optional properties.
+ * @returns The normalized object, compatible with `exactOptionalPropertyTypes`.
+ */
+export declare function normalizeOptionalProperties<T>($object: UndefinedOnPartialDeep<T>): T;
+/**
+ * Removes all `undefined` properties from an object when there are no mandatory keys with `undefined` values.
+ *
+ * @typeParam Type - The type of the object.
+ * @param $arguments - The arguments to the function.
+ * @returns The object with all `undefined` properties removed.
+ */
+export declare function removeUndefinedProperties<Type extends object>(...$arguments: RemoveUndefinedOverload<Type>): Type;
+/**
+ * Removes all `undefined` properties from an object when there are mandatory keys with `undefined` values.
+ *
+ * @typeParam Type - The type of the object.
+ * @typeParam KeysToKeep - The keys to keep.
+ * @param $arguments - The arguments to the function.
+ * @returns The object with all `undefined` properties removed.
+ */
+export declare function removeUndefinedProperties<Type extends object, const KeysToKeep extends readonly string[]>(...$arguments: RemoveUndefinedWithKeysOverload<Type, KeysToKeep>): Type;
+/**
+ * Sets the value of a nested property in an object.
+ *
+ * @param params - The parameters for setting the nested property value.
+ */
+export declare function setNestedPropertyValue(params: SetNestedPropertyValueParams): void;
+/**
+ * Converts a given value to a JSON string.
+ *
+ * @param value - The value to be converted to JSON. This can be of any type.
+ * @param options - Options for customizing the JSON conversion process.
+ * @returns The JSON string representation of the input value.
+ */
+export declare function toJson(value: unknown, options?: Partial<ToJsonOptions>): string;
+export {};

package/dist/lib/cjs/path.cjs

@@ -0,0 +1,202 @@
+/*
+THIS IS A GENERATED/BUNDLED FILE BY ESBUILD
+if you want to view the source, please visit the github repository of this plugin
+*/
+
+(function () {
+function ensureDisposeSymbols(symbolConstructor = Symbol) {
+  symbolConstructor.asyncDispose ??= symbolConstructor.for('Symbol.asyncDispose');
+  symbolConstructor.dispose ??= symbolConstructor.for('Symbol.dispose');
+}
+
+function ensureBrowserProcess() {
+  const browserProcess = {
+    browser: true,
+    cwd() {
+      return '/';
+    },
+    env: {},
+    platform: 'android'
+  };
+
+  // eslint-disable-next-line obsidianmd/no-global-this, unicorn/no-unnecessary-global-this -- Must stay `globalThis`-qualified: in the emitted banner a bare `process` is a free identifier, so reading it where the host has none throws a ReferenceError instead of yielding `undefined`. That is the very case this function exists to handle.
+  const existingProcess = globalThis.process;
+
+  if (!existingProcess) {
+    // eslint-disable-next-line obsidianmd/no-global-this -- Actively use globalThis.
+    globalThis.process = browserProcess;
+    return;
+  }
+
+  if (existingProcess.versions?.node) {
+    return;
+  }
+
+  const existingProcessRecord = existingProcess;
+
+  for (const [key, value] of Object.entries(browserProcess)) {
+    existingProcessRecord[key] ??= value;
+  }
+
+  existingProcessRecord['browser'] = true;
+}
+
+function keepName($unknown) {
+  return $unknown;
+}
+
+(function initCjs() {
+  // eslint-disable-next-line obsidianmd/no-global-this -- Actively use globalThis.
+  const globalThisRecord = globalThis;
+  ensureDisposeSymbols();
+  globalThisRecord['__name'] ??= keepName;
+  globalThisRecord['__extractDefault'] ??= extractDefault;
+
+  ensureBrowserProcess();
+
+  // eslint-disable-next-line unicorn/consistent-function-scoping -- Serialized with initCjs into the banner; at module scope it would be left out of it.
+  function extractDefault(module) {
+    return module && module.__esModule && 'default' in module ? module.default : module;
+  }
+})();
+})();
+
+"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);
+var path_exports = {};
+__export(path_exports, {
+  basename: () => basename,
+  delimiter: () => delimiter,
+  dirname: () => dirname,
+  extname: () => extname,
+  format: () => format,
+  getFileName: () => getFileName,
+  getFolderName: () => getFolderName,
+  isAbsolute: () => isAbsolute,
+  join: () => join,
+  makeFileName: () => makeFileName,
+  normalizeIfRelative: () => normalizeIfRelative,
+  normalizePath: () => normalizePath,
+  parse: () => parse,
+  posix: () => posix,
+  relative: () => relative,
+  resolve: () => resolve,
+  separator: () => separator,
+  toPosixBuffer: () => toPosixBuffer,
+  toPosixPath: () => toPosixPath
+});
+module.exports = __toCommonJS(path_exports);
+var import_path_browserify = __toESM(__extractDefault(require('path-browserify')), 1);
+var import_string = require('./string.cjs');
+const WINDOWS_DRIVE_REG_EXP = /^[a-zA-Z]:\//;
+const WINDOWS_POSIX_LIKE_PATH_REG_EXP = /[a-zA-Z]:\/[^:]*$/;
+const posix = import_path_browserify.default.posix;
+const delimiter = posix.delimiter;
+const separator = import_path_browserify.default.posix.sep;
+const basename = posix.basename;
+const dirname = posix.dirname;
+const extname = posix.extname;
+const format = posix.format;
+function isAbsolute(path) {
+  return posix.isAbsolute(path) || WINDOWS_POSIX_LIKE_PATH_REG_EXP.exec(path)?.[0] === path;
+}
+const join = posix.join;
+const normalizePath = posix.normalize;
+const parse = posix.parse;
+function getFileName(importMetaUrl) {
+  return resolve(decodeURI(new URL(importMetaUrl).pathname));
+}
+function getFolderName(importMetaUrl) {
+  return dirname(getFileName(importMetaUrl));
+}
+function makeFileName(params) {
+  return params.fileExtension ? `${params.fileBaseName}.${params.fileExtension}` : params.fileBaseName;
+}
+function normalizeIfRelative(path) {
+  return path.startsWith("/") || path.includes(":") ? path : (0, import_string.ensureStartsWith)({
+    $string: path,
+    prefix: "./"
+  });
+}
+function relative(from, to) {
+  const resolvedFrom = resolve(from);
+  const resolvedTo = resolve(to);
+  const fromDrive = WINDOWS_DRIVE_REG_EXP.exec(resolvedFrom)?.[0].toUpperCase();
+  const toDrive = WINDOWS_DRIVE_REG_EXP.exec(resolvedTo)?.[0].toUpperCase();
+  return fromDrive === toDrive ? posix.relative(toRootedPosixPath(upperCaseDrive(resolvedFrom)), toRootedPosixPath(upperCaseDrive(resolvedTo))) : resolvedTo;
+}
+function resolve(...pathSegments) {
+  const rootedSegments = pathSegments.map((segment) => toRootedPosixPath(segment));
+  if (rootedSegments.every((segment) => !segment.startsWith("/"))) {
+    rootedSegments.unshift(toRootedPosixPath(process.cwd()));
+  }
+  const path = posix.resolve(...rootedSegments);
+  const match = WINDOWS_POSIX_LIKE_PATH_REG_EXP.exec(path);
+  return match?.[0] ?? path;
+}
+function toPosixBuffer(buffer) {
+  return Buffer.from(toPosixPath(String(buffer)));
+}
+function toPosixPath(path) {
+  return (0, import_string.replaceAll)({
+    $string: path,
+    replacer: "/",
+    searchValue: "\\"
+  });
+}
+function toRootedPosixPath(path) {
+  const posixPath = toPosixPath(path);
+  return WINDOWS_DRIVE_REG_EXP.test(posixPath) ? `/${posixPath}` : posixPath;
+}
+function upperCaseDrive(path) {
+  return path.replace(WINDOWS_DRIVE_REG_EXP, (drive) => drive.toUpperCase());
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  basename,
+  delimiter,
+  dirname,
+  extname,
+  format,
+  getFileName,
+  getFolderName,
+  isAbsolute,
+  join,
+  makeFileName,
+  normalizeIfRelative,
+  normalizePath,
+  parse,
+  posix,
+  relative,
+  resolve,
+  separator,
+  toPosixBuffer,
+  toPosixPath
+});
+//# sourceMappingURL=data:application/json;base64,ewogICJ2ZXJzaW9uIjogMywKICAic291cmNlcyI6IFsiLi4vLi4vLi4vc3JjL3BhdGgudHMiXSwKICAic291cmNlc0NvbnRlbnQiOiBbIi8qKlxuICogQGZpbGVcbiAqXG4gKiBDb250YWlucyB1dGlsaXR5IGZ1bmN0aW9ucyBmb3IgaGFuZGxpbmcgcGF0aHMuXG4gKi9cblxuaW1wb3J0IHBhdGhCcm93c2VyaWZ5IGZyb20gJ3BhdGgtYnJvd3NlcmlmeSc7XG5cbmltcG9ydCB7XG4gIGVuc3VyZVN0YXJ0c1dpdGgsXG4gIHJlcGxhY2VBbGxcbn0gZnJvbSAnLi9zdHJpbmcudHMnO1xuXG5jb25zdCBXSU5ET1dTX0RSSVZFX1JFR19FWFAgPSAvXlthLXpBLVpdOlxcLy87XG5jb25zdCBXSU5ET1dTX1BPU0lYX0xJS0VfUEFUSF9SRUdfRVhQID0gL1thLXpBLVpdOlxcL1teOl0qJC87XG5cbi8qKlxuICogUHJvdmlkZXMgbWV0aG9kcyBmb3IgaGFuZGxpbmcgUE9TSVggcGF0aHMuXG4gKi9cbmV4cG9ydCBjb25zdCBwb3NpeCA9IHBhdGhCcm93c2VyaWZ5LnBvc2l4O1xuXG4vKipcbiAqIEEgUE9TSVggcGF0aCBkZWxpbWl0ZXIuXG4gKi9cbmV4cG9ydCBjb25zdCBkZWxpbWl0ZXIgPSBwb3NpeC5kZWxpbWl0ZXI7XG5cbi8qKlxuICogQSBQT1NJWCBzZWdtZW50IHNlcGFyYXRvci5cbiAqL1xuZXhwb3J0IGNvbnN0IHNlcGFyYXRvciA9IHBhdGhCcm93c2VyaWZ5LnBvc2l4LnNlcDtcblxuLyoqXG4gKiBSZXR1cm5zIHRoZSBiYXNlIG5hbWUgb2YgYSBmaWxlLCBvcHRpb25hbGx5IHJlbW92aW5nIHRoZSBmaWxlIGV4dGVuc2lvbi5cbiAqXG4gKiBAcGFyYW0gcGF0aCAtIFRoZSBwYXRoIHRvIGdldCB0aGUgYmFzZSBuYW1lIGZyb20uXG4gKiBAcGFyYW0gZXh0IC0gQW4gb3B0aW9uYWwgZXh0ZW5zaW9uIHRvIHJlbW92ZSBmcm9tIHRoZSBiYXNlIG5hbWUuXG4gKiBAcmV0dXJucyBUaGUgYmFzZSBuYW1lIG9mIHRoZSBmaWxlLlxuICovXG5leHBvcnQgY29uc3QgYmFzZW5hbWUgPSBwb3NpeC5iYXNlbmFtZTtcblxuLyoqXG4gKiBSZXR1cm5zIHRoZSBkaXJlY3RvcnkgbmFtZSBvZiBhIHBhdGguXG4gKlxuICogYGRpcmVjdG9yeWAgaXMgdXNlZCBpbnN0ZWFkIG9mIGBmb2xkZXJgIHRvIHByZXNlcnZlIGNvbXBhdGliaWxpdHkgd2l0aCBgbm9kZTpwYXRoYCBtb2R1bGUuXG4gKlxuICogQHBhcmFtIHBhdGggLSBUaGUgcGF0aCB0byBnZXQgdGhlIGRpcmVjdG9yeSBuYW1lIGZyb20uXG4gKiBAcmV0dXJucyBUaGUgZGlyZWN0b3J5IG5hbWUgb2YgdGhlIHBhdGguXG4gKi9cbmV4cG9ydCBjb25zdCBkaXJuYW1lID0gcG9zaXguZGlybmFtZTtcblxuLyoqXG4gKiBSZXR1cm5zIHRoZSBmaWxlIGV4dGVuc2lvbiBvZiBhIHBhdGguXG4gKlxuICogQHBhcmFtIHBhdGggLSBUaGUgcGF0aCB0byBnZXQgdGhlIGV4dGVuc2lvbiBmcm9tLlxuICogQHJldHVybnMgVGhlIGZpbGUgZXh0ZW5zaW9uIG9mIHRoZSBwYXRoLlxuICovXG5leHBvcnQgY29uc3QgZXh0bmFtZSA9IHBvc2l4LmV4dG5hbWU7XG5cbi8qKlxuICogRm9ybWF0cyBhIHBhdGggb2JqZWN0IGludG8gYSBwYXRoIHN0cmluZy5cbiAqXG4gKiBAcGFyYW0gcGF0aE9iamVjdCAtIFRoZSBwYXRoIG9iamVjdCB0byBmb3JtYXQuXG4gKiBAcmV0dXJucyBUaGUgZm9ybWF0dGVkIHBhdGggc3RyaW5nLlxuICovXG5leHBvcnQgY29uc3QgZm9ybWF0ID0gcG9zaXguZm9ybWF0O1xuXG4vKipcbiAqIERldGVybWluZXMgaWYgYSBwYXRoIGlzIGFic29sdXRlLlxuICpcbiAqIEBwYXJhbSBwYXRoIC0gVGhlIHBhdGggdG8gY2hlY2suXG4gKiBAcmV0dXJucyBgdHJ1ZWAgaWYgdGhlIHBhdGggaXMgYWJzb2x1dGUsIGBmYWxzZWAgb3RoZXJ3aXNlLlxuICovXG5leHBvcnQgZnVuY3Rpb24gaXNBYnNvbHV0ZShwYXRoOiBzdHJpbmcpOiBib29sZWFuIHtcbiAgcmV0dXJuIHBvc2l4LmlzQWJzb2x1dGUocGF0aCkgfHwgV0lORE9XU19QT1NJWF9MSUtFX1BBVEhfUkVHX0VYUC5leGVjKHBhdGgpPy5bMF0gPT09IHBhdGg7XG59XG5cbi8qKlxuICogSm9pbnMgbXVsdGlwbGUgcGF0aCBzZWdtZW50cyBpbnRvIGEgc2luZ2xlIHBhdGguXG4gKlxuICogQHBhcmFtIHBhdGhzIC0gVGhlIHBhdGggc2VnbWVudHMgdG8gam9pbi5cbiAqIEByZXR1cm5zIFRoZSBqb2luZWQgcGF0aC5cbiAqL1xuZXhwb3J0IGNvbnN0IGpvaW4gPSBwb3NpeC5qb2luO1xuXG4vKipcbiAqIE5vcm1hbGl6ZXMgYSBwYXRoLCByZXNvbHZpbmcgJy4uJyBhbmQgJy4nIHNlZ21lbnRzLlxuICpcbiAqIEBwYXJhbSBwYXRoIC0gVGhlIHBhdGggdG8gbm9ybWFsaXplLlxuICogQHJldHVybnMgVGhlIG5vcm1hbGl6ZWQgcGF0aC5cbiAqL1xuZXhwb3J0IGNvbnN0IG5vcm1hbGl6ZVBhdGggPSBwb3NpeC5ub3JtYWxpemU7XG5cbi8qKlxuICogUGFyc2VzIGEgcGF0aCBzdHJpbmcgaW50byBhIHBhdGggb2JqZWN0LlxuICpcbiAqIEBwYXJhbSBwYXRoIC0gVGhlIHBhdGggc3RyaW5nIHRvIHBhcnNlLlxuICogQHJldHVybnMgVGhlIHBhcnNlZCBwYXRoIG9iamVjdC5cbiAqL1xuZXhwb3J0IGNvbnN0IHBhcnNlID0gcG9zaXgucGFyc2U7XG5cbi8qKlxuICogUGFyYW1ldGVycyBmb3Ige0BsaW5rIG1ha2VGaWxlTmFtZX0uXG4gKi9cbmV4cG9ydCBpbnRlcmZhY2UgTWFrZUZpbGVOYW1lUGFyYW1zIHtcbiAgLyoqXG4gICAqIFRoZSBmaWxlIG5hbWUgdG8gYXBwZW5kIHRoZSBleHRlbnNpb24gdG8uXG4gICAqL1xuICByZWFkb25seSBmaWxlQmFzZU5hbWU6IHN0cmluZztcblxuICAvKipcbiAgICogVGhlIGV4dGVuc2lvbiB0byBhcHBlbmQgdG8gdGhlIGZpbGUgbmFtZS5cbiAgICovXG4gIHJlYWRvbmx5IGZpbGVFeHRlbnNpb246IHN0cmluZztcbn1cblxuLyoqXG4gKiBHZXRzIHRoZSBmaWxlIG5hbWUgZnJvbSB0aGUgYGltcG9ydChkb3QpbWV0YShkb3QpdXJsYCwgY29udmVydGluZyBpdCB0byBhIFBPU0lYLXN0eWxlIHBhdGguXG4gKlxuICogQHBhcmFtIGltcG9ydE1ldGFVcmwgLSBUaGUgYGltcG9ydChkb3QpbWV0YShkb3QpdXJsYCBmcm9tIHdoaWNoIHRvIGV4dHJhY3QgdGhlIGZpbGUgbmFtZS5cbiAqIEByZXR1cm5zIFRoZSBQT1NJWC1zdHlsZSBmaWxlIG5hbWUuXG4gKi9cbmV4cG9ydCBmdW5jdGlvbiBnZXRGaWxlTmFtZShpbXBvcnRNZXRhVXJsOiBzdHJpbmcpOiBzdHJpbmcge1xuICByZXR1cm4gcmVzb2x2ZShkZWNvZGVVUkkobmV3IFVSTChpbXBvcnRNZXRhVXJsKS5wYXRobmFtZSkpO1xufVxuXG4vKipcbiAqIEdldHMgdGhlIGZvbGRlciBuYW1lIGZyb20gdGhlIGBpbXBvcnQoZG90KW1ldGEoZG90KXVybGAsIGNvbnZlcnRpbmcgaXQgdG8gYSBQT1NJWC1zdHlsZSBwYXRoLlxuICpcbiAqIEBwYXJhbSBpbXBvcnRNZXRhVXJsIC0gVGhlIGBpbXBvcnQoZG90KW1ldGEoZG90KXVybGAgZnJvbSB3aGljaCB0byBleHRyYWN0IHRoZSBmb2xkZXIgbmFtZS5cbiAqIEByZXR1cm5zIFRoZSBQT1NJWC1zdHlsZSBmb2xkZXIgbmFtZS5cbiAqL1xuZXhwb3J0IGZ1bmN0aW9uIGdldEZvbGRlck5hbWUoaW1wb3J0TWV0YVVybDogc3RyaW5nKTogc3RyaW5nIHtcbiAgcmV0dXJuIGRpcm5hbWUoZ2V0RmlsZU5hbWUoaW1wb3J0TWV0YVVybCkpO1xufVxuXG4vKipcbiAqIE1ha2VzIGEgZmlsZSBuYW1lIGJ5IGFwcGVuZGluZyBhbiBleHRlbnNpb24gdG8gYSBnaXZlbiBmaWxlIG5hbWUuXG4gKiBJZiB0aGUgZXh0ZW5zaW9uIGlzIGVtcHR5LCB0aGUgZmlsZSBuYW1lIGlzIHJldHVybmVkIGFzIGlzLlxuICpcbiAqIEBwYXJhbSBwYXJhbXMgLSBUaGUgcGFyYW1ldGVycyBmb3IgbWFraW5nIHRoZSBmaWxlIG5hbWUuXG4gKiBAcmV0dXJucyBUaGUgZmlsZSBuYW1lIHdpdGggdGhlIGV4dGVuc2lvbiBhcHBlbmRlZC5cbiAqL1xuZXhwb3J0IGZ1bmN0aW9uIG1ha2VGaWxlTmFtZShwYXJhbXM6IE1ha2VGaWxlTmFtZVBhcmFtcyk6IHN0cmluZyB7XG4gIHJldHVybiBwYXJhbXMuZmlsZUV4dGVuc2lvbiA/IGAke3BhcmFtcy5maWxlQmFzZU5hbWV9LiR7cGFyYW1zLmZpbGVFeHRlbnNpb259YCA6IHBhcmFtcy5maWxlQmFzZU5hbWU7XG59XG5cbi8qKlxuICogTm9ybWFsaXplcyBhIGdpdmVuIHBhdGggYnkgZW5zdXJpbmcgaXQgaXMgcmVsYXRpdmUsIGFkZGluZyBcIi4vXCIgaWYgbmVjZXNzYXJ5LlxuICpcbiAqIEBwYXJhbSBwYXRoIC0gVGhlIHBhdGggdG8gbm9ybWFsaXplLlxuICogQHJldHVybnMgVGhlIG5vcm1hbGl6ZWQgcGF0aCwgc3RhcnRpbmcgd2l0aCBcIi4vXCIgaWYgaXQgd2FzIHJlbGF0aXZlLlxuICovXG5leHBvcnQgZnVuY3Rpb24gbm9ybWFsaXplSWZSZWxhdGl2ZShwYXRoOiBzdHJpbmcpOiBzdHJpbmcge1xuICByZXR1cm4gcGF0aC5zdGFydHNXaXRoKCcvJykgfHwgcGF0aC5pbmNsdWRlcygnOicpXG4gICAgPyBwYXRoXG4gICAgOiBlbnN1cmVTdGFydHNXaXRoKHtcbiAgICAgICRzdHJpbmc6IHBhdGgsXG4gICAgICBwcmVmaXg6ICcuLydcbiAgICB9KTtcbn1cblxuLyoqXG4gKiBSZXR1cm5zIHRoZSByZWxhdGl2ZSBwYXRoIGZyb20gb25lIHBhdGggdG8gYW5vdGhlci5cbiAqXG4gKiBgcGF0aC1icm93c2VyaWZ5YCdzIG93biBgcmVsYXRpdmVgIGNhbm5vdCBiZSB1c2VkIGRpcmVjdGx5OiBpdCByZXNvbHZlcyBhIHJlbGF0aXZlIGFyZ3VtZW50IGFnYWluc3RcbiAqIGBwcm9jZXNzLmN3ZCgpYCwgd2hpY2ggb24gV2luZG93cyBpcyBgRjpcXC4uLmAgcmF0aGVyIHRoYW4gYSBQT1NJWCBhYnNvbHV0ZSBwYXRoLCBhbmQgaXRzIHNsaWNpbmcgdGhlbiBhc3N1bWVzIGFcbiAqIGxlYWRpbmcgYC9gIC0gc28gYHJlbGF0aXZlKCdzcmMnLCAnLi4veCcpYCBjYW1lIGJhY2sgYXMgYCcuLi8uLngnYC4gQm90aCBhcmd1bWVudHMgYXJlIHJlc29sdmVkIHRocm91Z2hcbiAqIHtAbGluayByZXNvbHZlfSBoZXJlIGluc3RlYWQsIGFuZCByb290ZWQgYXQgYC9gIGJlZm9yZSB0aGUgUE9TSVggY29tcGFyaXNvbi5cbiAqXG4gKiBAcGFyYW0gZnJvbSAtIFRoZSBzdGFydGluZyBwYXRoLlxuICogQHBhcmFtIHRvIC0gVGhlIGRlc3RpbmF0aW9uIHBhdGguXG4gKiBAcmV0dXJucyBUaGUgcmVsYXRpdmUgcGF0aCBmcm9tIGBmcm9tYCB0byBgdG9gLlxuICovXG5leHBvcnQgZnVuY3Rpb24gcmVsYXRpdmUoZnJvbTogc3RyaW5nLCB0bzogc3RyaW5nKTogc3RyaW5nIHtcbiAgY29uc3QgcmVzb2x2ZWRGcm9tID0gcmVzb2x2ZShmcm9tKTtcbiAgY29uc3QgcmVzb2x2ZWRUbyA9IHJlc29sdmUodG8pO1xuICBjb25zdCBmcm9tRHJpdmUgPSBXSU5ET1dTX0RSSVZFX1JFR19FWFAuZXhlYyhyZXNvbHZlZEZyb20pPy5bMF0udG9VcHBlckNhc2UoKTtcbiAgY29uc3QgdG9Ecml2ZSA9IFdJTkRPV1NfRFJJVkVfUkVHX0VYUC5leGVjKHJlc29sdmVkVG8pPy5bMF0udG9VcHBlckNhc2UoKTtcbiAgcmV0dXJuIGZyb21Ecml2ZSA9PT0gdG9Ecml2ZVxuICAgID8gcG9zaXgucmVsYXRpdmUodG9Sb290ZWRQb3NpeFBhdGgodXBwZXJDYXNlRHJpdmUocmVzb2x2ZWRGcm9tKSksIHRvUm9vdGVkUG9zaXhQYXRoKHVwcGVyQ2FzZURyaXZlKHJlc29sdmVkVG8pKSlcbiAgICA6IHJlc29sdmVkVG87XG59XG5cbi8qKlxuICogUmVzb2x2ZXMgYSBzZXF1ZW5jZSBvZiBwYXRocyBvciBwYXRoIHNlZ21lbnRzIGludG8gYW4gYWJzb2x1dGUgcGF0aC5cbiAqXG4gKiBAcGFyYW0gcGF0aFNlZ21lbnRzIC0gVGhlIHNlcXVlbmNlIG9mIHBhdGggc2VnbWVudHMgdG8gcmVzb2x2ZS5cbiAqIEByZXR1cm5zIFRoZSByZXNvbHZlZCBhYnNvbHV0ZSBwYXRoLlxuICovXG5leHBvcnQgZnVuY3Rpb24gcmVzb2x2ZSguLi5wYXRoU2VnbWVudHM6IHN0cmluZ1tdKTogc3RyaW5nIHtcbiAgLypcbiAgICogYHBhdGgtYnJvd3NlcmlmeWAgdHJlYXRzIG9ubHkgYSBsZWFkaW5nIGAvYCBhcyBhYnNvbHV0ZSBhbmQgam9pbnMgYHByb2Nlc3MuY3dkKClgIGluIGFzIGFuIG9wYXF1ZSBzZWdtZW50LCBzbyBvblxuICAgKiBXaW5kb3dzIGEgYC4uYCBjbGltYmluZyBvdXQgb2YgdGhlIHdvcmtpbmcgZm9sZGVyIGNhbmNlbGxlZCB0aGUgd2hvbGUgYEY6XFwuLi5gIGN3ZC4gRXZlcnkgc2VnbWVudCBpcyBtYWRlIFBPU0lYXG4gICAqIGFuZCBhIGRyaXZlIHJvb3QgaXMgZ2l2ZW4gYSBsZWFkaW5nIGAvYCwgd2hpY2ggbWFrZXMgaXQgYSByb290IGBwYXRoLWJyb3dzZXJpZnlgIHVuZGVyc3RhbmRzOyB0aGUgYC9gIGlzIGRyb3BwZWRcbiAgICogYWdhaW4gYmVsb3cuXG4gICAqL1xuICBjb25zdCByb290ZWRTZWdtZW50cyA9IHBhdGhTZWdtZW50cy5tYXAoKHNlZ21lbnQpID0+IHRvUm9vdGVkUG9zaXhQYXRoKHNlZ21lbnQpKTtcbiAgaWYgKHJvb3RlZFNlZ21lbnRzLmV2ZXJ5KChzZWdtZW50KSA9PiAhc2VnbWVudC5zdGFydHNXaXRoKCcvJykpKSB7XG4gICAgcm9vdGVkU2VnbWVudHMudW5zaGlmdCh0b1Jvb3RlZFBvc2l4UGF0aChwcm9jZXNzLmN3ZCgpKSk7XG4gIH1cbiAgY29uc3QgcGF0aCA9IHBvc2l4LnJlc29sdmUoLi4ucm9vdGVkU2VnbWVudHMpO1xuICBjb25zdCBtYXRjaCA9IFdJTkRPV1NfUE9TSVhfTElLRV9QQVRIX1JFR19FWFAuZXhlYyhwYXRoKTtcbiAgcmV0dXJuIG1hdGNoPy5bMF0gPz8gcGF0aDtcbn1cblxuLyoqXG4gKiBDb252ZXJ0cyBhIGJ1ZmZlciBjb250YWluaW5nIGEgcGF0aCB0byBhIFBPU0lYLXN0eWxlIGJ1ZmZlciBieSByZXBsYWNpbmcgYmFja3NsYXNoZXMgd2l0aCBmb3J3YXJkIHNsYXNoZXMuXG4gKlxuICogQHBhcmFtIGJ1ZmZlciAtIFRoZSBidWZmZXIgdG8gY29udmVydC5cbiAqIEByZXR1cm5zIEEgbmV3IGJ1ZmZlciBjb250YWluaW5nIHRoZSBQT1NJWC1zdHlsZSBwYXRoLlxuICovXG5leHBvcnQgZnVuY3Rpb24gdG9Qb3NpeEJ1ZmZlcihidWZmZXI6IEJ1ZmZlcik6IEJ1ZmZlciB7XG4gIHJldHVybiBCdWZmZXIuZnJvbSh0b1Bvc2l4UGF0aChTdHJpbmcoYnVmZmVyKSkpO1xufVxuXG4vKipcbiAqIENvbnZlcnRzIGEgZ2l2ZW4gcGF0aCB0byBhIFBPU0lYLXN0eWxlIHBhdGggYnkgcmVwbGFjaW5nIGJhY2tzbGFzaGVzIHdpdGggZm9yd2FyZCBzbGFzaGVzLlxuICpcbiAqIEBwYXJhbSBwYXRoIC0gVGhlIHBhdGggdG8gY29udmVydC5cbiAqIEByZXR1cm5zIFRoZSBQT1NJWC1zdHlsZSBwYXRoLlxuICovXG5leHBvcnQgZnVuY3Rpb24gdG9Qb3NpeFBhdGgocGF0aDogc3RyaW5nKTogc3RyaW5nIHtcbiAgcmV0dXJuIHJlcGxhY2VBbGwoe1xuICAgICRzdHJpbmc6IHBhdGgsXG4gICAgcmVwbGFjZXI6ICcvJyxcbiAgICBzZWFyY2hWYWx1ZTogJ1xcXFwnXG4gIH0pO1xufVxuXG5mdW5jdGlvbiB0b1Jvb3RlZFBvc2l4UGF0aChwYXRoOiBzdHJpbmcpOiBzdHJpbmcge1xuICBjb25zdCBwb3NpeFBhdGggPSB0b1Bvc2l4UGF0aChwYXRoKTtcbiAgcmV0dXJuIFdJTkRPV1NfRFJJVkVfUkVHX0VYUC50ZXN0KHBvc2l4UGF0aCkgPyBgLyR7cG9zaXhQYXRofWAgOiBwb3NpeFBhdGg7XG59XG5cbmZ1bmN0aW9uIHVwcGVyQ2FzZURyaXZlKHBhdGg6IHN0cmluZyk6IHN0cmluZyB7XG4gIHJldHVybiBwYXRoLnJlcGxhY2UoV0lORE9XU19EUklWRV9SRUdfRVhQLCAoZHJpdmUpID0+IGRyaXZlLnRvVXBwZXJDYXNlKCkpO1xufVxuIl0sCiAgIm1hcHBpbmdzIjogIjs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7OztBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFNQSw2QkFBMkI7QUFFM0Isb0JBR087QUFFUCxNQUFNLHdCQUF3QjtBQUM5QixNQUFNLGtDQUFrQztBQUtqQyxNQUFNLFFBQVEsdUJBQUFBLFFBQWU7QUFLN0IsTUFBTSxZQUFZLE1BQU07QUFLeEIsTUFBTSxZQUFZLHVCQUFBQSxRQUFlLE1BQU07QUFTdkMsTUFBTSxXQUFXLE1BQU07QUFVdkIsTUFBTSxVQUFVLE1BQU07QUFRdEIsTUFBTSxVQUFVLE1BQU07QUFRdEIsTUFBTSxTQUFTLE1BQU07QUFRckIsU0FBUyxXQUFXLE1BQXVCO0FBQ2hELFNBQU8sTUFBTSxXQUFXLElBQUksS0FBSyxnQ0FBZ0MsS0FBSyxJQUFJLElBQUksQ0FBQyxNQUFNO0FBQ3ZGO0FBUU8sTUFBTSxPQUFPLE1BQU07QUFRbkIsTUFBTSxnQkFBZ0IsTUFBTTtBQVE1QixNQUFNLFFBQVEsTUFBTTtBQXVCcEIsU0FBUyxZQUFZLGVBQStCO0FBQ3pELFNBQU8sUUFBUSxVQUFVLElBQUksSUFBSSxhQUFhLEVBQUUsUUFBUSxDQUFDO0FBQzNEO0FBUU8sU0FBUyxjQUFjLGVBQStCO0FBQzNELFNBQU8sUUFBUSxZQUFZLGFBQWEsQ0FBQztBQUMzQztBQVNPLFNBQVMsYUFBYSxRQUFvQztBQUMvRCxTQUFPLE9BQU8sZ0JBQWdCLEdBQUcsT0FBTyxZQUFZLElBQUksT0FBTyxhQUFhLEtBQUssT0FBTztBQUMxRjtBQVFPLFNBQVMsb0JBQW9CLE1BQXNCO0FBQ3hELFNBQU8sS0FBSyxXQUFXLEdBQUcsS0FBSyxLQUFLLFNBQVMsR0FBRyxJQUM1QyxXQUNBLGdDQUFpQjtBQUFBLElBQ2pCLFNBQVM7QUFBQSxJQUNULFFBQVE7QUFBQSxFQUNWLENBQUM7QUFDTDtBQWNPLFNBQVMsU0FBUyxNQUFjLElBQW9CO0FBQ3pELFFBQU0sZUFBZSxRQUFRLElBQUk7QUFDakMsUUFBTSxhQUFhLFFBQVEsRUFBRTtBQUM3QixRQUFNLFlBQVksc0JBQXNCLEtBQUssWUFBWSxJQUFJLENBQUMsRUFBRSxZQUFZO0FBQzVFLFFBQU0sVUFBVSxzQkFBc0IsS0FBSyxVQUFVLElBQUksQ0FBQyxFQUFFLFlBQVk7QUFDeEUsU0FBTyxjQUFjLFVBQ2pCLE1BQU0sU0FBUyxrQkFBa0IsZUFBZSxZQUFZLENBQUMsR0FBRyxrQkFBa0IsZUFBZSxVQUFVLENBQUMsQ0FBQyxJQUM3RztBQUNOO0FBUU8sU0FBUyxXQUFXLGNBQWdDO0FBT3pELFFBQU0saUJBQWlCLGFBQWEsSUFBSSxDQUFDLFlBQVksa0JBQWtCLE9BQU8sQ0FBQztBQUMvRSxNQUFJLGVBQWUsTUFBTSxDQUFDLFlBQVksQ0FBQyxRQUFRLFdBQVcsR0FBRyxDQUFDLEdBQUc7QUFDL0QsbUJBQWUsUUFBUSxrQkFBa0IsUUFBUSxJQUFJLENBQUMsQ0FBQztBQUFBLEVBQ3pEO0FBQ0EsUUFBTSxPQUFPLE1BQU0sUUFBUSxHQUFHLGNBQWM7QUFDNUMsUUFBTSxRQUFRLGdDQUFnQyxLQUFLLElBQUk7QUFDdkQsU0FBTyxRQUFRLENBQUMsS0FBSztBQUN2QjtBQVFPLFNBQVMsY0FBYyxRQUF3QjtBQUNwRCxTQUFPLE9BQU8sS0FBSyxZQUFZLE9BQU8sTUFBTSxDQUFDLENBQUM7QUFDaEQ7QUFRTyxTQUFTLFlBQVksTUFBc0I7QUFDaEQsYUFBTywwQkFBVztBQUFBLElBQ2hCLFNBQVM7QUFBQSxJQUNULFVBQVU7QUFBQSxJQUNWLGFBQWE7QUFBQSxFQUNmLENBQUM7QUFDSDtBQUVBLFNBQVMsa0JBQWtCLE1BQXNCO0FBQy9DLFFBQU0sWUFBWSxZQUFZLElBQUk7QUFDbEMsU0FBTyxzQkFBc0IsS0FBSyxTQUFTLElBQUksSUFBSSxTQUFTLEtBQUs7QUFDbkU7QUFFQSxTQUFTLGVBQWUsTUFBc0I7QUFDNUMsU0FBTyxLQUFLLFFBQVEsdUJBQXVCLENBQUMsVUFBVSxNQUFNLFlBQVksQ0FBQztBQUMzRTsiLAogICJuYW1lcyI6IFsicGF0aEJyb3dzZXJpZnkiXQp9Cg==

package/dist/lib/cjs/path.d.cts

@@ -0,0 +1,154 @@
+/// <reference path="./library.d.cts" />
+/**
+ * @file
+ *
+ * Contains utility functions for handling paths.
+ */
+import pathBrowserify from 'path-browserify';
+/**
+ * Provides methods for handling POSIX paths.
+ */
+export declare const posix: pathBrowserify.Path;
+/**
+ * A POSIX path delimiter.
+ */
+export declare const delimiter: string;
+/**
+ * A POSIX segment separator.
+ */
+export declare const separator: string;
+/**
+ * Returns the base name of a file, optionally removing the file extension.
+ *
+ * @param path - The path to get the base name from.
+ * @param ext - An optional extension to remove from the base name.
+ * @returns The base name of the file.
+ */
+export declare const basename: (this: void, path: string, ext?: string) => string;
+/**
+ * Returns the directory name of a path.
+ *
+ * `directory` is used instead of `folder` to preserve compatibility with `node:path` module.
+ *
+ * @param path - The path to get the directory name from.
+ * @returns The directory name of the path.
+ */
+export declare const dirname: (this: void, path: string) => string;
+/**
+ * Returns the file extension of a path.
+ *
+ * @param path - The path to get the extension from.
+ * @returns The file extension of the path.
+ */
+export declare const extname: (this: void, path: string) => string;
+/**
+ * Formats a path object into a path string.
+ *
+ * @param pathObject - The path object to format.
+ * @returns The formatted path string.
+ */
+export declare const format: (this: void, pathObject: Partial<pathBrowserify.PathObject>) => string;
+/**
+ * Determines if a path is absolute.
+ *
+ * @param path - The path to check.
+ * @returns `true` if the path is absolute, `false` otherwise.
+ */
+export declare function isAbsolute(path: string): boolean;
+/**
+ * Joins multiple path segments into a single path.
+ *
+ * @param paths - The path segments to join.
+ * @returns The joined path.
+ */
+export declare const join: (this: void, ...paths: string[]) => string;
+/**
+ * Normalizes a path, resolving '..' and '.' segments.
+ *
+ * @param path - The path to normalize.
+ * @returns The normalized path.
+ */
+export declare const normalizePath: (this: void, path: string) => string;
+/**
+ * Parses a path string into a path object.
+ *
+ * @param path - The path string to parse.
+ * @returns The parsed path object.
+ */
+export declare const parse: (this: void, path: string) => pathBrowserify.PathObject;
+/**
+ * Parameters for {@link makeFileName}.
+ */
+export interface MakeFileNameParams {
+    /**
+     * The file name to append the extension to.
+     */
+    readonly fileBaseName: string;
+    /**
+     * The extension to append to the file name.
+     */
+    readonly fileExtension: string;
+}
+/**
+ * Gets the file name from the `import(dot)meta(dot)url`, converting it to a POSIX-style path.
+ *
+ * @param importMetaUrl - The `import(dot)meta(dot)url` from which to extract the file name.
+ * @returns The POSIX-style file name.
+ */
+export declare function getFileName(importMetaUrl: string): string;
+/**
+ * Gets the folder name from the `import(dot)meta(dot)url`, converting it to a POSIX-style path.
+ *
+ * @param importMetaUrl - The `import(dot)meta(dot)url` from which to extract the folder name.
+ * @returns The POSIX-style folder name.
+ */
+export declare function getFolderName(importMetaUrl: string): string;
+/**
+ * Makes a file name by appending an extension to a given file name.
+ * If the extension is empty, the file name is returned as is.
+ *
+ * @param params - The parameters for making the file name.
+ * @returns The file name with the extension appended.
+ */
+export declare function makeFileName(params: MakeFileNameParams): string;
+/**
+ * Normalizes a given path by ensuring it is relative, adding "./" if necessary.
+ *
+ * @param path - The path to normalize.
+ * @returns The normalized path, starting with "./" if it was relative.
+ */
+export declare function normalizeIfRelative(path: string): string;
+/**
+ * Returns the relative path from one path to another.
+ *
+ * `path-browserify`'s own `relative` cannot be used directly: it resolves a relative argument against
+ * `process.cwd()`, which on Windows is `F:\...` rather than a POSIX absolute path, and its slicing then assumes a
+ * leading `/` - so `relative('src', '../x')` came back as `'../..x'`. Both arguments are resolved through
+ * {@link resolve} here instead, and rooted at `/` before the POSIX comparison.
+ *
+ * @param from - The starting path.
+ * @param to - The destination path.
+ * @returns The relative path from `from` to `to`.
+ */
+export declare function relative(from: string, to: string): string;
+/**
+ * Resolves a sequence of paths or path segments into an absolute path.
+ *
+ * @param pathSegments - The sequence of path segments to resolve.
+ * @returns The resolved absolute path.
+ */
+export declare function resolve(...pathSegments: string[]): string;
+/**
+ * Converts a buffer containing a path to a POSIX-style buffer by replacing backslashes with forward slashes.
+ *
+ * @param buffer - The buffer to convert.
+ * @returns A new buffer containing the POSIX-style path.
+ */
+export declare function toPosixBuffer(buffer: Buffer): Buffer;
+/**
+ * Converts a given path to a POSIX-style path by replacing backslashes with forward slashes.
+ *
+ * @param path - The path to convert.
+ * @returns The POSIX-style path.
+ */
+export declare function toPosixPath(path: string): string;