fixup!

Author: aduh95

test/doctool/test-doc-api-json.mjs

@@ -77,7 +77,6 @@ function findAllKeys(obj, allKeys = new Set()) {
 
 const allExpectedKeys = new Set([
   'added',
-  'api',
   'changes',
   'classes',
   'classMethods',
@@ -97,8 +96,8 @@ const allExpectedKeys = new Set([
   'miscs',
   'modules',
   'name',
-  'optional',
   'napiVersion',
+  'optional',
   'options',
   'params',
   'pr-url',
@@ -128,18 +127,18 @@ for await (const dirent of await fs.opendir(new URL('../../out/doc/api/', import
   console.log('testing', jsonPath, 'based on', expectedSource);
 
   const fileContent = await fs.readFile(jsonPath, 'utf8');
+  // A proxy to check if the file is human readable is to count if it contains
+  // at least 3 line return.
+  assert.strictEqual(fileContent.split('\n', 3).length, 3);
 
   const json = JSON.parse(fileContent);
 
   assert.strictEqual(json.type, 'module');
   assert.strictEqual(json.source, expectedSource);
-
   if (dirent.name !== 'index.md') {
     assert.ok(json.introduced_in || Object.values(json).at(-1)?.[0].introduced_in);
-    assert.partialDeepStrictEqual(allExpectedKeys, findAllKeys(json));
   }
-
-  assert.deepStrictEqual(Object.keys(json).sort(), ['type', 'api', 'source', ...({
+  assert.deepStrictEqual(Object.keys(json), ['type', 'source', ...({
     'addons.md': ['introduced_in', 'miscs'],
     'cli.md': ['introduced_in', 'miscs'],
     'debugger.md': ['introduced_in', 'stability', 'stabilityText', 'miscs'],
@@ -148,6 +147,7 @@ for await (const dirent of await fs.opendir(new URL('../../out/doc/api/', import
     'errors.md': ['introduced_in', 'classes', 'miscs'],
     'esm.md': ['introduced_in', 'meta', 'stability', 'stabilityText', 'properties', 'miscs'],
     'globals.md': ['introduced_in', 'stability', 'stabilityText', 'classes', 'methods', 'miscs'],
+    'index.md': [],
     'intl.md': ['introduced_in', 'miscs'],
     'n-api.md': ['introduced_in', 'stability', 'stabilityText', 'miscs'],
     'packages.md': ['introduced_in', 'meta', 'miscs'],

tools/doc/package-lock.json

@@ -2,6 +2,6 @@
   "name": "doc",
   "private": true,
   "dependencies": {
-    "@nodejs/doc-kit": "https://github.com/nodejs/doc-kit/archive/2a4cbe3f59b4b811cb6f1de2cf13f4b7ff853286.tar.gz"
+    "@nodejs/doc-kit": "https://github.com/nodejs/doc-kit/archive/6ec904754a43eaaff6f16346049e2a2b44faadab.tar.gz"
   }
 }