Optimize lib for large datasets

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

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

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

The issue names no files, tests, or entry points. Start by locating the library's type-handling and error-reporting paths, then reproduce the reported cases and identify the messages that need more detail. Done means the relevant errors are more descriptive and coverage verifies the new behavior.

Written by the indexing model from the issue text.