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.

[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.

[vanessatran-ddi]

Looks good!

[netlify]

✅ Deploy Preview for benji-docs-previews ready!

Name	Link
🔨 Latest commit	7afd6cd
🔍 Latest deploy log	https://app.netlify.com/projects/benji-docs-previews/deploys/69dd461aa56e150008dfe5b5
😎 Deploy Preview	https://deploy-preview-3715--benji-docs-previews.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.

---

To edit notification comments on pull requests, go to your Netlify project configuration.

[bdfranck]

@copilot Address the latest review comments on this PR.

[Copilot]

@copilot Address the latest review comments on this PR.

All review comments addressed in b8f8148:

• form-item.tsx + form-item.ts: Removed invalid compact from GoabFormItemLabelSize JSDoc
• checkbox-list.ts: Fixed onChange comment — "labels" → "event"
• radio-group.ts: Fixed onChange comment — "label" → "event"
• form-stepper.ts: Removed non-existent stepIndex from onChange comment
• tabs.ts: Removed non-existent heading from onChange comment
• notification.ts: Fixed emphasis comment — filled → low
• common.ts: Added "normal" to GoabBlockAlignment type
• modal.tsx: Updated onClose comment to mention it enables the close button

[bdfranck]

I squashed co-pilot's commit into mine.

[chrisolsen]

🎉 This PR is included in version 2.0.0-dev.3 🎉

The release is available on:

• npm package (@dev dist-tag)
• GitHub release

Your semantic-release bot 📦🚀

[chrisolsen]

🎉 This PR is included in version 2.0.0-dev.8 🎉

The release is available on:

• npm package (@dev dist-tag)
• GitHub release

Your semantic-release bot 📦🚀

[chrisolsen]

🎉 This PR is included in version 7.0.0-dev.3 🎉

The release is available on:

• npm package (@dev dist-tag)
• GitHub release

Your semantic-release bot 📦🚀

[chrisolsen]

🎉 This PR is included in version 5.0.0-dev.4 🎉

The release is available on:

• npm package (@dev dist-tag)
• GitHub release

Your semantic-release bot 📦🚀