Neurocaps

🚀 New/Added
- Method chaining for several methods in the `CAP` and `TimeseriesExtractor` class.

🐛 Fixes
- Add type hints to properties.
- Improve accuracy of type hints for the properties.
- Fixes type hints for certain parameters that included numpy.ndarray.
- Replaces any returns that implies a plot object is returned and replaces with None for clarity.
- Raise type error when ``self.subject_table`` in ``CAP`` is set but is not a dictionary.

- Primarily to ensure all the latest distributions have the correct documentation links.
- Includes some internal code changes that won't change results.
- TODO for future version is to support Python 3.13.

- Cleaning some of the API, specifically parameter names and properties, no defaults have been changed in
this update.

[API for 0.18.0 versions](https://neurocaps.readthedocs.io/en/0.18.9/api.html)

[API for 0.19.0](https://neurocaps.readthedocs.io/en/stable/api.html)

🚀 New/Added
- ``suffix_filename`` added to ``CAP.caps2plot``, ``CAP.caps2surf``, ``CAP.caps2radar``, and ``transition_matrix``.
This addition was done to allow the ``suffix_title`` parameter in each of the previously listed methods to only be
responsible for the title of the plots. The suffix filename will also be appended to the end of the default filename.

- ``CAP`` class now has a ``cluster_scores`` property to consolodate the ``inertia``, ``davies_bouldin``, ``silhouette``,
and "variance_ratio" scores into a property instead of separate properties. Consequently, the ``inertia``,
``davies_bouldin``, ``silhouette``, and "variance_ratio" have been removed.

The structure of this property is:


{
"Cluster_Selection_Method": str, e.g., "elbow", "davies_bouldin", "silhouette", or "variance_ratio"
"Scores": {
"GroupName": {
2: float, Score for 2 clusters
3: float, Score for 3 clusters
4: float, Score for 4 clusters
},
}
}


♻ Changed
- Any instance of ``file_name`` in a parameter name has been changed to the more conventional parameter name ``filename``.
For instance, ``suffix_file_name`` now becomes ``suffix_filename`` and ``file_names`` becomes ``filenames``. This
change effects the following functions: ``merge_dicts``, ``standardize``, ``change_dtypes``, ``CAP.calculate_metrics``,
``CAP.caps2niftis``, ``TimeseriesExtractor.timeseries_to_pickle``, and ``TimeseriesExtractor.visualize_bold``.
- Warning logged whenever file name parameter is used but ``output_dir`` is not specified.

📖 Documentation
- Fix doc parameter error for ``CAP.caps2niftis`` that used ``suffix_title`` instead of ``suffix_file_name``, which
is now ``suffix_filename``.
- In documentation, version labels restricted to changes or additions make from 0.18.0 and above for less clutter.