fix(legacy-json): more identical output

Author: avivkeller

src/generators/legacy-json/utils/buildSection.mjs

@@ -102,13 +102,17 @@ export const createSectionBuilder = () => {
    * @param {Array} nodes - The remaining AST nodes.
    * @param {import('../types.d.ts').HierarchizedEntry} entry - The entry providing stability information.
    */
-  const parseStability = (section, nodes, { stability }) => {
-    const stabilityInfo = stability.children.map(node => node.data)?.[0];
+  const parseStability = (section, nodes, { stability, content }) => {
+    const stabilityNode = stability.children[0];
 
-    if (stabilityInfo) {
-      section.stability = Number(stabilityInfo.index);
-      section.stabilityText = stabilityInfo.description;
-      nodes.shift(); // Remove stability node from processing
+    if (stabilityNode) {
+      section.stability = Number(stabilityNode.data.index);
+      section.stabilityText = stabilityNode.data.description;
+
+      const nodeToRemove = content.children.findIndex(
+        ({ data }) => data === stabilityNode.data
+      );
+      nodes.splice(nodeToRemove - 1, 1);
     }
   };
 
@@ -153,7 +157,10 @@ export const createSectionBuilder = () => {
    * @param {import('../types.d.ts').Section} parent - The parent section.
    */
   const addToParent = (section, parent) => {
-    const key = SECTION_TYPE_PLURALS[section.type] || 'miscs';
+    const key =
+      SECTION_TYPE_PLURALS[section.__promote ?? section.type] || 'miscs';
+
+    delete section.__promote;
 
     parent[key] ??= [];
     parent[key].push(section);

src/generators/legacy-json/utils/parseList.mjs

@@ -109,7 +109,12 @@ export function parseList(section, nodes) {
     case 'property':
       // For properties, update type and other details if values exist
       if (values.length) {
-        leftHandAssign(section, values[0]);
+        delete values[0].name;
+
+        Object.assign(section, values[0]);
+
+        // TODO(@avivkeller): There is probably a better way to do this.
+        section.__promote = 'property';
       }
       break;
 

src/utils/parser/constants.mjs

@@ -45,7 +45,10 @@ const PROPERTY = `${CAMEL_CASE}(?:(\\[${CAMEL_CASE}\\])|\\.(\\w+))`;
 export const DOC_API_HEADING_TYPES = [
   {
     type: 'method',
-    regex: new RegExp(`^\`${PROPERTY}${FUNCTION_CALL}\`$`, 'i'),
+    regex: new RegExp(
+      `^\`(?:${PROPERTY}|(${CAMEL_CASE}))${FUNCTION_CALL}\`$`,
+      'i'
+    ),
   },
   { type: 'event', regex: /^Event: +`'?([^']+)'`$/i },
   {