From 177f416ebfaee5923d976098b3127f913df48f05 Mon Sep 17 00:00:00 2001
From: Tim Biesenbeek Sol <tbiesenbeek@swis.nl>
Date: Wed, 22 Jul 2026 17:08:12 +0200
Subject: [PATCH] feat: add stubs for Markup classes for type hinting

---
 .../Component/Render/FormattableMarkup.stub      | 13 +++++++++++++
 .../StringTranslation/TranslatableMarkup.stub    | 16 ++++++++++++++++
 .../StringTranslation/TranslationInterface.stub  |  6 ++++++
 3 files changed, 35 insertions(+)
 create mode 100644 stubs/Drupal/Component/Render/FormattableMarkup.stub
 create mode 100644 stubs/Drupal/Core/StringTranslation/TranslatableMarkup.stub
 create mode 100644 stubs/Drupal/Core/StringTranslation/TranslationInterface.stub

diff --git a/stubs/Drupal/Component/Render/FormattableMarkup.stub b/stubs/Drupal/Component/Render/FormattableMarkup.stub
new file mode 100644
index 00000000..21738798
--- /dev/null
+++ b/stubs/Drupal/Component/Render/FormattableMarkup.stub
@@ -0,0 +1,13 @@
+<?php
+
+namespace Drupal\Component\Render;
+
+class FormattableMarkup implements MarkupInterface, \Countable {
+
+    /**
+     * @param string $string
+     * @param array<string, string|\Stringable> $arguments
+     */
+    public function __construct($string, array $arguments) {}
+
+}
\ No newline at end of file
diff --git a/stubs/Drupal/Core/StringTranslation/TranslatableMarkup.stub b/stubs/Drupal/Core/StringTranslation/TranslatableMarkup.stub
new file mode 100644
index 00000000..4d9142d4
--- /dev/null
+++ b/stubs/Drupal/Core/StringTranslation/TranslatableMarkup.stub
@@ -0,0 +1,16 @@
+<?php
+
+namespace Drupal\Core\StringTranslation;
+
+use Drupal\Component\Render\FormattableMarkup;
+
+class TranslatableMarkup extends FormattableMarkup {
+
+  /**
+   * @param string $string
+   * @param array<string, string|\Stringable> $arguments
+   * @param array<string, mixed> $options
+   */
+  public function __construct($string, array $arguments = [], array $options = [], ?TranslationInterface $string_translation = NULL) {}
+
+}
diff --git a/stubs/Drupal/Core/StringTranslation/TranslationInterface.stub b/stubs/Drupal/Core/StringTranslation/TranslationInterface.stub
new file mode 100644
index 00000000..043d40fc
--- /dev/null
+++ b/stubs/Drupal/Core/StringTranslation/TranslationInterface.stub
@@ -0,0 +1,6 @@
+<?php
+
+namespace Drupal\Core\StringTranslation;
+
+interface TranslationInterface {
+}