From 89bd529cf918e23ea87fc9d3f24bd105b60cb98d Mon Sep 17 00:00:00 2001
From: "J. Nick Koston" <nick@home-assistant.io>
Date: Tue, 7 Apr 2026 14:18:32 -1000
Subject: [PATCH] [mdns] Add comment explaining why manual lambda wrapping is
 needed

---
 esphome/components/mdns/__init__.py | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/esphome/components/mdns/__init__.py b/esphome/components/mdns/__init__.py
index e308f31f30..79d355e8ae 100644
--- a/esphome/components/mdns/__init__.py
+++ b/esphome/components/mdns/__init__.py
@@ -132,7 +132,8 @@ def mdns_service(
     Returns:
         A StructInitializer representing a MDNSService struct
     """
-    # Wrap port in a stateless lambda for TemplatableFn storage
+    # Wrap port in a stateless lambda for TemplatableFn storage.
+    # Can't use cg.templatable() here because this is a sync function.
     if not isinstance(port, LambdaExpression):
         port = LambdaExpression(
             f"return {cg.safe_exp(port)};", [], capture="", return_type=cg.uint16