@flex-development/mlly 1.0.0-beta.5 → 1.0.0-beta.7

package/dist/index.d.mts

@@ -1,5 +1,5 @@
-import * as pkgTypes from '@flex-development/pkg-types';
-import { ImportsSubpath, PackageJson, Exports, ExportsObject, Imports } from '@flex-development/pkg-types';
+import type * as pkgTypes from '@flex-development/pkg-types';
+import type { ImportsSubpath, PackageJson, Exports, ExportsObject, Imports } from '@flex-development/pkg-types';
 
 /**
  * @file Interfaces - Aliases
@@ -76,137 +76,669 @@ interface ConditionMap extends pkgTypes.ConditionMap {
 }
 
 /**
- * @file canParseUrl
- * @module mlly/lib/canParseUrl
+ * @file Interfaces - FileSystem
+ * @module mlly/interfaces/FileSystem
  */
+
 /**
- * Check if `input` can be parsed to a {@linkcode URL}.
- *
- * > 👉 **Note**: If `input` is relative, `base` is required.
- * > If `input` is absolute, `base` is ignored.
- *
- * @see {@linkcode ModuleId}
- *
- * @this {void}
- *
- * @param {unknown} input
- *  The input URL
- * @param {unknown} [base]
- *  The base URL to resolve against if `input` is not absolute
- * @return {boolean}
- *  `true` if `input` can be parsed to a `URL`, `false` otherwise
+ * The file system API.
  */
-declare function canParseUrl(this: void, input: unknown, base?: unknown): boolean;
+interface FileSystem {
+    /**
+     * Read the entire contents of a file.
+     *
+     * @see {@linkcode ReadFile}
+     */
+    readFile: ReadFile;
+    /**
+     * Compute a canonical pathname by resolving `.`, `..`, and symbolic links.
+     *
+     * @see {@linkcode Realpath}
+     */
+    realpath: Realpath;
+    /**
+     * Get information about a directory or file.
+     *
+     * @see {@linkcode Stat}
+     */
+    stat: Stat;
+}
 
 /**
- * @file cwd
- * @module mlly/lib/cwd
+ * @file Interfaces - GetSourceContext
+ * @module mlly/interfaces/GetSourceContext
  */
+
 /**
- * Get the URL of the current working directory.
+ * Source code retrieval context.
  *
- * @this {void}
+ * @see {@linkcode GetSourceOptions}
  *
- * @return {URL}
- *  The current working directory URL
+ * @extends {GetSourceOptions}
  */
-declare function cwd(this: void): URL;
+interface GetSourceContext extends GetSourceOptions {
+    /**
+     * The file system API.
+     *
+     * @see {@linkcode FileSystem}
+     *
+     * @override
+     */
+    fs: FileSystem;
+    /**
+     * Record, where each key is a URL protocol
+     * and each value is a source code handler.
+     *
+     * @see {@linkcode GetSourceHandlers}
+     *
+     * @override
+     */
+    handlers: GetSourceHandlers;
+    /**
+     * Request options for network based modules.
+     *
+     * @override
+     */
+    req: RequestInit;
+    /**
+     * The list of supported URL schemes.
+     *
+     * @override
+     */
+    schemes: Set<string>;
+}
 
 /**
- * @file defaultConditions
- * @module mlly/lib/defaultConditions
+ * @file Interfaces - GetSourceOptions
+ * @module mlly/interfaces/GetSourceOptions
  */
 
 /**
- * The default list of conditions.
- *
- * @see {@linkcode Condition}
- * @see https://nodejs.org/api/packages.html#conditional-exports
- *
- * @const {Set<Condition>} defaultConditions
+ * Options for retrieving source code.
  */
-declare const defaultConditions: Set<Condition>;
+interface GetSourceOptions {
+    /**
+     * The encoding of the result.
+     *
+     * > 👉 **Note**: Used when the `file:` handler is called.
+     *
+     * @see {@linkcode BufferEncoding}
+     */
+    encoding?: BufferEncoding | null | undefined;
+    /**
+     * The module format hint.
+     *
+     * @see {@linkcode ModuleFormat}
+     */
+    format?: ModuleFormat | null | undefined;
+    /**
+     * The file system API.
+     *
+     * @see {@linkcode FileSystem}
+     */
+    fs?: FileSystem | null | undefined;
+    /**
+     * Record, where each key is a URL protocol
+     * and each value is a source code handler.
+     *
+     * @see {@linkcode GetSourceHandlers}
+     */
+    handlers?: GetSourceHandlers | null | undefined;
+    /**
+     * Whether to ignore [`ERR_UNSUPPORTED_ESM_URL_SCHEME`][err] if thrown.
+     *
+     * [err]: https://nodejs.org/api/errors.html#err_unsupported_esm_url_scheme
+     */
+    ignoreErrors?: boolean | null | undefined;
+    /**
+     * Request options for network based modules.
+     */
+    req?: RequestInit | null | undefined;
+    /**
+     * The list of supported URL schemes.
+     *
+     * @see {@linkcode List}
+     *
+     * @default ['data','file','http','https','node']
+     */
+    schemes?: List<string> | null | undefined;
+}
 
 /**
- * @file defaultExtensions
- * @module mlly/lib/defaultExtensions
+ * @file Interfaces - IsDirectory
+ * @module mlly/interfaces/IsDirectory
  */
-
 /**
- * The default list of resolvable file extensions.
- *
- * @see {@linkcode Ext}
- *
- * @const {Set<Ext>} defaultExtensions
+ * Check if a stats object describes a directory.
  */
-declare const defaultExtensions: Set<Ext>;
+interface IsDirectory {
+    /**
+     * @this {unknown}
+     *
+     * @return {boolean}
+     *  `true` if stats describes directory, `false` otherwise
+     */
+    (): boolean;
+}
 
 /**
- * @file defaultMainFields
- * @module mlly/lib/defaultMainFields
+ * @file Interfaces - IsFile
+ * @module mlly/interfaces/IsFile
  */
-
 /**
- * The default list of main fields.
- *
- * @see {@linkcode MainField}
- *
- * @const {Set<MainField>} defaultMainFields
+ * Check if a stats object describes a file.
  */
-declare const defaultMainFields: Set<MainField>;
+interface IsFile {
+    /**
+     * @this {void}
+     *
+     * @return {boolean}
+     *  `true` if stats object describes regular file, `false` otherwise
+     */
+    (): boolean;
+}
 
 /**
- * @file extensionFormatMap
- * @module mlly/lib/extensionFormatMap
+ * @file Interfaces - MainFieldMap
+ * @module mlly/interfaces/MainFieldMap
  */
-
 /**
- * Map, where each key is a file extension
- * and each value is a default module format.
+ * Registry of main fields.
  *
- * @see {@linkcode Ext}
- * @see {@linkcode ModuleFormat}
+ * This interface can be augmented to register custom main fields.
  *
- * @const {Map<Ext, ModuleFormat>} extensionFormatMap
+ * @example
+ *  declare module '@flex-development/mlly' {
+ *    interface MainFieldMap {
+ *      unpkg: 'unpkg'
+ *    }
+ *  }
  */
-declare const extensionFormatMap: Map<Ext, ModuleFormat>;
+interface MainFieldMap {
+    main: 'main';
+    module: 'module';
+    types: 'types';
+}
 
 /**
- * @file formats
- * @module mlly/lib/formats
+ * @file Interfaces - ModuleFormatMap
+ * @module mlly/interfaces/ModuleFormatMap
  */
 /**
- * Default module formats.
+ * Registry of module formats.
  *
- * @see {@linkcode ModuleFormat}
+ * This interface can be augmented to register custom module formats.
  *
- * @enum {ModuleFormat}
+ * @example
+ *  declare module '@flex-development/mlly' {
+ *    interface ModuleFormatMap {
+ *      custom: 'custom'
+ *    }
+ *  }
  */
-declare const enum formats {
-    builtin = "builtin",
-    commonjs = "commonjs",
-    cts = "commonjs-typescript",
-    json = "json",
-    module = "module",
-    mts = "module-typescript",
-    wasm = "wasm"
+interface ModuleFormatMap {
+    builtin: 'builtin';
+    commonjs: 'commonjs';
+    cts: 'commonjs-typescript';
+    json: 'json';
+    module: 'module';
+    mts: 'module-typescript';
+    wasm: 'wasm';
 }
 
 /**
- * @file getSource
- * @module mlly/lib/getSource
+ * @file Interfaces - PatternKeyComparisonMap
+ * @module mlly/interfaces/PatternKeyComparisonMap
  */
-
 /**
- * Get the source code for a module.
- *
- * @see {@linkcode EmptyString}
- * @see {@linkcode GetSourceOptions}
+ * Registry of `PATTERN_KEY_COMPARE` algorithm results.
  *
- * @this {void}
+ * This interface can be augmented to register custom results.
  *
- * @param {EmptyString | null | undefined} id
- *  The module id
+ * @example
+ *  declare module '@flex-development/mlly' {
+ *    interface PatternKeyComparisonMap {
+ *      afterThree: 3
+ *    }
+ *  }
+ */
+interface PatternKeyComparisonMap {
+    /**
+     * `a` should come after `b`.
+     */
+    after: 1;
+    /**
+     * `a` should come before `b`.
+     */
+    before: -1;
+    /**
+     * `a` and `b` are equal.
+     */
+    equal: 0;
+}
+
+/**
+ * @file Interfaces - ProtocolMap
+ * @module mlly/interfaces/ProtocolMap
+ */
+/**
+ * Registry of URL protocols.
+ *
+ * This interface can be augmented to register custom protocols.
+ *
+ * @see https://nodejs.org/api/url.html#urlprotocol
+ * @see https://iana.org/assignments/uri-schemes/uri-schemes.xhtml
+ * @see https://url.spec.whatwg.org/#special-scheme
+ *
+ * @example
+ *  declare module '@flex-development/mlly' {
+ *    interface ProtocolMap {
+ *      custom: 'custom:'
+ *    }
+ *  }
+ */
+interface ProtocolMap {
+    blob: 'blob:';
+    content: 'content:';
+    cvs: 'cvs:';
+    data: 'data:';
+    dns: 'dns:';
+    file: 'file:';
+    fish: 'fish:';
+    ftp: 'ftp:';
+    git: 'git:';
+    http: 'http:';
+    https: 'https:';
+    mvn: 'mvn:';
+    node: 'node:';
+    redis: 'redis:';
+    sftp: 'sftp:';
+    ssh: 'ssh:';
+    svn: 'svn:';
+    urn: 'urn:';
+    viewSource: 'view-source:';
+    ws: 'ws:';
+    wss: 'wss:';
+}
+
+/**
+ * @file Interfaces - ReadFile
+ * @module mlly/interfaces/ReadFile
+ */
+
+/**
+ * Read the entire contents of a file.
+ */
+interface ReadFile {
+    /**
+     * @see {@linkcode ModuleId}
+     *
+     * @this {unknown}
+     *
+     * @param {ModuleId} id
+     *  The module id
+     * @param {BufferEncoding} encoding
+     *  The encoding of the file contents
+     * @return {Awaitable<string>}
+     *  The file contents
+     */
+    (id: ModuleId, encoding: BufferEncoding): Awaitable<string>;
+    /**
+     * @see {@linkcode Awaitable}
+     * @see {@linkcode FileContent}
+     * @see {@linkcode ModuleId}
+     *
+     * @template {Awaitable<FileContent | null | undefined>} T
+     *  The file contents
+     *
+     * @this {unknown}
+     *
+     * @param {ModuleId} id
+     *  The module id
+     * @param {BufferEncoding | null | undefined} [encoding]
+     *  The encoding of the file contents
+     * @return {T}
+     *  The file contents
+     */
+    <T extends Awaitable<FileContent | null | undefined>>(id: ModuleId, encoding?: BufferEncoding | null | undefined): T;
+}
+
+/**
+ * @file Interfaces - Realpath
+ * @module mlly/interfaces/Realpath
+ */
+
+/**
+ * Compute a canonical pathname by resolving `.`, `..`, and symbolic links.
+ *
+ * > 👉 **Note**: A canonical pathname is not necessarily unique.
+ * > Hard links and bind mounts can expose an entity through many pathnames.
+ */
+interface Realpath {
+    /**
+     * @see {@linkcode Awaitable}
+     * @see {@linkcode ModuleId}
+     *
+     * @template {Awaitable<string>} T
+     *  The canonical pathname
+     *
+     * @this {unknown}
+     *
+     * @param {ModuleId} id
+     *  The module id
+     * @return {T}
+     *  The canonical pathname
+     */
+    <T extends Awaitable<string>>(id: ModuleId): T;
+}
+
+/**
+ * @file Interfaces - ResolveAliasOptions
+ * @module mlly/interfaces/ResolveAliasOptions
+ */
+
+/**
+ * Options for path alias resolution.
+ */
+interface ResolveAliasOptions {
+    /**
+     * Whether the resolved specifier should be absolute.
+     *
+     * If `true`, the resolved specifier will be a [`file:` URL][file-url].
+     *
+     * [file-url]: https://nodejs.org/api/esm.html#file-urls
+     *
+     * @see https://nodejs.org/api/esm.html#terminology
+     */
+    absolute?: boolean | null | undefined;
+    /**
+     * The path mappings dictionary.
+     *
+     * > 👉 **Note**: Paths should be relative to {@linkcode cwd}.
+     *
+     * @see {@linkcode Aliases}
+     */
+    aliases?: Aliases | null | undefined;
+    /**
+     * The URL of the directory to resolve non-absolute modules from.
+     *
+     * @see {@linkcode ModuleId}
+     *
+     * @default cwd()
+     */
+    cwd?: ModuleId | null | undefined;
+    /**
+     * The URL of the parent module.
+     *
+     * @see {@linkcode ModuleId}
+     */
+    parent?: ModuleId | null | undefined;
+}
+
+/**
+ * @file Interfaces - ResolveModuleOptions
+ * @module mlly/interfaces/ResolveModuleOptions
+ */
+
+/**
+ * Options for module resolution.
+ */
+interface ResolveModuleOptions {
+    /**
+     * The path mappings dictionary.
+     *
+     * > 👉 **Note**: Paths should be relative to {@linkcode cwd}.
+     *
+     * @see {@linkcode Aliases}
+     */
+    aliases?: Aliases | null | undefined;
+    /**
+     * The list of export/import conditions.
+     *
+     * > 👉 **Note**: Should be sorted by priority.
+     *
+     * @see {@linkcode Condition}
+     * @see {@linkcode List}
+     * @see https://nodejs.org/api/packages.html#conditional-exports
+     *
+     * @default defaultConditions
+     */
+    conditions?: List<Condition> | null | undefined;
+    /**
+     * The URL of the directory to resolve path {@linkcode aliases} from.
+     *
+     * @see {@linkcode ModuleId}
+     *
+     * @default cwd()
+     */
+    cwd?: ModuleId | null | undefined;
+    /**
+     * A replacement file extension, a record of replacement file extensions,
+     * or a function that returns a replacement file extension.
+     *
+     * > 👉 **Note**: Replacement file extensions are normalized and do not
+     * > need to begin with a dot character (`'.'`); an empty string (`''`),
+     * > `false`, or `null` will remove an extension.
+     *
+     * @see {@linkcode ExtensionRewrites}
+     * @see {@linkcode GetNewExtension}
+     */
+    ext?: ExtensionRewrites | GetNewExtension | string | false | null | undefined;
+    /**
+     * The module extensions to probe for.
+     *
+     * > 👉 **Note**: Should be sorted by priority.
+     *
+     * @see {@linkcode List}
+     *
+     * @default defaultExtensions
+     */
+    extensions?: List<string> | null | undefined;
+    /**
+     * The file system API.
+     *
+     * @see {@linkcode FileSystem}
+     */
+    fs?: FileSystem | null | undefined;
+    /**
+     * The list of legacy `main` fields.
+     *
+     * > 👉 **Note**: Should be sorted by priority.
+     *
+     * @see {@linkcode List}
+     * @see {@linkcode MainField}
+     *
+     * @default defaultMainFields
+     */
+    mainFields?: List<MainField> | null | undefined;
+    /**
+     * Whether to keep symlinks instead of resolving them.
+     */
+    preserveSymlinks?: boolean | null | undefined;
+}
+
+/**
+ * @file Interfaces - Stat
+ * @module mlly/interfaces/Stat
+ */
+
+/**
+ * Get information about a directory or file.
+ */
+interface Stat {
+    /**
+     * @see {@linkcode Awaitable}
+     * @see {@linkcode ModuleId}
+     * @see {@linkcode Stats}
+     *
+     * @template {Awaitable<Stats>} T
+     *  The info
+     *
+     * @this {unknown}
+     *
+     * @param {ModuleId} id
+     *  The module id
+     * @return {T}
+     *  The info
+     */
+    <T extends Awaitable<Stats>>(id: ModuleId): T;
+}
+
+/**
+ * @file Interfaces - Stats
+ * @module mlly/interfaces/Stats
+ */
+
+/**
+ * An object describing a directory or file.
+ */
+interface Stats {
+    /**
+     * Check if the stats object describes a directory.
+     *
+     * @see {@linkcode IsDirectory}
+     */
+    isDirectory: IsDirectory;
+    /**
+     * Check if the stats object describes a file.
+     *
+     * @see {@linkcode IsFile}
+     */
+    isFile: IsFile;
+}
+
+/**
+ * @file canParseUrl
+ * @module mlly/lib/canParseUrl
+ */
+/**
+ * Check if `input` can be parsed to a {@linkcode URL}.
+ *
+ * > 👉 **Note**: If `input` is relative, `base` is required.
+ * > If `input` is absolute, `base` is ignored.
+ *
+ * @see {@linkcode ModuleId}
+ *
+ * @this {void}
+ *
+ * @param {unknown} input
+ *  The input URL
+ * @param {unknown} [base]
+ *  The base URL to resolve against if `input` is not absolute
+ * @return {boolean}
+ *  `true` if `input` can be parsed to a `URL`, `false` otherwise
+ */
+declare function canParseUrl(this: void, input: unknown, base?: unknown): boolean;
+
+/**
+ * @file cwd
+ * @module mlly/lib/cwd
+ */
+/**
+ * Get the URL of the current working directory.
+ *
+ * @this {void}
+ *
+ * @return {URL}
+ *  The current working directory URL
+ */
+declare function cwd(this: void): URL;
+
+/**
+ * @file defaultConditions
+ * @module mlly/lib/defaultConditions
+ */
+
+/**
+ * The default list of conditions.
+ *
+ * @see {@linkcode Condition}
+ * @see https://nodejs.org/api/packages.html#conditional-exports
+ *
+ * @const {Set<Condition>} defaultConditions
+ */
+declare const defaultConditions: Set<Condition>;
+
+/**
+ * @file defaultExtensions
+ * @module mlly/lib/defaultExtensions
+ */
+
+/**
+ * The default list of resolvable file extensions.
+ *
+ * @see {@linkcode Ext}
+ *
+ * @const {Set<Ext>} defaultExtensions
+ */
+declare const defaultExtensions: Set<Ext>;
+
+/**
+ * @file defaultMainFields
+ * @module mlly/lib/defaultMainFields
+ */
+
+/**
+ * The default list of main fields.
+ *
+ * @see {@linkcode MainField}
+ *
+ * @const {Set<MainField>} defaultMainFields
+ */
+declare const defaultMainFields: Set<MainField>;
+
+/**
+ * @file extensionFormatMap
+ * @module mlly/lib/extensionFormatMap
+ */
+
+/**
+ * Map, where each key is a file extension
+ * and each value is a default module format.
+ *
+ * @see {@linkcode Ext}
+ * @see {@linkcode ModuleFormat}
+ *
+ * @const {Map<Ext, ModuleFormat>} extensionFormatMap
+ */
+declare const extensionFormatMap: Map<Ext, ModuleFormat>;
+
+/**
+ * @file formats
+ * @module mlly/lib/formats
+ */
+/**
+ * Default module formats.
+ *
+ * @see {@linkcode ModuleFormat}
+ *
+ * @enum {ModuleFormat}
+ */
+declare const enum formats {
+    builtin = "builtin",
+    commonjs = "commonjs",
+    cts = "commonjs-typescript",
+    json = "json",
+    module = "module",
+    mts = "module-typescript",
+    wasm = "wasm"
+}
+
+/**
+ * @file getSource
+ * @module mlly/lib/getSource
+ */
+
+/**
+ * Get the source code for a module.
+ *
+ * @see {@linkcode EmptyString}
+ * @see {@linkcode GetSourceOptions}
+ *
+ * @this {void}
+ *
+ * @param {EmptyString | null | undefined} id
+ *  The module id
  * @param {GetSourceOptions | null | undefined} [options]
  *  Source code retrieval options
  * @return {null}
@@ -605,7 +1137,7 @@ declare function readPackageJson<T extends Awaitable<PackageJson | null>>(this:
  * @param {string} specifier
  *  The specifier using an alias
  * @param {ResolveAliasOptions | null | undefined} [options]
- *  Alias resolution options
+ *  Options for alias resolution
  * @return {string | null}
  *  The specifier of the aliased module
  */
@@ -641,17 +1173,17 @@ declare function resolveAlias(this: void, specifier: string, options?: ResolveAl
  *
  * @this {void}
  *
- * @param {string} specifier
+ * @param {ModuleId} specifier
  *  The module specifier to resolve
  * @param {ModuleId} parent
  *  The URL of the parent module
  * @param {ResolveModuleOptions | null | undefined} [options]
- *  Module resolution options
+ *  Options for module resolution
  * @return {T}
  *  The resolved URL
  * @throws {NodeError}
  */
-declare function resolveModule<T extends Awaitable<URL>>(this: void, specifier: string, parent: ModuleId, options?: ResolveModuleOptions | null | undefined): T;
+declare function resolveModule<T extends Awaitable<URL>>(this: void, specifier: ModuleId, parent: ModuleId, options?: ResolveModuleOptions | null | undefined): T;
 
 /**
  * @file resolver
@@ -992,896 +1524,387 @@ declare function packageSelfResolve<T extends Awaitable<URL | undefined>>(this:
  *  The URL of the parent module
  * @param {FileSystem | null | undefined} [fs]
  *  The file system API
- * @return {T}
- *  The resolved package target URL
- * @throws {ErrInvalidPackageConfig}
- * @throws {ErrInvalidPackageTarget}
- */
-declare function packageTargetResolve<T extends Awaitable<URL | null | undefined>>(this: void, packageUrl: ModuleId, target: unknown, subpath: string, patternMatch?: string | null | undefined, isImports?: boolean | null | undefined, conditions?: List<Condition> | null | undefined, mainFields?: List<MainField> | null | undefined, parent?: ModuleId | null | undefined, fs?: FileSystem | null | undefined): T;
-
-declare const resolver_d_legacyMainResolve: typeof legacyMainResolve;
-declare const resolver_d_moduleResolve: typeof moduleResolve;
-declare const resolver_d_packageExportsResolve: typeof packageExportsResolve;
-declare const resolver_d_packageImportsExportsResolve: typeof packageImportsExportsResolve;
-declare const resolver_d_packageImportsResolve: typeof packageImportsResolve;
-declare const resolver_d_packageResolve: typeof packageResolve;
-declare const resolver_d_packageSelfResolve: typeof packageSelfResolve;
-declare const resolver_d_packageTargetResolve: typeof packageTargetResolve;
-declare namespace resolver_d {
-  export {
-    resolver_d_legacyMainResolve as legacyMainResolve,
-    resolver_d_moduleResolve as moduleResolve,
-    resolver_d_packageExportsResolve as packageExportsResolve,
-    resolver_d_packageImportsExportsResolve as packageImportsExportsResolve,
-    resolver_d_packageImportsResolve as packageImportsResolve,
-    resolver_d_packageResolve as packageResolve,
-    resolver_d_packageSelfResolve as packageSelfResolve,
-    resolver_d_packageTargetResolve as packageTargetResolve,
-  };
-}
-
-/**
- * @file root
- * @module mlly/lib/root
- */
-/**
- * The URL of the file system root.
- *
- * @const {URL} root
- */
-declare const root: URL;
-
-/**
- * @file toRelativeSpecifier
- * @module mlly/lib/toRelativeSpecifier
- */
-
-/**
- * Turn `url` into a *relative specifier*.
- *
- * ::: info
- * The relative specifier will only have a file extension
- * if `specifier` also has an extension.
- * :::
- *
- * @see {@linkcode ModuleId}
- * @see https://nodejs.org/api/esm.html#terminology
- *
- * @this {void}
- *
- * @param {ModuleId} url
- *  The `file:` URL to convert
- * @param {ModuleId} parent
- *  The parent module id
- * @return {string}
- *  The relative specifier
- */
-declare function toRelativeSpecifier(this: void, url: ModuleId, parent: ModuleId): string;
-
-/**
- * @file toUrl
- * @module mlly/lib/toUrl
- */
-
-/**
- * Convert `id` to a {@linkcode URL}.
- *
- * > 👉 **Note**: If `id` cannot be parsed as a `URL`, and is also not a
- * > [builtin module][builtin-module], it will be assumed to be a path and
- * > converted to a [`file:` URL][file-url].
- *
- * [builtin-module]: https://nodejs.org/api/esm.html#builtin-modules
- * [file-url]: https://nodejs.org/api/esm.html#file-urls
- *
- * @this {void}
- *
- * @param {ModuleId} id
- *  The module id to convert
- * @param {ModuleId | null | undefined} [parent]
- *  The base URL to resolve against if `id` is not absolute
- * @return {URL}
- *  The new URL
- */
-declare function toUrl(this: void, id: ModuleId, parent?: ModuleId | null | undefined): URL;
-
-/**
- * @file Type Aliases - Awaitable
- * @module mlly/types/Awaitable
- */
-/**
- * Create a union of `T` and `T` as a promise-like object.
- *
- * @template {any} T
- *  The value
- */
-type Awaitable<T> = PromiseLike<T> | T;
-
-/**
- * @file Type Aliases - BufferEncoding
- * @module mlly/types/BufferEncoding
- */
-
-/**
- * Union of values that can occur where a buffer encoding is expected.
- *
- * To register new encodings, augment {@linkcode BufferEncodingMap}.
- * They will be added to this union automatically.
- */
-type BufferEncoding = BufferEncodingMap[keyof BufferEncodingMap];
-
-/**
- * @file Type Aliases - ChangeExtFn
- * @module mlly/types/ChangeExtFn
- */
-/**
- * Get a new file extension for `url`.
- *
- * Returning an empty string (`''`), `null`, or `undefined` will remove the
- * current file extension.
- *
- * ::: info
- * The new file extension need not begin with a dot character (`'.'`).
- * :::
- *
- * @see {@linkcode URL}
- * @see https://github.com/flex-development/pathe/tree/1.0.3#changeextpath-string-ext-nullablestring-string
- *
- * @template {string | null | undefined} Ext
- *  The new file extension
- *
- * @param {URL} url
- *  The resolved module URL
- * @param {string} specifier
- *  The module specifier being resolved
- * @return {Ext}
- *  The new file extension
- */
-type ChangeExtFn<Ext extends string | null | undefined = string | null | undefined> = (this: void, url: URL, specifier: string) => Ext;
-
-/**
- * @file Type Aliases - Condition
- * @module mlly/types/Condition
- */
-
-/**
- * Union of values that can occur where a export/import condition is expected.
- *
- * To register new conditions, augment {@linkcode ConditionMap}.
- * They will be added to this union automatically.
- */
-type Condition = ConditionMap[keyof ConditionMap];
-
-/**
- * @file Type Aliases - Dot
- * @module mlly/types/Dot
- */
-/**
- * A dot character (`'.'`).
- */
-type Dot = '.';
-
-/**
- * @file Type Aliases - EmptyArray
- * @module mlly/types/EmptyArray
- */
-/**
- * An empty array.
- */
-type EmptyArray = [];
-
-/**
- * @file Type Aliases - EmptyObject
- * @module mlly/types/EmptyObject
- */
-/**
- * The empty object symbol.
- *
- * @internal
- *
- * @const {symbol} tag
- */
-declare const tag: unique symbol;
-/**
- * An empty object.
- */
-type EmptyObject = {
-    [tag]?: never;
-};
-
-/**
- * @file Type Aliases - EmptyString
- * @module mlly/types/EmptyString
- */
-/**
- * An empty string.
- */
-type EmptyString = '';
-
-/**
- * @file Type Aliases - Ext
- * @module mlly/types/Ext
+ * @return {T}
+ *  The resolved package target URL
+ * @throws {ErrInvalidPackageConfig}
+ * @throws {ErrInvalidPackageTarget}
  */
+declare function packageTargetResolve<T extends Awaitable<URL | null | undefined>>(this: void, packageUrl: ModuleId, target: unknown, subpath: string, patternMatch?: string | null | undefined, isImports?: boolean | null | undefined, conditions?: List<Condition> | null | undefined, mainFields?: List<MainField> | null | undefined, parent?: ModuleId | null | undefined, fs?: FileSystem | null | undefined): T;
 
-/**
- * A file extension.
- *
- * @see {@linkcode Dot}
- */
-type Ext = `${Dot}${string}`;
+declare const resolver_d_legacyMainResolve: typeof legacyMainResolve;
+declare const resolver_d_moduleResolve: typeof moduleResolve;
+declare const resolver_d_packageExportsResolve: typeof packageExportsResolve;
+declare const resolver_d_packageImportsExportsResolve: typeof packageImportsExportsResolve;
+declare const resolver_d_packageImportsResolve: typeof packageImportsResolve;
+declare const resolver_d_packageResolve: typeof packageResolve;
+declare const resolver_d_packageSelfResolve: typeof packageSelfResolve;
+declare const resolver_d_packageTargetResolve: typeof packageTargetResolve;
+declare namespace resolver_d {
+  export {
+    resolver_d_legacyMainResolve as legacyMainResolve,
+    resolver_d_moduleResolve as moduleResolve,
+    resolver_d_packageExportsResolve as packageExportsResolve,
+    resolver_d_packageImportsExportsResolve as packageImportsExportsResolve,
+    resolver_d_packageImportsResolve as packageImportsResolve,
+    resolver_d_packageResolve as packageResolve,
+    resolver_d_packageSelfResolve as packageSelfResolve,
+    resolver_d_packageTargetResolve as packageTargetResolve,
+  };
+}
 
 /**
- * @file Type Aliases - FileContent
- * @module mlly/types/FileContent
+ * @file root
+ * @module mlly/lib/root
  */
 /**
- * Union of values that can occur where file content is expected.
+ * The URL of the file system root.
  *
- * @see {@linkcode Uint8Array}
+ * @const {URL} root
  */
-type FileContent = Uint8Array | string;
+declare const root: URL;
 
 /**
- * @file Type Aliases - GetSourceHandler
- * @module mlly/types/GetSourceHandler
+ * @file toRelativeSpecifier
+ * @module mlly/lib/toRelativeSpecifier
  */
 
 /**
- * Get the source code for a module.
+ * Turn `url` into a *relative specifier*.
  *
- * @see {@linkcode Awaitable}
- * @see {@linkcode FileContent}
- * @see {@linkcode GetSourceContext}
- * @see {@linkcode URL}
+ * ::: info
+ * The relative specifier will only have a file extension
+ * if `specifier` also has an extension.
+ * :::
  *
- * @this {GetSourceContext}
- *  The retrieval context
+ * @see {@linkcode ModuleId}
+ * @see https://nodejs.org/api/esm.html#terminology
  *
- * @param {URL} url
- *  The module URL
- * @return {Awaitable<FileContent | null | undefined>}
- *  The source code
+ * @this {void}
+ *
+ * @param {ModuleId} url
+ *  The `file:` URL to convert
+ * @param {ModuleId} parent
+ *  The parent module id
+ * @return {string}
+ *  The relative specifier
  */
-type GetSourceHandler = (this: GetSourceContext, url: URL) => Awaitable<FileContent | null | undefined>;
+declare function toRelativeSpecifier(this: void, url: ModuleId, parent: ModuleId): string;
 
 /**
- * @file Type Aliases - GetSourceHandlers
- * @module mlly/types/GetSourceHandlers
+ * @file toUrl
+ * @module mlly/lib/toUrl
  */
 
 /**
- * Record, where key is a URL protocol and each value is a source code handler.
+ * Convert `id` to a {@linkcode URL}.
  *
- * @see {@linkcode GetSourceHandler}
- * @see {@linkcode Protocol}
- */
-type GetSourceHandlers = {
-    [H in Protocol]?: GetSourceHandler | null | undefined;
-};
-
-/**
- * @file Type Aliases - List
- * @module mlly/types/List
- */
-/**
- * A list.
+ * > 👉 **Note**: If `id` cannot be parsed as a `URL`, and is also not a
+ * > [builtin module][builtin-module], it will be assumed to be a path and
+ * > converted to a [`file:` URL][file-url].
  *
- * @template {any} [T=unknown]
- *  The list item type
- */
-type List<T = unknown> = ReadonlySet<T> | readonly T[];
-
-/**
- * @file Type Aliases - MainField
- * @module mlly/types/MainField
- */
-
-/**
- * Union of values that can occur where a main field is expected.
+ * [builtin-module]: https://nodejs.org/api/esm.html#builtin-modules
+ * [file-url]: https://nodejs.org/api/esm.html#file-urls
  *
- * To register new fields, augment {@linkcode MainFieldMap}.
- * They will be added to this union automatically.
- */
-type MainField = MainFieldMap[keyof MainFieldMap];
-
-/**
- * @file Type Aliases - ModuleFormat
- * @module mlly/types/ModuleFormat
- */
-
-/**
- * Union of values that can occur where a module format is expected.
+ * @this {void}
  *
- * To register new formats, augment {@linkcode ModuleFormatMap}.
- * They will be added to this union automatically.
+ * @param {ModuleId} id
+ *  The module id to convert
+ * @param {ModuleId | null | undefined} [parent]
+ *  The base URL to resolve against if `id` is not absolute
+ * @return {URL}
+ *  The new URL
  */
-type ModuleFormat = ModuleFormatMap[keyof ModuleFormatMap];
+declare function toUrl(this: void, id: ModuleId, parent?: ModuleId | null | undefined): URL;
 
 /**
- * @file Type Aliases - ModuleId
- * @module mlly/types/ModuleId
+ * @file Type Aliases - Awaitable
+ * @module mlly/types/Awaitable
  */
 /**
- * Union of values that can occur where a
- * ECMAScript (ES) module identifier is expected.
+ * Create a union of `T` and `T` as a promise-like object.
  *
- * @see {@linkcode URL}
- */
-type ModuleId = URL | string;
-
-/**
- * @file Type Aliases - Numeric
- * @module mlly/types/Numeric
- */
-/**
- * String containing only numbers (not including the leading `-` if negative).
+ * @template {any} T
+ *  The value
  */
-type Numeric = `${number}`;
+type Awaitable<T> = PromiseLike<T> | T;
 
 /**
- * @file Type Aliases - PatternKeyComparison
- * @module mlly/types/PatternKeyComparison
+ * @file Type Aliases - BufferEncoding
+ * @module mlly/types/BufferEncoding
  */
 
 /**
- * Union of values that can occur
- * where a `PATTERN_KEY_COMPARE` algorithm result is expected.
+ * Union of values that can occur where a buffer encoding is expected.
  *
- * To register new results, augment {@linkcode PatternKeyComparisonMap}.
+ * To register new encodings, augment {@linkcode BufferEncodingMap}.
  * They will be added to this union automatically.
  */
-type PatternKeyComparison = PatternKeyComparisonMap[keyof PatternKeyComparisonMap];
-
-/**
- * @file Type Aliases - PatternMatch
- * @module mlly/types/PatternMatch
- */
-/**
- * List, where the first item is the key of a package `exports` or `imports`
- * target object, and the last is a subpath pattern match.
- */
-type PatternMatch = [expansionKey: string, patternMatch: string | null];
+type BufferEncoding = BufferEncodingMap[keyof BufferEncodingMap];
 
 /**
- * @file Type Aliases - Protocol
- * @module mlly/types/Protocol
+ * @file Type Aliases - Condition
+ * @module mlly/types/Condition
  */
 
 /**
- * Union of values that can occur where a URL protocol is expected.
+ * Union of values that can occur where a export/import condition is expected.
  *
- * To register new protocols, augment {@linkcode ProtocolMap}.
+ * To register new conditions, augment {@linkcode ConditionMap}.
  * They will be added to this union automatically.
  */
-type Protocol = ProtocolMap[keyof ProtocolMap];
-
-/**
- * @file Interfaces - FileSystem
- * @module mlly/interfaces/FileSystem
- */
+type Condition = ConditionMap[keyof ConditionMap];
 
 /**
- * The file system API.
+ * @file Type Aliases - Dot
+ * @module mlly/types/Dot
  */
-interface FileSystem {
-    /**
-     * Read the entire contents of a file.
-     *
-     * @see {@linkcode ReadFile}
-     */
-    readFile: ReadFile;
-    /**
-     * Compute a canonical pathname by resolving `.`, `..`, and symbolic links.
-     *
-     * @see {@linkcode Realpath}
-     */
-    realpath: Realpath;
-    /**
-     * Get information about a directory or file.
-     *
-     * @see {@linkcode Stat}
-     */
-    stat: Stat;
-}
-
 /**
- * @file Interfaces - GetSourceContext
- * @module mlly/interfaces/GetSourceContext
+ * A dot character (`'.'`).
  */
+type Dot = '.';
 
 /**
- * Source code retrieval context.
- *
- * @see {@linkcode GetSourceOptions}
- *
- * @extends {GetSourceOptions}
+ * @file Type Aliases - EmptyArray
+ * @module mlly/types/EmptyArray
  */
-interface GetSourceContext extends GetSourceOptions {
-    /**
-     * The file system API.
-     *
-     * @see {@linkcode FileSystem}
-     *
-     * @override
-     */
-    fs: FileSystem;
-    /**
-     * Record, where each key is a URL protocol
-     * and each value is a source code handler.
-     *
-     * @see {@linkcode GetSourceHandlers}
-     *
-     * @override
-     */
-    handlers: GetSourceHandlers;
-    /**
-     * Request options for network based modules.
-     *
-     * @override
-     */
-    req: RequestInit;
-    /**
-     * The list of supported URL schemes.
-     *
-     * @override
-     */
-    schemes: Set<string>;
-}
-
 /**
- * @file Interfaces - GetSourceOptions
- * @module mlly/interfaces/GetSourceOptions
+ * An empty array.
  */
+type EmptyArray = [];
 
 /**
- * Options for retrieving source code.
+ * @file Type Aliases - EmptyObject
+ * @module mlly/types/EmptyObject
  */
-interface GetSourceOptions {
-    /**
-     * The encoding of the result.
-     *
-     * > 👉 **Note**: Used when the `file:` handler is called.
-     *
-     * @see {@linkcode BufferEncoding}
-     */
-    encoding?: BufferEncoding | null | undefined;
-    /**
-     * The module format hint.
-     *
-     * @see {@linkcode ModuleFormat}
-     */
-    format?: ModuleFormat | null | undefined;
-    /**
-     * The file system API.
-     *
-     * @see {@linkcode FileSystem}
-     */
-    fs?: FileSystem | null | undefined;
-    /**
-     * Record, where each key is a URL protocol
-     * and each value is a source code handler.
-     *
-     * @see {@linkcode GetSourceHandlers}
-     */
-    handlers?: GetSourceHandlers | null | undefined;
-    /**
-     * Whether to ignore [`ERR_UNSUPPORTED_ESM_URL_SCHEME`][err] if thrown.
-     *
-     * [err]: https://nodejs.org/api/errors.html#err_unsupported_esm_url_scheme
-     */
-    ignoreErrors?: boolean | null | undefined;
-    /**
-     * Request options for network based modules.
-     */
-    req?: RequestInit | null | undefined;
-    /**
-     * The list of supported URL schemes.
-     *
-     * @see {@linkcode List}
-     *
-     * @default ['data','file','http','https','node']
-     */
-    schemes?: List<string> | null | undefined;
-}
+/**
+ * The empty object symbol.
+ *
+ * @internal
+ *
+ * @const {symbol} tag
+ */
+declare const tag: unique symbol;
+/**
+ * An empty object.
+ */
+type EmptyObject = {
+    [tag]?: never;
+};
 
 /**
- * @file Interfaces - IsDirectory
- * @module mlly/interfaces/IsDirectory
+ * @file Type Aliases - EmptyString
+ * @module mlly/types/EmptyString
  */
 /**
- * Check if a stats object describes a directory.
+ * An empty string.
  */
-interface IsDirectory {
-    /**
-     * @this {unknown}
-     *
-     * @return {boolean}
-     *  `true` if stats describes directory, `false` otherwise
-     */
-    (): boolean;
-}
+type EmptyString = '';
 
 /**
- * @file Interfaces - IsFile
- * @module mlly/interfaces/IsFile
+ * @file Type Aliases - Ext
+ * @module mlly/types/Ext
  */
+
 /**
- * Check if a stats object describes a file.
+ * A file extension.
+ *
+ * @see {@linkcode Dot}
  */
-interface IsFile {
-    /**
-     * @this {void}
-     *
-     * @return {boolean}
-     *  `true` if stats object describes regular file, `false` otherwise
-     */
-    (): boolean;
-}
+type Ext = `${Dot}${string}`;
 
 /**
- * @file Interfaces - MainFieldMap
- * @module mlly/interfaces/MainFieldMap
+ * @file Type Aliases - ExtensionRewrites
+ * @module mlly/types/ExtensionRewrites
  */
+
 /**
- * Registry of main fields.
+ * Record, where each key is the file extension of a module specifier and
+ * each value is a replacement file extension.
  *
- * This interface can be augmented to register custom main fields.
+ * > 👉 **Note**: Replacement file extensions are normalized and do not need to
+ * > begin with a dot character (`'.'`); falsy values will remove an extension.
  *
- * @example
- *  declare module '@flex-development/mlly' {
- *    interface MainFieldMap {
- *      unpkg: 'unpkg'
- *    }
- *  }
+ * @see {@linkcode EmptyString}
+ * @see {@linkcode Ext}
  */
-interface MainFieldMap {
-    main: 'main';
-    module: 'module';
-    types: 'types';
-}
+type ExtensionRewrites = {
+    [K in EmptyString | Ext]?: string | false | null | undefined;
+};
 
 /**
- * @file Interfaces - ModuleFormatMap
- * @module mlly/interfaces/ModuleFormatMap
+ * @file Type Aliases - FileContent
+ * @module mlly/types/FileContent
  */
 /**
- * Registry of module formats.
- *
- * This interface can be augmented to register custom module formats.
+ * Union of values that can occur where file content is expected.
  *
- * @example
- *  declare module '@flex-development/mlly' {
- *    interface ModuleFormatMap {
- *      custom: 'custom'
- *    }
- *  }
+ * @see {@linkcode Uint8Array}
  */
-interface ModuleFormatMap {
-    builtin: 'builtin';
-    commonjs: 'commonjs';
-    cts: 'commonjs-typescript';
-    json: 'json';
-    module: 'module';
-    mts: 'module-typescript';
-    wasm: 'wasm';
-}
+type FileContent = Uint8Array | string;
 
 /**
- * @file Interfaces - PatternKeyComparisonMap
- * @module mlly/interfaces/PatternKeyComparisonMap
+ * @file Type Aliases - GetNewExtension
+ * @module mlly/types/GetNewExtension
  */
 /**
- * Registry of `PATTERN_KEY_COMPARE` algorithm results.
+ * Get a new file extension for a `url`.
  *
- * This interface can be augmented to register custom results.
+ * Returning an empty string (`''`), `false`, `null`, or `undefined`
+ * will remove the current file extension.
  *
- * @example
- *  declare module '@flex-development/mlly' {
- *    interface PatternKeyComparisonMap {
- *      afterThree: 3
- *    }
- *  }
+ * ::: info
+ * File extensions are normalized and
+ * do not need to begin with a dot character (`'.'`).
+ * :::
+ *
+ * @see {@linkcode URL}
+ * @see https://github.com/flex-development/pathe/tree/1.0.3#changeextpath-string-ext-nullablestring-string
+ *
+ * @template {string | false | null | undefined} [T]
+ *  The new file extension
+ *
+ * @param {URL} url
+ *  The resolved module URL
+ * @param {string} specifier
+ *  The module specifier being resolved
+ * @return {T}
+ *  The new file extension
  */
-interface PatternKeyComparisonMap {
-    /**
-     * `a` should come after `b`.
-     */
-    after: 1;
-    /**
-     * `a` should come before `b`.
-     */
-    before: -1;
-    /**
-     * `a` and `b` are equal.
-     */
-    equal: 0;
-}
+type GetNewExtension<T extends string | false | null | undefined = string | false | null | undefined> = (this: void, url: URL, specifier: string) => T;
 
 /**
- * @file Interfaces - ProtocolMap
- * @module mlly/interfaces/ProtocolMap
+ * @file Type Aliases - GetSourceHandler
+ * @module mlly/types/GetSourceHandler
  */
+
 /**
- * Registry of URL protocols.
+ * Get the source code for a module.
  *
- * This interface can be augmented to register custom protocols.
+ * @see {@linkcode Awaitable}
+ * @see {@linkcode FileContent}
+ * @see {@linkcode GetSourceContext}
+ * @see {@linkcode URL}
  *
- * @see https://nodejs.org/api/url.html#urlprotocol
- * @see https://iana.org/assignments/uri-schemes/uri-schemes.xhtml
- * @see https://url.spec.whatwg.org/#special-scheme
+ * @this {GetSourceContext}
+ *  The retrieval context
  *
- * @example
- *  declare module '@flex-development/mlly' {
- *    interface ProtocolMap {
- *      custom: 'custom:'
- *    }
- *  }
+ * @param {URL} url
+ *  The module URL
+ * @return {Awaitable<FileContent | null | undefined>}
+ *  The source code
  */
-interface ProtocolMap {
-    blob: 'blob:';
-    content: 'content:';
-    cvs: 'cvs:';
-    data: 'data:';
-    dns: 'dns:';
-    file: 'file:';
-    fish: 'fish:';
-    ftp: 'ftp:';
-    git: 'git:';
-    http: 'http:';
-    https: 'https:';
-    mvn: 'mvn:';
-    node: 'node:';
-    redis: 'redis:';
-    sftp: 'sftp:';
-    ssh: 'ssh:';
-    svn: 'svn:';
-    urn: 'urn:';
-    viewSource: 'view-source:';
-    ws: 'ws:';
-    wss: 'wss:';
-}
+type GetSourceHandler = (this: GetSourceContext, url: URL) => Awaitable<FileContent | null | undefined>;
+
+/**
+ * @file Type Aliases - GetSourceHandlers
+ * @module mlly/types/GetSourceHandlers
+ */
+
+/**
+ * Record, where key is a URL protocol and each value is a source code handler.
+ *
+ * @see {@linkcode GetSourceHandler}
+ * @see {@linkcode Protocol}
+ */
+type GetSourceHandlers = {
+    [H in Protocol]?: GetSourceHandler | null | undefined;
+};
+
+/**
+ * @file Type Aliases - List
+ * @module mlly/types/List
+ */
+/**
+ * A list.
+ *
+ * @template {any} [T=unknown]
+ *  The list item type
+ */
+type List<T = unknown> = ReadonlySet<T> | readonly T[];
 
 /**
- * @file Interfaces - ReadFile
- * @module mlly/interfaces/ReadFile
+ * @file Type Aliases - MainField
+ * @module mlly/types/MainField
  */
 
 /**
- * Read the entire contents of a file.
+ * Union of values that can occur where a main field is expected.
+ *
+ * To register new fields, augment {@linkcode MainFieldMap}.
+ * They will be added to this union automatically.
  */
-interface ReadFile {
-    /**
-     * @see {@linkcode ModuleId}
-     *
-     * @this {unknown}
-     *
-     * @param {ModuleId} id
-     *  The module id
-     * @param {BufferEncoding} encoding
-     *  The encoding of the file contents
-     * @return {Awaitable<string>}
-     *  The file contents
-     */
-    (id: ModuleId, encoding: BufferEncoding): Awaitable<string>;
-    /**
-     * @see {@linkcode Awaitable}
-     * @see {@linkcode FileContent}
-     * @see {@linkcode ModuleId}
-     *
-     * @template {Awaitable<FileContent | null | undefined>} T
-     *  The file contents
-     *
-     * @this {unknown}
-     *
-     * @param {ModuleId} id
-     *  The module id
-     * @param {BufferEncoding | null | undefined} [encoding]
-     *  The encoding of the file contents
-     * @return {T}
-     *  The file contents
-     */
-    <T extends Awaitable<FileContent | null | undefined>>(id: ModuleId, encoding?: BufferEncoding | null | undefined): T;
-}
+type MainField = MainFieldMap[keyof MainFieldMap];
 
 /**
- * @file Interfaces - Realpath
- * @module mlly/interfaces/Realpath
+ * @file Type Aliases - ModuleFormat
+ * @module mlly/types/ModuleFormat
  */
 
 /**
- * Compute a canonical pathname by resolving `.`, `..`, and symbolic links.
+ * Union of values that can occur where a module format is expected.
  *
- * > 👉 **Note**: A canonical pathname is not necessarily unique.
- * > Hard links and bind mounts can expose an entity through many pathnames.
+ * To register new formats, augment {@linkcode ModuleFormatMap}.
+ * They will be added to this union automatically.
  */
-interface Realpath {
-    /**
-     * @see {@linkcode Awaitable}
-     * @see {@linkcode ModuleId}
-     *
-     * @template {Awaitable<string>} T
-     *  The canonical pathname
-     *
-     * @this {unknown}
-     *
-     * @param {ModuleId} id
-     *  The module id
-     * @return {T}
-     *  The canonical pathname
-     */
-    <T extends Awaitable<string>>(id: ModuleId): T;
-}
+type ModuleFormat = ModuleFormatMap[keyof ModuleFormatMap];
 
 /**
- * @file Interfaces - ResolveAliasOptions
- * @module mlly/interfaces/ResolveAliasOptions
+ * @file Type Aliases - ModuleId
+ * @module mlly/types/ModuleId
  */
-
 /**
- * Options for path alias resolution.
+ * Union of values that can occur where a
+ * ECMAScript (ES) module identifier is expected.
+ *
+ * @see {@linkcode URL}
  */
-interface ResolveAliasOptions {
-    /**
-     * Whether the resolved specifier should be absolute.
-     *
-     * If `true`, the resolved specifier will be a [`file:` URL][file-url].
-     *
-     * [file-url]: https://nodejs.org/api/esm.html#file-urls
-     *
-     * @see https://nodejs.org/api/esm.html#terminology
-     */
-    absolute?: boolean | null | undefined;
-    /**
-     * The path mappings dictionary.
-     *
-     * > 👉 **Note**: Paths should be relative to {@linkcode cwd}.
-     *
-     * @see {@linkcode Aliases}
-     */
-    aliases?: Aliases | null | undefined;
-    /**
-     * The URL of the directory to resolve non-absolute modules from.
-     *
-     * @see {@linkcode ModuleId}
-     *
-     * @default cwd()
-     */
-    cwd?: ModuleId | null | undefined;
-    /**
-     * The URL of the parent module.
-     *
-     * @see {@linkcode ModuleId}
-     */
-    parent?: ModuleId | null | undefined;
-}
+type ModuleId = URL | string;
 
 /**
- * @file Interfaces - ResolveModuleOptions
- * @module mlly/interfaces/ResolveModuleOptions
+ * @file Type Aliases - Numeric
+ * @module mlly/types/Numeric
+ */
+/**
+ * String containing only numbers (not including the leading `-` if negative).
  */
+type Numeric = `${number}`;
 
 /**
- * Module resolution options.
+ * @file Type Aliases - PatternKeyComparison
+ * @module mlly/types/PatternKeyComparison
  */
-interface ResolveModuleOptions {
-    /**
-     * The path mappings dictionary.
-     *
-     * > 👉 **Note**: Paths should be relative to {@linkcode cwd}.
-     *
-     * @see {@linkcode Aliases}
-     */
-    aliases?: Aliases | null | undefined;
-    /**
-     * The list of export/import conditions.
-     *
-     * > 👉 **Note**: Should be sorted by priority.
-     *
-     * @see {@linkcode Condition}
-     * @see {@linkcode List}
-     * @see https://nodejs.org/api/packages.html#conditional-exports
-     *
-     * @default defaultConditions
-     */
-    conditions?: List<Condition> | null | undefined;
-    /**
-     * The URL of the directory to resolve path {@linkcode aliases} from.
-     *
-     * @see {@linkcode ModuleId}
-     *
-     * @default cwd()
-     */
-    cwd?: ModuleId | null | undefined;
-    /**
-     * A replacement file extension or a function that returns a file extension.
-     *
-     * > 👉 **Note**: An empty string (`''`) or `null` will
-     * > remove a file extension.
-     *
-     * @see {@linkcode ChangeExtFn}
-     */
-    ext?: ChangeExtFn | string | null | undefined;
-    /**
-     * The module extensions to probe for.
-     *
-     * > 👉 **Note**: Should be sorted by priority.
-     *
-     * @see {@linkcode List}
-     *
-     * @default defaultExtensions
-     */
-    extensions?: List<string> | null | undefined;
-    /**
-     * The file system API.
-     *
-     * @see {@linkcode FileSystem}
-     */
-    fs?: FileSystem | null | undefined;
-    /**
-     * The list of legacy `main` fields.
-     *
-     * > 👉 **Note**: Should be sorted by priority.
-     *
-     * @see {@linkcode List}
-     * @see {@linkcode MainField}
-     *
-     * @default defaultMainFields
-     */
-    mainFields?: List<MainField> | null | undefined;
-    /**
-     * Whether to keep symlinks instead of resolving them.
-     */
-    preserveSymlinks?: boolean | null | undefined;
-}
 
 /**
- * @file Interfaces - Stat
- * @module mlly/interfaces/Stat
+ * Union of values that can occur
+ * where a `PATTERN_KEY_COMPARE` algorithm result is expected.
+ *
+ * To register new results, augment {@linkcode PatternKeyComparisonMap}.
+ * They will be added to this union automatically.
  */
+type PatternKeyComparison = PatternKeyComparisonMap[keyof PatternKeyComparisonMap];
 
 /**
- * Get information about a directory or file.
+ * @file Type Aliases - PatternMatch
+ * @module mlly/types/PatternMatch
  */
-interface Stat {
-    /**
-     * @see {@linkcode Awaitable}
-     * @see {@linkcode ModuleId}
-     * @see {@linkcode Stats}
-     *
-     * @template {Awaitable<Stats>} T
-     *  The info
-     *
-     * @this {unknown}
-     *
-     * @param {ModuleId} id
-     *  The module id
-     * @return {T}
-     *  The info
-     */
-    <T extends Awaitable<Stats>>(id: ModuleId): T;
-}
+/**
+ * List, where the first item is the key of a package `exports` or `imports`
+ * target object, and the last is a subpath pattern match.
+ */
+type PatternMatch = [expansionKey: string, patternMatch: string | null];
 
 /**
- * @file Interfaces - Stats
- * @module mlly/interfaces/Stats
+ * @file Type Aliases - Protocol
+ * @module mlly/types/Protocol
  */
 
 /**
- * An object describing a directory or file.
+ * Union of values that can occur where a URL protocol is expected.
+ *
+ * To register new protocols, augment {@linkcode ProtocolMap}.
+ * They will be added to this union automatically.
  */
-interface Stats {
-    /**
-     * Check if the stats object describes a directory.
-     *
-     * @see {@linkcode IsDirectory}
-     */
-    isDirectory: IsDirectory;
-    /**
-     * Check if the stats object describes a file.
-     *
-     * @see {@linkcode IsFile}
-     */
-    isFile: IsFile;
-}
+type Protocol = ProtocolMap[keyof ProtocolMap];
 
 export { canParseUrl, cwd, defaultConditions, defaultExtensions, defaultMainFields, extensionFormatMap, formats, getSource, isAbsoluteSpecifier, isArrayIndex, isBareSpecifier, isDirectory, isFile, isImportsSubpath, isModuleId, isRelativeSpecifier, legacyMainResolve, lookupPackageScope, moduleResolve, packageExportsResolve, packageImportsExportsResolve, packageImportsResolve, packageResolve, packageSelfResolve, packageTargetResolve, patternKeyCompare, patternMatch, readPackageJson, resolveAlias, resolveModule, resolver_d as resolver, root, toRelativeSpecifier, toUrl };
-export type { Aliases, Awaitable, BufferEncoding, BufferEncodingMap, ChangeExtFn, Condition, ConditionMap, Dot, EmptyArray, EmptyObject, EmptyString, Ext, FileContent, FileSystem, GetSourceContext, GetSourceHandler, GetSourceHandlers, GetSourceOptions, IsDirectory, IsFile, List, MainField, MainFieldMap, ModuleFormat, ModuleFormatMap, ModuleId, Numeric, PatternKeyComparison, PatternKeyComparisonMap, PatternMatch, Protocol, ProtocolMap, ReadFile, Realpath, ResolveAliasOptions, ResolveModuleOptions, Stat, Stats };
+export type { Aliases, Awaitable, BufferEncoding, BufferEncodingMap, Condition, ConditionMap, Dot, EmptyArray, EmptyObject, EmptyString, Ext, ExtensionRewrites, FileContent, FileSystem, GetNewExtension, GetSourceContext, GetSourceHandler, GetSourceHandlers, GetSourceOptions, IsDirectory, IsFile, List, MainField, MainFieldMap, ModuleFormat, ModuleFormatMap, ModuleId, Numeric, PatternKeyComparison, PatternKeyComparisonMap, PatternMatch, Protocol, ProtocolMap, ReadFile, Realpath, ResolveAliasOptions, ResolveModuleOptions, Stat, Stats };