@flex-development/mlly 1.0.0-beta.1 → 1.0.0-beta.2

package/CHANGELOG.md

@@ -1,3 +1,9 @@
+## [1.0.0-beta.2](https://github.com/flex-development/mlly/compare/1.0.0-beta.1...1.0.0-beta.2) (2026-02-02)
+
+### :sparkles: Features
+
+- [[`a799aef`](https://github.com/flex-development/mlly/commit/a799aef04f5fa6033297c362474047acaaeb0e1f)] **ts:** generic fs methods
+
 ## [1.0.0-beta.1](https://github.com/flex-development/mlly/compare/1.0.0-alpha.20...1.0.0-beta.1) (2026-02-02)
 
 ### ⚠ BREAKING CHANGES
@@ -1253,3 +1259,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

@@ -84,11 +84,11 @@
   - [`PatternMatch`](#patternmatch)
   - [`ProtocolMap`](#protocolmap)
   - [`Protocol`](#protocol)
-  - [`ReadFile`](#readfile)
-  - [`Realpath`](#realpath)
+  - [`ReadFile<[T]>`](#readfilet)
+  - [`Realpath<[T]>`](#realpatht)
   - [`ResolveAliasOptions`](#resolvealiasoptions)
   - [`ResolveModuleOptions`](#resolvemoduleoptions)
-  - [`Stat`](#stat)
+  - [`Stat<[T]>`](#statt)
   - [`Stats`](#stats)
 - Additional Documentation
   - [Resolution Algorithm](./docs/resolution-algorithm.md)
@@ -1138,11 +1138,11 @@ The file system API (`interface`).
 
 #### Properties
 
-- `readFile` ([`ReadFile`](#readfile))
+- `readFile` ([`ReadFile`](#readfilet))
   — read the entire contents of a file
-- `realpath` ([`Realpath`](#realpath))
+- `realpath` ([`Realpath`](#realpatht))
   — compute a canonical pathname by resolving `.`, `..`, and symbolic links
-- `stat` ([`Stat`](#stat))
+- `stat` ([`Stat`](#statt))
   — get information about a directory or file
 
 ### `GetSourceContext`
@@ -1372,10 +1372,15 @@ They will be added to this union automatically.
 type Protocol = ProtocolMap[keyof ProtocolMap]
 ```
 
-### `ReadFile`
+### `ReadFile<[T]>`
 
 Read the entire contents of a file (`interface`).
 
+#### Type Parameters
+
+- `T` ([`Awaitable<Buffer | string>`](#awaitablet), optional)
+  — the file contents
+
 #### Parameters
 
 - `id` ([`ModuleId`](#moduleid))
@@ -1383,15 +1388,20 @@ Read the entire contents of a file (`interface`).
 
 #### Returns
 
-([`Awaitable<Buffer | string>`](#awaitablet)) The file contents
+(`T`) The file contents
 
-### `Realpath`
+### `Realpath<[T]>`
 
 Compute a canonical pathname by resolving `.`, `..`, and symbolic links (`interface`).
 
 > 👉 **Note**: A canonical pathname is not necessarily unique.
 > Hard links and bind mounts can expose an entity through many pathnames.
 
+#### Type Parameters
+
+- `T` ([`Awaitable<string>`](#awaitablet), optional)
+  — the canonical pathname
+
 #### Parameters
 
 - `id` ([`ModuleId`](#moduleid))
@@ -1399,7 +1409,7 @@ Compute a canonical pathname by resolving `.`, `..`, and symbolic links (`interf
 
 #### Returns
 
-([`Awaitable<string>`](#awaitablet)) The canonical pathname
+(`T`) The canonical pathname
 
 ### `ResolveAliasOptions`
 
@@ -1451,10 +1461,15 @@ Options for path alias resolution (`interface`).
 - `preserveSymlinks?` (`boolean` | `null` | `undefined`)
   — whether to keep symlinks instead of resolving them
 
-### `Stat`
+### `Stat<[T]>`
 
 Get information about a directory or file (`interface`).
 
+#### Type Parameters
+
+- `T` ([`Awaitable<Stats>`](#stats), optional)
+  — the info
+
 #### Parameters
 
 - `id` ([`ModuleId`](#moduleid))
@@ -1462,7 +1477,7 @@ Get information about a directory or file (`interface`).
 
 #### Returns
 
-([`Awaitable<Stats>`](#stats)) The info
+(`T`) The info
 
 ### `Stats`
 

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

@@ -5,20 +5,24 @@
 import type { Awaitable, ModuleId } from '@flex-development/mlly';
 /**
  * Read the entire contents of a file.
+ *
+ * @see {@linkcode Awaitable}
+ * @see {@linkcode Buffer}
+ *
+ * @template {Awaitable<Buffer | string>} [T]
+ *  The file contents
  */
-interface ReadFile {
+interface ReadFile<T extends Awaitable<Buffer | string> = Awaitable<Buffer | string>> {
     /**
-     * @see {@linkcode Awaitable}
-     * @see {@linkcode Buffer}
      * @see {@linkcode ModuleId}
      *
      * @this {void}
      *
      * @param {ModuleId} id
      *  The module id
-     * @return {Awaitable<Buffer | string>}
+     * @return {T}
      *  The file contents
      */
-    (this: void, id: ModuleId): Awaitable<Buffer | string>;
+    (this: void, id: ModuleId): T;
 }
 export type { ReadFile as default };

package/dist/interfaces/realpath.d.mts

@@ -8,19 +8,23 @@ import type { Awaitable, ModuleId } from '@flex-development/mlly';
  *
  * > 👉 **Note**: A canonical pathname is not necessarily unique.
  * > Hard links and bind mounts can expose an entity through many pathnames.
+ *
+ * @see {@linkcode Awaitable}
+ *
+ * @template {Awaitable<string>} [T]
+ *  The canonical pathname
  */
-interface Realpath {
+interface Realpath<T extends Awaitable<string> = Awaitable<string>> {
     /**
-     * @see {@linkcode Awaitable}
      * @see {@linkcode ModuleId}
      *
      * @this {void}
      *
      * @param {ModuleId} id
      *  The module id
-     * @return {Awaitable<string>}
+     * @return {T}
      *  The canonical pathname
      */
-    (this: void, id: ModuleId): Awaitable<string>;
+    (this: void, id: ModuleId): T;
 }
 export type { Realpath as default };

package/dist/interfaces/stat.d.mts

@@ -5,20 +5,24 @@
 import type { Awaitable, ModuleId, Stats } from '@flex-development/mlly';
 /**
  * Get information about a directory or file.
+ *
+ * @see {@linkcode Awaitable}
+ * @see {@linkcode Stats}
+ *
+ * @template {Awaitable<Stats>} [T]
+ *  The info
  */
-interface Stat {
+interface Stat<T extends Awaitable<Stats> = Awaitable<Stats>> {
     /**
-     * @see {@linkcode Awaitable}
      * @see {@linkcode ModuleId}
-     * @see {@linkcode Stats}
      *
      * @this {void}
      *
      * @param {ModuleId} id
      *  The module id
-     * @return {Awaitable<Stats>}
+     * @return {T}
      *  The info
      */
-    (this: void, id: ModuleId): Awaitable<Stats>;
+    (this: void, id: ModuleId): T;
 }
 export type { Stat as default };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@flex-development/mlly",
   "description": "ECMAScript module utilities",
-  "version": "1.0.0-beta.1",
+  "version": "1.0.0-beta.2",
   "keywords": [
     "ecmascript",
     "esm",