From 845e47f47298818c7fb905d8d104630cab45d232 Mon Sep 17 00:00:00 2001
From: jirka <6035284+Borda@users.noreply.github.com>
Date: Tue, 27 Jan 2026 15:40:48 +0100
Subject: [PATCH] Introduce deprecation warnings for `supervision.keypoint`
 module, redirecting to `supervision.key_points`.

(cherry picked from commit 99e772c4665ce485fe49cc288c5642988af9a28e)
---
 supervision/keypoint/__init__.py   | 15 +++++++++++++++
 supervision/keypoint/annotators.py | 15 +++++++++++++++
 supervision/keypoint/core.py       | 10 ++++++++++
 3 files changed, 40 insertions(+)
 create mode 100644 supervision/keypoint/__init__.py
 create mode 100644 supervision/keypoint/annotators.py
 create mode 100644 supervision/keypoint/core.py

diff --git a/supervision/keypoint/__init__.py b/supervision/keypoint/__init__.py
new file mode 100644
index 00000000..5e0b8d75
--- /dev/null
+++ b/supervision/keypoint/__init__.py
@@ -0,0 +1,15 @@
+import warnings
+
+warnings.warn(
+    "The 'supervision.keypoint' module is deprecated in `0.27.0` and will be removed "
+    "in `0.30.0`. Please use 'supervision.key_points' instead.",
+    DeprecationWarning,
+    stacklevel=2,
+)
+
+from supervision.key_points.annotators import (  # noqa: F401
+    EdgeAnnotator,
+    VertexAnnotator,
+    VertexLabelAnnotator,
+)
+from supervision.key_points.core import KeyPoints  # noqa: F401
diff --git a/supervision/keypoint/annotators.py b/supervision/keypoint/annotators.py
new file mode 100644
index 00000000..06debc81
--- /dev/null
+++ b/supervision/keypoint/annotators.py
@@ -0,0 +1,15 @@
+import warnings
+
+warnings.warn(
+    "The 'supervision.keypoint' module is deprecated in `0.27.0` and will be removed "
+    "in `0.30.0`. Please use 'supervision.key_points' instead.",
+    DeprecationWarning,
+    stacklevel=2,
+)
+
+from supervision.key_points.annotators import (  # noqa: F401
+    BaseKeyPointAnnotator,
+    EdgeAnnotator,
+    VertexAnnotator,
+    VertexLabelAnnotator,
+)
diff --git a/supervision/keypoint/core.py b/supervision/keypoint/core.py
new file mode 100644
index 00000000..e7a92e1b
--- /dev/null
+++ b/supervision/keypoint/core.py
@@ -0,0 +1,10 @@
+import warnings
+
+warnings.warn(
+    "The 'supervision.keypoint' module is deprecated in `0.27.0` and will be removed "
+    "in `0.30.0`. Please use 'supervision.key_points' instead.",
+    DeprecationWarning,
+    stacklevel=2,
+)
+
+from supervision.key_points.core import KeyPoints  # noqa: F401