@longzai-intelligence-oxlint/design-rules-plugin 0.1.17

package/README.md

@@ -0,0 +1,30 @@
+# @longzai-intelligence-oxlint/design-rules-plugin
+
+Longzai Intelligence Design 设计专用 Oxlint 规则插件。强制消费方使用设计令牌，杜绝硬编码颜色 / 间距 / z-index，作为 design 域代码规范契约的真实承载（替代历史幻影 `eslint-config`）。
+
+## 规则
+
+| 规则 | 说明 | 推荐级别 |
+| --- | --- | --- |
+| `no-hardcoded-color` | 禁止在 className 中硬编码颜色（`bg-[#fff]`、`text-[rgb(...)]`），强制用语义令牌（`bg-primary`） | error |
+| `no-hardcoded-spacing` | 禁止任意值间距（`p-[22px]`、`gap-[7px]`），强制用间距刻度（`p-6`、`gap-2`） | error |
+| `no-magic-z-index` | 禁止魔法 z-index（`z-[999]`、`zIndex: 100`），强制用层级令牌（`z-dropdown`） | error |
+
+## 消费方式
+
+design 项目不直接引用本插件，而是经 `@longzai-intelligence-oxlint/presets` 的 `library` 预设间接消费（presets 的 `JS_PLUGINS` 已聚合本插件）。新增 design package 默认生效，无需改 `oxlint.config.ts`。
+
+## 规则键名
+
+```
+@longzai-intelligence-oxlint/design-rules-plugin/no-hardcoded-color
+@longzai-intelligence-oxlint/design-rules-plugin/no-hardcoded-spacing
+@longzai-intelligence-oxlint/design-rules-plugin/no-magic-z-index
+```
+
+## 相关
+
+- [design 色彩规范](../../../../longzai-intelligence-design/docs/foundations/color.md)
+- [design 间距规范](../../../../longzai-intelligence-design/docs/foundations/spacing.md)
+- [design 层级规范](../../../../longzai-intelligence-design/docs/foundations/elevation.md)
+- ADR-0078（设计专用代码规范契约，待补）

package/dist/configs/recommended.d.ts

@@ -0,0 +1,8 @@
+import { OxlintRules } from "@longzai-intelligence-oxlint/core";
+//#region src/configs/recommended.config.d.ts
+/**
+ * 推荐规则集
+ */
+declare const recommended: OxlintRules;
+//#endregion
+export { recommended };

package/dist/configs/recommended.js

@@ -0,0 +1 @@
+const e={"@longzai-intelligence-oxlint/design-rules-plugin/no-hardcoded-color":`error`,"@longzai-intelligence-oxlint/design-rules-plugin/no-hardcoded-spacing":`error`,"@longzai-intelligence-oxlint/design-rules-plugin/no-magic-z-index":`error`};export{e as recommended};

package/dist/index.d.ts

@@ -0,0 +1,31 @@
+//#region src/rules/no-hardcoded-color.rule.d.ts
+/**
+ * 禁止硬编码颜色的 Oxlint 规则
+ *
+ * 扫描源码每行，检测 Tailwind 任意值颜色模式。命中则报告，提示改用语义令牌。
+ */
+declare const noHardcodedColorRule: import("@oxlint/plugins").Rule;
+//#endregion
+//#region src/rules/no-hardcoded-spacing.rule.d.ts
+/**
+ * 禁止硬编码间距的 Oxlint 规则
+ *
+ * 扫描源码每行，检测 Tailwind 任意值间距模式。命中则报告，提示改用间距刻度。
+ */
+declare const noHardcodedSpacingRule: import("@oxlint/plugins").Rule;
+//#endregion
+//#region src/rules/no-magic-z-index.rule.d.ts
+/**
+ * 禁止魔法 z-index 的 Oxlint 规则
+ *
+ * 扫描源码每行，检测任意值 z-index 与 inline zIndex 数值。命中则报告，提示改用层级令牌。
+ */
+declare const noMagicZIndexRule: import("@oxlint/plugins").Rule;
+//#endregion
+//#region src/index.d.ts
+/**
+ * design-rules 插件
+ */
+declare const designRulesPlugin: import("@oxlint/plugins").Plugin;
+//#endregion
+export { designRulesPlugin as default, designRulesPlugin, noHardcodedColorRule, noHardcodedSpacingRule, noMagicZIndexRule };

package/dist/index.js

@@ -0,0 +1,4 @@
+import{defineRule as e,eslintCompatPlugin as t}from"@oxlint/plugins";const n=/(?:bg|text|border|fill|stroke|ring|outline|from|to|via|caret|accent|decoration|shadow)-\[(?:#[0-9a-fA-F]{3,8}|(?:rgb|rgba|hsl|hsla|oklch)\([^)]*\))\]/g;function r(e){let t=e.trim();return t.startsWith(`//`)||t.startsWith(`*`)||t.startsWith(`/*`)||t.startsWith(`<!--`)}const i=e({meta:{type:`problem`,docs:{description:`禁止在 className 中硬编码颜色，强制使用设计令牌语义色（如 bg-primary）`}},createOnce(e){return{Program(t){let i=e.sourceCode.text.split(`
+`);for(let a=0;a<i.length;a+=1){if(r(i[a]))continue;n.lastIndex=0;let o=n.exec(i[a]);o&&e.report({node:t,message:`禁止硬编码颜色 "${o[0]}"：请使用设计令牌语义色（如 bg-primary / text-muted-foreground），见 foundations/color 规范。`})}}}}}),a=/\b(?:p|px|py|pt|pb|pl|pr|m|mx|my|mt|mb|ml|mr|gap|gap-x|gap-y|w|h|min-w|min-h|max-w|max-h|space-x|space-y|inset|top|right|bottom|left)-\[\d+(?:\.\d+)?(?:px|rem|em)\]/g;function o(e){let t=e.trim();return t.startsWith(`//`)||t.startsWith(`*`)||t.startsWith(`/*`)||t.startsWith(`<!--`)}const s=e({meta:{type:`problem`,docs:{description:`禁止在 className 中使用任意值间距，强制使用间距刻度（如 p-6 / gap-2）`}},createOnce(e){return{Program(t){let n=e.sourceCode.text.split(`
+`);for(let r=0;r<n.length;r+=1){if(o(n[r]))continue;a.lastIndex=0;let i=a.exec(n[r]);i&&e.report({node:t,message:`禁止任意值间距 "${i[0]}"：请使用间距刻度（如 p-6 / gap-2）或语义别名，见 foundations/spacing 规范。`})}}}}}),c=/\bz-\[\d+\]/g,l=/zIndex\s*:\s*\d+/g;function u(e){let t=e.trim();return t.startsWith(`//`)||t.startsWith(`*`)||t.startsWith(`/*`)||t.startsWith(`<!--`)}const d=e({meta:{type:`problem`,docs:{description:`禁止硬编码 z-index，强制使用层级令牌（如 z-dropdown / z-modal / z-toast）`}},createOnce(e){return{Program(t){let n=e.sourceCode.text.split(`
+`);for(let r=0;r<n.length;r+=1){if(u(n[r]))continue;c.lastIndex=0;let i=c.exec(n[r]);if(i){e.report({node:t,message:`禁止魔法 z-index "${i[0]}"：请使用层级令牌（如 z-dropdown / z-modal / z-toast），见 foundations/elevation 规范。`});continue}l.lastIndex=0;let a=l.exec(n[r]);a&&e.report({node:t,message:`禁止硬编码 zIndex "${a[0]}"：请使用层级令牌（如 z-dropdown / z-modal / z-toast），见 foundations/elevation 规范。`})}}}}}),f=t({meta:{name:`@longzai-intelligence-oxlint/design-rules-plugin`},rules:{"no-hardcoded-color":i,"no-hardcoded-spacing":s,"no-magic-z-index":d}});export{f as default,f as designRulesPlugin,i as noHardcodedColorRule,s as noHardcodedSpacingRule,d as noMagicZIndexRule};

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "@longzai-intelligence-oxlint/design-rules-plugin",
+  "version": "0.1.17",
+  "license": "UNLICENSED",
+  "files": [
+    "dist"
+  ],
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./configs/recommended": {
+      "types": "./dist/configs/recommended.d.ts",
+      "import": "./dist/configs/recommended.js"
+    }
+  },
+  "scripts": {
+    "build": "lzi-builder",
+    "build:prod": "NODE_ENV=production bun run build",
+    "prepublishOnly": "bun run build:prod",
+    "dev": "lzi-builder --watch",
+    "clean": "lzi-dev-cli clean",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "lint": "oxlint && oxfmt --check",
+    "lint:fix": "oxlint --fix && oxfmt",
+    "typecheck": "bun run typecheck:app && bun run typecheck:node && bun run typecheck:test",
+    "typecheck:app": "lzi-tsgo typecheck tsconfig/app.json",
+    "typecheck:node": "lzi-tsgo typecheck tsconfig/node.json",
+    "typecheck:test": "lzi-tsgo typecheck tsconfig/test.json"
+  },
+  "dependencies": {
+    "@longzai-intelligence-oxlint/core": "0.1.17",
+    "@longzai-intelligence-oxlint/utils": "0.1.17",
+    "@oxlint/plugins": "^1.74.0"
+  },
+  "devDependencies": {
+    "@vitest/coverage-v8": "^4.1.10"
+  },
+  "peerDependencies": {
+    "oxlint": ">=1.0.0"
+  }
+}