@@ -31,7 +31,7 @@ jobs:
       name: github-pages
       url: ${{ steps.deployment.outputs.page_url }}
     steps:
-      - uses: actions/checkout@v5
+      - uses: actions/checkout@v7
       - name: Assemble site
         run: |
           mkdir -p _site/schemas/statechart
@@ -44,8 +44,8 @@ jobs:
           <p>See the <a href="schemas/statechart/v1.json">statechart JSON Schema</a> or the
           <a href="https://python-statemachine.readthedocs.io/">documentation</a>.</p>
           HTML
-      - uses: actions/upload-pages-artifact@v3
+      - uses: actions/upload-pages-artifact@v5
         with:
           path: _site
       - id: deployment
-        uses: actions/deploy-pages@v4
+        uses: actions/deploy-pages@v5
@@ -21,16 +21,16 @@ jobs:
         python-version: ["3.10", "3.11", "3.12", "3.13", "3.14"]
 
     steps:
-    - uses: actions/checkout@v5
+    - uses: actions/checkout@v7
     - run: git fetch origin develop
     - name: Set up Python ${{ matrix.python-version }}
-      uses: actions/setup-python@v6
+      uses: actions/setup-python@v7
       with:
         python-version: ${{ matrix.python-version }}
     - name: Setup Graphviz
       uses: ts-graphviz/setup-graphviz@v2
     - name: Install uv
-      uses: astral-sh/setup-uv@v8.1.0
+      uses: astral-sh/setup-uv@v10.1.0
       with:
         enable-cache: true
         cache-suffix: "python${{ matrix.python-version }}"
@@ -55,7 +55,7 @@ jobs:
       #          upload coverage
       #----------------------------------------------
     - name: Upload coverage to Codecov
-      uses: codecov/codecov-action@v6
+      uses: codecov/codecov-action@v7
       if: matrix.python-version == 3.14
       with:
         token: ${{ secrets.CODECOV_TOKEN }} # not required for public repos
 
@@ -11,20 +11,20 @@ jobs:
     permissions:
       id-token: write
     steps:
-      - uses: actions/checkout@v5
+      - uses: actions/checkout@v7
 
       - run: git fetch origin develop
 
       - name: Setup Python
-        uses: actions/setup-python@v6
+        uses: actions/setup-python@v7
         with:
           python-version: '3.14'
 
       - name: Setup Graphviz
         uses: ts-graphviz/setup-graphviz@v2
 
       - name: Install uv
-        uses: astral-sh/setup-uv@v8.1.0
+        uses: astral-sh/setup-uv@v10.1.0
         with:
           enable-cache: true
 
@@ -40,7 +40,7 @@ jobs:
           uv build
 
       - name: Upload  dists
-        uses: actions/upload-artifact@v4
+        uses: actions/upload-artifact@v7
         with:
           name: release-dists
           path: dist/
@@ -59,7 +59,7 @@ jobs:
 
     steps:
       - name: Retrieve release distributions
-        uses: actions/download-artifact@v4
+        uses: actions/download-artifact@v8
         with:
           name: release-dists
           path: dist/
 
@@ -9,7 +9,7 @@ repos:
         exclude: docs/auto_examples
 - repo: https://github.com/astral-sh/ruff-pre-commit
   # Ruff version.
-  rev: v0.15.17
+  rev: v0.16.7
   hooks:
     # Run the linter.
     - id: ruff
 
@@ -214,6 +214,7 @@ Sphinx directive):
 ```python
 from statemachine.contrib.diagram import formatter
 
+
 @formatter.register_format("plantuml", "puml")
 def _render_plantuml(machine_or_class):
     # your PlantUML renderer here
@@ -525,6 +526,7 @@ class CustomDiagram(DotGraphMachine):
     graph_rankdir = "TB"
     state_active_fillcolor = "lightyellow"
 
+
 sm = OrderControl()
 sm.receive_payment(10)
 
 
@@ -254,7 +254,7 @@ listeners. They can point to properties, attributes, or methods:
 **Parentheses** control evaluation order:
 
 ```python
-cond="(is_admin or is_moderator) and not is_banned"
+cond = "(is_admin or is_moderator) and not is_banned"
 ```
 
 #### Expression examples
 
@@ -28,16 +28,13 @@ class OrderState(ABC):
     """Abstract base for all order states."""
 
     @abstractmethod
-    def confirm(self, order):
-        ...
+    def confirm(self, order): ...
 
     @abstractmethod
-    def ship(self, order):
-        ...
+    def ship(self, order): ...
 
     @abstractmethod
-    def deliver(self, order):
-        ...
+    def deliver(self, order): ...
 
 
 class DraftState(OrderState):
 
@@ -233,7 +233,7 @@ that reads SCXML, JSON and YAML *documents* straight into a `StateChart`:
 ```python
 from statemachine.io import load
 
-Machine = load("traffic_light.scxml")   # or .json / .yaml; format detected from the extension
+Machine = load("traffic_light.scxml")  # or .json / .yaml; format detected from the extension
 ```
 
 Expressions in the document (guards, datamodel) are evaluated by a restricted allowlist —
@@ -306,8 +306,8 @@ True
 In *transitions*, events are called as methods on the model:
 
 ```python
-machine.produce()   # triggers the "produce" event
-machine.deliver()   # triggers the "deliver" event
+machine.produce()  # triggers the "produce" event
+machine.deliver()  # triggers the "deliver" event
 ```
 
 python-statemachine supports both styles:
@@ -342,13 +342,15 @@ Callbacks are specified as strings (method names) or callables:
 ```python
 machine = Machine(
     states=states,
-    transitions=[{
-        "trigger": "produce",
-        "source": "draft",
-        "dest": "producing",
-        "before": "validate_job",
-        "after": "notify_team",
-    }],
+    transitions=[
+        {
+            "trigger": "produce",
+            "source": "draft",
+            "dest": "producing",
+            "before": "validate_job",
+            "after": "notify_team",
+        }
+    ],
     initial="draft",
 )
 ```
@@ -454,7 +456,9 @@ In *transitions*:
 
 ```python
 machine.add_transition(
-    "produce", "draft", "producing",
+    "produce",
+    "draft",
+    "producing",
     conditions=["is_valid", "has_resources"],
     unless=["is_locked"],
 )
@@ -588,10 +592,12 @@ See {ref}`invoke` for full documentation.
 ```python
 from transitions.extensions import AsyncMachine
 
+
 class AsyncModel:
     async def on_enter_producing(self):
         await some_async_operation()
 
+
 machine = AsyncMachine(model=AsyncModel(), states=states, initial="draft")
 await machine.produce()
 ```
@@ -752,6 +758,7 @@ No class swapping, no feature matrices to consult — just `StateChart`.
 class MyModel:
     pass
 
+
 model = MyModel()
 machine = Machine(model=model, states=states, transitions=transitions, initial="draft")
 model.produce()  # events are added to the model
 
@@ -120,10 +120,11 @@ from statemachine import State
 
 class CampaignMachine(StateChart):
     "A workflow machine"
-    draft = State('Draft', initial=True, value=1)
-    producing = State('Being produced', value=2)
-    closed = State('Closed', value=3)
-    cancelled = State('Cancelled', value=4)
+
+    draft = State("Draft", initial=True, value=1)
+    producing = State("Being produced", value=2)
+    closed = State("Closed", value=3)
+    cancelled = State("Cancelled", value=4)
 
     add_job = draft.to.itself() | producing.to.itself()
     produce = draft.to(producing)
@@ -142,9 +143,9 @@ from statemachine.mixins import MachineMixin
 
 
 class Campaign(models.Model, MachineMixin):
-    state_machine_name = 'campaign.statemachines.CampaignMachine'
-    state_machine_attr = 'sm'
-    state_field_name = 'step'
+    state_machine_name = "campaign.statemachines.CampaignMachine"
+    state_machine_attr = "sm"
+    state_field_name = "step"
 
     name = models.CharField(max_length=30)
     step = models.IntegerField()
 
@@ -27,14 +27,15 @@ Transitions now support `cond` and `unless` parameters, to restrict
 the execution.
 
 ```python
-    class ApprovalMachine(StateMachine):
-        "A workflow machine"
-        requested = State("Requested", initial=True)
-        accepted = State("Accepted")
-        rejected = State("Rejected")
-        completed = State("Completed")
+class ApprovalMachine(StateMachine):
+    "A workflow machine"
+
+    requested = State("Requested", initial=True)
+    accepted = State("Accepted")
+    rejected = State("Rejected")
+    completed = State("Completed")
 
-        validate = requested.to(accepted, cond="is_ok") | requested.to(rejected)
+    validate = requested.to(accepted, cond="is_ok") | requested.to(rejected)
 ```
 
 ```{seealso}
@@ -114,9 +115,10 @@ So, the previous code (not valid anymore):
 ```py
 class ApprovalMachine(StateMachine):
     "A workflow machine"
-    requested = State('Requested', initial=True)
-    accepted = State('Accepted')
-    rejected = State('Rejected')
+
+    requested = State("Requested", initial=True)
+    accepted = State("Accepted")
+    rejected = State("Rejected")
 
     validate = requested.to(accepted, rejected)
 
@@ -133,6 +135,7 @@ Should be rewritten to use {ref}`guards`, like this:
 ``` py
 class ApprovalMachine(StateMachine):
     "A workflow machine"
+
     requested = State("Requested", initial=True)
     accepted = State("Accepted")
     rejected = State("Rejected")
@@ -168,14 +171,16 @@ This was the previous behavior, you only got an error when trying to instantiate
 ```py
 class CampaignMachine(StateMachine):
     "A workflow machine"
-    draft = State('Draft', initial=True)
-    producing = State('Being produced')
-    closed = State('Closed', initial=True)  # Should raise an Exception when instantiated
+
+    draft = State("Draft", initial=True)
+    producing = State("Being produced")
+    closed = State("Closed", initial=True)  # Should raise an Exception when instantiated
 
     add_job = draft.to(draft) | producing.to(producing)
     produce = draft.to(producing)
     deliver = producing.to(closed)
 
+
 with pytest.raises(exceptions.InvalidDefinition):
     CampaignMachine()
 ```
@@ -187,6 +192,7 @@ with pytest.raises(exceptions.InvalidDefinition):
 
     class CampaignMachine(StateMachine):
         "A workflow machine"
+
         draft = State("Draft", initial=True)
         producing = State("Being produced")
         closed = State(