@linkdesk/plugin-sdk 0.1.0 → 0.1.1

package/dist/eslint/checks/spacing-grid.js

@@ -0,0 +1,54 @@
+/**
+ * check-spacing-grid.mjs 移植（E6#54d）——间距 4px 节奏刻度门禁（面向第三方插件工程）。
+ *
+ * 壳版本差异（07 §六·规则载体双轨）：root 相对扫描（任意插件工程）；豁免只留通用类别
+ * （测试 mock / i18n·主题·取色器数据目录 / eslint-disable 知情绕行）。token 定义行天然豁免：
+ * `--space-*: NNpx` 的属性名不是 padding/margin/gap，属性前缀正则不会命中（与壳同源语义）。
+ *
+ * 语义（档案）：CSS 声明行的 padding/margin/gap 值在 4px 节奏刻度上；1-6px = 微调值
+ * （图标间距/紧凑内边距有意的精细控制）豁免；>6px 非 4 倍数 = 违规模板。
+ * 纯函数返回违规数组（不 process.exit）——知情绕行由 buildDisableIndex 裁决。
+ */
+import { collectFiles, relPath, readSource, stripComments, stripLineComments, isTestOrMockRel } from "./scan.js";
+import { buildDisableIndex, isDisabled, CHECK_IDS } from "./disable.js";
+const DATA_DIR_RE = /(^|\/)(i18n|themes?|color-picker)\//;
+const EXT_CSS = [".css"];
+/** 声明行命中：本行含 padding/margin/gap（含 padding-inline 等逻辑属——前缀 \b 后须紧跟 :，逻辑属被天然排除，与壳同源） */
+const DECL_LINE_RE = /\b(padding|margin|gap)\s*:/;
+const PX_RE = /\b(\d+)px\b/g;
+export function runSpacingGridCheck(root) {
+    const violations = [];
+    for (const css of collectFiles(root, EXT_CSS)) {
+        const rel = relPath(root, css);
+        if (isTestOrMockRel(rel))
+            continue;
+        if (DATA_DIR_RE.test(rel))
+            continue;
+        const src = readSource(css);
+        const disabled = buildDisableIndex(src, [CHECK_IDS.spacingGrid]);
+        const cleaned = stripLineComments(stripComments(src));
+        cleaned.split("\n").forEach((line, i) => {
+            if (!DECL_LINE_RE.test(line))
+                return;
+            const line1 = i + 1;
+            for (const m of line.matchAll(PX_RE)) {
+                const value = parseInt(m[1], 10);
+                if (value <= 6)
+                    continue; // 微调值（图标间距/紧凑内边距有意的精细控制）
+                if (value % 4 === 0)
+                    continue; // 4px 节奏合规
+                // 知情绕行 = 静默豁免（对齐 eslint suppress 语义，disable 声明后不亮灯）
+                if (isDisabled(disabled, line1, CHECK_IDS.spacingGrid))
+                    continue;
+                violations.push({
+                    file: rel,
+                    line: line1,
+                    message: `${line.trim().slice(0, 100)}  ← ${value}px 不在 4px 节奏刻度上（padding/margin/gap）——` +
+                        "归到最近 4px 倍数，或 eslint-disable-next-line linkdesk/no-nonstandard-spacing -- 理由",
+                });
+            }
+        });
+    }
+    return violations;
+}
+//# sourceMappingURL=spacing-grid.js.map

package/dist/eslint/checks/spacing-grid.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spacing-grid.js","sourceRoot":"","sources":["../../../src/eslint/checks/spacing-grid.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,iBAAiB,EAAE,eAAe,EAAuB,MAAM,WAAW,CAAC;AACtI,OAAO,EAAE,iBAAiB,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAExE,MAAM,WAAW,GAAG,qCAAqC,CAAC;AAC1D,MAAM,OAAO,GAAG,CAAC,MAAM,CAAC,CAAC;AACzB,sFAAsF;AACtF,MAAM,YAAY,GAAG,4BAA4B,CAAC;AAClD,MAAM,KAAK,GAAG,cAAc,CAAC;AAE7B,MAAM,UAAU,mBAAmB,CAAC,IAAY;IAC9C,MAAM,UAAU,GAAqB,EAAE,CAAC;IACxC,KAAK,MAAM,GAAG,IAAI,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,EAAE,CAAC;QAC9C,MAAM,GAAG,GAAG,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;QAC/B,IAAI,eAAe,CAAC,GAAG,CAAC;YAAE,SAAS;QACnC,IAAI,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC;YAAE,SAAS;QACpC,MAAM,GAAG,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC;QAC5B,MAAM,QAAQ,GAAG,iBAAiB,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC,CAAC;QACjE,MAAM,OAAO,GAAG,iBAAiB,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC;QACtD,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE;YACtC,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC;gBAAE,OAAO;YACrC,MAAM,KAAK,GAAG,CAAC,GAAG,CAAC,CAAC;YACpB,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;gBACrC,MAAM,KAAK,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBACjC,IAAI,KAAK,IAAI,CAAC;oBAAE,SAAS,CAAC,yBAAyB;gBACnD,IAAI,KAAK,GAAG,CAAC,KAAK,CAAC;oBAAE,SAAS,CAAC,WAAW;gBAC1C,oDAAoD;gBACpD,IAAI,UAAU,CAAC,QAAQ,EAAE,KAAK,EAAE,SAAS,CAAC,WAAW,CAAC;oBAAE,SAAS;gBACjE,UAAU,CAAC,IAAI,CAAC;oBACd,IAAI,EAAE,GAAG;oBACT,IAAI,EAAE,KAAK;oBACX,OAAO,EAAE,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,OAAO,KAAK,uCAAuC;wBACtF,8EAA8E;iBACjF,CAAC,CAAC;YACL,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;IACD,OAAO,UAAU,CAAC;AACpB,CAAC"}

package/dist/eslint/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * @linkdesk/plugin-sdk/eslint 子路径出口（E6#54d）——作者零配置门禁。
+ *
+ * 用法（脚手架模板）：
+ *   "lint": "linkdesk-plugin-sdk lint"          // 两条腿全跑 + 打印报告（bin）
+ *   // 或编程：linkdeskPluginLintConfig() 展开进作者自配 eslint.config.js
+ *
+ * 全量门禁 = eslint 规则腿 + 三 check 扫描腿（lint.ts 编排）。规则 id 与 disable 注释格式
+ * 见 src/eslint/rules.ts 头注（双源注记）。这里不暴露内部 check 函数——bin lint 已聚合。
+ */
+export { linkdeskPluginLintConfig } from "./preset.js";
+export type { PluginLintOptions } from "./preset.js";
+export { runPluginLint, renderPluginLintReport } from "./lint.js";
+export type { PluginLintReport, LintLeg } from "./lint.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/eslint/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/eslint/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AACvD,YAAY,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,sBAAsB,EAAE,MAAM,WAAW,CAAC;AAClE,YAAY,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC"}

package/dist/eslint/index.js

@@ -0,0 +1,13 @@
+/**
+ * @linkdesk/plugin-sdk/eslint 子路径出口（E6#54d）——作者零配置门禁。
+ *
+ * 用法（脚手架模板）：
+ *   "lint": "linkdesk-plugin-sdk lint"          // 两条腿全跑 + 打印报告（bin）
+ *   // 或编程：linkdeskPluginLintConfig() 展开进作者自配 eslint.config.js
+ *
+ * 全量门禁 = eslint 规则腿 + 三 check 扫描腿（lint.ts 编排）。规则 id 与 disable 注释格式
+ * 见 src/eslint/rules.ts 头注（双源注记）。这里不暴露内部 check 函数——bin lint 已聚合。
+ */
+export { linkdeskPluginLintConfig } from "./preset.js";
+export { runPluginLint, renderPluginLintReport } from "./lint.js";
+//# sourceMappingURL=index.js.map

package/dist/eslint/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/eslint/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AAEvD,OAAO,EAAE,aAAa,EAAE,sBAAsB,EAAE,MAAM,WAAW,CAAC"}

package/dist/eslint/lint.d.ts

@@ -0,0 +1,26 @@
+import { type PluginLintOptions } from "./preset.js";
+import { type CheckViolation } from "./checks/scan.js";
+export interface LintLeg {
+    id: string;
+    label: string;
+    violations: CheckViolation[];
+}
+export interface EslintRow {
+    file: string;
+    line: number;
+    column: number;
+    ruleId: string | null;
+    message: string;
+    severity: 1 | 2;
+}
+export interface PluginLintReport {
+    files: number;
+    eslintRows: EslintRow[];
+    legs: LintLeg[];
+    totalCheckViolations: number;
+    tsconfigUsed: string | null;
+}
+export declare function runPluginLint(root: string, options?: PluginLintOptions): Promise<PluginLintReport>;
+/** 打印报告（人机双通道的即时反馈环）；返回进程退出码（真 error 才 1，WARN 永不 fail）。 */
+export declare function renderPluginLintReport(report: PluginLintReport): string;
+//# sourceMappingURL=lint.d.ts.map

package/dist/eslint/lint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lint.d.ts","sourceRoot":"","sources":["../../src/eslint/lint.ts"],"names":[],"mappings":"AAcA,OAAO,EAA4B,KAAK,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAI/E,OAAO,EAAE,KAAK,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAKvD,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,cAAc,EAAE,CAAC;CAC9B;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,CAAC,GAAG,CAAC,CAAC;CACjB;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,SAAS,EAAE,CAAC;IACxB,IAAI,EAAE,OAAO,EAAE,CAAC;IAChB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED,wBAAsB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,iBAAsB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CA2D5G;AAED,2DAA2D;AAC3D,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM,CAkCvE"}

package/dist/eslint/lint.js

@@ -0,0 +1,112 @@
+/**
+ * `runPluginLint()`——`npm run lint` 门禁编排（E6#54d）：eslint 规则腿 + 三 check 扫描腿双轨。
+ *
+ * 对标壳 check 同款双轨（07 §六·载体双轨）：eslint（12 项注册规则，全 WARN）管 ts/tsx；
+ * css-hardcode / font-scale / spacing-grid 三移植脚本管整工程（eslint 到不了 .css，
+ * ts/tsx 的 rgb()/hsl() 也归 css-hardcode 补）。jscpd = 项目级可选（文档引导，不进编排）。
+ *
+ * 门禁哲学（07 §六·三档）：违规全 WARN **永不 fail build**——本编排按违规数统计并打印
+ * 「未处理偏离」行；退出码只反映真 error（语法致命错 / 作者自配 error 规则），WARN 不拦。
+ * 知情绕行 = 标准 eslint-disable 注释（disable.ts 语义：命中豁免行整体静默不亮灯）。
+ */
+import { ESLint } from "eslint";
+import { existsSync } from "node:fs";
+import { resolve } from "node:path";
+import { linkdeskPluginLintConfig } from "./preset.js";
+import { runCssHardcodeCheck } from "./checks/css-hardcode.js";
+import { runFontScaleCheck } from "./checks/font-scale.js";
+import { runSpacingGridCheck } from "./checks/spacing-grid.js";
+import {} from "./checks/scan.js";
+/** 示例用的门禁 id（打印知情绕行格式）；伪 id 与 check 脚本 CHECK_IDS 同源 */
+const LEG_HINT_ID = "linkdesk/no-hardcoded-hex";
+export async function runPluginLint(root, options = {}) {
+    const absRoot = resolve(root);
+    const defaultTsconfig = resolve(absRoot, "tsconfig.json");
+    const tsconfig = options.tsconfig
+        ? resolve(absRoot, options.tsconfig)
+        : existsSync(defaultTsconfig)
+            ? defaultTsconfig
+            : null;
+    const preset = linkdeskPluginLintConfig({
+        files: options.files,
+        ignore: options.ignore,
+        tsconfig: tsconfig ?? undefined, // 无 tsconfig → 剥 settings（import-x 直解 node_modules）
+    });
+    if (!tsconfig) {
+        // 剥掉 import-x/typescript resolver——工程没有 tsconfig 时它无事可做
+        for (const block of preset) {
+            if (block.settings)
+                delete block.settings;
+        }
+    }
+    const eslint = new ESLint({
+        cwd: absRoot,
+        overrideConfigFile: true, // 只用 SDK 预设——零配置确定性强，不吞作者自配 eslint.config.js
+        overrideConfig: preset,
+    });
+    const results = await eslint.lintFiles(["**/*.{ts,tsx,js,jsx}"]);
+    const eslintRows = [];
+    for (const res of results) {
+        for (const m of res.messages) {
+            eslintRows.push({
+                file: res.filePath.slice(absRoot.length + 1).split("\\").join("/"),
+                line: m.line ?? 0,
+                column: m.column ?? 0,
+                ruleId: m.ruleId,
+                message: m.message,
+                severity: m.fatal || m.severity === 2 ? 2 : 1,
+            });
+        }
+    }
+    const css = runCssHardcodeCheck(absRoot);
+    const font = runFontScaleCheck(absRoot);
+    const spacing = runSpacingGridCheck(absRoot);
+    const legs = [
+        { id: "linkdesk/no-hardcoded-hex（css + rgb/hsl 腿）", label: "check-css-hardcode", violations: css },
+        { id: "linkdesk/no-hardcoded-font-size", label: "check-font-scale", violations: font },
+        { id: "linkdesk/no-nonstandard-spacing", label: "check-spacing-grid", violations: spacing },
+    ];
+    const totalCheckViolations = css.length + font.length + spacing.length;
+    return {
+        files: results.length,
+        eslintRows,
+        legs,
+        totalCheckViolations,
+        tsconfigUsed: tsconfig ? tsconfig : null,
+    };
+}
+/** 打印报告（人机双通道的即时反馈环）；返回进程退出码（真 error 才 1，WARN 永不 fail）。 */
+export function renderPluginLintReport(report) {
+    const lines = [];
+    const errors = report.eslintRows.filter((r) => r.severity === 2);
+    const warnings = report.eslintRows.filter((r) => r.severity === 1);
+    if (errors.length > 0) {
+        lines.push(`❌ eslint ${errors.length} 处 error（语法致命错 / 作者自配 error 规则）——`);
+        for (const r of errors)
+            lines.push(`    ${r.file}:${r.line}:${r.column}  [${r.ruleId ?? "fatal"}]  ${r.message}`);
+    }
+    if (warnings.length > 0) {
+        lines.push(`⚠ eslint 规则腿：${warnings.length} 处未处理偏离（${report.files} 文件）——均为 WARN，永不 fail build。`);
+        for (const r of warnings)
+            lines.push(`    ${r.file}:${r.line}:${r.column}  [${r.ruleId}]  ${r.message}`);
+    }
+    else if (errors.length === 0) {
+        lines.push(`✅ eslint 规则腿：${report.files} 文件零偏离。`);
+    }
+    for (const leg of report.legs) {
+        if (leg.violations.length === 0) {
+            lines.push(`✅ ${leg.label}：零偏离。`);
+            continue;
+        }
+        lines.push(`⚠ ${leg.label}：${leg.violations.length} 处未处理偏离——`);
+        for (const v of leg.violations) {
+            lines.push(`    ${v.file}:${v.line}  ${v.message}`);
+        }
+    }
+    lines.push(`\n门禁 = 警告不是封锁（07 §六·三档）：未处理偏离可修可绕——知情绕行写标准注释\n` +
+        `  // eslint-disable-next-line ${LEG_HINT_ID} -- 理由   （行级）\n` +
+        `  /* eslint-disable ${LEG_HINT_ID} -- 内容画布 */   （文件级：内容/画布整文件豁免）\n` +
+        `WARN 永不 fail build/上传；偏离标签随包可见（市场层读取 disable 注释）。`);
+    return lines.join("\n");
+}
+//# sourceMappingURL=lint.js.map

package/dist/eslint/lint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lint.js","sourceRoot":"","sources":["../../src/eslint/lint.ts"],"names":[],"mappings":"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"}

package/dist/eslint/preset.d.ts

@@ -0,0 +1,11 @@
+import type { Linter } from "eslint";
+export interface PluginLintOptions {
+    /** 参与 lint 的 glob（默认：ts/tsx/js/jsx） */
+    files?: string[];
+    /** 追加忽略 glob（叠在默认忽略集之上） */
+    ignore?: string[];
+    /** import-x/no-unresolved 解析用 tsconfig 路径（相对工程根；默认 ./tsconfig.json） */
+    tsconfig?: string;
+}
+export declare function linkdeskPluginLintConfig(options?: PluginLintOptions): Linter.Config[];
+//# sourceMappingURL=preset.d.ts.map

package/dist/eslint/preset.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preset.d.ts","sourceRoot":"","sources":["../../src/eslint/preset.ts"],"names":[],"mappings":"AAsBA,OAAO,KAAK,EAAE,MAAM,EAAU,MAAM,QAAQ,CAAC;AAK7C,MAAM,WAAW,iBAAiB;IAChC,uCAAuC;IACvC,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,2BAA2B;IAC3B,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,uEAAuE;IACvE,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAgBD,wBAAgB,wBAAwB,CAAC,OAAO,GAAE,iBAAsB,GAAG,MAAM,CAAC,MAAM,EAAE,CAkDzF"}

package/dist/eslint/preset.js

@@ -0,0 +1,88 @@
+/**
+ * `linkdeskPluginLintConfig()`——第三方插件工程的 eslint 门禁预设（E6#54d）。
+ *
+ * 07 设计 §六「三档梯度」：全部规则 **WARN 级，永不 fail build/上传**——lint 是建议不是封锁。
+ * 知情绕行 = 标准 eslint-disable 注释（行级 eslint-disable-next-line/eslint-disable-line，
+ * 或文件级 eslint-disable 批量声明——注释里带理由 `-- 内容画布` 等），本预设把
+ * reportUnusedDisableDirectives 留给调用方关闭（见 lint.ts——脚本伪 id 如
+ * linkdesk/no-hardcoded-font-size 非 eslint rule，eslint 不认，靠 check 脚本自己认）。
+ *
+ * 15 项门禁载体双轨（07 §六·审计对齐）：
+ *   - 本预设 = eslint 规则腿（rules 映射 12 项注册）；
+ *   - 整工程扫描腿 = css-hardcode / font-scale / spacing-grid 三 check（lint.ts 调 run*Check）——
+ *     css 与 rgb()/hsl() 的 hex 强拦、字号 token、间距 4px 节奏（eslint 到不了 .css）；
+ *   - jscpd（克隆检测）= 项目级可选，不进预设（文档引导）。
+ *   `npm run lint`（bin lint）两条腿都走，对标壳 check 同款双轨。
+ *
+ * 脚手架模板默认启用本预设（07 §八）；作者可自定义 eslint.config 后自管。
+ */
+import tseslint from "@typescript-eslint/eslint-plugin";
+import tsparser from "@typescript-eslint/parser";
+import reactHooks from "eslint-plugin-react-hooks";
+import importX from "eslint-plugin-import-x";
+import { linkdeskRuleMap } from "./rules.js";
+/** 默认忽略 = 构建产物 / 依赖 / 版本控制 / vite 缓存 / 声明文件 / 测试与 mock（对齐 scan.ts SKIP_DIRS 语义） */
+const BASE_IGNORES = [
+    "**/node_modules/**",
+    "**/dist/**",
+    "**/dist-electron/**",
+    "**/out/**",
+    "**/coverage/**",
+    "**/.git/**",
+    "**/.vite/**",
+    "**/*.d.ts",
+    "**/*.{test,spec}.{ts,tsx,js,jsx}",
+    "**/*.{fixture,mock}.{ts,tsx,js,jsx}",
+];
+export function linkdeskPluginLintConfig(options = {}) {
+    const files = options.files ?? ["**/*.{ts,tsx,js,jsx}"];
+    const tsconfig = options.tsconfig ?? "./tsconfig.json";
+    return [
+        { ignores: [...BASE_IGNORES, ...(options.ignore ?? [])] },
+        {
+            files,
+            languageOptions: {
+                parser: tsparser,
+                parserOptions: {
+                    ecmaVersion: "latest",
+                    sourceType: "module",
+                    ecmaFeatures: { jsx: true },
+                },
+            },
+            // 脚本伪 id（linkdesk/no-hardcoded-font-size / no-nonstandard-spacing）不是 eslint rule——
+            // 关掉 unused-disable 报告，eslint 不报"未找到规则"，靠 check 脚本自己认这些注释
+            linterOptions: { reportUnusedDisableDirectives: "off" },
+            // 各插件包的 configs 类型与 eslint 9 的 Plugin.configs 联合类型跨包漂移（tseslint 8 / react-hooks 7 /
+            // import-x 4 各自定义 configs），运行时语义兼容——统一按 eslint Plugin 收窄（eslint-config-* 生态同法）
+            plugins: {
+                "@typescript-eslint": tseslint,
+                linkdesk: { rules: linkdeskRuleMap }, // kebab 键 = eslint 按原样查（无 camel 转换）
+                "react-hooks": reactHooks,
+                "import-x": importX,
+            },
+            settings: {
+                "import-x/resolver": {
+                    typescript: { alwaysTryTypes: true, project: tsconfig },
+                },
+            },
+            rules: {
+                // ═══ 07 §六 · React 通用陷阱 6 条（react-hooks 官方 2 + 移植 4）═══
+                "react-hooks/rules-of-hooks": "warn",
+                "react-hooks/exhaustive-deps": "warn",
+                "linkdesk/no-async-init-guard-only": "warn",
+                "linkdesk/no-effect-callback-without-active-guard": "warn",
+                "linkdesk/no-dynamic-import-in-effect-cleanup": "warn",
+                "linkdesk/no-ref-current-in-jsx": "warn",
+                // ═══ 07 §六 · 视觉统一 5 条（eslint 腿；css + rgb/hsl 腿 = lint.ts 三 check）═══
+                "linkdesk/no-hardcoded-zh": "warn", // ts/tsx UI 文案中文字面量——推荐 t()
+                "linkdesk/no-hardcoded-hex": "warn", // ts/tsx hex（同 disable id = 强化版 css 腿，见 css-hardcode.ts）
+                "linkdesk/no-hardcoded-radius": "warn", // border-radius 裸 px——推荐 var(--radius-*)/var(--surface-radius)
+                "import-x/no-unresolved": "warn", // 模块路径拼错
+                // ═══ 07 §六 · 审美 4 条（eslint 腿；spacing 腿在 lint.ts；jscpd 文档引导可选）═══
+                "linkdesk/no-quickpick-render-item": "warn",
+                "@typescript-eslint/no-explicit-any": "warn",
+            },
+        },
+    ];
+}
+//# sourceMappingURL=preset.js.map

package/dist/eslint/preset.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"preset.js","sourceRoot":"","sources":["../../src/eslint/preset.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,OAAO,QAAQ,MAAM,kCAAkC,CAAC;AACxD,OAAO,QAAQ,MAAM,2BAA2B,CAAC;AACjD,OAAO,UAAU,MAAM,2BAA2B,CAAC;AACnD,OAAO,OAAO,MAAM,wBAAwB,CAAC;AAE7C,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAa7C,mFAAmF;AACnF,MAAM,YAAY,GAAG;IACnB,oBAAoB;IACpB,YAAY;IACZ,qBAAqB;IACrB,WAAW;IACX,gBAAgB;IAChB,YAAY;IACZ,aAAa;IACb,WAAW;IACX,kCAAkC;IAClC,qCAAqC;CACtC,CAAC;AAEF,MAAM,UAAU,wBAAwB,CAAC,UAA6B,EAAE;IACtE,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,CAAC,sBAAsB,CAAC,CAAC;IACxD,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,iBAAiB,CAAC;IACvD,OAAO;QACL,EAAE,OAAO,EAAE,CAAC,GAAG,YAAY,EAAE,GAAG,CAAC,OAAO,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,EAAE;QACzD;YACE,KAAK;YACL,eAAe,EAAE;gBACf,MAAM,EAAE,QAAQ;gBAChB,aAAa,EAAE;oBACb,WAAW,EAAE,QAAQ;oBACrB,UAAU,EAAE,QAAQ;oBACpB,YAAY,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE;iBAC5B;aACF;YACD,mFAAmF;YACnF,0DAA0D;YAC1D,aAAa,EAAE,EAAE,6BAA6B,EAAE,KAAK,EAAE;YACvD,oFAAoF;YACpF,+EAA+E;YAC/E,OAAO,EAAE;gBACP,oBAAoB,EAAE,QAAkC;gBACxD,QAAQ,EAAE,EAAE,KAAK,EAAE,eAAe,EAA4B,EAAE,oCAAoC;gBACpG,aAAa,EAAE,UAAoC;gBACnD,UAAU,EAAE,OAAiC;aAC9C;YACD,QAAQ,EAAE;gBACR,mBAAmB,EAAE;oBACnB,UAAU,EAAE,EAAE,cAAc,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE;iBACxD;aACF;YACD,KAAK,EAAE;gBACL,yDAAyD;gBACzD,4BAA4B,EAAE,MAAM;gBACpC,6BAA6B,EAAE,MAAM;gBACrC,mCAAmC,EAAE,MAAM;gBAC3C,kDAAkD,EAAE,MAAM;gBAC1D,8CAA8C,EAAE,MAAM;gBACtD,gCAAgC,EAAE,MAAM;gBACxC,sEAAsE;gBACtE,0BAA0B,EAAE,MAAM,EAAE,4BAA4B;gBAChE,2BAA2B,EAAE,MAAM,EAAE,yDAAyD;gBAC9F,8BAA8B,EAAE,MAAM,EAAE,+DAA+D;gBACvG,wBAAwB,EAAE,MAAM,EAAE,SAAS;gBAC3C,kEAAkE;gBAClE,mCAAmC,EAAE,MAAM;gBAC3C,oCAAoC,EAAE,MAAM;aAC7C;SACF;KACF,CAAC;AACJ,CAAC"}

package/dist/eslint/rules.d.ts

@@ -0,0 +1,28 @@
+/**
+ * @linkdesk/plugin-sdk 门禁自定义规则（E6#54d）——从壳 eslint-local-rules.js 移植的作者面向子集。
+ *
+ * 🔴 双源注记（与壳 eslint-local-rules.js 同 id / 同语义，防作者文档与壳文档二义）：
+ *   壳规则管壳代码（src/ + 仓库内 plugins/），本文件规则管第三方插件工程（仓库外）——两个
+ *   工程物理隔离，发布态 plugin-sdk 不能 import 仓库源码，故是"移植副本"而非"共享单源"。
+ *   与壳语义同名的规则沿用 `linkdesk/` 命名空间 + 同名（no-hardcoded-hex / no-async-init-guard-only /
+ *   no-effect-callback-without-active-guard / no-dynamic-import-in-effect-cleanup / no-ref-current-in-jsx /
+ *   no-quickpick-render-item）——disable 注释格式两套配置一致；zh 规则例外：SDK 用设计文档 07 §六
+ *   id `linkdesk/no-hardcoded-zh`（壳遗留名 no-hardcoded-chinese，第三方作者不写壳代码故不冲突），
+ *   no-hardcoded-radius 为 SDK 新写（壳无对应）。改消息文本 / 规则 id 时同步核对壳 eslint-local-rules.js。
+ *
+ * 三档梯度定位（07 设计 §六）：这些规则全部 WARN 级（永不 fail build/上传），报错自解释
+ * （错在哪 + 换成什么 + 为什么），知情绕行 = 标准 eslint-disable 注释（非发明新语法）。
+ *
+ * 规则命名空间 = `linkdesk`（与壳一致），由 src/eslint/preset.ts 注册进 flat config。
+ */
+import type { Rule } from "eslint";
+export declare const noAsyncInitGuardOnly: Rule.RuleModule;
+export declare const noEffectCallbackWithoutActiveGuard: Rule.RuleModule;
+export declare const noDynamicImportInEffectCleanup: Rule.RuleModule;
+export declare const noRefCurrentInJsx: Rule.RuleModule;
+export declare const noHardcodedZh: Rule.RuleModule;
+export declare const noHardcodedHex: Rule.RuleModule;
+export declare const noHardcodedRadius: Rule.RuleModule;
+export declare const noQuickpickRenderItem: Rule.RuleModule;
+export declare const linkdeskRuleMap: Record<string, Rule.RuleModule>;
+//# sourceMappingURL=rules.d.ts.map

package/dist/eslint/rules.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rules.d.ts","sourceRoot":"","sources":["../../src/eslint/rules.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAMnC,eAAO,MAAM,oBAAoB,EAAE,IAAI,CAAC,UAuDvC,CAAC;AAMF,eAAO,MAAM,kCAAkC,EAAE,IAAI,CAAC,UA0CrD,CAAC;AAgCF,eAAO,MAAM,8BAA8B,EAAE,IAAI,CAAC,UAuCjD,CAAC;AAMF,eAAO,MAAM,iBAAiB,EAAE,IAAI,CAAC,UAsBpC,CAAC;AA4CF,eAAO,MAAM,aAAa,EAAE,IAAI,CAAC,UAsChC,CAAC;AAWF,eAAO,MAAM,cAAc,EAAE,IAAI,CAAC,UAmCjC,CAAC;AAUF,eAAO,MAAM,iBAAiB,EAAE,IAAI,CAAC,UA4CpC,CAAC;AAKF,eAAO,MAAM,qBAAqB,EAAE,IAAI,CAAC,UA2BxC,CAAC;AAOF,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,UAAU,CAS3D,CAAC"}