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

package/dist/lib/root.mjs

@@ -1,12 +1 @@
-/**
- * @file root
- * @module mlly/lib/root
- */
-import { dot, parse, pathToFileURL, resolve } from '@flex-development/pathe';
-/**
- * The URL of the file system root.
- *
- * @const {URL} root
- */
-const root = pathToFileURL(parse(resolve(dot)).root);
-export default root;
+import{dot as o,parse as t,pathToFileURL as r,resolve as e}from"@flex-development/pathe";const p=r(t(e(o)).root);var l=p;export{l as default};

package/dist/lib/to-relative-specifier.mjs

@@ -1,63 +1 @@
-/**
- * @file toRelativeSpecifier
- * @module mlly/lib/toRelativeSpecifier
- */
-import pathe from '@flex-development/pathe';
-import { ok } from 'devlop';
-/**
- * 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
- */
-function toRelativeSpecifier(url, parent) {
-    parent = pathe.fileURLToPath(parent);
-    url = pathe.fileURLToPath(url);
-    /**
-     * The directory name of the {@linkcode parent} path.
-     *
-     * @const {string} dirname
-     */
-    const dirname = pathe.dirname(parent);
-    /**
-     * The relative specifier.
-     *
-     * @var {string} specifier
-     */
-    let specifier;
-    if (url.startsWith(parent) && parent.endsWith(pathe.sep)) {
-        // inside same directory as parent
-        specifier = pathe.dot + pathe.sep + url.slice(parent.length);
-    }
-    else if (url === dirname || url.startsWith(dirname + pathe.sep)) {
-        // directory name of parent or inside same directory as parent
-        specifier = pathe.dot + pathe.sep + url.slice(dirname.length + 1);
-    }
-    else {
-        // outside directory of parent
-        specifier = pathe.relative(parent, url);
-        ok(specifier.startsWith(pathe.dot), 'expected result to start with `.`');
-        /* v8 ignore else -- @preserve */
-        if (/(?:\.\.\/){2,}/.test(specifier)) {
-            // remove first '../' segment:
-            // pathe.relative backs out of an extra directory
-            specifier = specifier.slice(specifier.indexOf(pathe.sep) + 1);
-        }
-    }
-    return specifier;
-}
-export default toRelativeSpecifier;
+var h=Object.defineProperty;var f=(t,i)=>h(t,"name",{value:i,configurable:!0});import e from"@flex-development/pathe";import{ok as d}from"devlop";function c(t,i){i=e.fileURLToPath(i),t=e.fileURLToPath(t);const o=e.dirname(i);let s;if(t.startsWith(i)&&i.endsWith(e.sep))s=e.dot+e.sep+t.slice(i.length);else if(t===o||t.startsWith(o+e.sep))s=e.dot+e.sep+t.slice(o.length+1);else{s=e.relative(i,t),d(s.startsWith(e.dot),"expected result to start with `.`");/* v8 ignore else -- @preserve */ /(?:\.\.\/){2,}/.test(s)&&(s=s.slice(s.indexOf(e.sep)+1))}return s}f(c,"toRelativeSpecifier");var p=c;export{p as default};

package/dist/lib/to-url.mjs

@@ -1,34 +1 @@
-/**
- * @file toUrl
- * @module mlly/lib/toUrl
- */
-import canParseUrl from '#lib/can-parse-url';
-import { isBuiltin } from '@flex-development/is-builtin';
-import pathe from '@flex-development/pathe';
-/**
- * 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
- */
-function toUrl(id, parent) {
-    return canParseUrl(id, parent)
-        ? new URL(id, parent ?? undefined)
-        : isBuiltin(id)
-            ? new URL('node:' + String(id))
-            : pathe.pathToFileURL(String(id));
-}
-export default toUrl;
+var o=Object.defineProperty;var n=(r,t)=>o(r,"name",{value:t,configurable:!0});import e from"#lib/can-parse-url";import{isBuiltin as i}from"@flex-development/is-builtin";import f from"@flex-development/pathe";function m(r,t){return e(r,t)?new URL(r,t??void 0):i(r)?new URL("node:"+String(r)):f.pathToFileURL(String(r))}n(m,"toUrl");var a=m;export{a as default};

package/package.json

@@ -1,12 +1,29 @@
 {
   "name": "@flex-development/mlly",
-  "description": "ECMAScript module utilities",
-  "version": "1.0.0-beta.4",
+  "description": "ESM utilities for modern tooling — spec-compliant, developer-friendly, and fully typed",
+  "version": "1.0.0-beta.5",
   "keywords": [
+    "bundle",
+    "cli",
     "ecmascript",
+    "ecmascript-modules",
     "esm",
     "esmodules",
+    "exports",
+    "import",
+    "import.meta.resolve",
+    "imports",
+    "meta",
     "module",
+    "modules",
+    "node",
+    "nodejs",
+    "package-json",
+    "resolution",
+    "resolve",
+    "resolver",
+    "tooling",
+    "transpile",
     "typescript"
   ],
   "license": "BSD-3-Clause",
@@ -42,11 +59,7 @@
       "mlly": "./src/index.mts",
       "default": "./dist/index.mjs"
     },
-    "./package.json": "./package.json",
-    "./*": {
-      "mlly": "./src/lib/*.mts",
-      "default": "./dist/lib/*.mjs"
-    }
+    "./package.json": "./package.json"
   },
   "imports": {
     "#fixtures/tsconfig*.json": {
@@ -110,7 +123,8 @@
     ]
   },
   "scripts": {
-    "build": "yarn clean:build && tsc -p tsconfig.build.json --noEmit false && trash ./dist/{interfaces,types}/*.mjs || exit 0 && trash ./dist/internal/*.d.mts || exit 0",
+    "build": "yarn clean:build && tsc -p tsconfig.build.json --noEmit false && yarn bundle:dts && yarn minify:build",
+    "bundle:dts": "dtsroll --conditions=mlly && trash ./dist/{interfaces,types} && trash ./dist/{internal,lib}/index.d.mts || exit 0",
     "check:ci": "yarn dedupe --check && yarn check:format && yarn check:lint && yarn check:spelling && yarn typecheck && yarn check:types && yarn test:cov && yarn pack && yarn check:types:build && attw package.tgz && yarn clean:pack",
     "check:format": "dprint check --incremental=false",
     "check:lint": "eslint --exit-on-fatal-error --max-warnings 0 .",
@@ -130,6 +144,7 @@
     "fix:dedupe": "yarn dedupe --strategy=highest",
     "fix:format": "dprint fmt",
     "fix:lint": "yarn check:lint --cache --fix",
+    "minify:build": "esbuild dist/**/*.mjs --allow-overwrite --minify --keep-names --outdir=dist --format=esm --out-extension:.js=.mjs --log-level=warning",
     "_postinstall": "[ -f ./.git ] && [ -f ./node_modules/.bin/husky ] && chmod +x .husky/_/* && husky || exit 0",
     "postpack": "toggle-scripts +postinstall",
     "postpublish": "toggle-scripts +prepack",
@@ -182,14 +197,17 @@
     "cross-env": "10.1.0",
     "cspell": "9.6.4",
     "dprint": "0.51.1",
+    "dtsroll": "1.7.6",
     "editorconfig": "3.0.1",
+    "esbuild": "0.27.3",
     "eslint": "9.39.2",
     "growl": "1.10.5",
     "husky": "9.1.7",
     "import-meta-resolve": "4.2.0",
     "is-ci": "4.1.0",
-    "msw": "2.12.9",
+    "msw": "2.12.10",
     "node-notifier": "10.0.1",
+    "pkg-size": "2.4.0",
     "remark": "15.0.1",
     "remark-cli": "12.0.1",
     "remark-lint-maximum-heading-length": "4.1.1",
@@ -198,7 +216,7 @@
     "typescript": "5.9.3",
     "unified": "11.0.5",
     "vfile": "6.0.3",
-    "vite-tsconfig-paths": "6.0.5",
+    "vite-tsconfig-paths": "6.1.0",
     "vitest": "4.0.18"
   },
   "resolutions": {

package/dist/interfaces/aliases.d.mts

@@ -1,21 +0,0 @@
-/**
- * @file Interfaces - Aliases
- * @module mlly/interfaces/Aliases
- */
-/**
- * Record, where each key is a path alias or pattern and each value
- * is a path mapping configuration.
- *
- * This interface can be augmented to register custom aliases.
- *
- * @example
- *  declare module '@flex-development/mlly' {
- *    interface Aliases {
- *      custom?: string[] | string | null
- *    }
- *  }
- */
-interface Aliases {
-    [alias: string]: (string | null | undefined)[] | string | null | undefined;
-}
-export type { Aliases as default };

package/dist/interfaces/buffer-encoding-map.d.mts

@@ -1,29 +0,0 @@
-/**
- * @file Interfaces - BufferEncodingMap
- * @module mlly/interfaces/BufferEncodingMap
- */
-/**
- * Registry of character encodings that can be used when working
- * with {@linkcode Buffer} objects.
- *
- * This interface can be augmented to register custom encodings.
- *
- * @example
- *  declare module '@flex-development/mlly' {
- *    interface BufferEncodingMap {
- *      custom: 'custom'
- *    }
- *  }
- */
-interface BufferEncodingMap {
-    ascii: 'ascii';
-    base64: 'base64';
-    base64url: 'base64url';
-    binary: 'binary';
-    hex: 'hex';
-    latin1: 'latin1';
-    ucs2: 'ucs2' | 'ucs-2';
-    utf16le: 'utf16le' | 'utf-16le';
-    utf8: 'utf8' | 'utf-8';
-}
-export type { BufferEncodingMap as default };

package/dist/interfaces/condition-map.d.mts

@@ -1,24 +0,0 @@
-/**
- * @file Interfaces - ConditionMap
- * @module mlly/interfaces/ConditionMap
- */
-import type * as pkgTypes from '@flex-development/pkg-types';
-/**
- * Registry of export/import conditions.
- *
- * This interface can be augmented to register custom conditions.
- *
- * @see {@linkcode pkgTypes.ConditionMap}
- *
- * @example
- *  declare module '@flex-development/mlly' {
- *    interface ConditionMap {
- *      custom: 'custom'
- *    }
- *  }
- *
- * @extends {pkgTypes.ConditionMap}
- */
-interface ConditionMap extends pkgTypes.ConditionMap {
-}
-export type { ConditionMap as default };

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

@@ -1,29 +0,0 @@
-/**
- * @file Interfaces - FileSystem
- * @module mlly/interfaces/FileSystem
- */
-import type { ReadFile, Realpath, Stat } from '@flex-development/mlly';
-/**
- * The file system API.
- */
-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;
-}
-export type { FileSystem as default };

package/dist/interfaces/get-source-context.d.mts

@@ -1,44 +0,0 @@
-/**
- * @file Interfaces - GetSourceContext
- * @module mlly/interfaces/GetSourceContext
- */
-import type { FileSystem, GetSourceHandlers, GetSourceOptions } from '@flex-development/mlly';
-/**
- * Source code retrieval context.
- *
- * @see {@linkcode GetSourceOptions}
- *
- * @extends {GetSourceOptions}
- */
-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>;
-}
-export type { GetSourceContext as default };

package/dist/interfaces/get-source-options.d.mts

@@ -1,56 +0,0 @@
-/**
- * @file Interfaces - GetSourceOptions
- * @module mlly/interfaces/GetSourceOptions
- */
-import type { BufferEncoding, FileSystem, GetSourceHandlers, List, ModuleFormat } from '@flex-development/mlly';
-/**
- * Options for retrieving source code.
- */
-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;
-}
-export type { GetSourceOptions as default };

package/dist/interfaces/index.d.mts

@@ -1,22 +0,0 @@
-/**
- * @file Entry Point - Interfaces
- * @module mlly/interfaces
- */
-export type { default as Aliases } from '#interfaces/aliases';
-export type { default as BufferEncodingMap } from '#interfaces/buffer-encoding-map';
-export type { default as ConditionMap } from '#interfaces/condition-map';
-export type { default as FileSystem } from '#interfaces/file-system';
-export type { default as GetSourceContext } from '#interfaces/get-source-context';
-export type { default as GetSourceOptions } from '#interfaces/get-source-options';
-export type { default as IsDirectory } from '#interfaces/is-directory';
-export type { default as IsFile } from '#interfaces/is-file';
-export type { default as MainFieldMap } from '#interfaces/main-field-map';
-export type { default as ModuleFormatMap } from '#interfaces/module-format-map';
-export type { default as PatternKeyComparisonMap } from '#interfaces/pattern-key-comparison-map';
-export type { default as ProtocolMap } from '#interfaces/protocol-map';
-export type { default as ReadFile } from '#interfaces/read-file';
-export type { default as Realpath } from '#interfaces/realpath';
-export type { default as ResolveAliasOptions } from '#interfaces/resolve-alias-options';
-export type { default as ResolveModuleOptions } from '#interfaces/resolve-module-options';
-export type { default as Stat } from '#interfaces/stat';
-export type { default as Stats } from '#interfaces/stats';

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

@@ -1,17 +0,0 @@
-/**
- * @file Interfaces - IsDirectory
- * @module mlly/interfaces/IsDirectory
- */
-/**
- * Check if a stats object describes a directory.
- */
-interface IsDirectory {
-    /**
-     * @this {unknown}
-     *
-     * @return {boolean}
-     *  `true` if stats describes directory, `false` otherwise
-     */
-    (): boolean;
-}
-export type { IsDirectory as default };

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

@@ -1,17 +0,0 @@
-/**
- * @file Interfaces - IsFile
- * @module mlly/interfaces/IsFile
- */
-/**
- * Check if a stats object describes a file.
- */
-interface IsFile {
-    /**
-     * @this {void}
-     *
-     * @return {boolean}
-     *  `true` if stats object describes regular file, `false` otherwise
-     */
-    (): boolean;
-}
-export type { IsFile as default };

package/dist/interfaces/main-field-map.d.mts

@@ -1,22 +0,0 @@
-/**
- * @file Interfaces - MainFieldMap
- * @module mlly/interfaces/MainFieldMap
- */
-/**
- * Registry of main fields.
- *
- * This interface can be augmented to register custom main fields.
- *
- * @example
- *  declare module '@flex-development/mlly' {
- *    interface MainFieldMap {
- *      unpkg: 'unpkg'
- *    }
- *  }
- */
-interface MainFieldMap {
-    main: 'main';
-    module: 'module';
-    types: 'types';
-}
-export type { MainFieldMap as default };

package/dist/interfaces/module-format-map.d.mts

@@ -1,26 +0,0 @@
-/**
- * @file Interfaces - ModuleFormatMap
- * @module mlly/interfaces/ModuleFormatMap
- */
-/**
- * Registry of module formats.
- *
- * This interface can be augmented to register custom module formats.
- *
- * @example
- *  declare module '@flex-development/mlly' {
- *    interface ModuleFormatMap {
- *      custom: 'custom'
- *    }
- *  }
- */
-interface ModuleFormatMap {
-    builtin: 'builtin';
-    commonjs: 'commonjs';
-    cts: 'commonjs-typescript';
-    json: 'json';
-    module: 'module';
-    mts: 'module-typescript';
-    wasm: 'wasm';
-}
-export type { ModuleFormatMap as default };

package/dist/interfaces/pattern-key-comparison-map.d.mts

@@ -1,31 +0,0 @@
-/**
- * @file Interfaces - PatternKeyComparisonMap
- * @module mlly/interfaces/PatternKeyComparisonMap
- */
-/**
- * Registry of `PATTERN_KEY_COMPARE` algorithm results.
- *
- * This interface can be augmented to register custom results.
- *
- * @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;
-}
-export type { PatternKeyComparisonMap as default };

package/dist/interfaces/protocol-map.d.mts

@@ -1,44 +0,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:';
-}
-export type { ProtocolMap as default };

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

@@ -1,42 +0,0 @@
-/**
- * @file Interfaces - ReadFile
- * @module mlly/interfaces/ReadFile
- */
-import type { Awaitable, BufferEncoding, FileContent, ModuleId } from '@flex-development/mlly';
-/**
- * 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;
-}
-export type { ReadFile as default };

package/dist/interfaces/realpath.d.mts

@@ -1,29 +0,0 @@
-/**
- * @file Interfaces - Realpath
- * @module mlly/interfaces/Realpath
- */
-import type { Awaitable, ModuleId } from '@flex-development/mlly';
-/**
- * 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;
-}
-export type { Realpath as default };