docs: [api] packageSelfResolve

Signed-off-by: Lexus Drumgold <[email protected]>

Author: unicornware

README.md

@@ -506,9 +506,36 @@ Implements the [`PACKAGE_RESOLVE`][algorithm-package-resolve] algorithm.
 
 <!--lint enable-->
 
+Resolve the self-import of a package.
+
 Implements the [`PACKAGE_SELF_RESOLVE`][algorithm-package-self-resolve] algorithm.
 
-**TODO**: `packageSelfResolve`
+> 👉 **Note**: Returns a promise if [`lookupPackageScope`](#lookuppackagescopeturl-end-fs),
+> [`packageExportsResolve`](#packageexportsresolvetpackageurl-subpath-exports-conditions-parent-fs),
+> or [`readPackageJson`](#readpackagejsontid-specifier-parent-fs) returns a promise.
+
+#### Type Parameters
+
+- `T` ([`Awaitable<URL | undefined>`](#awaitablet))
+  — the resolved package url
+
+#### Parameters
+
+- `name` (`string`)
+  — the package name
+- `subpath` (`string`)
+  — the package subpath
+- `parent` ([`ModuleId`](#moduleid))
+  — the url of the parent module
+- `conditions` ([`List<Condition>`](#condition) | `null` | `undefined`)
+  — the list of export conditions
+  - **default**: [`defaultConditions`](#defaultconditions)
+- `fs` ([`FileSystem`](#filesystem) | `null` | `undefined`)
+  — the file system api
+
+#### Returns
+
+(`T`) The resolved package URL
 
 <!--lint disable-->
 

docs/resolution-algorithm.md

@@ -162,7 +162,16 @@ The resolver can throw the following errors:
 
 ## `PACKAGE_SELF_RESOLVE(name, subpath, parent, conditions)`
 
-**TODO**: `PACKAGE_SELF_RESOLVE`
+1. Let *packageUrl* be the result of [`LOOKUP_PACKAGE_SCOPE(packageUrl)`][lookup-package-scope]
+2. If *packageUrl* is `null`, then
+   1. Return `undefined`
+3. Let *pjson* be the result of [`READ_PACKAGE_JSON(packageUrl)`][read-package-json]
+4. If *pjson* is `null` or if *pjson*.*exports* is `null` or `undefined`, then
+   1. Return `undefined`
+5. If *pjson*.*name* is equal to `name`, then
+   1. Return the result of
+      [`PACKAGE_EXPORTS_RESOLVE(packageUrl, subpath, pjson.exports, conditions)`][package-exports-resolve]
+6. Otherwise, return `undefined`
 
 <!--lint disable-->
 

src/lib/resolver.mts

@@ -1358,7 +1358,7 @@ function packageResolve(
  * @see {@linkcode ModuleId}
  *
  * @template {Awaitable<URL | undefined>} T
- *  The resolved URL
+ *  The resolved package URL
  *
  * @this {void}
  *
@@ -1373,7 +1373,7 @@ function packageResolve(
  * @param {FileSystem | null | undefined} [fs]
  *  The file system API
  * @return {T}
- *  The resolved URL
+ *  The resolved package URL
  */
 function packageSelfResolve<T extends Awaitable<URL | undefined>>(
   this: void,
@@ -1412,7 +1412,7 @@ function packageSelfResolve<T extends Awaitable<URL | undefined>>(
  * @param {FileSystem | null | undefined} [fs]
  *  The file system API
  * @return {Awaitable<URL | undefined>}
- *  The resolved URL
+ *  The resolved package URL
  */
 function packageSelfResolve(
   this: void,