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

package/dist/utils/find-exports.mjs

@@ -0,0 +1,95 @@
+import {
+  SpecifierSyntaxKind,
+  StatementKind,
+  StatementSyntaxKind
+} from "../enums/index.mjs";
+import getSpecifierKind from "../internal/get-specifier-kind.mjs";
+import validateString from "../internal/validate-string.mjs";
+import {
+  EXPORT_AGGREGATE_REGEX,
+  EXPORT_DECLARATION_REGEX,
+  EXPORT_DEFAULT_REGEX,
+  EXPORT_LIST_REGEX
+} from "@flex-development/export-regex";
+const findExports = (code = "") => {
+  validateString(code, "code");
+  const statements = [];
+  for (const match of code.matchAll(EXPORT_AGGREGATE_REGEX)) {
+    const { 0: code2 = "", index: start = 0, groups = {} } = match;
+    const { exports = "", specifier = "", type = "" } = groups;
+    statements.push({
+      code: code2,
+      declaration: null,
+      end: start + code2.length,
+      exports: exports.startsWith("*") ? [exports] : exports.replace(/^{|}$/g, "").split(",").map((e) => e.trim()).filter((e) => e.length > 0),
+      kind: StatementKind.EXPORT,
+      modifiers: [],
+      specifier,
+      specifier_kind: getSpecifierKind(specifier),
+      specifier_syntax: SpecifierSyntaxKind.STATIC,
+      start,
+      syntax: exports.startsWith("{") ? StatementSyntaxKind.NAMED : StatementSyntaxKind.NAMESPACE,
+      type: !!type
+    });
+  }
+  for (const match of code.matchAll(EXPORT_DECLARATION_REGEX)) {
+    const { 0: code2 = "", index: start = 0, groups = {} } = match;
+    const { declaration = "", exports = "", modifiers = "" } = groups;
+    statements.push({
+      code: code2,
+      declaration,
+      end: start + code2.length,
+      exports: /^\w+$/.test(exports) ? [exports] : exports.replace(/^[[{]|[\]}]$/g, "").split(",").map((e) => e.trim().replace(/\s*=\s*.*$/, "")).filter((e) => e.length > 0),
+      kind: StatementKind.EXPORT,
+      modifiers: modifiers === "" ? [] : modifiers.split(" ").map((e) => e.trim()).filter((e) => e.length > 0),
+      specifier: null,
+      specifier_kind: null,
+      specifier_syntax: null,
+      start,
+      syntax: StatementSyntaxKind.DECLARATION,
+      type: false
+    });
+  }
+  for (const match of code.matchAll(EXPORT_DEFAULT_REGEX)) {
+    const { 0: code2 = "", index: start = 0, groups = {} } = match;
+    const { exports = "", kind: declaration = "", modifiers = "" } = groups;
+    statements.push({
+      code: code2,
+      declaration: declaration ? declaration : null,
+      end: start + code2.length,
+      exports: exports === "" ? [] : [exports],
+      kind: StatementKind.EXPORT,
+      modifiers: modifiers === "" ? [] : modifiers.split(" ").map((e) => e.trim()).filter((e) => e.length > 0),
+      specifier: null,
+      specifier_kind: null,
+      specifier_syntax: null,
+      start,
+      syntax: StatementSyntaxKind.DEFAULT,
+      type: false
+    });
+  }
+  for (const match of code.matchAll(EXPORT_LIST_REGEX)) {
+    const { 0: code2 = "", index: start = 0, groups = {} } = match;
+    const { exports = "", type = "" } = groups;
+    statements.push({
+      code: code2,
+      declaration: null,
+      end: start + code2.length,
+      exports: exports.replace(/^{|}$/g, "").split(",").map((e) => e.trim()).filter((e) => e.length > 0),
+      kind: StatementKind.EXPORT,
+      modifiers: [],
+      specifier: null,
+      specifier_kind: null,
+      specifier_syntax: null,
+      start,
+      syntax: StatementSyntaxKind.LIST,
+      type: !!type
+    });
+  }
+  return statements;
+};
+var find_exports_default = findExports;
+export {
+  find_exports_default as default
+};
+//# sourceMappingURL=find-exports.mjs.map

package/dist/utils/find-exports.mjs.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../src/utils/find-exports.ts"],
+  "mappings": "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",
+  "names": ["code"]
+}

package/dist/utils/find-requires.d.mts

@@ -0,0 +1,18 @@
+/**
+ * @file findRequires
+ * @module mlly/utils/findRequires
+ */
+import type { RequireStatement } from '../interfaces/index.mjs';
+/**
+ * Finds all `require` statements in `code`. Ignores matches in comments.
+ *
+ * @see {@linkcode RequireStatement}
+ * @see https://regex101.com/r/uCqSYB
+ * @see https://nodejs.org/api/modules.html#requireid
+ *
+ * @param {string} [code=''] - Code to evaluate
+ * @return {RequireStatement[]} Require statement objects
+ * @throws {NodeError<TypeError>} If `code` is not a string
+ */
+declare const findRequires: (code?: string) => RequireStatement[];
+export default findRequires;

package/dist/utils/find-requires.mjs

@@ -0,0 +1,32 @@
+import {
+  SpecifierSyntaxKind,
+  StatementKind,
+  StatementSyntaxKind
+} from "../enums/index.mjs";
+import getSpecifierKind from "../internal/get-specifier-kind.mjs";
+import validateString from "../internal/validate-string.mjs";
+const findRequires = (code = "") => {
+  validateString(code, "code");
+  const REQUIRE_REGEX = /(?<=^|[\s;])\b(?:(?:const\s*|let\s*|var\s*)?(?<imports>(?:[$_\p{ID_Start}][$\u200C\u200D\p{ID_Continue}]*)|(?:[\w\t\n\r "$'*,./:{}-]+?))?\s*=?\s*(?<kind>require)\((?<specifier>["']?[\S\t\n\r]+?["']?)\)(?=;?\n?))(?<!(?:\/\/|\*).*)/gu;
+  return [...code.matchAll(REQUIRE_REGEX)].map((match) => {
+    const { 0: code2 = "", index: start = 0, groups = {} } = match;
+    const { imports = "", specifier = "" } = groups;
+    const specifier_syntax = /^["']/.test(specifier) ? SpecifierSyntaxKind.STATIC : SpecifierSyntaxKind.DYNAMIC;
+    return {
+      code: code2,
+      end: start + code2.length,
+      imports: imports === "" ? [] : imports.replace(/^{|}$/g, "").split(",").map((e) => e.trim()).filter((e) => e.length > 0),
+      kind: StatementKind.REQUIRE,
+      specifier: specifier.replace(/^["']|["']$/g, ""),
+      specifier_kind: specifier_syntax === SpecifierSyntaxKind.DYNAMIC ? null : getSpecifierKind(specifier),
+      specifier_syntax,
+      start,
+      syntax: StatementSyntaxKind.REQUIRE
+    };
+  });
+};
+var find_requires_default = findRequires;
+export {
+  find_requires_default as default
+};
+//# sourceMappingURL=find-requires.mjs.map

package/dist/utils/find-requires.mjs.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../src/utils/find-requires.ts"],
+  "mappings": "AAKA;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAEP,OAAO,sBAAsB;AAC7B,OAAO,oBAAoB;AAc3B,MAAM,eAAe,CAAC,OAAe,OAA2B;AAC9D,iBAAe,MAAM,MAAM;AAO3B,QAAM,gBACJ;AAEF,SAAO,CAAC,GAAG,KAAK,SAAS,aAAa,CAAC,EAAE,IAAI,WAAS;AACpD,UAAM,EAAE,GAAGA,QAAO,IAAI,OAAO,QAAQ,GAAG,SAAS,CAAC,EAAE,IAAI;AACxD,UAAM,EAAE,UAAU,IAAI,YAAY,GAAG,IAAI;AAOzC,UAAM,mBAAwC,QAAQ,KAAK,SAAS,IAChE,oBAAoB,SACpB,oBAAoB;AAExB,WAAO;AAAA,MACL,MAAAA;AAAA,MACA,KAAK,QAAQA,MAAK;AAAA,MAClB,SACE,YAAY,KACR,CAAC,IACD,QACG,QAAQ,UAAU,EAAE,EACpB,MAAM,GAAG,EACT,IAAI,OAAK,EAAE,KAAK,CAAC,EACjB,OAAO,OAAK,EAAE,SAAS,CAAC;AAAA,MACjC,MAAM,cAAc;AAAA,MACpB,WAAW,UAAU,QAAQ,gBAAgB,EAAE;AAAA,MAC/C,gBACE,qBAAqB,oBAAoB,UACrC,OACA,iBAAiB,SAAS;AAAA,MAChC;AAAA,MACA;AAAA,MACA,QAAQ,oBAAoB;AAAA,IAC9B;AAAA,EACF,CAAC;AACH;AAEA,IAAO,wBAAQ;",
+  "names": ["code"]
+}

package/dist/utils/find-static-imports.d.mts

@@ -0,0 +1,18 @@
+/**
+ * @file findStaticImports
+ * @module mlly/utils/findStaticImports
+ */
+import type { StaticImport } from '../interfaces/index.mjs';
+/**
+ * Finds all static import statements in `code`. Ignores matches in comments.
+ *
+ * @see {@linkcode StaticImport}
+ * @see https://regex101.com/r/wlYQUN
+ * @see https://developer.mozilla.org/docs/Web/JavaScript/Reference/Statements/import
+ *
+ * @param {string} [code=''] - Code to evaluate
+ * @return {StaticImport[]} Static import statement objects
+ * @throws {NodeError<TypeError>} If `code` is not a string
+ */
+declare const findStaticImports: (code?: string) => StaticImport[];
+export default findStaticImports;

package/dist/utils/find-static-imports.mjs

@@ -0,0 +1,34 @@
+import {
+  SpecifierSyntaxKind,
+  StatementKind,
+  StatementSyntaxKind
+} from "../enums/index.mjs";
+import getSpecifierKind from "../internal/get-specifier-kind.mjs";
+import validateString from "../internal/validate-string.mjs";
+import { STATIC_IMPORT_REGEX } from "@flex-development/import-regex";
+const findStaticImports = (code = "") => {
+  validateString(code, "code");
+  return [...code.matchAll(STATIC_IMPORT_REGEX)].map((match) => {
+    const { 0: code2 = "", index: start = 0, groups = {} } = match;
+    const { assertion = "", imports = "", specifier = "", type = "" } = groups;
+    const syntax = imports === "" ? StatementSyntaxKind.SIDE_EFFECT : imports.startsWith("* as") ? StatementSyntaxKind.NAMESPACE : imports.startsWith("{") ? StatementSyntaxKind.NAMED : /^\w+$/.test(imports) ? StatementSyntaxKind.DEFAULT : /^\w+,\s*{/.test(imports) ? StatementSyntaxKind.DEFAULT_WITH_NAMED : StatementSyntaxKind.DEFAULT_WITH_NAMESPACE;
+    return {
+      assertion,
+      code: code2,
+      end: start + code2.length,
+      imports: syntax === StatementSyntaxKind.SIDE_EFFECT ? [] : syntax === StatementSyntaxKind.NAMED ? imports.replace(/^{|}$/g, "").split(",").map((e) => e.trim()).filter((e) => e.length > 0) : syntax === StatementSyntaxKind.DEFAULT_WITH_NAMED ? imports.split(",").map((i) => i.trim().replace(/^{|}$/g, "")).map((i) => i.trim()).filter((i) => i.length > 0) : syntax === StatementSyntaxKind.DEFAULT_WITH_NAMESPACE ? imports.split(",").map((i) => i.trim()).filter((i) => i.length > 0) : [imports],
+      kind: StatementKind.IMPORT,
+      specifier,
+      specifier_kind: getSpecifierKind(specifier),
+      specifier_syntax: SpecifierSyntaxKind.STATIC,
+      start,
+      syntax,
+      type: !!type
+    };
+  });
+};
+var find_static_imports_default = findStaticImports;
+export {
+  find_static_imports_default as default
+};
+//# sourceMappingURL=find-static-imports.mjs.map

package/dist/utils/find-static-imports.mjs.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../src/utils/find-static-imports.ts"],
+  "mappings": "AAKA;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAEP,OAAO,sBAAsB;AAC7B,OAAO,oBAAoB;AAE3B,SAAS,2BAA2B;AAapC,MAAM,oBAAoB,CAAC,OAAe,OAAuB;AAC/D,iBAAe,MAAM,MAAM;AAE3B,SAAO,CAAC,GAAG,KAAK,SAAS,mBAAmB,CAAC,EAAE,IAAI,WAAS;AAC1D,UAAM,EAAE,GAAGA,QAAO,IAAI,OAAO,QAAQ,GAAG,SAAS,CAAC,EAAE,IAAI;AACxD,UAAM,EAAE,YAAY,IAAI,UAAU,IAAI,YAAY,IAAI,OAAO,GAAG,IAAI;AAOpE,UAAM,SACJ,YAAY,KACR,oBAAoB,cACpB,QAAQ,WAAW,MAAM,IACzB,oBAAoB,YACpB,QAAQ,WAAW,GAAG,IACtB,oBAAoB,QACpB,QAAQ,KAAK,OAAO,IACpB,oBAAoB,UACpB,YAAY,KAAK,OAAO,IACxB,oBAAoB,qBACpB,oBAAoB;AAE1B,WAAO;AAAA,MACL;AAAA,MACA,MAAAA;AAAA,MACA,KAAK,QAAQA,MAAK;AAAA,MAClB,SACE,WAAW,oBAAoB,cAC3B,CAAC,IACD,WAAW,oBAAoB,QAC/B,QACG,QAAQ,UAAU,EAAE,EACpB,MAAM,GAAG,EACT,IAAI,OAAK,EAAE,KAAK,CAAC,EACjB,OAAO,OAAK,EAAE,SAAS,CAAC,IAC3B,WAAW,oBAAoB,qBAC/B,QACG,MAAM,GAAG,EACT,IAAI,OAAK,EAAE,KAAK,EAAE,QAAQ,UAAU,EAAE,CAAC,EACvC,IAAI,OAAK,EAAE,KAAK,CAAC,EACjB,OAAO,OAAK,EAAE,SAAS,CAAC,IAC3B,WAAW,oBAAoB,yBAC/B,QACG,MAAM,GAAG,EACT,IAAI,OAAK,EAAE,KAAK,CAAC,EACjB,OAAO,OAAK,EAAE,SAAS,CAAC,IAC3B,CAAC,OAAO;AAAA,MACd,MAAM,cAAc;AAAA,MACpB;AAAA,MACA,gBAAgB,iBAAiB,SAAS;AAAA,MAC1C,kBAAkB,oBAAoB;AAAA,MACtC;AAAA,MACA;AAAA,MACA,MAAM,CAAC,CAAC;AAAA,IACV;AAAA,EACF,CAAC;AACH;AAEA,IAAO,8BAAQ;",
+  "names": ["code"]
+}

package/dist/utils/find-subpath.d.mts

@@ -0,0 +1,30 @@
+/**
+ * @file findSubpath
+ * @module mlly/utils/findSubpath
+ */
+import type { FindSubpathOptions } from '../interfaces/index.mjs';
+import type { Exports, Imports } from '@flex-development/pkg-types';
+import { type Nullable } from '@flex-development/tutils';
+/**
+ * Finds the subpath defined in `context`, a `package.json` [`exports`][1] or
+ * [`imports`][2] field, that maps to the given package `target`.
+ *
+ * Supports extensionless targets. Returns `null` if a subpath is not found.
+ *
+ * [1]: https://nodejs.org/api/packages.html#exports
+ * [2]: https://nodejs.org/api/packages.html#imports
+ *
+ * @see {@linkcode Exports}
+ * @see {@linkcode FindSubpathOptions}
+ * @see {@linkcode Imports}
+ * @see https://nodejs.org/api/packages.html#subpath-exports
+ * @see https://nodejs.org/api/packages.html#subpath-imports
+ *
+ * @param {string} target - Package target to find in `context`
+ * @param {Exports | Imports | undefined} context - Package context
+ * @param {FindSubpathOptions} options - Search options
+ * @return {Nullable<string>} Subpath defined in `context` or `null`
+ * @throws {NodeError<Error | TypeError>}
+ */
+declare const findSubpath: (target: string, context: Exports | Imports | undefined, options: FindSubpathOptions) => Nullable<string>;
+export default findSubpath;

package/dist/utils/find-subpath.mjs

@@ -0,0 +1,106 @@
+import getSubpaths from "../internal/get-subpaths.mjs";
+import validateBoolean from "../internal/validate-boolean.mjs";
+import validateSet from "../internal/validate-set.mjs";
+import validateString from "../internal/validate-string.mjs";
+import validateURLString from "../internal/validate-url-string.mjs";
+import pathe from "@flex-development/pathe";
+import { isNIL } from "@flex-development/tutils";
+import { URL } from "node:url";
+import compareSubpaths from "./compare-subpaths.mjs";
+import CONDITIONS from "./conditions.mjs";
+import isExportsSugar from "./is-exports-sugar.mjs";
+import PATTERN_CHARACTER from "./pattern-character.mjs";
+import toURL from "./to-url.mjs";
+const findSubpath = (target, context, options) => {
+  const {
+    condition = "default",
+    conditions = CONDITIONS,
+    dir,
+    internal = false,
+    parent
+  } = options;
+  if (isNIL(context))
+    return null;
+  validateString(target, "target");
+  if (typeof context === "string") {
+    if (target === context || target === pathe.changeExt(context, "")) {
+      return ".";
+    }
+  }
+  validateString(condition, "options.condition");
+  validateSet(conditions, "options.conditions");
+  validateURLString(dir, "options.dir");
+  validateBoolean(internal, "options.internal");
+  validateURLString(parent, "options.parent");
+  const find = (target2, context2, key = ".") => {
+    let subpath = null;
+    switch (true) {
+      case (!isNIL(context2) && typeof context2 === "object"):
+      case typeof context2 === "string":
+        const pkgdir = toURL(dir).href.replace(/\/$/, "") + pathe.sep;
+        const pkg = new URL("package.json", pkgdir);
+        if (!internal && isExportsSugar(context2, pkg, parent)) {
+          context2 = { [key]: context2 };
+        }
+        context2 = context2;
+        const subpaths = getSubpaths(
+          context2,
+          internal,
+          pkg,
+          parent
+        ).sort((s1, s2) => compareSubpaths(s1, s2) * -1);
+        for (const pkgsubpath of subpaths) {
+          let tar = context2[pkgsubpath];
+          switch (true) {
+            case Array.isArray(tar):
+              tar = tar;
+              for (const item of tar) {
+                subpath = find(target2, item, pkgsubpath);
+                if (subpath)
+                  break;
+              }
+              break;
+            case (typeof tar === "object" && !isNIL(tar)):
+              tar = tar;
+              for (const prop of Object.getOwnPropertyNames(tar)) {
+                if (prop === condition || conditions.has(prop)) {
+                  subpath = find(target2, tar[prop], pkgsubpath);
+                  if (subpath)
+                    break;
+                }
+              }
+              break;
+            case typeof tar === "string":
+              tar = tar;
+              const tar_ne = pathe.changeExt(tar, "");
+              const pattern = tar.indexOf(PATTERN_CHARACTER);
+              switch (true) {
+                case target2 === tar:
+                case target2 === tar_ne:
+                case (pattern === -1 && (target2 === tar || target2 === tar_ne)):
+                  subpath = pkgsubpath;
+                  break;
+                case (pattern !== -1 && target2.startsWith(tar.slice(0, pattern))):
+                  const match = target2.length >= tar.length && tar.lastIndexOf(PATTERN_CHARACTER) === pattern && (target2.endsWith(tar.slice(pattern + 1)) || target2.endsWith(tar_ne.slice(pattern + 1)));
+                  if (match)
+                    subpath = pkgsubpath;
+                  break;
+              }
+              break;
+          }
+          if (subpath)
+            break;
+        }
+        break;
+      default:
+        break;
+    }
+    return subpath;
+  };
+  return find(target, context);
+};
+var find_subpath_default = findSubpath;
+export {
+  find_subpath_default as default
+};
+//# sourceMappingURL=find-subpath.mjs.map

package/dist/utils/find-subpath.mjs.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../src/utils/find-subpath.ts"],
+  "mappings": "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",
+  "names": ["target", "context"]
+}

package/dist/utils/get-format.d.mts

@@ -0,0 +1,24 @@
+/**
+ * @file getFormat
+ * @module mlly/utils/getFormat
+ */
+import { Format } from '../enums/index.mjs';
+import type { GetFormatOptions } from '../interfaces/index.mjs';
+import type { ModuleId } from '../types/index.mjs';
+import type { Nilable } from '@flex-development/tutils';
+/**
+ * Retrieves a module format for the given module `id`.
+ *
+ * @see {@linkcode Format}
+ * @see {@linkcode GetFormatOptions}
+ * @see {@linkcode ModuleId}
+ *
+ * @async
+ *
+ * @param {ModuleId} id - Module id to evaluate
+ * @param {GetFormatOptions?} [options={}] - Format retrieval options
+ * @return {Promise<Nilable<Format>>} Module format, `null`, or `undefined`
+ * @throws {NodeError<TypeError>}
+ */
+declare const getFormat: (id: ModuleId, options?: GetFormatOptions) => Promise<Nilable<Format>>;
+export default getFormat;

package/dist/utils/get-format.mjs

@@ -0,0 +1,111 @@
+import { Format } from "../enums/index.mjs";
+import {
+  ERR_UNKNOWN_FILE_EXTENSION
+} from "@flex-development/errnode";
+import { isBuiltin } from "@flex-development/is-builtin";
+import pathe from "@flex-development/pathe";
+import EXTENSION_FORMAT_MAP from "./extension-format-map.mjs";
+import lookupPackageScope from "./lookup-package-scope.mjs";
+import parseDataURL from "./parse-data-url.mjs";
+import toURL from "./to-url.mjs";
+const getFormat = async (id, options = {}) => {
+  const {
+    base,
+    experimental_json_modules = true,
+    experimental_network_imports = false,
+    experimental_wasm_modules = false,
+    extension_format_map = EXTENSION_FORMAT_MAP,
+    ignore_errors = false,
+    req
+  } = options;
+  const url = toURL(id, base);
+  const mimeToFormat = (value, content_type = false) => {
+    let format2 = null;
+    if (!value)
+      return format2;
+    if (content_type)
+      value = value.replace(/;.*/, ",");
+    if (!value.startsWith("data:"))
+      value = `data:${value}`;
+    try {
+      switch (parseDataURL(value).mime) {
+        case "application/javascript":
+        case "application/typescript":
+        case "text/javascript":
+          format2 = Format.MODULE;
+          break;
+        case "application/json":
+          format2 = experimental_json_modules ? Format.JSON : null;
+          break;
+        case "application/wasm":
+          format2 = experimental_wasm_modules ? Format.WASM : null;
+          break;
+        default:
+          break;
+      }
+    } catch {
+      format2 = ignore_errors ? void 0 : null;
+    }
+    return format2;
+  };
+  let format = null;
+  switch (url.protocol) {
+    case "data:":
+      format = mimeToFormat(url.href);
+      break;
+    case "file:":
+      const ext = pathe.extname(url.pathname);
+      const scope = lookupPackageScope(url);
+      switch (true) {
+        case (scope && ext === ".js"):
+          format = scope.pkgjson.type === Format.MODULE ? Format.MODULE : Format.COMMONJS;
+          break;
+        case extension_format_map.has(ext):
+          format = extension_format_map.get(ext);
+          switch (true) {
+            case (format === Format.JSON && !experimental_json_modules):
+            case (format === Format.WASM && !experimental_wasm_modules):
+              format = ignore_errors ? void 0 : null;
+              break;
+            default:
+              break;
+          }
+          break;
+        case ignore_errors:
+          format = void 0;
+          break;
+        default:
+          let suggestion;
+          if (scope && scope.pkgjson.type === Format.MODULE && ext === "") {
+            const { pkg } = scope;
+            const basename = pathe.basename(url.pathname);
+            const relative = pathe.relative(pkg, url.pathname).slice(1);
+            suggestion = `Loading extensionless files is not supported inside of "type":"module" package.json contexts. The package.json file ${pkg} caused this "type":"module" context. Try changing ${url.pathname} to have a file extension. Note the "bin" field of package.json can point to a file with an extension, for example {"type":"module","bin":{"${basename}":"${relative}.js"}}`;
+          }
+          throw new ERR_UNKNOWN_FILE_EXTENSION(ext, url.pathname, suggestion);
+      }
+      break;
+    case "http:":
+    case "https:":
+      if (experimental_network_imports) {
+        const { default: fetch } = await import("node-fetch");
+        const { headers } = await fetch(url.href, req);
+        format = mimeToFormat(headers.get("content-type"), true);
+      } else {
+        format = ignore_errors ? void 0 : null;
+      }
+      break;
+    case "node:":
+      if (isBuiltin(url))
+        format = Format.BUILTIN;
+      break;
+    default:
+      break;
+  }
+  return format;
+};
+var get_format_default = getFormat;
+export {
+  get_format_default as default
+};
+//# sourceMappingURL=get-format.mjs.map

package/dist/utils/get-format.mjs.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../src/utils/get-format.ts"],
+  "mappings": "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",
+  "names": ["format"]
+}

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

@@ -0,0 +1,22 @@
+/**
+ * @file getSource
+ * @module mlly/utils/getSource
+ */
+import type { GetSourceOptions } from '../interfaces/index.mjs';
+import type { ModuleId } from '../types/index.mjs';
+/**
+ * Retrieves source code for the given module `id`.
+ *
+ * @see {@linkcode GetSourceOptions}
+ * @see {@linkcode ModuleId}
+ * @see https://nodejs.org/docs/latest-v19.x/api/esm.html#loadurl-context-nextload
+ *
+ * @async
+ *
+ * @param {ModuleId} id - Module id to evaluate
+ * @param {GetSourceOptions?} [options={}] - Source code retrieval options
+ * @return {Promise<Uint8Array | string | undefined>} Source code for `id`
+ * @throws {NodeError} If unsupported URL scheme is encountered
+ */
+declare const getSource: (id: ModuleId, options?: GetSourceOptions) => Promise<Uint8Array | string | undefined>;
+export default getSource;

package/dist/utils/get-source.mjs

@@ -0,0 +1,63 @@
+import { Format } from "../enums/index.mjs";
+import {
+  ERR_UNSUPPORTED_ESM_URL_SCHEME
+} from "@flex-development/errnode";
+import fs from "node:fs/promises";
+import os from "node:os";
+import util from "node:util";
+import parseDataURL from "./parse-data-url.mjs";
+import toURL from "./to-url.mjs";
+const getSource = async (id, options = {}) => {
+  const {
+    base,
+    experimental_network_imports = false,
+    format,
+    ignore_errors = false,
+    req
+  } = options;
+  if (format === Format.BUILTIN)
+    return void 0;
+  const url = toURL(id, base);
+  let err = false;
+  let source = "";
+  switch (url.protocol) {
+    case "data:":
+      const { base64, data } = parseDataURL(url);
+      const encoding = base64 ? "base64" : "utf8";
+      source = Buffer.from(decodeURIComponent(data), encoding).toString();
+      break;
+    case "file:":
+      source = await fs.readFile(url, "utf8");
+      break;
+    case "http:":
+    case "https:":
+      if (experimental_network_imports) {
+        const { default: fetch } = await import("node-fetch");
+        source = await (await fetch(url.href, req)).text();
+      } else {
+        err = true;
+      }
+      break;
+    case "node:":
+      source = void 0;
+      break;
+    default:
+      err = true;
+  }
+  if (!ignore_errors && err) {
+    const schemes = ["data", "file"];
+    if (experimental_network_imports)
+      schemes.push("http", "https");
+    throw new ERR_UNSUPPORTED_ESM_URL_SCHEME(
+      url,
+      schemes,
+      os.platform() === "win32"
+    );
+  }
+  return format === Format.WASM ? new util.TextEncoder().encode(source) : source;
+};
+var get_source_default = getSource;
+export {
+  get_source_default as default
+};
+//# sourceMappingURL=get-source.mjs.map

package/dist/utils/get-source.mjs.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../src/utils/get-source.ts"],
+  "mappings": "AAKA,SAAS,cAAc;AAGvB;AAAA,EACE;AAAA,OAEK;AACP,OAAO,QAAQ;AACf,OAAO,QAAQ;AAEf,OAAO,UAAU;AACjB,OAAO,kBAAkB;AACzB,OAAO,WAAW;AAgBlB,MAAM,YAAY,OAChB,IACA,UAA4B,CAAC,MACgB;AAC7C,QAAM;AAAA,IACJ;AAAA,IACA,+BAA+B;AAAA,IAC/B;AAAA,IACA,gBAAgB;AAAA,IAChB;AAAA,EACF,IAAI;AAGJ,MAAI,WAAW,OAAO;AAAS,WAAO;AAOtC,QAAM,MAAW,MAAM,IAAI,IAAI;AAS/B,MAAI,MAAe;AAOnB,MAAI,SAA0C;AAG9C,UAAQ,IAAI,UAAU;AAAA,IACpB,KAAK;AACH,YAAM,EAAE,QAAQ,KAAK,IAAI,aAAa,GAAG;AAQzC,YAAM,WAA2B,SAAS,WAAW;AAErD,eAAS,OAAO,KAAK,mBAAmB,IAAI,GAAG,QAAQ,EAAE,SAAS;AAClE;AAAA,IACF,KAAK;AACH,eAAS,MAAM,GAAG,SAAS,KAAK,MAAM;AACtC;AAAA,IACF,KAAK;AAAA,IACL,KAAK;AACH,UAAI,8BAA8B;AAChC,cAAM,EAAE,SAAS,MAAM,IAAI,MAAM,OAAO,YAAY;AACpD,iBAAS,OAAO,MAAM,MAAM,IAAI,MAAM,GAAG,GAAG,KAAK;AAAA,MACnD,OAAO;AACL,cAAM;AAAA,MACR;AAEA;AAAA,IACF,KAAK;AACH,eAAS;AACT;AAAA,IACF;AACE,YAAM;AAAA,EACV;AAGA,MAAI,CAAC,iBAAiB,KAAK;AAMzB,UAAM,UAAoB,CAAC,QAAQ,MAAM;AAGzC,QAAI;AAA8B,cAAQ,KAAK,QAAQ,OAAO;AAE9D,UAAM,IAAI;AAAA,MACR;AAAA,MACA;AAAA,MACA,GAAG,SAAS,MAAM;AAAA,IACpB;AAAA,EACF;AAEA,SAAO,WAAW,OAAO,OAAO,IAAI,KAAK,YAAY,EAAE,OAAO,MAAM,IAAI;AAC1E;AAEA,IAAO,qBAAQ;",
+  "names": []
+}

package/dist/{lib → utils}/has-cjs-syntax.d.mts

@@ -1,6 +1,6 @@
 /**
  * @file hasCJSSyntax
- * @module mlly/lib/hasCJSSyntax
+ * @module mlly/utils/hasCJSSyntax
  */
 /**
  * Detects if `code` contains CommonJS syntax. Ignores matches in comments.
@@ -15,8 +15,11 @@
  * - `require`
  * - `require.*`
  *
- * @param {string} code - Code to check
+ * @see https://regex101.com/r/Co77SJ
+ *
+ * @param {string} code - Code to evaluate
  * @return {boolean} `true` if `code` contains cjs syntax, `false` otherwise
+ * @throws {NodeError<TypeError>} If `code` is not a string
  */
 declare const hasCJSSyntax: (code: string) => boolean;
 export default hasCJSSyntax;

package/dist/utils/has-cjs-syntax.mjs

@@ -0,0 +1,11 @@
+import validateString from "../internal/validate-string.mjs";
+const hasCJSSyntax = (code) => {
+  validateString(code, "code");
+  const CJS_SYNTAX_REGEX = /(?<!(?:\/\/|\*).*)((?:module\.)?exports(?:\.\w+|(?<!\s+=))|require(?=\(.)|require\.\w+|__dirname|__filename|await import)/gm;
+  return !!code.match(CJS_SYNTAX_REGEX);
+};
+var has_cjs_syntax_default = hasCJSSyntax;
+export {
+  has_cjs_syntax_default as default
+};
+//# sourceMappingURL=has-cjs-syntax.mjs.map