@linkdesk/plugin-sdk 0.1.38 → 0.1.40

package/README.md

@@ -18,7 +18,7 @@ npm install -D @linkdesk/plugin-sdk
 > 自动生成，**勿手改**——由 `scripts/generate-api-cheatsheet.mjs` 从 `@linkdesk/contracts` 的 `linkdesk.d.ts` 现读产出，
 > `npm run check` 机械盯漂。完整签名与逐方法说明见 `linkdesk.d.ts` 本体（IDE 里可直接跳转）。
 
-**15 个域接口 → 46 个命名空间 / 243 个方法**，全部经 `window.linkdesk.<命名空间>.<方法>` 调用。 (plus 1 deprecated alias/es `config`, not counted twice)
+**15 个域接口 → 46 个命名空间 / 244 个方法**，全部经 `window.linkdesk.<命名空间>.<方法>` 调用。 (plus 1 deprecated alias/es `config`, not counted twice)
 
 | Namespace | Methods | Method | Notes |
 |:--|:--:|:--|:--|
@@ -55,7 +55,7 @@ npm install -D @linkdesk/plugin-sdk
 | `lsp` | 4 | `spawn` `write` `dispose` `onData` | E5.6#14-lsp：LSP 桥——自动补全/F12/诊断/重命名 |
 | `protocol` | 3 | `listProtocols` `getActiveProtocolId` `setActiveProtocolId` | E5.7#49：protocol——协议注册表（主进程直答） |
 | `viewContainer` | 4 | `getViewContainer` `getViews` `getView` `registerView` | E5.7#58：viewContainer——真 IPC 查询/更新（问壳侧注册表） |
-| `plugins` | 13 | `resolvePath` `resolveEntry`° `listDirs`° `listAll`° `listDisabledDirs`° `readManifest`° `readAllManifests`° `packageDownload`° `packageExtract`° `packageCancel`° `packageUpdateCheck`° `packageStageUpdate`° `packageCommitUpdate`° | 插件发现——双端注入：resolvePath 双端同面 |
+| `plugins` | 14 | `resolvePath` `resolveEntry`° `getCompatibility`° `listDirs`° `listAll`° `listDisabledDirs`° `readManifest`° `readAllManifests`° `packageDownload`° `packageExtract`° `packageCancel`° `packageUpdateCheck`° `packageStageUpdate`° `packageCommitUpdate`° | 插件发现——双端注入：resolvePath 双端同面 |
 | `pluginManager` | 13 | `list` `enable` `disable` `uninstall` `install` `installWithProgress`° `reinstall` `getDisabled` `getUninstalled` `isDisabled` `update`° `checkUpdates`° `notifyManifestChanged`° | 插件管理——桥接 IpcBridgeHandler → loader 函数 |
 | `bridge` ⚠️ | 4 | `onRequest` `respond` `broadcast` `notifyConfigChanged` | 壳↔插件通信中继——壳 preload 独有 |
 | `pool` | 31 | `pushLayout` `onReady` `toggleDevTools` `onSidebarAction` `onTabAction` `onTabBarRects` `onDragPosition` `pushAdsorbHint` `onAdsorbIndex` `pushQuickPick` `onQuickPickAction` `pushDialog` `onDialogAction` `pushFloatingPanel` `onFloatingPanelAction` `onMemoryPressure` `createWindow` `closeWindow` `onWindowClosed` `onWindowBoundsChanged` `onLayout` `ready` `sidebarAction` `tabAction` `tabBarRects` `dragPosition` `onAdsorbHint` `adsorbIndex` `registerBeforeClose` `unregisterBeforeClose` `beforeClose` | 池控制——壳 preload：推送布局 + 注册池→壳动作回调 |

package/dev-host/linkdesk-mock.generated.ts

@@ -252,6 +252,7 @@ export const linkdeskMock: Record<string, unknown> = {
   plugins: {
     resolvePath: async (..._args: unknown[]) => { console.info("[linkdesk-mock] plugins.resolvePath", ..._args); return ""; },
     resolveEntry: async (..._args: unknown[]) => { console.info("[linkdesk-mock] plugins.resolveEntry", ..._args); },
+    getCompatibility: async (..._args: unknown[]) => { console.info("[linkdesk-mock] plugins.getCompatibility", ..._args); },
     listDirs: async (..._args: unknown[]) => { console.info("[linkdesk-mock] plugins.listDirs", ..._args); return []; },
     listAll: async (..._args: unknown[]) => { console.info("[linkdesk-mock] plugins.listAll", ..._args); return []; },
     listDisabledDirs: async (..._args: unknown[]) => { console.info("[linkdesk-mock] plugins.listDisabledDirs", ..._args); return []; },

package/dist/eslint/checks/dangling-names.d.ts

@@ -0,0 +1,65 @@
+import { type CheckViolation } from "./scan.js";
+import { type PluginIdResolution } from "./plugin-prefix.js";
+/** 判级文案——作者面（00 总纲 §〇d：这一面允许「名字 ＋ 文件:行 ＋ 两步修法」） */
+export declare const DANGLING_NAME_WHY: {
+    readonly jsClassname: string;
+    readonly cssAnimation: "`animation` 引用的关键帧在本方没有 `@keyframes` 定义 ⇒ **动画静默消失**（不报错、只是不动）。";
+};
+/** 随包下发的宿主 CSS 定义集（`schemas/host-css-names.json`，与壳运行时清单同一生成器） */
+export interface HostCssNames {
+    version: number;
+    generatedFrom: string;
+    /** 宿主定义/提及的类名全集（裸定义全 ldk-* ＋ 宿主加载的第三方 CSS 名） */
+    classes: string[];
+    /** 宿主关键帧名全集（@keyframes 定义 ＋ 保留关键帧账） */
+    keyframes: string[];
+    reservedKeyframeCount: number;
+}
+/** 读随包宿主定义集；缺失/坏 ⇒ null（调用方 fail-closed 报「未核验」，⛔ 不许当 0 处通过） */
+export declare function loadHostCssNames(file?: string): HostCssNames | null;
+/** 一处悬空引用站点 */
+export interface DanglingNameSite {
+    /** 工程相对路径（正斜杠） */
+    file: string;
+    /** 1-based */
+    line: number;
+    /** 被引用但两个定义集里都没有的名字 */
+    name: string;
+    /** 引用通道：JS className 字面量 / CSS animation 引用 */
+    via: "js-classname" | "css-animation";
+}
+export interface DanglingNameReport {
+    root: string;
+    pluginId: string | null;
+    /** 非 null ⇒ fail-closed（宿主定义集读不到 ⇒ 「未核验」，⛔ 不许当 0 处通过） */
+    error: string | null;
+    /** 宿主定义集规模（审计读数用；error 非 null 时为 0） */
+    hostClassCount: number;
+    hostKeyframeCount: number;
+    /** 产物/源码 JS 喊的 `ldk-*` 名站点数 */
+    ldkRefs: number;
+    /** CSS `animation:` 引用点数 */
+    kfRefs: number;
+    /** 射程外计数（含插值的模板 / 动态拼接——静态读不出，⛔ 不判） */
+    skipped: {
+        interp: number;
+        dynamic: number;
+    };
+    /** 非 `ldk-` 且两个定义集都没有的未判名数（自有命名空间 / DOM 钩子 / 第三方内联） */
+    notJudgedCount: number;
+    /** `ldk-*` 名只被包内自己满足（归 `plugin-prefix.ts` 前缀腿判红，本腿不判悬空） */
+    borrowedLdk: string[];
+    /** 悬空站点 */
+    dangling: DanglingNameSite[];
+    /** 腿报点 = fail-closed ＋ 悬空 */
+    violations: CheckViolation[];
+}
+/**
+ * 跑本仓悬空名判据（作者侧唯一入口）。返回结构化报告——**同一份实现，没有第二条判据路径**。
+ * ⚠️ `host` / `resolution` 可注入（单测用）；缺省读随包 `schemas/host-css-names.json`。
+ */
+export declare function runDanglingNameCheck(root: string, opts?: {
+    host?: HostCssNames | null;
+    resolution?: PluginIdResolution;
+}): DanglingNameReport;
+//# sourceMappingURL=dangling-names.d.ts.map

package/dist/eslint/checks/dangling-names.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dangling-names.d.ts","sourceRoot":"","sources":["../../../src/eslint/checks/dangling-names.ts"],"names":[],"mappings":"AA+CA,OAAO,EAKL,KAAK,cAAc,EACpB,MAAM,WAAW,CAAC;AAQnB,OAAO,EAAyB,KAAK,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAEpF,mDAAmD;AACnD,eAAO,MAAM,iBAAiB;;;CAMpB,CAAC;AAEX,kEAAkE;AAClE,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;IACtB,gDAAgD;IAChD,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,uCAAuC;IACvC,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,qBAAqB,EAAE,MAAM,CAAC;CAC/B;AAWD,+DAA+D;AAC/D,wBAAgB,gBAAgB,CAAC,IAAI,GAAE,MAA4B,GAAG,YAAY,GAAG,IAAI,CAexF;AAuLD,eAAe;AACf,MAAM,WAAW,gBAAgB;IAC/B,kBAAkB;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,cAAc;IACd,IAAI,EAAE,MAAM,CAAC;IACb,uBAAuB;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,+CAA+C;IAC/C,GAAG,EAAE,cAAc,GAAG,eAAe,CAAC;CACvC;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,yDAAyD;IACzD,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,uCAAuC;IACvC,cAAc,EAAE,MAAM,CAAC;IACvB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,+BAA+B;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,4BAA4B;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,uCAAuC;IACvC,OAAO,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAC7C,uDAAuD;IACvD,cAAc,EAAE,MAAM,CAAC;IACvB,2DAA2D;IAC3D,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,WAAW;IACX,QAAQ,EAAE,gBAAgB,EAAE,CAAC;IAC7B,6BAA6B;IAC7B,UAAU,EAAE,cAAc,EAAE,CAAC;CAC9B;AAaD;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,MAAM,EACZ,IAAI,GAAE;IAAE,IAAI,CAAC,EAAE,YAAY,GAAG,IAAI,CAAC;IAAC,UAAU,CAAC,EAAE,kBAAkB,CAAA;CAAO,GACzE,kBAAkB,CA6GpB"}

package/dist/eslint/checks/dangling-names.js

@@ -0,0 +1,469 @@
+/**
+ * check-css-namespace 腿·**插件域悬空名判据**（E6#119 · 2026-09-19）。
+ *
+ * ── 规则一句话 ──
+ * 插件产物是**冻结的快照**：发布那一刻的名字被烘进 bundle，之后宿主改名/删除它不会知道
+ * （实证：`.ldk-input` 那一路，`settings` v1.0.12 → v1.0.13 输入框丢底色/边框/圆角，**零报错**）。
+ * 本腿把格 1 那把尺子（壳仓 `scripts/plugin-dangling-name-audit.mjs`，E6#114）搬到**作者自己的仓里**：
+ * 作者在他自己的 CI / 本地就能跑出红黄，不必来问维护者——「让第三方插件作者自由制造插件」的机械兑现。
+ * 规则正文 = `docs/02-Electron架构/E6_插件生态与发布/插件兼容机械化/06-任务-判据铺开.md`。
+ *
+ * ── 🔴 这不是第二把尺子（三份同口径）──
+ * 判据口径的唯一真相源 = 壳仓 `scripts/plugin-dangling-name-audit.mjs`（格 1 尺子）。三份实现同口径：
+ *   ① 壳尺子（产物层只读审计）② 壳运行时腿 `src/core/compat/dangling-scan.ts`（格 4，**已与格 1 在
+ *   随包 6 zip 上对账逐只相等**，对账测试常驻壳 check）③ **本腿**（作者侧，本文件）。
+ * 跨包无法 import ⇒ 照 E6#112 `锚⑨` 先例用**锚词**把口径钉住：壳尺子 `--self-test` 的 `锚⑩`
+ * 与本包单测各断言一遍（下方「口径锚词」块 ＋ 壳尺子 §判据 的原句逐字同源——改一边不改另一边必红）。
+ *
+ * ── 口径锚词（与格 1 尺子逐字同源——`锚⑩` 断言的另一半）──
+ *   · 🔴 判据：只判「**不属于它自己**的名字」；
+ *   · **悬空** = 须判定的引用，在「自身定义集 ∪ 当前宿主定义集」里都没有；
+ *   · 动态拼接一律**跳过并计数**（静态读不出运行时拼出来的名字，拦就假红）；
+ *   · 非 `ldk-` 的未定义名**不计悬空**（自有命名空间 / DOM 钩子 / 第三方内联）——假红比漏报更坏；
+ *   · `ldk-*` 名只被包内自己满足 ⇒ borrowedLdk（归本包前缀腿判红，本腿不判悬空）；
+ *   · 产物 CSS 里 `animation:` / `animation-name:` 引用的**关键帧名**（引用方与定义方分离）。
+ *
+ * ── 域差异（如实写，不是漏了）──
+ * 格 1 尺子扫**产物**（构建后的 bundle），本腿扫**作者源码**（src 树，`scan.ts` 的 SKIP_DIRS 已排
+ * node_modules/dist）——域不同、判定口径同一份。测试/mock 文件不进产物 ⇒ 本腿照既有各腿口径跳过
+ * （`isTestOrMockRel`），否则夹具里的假名字当场假红。
+ *
+ * ── 宿主定义集（作者侧拿不到壳源码 ⇒ 随包下发）──
+ * `schemas/host-css-names.json`（本格新增的随包 schema）——壳侧 `scripts/gen-host-css-manifest.mjs`
+ * 从 `collectHostDefs()`（格 1/格 2 同一采集器）生成，与壳运行时清单 `host-css.generated.ts`
+ * **同一生成器同一次采集**（⛔ 两份口径不会分叉）。🔴 **保底（fail-closed）**：宿主定义集读不到
+ * ⇒ 报「**未核验**」违规——⛔ **不许当成 0 处通过**（假绿比假红更坏：作者会以为已经查过了）。
+ *
+ * ── 明确不做的三件（防越界）──
+ *   ⛔ 不判「该不该退役 / 老不老」（时间不设阈值——本层红线③）；
+ *   ⛔ 不判**前缀**（「裸定义必须 `<pluginId>-` 开头」是 `plugin-prefix.ts` 的活；自己定义的 `ldk-*`
+ *      归它判红，本腿只把它从悬空里排除）；
+ *   ⛔ 不做退役名提示（那是 `retired-names.ts` 的活，且**永远只是提示、不是拒绝**）。
+ *
+ * 知情绕行 = 标准 disable 注释（`CHECK_IDS.cssNamespace`，与类名／关键帧／token／形态同一 id）。
+ */
+import { existsSync, readFileSync } from "node:fs";
+import { resolve, dirname } from "node:path";
+import { fileURLToPath } from "node:url";
+import { collectCssUnits, collectFiles, isTestOrMockRel, relPath, } from "./scan.js";
+import { bareClassDefinitions, keyframeDefinitions, animationRefs, splitSelector, } from "./css-selectors.js";
+import { buildDisableIndex, isDisabled, CHECK_IDS } from "./disable.js";
+import { resolvePluginIdForCss } from "./plugin-prefix.js";
+/** 判级文案——作者面（00 总纲 §〇d：这一面允许「名字 ＋ 文件:行 ＋ 两步修法」） */
+export const DANGLING_NAME_WHY = {
+    jsClassname: "它喊的名字宿主已经没有、自己也没定义 ⇒ 发布后**静默丢样式**（零报错）。「宿主改一个类名，" +
+        "插件侧要升依赖＋重打包两件、少任何一件就静默失样」是这条判据的真实发生率来源。",
+    cssAnimation: "`animation` 引用的关键帧在本方没有 `@keyframes` 定义 ⇒ **动画静默消失**（不报错、只是不动）。",
+};
+/**
+ * 包内宿主 CSS 定义集定位（dist/eslint/checks/x.js → ../../../schemas = 包根/schemas；src 直跑同样命中）。
+ * 🔴 路径式 resolve（`reserved-classes.ts` 同款）——`new URL(<字面量>, import.meta.url)` 会被 Vite 改写。
+ */
+const HOST_CSS_NAMES_FILE = resolve(dirname(fileURLToPath(import.meta.url)), "../../../schemas/host-css-names.json");
+/** 读随包宿主定义集；缺失/坏 ⇒ null（调用方 fail-closed 报「未核验」，⛔ 不许当 0 处通过） */
+export function loadHostCssNames(file = HOST_CSS_NAMES_FILE) {
+    if (!existsSync(file))
+        return null;
+    try {
+        const raw = JSON.parse(readFileSync(file, "utf8"));
+        if (!Array.isArray(raw.classes) || !Array.isArray(raw.keyframes))
+            return null;
+        return {
+            version: raw.version ?? 0,
+            generatedFrom: raw.generatedFrom ?? "",
+            classes: raw.classes,
+            keyframes: raw.keyframes,
+            reservedKeyframeCount: raw.reservedKeyframeCount ?? 0,
+        };
+    }
+    catch {
+        return null;
+    }
+}
+/** 名字形态（与格 1 尺子 `IDENT` 同款）——⛔ 别放宽成「像名字就行」 */
+const IDENT = /^-?[_a-zA-Z][\w-]*$/;
+/** 宿主/共享命名空间：硬约束 23 —— `ldk-` 整个命名空间属宿主侧，插件不得定义 */
+const HOST_NAMESPACE = /^ldk-/;
+/** 偏移 → 1-based 行号 */
+const lineAt = (text, index) => text.slice(0, index).split("\n").length;
+/* jscpd:ignore-start */
+/* ↑ 与壳仓两份移植（scripts/plugin-dangling-name-audit.mjs / src/core/compat/dangling-scan.ts）的
+   JS 词法段逐行同构——跨包无法 import；口径由 `锚⑩`（锚词）＋ 单测钉住，见文件头。 */
+/**
+ * 极简 JS 词法遍历：跳过字符串 / 模板正文 / 注释 / 正则，只对**代码**里的标识符回调。
+ * 模板的 `${…}` 内部仍是代码 ⇒ 递归进去（嵌套模板一并处理）。与格 1 `scanCode` 逐行同构。
+ */
+function scanCode(text, start, onWord) {
+    const regexAllowed = (prev) => prev === "" || /[([{,;:=!&|?+\-*%~^<>]/.test(prev) || prev === "return" || prev === "typeof";
+    let i = start;
+    let prev = "";
+    while (i < text.length) {
+        const c = text[i];
+        const c2 = text[i + 1];
+        if (c === "/" && c2 === "/") {
+            const e = text.indexOf("\n", i);
+            i = e < 0 ? text.length : e + 1;
+            continue;
+        }
+        if (c === "/" && c2 === "*") {
+            const e = text.indexOf("*/", i + 2);
+            i = e < 0 ? text.length : e + 2;
+            continue;
+        }
+        if (c === '"' || c === "'") {
+            i = skipString(text, i, c);
+            prev = '"';
+            continue;
+        }
+        if (c === "`") {
+            i = skipTemplate(text, i, onWord);
+            prev = "`";
+            continue;
+        }
+        if (c === "/" && regexAllowed(prev)) {
+            i = skipRegex(text, i);
+            prev = "/";
+            continue;
+        }
+        if (/[A-Za-z_$]/.test(c)) {
+            let j = i;
+            while (j < text.length && /[\w$]/.test(text[j]))
+                j++;
+            const word = text.slice(i, j);
+            onWord(word, j);
+            prev = word;
+            i = j;
+            continue;
+        }
+        if (!/\s/.test(c))
+            prev = c;
+        i++;
+    }
+    return i;
+}
+const skipString = (text, i, quote) => {
+    let j = i + 1;
+    while (j < text.length) {
+        if (text[j] === "\\") {
+            j += 2;
+            continue;
+        }
+        if (text[j] === quote)
+            return j + 1;
+        j++;
+    }
+    return text.length;
+};
+const skipTemplate = (text, i, onWord) => {
+    let j = i + 1;
+    while (j < text.length) {
+        if (text[j] === "\\") {
+            j += 2;
+            continue;
+        }
+        if (text[j] === "`")
+            return j + 1;
+        if (text[j] === "$" && text[j + 1] === "{") {
+            j = skipBraced(text, j + 2, onWord);
+            continue;
+        }
+        j++;
+    }
+    return text.length;
+};
+/** 从 `${` 之后扫到配对的 `}`（内部按代码处理：字符串/模板/嵌套括号都过一遍） */
+const skipBraced = (text, i, onWord) => {
+    let depth = 1;
+    let j = i;
+    while (j < text.length) {
+        const c = text[j];
+        if (c === '"' || c === "'") {
+            j = skipString(text, j, c);
+            continue;
+        }
+        if (c === "`") {
+            j = skipTemplate(text, j, onWord);
+            continue;
+        }
+        if (c === "/" && text[j + 1] === "/") {
+            const e = text.indexOf("\n", j);
+            j = e < 0 ? text.length : e + 1;
+            continue;
+        }
+        if (c === "/" && text[j + 1] === "*") {
+            const e = text.indexOf("*/", j + 2);
+            j = e < 0 ? text.length : e + 2;
+            continue;
+        }
+        if (/[A-Za-z_$]/.test(c)) {
+            let k = j;
+            while (k < text.length && /[\w$]/.test(text[k]))
+                k++;
+            onWord(text.slice(j, k), k);
+            j = k;
+            continue;
+        }
+        if (c === "{")
+            depth++;
+        else if (c === "}") {
+            depth--;
+            if (depth === 0)
+                return j + 1;
+        }
+        j++;
+    }
+    return text.length;
+};
+const skipRegex = (text, i) => {
+    let j = i + 1;
+    let inClass = false;
+    while (j < text.length) {
+        const c = text[j];
+        if (c === "\\") {
+            j += 2;
+            continue;
+        }
+        if (c === "[")
+            inClass = true;
+        else if (c === "]")
+            inClass = false;
+        else if (c === "/" && !inClass)
+            return j + 1;
+        else if (c === "\n")
+            return j; // 未闭合 ⇒ 当除法处理，别吞掉整段代码
+        j++;
+    }
+    return text.length;
+};
+function shoutSites(text) {
+    const literals = [];
+    const skipped = { interp: 0, dynamic: 0 };
+    const push = (raw, at) => {
+        const line = lineAt(text, at);
+        for (const tok of raw.split(/\s+/)) {
+            if (IDENT.test(tok))
+                literals.push({ name: tok, line });
+        }
+    };
+    /** `word` 之后紧跟的实参是不是字面量（`(` 可选 + 引号） */
+    const literalArg = (after, allowSelector) => {
+        const m = /^\s*\(\s*(["'`])([\s\S]*?)\1\s*\)/.exec(text.slice(after));
+        if (!m)
+            return null;
+        if (m[1] === "`" && m[2].includes("${"))
+            return { interp: true };
+        return { raw: allowSelector ? [...m[2].matchAll(/\.(-?[_a-zA-Z][\w-]*)/g)].map((x) => x[1]).join(" ") : m[2] };
+    };
+    scanCode(text, 0, (word, end) => {
+        if (word === "className" || word === "class") {
+            let i = end;
+            while (i < text.length && /\s/.test(text[i]))
+                i++;
+            // 必须是赋值位（`className: "x"` / `className = "x"`）——读法 / 比较 / 箭头都不是站点
+            if (text[i] !== ":" && text[i] !== "=")
+                return;
+            if (text[i] === "=" && (text[i + 1] === "=" || text[i + 1] === ">"))
+                return;
+            i++;
+            while (i < text.length && /\s/.test(text[i]))
+                i++;
+            let braced = false;
+            if (text[i] === "{") {
+                braced = true;
+                i++;
+                while (i < text.length && /\s/.test(text[i]))
+                    i++;
+            }
+            const ch = text[i];
+            if (ch === '"' || ch === "'" || ch === "`") {
+                let j = i + 1;
+                let raw = "";
+                let closed = false;
+                while (j < text.length) {
+                    if (text[j] === "\\") {
+                        raw += text[j + 1] ?? "";
+                        j += 2;
+                        continue;
+                    }
+                    if (text[j] === ch) {
+                        closed = true;
+                        break;
+                    }
+                    raw += text[j];
+                    j++;
+                }
+                if (!closed) {
+                    skipped.dynamic++;
+                    return;
+                }
+                if (ch === "`" && raw.includes("${")) {
+                    skipped.interp++;
+                    return;
+                } // 插值模板 ⇒ 射程外
+                if (braced) {
+                    let k = j + 1;
+                    while (k < text.length && /\s/.test(text[k]))
+                        k++;
+                    if (text[k] !== "}") {
+                        skipped.dynamic++;
+                        return;
+                    }
+                }
+                push(raw, i);
+                return;
+            }
+            skipped.dynamic++; // 变量 / 函数调用 / 三元 …… 静态读不出
+            return;
+        }
+        if (word === "classList") {
+            const m = /^\s*\.\s*(add|remove|toggle|contains)\s*\(\s*(["'])([\s\S]*?)\2/.exec(text.slice(end));
+            if (m)
+                push(m[3], end + m.index + m[0].length);
+            return;
+        }
+        if (word === "querySelector" || word === "querySelectorAll" || word === "closest" || word === "matches") {
+            const r = literalArg(end, true);
+            if (r?.interp)
+                skipped.interp++;
+            else if (r?.raw != null)
+                push(r.raw, end);
+        }
+    });
+    return { literals, skipped };
+}
+/* jscpd:ignore-end */
+/** 本腿扫描的 JS 族扩展名（作者源码域——格 1 尺子在产物域只见到 bundle 后的 .js/.html） */
+const JS_EXTS = [".ts", ".tsx", ".js", ".jsx", ".mjs", ".cjs", ".html"];
+/** 一个选择器里的类名（剥属性选择器后再抓 `.x`） */
+const classTokensIn = (sel) => [...String(sel).replace(/\[[^\]]*\]/g, " ").matchAll(/\.(-?[_a-zA-Z][\w-]*)/g)].map((m) => m[1]);
+/** 一处悬空引用的报点文案（作者面：名字 ＋ 出处 ＋ 两步修法） */
+function messageOf(site, hostClassCount) {
+    const channel = site.via === "js-classname" ? "JS className" : "CSS `animation:`";
+    return (`\`${site.name}\`（${channel} 引用，本仓 ${site.file}:${site.line}）在本仓 CSS 与宿主定义集` +
+        `（${hostClassCount} 个类名）里都找不到 ⇒ ${site.via === "js-classname" ? DANGLING_NAME_WHY.jsClassname : DANGLING_NAME_WHY.cssAnimation} ` +
+        `修法两步：① 换成宿主真实存在的名字，或在本仓补定义（自有类名须以 \`<pluginId>-\` 开头；` +
+        `\`ldk-*\` 只许宿主定义）；② 重新打包发版。知情绕行 = // eslint-disable-next-line ${CHECK_IDS.cssNamespace} -- 理由。`);
+}
+/**
+ * 跑本仓悬空名判据（作者侧唯一入口）。返回结构化报告——**同一份实现，没有第二条判据路径**。
+ * ⚠️ `host` / `resolution` 可注入（单测用）；缺省读随包 `schemas/host-css-names.json`。
+ */
+export function runDanglingNameCheck(root, opts = {}) {
+    const absRoot = resolve(root);
+    const host = opts.host !== undefined ? opts.host : loadHostCssNames();
+    const resolution = opts.resolution ?? resolvePluginIdForCss(absRoot);
+    const report = {
+        root: absRoot,
+        pluginId: resolution.pluginId,
+        error: resolution.error,
+        hostClassCount: host?.classes.length ?? 0,
+        hostKeyframeCount: host?.keyframes.length ?? 0,
+        ldkRefs: 0,
+        kfRefs: 0,
+        skipped: { interp: 0, dynamic: 0 },
+        notJudgedCount: 0,
+        borrowedLdk: [],
+        dangling: [],
+        violations: [],
+    };
+    // 🔴 保底（fail-closed，不可豁免）：宿主定义集读不到 ⇒ 「未核验」报红——⛔ 不许静默当 0 处通过
+    if (!host) {
+        report.error = report.error ?? "宿主定义集读不到";
+        report.violations.push({
+            file: "plugin.json",
+            line: 1,
+            message: "宿主 CSS 定义集（@linkdesk/plugin-sdk 的 schemas/host-css-names.json）**读不到** ⇒ 本腿**未核验**。" +
+                "「0 处通过」在这里是假绿（假绿比假红更坏：你会以为已经查过了）。修复：重装 @linkdesk/plugin-sdk（包不完整）。",
+        });
+        return report;
+    }
+    if (resolution.error || !resolution.pluginId) {
+        // 身份读不到时前缀腿已 fail-closed 报同一件事 ⇒ 本腿不重复报，但照常跑判定（判定不依赖身份）
+        report.error = resolution.error;
+    }
+    const hostClasses = new Set(host.classes);
+    const hostKeyframes = new Set(host.keyframes);
+    // ① 自身定义集先**全量收齐**（CSS 半边——collectCssUnits 与前几条判据同一批站点、同一豁免索引）
+    const cssUnits = collectCssUnits(absRoot, [CHECK_IDS.cssNamespace]);
+    const selfDefs = new Set();
+    const selfKeyframes = new Set();
+    const cssMentions = new Set();
+    for (const unit of cssUnits) {
+        for (const d of bareClassDefinitions(unit.cleaned))
+            selfDefs.add(d.name);
+        for (const k of keyframeDefinitions(unit.cleaned))
+            selfKeyframes.add(k.name);
+        for (const m of unit.cleaned.matchAll(/([^{}]+)\{([^{}]*)\}/g)) {
+            const sel = m[1].trim();
+            if (sel.startsWith("@") || !m[2].trim())
+                continue;
+            for (const one of splitSelector(sel.replace(/\[[^\]]*\]/g, " "))) {
+                for (const n of classTokensIn(one))
+                    cssMentions.add(n);
+            }
+        }
+    }
+    const jsSites = [];
+    const notJudged = new Set();
+    for (const file of collectFiles(absRoot, JS_EXTS)) {
+        const rel = relPath(absRoot, file);
+        if (isTestOrMockRel(rel))
+            continue;
+        const src = readSource(file);
+        const { literals, skipped } = shoutSites(src);
+        report.skipped.interp += skipped.interp;
+        report.skipped.dynamic += skipped.dynamic;
+        if (literals.length === 0)
+            continue;
+        const disabled = buildDisableIndex(src, [CHECK_IDS.cssNamespace]);
+        for (const l of literals)
+            jsSites.push({ site: l, rel, disabled });
+    }
+    // ③ 判定：须判定的引用，在「自身定义集 ∪ 宿主定义集」里都没有 ⇒ 悬空
+    const dangling = new Map();
+    const satisfiedBySelfOnly = new Set();
+    for (const { site, rel, disabled } of jsSites) {
+        if (!HOST_NAMESPACE.test(site.name)) {
+            // 非 ldk- 的未定义名不计悬空（自有命名空间 / DOM 钩子 / 第三方内联）——误报控，只计数
+            if (!selfDefs.has(site.name) && !cssMentions.has(site.name) && !hostClasses.has(site.name)) {
+                notJudged.add(site.name);
+            }
+            continue;
+        }
+        report.ldkRefs++;
+        if (hostClasses.has(site.name))
+            continue;
+        if (selfDefs.has(site.name)) {
+            satisfiedBySelfOnly.add(site.name);
+            continue;
+        }
+        if (isDisabled(disabled, site.line, CHECK_IDS.cssNamespace))
+            continue;
+        const entry = { name: site.name, via: "js-classname", file: rel, line: site.line };
+        if (!dangling.has(site.name))
+            dangling.set(site.name, entry);
+    }
+    for (const unit of cssUnits) {
+        for (const ref of animationRefs(unit.cleaned)) {
+            report.kfRefs++;
+            if (selfKeyframes.has(ref.name) || hostKeyframes.has(ref.name))
+                continue;
+            if (isDisabled(unit.disabled, ref.line, CHECK_IDS.cssNamespace))
+                continue;
+            const entry = { name: ref.name, via: "css-animation", file: unit.rel, line: ref.line };
+            if (!dangling.has(ref.name))
+                dangling.set(ref.name, entry);
+        }
+    }
+    report.notJudgedCount = notJudged.size;
+    report.borrowedLdk = [...satisfiedBySelfOnly].sort();
+    report.dangling = [...dangling.values()].sort((x, y) => x.name.localeCompare(y.name) || x.file.localeCompare(y.file) || x.line - y.line);
+    for (const site of report.dangling) {
+        report.violations.push({ file: site.file, line: site.line, message: messageOf(site, report.hostClassCount) });
+    }
+    return report;
+}
+function readSource(abs) {
+    return readFileSync(abs, "utf8");
+}
+//# sourceMappingURL=dangling-names.js.map

package/dist/eslint/checks/dangling-names.js.map

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

package/dist/eslint/checks/retired-names.d.ts

@@ -0,0 +1,46 @@
+/** 退役登记条目（`host-reserved.json` `retired[]` 的形状——7 字段，唯一真相源 = `scripts/lib/retired-ledger.mjs`） */
+export interface RetiredEntry {
+    name: string;
+    kind: string;
+    since: string;
+    why: string;
+    replacedBy: string;
+    landing: string;
+    approvedBy: string;
+}
+export interface RetiredLedger {
+    file: string;
+    /** false ⇒ 账没读到（判据空转——报告里必须能看出来，⛔ 不许静默） */
+    found: boolean;
+    retired: RetiredEntry[];
+}
+/** 读退役登记栏（只取 `retired[]`；账缺失/坏 ⇒ found=false，⛔ 不许静默丢） */
+export declare function loadRetiredLedger(file?: string): RetiredLedger;
+/** 一处退役名引用的提示（名字 ＋ 哪天退的休 ＋ 替身 ＋ 出处） */
+export interface RetiredNameHint {
+    /** 退役名 */
+    name: string;
+    /** 退役生效日（账里的 `since`，写日期不写版本号） */
+    since: string;
+    /** 替身（账里的 `replacedBy`） */
+    replacedBy: string;
+    /** 工程相对路径（正斜杠） */
+    file: string;
+    /** 1-based */
+    line: number;
+}
+export interface RetiredNameReport {
+    root: string;
+    /** 账的加载实况（found=false ⇒ 本腿空转，报告里必须能看出来） */
+    ledger: RetiredLedger;
+    /** 扫过的源码文件数（审计读数用） */
+    filesScanned: number;
+    /** 提示站点（⛔ 不进 violations——本腿永远只是提示） */
+    hints: RetiredNameHint[];
+}
+/**
+ * 跑本仓退役名提示（作者侧入口）。🔴 `hints` 永不进 violations——升级成拒绝 = 越界（见文件头）。
+ * ⚠️ `ledger` 可注入（单测用）；缺省读随包 `schemas/host-reserved.json` 的 `retired[]`。
+ */
+export declare function runRetiredNameHint(root: string, ledger?: RetiredLedger): RetiredNameReport;
+//# sourceMappingURL=retired-names.d.ts.map

package/dist/eslint/checks/retired-names.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retired-names.d.ts","sourceRoot":"","sources":["../../../src/eslint/checks/retired-names.ts"],"names":[],"mappings":"AAyBA,kGAAkG;AAClG,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,2CAA2C;IAC3C,KAAK,EAAE,OAAO,CAAC;IACf,OAAO,EAAE,YAAY,EAAE,CAAC;CACzB;AAUD,yDAAyD;AACzD,wBAAgB,iBAAiB,CAAC,IAAI,GAAE,MAA2B,GAAG,aAAa,CAQlF;AAED,uCAAuC;AACvC,MAAM,WAAW,eAAe;IAC9B,UAAU;IACV,IAAI,EAAE,MAAM,CAAC;IACb,kCAAkC;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,2BAA2B;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,kBAAkB;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,cAAc;IACd,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,2CAA2C;IAC3C,MAAM,EAAE,aAAa,CAAC;IACtB,sBAAsB;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,sCAAsC;IACtC,KAAK,EAAE,eAAe,EAAE,CAAC;CAC1B;AAaD;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,GAAE,aAAmC,GAAG,iBAAiB,CAoC/G"}