From bb7fac786856945fbbf5de8f9a0f0db8e1aba1de Mon Sep 17 00:00:00 2001
From: Wonsuk Choi <sukvvon@gmail.com>
Date: Thu, 15 Oct 2026 17:13:53 +0900
Subject: [PATCH] fix(typedoc-config/typedoc-custom-settings): use
 'markdownHooks' to add 'DO NOT EDIT' comment instead of overwritten
 'page.contents'

---
 .changeset/warm-notes-stay.md                          | 5 +++++
 packages/typedoc-config/src/typedoc-custom-settings.ts | 8 ++++++--
 2 files changed, 11 insertions(+), 2 deletions(-)
 create mode 100644 .changeset/warm-notes-stay.md

diff --git a/.changeset/warm-notes-stay.md b/.changeset/warm-notes-stay.md
new file mode 100644
index 00000000..31c52cd1
--- /dev/null
+++ b/.changeset/warm-notes-stay.md
@@ -0,0 +1,5 @@
+---
+'@tanstack/typedoc-config': patch
+---
+
+fix(typedoc-config): add 'DO NOT EDIT' comment to generated pages via 'markdownHooks'
diff --git a/packages/typedoc-config/src/typedoc-custom-settings.ts b/packages/typedoc-config/src/typedoc-custom-settings.ts
index 89b2dcf3..c5f536e0 100644
--- a/packages/typedoc-config/src/typedoc-custom-settings.ts
+++ b/packages/typedoc-config/src/typedoc-custom-settings.ts
@@ -8,7 +8,11 @@ export function load(app: MarkdownApplication): void {
       id: page.model.name,
       title: page.model.name,
     }
-    page.contents =
-      '<!-- DO NOT EDIT: this page is autogenerated from the type comments -->\n\n'
   })
+
+  // Add a warning comment to the top of each page, including the index page
+  const doNotEdit = () =>
+    '<!-- DO NOT EDIT: this page is autogenerated from the type comments -->'
+  app.renderer.markdownHooks.on('page.begin', doNotEdit)
+  app.renderer.markdownHooks.on('index.page.begin', doNotEdit)
 }