@flex-development/mlly 1.0.0-alpha.19 → 1.0.0-alpha.20

package/CHANGELOG.md

@@ -1,3 +1,22 @@
+## [1.0.0-alpha.20](https://github.com/flex-development/mlly/compare/1.0.0-alpha.19...1.0.0-alpha.20) (2024-12-29)
+
+### ⚠ BREAKING CHANGES
+
+- **lib:** [`resolver`] synchronous methods
+
+### :package: Build
+
+- [[`a466da3`](https://github.com/flex-development/mlly/commit/a466da3a2220d5bf8b76d5a145c67c7767a4df2e)] **deps-dev:** Bump @stylistic/eslint-plugin from 2.11.0 to 2.12.1 ([#756](https://github.com/flex-development/mlly/issues/756))
+- [[`b55b400`](https://github.com/flex-development/mlly/commit/b55b400e8fd612cb4cd2fae681e82529649fcd69)] **deps-dev:** Bump consola from 3.2.3 to 3.3.1 ([#757](https://github.com/flex-development/mlly/issues/757))
+- [[`156b3d2`](https://github.com/flex-development/mlly/commit/156b3d2f047b07f74fef291f9880fece6635c628)] **deps-dev:** Bump consola from 3.3.1 to 3.3.3 ([#759](https://github.com/flex-development/mlly/issues/759))
+- [[`822d03a`](https://github.com/flex-development/mlly/commit/822d03a715735e4272c3682df634f93aef6630c5)] **deps-dev:** Bump dprint from 0.47.6 to 0.48.0 ([#755](https://github.com/flex-development/mlly/issues/755))
+- [[`51d471a`](https://github.com/flex-development/mlly/commit/51d471af89b6811c7732f73fe22c41a782cec4cb)] **deps-dev:** bump the typescript-eslint group from 8.18.1 to 8.18.3-alpha.5
+- [[`dc82de3`](https://github.com/flex-development/mlly/commit/dc82de388f9387b53a4cd551de44756f99d144fb)] **deps:** Bump @flex-development/pathe from 4.0.0 to 4.0.1 in the flex-development group ([#758](https://github.com/flex-development/mlly/issues/758))
+
+### :sparkles: Features
+
+- [[`a88c7f8`](https://github.com/flex-development/mlly/commit/a88c7f867397fc061371367c31086693c2f89e4f)] **lib:** [`resolver`] synchronous methods
+
 ## [1.0.0-alpha.19](https://github.com/flex-development/mlly/compare/1.0.0-alpha.18...1.0.0-alpha.19) (2024-12-20)
 
 ### ⚠ BREAKING CHANGES
@@ -1073,3 +1092,4 @@
 - [[`0266ca9`](https://github.com/flex-development/mlly/commit/0266ca9a5593d0c66e950ba1fe2c8f6df8422ff9)] **resolve:** sort `RESOLVE_EXTENSIONS` according to priority
 - [[`36c4b74`](https://github.com/flex-development/mlly/commit/36c4b7475c9bb6c924f5e75c8d6d215a8d23e79c)] **specifiers:** [`toBareSpecifier`] improve `exports` path search
 
+

package/README.md

@@ -77,14 +77,22 @@ import {
   isImportsSubpath,
   isRelativeSpecifier,
   legacyMainResolve,
+  legacyMainResolveSync,
   lookupPackageScope,
   moduleResolve,
+  moduleResolveSync,
   packageExportsResolve,
+  packageExportsResolveSync,
   packageImportsExportsResolve,
+  packageImportsExportsResolveSync,
   packageImportsResolve,
+  packageImportsResolveSync,
   packageResolve,
+  packageResolveSync,
   packageSelfResolve,
+  packageSelfResolveSync,
   packageTargetResolve,
+  packageTargetResolveSync,
   patternKeyCompare,
   patternMatch,
   readPackageJson,
@@ -124,13 +132,21 @@ This package exports the following identifiers:
 - [`resolveModule`](./src/lib/resolve-module.mts)
 - [`resolver`](./src/lib/resolver.mts)
   - `legacyMainResolve`
+  - `legacyMainResolveSync`
   - `moduleResolve`
+  - `moduleResolveSync`
   - `packageExportsResolve`
+  - `packageExportsResolveSync`
   - `packageImportsExportsResolve`
+  - `packageImportsExportsResolveSync`
   - `packageImportsResolve`
+  - `packageImportsResolveSync`
   - `packageResolve`
+  - `packageResolveSync`
   - `packageSelfResolve`
+  - `packageSelfResolveSync`
   - `packageTargetResolve`
+  - `packageTargetResolveSync`
 - [`root`](./src/lib/root.mts)
 - [`toRelativeSpecifier`](./src/lib/to-relative-specifier.mts)
 - [`toUrl`](./src/lib/to-url.mts)

package/dist/interfaces/file-system.d.mts

@@ -2,7 +2,7 @@
  * @file Interfaces - FileSystem
  * @module mlly/interfaces/FileSystem
  */
-import type { Awaitable, ModuleId, Stats } from '@flex-development/mlly';
+import type { ModuleId, Stats } from '@flex-development/mlly';
 /**
  * File system API.
  */
@@ -10,7 +10,6 @@ interface FileSystem {
     /**
      * Get the contents of `id`.
      *
-     * @see {@linkcode Awaitable}
      * @see {@linkcode Buffer}
      * @see {@linkcode ModuleId}
      * @see https://nodejs.org/api/fs.html#fsreadfilepath-options-callback
@@ -19,14 +18,13 @@ interface FileSystem {
      *
      * @param {ModuleId} id
      *  The path or `file:` URL to handle
-     * @return {Awaitable<Buffer | string>}
+     * @return {Buffer | string}
      *  File contents
      */
-    readFile(this: void, id: ModuleId): Awaitable<Buffer | string>;
+    readFileSync(this: void, id: ModuleId): Buffer | string;
     /**
      * Get the resolved pathname for `id`.
      *
-     * @see {@linkcode Awaitable}
      * @see {@linkcode ModuleId}
      * @see https://nodejs.org/api/fs.html#fsrealpathpath-options-callback
      *
@@ -34,14 +32,13 @@ interface FileSystem {
      *
      * @param {ModuleId} id
      *  The path or `file:` URL to handle
-     * @return {Awaitable<string>}
+     * @return {string}
      *  Resolved pathname
      */
-    realpath(this: void, id: ModuleId): Awaitable<string>;
+    realpathSync(this: void, id: ModuleId): string;
     /**
      * Get information about a directory or file.
      *
-     * @see {@linkcode Awaitable}
      * @see {@linkcode ModuleId}
      * @see {@linkcode Stats}
      *
@@ -49,9 +46,9 @@ interface FileSystem {
      *
      * @param {ModuleId} id
      *  The path or `file:` URL to handle
-     * @return {Awaitable<Stats>}
+     * @return {Stats}
      *  Info about `id`
      */
-    stat(this: void, id: ModuleId): Awaitable<Stats>;
+    statSync(this: void, id: ModuleId): Stats;
 }
 export type { FileSystem as default };

package/dist/internal/fs.browser.mjs

@@ -6,8 +6,8 @@ const fs = {
    *  Never; not implemented
    * @throws {Error}
    */
-  readFile() {
-    throw new Error("[readFile] not implemented");
+  readFileSync() {
+    throw new Error("[readFileSync] not implemented");
   },
   /**
    * Get the resolved pathname of a file.
@@ -16,8 +16,8 @@ const fs = {
    *  Never; not implemented
    * @throws {Error}
    */
-  realpath() {
-    throw new Error("[realpath] not implemented");
+  realpathSync() {
+    throw new Error("[realpathSync] not implemented");
   },
   /**
    * Get information about a file.
@@ -26,8 +26,8 @@ const fs = {
    *  Never; not implemented
    * @throws {Error}
    */
-  stat() {
-    throw new Error("[stat] not implemented");
+  statSync() {
+    throw new Error("[statSync] not implemented");
   }
 };
 var fs_browser_default = fs;

package/dist/lib/get-source.mjs

@@ -52,10 +52,10 @@ function data(url) {
     mime.endsWith("base64") ? "base64" : "utf8"
   );
 }
-async function file(url) {
+function file(url) {
   ok(url.protocol === "file:", "expected `file:` URL");
   let code = null;
-  if (await isFile(url, this.fs)) code = await this.fs.readFile(url);
+  if (isFile(url, this.fs)) code = this.fs.readFileSync(url);
   return code;
 }
 async function https(url) {

package/dist/lib/is-directory.d.mts

@@ -9,14 +9,12 @@ import type { FileSystem, ModuleId } from '@flex-development/mlly';
  * @see {@linkcode FileSystem}
  * @see {@linkcode ModuleId}
  *
- * @async
- *
  * @param {ModuleId} id
  *  Module id to check
  * @param {FileSystem | null | undefined} fs
  *  File system API
- * @return {Promise<boolean>}
+ * @return {boolean}
  *  `true` if directory exists at `id`, `false` otherwise
  */
-declare function isDirectory(id: ModuleId, fs?: FileSystem | null | undefined): Promise<boolean>;
+declare function isDirectory(id: ModuleId, fs?: FileSystem | null | undefined): boolean;
 export default isDirectory;

package/dist/lib/is-directory.mjs

@@ -1,8 +1,8 @@
 import dfs from "#internal/fs";
-async function isDirectory(id, fs) {
+function isDirectory(id, fs) {
   try {
     if (typeof id === "string" && id.startsWith("file:")) id = new URL(id);
-    return (await (fs ?? dfs).stat(id)).isDirectory();
+    return (fs ?? dfs).statSync(id).isDirectory();
   } catch {
     return false;
   }

package/dist/lib/is-file.d.mts

@@ -9,14 +9,12 @@ import type { FileSystem, ModuleId } from '@flex-development/mlly';
  * @see {@linkcode FileSystem}
  * @see {@linkcode ModuleId}
  *
- * @async
- *
  * @param {ModuleId} id
  *  Module id to check
  * @param {FileSystem | null | undefined} fs
  *  File system API
- * @return {Promise<boolean>}
+ * @return {boolean}
  *  `true` if file exists at `id`, `false` otherwise
  */
-declare function isFile(id: ModuleId, fs?: FileSystem | null | undefined): Promise<boolean>;
+declare function isFile(id: ModuleId, fs?: FileSystem | null | undefined): boolean;
 export default isFile;

package/dist/lib/is-file.mjs

@@ -1,8 +1,8 @@
 import dfs from "#internal/fs";
-async function isFile(id, fs) {
+function isFile(id, fs) {
   try {
     if (typeof id === "string" && id.startsWith("file:")) id = new URL(id);
-    return (await (fs ?? dfs).stat(id)).isFile();
+    return (fs ?? dfs).statSync(id).isFile();
   } catch {
     return false;
   }

package/dist/lib/lookup-package-scope.d.mts

@@ -11,16 +11,14 @@ import type { FileSystem, ModuleId } from '@flex-development/mlly';
  * @see {@linkcode FileSystem}
  * @see {@linkcode ModuleId}
  *
- * @async
- *
  * @param {ModuleId} url
  *  URL of module to get package scope for
  * @param {ModuleId | null | undefined} [end]
  *  URL of directory to end search, defaults to {@linkcode root}
  * @param {FileSystem | null | undefined} [fs]
  *  File system API
- * @return {Promise<URL | null>}
+ * @return {URL | null}
  *  URL of nearest directory containing `package.json` file or `null`
  */
-declare function lookupPackageScope(url: ModuleId, end?: ModuleId | null | undefined, fs?: FileSystem | null | undefined): Promise<URL | null>;
+declare function lookupPackageScope(url: ModuleId, end?: ModuleId | null | undefined, fs?: FileSystem | null | undefined): URL | null;
 export default lookupPackageScope;

package/dist/lib/lookup-package-scope.mjs

@@ -1,12 +1,12 @@
 import isFile from "#lib/is-file";
 import root from "#lib/root";
 import pathe from "@flex-development/pathe";
-async function lookupPackageScope(url, end, fs) {
+function lookupPackageScope(url, end, fs) {
   let scopeUrl = new URL(url);
   while (String(scopeUrl) !== String(end ?? root)) {
     scopeUrl = /[/\\]$/.test(scopeUrl.pathname) ? new URL(pathe.dot + pathe.dot, scopeUrl) : new URL(pathe.dot, scopeUrl);
     if (/node_modules[/\\]$/.test(scopeUrl.pathname)) break;
-    if (await isFile(new URL("package.json", scopeUrl), fs)) return scopeUrl;
+    if (isFile(new URL("package.json", scopeUrl), fs)) return scopeUrl;
   }
   return null;
 }

package/dist/lib/read-package-json.d.mts

@@ -26,10 +26,10 @@ import type { PackageJson } from '@flex-development/pkg-types';
  *  URL of parent module
  * @param {FileSystem | null | undefined} [fs]
  *  File system API
- * @return {Promise<PackageJson | null>}
+ * @return {PackageJson | null}
  *  Parsed file contents or `null`
  * @throws {ErrInvalidPackageConfig}
  *  If `package.json` file does not parse as valid JSON
  */
-declare function readPackageJson(id: ModuleId, specifier?: string | null | undefined, parent?: ModuleId | null | undefined, fs?: FileSystem | null | undefined): Promise<PackageJson | null>;
+declare function readPackageJson(id: ModuleId, specifier?: string | null | undefined, parent?: ModuleId | null | undefined, fs?: FileSystem | null | undefined): PackageJson | null;
 export default readPackageJson;

package/dist/lib/read-package-json.mjs

@@ -4,10 +4,10 @@ import {
   ERR_INVALID_PACKAGE_CONFIG
 } from "@flex-development/errnode";
 import pathe from "@flex-development/pathe";
-async function readPackageJson(id, specifier, parent, fs) {
+function readPackageJson(id, specifier, parent, fs) {
   const url = new URL("package.json", id);
-  if (await isFile(url, fs)) {
-    const data = String(await (fs ?? dfs).readFile(url));
+  if (isFile(url, fs)) {
+    const data = String((fs ?? dfs).readFileSync(url));
     try {
       return JSON.parse(data);
     } catch (e) {

package/dist/lib/resolver.d.mts

@@ -12,7 +12,7 @@ declare module '@flex-development/errnode' {
         url?: string | null | undefined;
     }
 }
-export { legacyMainResolve, moduleResolve, packageExportsResolve, packageImportsExportsResolve, packageImportsResolve, packageResolve, packageSelfResolve, packageTargetResolve };
+export { legacyMainResolve, legacyMainResolveSync, moduleResolve, moduleResolveSync, packageExportsResolve, packageExportsResolveSync, packageImportsExportsResolve, packageImportsExportsResolveSync, packageImportsResolve, packageImportsResolveSync, packageResolve, packageResolveSync, packageSelfResolve, packageSelfResolveSync, packageTargetResolve, packageTargetResolveSync };
 /**
  * Resolve the [`main`][main] package entry point using the legacy CommonJS
  * resolution algorithm.
@@ -43,6 +43,34 @@ export { legacyMainResolve, moduleResolve, packageExportsResolve, packageImports
  * @throws {ErrModuleNotFound}
  */
 declare function legacyMainResolve(packageUrl: ModuleId, manifest?: PackageJson | null | undefined, mainFields?: MainField[] | Set<MainField> | null | undefined, parent?: ModuleId | null | undefined, fs?: FileSystem | null | undefined): Promise<URL>;
+/**
+ * Resolve the [`main`][main] package entry point using the legacy CommonJS
+ * resolution algorithm.
+ *
+ * [main]: https://github.com/nodejs/node/blob/v22.9.0/doc/api/packages.md#main
+ *
+ * @see {@linkcode ErrModuleNotFound}
+ * @see {@linkcode FileSystem}
+ * @see {@linkcode MainField}
+ * @see {@linkcode ModuleId}
+ * @see {@linkcode PackageJson}
+ *
+ * @param {ModuleId} packageUrl
+ *  URL of package directory, `package.json` file, or module in the same
+ *  directory as a `package.json` file
+ * @param {PackageJson | null | undefined} [manifest]
+ *  Package manifest
+ * @param {MainField[] | Set<MainField> | null | undefined} [mainFields]
+ *  List of legacy main fields
+ * @param {ModuleId | null | undefined} [parent]
+ *  URL of parent module
+ * @param {FileSystem | null | undefined} [fs]
+ *  File system API
+ * @return {URL}
+ *  Resolved URL
+ * @throws {ErrModuleNotFound}
+ */
+declare function legacyMainResolveSync(packageUrl: ModuleId, manifest?: PackageJson | null | undefined, mainFields?: MainField[] | Set<MainField> | null | undefined, parent?: ModuleId | null | undefined, fs?: FileSystem | null | undefined): URL;
 /**
  * Resolve a module `specifier`.
  *
@@ -77,6 +105,38 @@ declare function legacyMainResolve(packageUrl: ModuleId, manifest?: PackageJson
  * @throws {ErrUnsupportedDirImport}
  */
 declare function moduleResolve(specifier: string, parent: ModuleId, conditions?: Condition[] | Set<Condition> | null | undefined, mainFields?: MainField[] | Set<MainField> | null | undefined, preserveSymlinks?: boolean | null | undefined, fs?: FileSystem | null | undefined): Promise<URL>;
+/**
+ * Resolve a module `specifier`.
+ *
+ * Implements the `MODULE_RESOLVE` (`ESM_RESOLVE`) algorithm.
+ *
+ * @see {@linkcode Condition}
+ * @see {@linkcode ErrInvalidModuleSpecifier}
+ * @see {@linkcode ErrModuleNotFound}
+ * @see {@linkcode ErrUnsupportedDirImport}
+ * @see {@linkcode FileSystem}
+ * @see {@linkcode ModuleId}
+ * @see https://github.com/nodejs/node/blob/v22.9.0/doc/api/esm.md#resolution-algorithm
+ *
+ * @param {string} specifier
+ *  Module specifier to resolve
+ * @param {ModuleId} parent
+ *  URL of parent module
+ * @param {Condition[] | Set<Condition> | null | undefined} [conditions]
+ *  List of export/import conditions
+ * @param {MainField[] | Set<MainField> | null | undefined} [mainFields]
+ *  List of legacy main fields
+ * @param {boolean | null | undefined} [preserveSymlinks]
+ *  Keep symlinks instead of resolving them
+ * @param {FileSystem | null | undefined} [fs]
+ *  File system API
+ * @return {URL}
+ *  Resolved URL
+ * @throws {ErrInvalidModuleSpecifier}
+ * @throws {ErrModuleNotFound}
+ * @throws {ErrUnsupportedDirImport}
+ */
+declare function moduleResolveSync(specifier: string, parent: ModuleId, conditions?: Condition[] | Set<Condition> | null | undefined, mainFields?: MainField[] | Set<MainField> | null | undefined, preserveSymlinks?: boolean | null | undefined, fs?: FileSystem | null | undefined): URL;
 /**
  * Resolve a package export.
  *
@@ -112,6 +172,39 @@ declare function moduleResolve(specifier: string, parent: ModuleId, conditions?:
  * @throws {ErrPackagePathNotExported}
  */
 declare function packageExportsResolve(packageUrl: ModuleId, subpath: string, exports: Exports | undefined, conditions?: Condition[] | Set<Condition> | null | undefined, parent?: ModuleId | null | undefined, fs?: FileSystem | null | undefined): Promise<URL>;
+/**
+ * Resolve a package export.
+ *
+ * Implements the `PACKAGE_EXPORTS_RESOLVE` algorithm.
+ *
+ * @see {@linkcode Condition}
+ * @see {@linkcode ErrInvalidPackageConfig}
+ * @see {@linkcode ErrPackagePathNotExported}
+ * @see {@linkcode Exports}
+ * @see {@linkcode FileSystem}
+ * @see {@linkcode Imports}
+ * @see {@linkcode ModuleId}
+ * @see https://github.com/nodejs/node/blob/v22.9.0/doc/api/esm.md#resolution-algorithm
+ *
+ * @param {ModuleId} packageUrl
+ *  URL of package directory, `package.json` file, or module in the same
+ *  directory as a `package.json` file
+ * @param {string} subpath
+ *  Package subpath to resolve
+ * @param {Exports | undefined} exports
+ *  Package exports
+ * @param {Condition[] | Set<Condition> | null | undefined} [conditions]
+ *  List of export/import conditions
+ * @param {ModuleId | null | undefined} [parent]
+ *  URL of parent module
+ * @param {FileSystem | null | undefined} [fs]
+ *  File system API
+ * @return {URL}
+ *  Resolved URL
+ * @throws {ErrInvalidPackageConfig}
+ * @throws {ErrPackagePathNotExported}
+ */
+declare function packageExportsResolveSync(packageUrl: ModuleId, subpath: string, exports: Exports | undefined, conditions?: Condition[] | Set<Condition> | null | undefined, parent?: ModuleId | null | undefined, fs?: FileSystem | null | undefined): URL;
 /**
  * Resolve a package export or import.
  *
@@ -146,6 +239,38 @@ declare function packageExportsResolve(packageUrl: ModuleId, subpath: string, ex
  *  Resolved URL
  */
 declare function packageImportsExportsResolve(matchKey: string, matchObject: ExportsObject | Imports | null | undefined, packageUrl: ModuleId, isImports?: boolean | null | undefined, conditions?: Condition[] | Set<Condition> | null | undefined, mainFields?: MainField[] | Set<MainField> | null | undefined, parent?: ModuleId | null | undefined, fs?: FileSystem | null | undefined): Promise<URL | null | undefined>;
+/**
+ * Resolve a package export or import.
+ *
+ * Implements the `PACKAGE_IMPORTS_EXPORTS_RESOLVE` algorithm.
+ *
+ * @see {@linkcode Condition}
+ * @see {@linkcode ExportsObject}
+ * @see {@linkcode FileSystem}
+ * @see {@linkcode Imports}
+ * @see {@linkcode ModuleId}
+ * @see https://github.com/nodejs/node/blob/v22.9.0/doc/api/esm.md#resolution-algorithm
+ *
+ * @param {string} matchKey
+ *  Package subpath from module specifier or dot character (`'.'`)
+ * @param {ExportsObject | Imports | null | undefined} matchObject
+ *  Package exports object or imports
+ * @param {ModuleId} packageUrl
+ *  URL of directory containing `package.json` file
+ * @param {boolean | null | undefined} [isImports]
+ *  Whether `matchObject` is internal to the package
+ * @param {Condition[] | Set<Condition> | null | undefined} [conditions]
+ *  List of export/import conditions
+ * @param {MainField[] | Set<MainField> | null | undefined} [mainFields]
+ *  List of legacy main fields
+ * @param {ModuleId | null | undefined} [parent]
+ *  URL of parent module
+ * @param {FileSystem | null | undefined} [fs]
+ *  File system API
+ * @return {URL | null | undefined}
+ *  Resolved URL
+ */
+declare function packageImportsExportsResolveSync(matchKey: string, matchObject: ExportsObject | Imports | null | undefined, packageUrl: ModuleId, isImports?: boolean | null | undefined, conditions?: Condition[] | Set<Condition> | null | undefined, mainFields?: MainField[] | Set<MainField> | null | undefined, parent?: ModuleId | null | undefined, fs?: FileSystem | null | undefined): URL | null | undefined;
 /**
  * Resolve a package import.
  *
@@ -158,6 +283,8 @@ declare function packageImportsExportsResolve(matchKey: string, matchObject: Exp
  * @see {@linkcode ModuleId}
  * @see https://github.com/nodejs/node/blob/v22.9.0/doc/api/esm.md#resolution-algorithm
  *
+ * @async
+ *
  * @param {string} specifier
  *  The import specifier to resolve
  * @param {ModuleId} parent
@@ -174,6 +301,34 @@ declare function packageImportsExportsResolve(matchKey: string, matchObject: Exp
  * @throws {ErrPackageImportNotDefined}
  */
 declare function packageImportsResolve(specifier: string, parent: ModuleId, conditions?: Condition[] | Set<Condition> | null | undefined, mainFields?: MainField[] | Set<MainField> | null | undefined, fs?: FileSystem | null | undefined): Promise<URL>;
+/**
+ * Resolve a package import.
+ *
+ * Implements the `PACKAGE_IMPORTS_RESOLVE` algorithm.
+ *
+ * @see {@linkcode Condition}
+ * @see {@linkcode ErrInvalidModuleSpecifier}
+ * @see {@linkcode ErrPackageImportNotDefined}
+ * @see {@linkcode FileSystem}
+ * @see {@linkcode ModuleId}
+ * @see https://github.com/nodejs/node/blob/v22.9.0/doc/api/esm.md#resolution-algorithm
+ *
+ * @param {string} specifier
+ *  The import specifier to resolve
+ * @param {ModuleId} parent
+ *  URL of parent module
+ * @param {Condition[] | Set<Condition> | null | undefined} [conditions]
+ *  List of export/import conditions
+ * @param {MainField[] | Set<MainField> | null | undefined} [mainFields]
+ *  List of legacy main fields
+ * @param {FileSystem | null | undefined} [fs]
+ *  File system API
+ * @return {URL}
+ *  Resolved URL
+ * @throws {ErrInvalidModuleSpecifier}
+ * @throws {ErrPackageImportNotDefined}
+ */
+declare function packageImportsResolveSync(specifier: string, parent: ModuleId, conditions?: Condition[] | Set<Condition> | null | undefined, mainFields?: MainField[] | Set<MainField> | null | undefined, fs?: FileSystem | null | undefined): URL;
 /**
  * Resolve a *bare specifier*.
  *
@@ -213,6 +368,43 @@ declare function packageImportsResolve(specifier: string, parent: ModuleId, cond
  * @throws {ErrModuleNotFound}
  */
 declare function packageResolve(specifier: string, parent: ModuleId, conditions?: Condition[] | Set<Condition> | null | undefined, mainFields?: MainField[] | Set<MainField> | null | undefined, fs?: FileSystem | null | undefined): Promise<URL>;
+/**
+ * Resolve a *bare specifier*.
+ *
+ * > *Bare specifiers* like `'some-package'` or `'some-package/shuffle'` refer
+ * > to the main entry point of a package by package name, or a specific feature
+ * > module within a package prefixed by the package name. Including the file
+ * > extension is only necessary for packages without an [`"exports"`][exports]
+ * > field.
+ *
+ * Implements the `PACKAGE_RESOLVE` algorithm.
+ *
+ * [exports]: https://nodejs.org/api/packages.html#exports
+ *
+ * @see {@linkcode Condition}
+ * @see {@linkcode ErrInvalidModuleSpecifier}
+ * @see {@linkcode ErrModuleNotFound}
+ * @see {@linkcode FileSystem}
+ * @see {@linkcode MainField}
+ * @see {@linkcode ModuleId}
+ * @see https://github.com/nodejs/node/blob/v22.9.0/doc/api/esm.md#resolution-algorithm
+ *
+ * @param {string} specifier
+ *  The package specifier to resolve
+ * @param {ModuleId} parent
+ *  Id of module to resolve `packageSpecifier` against
+ * @param {Condition[] | Set<Condition> | null | undefined} [conditions]
+ *  List of export/import conditions
+ * @param {MainField[] | Set<MainField> | null | undefined} [mainFields]
+ *  List of legacy main fields
+ * @param {FileSystem | null | undefined} [fs]
+ *  File system API
+ * @return {URL}
+ *  Resolved URL
+ * @throws {ErrInvalidModuleSpecifier}
+ * @throws {ErrModuleNotFound}
+ */
+declare function packageResolveSync(specifier: string, parent: ModuleId, conditions?: Condition[] | Set<Condition> | null | undefined, mainFields?: MainField[] | Set<MainField> | null | undefined, fs?: FileSystem | null | undefined): URL;
 /**
  * Resolve the self-import of a package.
  *
@@ -239,6 +431,30 @@ declare function packageResolve(specifier: string, parent: ModuleId, conditions?
  *  Resolved URL
  */
 declare function packageSelfResolve(name: string, subpath: string, parent: ModuleId, conditions?: Condition[] | Set<Condition> | null | undefined, fs?: FileSystem | null | undefined): Promise<URL | undefined>;
+/**
+ * Resolve the self-import of a package.
+ *
+ * Implements the `PACKAGE_SELF_RESOLVE` algorithm.
+ *
+ * @see {@linkcode Condition}
+ * @see {@linkcode FileSystem}
+ * @see {@linkcode ModuleId}
+ * @see https://github.com/nodejs/node/blob/v22.9.0/doc/api/esm.md#resolution-algorithm
+ *
+ * @param {string} name
+ *  Package name
+ * @param {string} subpath
+ *  Package subpath
+ * @param {ModuleId} parent
+ *  URL of parent module
+ * @param {Condition[] | Set<Condition> | null | undefined} [conditions]
+ *  List of export conditions
+ * @param {FileSystem | null | undefined} [fs]
+ *  File system API
+ * @return {URL | undefined}
+ *  Resolved URL
+ */
+declare function packageSelfResolveSync(name: string, subpath: string, parent: ModuleId, conditions?: Condition[] | Set<Condition> | null | undefined, fs?: FileSystem | null | undefined): URL | undefined;
 /**
  * Resolve a package target.
  *
@@ -278,3 +494,40 @@ declare function packageSelfResolve(name: string, subpath: string, parent: Modul
  * @throws {ErrInvalidPackageTarget}
  */
 declare function packageTargetResolve(packageUrl: ModuleId, target: unknown, subpath: string, patternMatch?: string | null | undefined, isImports?: boolean | null | undefined, conditions?: Condition[] | Set<Condition> | null | undefined, mainFields?: MainField[] | Set<MainField> | null | undefined, parent?: ModuleId | null | undefined, fs?: FileSystem | null | undefined): Promise<URL | null | undefined>;
+/**
+ * Resolve a package target.
+ *
+ * Implements the `PACKAGE_TARGET_RESOLVE` algorithm.
+ *
+ * @see {@linkcode Condition}
+ * @see {@linkcode ErrInvalidPackageConfig}
+ * @see {@linkcode ErrInvalidPackageTarget}
+ * @see {@linkcode FileSystem}
+ * @see {@linkcode ModuleId}
+ * @see {@linkcode Target}
+ * @see https://github.com/nodejs/node/blob/v22.9.0/doc/api/esm.md#resolution-algorithm
+ *
+ * @param {ModuleId} packageUrl
+ *  URL of directory containing `package.json` file
+ * @param {unknown} target
+ *  The package target to resolve
+ * @param {string} subpath
+ *  Package subpath (key of `exports`/`imports`)
+ * @param {string | null | undefined} [patternMatch]
+ *  Subpath pattern match
+ * @param {boolean | null | undefined} [isImports]
+ *  Whether `target` is internal to the package
+ * @param {Condition[] | Set<Condition> | null | undefined} [conditions]
+ *  List of export/import conditions
+ * @param {MainField[] | Set<MainField> | null | undefined} [mainFields]
+ *  List of legacy main fields
+ * @param {ModuleId | null | undefined} [parent]
+ *  URL of parent module
+ * @param {FileSystem | null | undefined} [fs]
+ *  File system API
+ * @return {URL | null | undefined}
+ *  Resolved URL
+ * @throws {ErrInvalidPackageConfig}
+ * @throws {ErrInvalidPackageTarget}
+ */
+declare function packageTargetResolveSync(packageUrl: ModuleId, target: unknown, subpath: string, patternMatch?: string | null | undefined, isImports?: boolean | null | undefined, conditions?: Condition[] | Set<Condition> | null | undefined, mainFields?: MainField[] | Set<MainField> | null | undefined, parent?: ModuleId | null | undefined, fs?: FileSystem | null | undefined): URL | null | undefined;

package/dist/lib/resolver.mjs

@@ -30,6 +30,17 @@ import { isBuiltin } from "@flex-development/is-builtin";
 import pathe from "@flex-development/pathe";
 import { ok } from "devlop";
 async function legacyMainResolve(packageUrl, manifest, mainFields, parent, fs) {
+  return new Promise((resolve) => {
+    return void resolve(legacyMainResolveSync(
+      packageUrl,
+      manifest,
+      mainFields,
+      parent,
+      fs
+    ));
+  });
+}
+function legacyMainResolveSync(packageUrl, manifest, mainFields, parent, fs) {
   if (manifest) {
     for (const field of mainFields ?? defaultMainFields) {
       const tries = [];
@@ -49,7 +60,7 @@ async function legacyMainResolve(packageUrl, manifest, mainFields, parent, fs) {
       tries.push("./index.js", "./index.json", "./index.node");
       for (const input of tries) {
         resolved = new URL(input, packageUrl);
-        if (await isFile(resolved, fs)) return resolved;
+        if (isFile(resolved, fs)) return resolved;
       }
     }
   }
@@ -59,6 +70,18 @@ async function legacyMainResolve(packageUrl, manifest, mainFields, parent, fs) {
   );
 }
 async function moduleResolve(specifier, parent, conditions, mainFields, preserveSymlinks, fs) {
+  return new Promise((resolve) => {
+    return void resolve(moduleResolveSync(
+      specifier,
+      parent,
+      conditions,
+      mainFields,
+      preserveSymlinks,
+      fs
+    ));
+  });
+}
+function moduleResolveSync(specifier, parent, conditions, mainFields, preserveSymlinks, fs) {
   const protocol = typeof parent === "string" ? parent.slice(0, parent.indexOf(":") + 1) : parent.protocol;
   let resolved;
   if (pathe.isAbsolute(specifier) || isRelativeSpecifier(specifier)) {
@@ -71,7 +94,7 @@ async function moduleResolve(specifier, parent, conditions, mainFields, preserve
       throw error;
     }
   } else if (protocol === "file:" && isImportsSubpath(specifier)) {
-    resolved = await packageImportsResolve(
+    resolved = packageImportsResolveSync(
       specifier,
       parent,
       conditions,
@@ -88,7 +111,7 @@ async function moduleResolve(specifier, parent, conditions, mainFields, preserve
         error.cause = e;
         throw error;
       }
-      resolved = await packageResolve(
+      resolved = packageResolveSync(
         specifier,
         parent,
         conditions,
@@ -107,7 +130,7 @@ async function moduleResolve(specifier, parent, conditions, mainFields, preserve
         pathe.fileURLToPath(parent)
       );
     }
-    if (await isDirectory(resolved, fs)) {
+    if (isDirectory(resolved, fs)) {
       let error;
       error = new ERR_UNSUPPORTED_DIR_IMPORT(
         pathname,
@@ -116,7 +139,7 @@ async function moduleResolve(specifier, parent, conditions, mainFields, preserve
       error.url = String(resolved);
       throw error;
     }
-    if (!await isFile(resolved, fs)) {
+    if (!isFile(resolved, fs)) {
       throw new ERR_MODULE_NOT_FOUND(
         pathname,
         pathe.fileURLToPath(parent),
@@ -125,7 +148,7 @@ async function moduleResolve(specifier, parent, conditions, mainFields, preserve
     }
     if (!preserveSymlinks) {
       fs ??= dfs;
-      resolved = new URL(pathe.pathToFileURL(await fs.realpath(resolved)));
+      resolved = new URL(pathe.pathToFileURL(fs.realpathSync(resolved)));
       resolved.hash = hash;
       resolved.search = search;
     }
@@ -133,6 +156,18 @@ async function moduleResolve(specifier, parent, conditions, mainFields, preserve
   return resolved;
 }
 async function packageExportsResolve(packageUrl, subpath, exports, conditions, parent, fs) {
+  return new Promise((resolve) => {
+    return void resolve(packageExportsResolveSync(
+      packageUrl,
+      subpath,
+      exports,
+      conditions,
+      parent,
+      fs
+    ));
+  });
+}
+function packageExportsResolveSync(packageUrl, subpath, exports, conditions, parent, fs) {
   if (exports) {
     let dot = false;
     if (!Array.isArray(exports) && typeof exports === "object") {
@@ -160,7 +195,7 @@ async function packageExportsResolve(packageUrl, subpath, exports, conditions, p
         mainExport = exports[pathe.dot];
       }
       if (mainExport !== void 0) {
-        resolved = await packageTargetResolve(
+        resolved = packageTargetResolveSync(
           packageUrl,
           mainExport,
           subpath,
@@ -175,7 +210,7 @@ async function packageExportsResolve(packageUrl, subpath, exports, conditions, p
     } else if (typeof exports === "object" && dot) {
       ok(!Array.isArray(exports), "expected `exports` to not be an array");
       ok(subpath.startsWith("./"), 'expected `subpath` to start with "./"');
-      resolved = await packageImportsExportsResolve(
+      resolved = packageImportsExportsResolveSync(
         subpath,
         exports,
         packageUrl,
@@ -195,10 +230,24 @@ async function packageExportsResolve(packageUrl, subpath, exports, conditions, p
   );
 }
 async function packageImportsExportsResolve(matchKey, matchObject, packageUrl, isImports, conditions, mainFields, parent, fs) {
+  return new Promise((resolve) => {
+    return void resolve(packageImportsExportsResolveSync(
+      matchKey,
+      matchObject,
+      packageUrl,
+      isImports,
+      conditions,
+      mainFields,
+      parent,
+      fs
+    ));
+  });
+}
+function packageImportsExportsResolveSync(matchKey, matchObject, packageUrl, isImports, conditions, mainFields, parent, fs) {
   if (typeof matchObject === "object" && matchObject) {
     const match = patternMatch(matchKey, matchObject);
     if (match) {
-      return packageTargetResolve(
+      return packageTargetResolveSync(
         packageUrl,
         matchObject[match[0]],
         ...match,
@@ -213,6 +262,17 @@ async function packageImportsExportsResolve(matchKey, matchObject, packageUrl, i
   return null;
 }
 async function packageImportsResolve(specifier, parent, conditions, mainFields, fs) {
+  return new Promise((resolve) => {
+    return void resolve(packageImportsResolveSync(
+      specifier,
+      parent,
+      conditions,
+      mainFields,
+      fs
+    ));
+  });
+}
+function packageImportsResolveSync(specifier, parent, conditions, mainFields, fs) {
   if (!specifier.startsWith(chars.hash) || specifier === chars.hash || specifier.startsWith(chars.hash + pathe.sep)) {
     throw new ERR_INVALID_MODULE_SPECIFIER(
       specifier,
@@ -220,16 +280,16 @@ async function packageImportsResolve(specifier, parent, conditions, mainFields,
       pathe.fileURLToPath(parent)
     );
   }
-  const packageUrl = await lookupPackageScope(parent, null, fs);
+  const packageUrl = lookupPackageScope(parent, null, fs);
   if (packageUrl) {
-    const pjson = await readPackageJson(
+    const pjson = readPackageJson(
       packageUrl,
       specifier,
       parent,
       fs
     );
     if (pjson) {
-      const resolved = await packageImportsExportsResolve(
+      const resolved = packageImportsExportsResolveSync(
         specifier,
         pjson.imports,
         packageUrl,
@@ -249,6 +309,17 @@ async function packageImportsResolve(specifier, parent, conditions, mainFields,
   );
 }
 async function packageResolve(specifier, parent, conditions, mainFields, fs) {
+  return new Promise((resolve) => {
+    return void resolve(packageResolveSync(
+      specifier,
+      parent,
+      conditions,
+      mainFields,
+      fs
+    ));
+  });
+}
+function packageResolveSync(specifier, parent, conditions, mainFields, fs) {
   if (isBuiltin(specifier)) return toUrl(specifier);
   let separatorIndex = -1;
   let valid = !!specifier;
@@ -272,7 +343,7 @@ async function packageResolve(specifier, parent, conditions, mainFields, fs) {
     );
   }
   const packageSubpath = pathe.dot + (separatorIndex === -1 ? chars.empty : specifier.slice(separatorIndex));
-  const selfUrl = await packageSelfResolve(
+  const selfUrl = packageSelfResolveSync(
     packageName,
     packageSubpath,
     parent,
@@ -284,15 +355,15 @@ async function packageResolve(specifier, parent, conditions, mainFields, fs) {
   while (String(parentUrl) !== String(root)) {
     let packageUrl = new URL(`node_modules/${packageName}/`, parentUrl);
     parentUrl = new URL(pathe.dirname(parentUrl.href));
-    if (!await isDirectory(packageUrl, fs)) continue;
-    const pjson = await readPackageJson(
+    if (!isDirectory(packageUrl, fs)) continue;
+    const pjson = readPackageJson(
       packageUrl,
       null,
       parent,
       fs
     );
     if (pjson?.exports) {
-      return packageExportsResolve(
+      return packageExportsResolveSync(
         packageUrl,
         packageSubpath,
         pjson.exports,
@@ -302,23 +373,34 @@ async function packageResolve(specifier, parent, conditions, mainFields, fs) {
       );
     }
     if (packageSubpath === pathe.dot) {
-      return legacyMainResolve(packageUrl, pjson, mainFields, parent, fs);
+      return legacyMainResolveSync(packageUrl, pjson, mainFields, parent, fs);
     }
     return new URL(packageSubpath, packageUrl);
   }
   throw new ERR_MODULE_NOT_FOUND(packageName, pathe.fileURLToPath(parent));
 }
 async function packageSelfResolve(name, subpath, parent, conditions, fs) {
-  const packageUrl = await lookupPackageScope(parent, null, fs);
+  return new Promise((resolve) => {
+    return void resolve(packageSelfResolveSync(
+      name,
+      subpath,
+      parent,
+      conditions,
+      fs
+    ));
+  });
+}
+function packageSelfResolveSync(name, subpath, parent, conditions, fs) {
+  const packageUrl = lookupPackageScope(parent, null, fs);
   if (packageUrl) {
-    const pjson = await readPackageJson(
+    const pjson = readPackageJson(
       packageUrl,
       null,
       parent,
       fs
     );
     if (pjson?.exports && name === pjson.name) {
-      return packageExportsResolve(
+      return packageExportsResolveSync(
         packageUrl,
         subpath,
         pjson.exports,
@@ -331,6 +413,21 @@ async function packageSelfResolve(name, subpath, parent, conditions, fs) {
   return void 0;
 }
 async function packageTargetResolve(packageUrl, target, subpath, patternMatch2, isImports, conditions, mainFields, parent, fs) {
+  return new Promise((resolve) => {
+    return void resolve(packageTargetResolveSync(
+      packageUrl,
+      target,
+      subpath,
+      patternMatch2,
+      isImports,
+      conditions,
+      mainFields,
+      parent,
+      fs
+    ));
+  });
+}
+function packageTargetResolveSync(packageUrl, target, subpath, patternMatch2, isImports, conditions, mainFields, parent, fs) {
   if (typeof target === "string") {
     if (!target.startsWith(pathe.dot + pathe.sep)) {
       if (!isImports || target.startsWith(pathe.dot + pathe.dot + pathe.sep) || target.startsWith(pathe.sep) || canParseUrl(target)) {
@@ -342,7 +439,7 @@ async function packageTargetResolve(packageUrl, target, subpath, patternMatch2,
           parent
         );
       }
-      return packageResolve(
+      return packageResolveSync(
         typeof patternMatch2 === "string" ? target.replace(chars.asterisk, patternMatch2) : target,
         packageUrl,
         conditions,
@@ -390,7 +487,7 @@ async function packageTargetResolve(packageUrl, target, subpath, patternMatch2,
       for (const targetValue of target) {
         let resolved;
         try {
-          resolved = await packageTargetResolve(
+          resolved = packageTargetResolveSync(
             packageUrl,
             targetValue,
             subpath,
@@ -425,7 +522,7 @@ async function packageTargetResolve(packageUrl, target, subpath, patternMatch2,
     if (Array.isArray(conditions)) conditions = new Set(conditions);
     for (const key of Object.getOwnPropertyNames(target)) {
       if (conditions.has(key) || key === "default") {
-        const resolved = await packageTargetResolve(
+        const resolved = packageTargetResolveSync(
           packageUrl,
           target[key],
           subpath,
@@ -452,11 +549,19 @@ async function packageTargetResolve(packageUrl, target, subpath, patternMatch2,
 }
 export {
   legacyMainResolve,
+  legacyMainResolveSync,
   moduleResolve,
+  moduleResolveSync,
   packageExportsResolve,
+  packageExportsResolveSync,
   packageImportsExportsResolve,
+  packageImportsExportsResolveSync,
   packageImportsResolve,
+  packageImportsResolveSync,
   packageResolve,
+  packageResolveSync,
   packageSelfResolve,
-  packageTargetResolve
+  packageSelfResolveSync,
+  packageTargetResolve,
+  packageTargetResolveSync
 };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@flex-development/mlly",
   "description": "ECMAScript module utilities",
-  "version": "1.0.0-alpha.19",
+  "version": "1.0.0-alpha.20",
   "keywords": [
     "ecmascript",
     "esm",
@@ -64,8 +64,8 @@
         "mlly": "./src/internal/fs.browser.mts",
         "default": "./dist/internal/fs.browser.mjs"
       },
-      "node": "fs/promises",
-      "default": "fs/promises"
+      "node": "fs",
+      "default": "fs"
     },
     "#internal/process": {
       "types": {
@@ -136,7 +136,7 @@
   "dependencies": {
     "@flex-development/errnode": "3.1.1",
     "@flex-development/is-builtin": "3.2.0",
-    "@flex-development/pathe": "4.0.0",
+    "@flex-development/pathe": "4.0.1",
     "@flex-development/pkg-types": "4.1.0",
     "devlop": "1.1.0"
   },
@@ -154,7 +154,7 @@
     "@flex-development/mkbuild": "1.0.0-alpha.23",
     "@flex-development/tsconfig-utils": "2.0.2",
     "@flex-development/tutils": "6.0.0-alpha.25",
-    "@stylistic/eslint-plugin": "2.11.0",
+    "@stylistic/eslint-plugin": "2.12.1",
     "@tsconfig/strictest": "2.0.5",
     "@types/chai": "5.0.0",
     "@types/chai-string": "1.4.5",
@@ -164,18 +164,18 @@
     "@types/node": "22.8.6",
     "@types/node-notifier": "8.0.5",
     "@types/rollup": "0.54.0",
-    "@typescript-eslint/eslint-plugin": "8.18.1",
-    "@typescript-eslint/parser": "8.18.1",
+    "@typescript-eslint/eslint-plugin": "8.18.3-alpha.5",
+    "@typescript-eslint/parser": "8.18.3-alpha.5",
     "@vates/toggle-scripts": "1.0.0",
     "@vitest/coverage-v8": "3.0.0-beta.3",
     "@vitest/ui": "3.0.0-beta.3",
     "chai": "5.1.2",
     "chai-each": "0.0.1",
     "chai-string": "1.5.0",
-    "consola": "3.2.3",
+    "consola": "3.3.3",
     "cross-env": "7.0.3",
     "cspell": "8.17.1",
-    "dprint": "0.47.6",
+    "dprint": "0.48.0",
     "editorconfig": "2.0.0",
     "esbuild": "0.24.2",
     "eslint": "9.17.0",
@@ -274,7 +274,7 @@
     "trash-cli": "6.0.0",
     "ts-dedent": "2.2.0",
     "typescript": "5.7.2",
-    "typescript-eslint": "8.18.1",
+    "typescript-eslint": "8.18.3-alpha.5",
     "unified": "11.0.5",
     "vfile": "6.0.3",
     "vite": "5.4.11",