From b9850c9f30cfaf2dae7e088f61d2345b08f93bb8 Mon Sep 17 00:00:00 2001
From: Kpa-clawbot <bot@kpa-clawbot.local>
Date: Wed, 6 May 2026 06:53:35 +0000
Subject: [PATCH] fix(check-css-vars): strip /* ... */ comments before scanning

Doc-blocks that mention `var(--name)` in prose (e.g. the z-index
scale comment in style.css) were producing false positives. Strip
comment spans before regex matching, replacing them with whitespace
so line numbers stay stable for any genuine offender that follows.

Refs #1128
---
 scripts/check-css-vars.js | 8 +++++++-
 1 file changed, 7 insertions(+), 1 deletion(-)

diff --git a/scripts/check-css-vars.js b/scripts/check-css-vars.js
index 821b67e9..64c0cb24 100644
--- a/scripts/check-css-vars.js
+++ b/scripts/check-css-vars.js
@@ -46,7 +46,13 @@ const defRe = /(?:^|[^a-zA-Z0-9_-])(--[a-zA-Z0-9_-]+)\s*:/g;
 const useRe = /var\(\s*(--[a-zA-Z0-9_-]+)\s*\)/g;
 
 for (const f of files) {
-  const lines = fs.readFileSync(f, 'utf8').split('\n');
+  // Strip /* ... */ comments before scanning so doc-blocks that mention
+  // var(--name) as prose don't trigger false positives. Replace each
+  // comment span with newlines to keep line numbers stable for any
+  // genuine offender that follows.
+  const raw = fs.readFileSync(f, 'utf8');
+  const stripped = raw.replace(/\/\*[\s\S]*?\*\//g, (m) => m.replace(/[^\n]/g, ' '));
+  const lines = stripped.split('\n');
   for (let i = 0; i < lines.length; i++) {
     const line = lines[i];
     let m;