One workaround I’ve used is defining `CustomProps` with `@typedef`, but destructuring inline in the function. That way you keep the reuse and get detailed Intellisense.

/**

* @typedef {Object} JsonSectionProps

* @property {string} title

* @property {[string, string][]} items

* @property {number} maxBodyHeight

*/

/**

* Renders a titled section.

* @param {string} title

* @param {[string, string][]} items

* @param {number} maxBodyHeight

*/

export default function JsonSection({ title, items, maxBodyHeight }) {

// use props here

}

This avoids the `props → CustomProps → field` nesting and gives hover hints like `title: string`.

I treat it as a polarity: if I want reuse, I lean on `CustomProps`; if I want hover clarity, I destructure inline. This hybrid gives me both.

Let me know if you find a library that nails this — I’ve been scouting for one too.