jsdoc

[程序员包子]

Describe the feature

Please tell me how to configure it so that jsdoc can be retained during packaging.

Additional information

• Would you be willing to help implement this feature?

[程序员包子]

config
export default defineBuildConfig({
entries: [
'src/index',
'src/cli/index',
],
declaration: true,
clean: true,
rollup: {
emitCJS: true,
},
})

[Marco Solazzi]

@coderbaozi because unbuild uses esbuild for bundling, I don't think there a global way to retain JSDoc comments.

What you can do, is to add the @preserve tag to those comment blocks you want to keep. For example:

/**
 * A log Function
 * @param  {...any} args Arguments to log
 * @returns {void}
 * @preserve
 */
export const log = (...args) => {
  console.log(...args);
};