Improved error handling and weather file documentation for v1 release

[iantsednv]

Error Handling

• Raise SolarFarmerAPIError on API failures instead of returning None — exception includes status code, message, and full error details
• Fix type annotation bugs in Response.problem_details_json and _log_api_failure

Documentation Fixes

• Fix gridConnectionLimit units (Watts, not MW)
• Document spec ID ↔ filename stem convention for PAN/OND files
• Document bifacial mounting requirements and rack height constraints
• Add comprehensive calculationYear + TMY timestamp interaction docs (warns about silent partial-year calculations)

Weather File Spec

• Add solarfarmer.weather.TSV_COLUMNS — machine-readable TSV format spec with all accepted header aliases, units, ranges, and sentinel values
• Enrich MeteoFileFormat enum with per-value docstrings and inline TSV example
• Cross-reference weather-dependent EnergyCalculationOptions fields