From 622d86328be584e094b3d8aeab95439649e8eba9 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?J=C3=A9r=C3=B4me=20Gamez?= <jerome@gamez.name>
Date: Sat, 22 Aug 2026 00:11:17 +0200
Subject: [PATCH] Deprecate `Clock` interface

---
 CHANGELOG.md  | 6 ++++++
 src/Clock.php | 3 +++
 2 files changed, 9 insertions(+)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index bf1be7d..500f9e4 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,5 +1,11 @@
 # CHANGELOG
 
+## Unreleased
+
+Deprecates `Beste\Clock` in favor of `Psr\Clock\ClockInterface`. The implementations continue to implement
+the deprecated interface for backwards compatibility. Please type against `Psr\Clock\ClockInterface`.
+`Beste\Clock` will be removed in 4.0.
+
 ## 3.0.0 - 2022-11-26
 This release replaces `stella-maris/clock` with `psr/clock`.
 
diff --git a/src/Clock.php b/src/Clock.php
index 5693d1d..ac77d4e 100644
--- a/src/Clock.php
+++ b/src/Clock.php
@@ -6,6 +6,9 @@ namespace Beste;
 
 use Psr\Clock\ClockInterface;
 
+/**
+ * @deprecated since 3.1.0, use {@see ClockInterface} instead.
+ */
 interface Clock extends ClockInterface
 {