From e04d35fe879994bc2419bd59b2650770c2a64996 Mon Sep 17 00:00:00 2001
From: Robert Hill <robert.hill@uphillsolutions.tech>
Date: Fri, 28 Aug 2026 00:09:00 -0400
Subject: [PATCH] register @flag/@endflags in metadata typedoc pass

build.sh runs a second, separate typedoc invocation to generate
.metadata.generated.json that never got the --blockTags fix from
0b6492bd, so it hit the same unknown-tag issue.
---
 scripts/build.sh | 14 ++++++++++++++
 1 file changed, 14 insertions(+)

diff --git a/scripts/build.sh b/scripts/build.sh
index 6a7a0ac5..e41455ca 100755
--- a/scripts/build.sh
+++ b/scripts/build.sh
@@ -62,6 +62,19 @@ if [ "$QUICK_BUILD" != "1" ]; then
     printf 'export * from "./lib/metadata"\n' > src/.metadata.generated.ts
     node -e "var fs=require('fs');fs.writeFileSync('src/.themes.generated.json',JSON.stringify(fs.readdirSync('src/static/themes').sort()))"
 
+    # TypeDoc's own default blockTags, plus our custom @flag/@endflags tags. Same as scripts/make_docs.sh
+    blockTags=$(node -e '
+import("typedoc").then(async ({ Application }) => {
+    const app = await Application.bootstrap({})
+    const tags = app.options.getValue("blockTags").filter(t => t !== "@inheritDoc")
+    console.log([...tags, "@flag", "@endflags"].join(" "))
+})
+')
+    set --
+    for tag in $blockTags; do
+        set -- "$@" --blockTags "$tag"
+    done
+
     # Generate runtime metadata via typedoc. The generated TypeScript shim
     # routes the public @src/.metadata.generated import to the JSON loader.
     "$(yarn bin)/typedoc" --json src/.metadata.generated.json \
@@ -69,6 +82,7 @@ if [ "$QUICK_BUILD" != "1" ]; then
       --excludePrivate false --excludePrivateClassFields false \
       --validation.notExported false \
       --exclude 'src/.excmds_*.generated.ts' \
+      "$@" \
       src/excmds.ts src/lib/config.ts src/content/state_content.ts
     node scripts/convert_typedoc_metadata.js src/.metadata.generated.json