阻止原始 button、input、textarea、a、label 等交互元素绕过项目组件库。
What it catches
把 UI 设计系统里最容易漂移的地方变成自动检查。
插件提供 11 条规则,覆盖交互控件、设计令牌、Tailwind 任意值、暗色模式、z-index、图标尺寸和组合组件导入路径。
禁止 raw palette、任意颜色、任意间距和暗色模式硬编码,保持主题可控。
限制 shell-only 组件、内部 UI 路径和组合组件导入,减少跨层误用。
How teams adopt it
从 warn 到 error,给现有项目一条可迁移的路线。
推荐先在推荐预设下暴露问题,再按页面、组件层和设计令牌逐步收紧到严格模式。
安装插件
在 ESLint 9 flat config 中启用 recommended 或 strict 预设。
扫描漂移
先把高频违规点转成清晰列表,避免靠人工 Code Review 追样式细节。
沉淀模式
把重复页面写法迁移到 shared patterns 或 compositions,而不是堆 className。
收紧规则
新代码走 error,遗留代码逐步清理,最终让 UI 规范进入 CI。