@optique/discover 1.2.0-dev.2167 → 1.2.0-dev.2179

package/dist/main-check-CwunSNpK.cjs

@@ -0,0 +1,60 @@
+const require_chunk = require('./chunk-CUT6urMc.cjs');
+const node_url = require_chunk.__toESM(require("node:url"));
+const node_fs = require_chunk.__toESM(require("node:fs"));
+
+//#region src/main-check.ts
+/**
+* Checks whether a module is the current process entry point.
+*
+* @param options Main-module check inputs.
+* @returns Whether the module should run as the process entry point.
+* @internal
+* @since 1.2.0
+*/
+function isMainModule(options) {
+	if (options.importMetaMain != null) return options.importMetaMain;
+	if (options.argvEntry == null) return false;
+	const realpath = options.realpath ?? node_fs.realpathSync;
+	return realpathOrOriginal(options.argvEntry, realpath) === realpathOrOriginal(options.modulePath, realpath);
+}
+/**
+* Checks whether a module URL is the current process entry point.
+*
+* Non-file module URLs rely on `import.meta.main` because process entry points
+* are file-system paths.
+*
+* @param options Main-module URL check inputs.
+* @returns Whether the module should run as the process entry point.
+* @internal
+* @since 1.2.0
+*/
+function isMainModuleUrl(options) {
+	if (options.importMetaMain != null) return options.importMetaMain;
+	if (!options.moduleUrl.startsWith("file:")) return false;
+	return isMainModule({
+		modulePath: (0, node_url.fileURLToPath)(options.moduleUrl),
+		argvEntry: options.argvEntry,
+		realpath: options.realpath
+	});
+}
+function realpathOrOriginal(path, realpath) {
+	try {
+		return realpath(path);
+	} catch {
+		return path;
+	}
+}
+
+//#endregion
+Object.defineProperty(exports, 'isMainModule', {
+  enumerable: true,
+  get: function () {
+    return isMainModule;
+  }
+});
+Object.defineProperty(exports, 'isMainModuleUrl', {
+  enumerable: true,
+  get: function () {
+    return isMainModuleUrl;
+  }
+});

package/dist/main-check-mMnKfUZs.js

@@ -0,0 +1,48 @@
+import { fileURLToPath } from "node:url";
+import { realpathSync } from "node:fs";
+
+//#region src/main-check.ts
+/**
+* Checks whether a module is the current process entry point.
+*
+* @param options Main-module check inputs.
+* @returns Whether the module should run as the process entry point.
+* @internal
+* @since 1.2.0
+*/
+function isMainModule(options) {
+	if (options.importMetaMain != null) return options.importMetaMain;
+	if (options.argvEntry == null) return false;
+	const realpath = options.realpath ?? realpathSync;
+	return realpathOrOriginal(options.argvEntry, realpath) === realpathOrOriginal(options.modulePath, realpath);
+}
+/**
+* Checks whether a module URL is the current process entry point.
+*
+* Non-file module URLs rely on `import.meta.main` because process entry points
+* are file-system paths.
+*
+* @param options Main-module URL check inputs.
+* @returns Whether the module should run as the process entry point.
+* @internal
+* @since 1.2.0
+*/
+function isMainModuleUrl(options) {
+	if (options.importMetaMain != null) return options.importMetaMain;
+	if (!options.moduleUrl.startsWith("file:")) return false;
+	return isMainModule({
+		modulePath: fileURLToPath(options.moduleUrl),
+		argvEntry: options.argvEntry,
+		realpath: options.realpath
+	});
+}
+function realpathOrOriginal(path, realpath) {
+	try {
+		return realpath(path);
+	} catch {
+		return path;
+	}
+}
+
+//#endregion
+export { isMainModule, isMainModuleUrl };

package/dist/main-check.cjs

@@ -0,0 +1,4 @@
+const require_main_check = require('./main-check-CwunSNpK.cjs');
+
+exports.isMainModule = require_main_check.isMainModule;
+exports.isMainModuleUrl = require_main_check.isMainModuleUrl;

package/dist/main-check.d.cts

@@ -0,0 +1,72 @@
+//#region src/main-check.d.ts
+/**
+ * Options for checking whether an ESM module is the process entry point.
+ *
+ * @internal
+ * @since 1.2.0
+ */
+interface MainModuleOptions {
+  /**
+   * `import.meta.main` when the current runtime provides it.
+   */
+  readonly importMetaMain?: boolean;
+  /**
+   * Path to the current module.
+   */
+  readonly modulePath: string;
+  /**
+   * Process entry-point path.
+   */
+  readonly argvEntry?: string;
+  /**
+   * Function used to resolve symlinks.
+   */
+  readonly realpath?: (path: string) => string;
+}
+/**
+ * Options for checking whether an ESM module URL is the process entry point.
+ *
+ * @internal
+ * @since 1.2.0
+ */
+interface MainModuleUrlOptions {
+  /**
+   * `import.meta.main` when the current runtime provides it.
+   */
+  readonly importMetaMain?: boolean;
+  /**
+   * URL of the current module.
+   */
+  readonly moduleUrl: string;
+  /**
+   * Process entry-point path.
+   */
+  readonly argvEntry?: string;
+  /**
+   * Function used to resolve symlinks.
+   */
+  readonly realpath?: (path: string) => string;
+}
+/**
+ * Checks whether a module is the current process entry point.
+ *
+ * @param options Main-module check inputs.
+ * @returns Whether the module should run as the process entry point.
+ * @internal
+ * @since 1.2.0
+ */
+declare function isMainModule(options: MainModuleOptions): boolean;
+/**
+ * Checks whether a module URL is the current process entry point.
+ *
+ * Non-file module URLs rely on `import.meta.main` because process entry points
+ * are file-system paths.
+ *
+ * @param options Main-module URL check inputs.
+ * @returns Whether the module should run as the process entry point.
+ * @internal
+ * @since 1.2.0
+ */
+declare function isMainModuleUrl(options: MainModuleUrlOptions): boolean;
+//#endregion
+export { MainModuleOptions, MainModuleUrlOptions, isMainModule, isMainModuleUrl };

package/dist/main-check.d.ts

@@ -0,0 +1,72 @@
+//#region src/main-check.d.ts
+/**
+ * Options for checking whether an ESM module is the process entry point.
+ *
+ * @internal
+ * @since 1.2.0
+ */
+interface MainModuleOptions {
+  /**
+   * `import.meta.main` when the current runtime provides it.
+   */
+  readonly importMetaMain?: boolean;
+  /**
+   * Path to the current module.
+   */
+  readonly modulePath: string;
+  /**
+   * Process entry-point path.
+   */
+  readonly argvEntry?: string;
+  /**
+   * Function used to resolve symlinks.
+   */
+  readonly realpath?: (path: string) => string;
+}
+/**
+ * Options for checking whether an ESM module URL is the process entry point.
+ *
+ * @internal
+ * @since 1.2.0
+ */
+interface MainModuleUrlOptions {
+  /**
+   * `import.meta.main` when the current runtime provides it.
+   */
+  readonly importMetaMain?: boolean;
+  /**
+   * URL of the current module.
+   */
+  readonly moduleUrl: string;
+  /**
+   * Process entry-point path.
+   */
+  readonly argvEntry?: string;
+  /**
+   * Function used to resolve symlinks.
+   */
+  readonly realpath?: (path: string) => string;
+}
+/**
+ * Checks whether a module is the current process entry point.
+ *
+ * @param options Main-module check inputs.
+ * @returns Whether the module should run as the process entry point.
+ * @internal
+ * @since 1.2.0
+ */
+declare function isMainModule(options: MainModuleOptions): boolean;
+/**
+ * Checks whether a module URL is the current process entry point.
+ *
+ * Non-file module URLs rely on `import.meta.main` because process entry points
+ * are file-system paths.
+ *
+ * @param options Main-module URL check inputs.
+ * @returns Whether the module should run as the process entry point.
+ * @internal
+ * @since 1.2.0
+ */
+declare function isMainModuleUrl(options: MainModuleUrlOptions): boolean;
+//#endregion
+export { MainModuleOptions, MainModuleUrlOptions, isMainModule, isMainModuleUrl };

package/dist/main-check.js

@@ -0,0 +1,3 @@
+import { isMainModule, isMainModuleUrl } from "./main-check-mMnKfUZs.js";
+
+export { isMainModule, isMainModuleUrl };