feat(#3361): add JSDocs comments to wrappers and common types

[bdfranck]

React and Angular wrappers lacked JSDoc comments, giving consumers no inline documentation in their IDE when using components or inspecting props.

JSDoc added across all wrappers

• Component-level descriptions on every exported class/function
• Prop-level descriptions using consistent Sets the... phrasing, with @default, @required, and @deprecated tags where applicable
• Common types (GoabInputOnChangeDetail, etc.) documented for IDE hover tooltips

Required/optional corrections (found during audit)

File	Change
file-upload-card.ts	size → @Input({ required: true }), aligned with React + Svelte
file-upload-input.ts	variant → optional with @default "dragdrop", aligned with React + Svelte
accordion.tsx	heading → optional, aligned with Angular
popover.tsx	target → required, aligned with Angular
drawer.ts, modal.ts, radio-item.ts	Removed incorrect @required JSDoc tags from optional fields

Before (the change)

No inline documentation when consuming React/Angular wrapper components — no component descriptions, no prop hints, no type documentation visible in IDEs.

After (the change)

Hovering a component or prop in any IDE shows descriptions, defaults, deprecation notices, and required flags sourced directly from the wrapper source.

Make sure that you've checked the boxes below before you submit the PR

• I have read and followed the setup steps
• I have created necessary unit tests
• I have tested the functionality in both React and Angular.

Steps needed to test

Open a project consuming @abgov/react-components or @abgov/angular-components and hover over any component or prop to verify JSDoc descriptions appear. Check @required, @default, and @deprecated tags render correctly in the IDE tooltip.

[chrisolsen]

Should this have the @required in the comment?

[Copilot]

Added @required to the slot comment in b76d497: /** @required Sets which form-item slot this content should render into. */

[bdfranck]

@copilot Make the following changes:

• Change the comments from "Defines the..." with "Sets the..."
• Change the testId comments to "Sets the data-testid attribute for automated testing."
• Make the GoabFormItemSlot comment @required

[Copilot]

@copilot Make the following changes:

• Change the comments from "Defines the..." with "Sets the..."
• Change the testId comments to "Sets the data-testid attribute for automated testing."
  ...

Done in b76d497:

• Changed all "Defines the..." comments to "Sets the..." across Angular (badge.ts, input.ts, input-number.ts) and React (badge.tsx, modal.tsx, callout.tsx) wrappers
• Updated testId comment in base.component.ts to "Sets the data-testid attribute for automated testing."
• Added @required to the GoabFormItemSlot slot comment in form-item-slot.ts

[vanessatran-ddi]

I see some properties in angular documented as Sets the ... while some are not. I checked this rule https://github.com/GovAlta/ui-components/blob/dev/CLAUDE.md?plain=1#L109 and looks like we should follow the rule starts vs Sets the .. pattern. However it is not a blocker for me.

[bdfranck]

@copilot Address the above review comments.

[Copilot]

@copilot Address the above review comments.

All review comments addressed in 97bf331:

• badge.ts: Fixed content, iconType, ariaLabel to use "Sets the..."
• block.ts: Fixed gap, direction, alignment to use "Sets the..."
• button.ts: Fixed size, disabled, leadingIcon comments
• accordion.tsx: Made heading optional, removed @required
• drawer.ts: Removed incorrect @required from heading comment
• file-upload-card.ts: Added required: true to size input + @required to JSDoc
• file-upload-input.ts: Made variant optional (aligned with React/Svelte default "dragdrop")
• modal.ts: Removed incorrect @required from heading comment
• popover.tsx: Made target required, added @required
• radio-item.ts: Removed incorrect @required from description comment

[vanessatran-ddi]

Looks good!

[chrisolsen]

You need to remove this line.