@flex-development/mlly 1.0.0-alpha.9 → 1.0.0-beta.2

package/dist/internal/chars.mjs

@@ -0,0 +1,17 @@
+/**
+ * @file Internal - chars
+ * @module mlly/internal/chars
+ */
+/**
+ * Characters that may have special meaning.
+ *
+ * @enum {string}
+ */
+var chars;
+(function (chars) {
+    chars["asterisk"] = "*";
+    chars["at"] = "@";
+    chars["empty"] = "";
+    chars["hash"] = "#";
+})(chars || (chars = {}));
+export default chars;

package/dist/internal/check-invalid-segments.mjs

@@ -0,0 +1,49 @@
+/**
+ * @file Internal - checkInvalidSegments
+ * @module mlly/internal/checkInvalidSegments
+ */
+import chars from '#internal/chars';
+/**
+ * Check `str` for invalid path segments.
+ *
+ * @internal
+ *
+ * @this {void}
+ *
+ * @param {string} str
+ *  The package target or subpath pattern match to check
+ * @return {boolean}
+ *  `true` if `str` contains invalid path segments, `false` otherwise
+ */
+function checkInvalidSegments(str) {
+    /**
+     * The regular expression matching path separators.
+     *
+     * @const {RegExp} separator
+     */
+    const separator = /\/|\\/;
+    /**
+     * The list of path segments.
+     *
+     * @const {string[]} segments
+     */
+    const segments = str.startsWith('./')
+        ? str.slice(2).split(separator)
+        : str.split(separator);
+    /**
+     * The list of regular expressions matching invalid segments.
+     *
+     * @const {RegExp[]} checks
+     */
+    const checks = [
+        /^(\.|%2e)(\.|%2e)?/i,
+        /^(n|%6e|%4e)(o|%6f|%4f)(d|%64|%44)(e|%65|%45)(_|%5f)(m|%6d|%4d)(o|%6f|%4f)(d|%64|%44)(u|%75|%55)(l|%6c|%4c)(e|%65|%45)(s|%73|%53)/i
+    ];
+    for (const segment of segments) {
+        if (segment === chars.empty || checks.some(check => check.test(segment))) {
+            return true;
+        }
+    }
+    return false;
+}
+export default checkInvalidSegments;

package/dist/internal/constant.mjs

@@ -0,0 +1,23 @@
+/**
+ * @file Internal - constant
+ * @module mlly/internal/constant
+ */
+/**
+ * Create a function that returns a constant value.
+ *
+ * @internal
+ *
+ * @template {unknown} T
+ *  The value
+ *
+ * @this {void}
+ *
+ * @param {T} value
+ *  The value
+ * @return {(this: void) => T}
+ *  `value`
+ */
+function constant(value) {
+    return () => value;
+}
+export default constant;

package/dist/internal/fs.browser.mjs

@@ -0,0 +1,42 @@
+/**
+ * @file Internal - fs/browser
+ * @module mlly/internal/fs/browser
+ */
+/**
+ * The file system API.
+ *
+ * @const {FileSystem} fs
+ */
+const fs = {
+    /**
+     * Get the contents of a file.
+     *
+     * @return {never}
+     *  Never; not implemented
+     * @throws {Error}
+     */
+    readFile() {
+        throw new Error('[readFile] not implemented');
+    },
+    /**
+     * Get the resolved pathname of a file.
+     *
+     * @return {never}
+     *  Never; not implemented
+     * @throws {Error}
+     */
+    realpath() {
+        throw new Error('[realpathSync] not implemented');
+    },
+    /**
+     * Get information about a file.
+     *
+     * @return {never}
+     *  Never; not implemented
+     * @throws {Error}
+     */
+    stat() {
+        throw new Error('[stat] not implemented');
+    }
+};
+export default fs;

package/dist/internal/fs.node.mjs

@@ -0,0 +1,16 @@
+/**
+ * @file Internal - fs/node
+ * @module mlly/internal/fs/node
+ */
+import nfs from 'node:fs';
+/**
+ * The file system API.
+ *
+ * @const {FileSystem} fs
+ */
+const fs = {
+    readFile: nfs.readFileSync,
+    realpath: nfs.realpathSync,
+    stat: nfs.statSync
+};
+export default fs;

package/dist/internal/identity.mjs

@@ -0,0 +1,23 @@
+/**
+ * @file Internal - identity
+ * @module mlly/internal/identity
+ */
+/**
+ * Return a constant value.
+ *
+ * @internal
+ *
+ * @template {unknown} T
+ *  The value
+ *
+ * @this {void}
+ *
+ * @param {T} value
+ *  The value
+ * @return {T}
+ *  `value`
+ */
+function identity(value) {
+    return value;
+}
+export default identity;

package/dist/internal/invalid-package-target.mjs

@@ -0,0 +1,36 @@
+/**
+ * @file Internal - invalidPackageTarget
+ * @module mlly/internal/invalidPackageTarget
+ */
+import chars from '#internal/chars';
+import { ERR_INVALID_PACKAGE_TARGET } from '@flex-development/errnode';
+import { fileURLToPath } from '@flex-development/pathe';
+/**
+ * Create an {@linkcode ERR_INVALID_PACKAGE_TARGET} error.
+ *
+ * @see {@linkcode ErrInvalidPackageTarget}
+ * @see {@linkcode ModuleId}
+ *
+ * @internal
+ *
+ * @this {void}
+ *
+ * @param {ModuleId} packageUrl
+ *  The URL of the directory containing the `package.json` file
+ * @param {string} subpath
+ *  The subpath pattern
+ * @param {unknown} target
+ *  The invalid package target
+ * @param {boolean | null | undefined} [isImports]
+ *  Whether `target` is internal to the package
+ * @param {ModuleId | null | undefined} [parent]
+ *  The URL of the parent module
+ * @return {ErrInvalidPackageTarget}
+ *  New node error
+ */
+function invalidPackageTarget(packageUrl, subpath, target, isImports, parent) {
+    return new ERR_INVALID_PACKAGE_TARGET(fileURLToPath(packageUrl), subpath, typeof target === 'object' && target !== null
+        ? JSON.stringify(target, null, '')
+        : String(target) + (typeof target === 'bigint' ? 'n' : chars.empty), isImports, parent && fileURLToPath(parent));
+}
+export default invalidPackageTarget;

package/dist/internal/invalid-subpath.mjs

@@ -0,0 +1,37 @@
+/**
+ * @file Internal - invalidSubpath
+ * @module mlly/internal/invalidSubpath
+ */
+import chars from '#internal/chars';
+import { ERR_INVALID_MODULE_SPECIFIER } from '@flex-development/errnode';
+import pathe from '@flex-development/pathe';
+/**
+ * Create an {@linkcode ERR_INVALID_MODULE_SPECIFIER} error for an invalid
+ * subpath pattern match.
+ *
+ * @see {@linkcode ErrInvalidModuleSpecifier}
+ * @see {@linkcode ModuleId}
+ *
+ * @internal
+ *
+ * @this {void}
+ *
+ * @param {string} subpath
+ *  The subpath pattern
+ * @param {string} patternMatch
+ *  The subpath pattern match
+ * @param {ModuleId} packageUrl
+ *  The URL of the directory containing the `package.json` file
+ * @param {boolean | null | undefined} [isImports]
+ *  Whether `target` is internal to the package
+ * @param {ModuleId | null | undefined} [parent]
+ *  The URL of the parent module
+ * @return {ErrInvalidModuleSpecifier}
+ *  New node error
+ */
+function invalidSubpath(subpath, patternMatch, packageUrl, isImports, parent) {
+    return new ERR_INVALID_MODULE_SPECIFIER(subpath.replace(chars.asterisk, () => patternMatch), `request is not a valid match in pattern "${subpath}" for the ` +
+        `"${isImports ? 'imports' : 'exports'}" resolution of ` +
+        `${pathe.fileURLToPath(new URL('package.json', packageUrl))}`, parent && pathe.fileURLToPath(parent));
+}
+export default invalidSubpath;

package/dist/internal/is-promise.mjs

@@ -0,0 +1,26 @@
+/**
+ * @file Internal - isPromise
+ * @module mlly/internal/isPromise
+ */
+/**
+ * Check if `value` is a {@linkcode PromiseLike} object.
+ *
+ * @internal
+ *
+ * @template {any} T
+ *  The resolved value of the promise
+ *
+ * @this {void}
+ *
+ * @param {unknown} value
+ *  The thing to check
+ * @return {value is PromiseLike<T>}
+ *  `true` if `value` is {@linkcode PromiseLike}, `false` otherwise
+ */
+function isPromise(value) {
+    return (typeof value === 'object' &&
+        value !== null &&
+        'then' in value &&
+        typeof value.then === 'function');
+}
+export default isPromise;

package/dist/internal/process.browser.mjs

@@ -0,0 +1,8 @@
+/**
+ * @file Internal - process/browser
+ * @module mlly/internal/process/browser
+ */
+export default {
+    browser: true,
+    platform: 'browser'
+};

package/dist/lib/can-parse-url.d.mts

@@ -0,0 +1,23 @@
+/**
+ * @file canParseUrl
+ * @module mlly/lib/canParseUrl
+ */
+/**
+ * Check if `input` can be parsed to a {@linkcode URL}.
+ *
+ * > 👉 **Note**: If `input` is relative, `base` is required.
+ * > If `input` is absolute, `base` is ignored.
+ *
+ * @see {@linkcode ModuleId}
+ *
+ * @this {void}
+ *
+ * @param {unknown} input
+ *  The input URL
+ * @param {unknown} [base]
+ *  The base URL to resolve against if `input` is not absolute
+ * @return {boolean}
+ *  `true` if `input` can be parsed to a `URL`, `false` otherwise
+ */
+declare function canParseUrl(this: void, input: unknown, base?: unknown): boolean;
+export default canParseUrl;

package/dist/lib/can-parse-url.mjs

@@ -0,0 +1,31 @@
+/**
+ * @file canParseUrl
+ * @module mlly/lib/canParseUrl
+ */
+/**
+ * Check if `input` can be parsed to a {@linkcode URL}.
+ *
+ * > 👉 **Note**: If `input` is relative, `base` is required.
+ * > If `input` is absolute, `base` is ignored.
+ *
+ * @see {@linkcode ModuleId}
+ *
+ * @this {void}
+ *
+ * @param {unknown} input
+ *  The input URL
+ * @param {unknown} [base]
+ *  The base URL to resolve against if `input` is not absolute
+ * @return {boolean}
+ *  `true` if `input` can be parsed to a `URL`, `false` otherwise
+ */
+function canParseUrl(input, base) {
+    try {
+        new URL(input, (base ?? undefined));
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export default canParseUrl;

package/dist/lib/cwd.d.mts

@@ -0,0 +1,14 @@
+/**
+ * @file cwd
+ * @module mlly/lib/cwd
+ */
+/**
+ * Get the URL of the current working directory.
+ *
+ * @this {void}
+ *
+ * @return {URL}
+ *  The current working directory URL
+ */
+declare function cwd(this: void): URL;
+export default cwd;

package/dist/lib/cwd.mjs

@@ -0,0 +1,17 @@
+/**
+ * @file cwd
+ * @module mlly/lib/cwd
+ */
+import pathe from '@flex-development/pathe';
+/**
+ * Get the URL of the current working directory.
+ *
+ * @this {void}
+ *
+ * @return {URL}
+ *  The current working directory URL
+ */
+function cwd() {
+    return pathe.pathToFileURL(pathe.cwd() + pathe.sep);
+}
+export default cwd;

package/dist/lib/default-conditions.d.mts

@@ -0,0 +1,15 @@
+/**
+ * @file defaultConditions
+ * @module mlly/lib/defaultConditions
+ */
+import type { Condition } from '@flex-development/mlly';
+/**
+ * The default list of conditions.
+ *
+ * @see {@linkcode Condition}
+ * @see https://nodejs.org/api/packages.html#conditional-exports
+ *
+ * @const {Set<Condition>} defaultConditions
+ */
+declare const defaultConditions: Set<Condition>;
+export default defaultConditions;

package/dist/lib/default-conditions.mjs

@@ -0,0 +1,14 @@
+/**
+ * @file defaultConditions
+ * @module mlly/lib/defaultConditions
+ */
+/**
+ * The default list of conditions.
+ *
+ * @see {@linkcode Condition}
+ * @see https://nodejs.org/api/packages.html#conditional-exports
+ *
+ * @const {Set<Condition>} defaultConditions
+ */
+const defaultConditions = new Set(['node', 'import']);
+export default defaultConditions;

package/dist/lib/default-extensions.d.mts

@@ -0,0 +1,14 @@
+/**
+ * @file defaultExtensions
+ * @module mlly/lib/defaultExtensions
+ */
+import type { Ext } from '@flex-development/mlly';
+/**
+ * The default list of resolvable file extensions.
+ *
+ * @see {@linkcode Ext}
+ *
+ * @const {Set<Ext>} defaultExtensions
+ */
+declare const defaultExtensions: Set<Ext>;
+export default defaultExtensions;

package/dist/lib/default-extensions.mjs

@@ -0,0 +1,29 @@
+/**
+ * @file defaultExtensions
+ * @module mlly/lib/defaultExtensions
+ */
+/**
+ * The default list of resolvable file extensions.
+ *
+ * @see {@linkcode Ext}
+ *
+ * @const {Set<Ext>} defaultExtensions
+ */
+const defaultExtensions = new Set([
+    '.mjs',
+    '.mts',
+    '.cjs',
+    '.cts',
+    '.js',
+    '.ts',
+    '.jsx',
+    '.tsx',
+    '.css',
+    '.json',
+    '.node',
+    '.wasm',
+    '.d.mts',
+    '.d.cts',
+    '.d.ts'
+]);
+export default defaultExtensions;

package/dist/lib/default-main-fields.d.mts

@@ -0,0 +1,14 @@
+/**
+ * @file defaultMainFields
+ * @module mlly/lib/defaultMainFields
+ */
+import type { MainField } from '@flex-development/mlly';
+/**
+ * The default list of main fields.
+ *
+ * @see {@linkcode MainField}
+ *
+ * @const {Set<MainField>} defaultMainFields
+ */
+declare const defaultMainFields: Set<MainField>;
+export default defaultMainFields;

package/dist/lib/default-main-fields.mjs

@@ -0,0 +1,13 @@
+/**
+ * @file defaultMainFields
+ * @module mlly/lib/defaultMainFields
+ */
+/**
+ * The default list of main fields.
+ *
+ * @see {@linkcode MainField}
+ *
+ * @const {Set<MainField>} defaultMainFields
+ */
+const defaultMainFields = new Set(['main']);
+export default defaultMainFields;

package/dist/lib/extension-format-map.d.mts

@@ -0,0 +1,16 @@
+/**
+ * @file extensionFormatMap
+ * @module mlly/lib/extensionFormatMap
+ */
+import type { Ext, ModuleFormat } from '@flex-development/mlly';
+/**
+ * Map, where each key is a file extension
+ * and each value is a default module format.
+ *
+ * @see {@linkcode Ext}
+ * @see {@linkcode ModuleFormat}
+ *
+ * @const {Map<Ext, ModuleFormat>} extensionFormatMap
+ */
+declare const extensionFormatMap: Map<Ext, ModuleFormat>;
+export default extensionFormatMap;

package/dist/lib/extension-format-map.mjs

@@ -0,0 +1,31 @@
+/**
+ * @file extensionFormatMap
+ * @module mlly/lib/extensionFormatMap
+ */
+import formats from '#lib/formats';
+/**
+ * Map, where each key is a file extension
+ * and each value is a default module format.
+ *
+ * @see {@linkcode Ext}
+ * @see {@linkcode ModuleFormat}
+ *
+ * @const {Map<Ext, ModuleFormat>} extensionFormatMap
+ */
+const extensionFormatMap = new Map([
+    ['.cjs', formats.commonjs],
+    ['.cts', formats.cts],
+    ['.d.cts', formats.cts],
+    ['.d.mts', formats.mts],
+    ['.d.ts', formats.mts],
+    ['.js', formats.module],
+    ['.json', formats.json],
+    ['.jsx', formats.module],
+    ['.mjs', formats.module],
+    ['.mts', formats.mts],
+    ['.node', formats.commonjs],
+    ['.ts', formats.mts],
+    ['.tsx', formats.mts],
+    ['.wasm', formats.wasm]
+]);
+export default extensionFormatMap;

package/dist/lib/formats.d.mts

@@ -0,0 +1,21 @@
+/**
+ * @file formats
+ * @module mlly/lib/formats
+ */
+/**
+ * Default module formats.
+ *
+ * @see {@linkcode ModuleFormat}
+ *
+ * @enum {ModuleFormat}
+ */
+declare const enum formats {
+    builtin = "builtin",
+    commonjs = "commonjs",
+    cts = "commonjs-typescript",
+    json = "json",
+    module = "module",
+    mts = "module-typescript",
+    wasm = "wasm"
+}
+export default formats;

package/dist/lib/formats.mjs

@@ -0,0 +1,22 @@
+/**
+ * @file formats
+ * @module mlly/lib/formats
+ */
+/**
+ * Default module formats.
+ *
+ * @see {@linkcode ModuleFormat}
+ *
+ * @enum {ModuleFormat}
+ */
+var formats;
+(function (formats) {
+    formats["builtin"] = "builtin";
+    formats["commonjs"] = "commonjs";
+    formats["cts"] = "commonjs-typescript";
+    formats["json"] = "json";
+    formats["module"] = "module";
+    formats["mts"] = "module-typescript";
+    formats["wasm"] = "wasm";
+})(formats || (formats = {}));
+export default formats;

package/dist/lib/get-source.d.mts

@@ -0,0 +1,46 @@
+/**
+ * @file getSource
+ * @module mlly/lib/getSource
+ */
+import type { Awaitable, EmptyString, GetSourceOptions, ModuleId } from '@flex-development/mlly';
+export default getSource;
+/**
+ * Get the source code for a module.
+ *
+ * @see {@linkcode EmptyString}
+ * @see {@linkcode GetSourceOptions}
+ *
+ * @this {void}
+ *
+ * @param {EmptyString | null | undefined} id
+ *  The module id
+ * @param {GetSourceOptions | null | undefined} [options]
+ *  Source code retrieval options
+ * @return {null}
+ *  The module source code
+ */
+declare function getSource(this: void, id: EmptyString | null | undefined, options?: GetSourceOptions | null | undefined): null;
+/**
+ * Get the source code for a module.
+ *
+ * > 👉 **Note**: Returns a promise if the handler for `id` is async.
+ *
+ * @see {@linkcode Awaitable}
+ * @see {@linkcode ErrUnsupportedEsmUrlScheme}
+ * @see {@linkcode GetSourceOptions}
+ * @see {@linkcode ModuleId}
+ *
+ * @template {Awaitable<string | null | undefined>} T
+ *  The module source code
+ *
+ * @this {void}
+ *
+ * @param {ModuleId | null | undefined} id
+ *  The module id
+ * @param {GetSourceOptions | null | undefined} [options]
+ *  Source code retrieval options
+ * @return {T}
+ *  The module source code
+ * @throws {ErrUnsupportedEsmUrlScheme}
+ */
+declare function getSource<T extends Awaitable<string | null | undefined>>(this: void, id: ModuleId | null | undefined, options?: GetSourceOptions | null | undefined): T;