Merge pull request #6110 from esphome/bump-2026.2.0b4

2026.2.0b4

Author: jesserockz

.devcontainer/postCreate.sh

@@ -5,7 +5,7 @@ updates:
     schedule:
       interval: daily
     open-pull-requests-limit: 10
-  - package-ecosystem: pip
+  - package-ecosystem: npm
     directory: "/"
     schedule:
       interval: daily

.github/dependabot.yml

@@ -1,6 +1,7 @@
 ports:
-- port: 8000
+- port: 4321
   onOpen: open-preview
 
 tasks:
-- command: make live-html
+- init: npm install
+  command: npm run dev

.github/workflows/docker.yml

@@ -2,10 +2,10 @@
   "version": "2.0.0",
   "tasks": [
     {
-      "label": "Live HTML build",
+      "label": "Dev server",
       "type": "shell",
-      "command": "make live-html",
+      "command": "npm run dev",
       "problemMatcher": []
-    },
+    }
   ]
 }

.gitpod.yml

@@ -168,6 +168,7 @@ export default defineConfig({
       editLink: {
         baseUrl: "https://github.com/esphome/esphome-docs/edit/current/",
       },
+      routeMiddleware: ["./src/routeData.ts"],
       components: {
         Footer: "./src/components/Footer.astro",
       },

.vscode/tasks.json

@@ -1,2 +1,2 @@
-release: 2026.2.0b3
+release: 2026.2.0b4
 version: '2026.2'

Dockerfile

@@ -364,6 +364,62 @@ async function checkInternalLinks(fname, content, anchorCache) {
   }
 }
 
+function checkAutomationHeadings(fname, content) {
+  if (!fname.startsWith('src/content/docs/components/')) return;
+  if (!fname.endsWith('.md') && !fname.endsWith('.mdx')) return;
+
+  // Skip the main actions page which documents core actions (delay, if, lambda, etc.)
+  if (fname.includes('automations/')) return;
+
+  const lines = content.split('\n');
+  for (let i = 0; i < lines.length; i++) {
+    const line = lines[i];
+    const lineno = i + 1;
+
+    // Only look at heading lines
+    if (!line.match(/^#{2,4}\s/)) continue;
+
+    // Check 1: Backticked `domain.name` without Action/Condition/Trigger suffix
+    // e.g. ### `wireguard.enabled`
+    if (line.match(/^#{2,4}\s+`[a-z_][a-z0-9_.]*\.[a-z_][a-z0-9_]*`\s*$/)) {
+      addError(fname, lineno, 1,
+        'Heading has backticked automation name but is missing Action/Condition/Trigger suffix. ' +
+        'Add " Action", " Condition", or " Trigger" after the closing backtick.');
+    }
+
+    // Check 2: Action/Condition with backticked name missing domain prefix (no dot)
+    // e.g. ### `arm_away` Action
+    const noDotMatch = line.match(/^#{2,4}\s+`([a-z_][a-z0-9_]*)`\s+(?:Action|Condition)s?\s*$/i);
+    if (noDotMatch) {
+      const name = noDotMatch[1];
+      // Exclude core actions/conditions documented on actions.mdx
+      const coreNames = [
+        'delay', 'if', 'lambda', 'repeat', 'wait_until', 'while',
+        'and', 'all', 'or', 'any', 'xor', 'not', 'for',
+      ];
+      if (!coreNames.includes(name) && !name.startsWith('on_')) {
+        addError(fname, lineno, 1,
+          `Heading "\`${name}\`" is missing the domain prefix. ` +
+          'Use the format: `domain.name` Action/Condition (e.g. `switch.toggle` Action).');
+      }
+    }
+
+    // Check 3: Bold **Action** or **Condition** suffix
+    // e.g. ### `remote_transmitter.transmit_nec` **Action**
+    if (line.match(/^#{2,4}\s+`[^`]+`.*\*\*(?:Action|Condition)s?\*\*/)) {
+      addError(fname, lineno, 1,
+        'Action/Condition suffix should not be bold. Use plain text: " Action" or " Condition".');
+    }
+
+    // Check 4: Lowercase action/condition suffix (not matching standard capitalization)
+    // e.g. ### `sprinkler.start_full_cycle` action
+    if (line.match(/^#{2,4}\s+`[a-z_][a-z0-9_.]*\.[a-z_][a-z0-9_]*`\s+(?:action|condition)s?\s*$/)) {
+      addError(fname, lineno, 1,
+        'Action/Condition suffix should be capitalized. Use "Action" or "Condition" (not lowercase).');
+    }
+  }
+}
+
 // Main execution
 async function main() {
   console.log(`${colors.cyan}Running ESPHome documentation linter...${colors.reset}\n`);
@@ -410,6 +466,7 @@ async function main() {
       checkNewlines(fname, content);
       checkEndNewline(fname, content);
       checkEsphomeLinks(fname, content);
+      checkAutomationHeadings(fname, content);
       await checkInternalLinks(fname, content, anchorCache);
 
     } catch (error) {