Version 5.6.0
=============

This release introduces **OCL Constraint Validation** in the generated backend and frontend, 
along with improved error handling in React components and comprehensive documentation restructuring.

New Features
------------

**OCL Constraint Validation in Backend**

* Added automatic generation of **Pydantic field validators from OCL constraints** defined in B-UML models.
* OCL expressions are parsed using BESSER's ANTLR-based OCL parser and transformed into Python validation code.
* Supported OCL comparison operators: ``>``, ``<``, ``>=``, ``<=``, ``=``, ``<>``
* Supported value types: ``int``, ``float``, ``str``, ``bool``
* New utility module ``ocl_utils.py`` for OCL constraint parsing with fallback regex parser.

Example constraint:

.. code-block:: python

    constraint = Constraint(
        name="min_age",
        context=Player,
        expression="context Player inv: self.age > 10",
        language="OCL"
    )

Generated validator:

.. code-block:: python

    @field_validator('age')
    @classmethod
    def validate_age_1(cls, v):
        if not (v > 10):
            raise ValueError('age must be > 10')
        return v

**Frontend Validation Error Display**

* **TableComponent**: Now displays backend validation errors (HTTP 422) in a red box inside the form modal.
* **TableComponent**: Modal stays open on errors so users can fix and retry without re-entering data.
* **MethodButton**: Improved error handling for HTTP 500 errors with detailed error message extraction.
* **MethodButton**: Modal stays open on errors for methods with parameters.
* Error messages are parsed from FastAPI/Pydantic response format and displayed in user-friendly format.

Improvements
------------

**Documentation Restructuring**

* Reorganized ``generators.rst`` with generators grouped by category
* Enhanced ``full_web_app.rst`` as the main Web App Generator documentation with:
    * Sub-generator dropdown (backend, pydantic, alchemy, rest_api)
    * Features section covering methods, OCL validation, error handling
    * REST API endpoints summary
* Added OCL Constraint Validation section to Pydantic Generator documentation.