Initial TrueGrowth source import

packages/drawnix/scripts/check-hover-usage.mjs

@@ -0,0 +1,193 @@
+import fs from 'fs';
+import path from 'path';
+import { fileURLToPath } from 'url';
+
+const projectRoot = path.resolve(
+  path.dirname(fileURLToPath(import.meta.url)),
+  '..'
+);
+
+const sourceRoots = [
+  path.resolve(projectRoot, 'src/components'),
+  path.resolve(projectRoot, 'src/tools'),
+].filter((dir) => fs.existsSync(dir));
+
+const allowedNativeTitleFiles = new Set([
+  path.join('src', 'components', 'MarkdownReadonly', 'index.tsx'),
+]);
+
+function collectFiles(dir, files = []) {
+  for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
+    if (entry.name.startsWith('.')) {
+      continue;
+    }
+
+    const entryPath = path.join(dir, entry.name);
+    if (entry.isDirectory()) {
+      collectFiles(entryPath, files);
+      continue;
+    }
+
+    if (/\.(ts|tsx|scss|css)$/.test(entry.name)) {
+      files.push(entryPath);
+    }
+  }
+
+  return files;
+}
+
+function getJsxOpeningTags(code) {
+  const tags = [];
+
+  for (let index = 0; index < code.length; index += 1) {
+    if (code[index] !== '<' || !/[A-Za-z]/.test(code[index + 1] || '')) {
+      continue;
+    }
+
+    let cursor = index + 1;
+    while (/[\w.$-]/.test(code[cursor] || '')) {
+      cursor += 1;
+    }
+
+    const tagName = code.slice(index + 1, cursor);
+    let depth = 0;
+    let quote = null;
+    let end = cursor;
+
+    for (; end < code.length; end += 1) {
+      const char = code[end];
+      const prev = code[end - 1];
+
+      if (quote) {
+        if (char === quote && prev !== '\\') {
+          quote = null;
+        }
+        continue;
+      }
+
+      if (char === '"' || char === "'" || char === '`') {
+        quote = char;
+        continue;
+      }
+
+      if (char === '{') {
+        depth += 1;
+        continue;
+      }
+
+      if (char === '}') {
+        depth = Math.max(0, depth - 1);
+        continue;
+      }
+
+      if (char === '>' && depth === 0) {
+        break;
+      }
+    }
+
+    if (end < code.length) {
+      tags.push({
+        name: tagName,
+        text: code.slice(index, end + 1),
+      });
+      index = end;
+    }
+  }
+
+  return tags;
+}
+
+function hasJsxAttribute(tagText, attrName) {
+  return new RegExp(`(?:^|[\\s{])${attrName}\\s*=`, 'm').test(tagText);
+}
+
+const violations = [];
+
+for (const rootDir of sourceRoots) {
+  for (const filePath of collectFiles(rootDir)) {
+    if (/\.(test|spec)\.tsx?$/.test(filePath)) {
+      continue;
+    }
+
+    if (filePath.endsWith(path.join('shared', 'hover', 'HoverTip.tsx'))) {
+      continue;
+    }
+
+    const relativePath = path.relative(projectRoot, filePath);
+    const code = fs.readFileSync(filePath, 'utf8');
+    const isStyleFile = /\.(scss|css)$/.test(filePath);
+
+    if (isStyleFile) {
+      const usesDataTooltip =
+        /\[data-tooltip\]/.test(code) ||
+        /attr\(\s*data-tooltip\s*\)/.test(code);
+      const usesLocalHoverTip =
+        /:hover\s+[^,{]*\.(?:[\w-]*tooltip[\w-]*|[\w-]*tip[\w-]*)\b/.test(
+          code
+        );
+
+      if (usesDataTooltip || usesLocalHoverTip) {
+        violations.push(
+          `${relativePath}: CSS 不应实现局部 hover tips，请改用共享 HoverTip 或 HoverCard。`
+        );
+      }
+
+      continue;
+    }
+
+    const importsTooltip =
+      /from\s+['"]tdesign-react['"]/.test(code) &&
+      /import\s*{[^}]*\bTooltip\b[^}]*}\s*from\s*['"]tdesign-react['"]/.test(
+        code
+      );
+
+    if (importsTooltip) {
+      violations.push(
+        `${relativePath}: 请改用共享 HoverTip，而不是直接从 tdesign-react 引入 Tooltip。`
+      );
+    }
+
+    const allowsNativeTitle = allowedNativeTitleFiles.has(relativePath);
+    const jsxOpeningTags = getJsxOpeningTags(code);
+    const nativeTitleMatches = allowsNativeTitle
+      ? []
+      : jsxOpeningTags.filter(
+          (tag) =>
+            /^(button|div|span|a|img|input|textarea|svg|path|circle|rect|p|label|li|td|th|section|article|h[1-6])$/.test(
+              tag.name
+            ) && hasJsxAttribute(tag.text, 'title')
+        );
+    if (nativeTitleMatches.length) {
+      violations.push(
+        `${relativePath}: 应用 UI 不应直接使用原生 title hover，请改用共享 HoverTip 包裹；Markdown/用户内容语义 title 需加入明确例外。`
+      );
+    }
+
+    const nativeTooltipMatches = jsxOpeningTags.filter(
+      (tag) =>
+        /^(button|div|span|a)$/.test(tag.name) &&
+        (hasJsxAttribute(tag.text, 'data-tooltip') ||
+          hasJsxAttribute(tag.text, 'tooltip'))
+    );
+    if (nativeTooltipMatches.length) {
+      violations.push(
+        `${relativePath}: 原生 DOM 节点不应直接使用 tooltip 属性，请改为使用共享 HoverTip 包裹。`
+      );
+    }
+
+    const toolButtonTitleMatches = jsxOpeningTags.filter(
+      (tag) => tag.name === 'ToolButton' && hasJsxAttribute(tag.text, 'title')
+    );
+    if (toolButtonTitleMatches.length) {
+      violations.push(
+        `${relativePath}: ToolButton 的 hover 文案请改用 tooltip 属性，避免继续扩散原生 title 语义。`
+      );
+    }
+  }
+}
+
+if (violations.length > 0) {
+  console.error('检测到不允许的 hover 用法:\n');
+  console.error(violations.join('\n'));
+  process.exit(1);
+}