From dbf3bd490eb59dda0c8bf3ce7f8b6076f32c7dda Mon Sep 17 00:00:00 2001
From: Peter Steinberger <steipete@gmail.com>
Date: Thu, 7 May 2026 00:15:38 +0100
Subject: [PATCH] fix: highlight json5 docs examples

---
 scripts/docs-site/mdx-ish.mjs | 10 +++++++---
 scripts/docs-site/smoke.mjs   |  5 +++++
 2 files changed, 12 insertions(+), 3 deletions(-)

diff --git a/scripts/docs-site/mdx-ish.mjs b/scripts/docs-site/mdx-ish.mjs
index 0f8f81804..ef9ad25bb 100644
--- a/scripts/docs-site/mdx-ish.mjs
+++ b/scripts/docs-site/mdx-ish.mjs
@@ -40,7 +40,9 @@ function highlightCode(code, rawLang = "") {
   const lang = normalizeLang(rawLang);
   if (isShell(lang, code)) return highlightWith(code, shellToken, shellTokenClass);
   if (["json", "jsonc"].includes(lang)) return highlightWith(code, jsonToken, jsonTokenClass);
-  if (["js", "jsx", "mjs", "cjs", "ts", "tsx"].includes(lang)) return highlightWith(code, jsToken, jsTokenClass);
+  if (["js", "javascript", "jsx", "mjs", "cjs", "ts", "typescript", "tsx", "json5"].includes(lang)) {
+    return highlightWith(code, jsToken, jsTokenClass);
+  }
   if (["yaml", "yml"].includes(lang)) return highlightWith(code, yamlToken, yamlTokenClass);
   if (["toml", "ini", "env"].includes(lang)) return highlightWith(code, configToken, configTokenClass);
   return escapeHtml(code);
@@ -72,7 +74,7 @@ function highlightWith(code, tokenPattern, tokenClass) {
 
 const shellToken = /(?<!\S)#[^\n]*|"(?:\\.|[^"])*"|'(?:\\.|[^'])*'|\$[A-Za-z_][A-Za-z0-9_]*|--?[A-Za-z0-9][A-Za-z0-9_-]*(?:=[^\s]+)?|\b(?:bun|brew|cat|cd|cp|curl|docker|export|git|grep|mkdir|mv|node|npm|npx|openclaw|pnpm|rg|rm|sudo)\b/g;
 const jsonToken = /"(?:\\.|[^"])*"(?=\s*:)|"(?:\\.|[^"])*"|\b(?:true|false|null)\b|-?\b\d+(?:\.\d+)?\b|[{}[\],:]/g;
-const jsToken = /\/\/[^\n]*|\/\*[\s\S]*?\*\/|"(?:\\.|[^"])*"|'(?:\\.|[^'])*'|`(?:\\.|[^`])*`|\b(?:await|break|case|catch|class|const|continue|default|else|export|false|finally|for|from|function|if|import|let|new|null|return|throw|true|try|type|undefined|while)\b|-?\b\d+(?:\.\d+)?\b/g;
+const jsToken = /\/\/[^\n]*|\/\*[\s\S]*?\*\/|"(?:\\.|[^"])*"|'(?:\\.|[^'])*'|`(?:\\.|[^`])*`|\b[A-Za-z_$][\w$-]*(?=\s*:)|\b(?:await|break|case|catch|class|const|continue|default|else|export|false|finally|for|from|function|if|import|let|new|null|return|throw|true|try|type|undefined|while)\b|-?\b\d+(?:\.\d+)?\b|[{}[\],:]/g;
 const yamlToken = /#[^\n]*|^\s*[-\w".'/]+\s*:|"(?:\\.|[^"])*"|'(?:\\.|[^'])*'|\b(?:true|false|null)\b|-?\b\d+(?:\.\d+)?\b/gm;
 const configToken = /#[^\n]*|^\s*[-\w".'/]+\s*=|"(?:\\.|[^"])*"|'(?:\\.|[^'])*'|\b(?:true|false|null)\b|-?\b\d+(?:\.\d+)?\b/gm;
 
@@ -94,11 +96,13 @@ function jsonTokenClass(token) {
   return "tok-punct";
 }
 
-function jsTokenClass(token) {
+function jsTokenClass(token, match, code) {
   if (token.startsWith("//") || token.startsWith("/*")) return "tok-comment";
   if (/^["'`]/.test(token)) return "tok-string";
   if (/^(?:true|false|null|undefined)$/.test(token)) return "tok-literal";
+  if (/^[A-Za-z_$][\w$-]*$/.test(token) && /^\s*:/.test(code.slice(match.index + token.length))) return "tok-key";
   if (/^-?\d/.test(token)) return "tok-number";
+  if (/^[{}[\],:]$/.test(token)) return "tok-punct";
   return "tok-keyword";
 }
 
diff --git a/scripts/docs-site/smoke.mjs b/scripts/docs-site/smoke.mjs
index 8430e1485..f3818f43d 100644
--- a/scripts/docs-site/smoke.mjs
+++ b/scripts/docs-site/smoke.mjs
@@ -60,6 +60,11 @@ if (!/Português \(BR\)/.test(index)) {
 if (!/data-docs-chat/.test(index) || !/OPENCLAW_DOCS_CHAT_API/.test(index)) {
   throw new Error("index: docs chat widget was not rendered");
 }
+if (!/class="tok-key">channels<\/span>/.test(index)
+  || !/class="tok-string">&quot;\+15555550123&quot;<\/span>/.test(index)
+  || !/class="tok-literal">true<\/span>/.test(index)) {
+  throw new Error("index: json5 config example was not syntax-highlighted");
+}
 const modelsMarkdown = fs.readFileSync(path.join(site, "concepts/models.md"), "utf8");
 if (!/^---\nsummary: /m.test(modelsMarkdown) || !/title: "Models CLI"/m.test(modelsMarkdown)) {
   throw new Error("concepts/models.md: source markdown was not emitted");