fix(api): Isolate API package validation consumers from ambient type definitions (#1800)

## Related Issue
Fixes #1799 

## Changes Proposed
* **[API Test Configurations]**: Configured `"types": ["node",
"vscode"]` and `"typeRoots": ["../node_modules/@types"]` in
`api/test/tsconfig.modern.json` and `api/test/tsconfig.legacy.json` to
prevent `tsc` from traversing parent directories for ambient type
definitions.
* **[Test Package Runner]**: Updated `api/scripts/test-package.cjs` to
resolve `typescript/bin/tsc` dynamically via `createRequire` instead of
hardcoding `packageRoot/node_modules/typescript/bin/tsc`.
* **[API Package Scripts]**: Added `"test": "npm run test:package"` to
`api/package.json` so standard `npm test` runs package validation.

## How Has This Been Tested?
Please describe the tests that you ran to verify your changes.
* [x] Test A: `npm --prefix api run test:package` completed with 0
errors (modern and legacy consumers verified).
* [x] Test B: `npm --prefix api test` ran successfully.
* [x] Test C: Root unit tests (`npm run unittest`) passed with 2,411
passing tests.
* [x] Test D: Root linter (`npm run lint`) passed with 0
errors/warnings.
* [x] Test E: TypeScript compilation (`npm run compile-tests`) succeeded
with 0 errors.

## Checklist
- [x] My code follows the style guidelines of this project
- [x] I have performed a self-review of my own code
- [x] I have commented my code, particularly in hard-to-understand areas
- [x] My changes generate no new warnings

Author: SatyamPandey-07

api/package.json

@@ -46,6 +46,7 @@
         "compile:esm": "tsc -b ./tsconfig.esm.json && mve out/esm/main.js out/esm/main.mjs && node -e \"require('fs').writeFileSync('out/esm/package.json', '{\\\"type\\\":\\\"module\\\"}')\"",
         "compile:cjs": "tsc -b ./tsconfig.cjs.json && mve out/cjs/main.js out/cjs/main.cjs",
         "clean": "node -e \"const fs = require('fs'); fs.rmSync('./out', { recursive: true, force: true });\"",
+        "test": "npm run test:package",
         "test:package": "node ./scripts/test-package.cjs"
     },
     "devDependencies": {

api/scripts/test-package.cjs

@@ -55,7 +55,8 @@ try {
         testRoot,
     );
 
-    const typescriptCli = path.join(packageRoot, 'node_modules', 'typescript', 'bin', 'tsc');
+    const packageRequire = createRequire(path.join(packageRoot, 'package.json'));
+    const typescriptCli = packageRequire.resolve('typescript/bin/tsc');
     const fixtureRoot = path.join(packageRoot, 'test');
 
     for (const consumer of [

api/test/tsconfig.legacy.json

@@ -5,7 +5,9 @@
         "moduleResolution": "Node",
         "noEmit": true,
         "strict": true,
-        "skipLibCheck": false
+        "skipLibCheck": false,
+        "types": ["node", "vscode"],
+        "typeRoots": ["../node_modules/@types"]
     },
     "include": ["consumer.ts"]
 }

api/test/tsconfig.modern.json

@@ -5,7 +5,9 @@
         "moduleResolution": "NodeNext",
         "noEmit": true,
         "strict": true,
-        "skipLibCheck": false
+        "skipLibCheck": false,
+        "types": ["node", "vscode"],
+        "typeRoots": ["../node_modules/@types"]
     },
     "include": ["consumer.ts"]
 }