fix(types): NodeNext-safe pem import in fxp.d.ts (fixes #808)

.github/workflows/node.js.yml

@@ -27,6 +27,7 @@ jobs:
       run: echo "PUBLISH_PLEASE_DISABLE_PROMPT=true" >> $GITHUB_ENV
     - run: npm install --ignore-scripts
     - run: npm run test
+    - run: npm run test-types-nodenext
     - uses: coverallsapp/github-action@v1.1.1
       with:
         github-token: ${{ secrets.GITHUB_TOKEN }}

package.json

@@ -22,6 +22,7 @@
   "scripts": {
     "test": "c8 --reporter=lcov --reporter=text jasmine spec/*spec.js",
     "test-types": "tsc --noEmit spec/typings/typings-test.ts",
+    "test-types-nodenext": "tsc --noEmit -p spec/typings/tsconfig.nodenext.json",
     "unit": "jasmine",
     "coverage": "nyc report --reporter html --reporter text -t .nyc_output --report-dir .nyc_output/summary",
     "perf": "node ./benchmark/perfTest3.js",

spec/typings/nodenext-import-test.ts

@@ -0,0 +1,10 @@
+/**
+ * Regression for GH-808: ESM declaration must use NodeNext-valid relative specifiers
+ * (e.g. `./pem.js` → resolves to `pem.d.ts`) so consumers with `moduleResolution: "NodeNext"`
+ * and `skipLibCheck: false` do not hit TS2834.
+ *
+ * Resolves the same entry as the package `import` types (`./src/fxp.d.ts`).
+ */
+import type { XMLParser } from "../../src/fxp.js";
+
+type _Smoke = XMLParser;

spec/typings/tsconfig.nodenext.json

@@ -0,0 +1,11 @@
+{
+  "compilerOptions": {
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "strict": true,
+    "skipLibCheck": false,
+    "noEmit": true,
+    "types": []
+  },
+  "include": ["nodenext-import-test.ts"]
+}

src/fxp.d.ts

@@ -1,4 +1,4 @@
-import type { Expression, ReadonlyMatcher } from './pem';
+import type { Expression, ReadonlyMatcher } from './pem.js';
 
 // jPath: true  → string
 // jPath: false → ReadonlyMatcher