fmode-code-lit/examples/core-wc/scripts/check.mjs

#!/usr/bin/env node
/**
 * scripts/check.mjs —— examples/core-wc 静态体检。
 *
 * 断言五件事（对应规则仓 core-library / web-component-library 的红线）：
 *  1. core/ 零浏览器依赖、不 import lit；
 *  2. wc/ 无装饰器；
 *  3. wc/ 组件必须用 Lit 实现（extends LitElement + import 'lit'，禁原生 wc 手写）；
 *  4. 全仓 .js 语法通过 + 相对 import 都带 .js；
 *  5. customElements.define 注册幂等。
 *
 * 用法：node scripts/check.mjs
 */
import { readdirSync, readFileSync, statSync } from 'node:fs';
import { join, dirname } from 'node:path';
import { fileURLToPath } from 'node:url';
import { execFileSync } from 'node:child_process';

const root = join(dirname(fileURLToPath(import.meta.url)), '..');

let fail = 0;
const check = (name, ok, detail = '') => {
  console.log(`${ok ? '✓' : '✗'} ${name}${!ok && detail ? `\n    ${detail}` : ''}`);
  if (!ok) fail++;
};

function walk(dir, out = []) {
  for (const e of readdirSync(dir, { withFileTypes: true })) {
    if (e.name === 'node_modules' || e.name.startsWith('.')) continue;
    const p = join(dir, e.name);
    if (e.isDirectory()) walk(p, out);
    else if (p.endsWith('.js')) out.push(p);
  }
  return out;
}

const files = walk(root);

/** 去掉注释与字符串字面量，避免把文档里提到的 window/fetch 误判为代码。 */
function strip(src) {
  return src
    .replace(/\/\*[\s\S]*?\*\//g, '')      // 块注释
    .replace(/(^|[^:])\/\/[^\n]*/g, '$1'); // 行注释（避开 https://）
}

/** 只去掉注释（保留字符串），用于「是否 import 某包」这类**看字面量**的判定。 */
function stripComments(src) {
  return src
    .replace(/\/\*[\s\S]*?\*\//g, '')
    .replace(/(^|[^:])\/\/[^\n]*/g, '$1');
}

// 1. core 零浏览器依赖
const DOM_GLOBALS = /\b(window|document|localStorage|sessionStorage|navigator|HTMLElement|CustomEvent)\b|\bfetch\s*\(/;
const coreFiles = files.filter((f) => f.includes('/core/'));
check('core/ 目录非空', coreFiles.length > 0);
let domHits = [];
for (const f of coreFiles) {
  const src = strip(readFileSync(f, 'utf8'));
  const m = src.match(DOM_GLOBALS);
  if (m) domHits.push(`${f}: ${m[0]}`);
}
check('core/ 无浏览器全局（window/document/fetch/…）', domHits.length === 0, domHits.join('\n    '));

const litHits = coreFiles.filter((f) => /from\s+['"]lit(-html|-element)?['"]/.test(strip(readFileSync(f, 'utf8'))));
check('core/ 不 import lit', litHits.length === 0, litHits.join('\n    '));

// 2. wc 无装饰器
const DECORATOR = /^\s*@(customElement|property|state|consume|provide|query|queryAssignedElements)\b/m;
const decoHits = files.filter((f) => DECORATOR.test(strip(readFileSync(f, 'utf8'))));
check('全仓无装饰器语法', decoHits.length === 0, decoHits.join('\n    '));

// 3. wc/ 必须用 Lit 实现（禁原生 Web Component 手写）
//
// 判定口径：**注册了自定义元素的文件**就是「组件」，必须用 Lit 框架特性开发。
// 不渲染 DOM 的纯 I/O 适配器（如 browser-transport.js，不 define）不在此列。
const NATIVE_WC = [
  [/\bextends\s+HTMLElement\b/, 'extends HTMLElement（原生 wc）'],
  [/\battachShadow\s*\(/, 'attachShadow()（手写 Shadow DOM）'],
  [/\bobservedAttributes\b/, 'observedAttributes（手写属性观察）'],
  [/\battributeChangedCallback\b/, 'attributeChangedCallback（手写属性观察）'],
];
const wcComponentFiles = files.filter((f) => f.includes('/wc/') && /customElements\.define\(/.test(readFileSync(f, 'utf8')));
check('wc/ 存在注册自定义元素的组件文件', wcComponentFiles.length > 0);

const notLit = wcComponentFiles.filter((f) => !/from\s+['"]lit(-element)?['"]/.test(stripComments(readFileSync(f, 'utf8'))));
check('wc/ 组件均 import lit', notLit.length === 0,
  notLit.map((f) => `${f}: 缺少 import { LitElement, html, css } from 'lit'`).join('\n    '));

const notLitElement = wcComponentFiles.filter((f) => !/\bextends\s+LitElement\b/.test(strip(readFileSync(f, 'utf8'))));
check('wc/ 组件均 extends LitElement', notLitElement.length === 0,
  notLitElement.map((f) => `${f}: 组件类必须继承 LitElement（见 web-component-library.md 第〇节）`).join('\n    '));

let nativeHits = [];
for (const f of wcComponentFiles) {
  const src = strip(readFileSync(f, 'utf8'));
  for (const [re, label] of NATIVE_WC) {
    if (re.test(src)) nativeHits.push(`${f}: ${label}`);
  }
}
check('wc/ 组件无原生 wc 写法（extends HTMLElement / attachShadow / observedAttributes）', nativeHits.length === 0,
  nativeHits.join('\n    '));

// 4. 语法 + 相对 import 带 .js
let syntaxBad = [];
const suffixBad = [];
for (const f of files) {
  try { execFileSync(process.execPath, ['--check', f], { stdio: 'pipe' }); }
  catch { syntaxBad.push(f); }
  const src = strip(readFileSync(f, 'utf8'));
  for (const m of src.matchAll(/\bfrom\s+['"](\.[^'"]*)['"]/g)) {
    if (!/\.js$/.test(m[1]) && !/\{\}/.test(m[1])) suffixBad.push(`${f}: ${m[1]}`);
  }
  // 裸标识符 import（非相对、非 node:）必须能进 importmap
  for (const m of src.matchAll(/\bfrom\s+['"]([^.'"][^'"]*)['"]/g)) {
    const spec = m[1];
    if (spec.startsWith('node:')) continue;
    if (!/^(lit|lit-html|lit-element|@lit\/|@lit-labs\/|signal-polyfill|\/)/.test(spec)) {
      suffixBad.push(`${f}: 裸标识符 ${spec} 未列入 importmap 白名单`);
    }
  }
}
check('全部 .js 通过 node --check', syntaxBad.length === 0, syntaxBad.join('\n    '));
check('相对 import 带 .js 且裸标识符在 importmap 内', suffixBad.length === 0, suffixBad.join('\n    '));

// 5. 注册幂等
const defs = files.filter((f) => /customElements\.define\(/.test(readFileSync(f, 'utf8')));
const guarded = defs.filter((f) => /customElements\.get\(/.test(readFileSync(f, 'utf8')));
check('customElements.define 均有 get() 判重', defs.length > 0 && defs.length === guarded.length,
  defs.filter((f) => !guarded.includes(f)).join('\n    '));

console.log(fail === 0 ? '\nCHECK OK' : `\nCHECK FAILED（${fail}）`);
process.exit(fail === 0 ? 0 : 1);