Add optional Parquet page index writes

[adonm]

What changes?

Adds an opt-in write.parquet.page-index-enabled table property. When enabled, PyIceberg passes write_page_index=True to PyArrow's ParquetWriter, producing Parquet column and offset indexes for page-level predicate pruning.

The default is false, preserving existing output and file-size behavior.

Why?

PyArrow supports page-index writing, but PyIceberg did not expose it through table properties. Readers such as ClickHouse can use these indexes to avoid decoding nonmatching pages for selective queries.

Testing

• Added a direct unit test for default/opt-in writer kwargs
• Extended the existing Parquet writer-property integration parameterization
• PYTHONPATH=. uv run pytest tests/io/test_pyarrow.py -k parquet_page_index_writer_property -q — passed
• ruff check on changed Python files — passed
• git diff --check — passed