tmp

Signed-off-by: flakey5 <[email protected]>

Author: flakey5

package-lock.json

@@ -55,6 +55,8 @@
     "reading-time": "^1.5.0",
     "recma-jsx": "^1.0.0",
     "rehype-recma": "^1.0.0",
+    "json-schema-to-typescript": "^15.0.4",
+    "jsonc-parser": "^3.3.1",
     "rehype-stringify": "^10.0.1",
     "remark-gfm": "^4.0.1",
     "remark-parse": "^11.0.0",

package.json

@@ -12,6 +12,8 @@ import legacyJsonAll from './legacy-json-all/index.mjs';
 import llmsTxt from './llms-txt/index.mjs';
 import manPage from './man-page/index.mjs';
 import oramaDb from './orama-db/index.mjs';
+import json from './json/index.mjs';
+import jsonAll from './json-all/index.mjs';
 
 export const publicGenerators = {
   'json-simple': jsonSimple,
@@ -25,6 +27,8 @@ export const publicGenerators = {
   'orama-db': oramaDb,
   'llms-txt': llmsTxt,
   'jsx-ast': jsxAst,
+  json,
+  'json-all': jsonAll,
 };
 
 export const allGenerators = {

src/generators/index.mjs

@@ -0,0 +1,78 @@
+// @ts-check
+'use strict';
+
+import { writeFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { DOC_NODE_VERSION } from '../../constants.mjs';
+import { generateJsonSchema } from './util/generateJsonSchema.mjs';
+
+// TODO add test w/ https://www.npmjs.com/package/jsonschema
+
+/**
+ * TODO docs
+ *
+ * @typedef {Array<ApiDocMetadataEntry>} Input
+ *
+ * @type {GeneratorMetadata<Input, object>}
+ */
+export default {
+  name: 'json-all',
+
+  // This should be kept in sync with the JSON schema version for this
+  // generator AND the `json` generator
+  version: '2.0.0',
+
+  description: 'TODO',
+
+  dependsOn: 'json',
+
+  /**
+   * Generates a JSON file.
+   *
+   * @param {Input} input
+   * @param {Partial<GeneratorOptions>} param1
+   * @returns {Promise<object>}
+   */
+  async generate(input, { output }) {
+    const generatedValue = {
+      $schema: `https://nodejs.org/docs/${DOC_NODE_VERSION}/api/node-doc-all-schema.jsonc`,
+      modules: [],
+      text: [],
+    };
+
+    const propertiesToIgnore = ['$schema', 'source'];
+
+    input.forEach(section => {
+      const copiedSection = {};
+
+      Object.keys(section).forEach(key => {
+        if (!propertiesToIgnore.includes(key)) {
+          copiedSection[key] = section[key];
+        }
+      });
+
+      switch (section.type) {
+        case 'module':
+          generatedValue.modules.push(copiedSection);
+          break;
+        case 'text':
+          generatedValue.text.push(copiedSection);
+          break;
+        default:
+          throw new TypeError(`unsupported root section type ${section.type}`);
+      }
+    });
+
+    if (output) {
+      const schema = generateJsonSchema();
+
+      // Write the parsed JSON schema to the output directory
+      await writeFile(
+        join(output, 'node-doc-schema.json'),
+        JSON.stringify(schema)
+      );
+    }
+
+    return generatedValue;
+  },
+};

src/generators/json-all/index.mjs

@@ -0,0 +1,26 @@
+// @ts-check
+'use strict';
+
+import { DOC_NODE_VERSION } from '../../../constants.mjs';
+
+const JSON_SCHEMA_URL = `https://nodejs.org/docs/${DOC_NODE_VERSION}/api/node-doc-schema.json`;
+
+export const generateJsonSchema = () => ({
+  $schema: 'http://json-schema.org/draft-07/schema#',
+  // This should be kept in sync with the generator version for this generator
+  // AND the `json` generator and schema
+  $id: '[email protected]', // This should be kept in sync with the generator version.
+  title: 'Node.js API Documentation Schema (All)',
+  readOnly: true,
+
+  properties: {
+    modules: {
+      type: 'array',
+      items: { $ref: `${JSON_SCHEMA_URL}/#/definitions/Module` },
+    },
+    text: {
+      type: 'array',
+      items: { $ref: `${JSON_SCHEMA_URL}/#/definitions/Text` },
+    },
+  },
+});

src/generators/json-all/util/generateJsonSchema.mjs

@@ -0,0 +1 @@
+'use strict';