Initial commit

2026-07-27 13:37:48 +08:00
commit ecba71e2a5
39123 changed files with 5989154 additions and 0 deletions
@@ -0,0 +1,25 @@
+# import-local
+
+> Let a globally installed package use a locally installed version of itself if available
+
+Useful for CLI tools that want to defer to the user's locally installed version when available, but still work if it's not installed locally. For example, [AVA](https://avajs.dev) and [XO](https://github.com/xojs/xo) uses this method.
+
+## Install
+
+```sh
+npm install import-local
+```
+
+## Usage
+
+```js
+import importLocal from 'import-local';
+
+if (importLocal(import.meta.url)) {
+	console.log('Using local version of this package');
+} else {
+	// Code for both global and local version here…
+}
+```
+
+You can also pass in `__filename` when used in a CommonJS context.