method-shorthand-jsdoc

To preserve JSDoc on methods returned by a factory function, move internal helper functions into the return object using method shorthand. This attaches inline documentation directly to the methods, ensuring proper IDE hover visibility for consumers.

IDE hover documentation disappears because internal helpers are scoped outside the returned object. Inlining these helpers as method shorthand members within the return object ensures JSDoc remains visible and properly attached to the exposed methods.

The method shorthand refactor pattern transforms internal helper functions into properties of the returned object. This allows sibling methods to reference each other via this-calls while preserving inline JSDoc for both consumers and internal method calls.

Yes, you can use this-calls between methods in a factory function without losing JSDoc by defining members with method shorthand. This enables sibling methods to invoke each other via this while maintaining accurate IDE hover documentation.

You should inline helpers into a return object using method shorthand when the helpers are used exclusively by returned methods in a JavaScript or TypeScript factory pattern. This approach improves code readability and preserves inline documentation.

Refactoring internal helpers to method shorthand preserves TypeScript type inference within factory-style functions. By exposing helpers as methods on the returned object, the pattern maintains proper IDE hover documentation and enables seamless this-calls between methods.