fix: improve JSDoc parameter validation for optional and destructured params

[Zih0]

• Fix false "unused @param" errors for optional parameters (options?: T) by using getNonNullableType() to unwrap
  the union type before resolving interface properties
• Fix cross-mismatch between JSDoc virtual root names and destructured parameters by matching them positionally

Details

Optional parameter fix

When a parameter is optional (options?: Options), param.getType() returns T | undefined.
getSymbol() on a union type returns undefined, causing all sub-properties to be unresolved. Adding
getNonNullableType() strips the undefined before symbol lookup.

Destructured parameter fix

JSDoc documents destructured params with a virtual root name:

// Code: ({ baseUrl }: Options)
// JSDoc: @param options / @param options.baseUrl

collectParameterPaths now returns structured ParameterPathEntry objects with a destructured flag.
FunctionValidator.resolveDestructuredNames assigns JSDoc root names to destructured params by position.

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
docflow-docs	Ready	Preview, Comment	Mar 29, 2026 11:47am