refactor(web-react): unify approach to aria id references using useAriaIdRefs hook

[literat]

Description

Refactors ARIA ID reference management into a layered hook architecture:

• useAriaIdRefs — generic hook that manages a dynamic list of ARIA ID references for any
  relationship attribute (aria-describedby, aria-details). Returns ready-to-spread props ({}
  or { 'aria-describedby': '...' }).
• useAriaDescribedBy / useAriaDetails — convenience wrappers for better DX at call
  sites.

Removes:

• useAriaIds hook (with its format option and TypeScript overloads)
• useAriaDescribedBy hook from src/hooks/ (the old one that took string[] and returned { 'aria-describedby': '...' })

Before (3 lines per attribute):

const [ids, register] = useAriaIds(ariaDescribedBy);
const ariaDescribedByProp = useAriaDescribedBy(ids);

After (1 line):

  const [ariaDescribedByProp, register] = useAriaDescribedBy(ariaDescribedBy);

All 9 form field components (Checkbox, Toggle, Radio, Select, Slider, TextFieldBase,
FileUploaderInput, UNSTABLE_FileUpload, FieldGroup) now use the same single-line pattern.

Additional context

Research across major design systems (React Aria, Headless UI, Radix, Base UI, Ark UI, Mantine)
showed:

• Every library returns string | undefined, not string[]
• Every library omits the attribute entirely when empty ({} not { 'aria-describedby': '' })
• No library has a generic hook for multiple ARIA relationship attributes — the generic
  useAriaIdRefs is novel but motivated by Spirit needing both aria-describedby and aria-details

The specific wrappers (useAriaDescribedBy, useAriaDetails) follow the ecosystem convention of
attribute-specific naming while sharing logic internally.

Issue reference

DS-2454

[Copilot]

Pull request overview

This PR refactors how ARIA relationship attributes are composed across web-react form fields by introducing a shared hook (useAriaIdRefs) plus attribute-specific wrappers (useAriaDescribedBy, useAriaDetails), and migrating field components to a single-line pattern for registering and spreading ARIA ID references.

Changes:

• Added useAriaIdRefs (generic) and wrappers useAriaDescribedBy / useAriaDetails under components/Field, removing the old useAriaIds + old hooks-based useAriaDescribedBy.
• Migrated 9 form field components to the new hook API (returning ready-to-spread props + register).
• Updated related tests and documentation to match the new hook architecture.

Reviewed changes

Copilot reviewed 21 out of 21 changed files in this pull request and generated 4 comments.

Show a summary per file

File	Description
packages/web-react/src/hooks/useAriaDescribedBy.ts	Removed old hooks-level useAriaDescribedBy implementation.
packages/web-react/src/hooks/index.ts	Stopped exporting the removed hooks-level useAriaDescribedBy.
packages/web-react/src/hooks/tests/useAriaDescribedBy.test.ts	Removed tests for the deleted hooks-level implementation.
packages/web-react/src/components/UNSTABLE_FileUpload/UNSTABLE_FileUpload.tsx	Migrated to useAriaDescribedBy from Field (new API).
packages/web-react/src/components/Toggle/Toggle.tsx	Migrated to new useAriaDescribedBy + useAriaDetails API.
packages/web-react/src/components/TextFieldBase/TextFieldBase.tsx	Migrated to new useAriaDescribedBy API.
packages/web-react/src/components/Slider/Slider.tsx	Migrated to new useAriaDescribedBy API.
packages/web-react/src/components/Select/Select.tsx	Migrated to new useAriaDescribedBy API.
packages/web-react/src/components/Radio/Radio.tsx	Migrated to new useAriaDescribedBy API.
packages/web-react/src/components/InputDetails/types.ts	Updated RegisterType import to come from useAriaIdRefs.
packages/web-react/src/components/InputDetails/README.md	Updated docs to reference useAriaDetails instead of useAriaIds.
packages/web-react/src/components/FileUploader/FileUploaderInput.tsx	Migrated to new useAriaDescribedBy API.
packages/web-react/src/components/FieldGroup/FieldGroup.tsx	Migrated to new useAriaDescribedBy API.
packages/web-react/src/components/Field/useAriaIds.tsx	Removed old useAriaIds hook (format overloads, array/string output).
packages/web-react/src/components/Field/useAriaIdRefs.tsx	Added new generic hook and wrappers; returns ready-to-spread ARIA props.
packages/web-react/src/components/Field/types.ts	Updated RegisterType import to new hook module.
packages/web-react/src/components/Field/index.ts	Updated exports to remove useAriaIds and export useAriaIdRefs helpers.
packages/web-react/src/components/Field/tests/useAriaIds.test.tsx	Removed tests for deleted useAriaIds.
packages/web-react/src/components/Field/tests/useAriaIdRefs.test.tsx	Added test coverage for useAriaIdRefs + wrappers.
packages/web-react/src/components/Field/README.md	Updated documentation for new ARIA ID ref hooks and usage.
packages/web-react/src/components/Checkbox/Checkbox.tsx	Migrated to new useAriaDescribedBy + useAriaDetails API.

[Copilot]

Pull request overview

Copilot reviewed 22 out of 22 changed files in this pull request and generated 3 comments.

[Copilot]

Pull request overview

Copilot reviewed 22 out of 22 changed files in this pull request and generated no new comments.