Add JSDoc comments to all custom React hooks

[Chuks-coderr]

Description

Add JSDoc comments to every custom React hook in the codebase documenting the hook's purpose, its parameters and their types, and the shape of its return value so contributors and IDE tooling can display inline documentation.

Acceptance Criteria

• Feature is fully implemented
• Tests pass
• Lint/type checks pass
• PR references this issue number

Notes

⚠️ Do not begin coding until you have been assigned by the maintainer.
Branch as feat/492-jsdoc-custom-hooks where N is this issue number.