2.0

.github/workflows/ci.yml

@@ -22,7 +22,8 @@ jobs:
     runs-on: ubuntu-latest
     strategy:
       matrix:
-        nodejs: [10, 12, 14, 16, 18]
+        # Node 10.x not supported by tsm & bundt
+        nodejs: [12, 14, 16, 18]
     steps:
     - uses: actions/checkout@v2
     - uses: actions/setup-node@v1
@@ -34,9 +35,16 @@ jobs:
         npm install
         npm install -g nyc
 
+    - name: Type Check
+      run: npm run types
+
     - name: Test w/ Coverage
       run: nyc --include=src npm test
 
+    - name: Compile
+      if: matrix.nodejs >= 18
+      run: npm run build
+
     - name: Report
       if: matrix.nodejs >= 18
       run: |

index.d.ts

@@ -1,21 +1,100 @@
 export type Options = {
+	/**
+	 * When true, adds the "browser" conditions.
+	 * Otherwise the "node" condition is enabled.
+	 * @default false
+	 */
 	browser?: boolean;
+	/**
+	 * Any custom conditions to match.
+	 * @note Array order does not matter. Priority is determined by the key-order of conditions defined within a package's imports/exports mapping.
+	 * @default []
+	 */
 	conditions?: readonly string[];
+	/**
+	 * When true, adds the "require" condition.
+	 * Otherwise the "import" condition is enabled.
+	 * @default false
+	 */
 	require?: boolean;
-	unsafe?: false;
-} | {
-	conditions?: readonly string[];
-	unsafe?: true;
+	/**
+	 * Prevents "require", "import", "browser", and/or "node" conditions from being added automatically.
+	 * When enabled, only `options.conditions` are added alongside the "default" condition.
+	 * @important Enabling this deviates from Node.js default behavior.
+	 * @default false
+	 */
+	unsafe?: boolean;
 }
 
-export function resolve<T=any>(pkg: T, entry: string, options?: Options): string | void;
-
-export type BrowserFiles = Record<string, string | false>;
+export function resolve<T=Package>(pkg: T, entry?: string, options?: Options): Imports.Output | Exports.Output | void;
+export function imports<T=Package>(pkg: T, entry?: string, options?: Options): Imports.Output | void;
+export function exports<T=Package>(pkg: T, target: string, options?: Options): Exports.Output | void;
 
-export function legacy<T=any>(pkg: T, options: { browser: true, fields?: readonly string[] }): BrowserFiles | string | void;
-export function legacy<T=any>(pkg: T, options: { browser: string, fields?: readonly string[] }): string | false | void;
-export function legacy<T=any>(pkg: T, options: { browser: false, fields?: readonly string[] }): string | void;
-export function legacy<T=any>(pkg: T, options?: {
+export function legacy<T=Package>(pkg: T, options: { browser: true, fields?: readonly string[] }): Browser | void;
+export function legacy<T=Package>(pkg: T, options: { browser: string, fields?: readonly string[] }): string | false | void;
+export function legacy<T=Package>(pkg: T, options: { browser: false, fields?: readonly string[] }): string | void;
+export function legacy<T=Package>(pkg: T, options?: {
 	browser?: boolean | string;
 	fields?: readonly string[];
-}): BrowserFiles | string | false | void;
+}): Browser | string;
+
+// ---
+
+/**
+ * A resolve condition
+ * @example "node", "default", "production"
+ */
+export type Condition = string;
+
+/** An internal file path */
+export type Path = `./${string}`;
+
+export type Imports = {
+	[entry: Imports.Entry]: Imports.Value;
+}
+
+export namespace Imports {
+	export type Entry = `#${string}`;
+
+	type External = string;
+
+	/** strings are dependency names OR internal paths */
+	export type Value = External | Path | null | {
+		[c: Condition]: Value;
+	} | Value[];
+
+
+	export type Output = Array<External|Path>;
+}
+
+export type Exports = Path | {
+	[path: Exports.Entry]: Exports.Value;
+	[cond: Condition]: Exports.Value;
+}
+
+export namespace Exports {
+	/** Allows "." and "./{name}" */
+	export type Entry = `.${string}`;
+
+	/** strings must be internal paths */
+	export type Value = Path | null | {
+		[c: Condition]: Value;
+	} | Value[];
+
+	export type Output = Path[];
+}
+
+export type Package = {
+	name: string;
+	version?: string;
+	module?: string;
+	main?: string;
+	imports?: Imports;
+	exports?: Exports;
+	browser?: Browser;
+	[key: string]: any;
+}
+
+export type Browser = string[] | string | {
+	[file: Path | string]: string | false;
+}

package.json

@@ -1,8 +1,8 @@
 {
-  "version": "1.1.1",
+  "version": "2.0.0-next.0",
   "name": "resolve.exports",
   "repository": "lukeed/resolve.exports",
-  "description": "A tiny (813b), correct, general-purpose, and configurable \"exports\" resolver without file-system reliance",
+  "description": "A tiny (952b), correct, general-purpose, and configurable \"exports\" and \"imports\" resolver without file-system reliance",
   "module": "dist/index.mjs",
   "main": "dist/index.js",
   "types": "index.d.ts",
@@ -16,8 +16,9 @@
     "node": ">=10"
   },
   "scripts": {
-    "build": "bundt",
-    "test": "uvu -r esm test"
+    "build": "bundt -m",
+    "types": "tsc --noEmit",
+    "test": "uvu -r tsm test"
   },
   "files": [
     "*.d.ts",
@@ -41,8 +42,9 @@
     "resolve"
   ],
   "devDependencies": {
-    "bundt": "1.1.2",
-    "esm": "3.2.25",
-    "uvu": "0.5.1"
+    "bundt": "next",
+    "tsm": "2.3.0",
+    "typescript": "4.9.4",
+    "uvu": "0.5.4"
   }
 }