@flex-development/mlly 1.0.0-alpha.1 → 1.0.0-alpha.11

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

@@ -0,0 +1,13 @@
+/**
+ * @file Internal - isDirectory
+ * @module mlly/internal/isDirectory
+ */
+import type { ModuleId } from '../types/index.mjs';
+/**
+ * Checks if a directory exists at the given module `id`.
+ *
+ * @param {ModuleId} id - Module id to evaluate
+ * @return {boolean} `true` if directory exists at `id`
+ */
+declare const isDirectory: (id: ModuleId) => boolean;
+export default isDirectory;

package/dist/internal/is-directory.mjs

@@ -0,0 +1,16 @@
+import fs from "node:fs";
+import validateURLString from "./validate-url-string.mjs";
+const isDirectory = (id) => {
+  var _a;
+  try {
+    validateURLString(id, "id");
+    return ((_a = fs.statSync(id, { throwIfNoEntry: false })) == null ? void 0 : _a.isDirectory()) ?? false;
+  } catch {
+    return false;
+  }
+};
+var is_directory_default = isDirectory;
+export {
+  is_directory_default as default
+};
+//# sourceMappingURL=is-directory.mjs.map

package/dist/internal/is-directory.mjs.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../src/internal/is-directory.ts"],
+  "mappings": "AAMA,OAAO,QAAQ;AACf,OAAO,uBAAuB;AAQ9B,MAAM,cAAc,CAAC,OAA0B;AAf/C;AAgBE,MAAI;AACF,sBAAkB,IAAI,IAAI;AAC1B,aAAO,QAAG,SAAS,IAAI,EAAE,gBAAgB,MAAM,CAAC,MAAzC,mBAA4C,kBAAiB;AAAA,EACtE,QAAE;AACA,WAAO;AAAA,EACT;AACF;AAEA,IAAO,uBAAQ;",
+  "names": []
+}

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

@@ -0,0 +1,13 @@
+/**
+ * @file Internal - isFile
+ * @module mlly/internal/isFile
+ */
+import type { ModuleId } from '../types/index.mjs';
+/**
+ * Checks if a file exists at the given module `id`.
+ *
+ * @param {ModuleId} id - Module id to evaluate
+ * @return {boolean} `true` if file exists at `id`
+ */
+declare const isFile: (id: ModuleId) => boolean;
+export default isFile;

package/dist/internal/is-file.mjs

@@ -0,0 +1,16 @@
+import fs from "node:fs";
+import validateURLString from "./validate-url-string.mjs";
+const isFile = (id) => {
+  var _a;
+  try {
+    validateURLString(id, "id");
+    return ((_a = fs.statSync(id, { throwIfNoEntry: false })) == null ? void 0 : _a.isFile()) ?? false;
+  } catch {
+    return false;
+  }
+};
+var is_file_default = isFile;
+export {
+  is_file_default as default
+};
+//# sourceMappingURL=is-file.mjs.map

package/dist/internal/is-file.mjs.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../src/internal/is-file.ts"],
+  "mappings": "AAMA,OAAO,QAAQ;AACf,OAAO,uBAAuB;AAQ9B,MAAM,SAAS,CAAC,OAA0B;AAf1C;AAgBE,MAAI;AACF,sBAAkB,IAAI,IAAI;AAC1B,aAAO,QAAG,SAAS,IAAI,EAAE,gBAAgB,MAAM,CAAC,MAAzC,mBAA4C,aAAY;AAAA,EACjE,QAAE;AACA,WAAO;AAAA,EACT;AACF;AAEA,IAAO,kBAAQ;",
+  "names": []
+}

package/dist/internal/is-function.d.mts

@@ -0,0 +1,12 @@
+/**
+ * @file Internal - isFunction
+ * @module mlly/internal/isFunction
+ */
+/**
+ * Checks if the given `value` is a function.
+ *
+ * @param {unknown} value - Value to check
+ * @return {value is (...args: any[]) => any} `true` if `value` is a unction
+ */
+declare const isFunction: (value: unknown) => value is (...args: any[]) => any;
+export default isFunction;

package/dist/internal/is-function.mjs

@@ -0,0 +1,8 @@
+const isFunction = (value) => {
+  return typeof value === "function";
+};
+var is_function_default = isFunction;
+export {
+  is_function_default as default
+};
+//# sourceMappingURL=is-function.mjs.map

package/dist/internal/is-function.mjs.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../src/internal/is-function.ts"],
+  "mappings": "AAWA,MAAM,aAAa,CAAC,UAAqD;AACvE,SAAO,OAAO,UAAU;AAC1B;AAEA,IAAO,sBAAQ;",
+  "names": []
+}

package/dist/internal/regex-encoded-sep.d.mts

@@ -0,0 +1,13 @@
+/**
+ * @file Internal - ENCODED_SEP_REGEX
+ * @module mlly/internal/ENCODED_SEP_REGEX
+ */
+/**
+ * Regex pattern matching encoded path separators (e.g `/`, `\\`).
+ *
+ * @see https://regex101.com/r/XV7HzM
+ *
+ * @const {RegExp} ENCODED_SEP_REGEX
+ */
+declare const ENCODED_SEP_REGEX: RegExp;
+export default ENCODED_SEP_REGEX;

package/dist/internal/regex-encoded-sep.mjs

@@ -0,0 +1,6 @@
+const ENCODED_SEP_REGEX = /%2f|%5c/i;
+var regex_encoded_sep_default = ENCODED_SEP_REGEX;
+export {
+  regex_encoded_sep_default as default
+};
+//# sourceMappingURL=regex-encoded-sep.mjs.map

package/dist/internal/regex-encoded-sep.mjs.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../src/internal/regex-encoded-sep.ts"],
+  "mappings": "AAYA,MAAM,oBAA4B;AAElC,IAAO,4BAAQ;",
+  "names": []
+}

package/dist/internal/regex-internal-specifier.d.mts

@@ -0,0 +1,14 @@
+/**
+ * @file Internal - INTERNAL_SPECIFIER_REGEX
+ * @module mlly/internal/INTERNAL_SPECIFIER_REGEX
+ */
+/**
+ * Regex pattern matching subpath imports.
+ *
+ * @see https://regex101.com/r/ppVRw7
+ * @see https://nodejs.org/api/packages.html#subpath-imports
+ *
+ * @const {RegExp} INTERNAL_SPECIFIER_REGEX
+ */
+declare const INTERNAL_SPECIFIER_REGEX: RegExp;
+export default INTERNAL_SPECIFIER_REGEX;

package/dist/internal/regex-internal-specifier.mjs

@@ -0,0 +1,6 @@
+const INTERNAL_SPECIFIER_REGEX = /^(?!.*(?:%2[Ff]|%5[Cc]))(?<root>#[^\s/]+?(?=\s|$|\/))(?<path>\/.+[^/](?=\s|$))?(?!\/)/;
+var regex_internal_specifier_default = INTERNAL_SPECIFIER_REGEX;
+export {
+  regex_internal_specifier_default as default
+};
+//# sourceMappingURL=regex-internal-specifier.mjs.map

package/dist/internal/regex-internal-specifier.mjs.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../src/internal/regex-internal-specifier.ts"],
+  "mappings": "AAaA,MAAM,2BACJ;AAEF,IAAO,mCAAQ;",
+  "names": []
+}

package/dist/internal/regex-package-name.d.mts

@@ -0,0 +1,13 @@
+/**
+ * @file Internal - PACKAGE_NAME_REGEX
+ * @module mlly/internal/PACKAGE_NAME_REGEX
+ */
+/**
+ * Regex pattern matching package names.
+ *
+ * @see https://regex101.com/r/BHcJfc
+ *
+ * @const {RegExp} PACKAGE_NAME_REGEX
+ */
+declare const PACKAGE_NAME_REGEX: RegExp;
+export default PACKAGE_NAME_REGEX;

package/dist/internal/regex-package-name.mjs

@@ -0,0 +1,6 @@
+const PACKAGE_NAME_REGEX = /^(?:(?<scope>@[\d*a-z~-][\w*.~-]*)\/)?[\da-z~-][\w.~-]*$/;
+var regex_package_name_default = PACKAGE_NAME_REGEX;
+export {
+  regex_package_name_default as default
+};
+//# sourceMappingURL=regex-package-name.mjs.map

package/dist/internal/regex-package-name.mjs.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../src/internal/regex-package-name.ts"],
+  "mappings": "AAYA,MAAM,qBACJ;AAEF,IAAO,6BAAQ;",
+  "names": []
+}

package/dist/internal/regex-package-path.d.mts

@@ -0,0 +1,15 @@
+/**
+ * @file Internal - PACKAGE_PATH_REGEX
+ * @module mlly/internal/PACKAGE_PATH_REGEX
+ */
+/**
+ * Regex pattern matching bare specifiers beginning with valid package names.
+ *
+ * **Note**: Does **not** match specifiers beginning with `'node_modules'`.
+ *
+ * @see https://regex101.com/r/z0MPgj
+ *
+ * @const {RegExp} PACKAGE_PATH_REGEX
+ */
+declare const PACKAGE_PATH_REGEX: RegExp;
+export default PACKAGE_PATH_REGEX;

package/dist/internal/regex-package-path.mjs

@@ -0,0 +1,6 @@
+const PACKAGE_PATH_REGEX = /^(?!\S+:|node_modules)(?<pkg>(?:(?:(?<scope>@[\d*a-z~-][\w*.~-]*)\/)?[\da-z~-][\w.~-]*))@?(?<version_prefix>v)?(?<version>(?:(?:0|[1-9]\d*)\.){2}(?:0|[1-9]\d*)(?:-(?:0|[1-9]\d*|\d*[a-z-][\da-z-]*)(?:\.(?:0|[1-9]\d*|\d*[a-z-][\da-z-]*))*)?(?:\+[\da-z-]+(?:\.[\da-z-]+)*)?)?(?<subpath>\/.*)?(?<!.*(?:%2[Ff]|%5[Cc]))/;
+var regex_package_path_default = PACKAGE_PATH_REGEX;
+export {
+  regex_package_path_default as default
+};
+//# sourceMappingURL=regex-package-path.mjs.map

package/dist/internal/regex-package-path.mjs.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../src/internal/regex-package-path.ts"],
+  "mappings": "AAcA,MAAM,qBACJ;AAEF,IAAO,6BAAQ;",
+  "names": []
+}

package/dist/internal/resolver.d.mts

@@ -0,0 +1,130 @@
+/**
+ * @file Internal - Resolver
+ * @module mlly/internal/Resolver
+ */
+/// <reference types="node" />
+import type { ModuleId } from '../types/index.mjs';
+import type { Exports, PackageJson } from '@flex-development/pkg-types';
+import { type Nullable } from '@flex-development/tutils';
+import { URL } from 'node:url';
+/**
+ * ECMAScript (ES) module resolver.
+ *
+ * @see https://nodejs.org/api/esm.html#resolver-algorithm
+ *
+ * @class
+ */
+declare class Resolver {
+    /**
+     * Resolves `specifier` according to the [ESM Resolver algorithm][1].
+     *
+     * [1]: https://nodejs.org/api/esm.html#esm_resolver_algorithm
+     *
+     * @public
+     *
+     * @param {string} specifier - Module specifier to resolve
+     * @param {ModuleId} parent - URL of module to resolve from
+     * @param {string?} [condition='default'] - Export condition to apply
+     * @param {Set<string>?} [conditions=CONDITIONS] - Export conditions
+     * @param {boolean?} [preserveSymlinks=false] - Skip resolving symlinks
+     * @return {URL} Resolved module URL
+     * @throws {NodeError}
+     */
+    resolveModule(specifier: string, parent: ModuleId, condition?: string, conditions?: Set<string>, preserveSymlinks?: boolean): URL;
+    /**
+     * Resolves a package path using a combination of the following algorithms:
+     *
+     * - `PACKAGE_RESOLVE`
+     * - `PACKAGE_SELF_RESOLVE`
+     *
+     * @see https://nodejs.org/api/esm.html#resolver-algorithm-specification
+     *
+     * @public
+     *
+     * @param {string} specifier - Module specifier to resolve
+     * @param {ModuleId} parent - URL of module to resolve from
+     * @param {string?} [condition='default'] - Export condition to apply
+     * @param {Set<string>?} [conditions=CONDITIONS] - Export conditions
+     * @return {URL} Resolved package path URL
+     * @throws {NodeError}
+     */
+    resolvePackage(specifier: string, parent: ModuleId, condition?: string, conditions?: Set<string>): URL;
+    /**
+     * Resolves a subpath export according to the `PACKAGE_EXPORTS_RESOLVE`
+     * algorithm.
+     *
+     * @see https://nodejs.org/api/esm.html#resolver-algorithm-specification
+     * @see https://nodejs.org/api/packages.html#subpath-exports
+     *
+     * @public
+     *
+     * @param {string} specifier - Module specifier containing subpath
+     * @param {ModuleId} pkg - URL of relevant `package.json` file
+     * @param {ModuleId} parent - URL of module to resolve from
+     * @param {string?} [condition='default'] - Export condition to apply
+     * @param {Set<string>?} [conditions=CONDITIONS] - Export conditions
+     * @return {URL} Resolved package export URL
+     * @throws {NodeError<Error | TypeError>}
+     */
+    resolvePackageExport(specifier: string, pkg: ModuleId, parent: ModuleId, condition?: string, conditions?: Set<string>): URL;
+    /**
+     * Resolves a subpath import according to the `PACKAGE_IMPORTS_RESOLVE`
+     * algorithm.
+     *
+     * @see https://nodejs.org/api/esm.html#resolver-algorithm-specification
+     * @see https://nodejs.org/api/packages.html#subpath-imports
+     *
+     * @public
+     *
+     * @param {string} specifier - Module specifier containing subpath
+     * @param {ModuleId} parent - URL of module to resolve from
+     * @param {string?} [condition='default'] - Export condition to apply
+     * @param {Set<string>?} [conditions=CONDITIONS] - Export conditions
+     * @return {URL} Resolved package import URL
+     * @throws {NodeError<Error | TypeError>}
+     */
+    resolvePackageImport(specifier: string, parent: ModuleId, condition?: string, conditions?: Set<string>): URL;
+    /**
+     * Resolves a package entry point using the legacy CommonJS `main` resolution
+     * alogirthm:
+     *
+     * 1. let M = pkgdir `pkgjson.main`
+     * 2. TRY(M, M.js, M.json, M.node, M/index.js, M/index.json, M/index.node)
+     * 4. TRY(pkgdir/index.js, pkgdir/index.json, pkgdir/index.node)
+     * 5. ERR_MODULE_NOT_FOUND
+     *
+     * @todo emit deprecation messages
+     *
+     * @public
+     *
+     * @param {ModuleId} pkg - URL of relevant `package.json` file
+     * @param {PackageJson} pkgjson - Relevant `package.json` object
+     * @param {ModuleId} parent - URL of module to resolve from
+     * @return {URL} Package entry point URL
+     * @throws {NodeError} If package entry point is not found
+     */
+    resolvePackageMain(pkg: ModuleId, pkgjson: PackageJson, parent: ModuleId): URL;
+    /**
+     * Resolves a package target according to the `PACKAGE_TARGET_RESOLVE`
+     * algorithm.
+     *
+     * @see https://nodejs.org/api/esm.html#resolver-algorithm-specification
+     *
+     * @todo emit deprecation messages
+     *
+     * @public
+     *
+     * @param {ModuleId} dir - URL of directory containing relevant `package.json`
+     * @param {Exports | undefined} target - Package `exports` or `imports` target
+     * @param {string} subpath - Package subpath without entry prefix (`key`)
+     * @param {string} key - Subpath defined in relevant `package.json` file
+     * @param {ModuleId} parent - URL of module to resolve from
+     * @param {boolean?} [internal=false] - Package `imports` hint
+     * @param {string?} [condition='default'] - Export condition to apply
+     * @param {Set<string>?} [conditions=CONDITIONS] - Export conditions
+     * @return {Nullable<URL>} Resolved package target URL or `null`
+     * @throws {NodeError<Error | TypeError>}
+     */
+    resolvePackageTarget(dir: ModuleId, target: Exports | undefined, subpath: string, key: string, parent: ModuleId, internal?: boolean, condition?: string, conditions?: Set<string>): Nullable<URL>;
+}
+export default Resolver;