From 8358e548ced1cac5db9783871f1d57ba23e9403e Mon Sep 17 00:00:00 2001
From: Shuaib Hasan Akib <akibh805@gmail.com>
Date: Sun, 4 Jan 2026 22:18:52 +0600
Subject: [PATCH] fix(docs-infra): stop auto-linking "state" and "group" to
 APIs

Prevents common words used in code examples from being incorrectly
linked to API references.

Fixes: #66292
---
 adev/shared-docs/pipeline/shared/linking.mts                | 2 ++
 .../pipeline/shared/marked/test/docs-code/docs-code.md      | 6 ++++++
 .../shared/marked/test/docs-code/docs-code.spec.mts         | 5 +++++
 3 files changed, 13 insertions(+)

diff --git a/adev/shared-docs/pipeline/shared/linking.mts b/adev/shared-docs/pipeline/shared/linking.mts
index bf01f6df2c7..a51a59bb389 100644
--- a/adev/shared-docs/pipeline/shared/linking.mts
+++ b/adev/shared-docs/pipeline/shared/linking.mts
@@ -18,6 +18,8 @@ const LINK_EXEMPT = new Set([
   'readonly',
   'disabled',
   'hidden',
+  'state',
+  'group',
 ]);
 
 export function shouldLinkSymbol(symbol: string): boolean {
diff --git a/adev/shared-docs/pipeline/shared/marked/test/docs-code/docs-code.md b/adev/shared-docs/pipeline/shared/marked/test/docs-code/docs-code.md
index 73871835de4..fa52fce3c58 100644
--- a/adev/shared-docs/pipeline/shared/marked/test/docs-code/docs-code.md
+++ b/adev/shared-docs/pipeline/shared/marked/test/docs-code/docs-code.md
@@ -6,3 +6,9 @@ this is code
 <docs-code path="./example-with-region.ts" />
 
 <docs-code header="src/locale/messages.fr.xlf (<trans-unit>)" path="./messages.fr.xlf" />
+
+<docs-code header="Property names should not be linked" language="ts">  
+const form = {  
+  state: ['']  
+};  
+</docs-code>
diff --git a/adev/shared-docs/pipeline/shared/marked/test/docs-code/docs-code.spec.mts b/adev/shared-docs/pipeline/shared/marked/test/docs-code/docs-code.spec.mts
index 4dd5c183be6..f008639a8d7 100644
--- a/adev/shared-docs/pipeline/shared/marked/test/docs-code/docs-code.spec.mts
+++ b/adev/shared-docs/pipeline/shared/marked/test/docs-code/docs-code.spec.mts
@@ -47,4 +47,9 @@ describe('markdown to html', () => {
     const codeBlock = markdownDocument.querySelectorAll('code')[3];
     expect(codeBlock).toBeTruthy();
   });
+
+  it('should not link property names in object literals', () => {
+    const codeBlock = markdownDocument.querySelectorAll('code')[4];
+    expect(codeBlock?.innerHTML).not.toContain('<a href="/api/animations/state">state</a>');
+  });
 });