@esmx/import 3.0.0-rc.116 → 3.0.0-rc.118

package/package.json

@@ -1,5 +1,15 @@
 {
     "name": "@esmx/import",
+    "description": "Import map utilities for resolving and merging ESM import maps",
+    "repository": {
+        "type": "git",
+        "url": "https://github.com/esmnext/esmx.git",
+        "directory": "packages/import"
+    },
+    "homepage": "https://github.com/esmnext/esmx",
+    "bugs": {
+        "url": "https://github.com/esmnext/esmx/issues"
+    },
     "template": "library-node",
     "license": "MIT",
     "contributors": [
@@ -24,8 +34,8 @@
         "lint:js": "biome check --write --no-errors-on-unmatched",
         "lint:css": "pnpm run lint:js",
         "lint:type": "tsc --noEmit",
-        "test": "vitest run --pass-with-no-tests",
-        "coverage": "vitest run --coverage --pass-with-no-tests",
+        "test": "cross-env NODE_OPTIONS=--experimental-vm-modules vitest run --pass-with-no-tests",
+        "coverage": "cross-env NODE_OPTIONS=--experimental-vm-modules vitest run --coverage --pass-with-no-tests",
         "build": "unbuild"
     },
     "dependencies": {
@@ -34,12 +44,13 @@
     "devDependencies": {
         "@biomejs/biome": "2.3.7",
         "@types/node": "^24.0.0",
-        "@vitest/coverage-v8": "3.2.4",
+        "@vitest/coverage-v8": "3.2.6",
+        "cross-env": "^10.1.0",
         "typescript": "5.9.3",
         "unbuild": "3.6.1",
-        "vitest": "3.2.4"
+        "vitest": "3.2.6"
     },
-    "version": "3.0.0-rc.116",
+    "version": "3.0.0-rc.118",
     "type": "module",
     "private": false,
     "exports": {
@@ -58,5 +69,11 @@
         "template",
         "public"
     ],
-    "gitHead": "2e16b175552400382913b445ae7e112b78c422f5"
+    "gitHead": "2fdbd62470f64e6e45568550941c78cb259e4917",
+    "engines": {
+        "node": ">=24"
+    },
+    "publishConfig": {
+        "access": "public"
+    }
 }

package/src/error.test.ts

@@ -202,5 +202,51 @@ describe('Module Loading Errors', () => {
                 `        └─ ${relativeE} ❌ Loading failed`
             );
         });
+
+        it('should handle formatModuleChain with original error', () => {
+            const moduleIds: string[] = [];
+            const targetModule = '/src/error.js';
+            const originalError = new Error('Original error message');
+
+            const formatted = formatModuleChain(
+                moduleIds,
+                targetModule,
+                originalError
+            );
+
+            expect(formatted).toContain('Error details:');
+            expect(formatted).toContain('Original error message');
+        });
+    });
+
+    describe('ModuleLoadingError base class', () => {
+        it('should create base error with all properties', () => {
+            const moduleIds = ['/src/a.js'];
+            const targetModule = '/src/b.js';
+            const originalError = new Error('cause');
+
+            const error = new ModuleLoadingError(
+                'Base error',
+                moduleIds,
+                targetModule,
+                originalError
+            );
+
+            expect(error.name).toBe('ModuleLoadingError');
+            expect(error.message).toBe('Base error');
+            expect(error.moduleIds).toEqual(moduleIds);
+            expect(error.targetModule).toBe(targetModule);
+            expect(error.originalError).toBe(originalError);
+        });
+
+        it('should create base error without original error', () => {
+            const error = new ModuleLoadingError(
+                'Simple error',
+                [],
+                '/src/x.js'
+            );
+
+            expect(error.originalError).toBeUndefined();
+        });
     });
 });

package/src/import-loader.ts

@@ -21,14 +21,17 @@ export function createLoaderImport(baseURL: URL, importMap: ImportMap = {}) {
         registered = JSON.stringify(importMap);
     } else if (registered !== JSON.stringify(importMap)) {
         throw new Error(
-            `'createLoaderImport()' can only be created once and cannot be created repeatedly`
+            `[@esmx/import] createLoaderImport() is a per-process singleton and was called twice with different importMap data. Ensure your app initializes the loader exactly once at startup.`
         );
     }
     return (specifier: string): Promise<Record<string, any>> => {
         try {
             return import(specifier);
         } catch (e) {
-            throw new Error(`Failed to import '${specifier}'`);
+            const cause = e instanceof Error ? e.message : String(e);
+            throw new Error(
+                `[@esmx/import] Failed to import '${specifier}'. Verify the specifier is declared in the importMap (modules.imports in entry.node.ts) or matches a federated module name. Original error: ${cause}`
+            );
         }
     };
 }