Refactor components for better readability

**Problem**
When working with lib, the error messages could be more descriptive.

**Suggestion**
Improve error handling and add detailed error messages.

**Context**
This would help with debugging and maintenance.

Start by reading the components under lib and tracing the existing error-handling paths. Identify which error messages are currently too vague and determine how the components can be made more readable without changing their behavior. Done means the relevant errors provide useful debugging context and the affected code is clearer, with the existing checks still passing.

Written by the indexing model from the issue text.