fix: Optional JSDoc @param

[magic-akari]

• fix JSDoc: Option @param syantax missing #3576

[daxpedda]

Could you add a note in the changelog?
Otherwise looks great!

[Liamolucko]

An issue I can see here is that this will currently produce optional parameters before required parameters; e.g. this function:

#[wasm_bindgen]
pub fn foo(a: Option<i32>, b: i32) {}

generates this JSDoc:

/**
* @param {number | undefined} [a]
* @param {number} b
*/

a is marked as optional even though b is required, so it's impossible to actually leave it out.

I wasn't sure if this actually mattered, but it seems like it does because TypeScript complains about it:

test.js(5,17): error TS1016: A required parameter cannot follow an optional parameter.

[magic-akari]

An issue I can see here is that this will currently produce optional parameters before required parameters; e.g. this function:

@Liamolucko You are right. I think it should be handled by reversing the order like typescript_signature.

[daxpedda]

LGTM!
Thanks @Liamolucko for catching that.