method-shorthand-jsdoc

SKILL.md

When factory functions have helper functions that are only used by returned methods, move them INTO the return object using method shorthand. This ensures JSDoc comments are properly passed through to consumers.

When you hover over head.getEpoch() in your IDE, you see... nothing. The JSDoc is lost.

Move the helper INTO the return object using method shorthand:

Mueva las funciones auxiliares a los objetos de retorno utilizando la abreviatura de métodos para una conservación adecuada de JSDoc. Úselo cuando las funciones de fábrica tengan ayudas internas que deberían exponer la documentación a los consumidores, o cuando al pasar el cursor sobre los métodos devueltos no se muestra JSDoc. Fuente: epicenterhq/epicenter.

Ver original