Enhance parser with typing, test suite, configurable debug and pyproject.toml fix

[JaskRendix]

PR introduces several improvements:

• adds full type annotations across the parser module for better clarity and tooling support
• introduces a comprehensive unit test suite to validate parsing behavior and edge cases
• refactors the parse() method to allow configurable debug and write_tables options
• fixes an issue in pyproject.toml where the README was incorrectly set to Readme.rst; it now correctly points to README.md
• adds a command-line interface (CLI) for parsing IDF files directly via terminal
• introduces a parse_file() helper for streamlined file-based parsing with error handling
• enhances error reporting with clearer diagnostics for syntax, file and unexpected issues
• prints object type counts and total parsed objects for quick validation after parsing