fix: add .js extensions to imports for Node.js native ESM compatibility

Author: liorcodev

package.json

@@ -49,6 +49,7 @@
     "generate": "bun scripts/generate-preview.ts",
     "prebuild": "bun scripts/build-inline.js",
     "build": "tsc",
+    "test:esm": "node test-esm.mjs",
     "prepublishOnly": "bun run build"
   },
   "type": "module",

src/generate-html.ts

@@ -1,6 +1,6 @@
-import { RouteInfo } from './collect-routes';
-import { DocsGeneratorOptions, RouteMeta } from './types';
-import { getStyles, getScripts, getLogo } from './assets-inline';
+import { RouteInfo } from './collect-routes.js';
+import { DocsGeneratorOptions, RouteMeta } from './types.js';
+import { getStyles, getScripts, getLogo } from './assets-inline.js';
 
 /**
  * Generate beautiful HTML documentation from route information

src/index.ts

@@ -7,6 +7,6 @@
  * @packageDocumentation
  */
 
-export { collectRoutes, type RouteInfo } from './collect-routes';
-export { generateDocsHtml } from './generate-html';
-export { type RouteMeta, type DocsGeneratorOptions } from './types';
+export { collectRoutes, type RouteInfo } from './collect-routes.js';
+export { generateDocsHtml } from './generate-html.js';
+export { type RouteMeta, type DocsGeneratorOptions } from './types.js';

test-esm.mjs

@@ -0,0 +1,31 @@
+/**
+ * ESM Smoke Test - Verifies Node.js native ESM compatibility
+ * This should run without ERR_MODULE_NOT_FOUND errors
+ */
+
+console.log('Testing ESM imports...');
+
+try {
+  // Test direct imports work without crashes
+  const { collectRoutes, generateDocsHtml } = await import('./dist/index.js');
+
+  console.log('✅ Successfully imported collectRoutes:', typeof collectRoutes);
+  console.log('✅ Successfully imported generateDocsHtml:', typeof generateDocsHtml);
+
+  // Verify they are the expected types
+  if (typeof collectRoutes !== 'function') {
+    throw new Error('collectRoutes should be a function');
+  }
+  if (typeof generateDocsHtml !== 'function') {
+    throw new Error('generateDocsHtml should be a function');
+  }
+
+  console.log('\n✅ ESM compatibility test PASSED');
+  console.log('All imports resolved correctly with .js extensions');
+  process.exit(0);
+} catch (error) {
+  console.error('\n❌ ESM compatibility test FAILED');
+  console.error('Error:', error.message);
+  console.error('\nStack:', error.stack);
+  process.exit(1);
+}

tsconfig.json

@@ -1,9 +1,9 @@
 {
   "compilerOptions": {
     "target": "ES2022",
-    "module": "ES2022",
+    "module": "Node16",
     "lib": ["ES2022"],
-    "moduleResolution": "bundler",
+    "moduleResolution": "node16",
     "declaration": true,
     "declarationMap": true,
     "outDir": "./dist",