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

package/CHANGELOG.md

@@ -1,3 +1,32 @@
+## [1.0.0-beta.7](https://github.com/flex-development/mlly/compare/1.0.0-beta.6...1.0.0-beta.7) (2026-02-18)
+
+### :package: Build
+
+- [[`d1d72a8`](https://github.com/flex-development/mlly/commit/d1d72a8ad498328f8bd9e1e030c18ac58441a879)] **deps:** use @flex-development/when
+- [[`fc3e70a`](https://github.com/flex-development/mlly/commit/fc3e70addbd8172f1464ba5fcef8dcf24cdd22e1)] **pkg:** bundle dts files with rollup only
+
+### :sparkles: Features
+
+- [[`20cd201`](https://github.com/flex-development/mlly/commit/20cd2010a3e4ba5fb3d6cfea649ee12996aebea7)] **lib:** [`resolveModule`] allow `specifier` to be `URL`
+
+### :white_check_mark: Testing
+
+- [[`b598060`](https://github.com/flex-development/mlly/commit/b59806093cf5bbdb8b06ec9bcea9972054bd2902)] add `edge-runtime` environment tests
+
+## [1.0.0-beta.6](https://github.com/flex-development/mlly/compare/1.0.0-beta.5...1.0.0-beta.6) (2026-02-12)
+
+### ⚠ BREAKING CHANGES
+
+- **lib:** [`resolveModule`] support extension rewrite map
+
+### :package: Build
+
+- [[`38c36b4`](https://github.com/flex-development/mlly/commit/38c36b4a6df62494e87aeb6ba7d9ce8466ab22cc)] **deps-dev:** Bump vite-tsconfig-paths from 6.1.0 to 6.1.1 ([#975](https://github.com/flex-development/mlly/issues/975))
+
+### :sparkles: Features
+
+- [[`efdcc40`](https://github.com/flex-development/mlly/commit/efdcc40de2380932f7cfac80b0d7e96a2cdb8e48)] **lib:** [`resolveModule`] support extension rewrite map
+
 ## [1.0.0-beta.5](https://github.com/flex-development/mlly/compare/1.0.0-beta.4...1.0.0-beta.5) (2026-02-12)
 
 ### :package: Build
@@ -1312,3 +1341,5 @@
 
 
 
+
+

package/README.md

@@ -23,6 +23,7 @@
   - [Resolve like Node.js](#resolve-like-nodejs)
   - [Resolve with custom conditions](#resolve-with-custom-conditions)
   - [Resolve a directory index](#resolve-a-directory-index)
+  - [Resolve path aliases](#resolve-path-aliases)
   - [Rewrite an extension](#rewrite-an-extension)
   - [Use a custom file system](#use-a-custom-file-system)
 - [Use Cases](#use-cases)
@@ -67,7 +68,6 @@
   - [`Awaitable<T>`](#awaitablet)
   - [`BufferEncodingMap`](#bufferencodingmap)
   - [`BufferEncoding`](#bufferencoding)
-  - [`ChangeExtFn<[Ext]>`](#changeextfnext)
   - [`ConditionMap`](#conditionmap)
   - [`Condition`](#condition)
   - [`Dot`](#dot)
@@ -75,8 +75,10 @@
   - [`EmptyObject`](#emptyobject)
   - [`EmptyString`](#emptystring)
   - [`Ext`](#ext)
+  - [`ExtensionRewrites`](#extensionrewrites)
   - [`FileContent`](#filecontent)
   - [`FileSystem`](#filesystem)
+  - [`GetNewExtension<[T]>`](#getnewextensiont)
   - [`GetSourceContext`](#getsourcecontext)
   - [`GetSourceHandler`](#getsourcehandler)
   - [`GetSourceHandlers`](#getsourcehandlers)
@@ -215,6 +217,39 @@ const resolved: URL = resolveModule('./src/lib', import.meta.url, {
 })
 ```
 
+### Resolve path aliases
+
+```ts
+import { resolveModule, type Aliases } from '@flex-development/mlly'
+
+/**
+ * The path mappings dictionary.
+ *
+ * @const {Aliases} aliases
+ */
+const aliases: Aliases = {
+  '@/internal': './src/internal',
+  '@/internal/*': './src/internal/*'
+}
+
+/**
+ * The resolved directory URL.
+ *
+ * @const {URL} directory
+ */
+const directory: URL = resolveModule('@/internal', import.meta.url, { aliases })
+
+/**
+ * The resolved file URL.
+ *
+ * @const {URL} file
+ */
+const file: URL = resolveModule('@/internal/fs', import.meta.url, { aliases })
+
+console.dir(directory)
+console.dir(file)
+```
+
 ### Rewrite an extension
 
 ```ts
@@ -987,7 +1022,7 @@ Resolve an aliased `specifier`.
 - `specifier` (`string`)
   — the specifier using an alias
 - `options` ([`ResolveAliasOptions`](#resolvealiasoptions) | `null` | `undefined`)
-  — alias resolution options
+  — options for alias resolution
 
 #### Returns
 
@@ -1016,12 +1051,12 @@ Adds support for:
 
 #### Parameters
 
-- `specifier` (`string`)
+- `specifier` ([`ModuleId`](#moduleid))
   — the module specifier to resolve
 - `parent` ([`ModuleId`](#moduleid))
   — the url of the parent module
 - `options` ([`ResolveModuleOptions`](#resolvemoduleoptions))
-  — module resolution options
+  — options for module resolution
 
 #### Returns
 
@@ -1144,34 +1179,6 @@ They will be added to this union automatically.
 type BufferEncoding = BufferEncodingMap[keyof BufferEncodingMap]
 ```
 
-### `ChangeExtFn<[Ext]>`
-
-Get a new file extension for `url` (`type`).
-
-Returning an empty string (`''`), `null`, or `undefined` will remove the current file extension.
-
-```ts
-type ChangeExtFn<
-  Ext extends string | null | undefined = string | null | undefined
-> = (this: void, url: URL, specifier: string) => Ext
-```
-
-#### Type Parameters
-
-- `Ext` (`string` | `null` | `undefined`, optional)
-  — the new file extension
-
-#### Parameters
-
-- `url` (`URL`)
-  — the resolved module URL
-- `specifier` (`string`)
-  — the module specifier being resolved
-
-#### Returns
-
-(`Ext`) The new file extension
-
 ### `ConditionMap`
 
 Registry of export/import conditions (`interface`).
@@ -1237,6 +1244,20 @@ A file extension (`type`).
 type Ext = `${Dot}${string}`
 ```
 
+### `ExtensionRewrites`
+
+Record, where each key is the file extension of a module specifier
+and each value is a replacement file extension (`type`).
+
+> 👉 **Note**: Replacement file extensions are normalized and do not need to begin with a dot character (`'.'`);
+> falsy values will remove an extension.
+
+```ts
+type ExtensionRewrites = {
+  [K in EmptyString | Ext]?: string | false | null | undefined
+}
+```
+
 ### `FileContent`
 
 Union of values that can occur where file content is expected (`type`).
@@ -1258,6 +1279,38 @@ The file system API (`interface`).
 - `stat` ([`Stat`](#stat))
   — get information about a directory or file
 
+### `GetNewExtension<[T]>`
+
+Get a new file extension for a `url` (`type`).
+
+Returning an empty string (`''`), `false`, `null`, or `undefined` will remove the current file extension.
+
+```ts
+type GetNewExtension<
+  T extends string | false | null | undefined =
+    | string
+    | false
+    | null
+    | undefined
+> = (this: void, url: URL, specifier: string) => T
+```
+
+#### Type Parameters
+
+- `T` (`string` | `false` | `null` | `undefined`, optional)
+  — the new file extension
+
+#### Parameters
+
+- `url` (`URL`)
+  — the resolved module URL
+- `specifier` (`string`)
+  — the module specifier being resolved
+
+#### Returns
+
+(`T`) The new file extension
+
 ### `GetSourceContext`
 
 Source code retrieval context (`interface`).
@@ -1557,7 +1610,7 @@ Options for path alias resolution (`interface`).
 
 ### `ResolveModuleOptions`
 
-Options for path alias resolution (`interface`).
+Options for module resolution (`interface`).
 
 #### Properties
 
@@ -1571,9 +1624,12 @@ Options for path alias resolution (`interface`).
 - `cwd?` ([`ModuleId`](#moduleid) | `null` | `undefined`)
   — the url of the directory to resolve path `aliases` from
   - **default**: [`cwd()`](#cwd)
-- `ext?` ([`ChangeExtFn`](#changeextfnext) | `string` | `null` | `undefined`)
-  — a replacement file extension or a function that returns a file extension.
-  > \:point\_right: **note**: an empty string (`''`) or `null` will remove a file extension
+  <!--lint disable-->
+- `ext?` ([`ExtensionRewrites`](#extensionrewrites) | [`GetNewExtension`](#getnewextensiont) | `false` | `string` | `null` | `undefined`)
+  — a replacement file extension, a record of replacement file extensions, or a function that returns a replacement file extension
+  <!--lint enable-->
+  > \:point\_right: **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
 - `extensions?` ([`List<string>`](#listt) | `null` | `undefined`)
   — the module extensions to probe for
   - **default**: [`defaultExtensions`](#defaultextensions)