Added various fixes for default exports, updated docs

Author: alphanull

CHANGELOG.md

@@ -2,7 +2,20 @@
 
 All notable changes to this project will be documented in this file.
 
-This project adheres to [Semantic Versioning](https://semver.org) and follows the [Keep a Changelog](https://keepachangelog.com/en/1.1.0/) format.
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/), and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [1.1.0] - 2025-08-07
+
+### Added
+
+- **Fix for ES6 default export issues**: The plugin now corrects wrong names and structures for exported classes, functions, object literals, and their members.
+  - Fixes the issue where default exports appear as `exports` instead of their actual names
+  - Corrects class method scoping and memberof relationships
+  - Extracts meaningful names from `@type` annotations for object literals
+  - Properly links class members (constructor, properties, methods) to their parent class
+  - Resolves [JSDoc Issue #1132](https://github.com/jsdoc/jsdoc/issues/1132)
+  - Resolves [JSDoc Issue #2023](https://github.com/jsdoc/jsdoc/issues/2023)
+  - Resolves [JSDoc Issue #2038](https://github.com/jsdoc/jsdoc/issues/2038)
 
 ---
 

README.md

@@ -3,7 +3,7 @@
 
 # JSDoc ESNext Plugin
 
-**Smart JSDoc plugin that adds full ES2022+ class-feature support – private fields, static members and arrow-bound methods.**
+**JSDoc plugin that adds full ES2022+ class-feature support – private fields, static members, arrow-bound methods, as well as ES6 default export fixes.**
 
 Modern JavaScript syntax isn’t always accurately recognized by JSDoc. This plugin enables accurate recognition of modern ECMAScript class structures and enhances the resulting documentation.
 
@@ -14,6 +14,7 @@ Modern JavaScript syntax isn’t always accurately recognized by JSDoc. This plu
 * Detects `static` class members and applies `@static` and `scope: static`.
 * Treats arrow-bound methods as `@function`.
 * Detects assignments like `this.#foo = ...` in constructors.
+* **Fixes various ES6 default export issues** - corrects wrong names and structures for exported classes, functions, object literals, and their members.
 * Works seamlessly with JSDoc's default parser.
 * Works with all themes (but see note below!).
 * Perfectly integrates with [VisionTheme](https://github.com/alphanull/jsdoc-vision-theme) for a modern UI (optional).
@@ -35,7 +36,7 @@ Then, add the plugin to your JSDoc configuration file:
 }
 ```
 
-## Example
+## ES2022 Example
 
 ```js
 export default class Example {
@@ -73,9 +74,9 @@ export default class Example {
 }
 ```
 
-### Resulting Documentation:
+### Resulting Documentation
 
-| ![before](assets/before.jpg) | ![after](assets/after.jpg) |
+| ![before](assets/private-before.jpg) | ![after](assets/private-after.jpg) |
 | :----------------------------------------------------------: | :----------------------------------------------------------: |
 |                      **Without plugin**                      |                **Using jsdoc-plugin-esnext**                 |
 
@@ -84,6 +85,37 @@ export default class Example {
 * `#handleClick` is listed as a private function.
 * `#compute()` is listed as a private method.
 
+## Exports Example
+
+```js
+/**
+ * Exported as default class.
+ */
+export default class FooClass {
+    /**
+     * FooClass constructor.
+     * @param {string} message - Additional message.
+     */
+    constructor(message) { }
+    /**
+     * This is a class method.
+     * @param {any} someArg - An arg you need to pass.
+     */
+    classMethod(someArg) {
+    this.fooAClassMethod(this.message);
+    }
+}
+```
+
+### Resulting Documentation
+
+| ![before](assets/exports-before.jpg) | ![after](assets/exports-after.jpg) |
+| :----------------------------------------------------------: | :----------------------------------------------------------: |
+|                      **Without plugin**                      |                **Using jsdoc-plugin-esnext**                 |
+
+* `FooClass` is named correctly (not `exports`).
+* Class members (constructor, properties, methods) are correctly linked to their parent class and do not appear in `Global`.
+
 ## Limitations
 
 While there are no limitations with this plugin per se, for private members (which start with "#")  there can be resulting hash links containing two hashes, like: `<a href="##privateMember">#privateMember</a>` which can lead to broken links. Unfortunately, this cannot be handled by the plugin itself and needs to be managed by the theme.

assets/exports-after.jpg

@@ -13,19 +13,49 @@ export const handlers = {
     /**
      * Triggered when a symbol (e.g. Method or field) is found during AST traversal.
      * Used to recover names for private class members and inline assignments to `this.#foo`.
+     * Also fixes ES6 default export names during parsing.
      * @param {Object} e  The event containing symbol data and AST node information.
      */
     symbolFound(e) {
 
-        // Phase 1: Detect native private methods defined via #method() syntax
+        // Phase 1: Fix ES6 default export names during parsing
+        if (e.code?.name === 'module.exports' && (e.code?.type === 'ClassDeclaration' || e.code?.type === 'FunctionDeclaration' || e.code?.type === 'ObjectExpression')) {
+            // Check if this is a default export by looking at the parent node
+            if (e.astnode?.parent?.type === 'ExportDefaultDeclaration') {
+                const exportName = e.astnode.parent.declaration.id?.name;
+                if (exportName) {
+                    e.code.name = exportName;
+                } else if (e.code?.type === 'FunctionDeclaration' && !e.astnode.parent.declaration.id) {
+                    // For anonymous functions, generate a descriptive name
+                    e.code.name = 'anonymousFunction';
+                } else if (e.code?.type === 'ObjectExpression') {
+                    // For object literals, try to extract name from JSDoc @type annotation
+                    // This will be handled in parseComplete
+                    e.code.name = 'defaultExport';
+                }
+            }
+        }
+
+        // Phase 1.5: Fix class member relationships during parsing
+        if (e.code?.type === 'MethodDefinition' && e.astnode?.parent?.type === 'ClassBody') {
+            // This is a class method, ensure it has the correct parent reference
+            const parentClass = e.astnode.parent.parent;
+            if (parentClass?.type === 'ClassDeclaration' && parentClass.id?.name) {
+                // The method should be linked to the class name, not module.exports
+                e.code.memberof = parentClass.id.name;
+                e.code.scope = 'instance';
+            }
+        }
+
+        // Phase 2: Detect native private methods defined via #method() syntax
         if (e.code?.type === 'MethodDefinition'
           && e.code?.node?.key?.type === 'PrivateName'
           && e.code?.node?.key?.id?.name) {
 
             e.code.name = e.code.node.key.id.name;
         }
 
-        // Phase 2: Detect assignments to this.#property inside constructor or methods
+        // Phase 3: Detect assignments to this.#property inside constructor or methods
         if (e.code?.name === 'this.' // <- smells like a jsdoc parse bug
           && e.astnode?.type === 'AssignmentExpression'
           && e.astnode?.left?.type === 'MemberExpression'
@@ -105,5 +135,47 @@ export const handlers = {
                 doclet.scope = 'static';
             }
         }
+
+        // Phase 3: Fix default export names in doclets (simple approach)
+        for (const doclet of doclets) {
+            // Fix default export function names
+            if (doclet.kind === 'function' && doclet.name === 'exports' && doclet.memberof === 'module') {
+                // Find the actual function name from the doclets
+                const funcDoclet = doclets.find(d => d.kind === 'function' && d.name !== 'exports' && d.scope === 'global');
+                if (funcDoclet) {
+                    doclet.name = funcDoclet.name;
+                    doclet.longname = funcDoclet.name;
+                    doclet.memberof = undefined;
+                }
+            }
+
+            // Fix default export object literals
+            if (doclet.kind === 'member' && doclet.name === 'exports' && doclet.memberof === 'module' &&
+                doclet.meta?.code?.type === 'ObjectExpression') {
+                // Try to extract name from JSDoc @type annotation
+                const typeMatch = doclet.description?.match(/@type\s*\{([^}]+)\}/);
+                const objectName = typeMatch?.[1]?.trim() ||
+                    doclet.meta?.code?.node?.properties?.[0]?.key?.name + 'Config' ||
+                    'defaultExport';
+
+                doclet.name = objectName;
+                doclet.longname = objectName;
+                doclet.memberof = undefined;
+            }
+
+            // Fix class methods that got marked as global
+            if (doclet.kind === 'function' && doclet.scope === 'global' &&
+                doclet.meta?.code?.node?.type === 'MethodDefinition') {
+                // Find the class name
+                const classDoclet = doclets.find(d => d.kind === 'class' && d.name !== 'exports');
+                if (classDoclet) {
+                    doclet.scope = 'instance';
+                    doclet.memberof = classDoclet.name;
+                    doclet.longname = `${classDoclet.name}#${doclet.name}`;
+                    doclet.id = doclet.longname; // Also fix the id to ensure proper HTML linking
+                }
+            }
+        }
+
     }
 };

assets/exports-before.jpg

@@ -1,8 +1,8 @@
 {
     "name": "@alphanull/jsdoc-plugin-esnext",
-    "version": "1.0.0",
+    "version": "1.1.0",
     "license": "MIT",
-    "description": "Smart JSDoc plugin that adds full ES2022+ class-feature support – private fields, static members and arrow-bound methods.",
+    "description": "JSDoc plugin that adds full ES2022+ class-feature support – private fields, static members, arrow-bound methods, and ES6 default export fixes.",
     "keywords": [
         "jsdoc",
         "plugin",