js-code-detector 0.0.2 → 0.0.4

package/README.md

@@ -14,9 +14,30 @@ $ npm run dev
 $ npm run build
 ```
 
-## Options
+## 说明
+
+包用于检测项目当前分支 与 master分支的差异，并出具报告，展示代码改动的影响
+目前适用于 umi4.x 版本的项目
+
+## 使用
+
+1.项目安装 **js-code-detector**
+2.package.json 中添加 scripts 命令 ```detect```
+3.执行该命令可在当前项目目录下生成报告
+
+## 报告说明
+- filePath 文件路径
+- type 改动类型 add remove modify
+- filesDependsOnMe 依赖当前文件的文件
+- dangerIdentifiers 危险标识符（包括 1、找不到定义的， 2、函数的参数是一个函数，并进行调用的）
+- blockReports 区块报告（每个diff块产生一个报告）
+  - kind 区块类型，目前把重点的类型单独提取处理，包括 "Import"|"Declaration"|"Assignment"|"SelfUpdate"|"Invoke"
+  - diff 区块的原始改动内容
+  - added 增加的标识符
+  - addedEffects 增加的标识符的影响
+    - causeBy 增加的标识符的来源
+    - effects 影响到的标识符的位置
 
-TODO
 
 ## LICENSE
 

package/bin/detect.js

@@ -1,7 +1,8 @@
 #!/usr/bin/env node
 
+const { writeGitDiffTxt, getGitRepositoryAndBranch, generateReport } = require('../dist/cjs/index')
 async function main() {
-  const { gitUrl, branchName } = await require('../dist/cjs/index').getGitRepositoryAndBranch();
-  require('../dist/cjs/index').writeGitDiffTxt(gitUrl, branchName);
+  const { gitUrl, branchName } = await getGitRepositoryAndBranch();
+  writeGitDiffTxt(gitUrl, branchName).then(reportContent => generateReport(reportContent));
 }
 main();

package/dist/cjs/index.d.ts

@@ -4,3 +4,4 @@ export declare function getGitRepositoryAndBranch(): Promise<{
     gitUrl: string;
     branchName: string;
 }>;
+export declare function generateReport(jsonStr: string): void;

package/dist/cjs/index.js

@@ -29,6 +29,7 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/index.ts
 var src_exports = {};
 __export(src_exports, {
+  generateReport: () => generateReport,
   getGitRepositoryAndBranch: () => getGitRepositoryAndBranch,
   umiPluginCallback: () => umiPluginCallback,
   writeGitDiffTxt: () => writeGitDiffTxt
@@ -42,7 +43,8 @@ var import_fs2 = require("fs");
 var import_report_util = require("./util/report_util");
 var import_utils = require("@umijs/utils");
 var import_dayjs = __toESM(require("dayjs"));
-var jsonName = "git_diff_report.json";
+var import_createMdByJson = require("./util/report_util/createMdByJson");
+var jsonName = "git_diff_report.md";
 async function umiPluginCallback(api) {
   const diff_txt = (0, import_fs.readFileSync)((0, import_path.join)(api.cwd, "git_diff.txt"), "utf-8");
   const gitDiffDetail = (0, import_format_git_diff_content.formatGitDiffContent)(diff_txt);
@@ -56,7 +58,8 @@ async function umiPluginCallback(api) {
   const usingFileNoPrefix = usingFiles.map((item) => item.filePath.replace(absPathPrefix, ""));
   const groupGitDiffLines = gitDiffDetail.filter((item) => usingFileNoPrefix.includes(item.filePath));
   const reports = (0, import_report_util.createDetectReport)({ groupGitDiffLines, tree, absPathPrefix });
-  (0, import_fs2.writeFileSync)((0, import_path.join)(api.cwd, jsonName), JSON.stringify(reports, null, 2), { encoding: "utf-8", flag: "w" });
+  const mdContent = (0, import_createMdByJson.createMdByJson)(reports);
+  (0, import_fs2.writeFileSync)((0, import_path.join)(api.cwd, jsonName), mdContent, { encoding: "utf-8", flag: "w" });
 }
 var shellFileContent = `#!/bin/sh
 time=$(date "+%Y%-m%d")
@@ -102,8 +105,12 @@ async function getGitRepositoryAndBranch() {
     branchName: branch.stdout
   };
 }
+function generateReport(jsonStr) {
+  (0, import_fs2.writeFileSync)((0, import_path.join)(process.cwd(), `${(0, import_dayjs.default)().format("YYYYMDD_HHmm")}_${jsonName}`), jsonStr, { encoding: "utf-8", flag: "w" });
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  generateReport,
   getGitRepositoryAndBranch,
   umiPluginCallback,
   writeGitDiffTxt

package/dist/cjs/util/ast_util/AstUtil.d.ts

@@ -49,7 +49,7 @@ export default class AstUtil {
     static isVarInit(node: AstNode): boolean;
     static isReturnArgument(node: AstNode): boolean;
     static collectDependenceIds(node: AstNode): void;
-    static markDependenceIdAsCrossScope(node: AstNode, scopeId: AstNode): void;
+    static markDependenceIdCrossScope(node: AstNode, scopeId: AstNode): void;
     static isUseStateVarDec(node: AstNode): node is (AstNode & {
         type: "VariableDeclarator";
         id: {
@@ -92,7 +92,12 @@ export default class AstUtil {
     static isValidArrayNodeCollect(astNode: any): astNode is AstNode[];
     static isValidNodeCollect(astNode: AstNode): astNode is AstNode;
     static windowProperties: string[];
+    static intrinsicElements: string[];
+    static standardAttributes: string[];
+    static isUntrackedId(id: AstNode): boolean;
     static isPropertyOfGlobal(node: AstNode): boolean;
+    static isIntrinsicElement(node: AstNode): boolean | "" | undefined;
+    static isStandardAttribute(node: AstNode): boolean;
     static getTopScopeNodesByLineNumberRange(mapFileLineToNodeSet: Map<number, Set<AstNode>>, lineNumberStart: number, lineNumberEnd: number): AstNode[];
     static getTopScopeNodesByLineNumber(mapFileLineToNodeSet: Map<number, Set<AstNode>>, lineNumber: number): AstNode[];
     static isSubNodeOfVariableDeclarator(node: AstNode): boolean;

package/dist/cjs/util/ast_util/AstUtil.js

@@ -23,6 +23,7 @@ __export(AstUtil_exports, {
 });
 module.exports = __toCommonJS(AstUtil_exports);
 var import_windowProperties = require("./windowProperties");
+var import_intrinsicElements = require("./intrinsicElements");
 var AstUtil = class {
   static getNodePath(node) {
     return [...node._util.ancestors, node].map((n) => n.type).join(":") + ":" + node.name;
@@ -185,12 +186,12 @@ var AstUtil = class {
         const firstPick = sameNameIds[0];
         if (firstPick) {
           firstPick._util.effectIds.add(dependenceId);
-          this.markDependenceIdAsCrossScope(dependenceId, firstPick);
+          this.markDependenceIdCrossScope(dependenceId, firstPick);
         }
       }
     }
   }
-  static markDependenceIdAsCrossScope(node, scopeId) {
+  static markDependenceIdCrossScope(node, scopeId) {
     var _a, _b, _c;
     const isParamsElement = scopeId._util.parentProperty === "params";
     const isCalleeId = ((_a = node._util.parent) == null ? void 0 : _a.type) === "CallExpression" && node._util.parentProperty === "callee";
@@ -425,6 +426,18 @@ var AstUtil = class {
       expression.name && callback(expression);
     } else if (exp.type === "JSXIdentifier") {
       callback(exp);
+    } else if (exp.type === "JSXAttribute") {
+      const value = exp.value;
+      value && this._deepFindIdOfExpression(value, callback);
+    } else if (exp.type === "JSXElement") {
+      const openingElement = exp.openingElement;
+      this._deepFindIdOfExpression(openingElement, callback);
+    } else if (exp.type === "JSXOpeningElement") {
+      const { name, attributes } = exp;
+      this._deepFindIdOfExpression(name, callback);
+      for (const attribute of attributes) {
+        this._deepFindIdOfExpression(attribute, callback);
+      }
     }
   }
   static getRootIdentifierOfMemberExpression(memExp) {
@@ -522,9 +535,19 @@ var AstUtil = class {
   static isValidNodeCollect(astNode) {
     return typeof (astNode == null ? void 0 : astNode.type) === "string";
   }
+  static isUntrackedId(id) {
+    return id._util.variableScope.length === 0 && !this.isPropertyOfGlobal(id) && !this.isIntrinsicElement(id) && !this.isStandardAttribute(id);
+  }
   static isPropertyOfGlobal(node) {
     return node.type === "Identifier" && !node._util.variableScope.length && this.windowProperties.includes(node.name);
   }
+  static isIntrinsicElement(node) {
+    var _a;
+    return node.type === "JSXIdentifier" && ((_a = node._util.parent) == null ? void 0 : _a.type) && ["JSXOpeningElement", "JSXClosingElement"].includes(node._util.parent.type) && this.intrinsicElements.includes(node.name);
+  }
+  static isStandardAttribute(node) {
+    return node._util.parent.type === "JSXAttribute" && this.standardAttributes.includes(node.name);
+  }
   static getTopScopeNodesByLineNumberRange(mapFileLineToNodeSet, lineNumberStart, lineNumberEnd) {
     const nodeSet = /* @__PURE__ */ new Set();
     for (let i = lineNumberStart; i <= lineNumberEnd; i++) {
@@ -569,3 +592,5 @@ AstUtil.invalidNodeKey = [
   "tokens"
 ];
 AstUtil.windowProperties = import_windowProperties.windowProperties;
+AstUtil.intrinsicElements = import_intrinsicElements.intrinsicElements;
+AstUtil.standardAttributes = import_intrinsicElements.standardAttributes;

package/dist/cjs/util/ast_util/intrinsicElements.d.ts

@@ -0,0 +1,2 @@
+export declare const intrinsicElements: string[];
+export declare const standardAttributes: string[];

package/dist/cjs/util/ast_util/intrinsicElements.js

@@ -0,0 +1,495 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/util/ast_util/intrinsicElements.ts
+var intrinsicElements_exports = {};
+__export(intrinsicElements_exports, {
+  intrinsicElements: () => intrinsicElements,
+  standardAttributes: () => standardAttributes
+});
+module.exports = __toCommonJS(intrinsicElements_exports);
+var intrinsicElements = [
+  "a",
+  "abbr",
+  "address",
+  "area",
+  "article",
+  "aside",
+  "audio",
+  "b",
+  "base",
+  "bdi",
+  "bdo",
+  "big",
+  "blockquote",
+  "body",
+  "br",
+  "button",
+  "canvas",
+  "caption",
+  "cite",
+  "code",
+  "col",
+  "colgroup",
+  "data",
+  "datalist",
+  "dd",
+  "del",
+  "details",
+  "dfn",
+  "dialog",
+  "div",
+  "dl",
+  "dt",
+  "em",
+  "embed",
+  "fieldset",
+  "figcaption",
+  "figure",
+  "footer",
+  "form",
+  "h1",
+  "h2",
+  "h3",
+  "h4",
+  "h5",
+  "h6",
+  "head",
+  "header",
+  "hgroup",
+  "hr",
+  "html",
+  "i",
+  "iframe",
+  "img",
+  "input",
+  "ins",
+  "kbd",
+  "keygen",
+  "label",
+  "legend",
+  "li",
+  "link",
+  "main",
+  "map",
+  "mark",
+  "menu",
+  "menuitem",
+  "meta",
+  "meter",
+  "nav",
+  "noindex",
+  "noscript",
+  "object",
+  "ol",
+  "optgroup",
+  "option",
+  "output",
+  "p",
+  "param",
+  "picture",
+  "pre",
+  "progress",
+  "q",
+  "rp",
+  "rt",
+  "ruby",
+  "s",
+  "samp",
+  "slot",
+  "script",
+  "section",
+  "select",
+  "small",
+  "source",
+  "span",
+  "strong",
+  "style",
+  "sub",
+  "summary",
+  "sup",
+  "table",
+  "template",
+  "tbody",
+  "td",
+  "textarea",
+  "tfoot",
+  "th",
+  "thead",
+  "time",
+  "title",
+  "tr",
+  "track",
+  "u",
+  "ul",
+  "video",
+  "wbr",
+  "webview",
+  "svg",
+  "animate",
+  "animateMotion",
+  "animateTransform",
+  "circle",
+  "clipPath",
+  "defs",
+  "desc",
+  "ellipse",
+  "feBlend",
+  "feColorMatrix",
+  "feComponentTransfer",
+  "feComposite",
+  "feConvolveMatrix",
+  "feDiffuseLighting",
+  "feDisplacementMap",
+  "feDistantLight",
+  "feDropShadow",
+  "feFlood",
+  "feFuncA",
+  "feFuncB",
+  "feFuncG",
+  "feFuncR",
+  "feGaussianBlur",
+  "feImage",
+  "feMerge",
+  "feMergeNode",
+  "feMorphology",
+  "feOffset",
+  "fePointLight",
+  "feSpecularLighting",
+  "feSpotLight",
+  "feTile",
+  "feTurbulence",
+  "filter",
+  "foreignObject",
+  "g",
+  "image",
+  "line",
+  "linearGradient",
+  "marker",
+  "mask",
+  "metadata",
+  "mpath",
+  "path",
+  "pattern",
+  "polygon",
+  "polyline",
+  "radialGradient",
+  "rect",
+  "stop",
+  "switch",
+  "symbol",
+  "text",
+  "textPath",
+  "tspan",
+  "use",
+  "view"
+];
+var standardAttributes = [
+  "key",
+  "defaultChecked",
+  "defaultValue",
+  "accessKey",
+  "className",
+  "contentEditable",
+  "contextMenu",
+  "dir",
+  "draggable",
+  "hidden",
+  "id",
+  "lang",
+  "placeholder",
+  "slot",
+  "spellCheck",
+  "style",
+  "tabIndex",
+  "title",
+  "translate",
+  "children",
+  "dangerouslySetInnerHTML",
+  "onCopy",
+  "onCopyCapture",
+  "onCut",
+  "onCutCapture",
+  "onPaste",
+  "onPasteCapture",
+  "onCompositionEnd",
+  "onCompositionEndCapture",
+  "onCompositionStart",
+  "onCompositionStartCapture",
+  "onCompositionUpdate",
+  "onCompositionUpdateCapture",
+  "onFocus",
+  "onFocusCapture",
+  "onBlur",
+  "onBlurCapture",
+  "onChange",
+  "onChangeCapture",
+  "onBeforeInput",
+  "onBeforeInputCapture",
+  "onInput",
+  "onInputCapture",
+  "onReset",
+  "onResetCapture",
+  "onSubmit",
+  "onSubmitCapture",
+  "onInvalid",
+  "onInvalidCapture",
+  "onLoad",
+  "onLoadCapture",
+  "onError",
+  "onErrorCapture",
+  "onKeyDown",
+  "onKeyDownCapture",
+  "onKeyPress",
+  "onKeyPressCapture",
+  "onKeyUp",
+  "onKeyUpCapture",
+  "onAbort",
+  "onAbortCapture",
+  "onCanPlay",
+  "onCanPlayCapture",
+  "onCanPlayThrough",
+  "onCanPlayThroughCapture",
+  "onDurationChange",
+  "onDurationChangeCapture",
+  "onEmptied",
+  "onEmptiedCapture",
+  "onEncrypted",
+  "onEncryptedCapture",
+  "onEnded",
+  "onEndedCapture",
+  "onLoadedData",
+  "onLoadedDataCapture",
+  "onLoadedMetadata",
+  "onLoadedMetadataCapture",
+  "onLoadStart",
+  "onLoadStartCapture",
+  "onPause",
+  "onPauseCapture",
+  "onPlay",
+  "onPlayCapture",
+  "onPlaying",
+  "onPlayingCapture",
+  "onProgress",
+  "onProgressCapture",
+  "onRateChange",
+  "onRateChangeCapture",
+  "onSeeked",
+  "onSeekedCapture",
+  "onSeeking",
+  "onSeekingCapture",
+  "onStalled",
+  "onStalledCapture",
+  "onSuspend",
+  "onSuspendCapture",
+  "onTimeUpdate",
+  "onTimeUpdateCapture",
+  "onVolumeChange",
+  "onVolumeChangeCapture",
+  "onWaiting",
+  "onWaitingCapture",
+  "onAuxClick",
+  "onAuxClickCapture",
+  "onClick",
+  "onClickCapture",
+  "onContextMenu",
+  "onContextMenuCapture",
+  "onDoubleClick",
+  "onDoubleClickCapture",
+  "onDrag",
+  "onDragCapture",
+  "onDragEnd",
+  "onDragEndCapture",
+  "onDragEnter",
+  "onDragEnterCapture",
+  "onDragExit",
+  "onDragExitCapture",
+  "onDragLeave",
+  "onDragLeaveCapture",
+  "onDragOver",
+  "onDragOverCapture",
+  "onDragStart",
+  "onDragStartCapture",
+  "onDrop",
+  "onDropCapture",
+  "onMouseDown",
+  "onMouseDownCapture",
+  "onMouseEnter",
+  "onMouseLeave",
+  "onMouseMove",
+  "onMouseMoveCapture",
+  "onMouseOut",
+  "onMouseOutCapture",
+  "onMouseOver",
+  "onMouseOverCapture",
+  "onMouseUp",
+  "onMouseUpCapture",
+  "onSelect",
+  "onSelectCapture",
+  "onTouchCancel",
+  "onTouchCancelCapture",
+  "onTouchEnd",
+  "onTouchEndCapture",
+  "onTouchMove",
+  "onTouchMoveCapture",
+  "onTouchStart",
+  "onTouchStartCapture",
+  "onPointerDown",
+  "onPointerDownCapture",
+  "onPointerMove",
+  "onPointerMoveCapture",
+  "onPointerUp",
+  "onPointerUpCapture",
+  "onPointerCancel",
+  "onPointerCancelCapture",
+  "onPointerEnter",
+  "onPointerEnterCapture",
+  "onPointerLeave",
+  "onPointerLeaveCapture",
+  "onPointerOver",
+  "onPointerOverCapture",
+  "onPointerOut",
+  "onPointerOutCapture",
+  "onGotPointerCapture",
+  "onGotPointerCaptureCapture",
+  "onLostPointerCapture",
+  "onLostPointerCaptureCapture",
+  "onScroll",
+  "onScrollCapture",
+  "onWheel",
+  "onWheelCapture",
+  "onAnimationStart",
+  "onAnimationStartCapture",
+  "onAnimationEnd",
+  "onAnimationEndCapture",
+  "onAnimationIteration",
+  "onAnimationIterationCapture",
+  "onTransitionEnd",
+  "onTransitionEndCapture",
+  "accept",
+  "acceptCharset",
+  "action",
+  "allowFullScreen",
+  "allowTransparency",
+  "alt",
+  "as",
+  "async",
+  "autoComplete",
+  "autoFocus",
+  "autoPlay",
+  "capture",
+  "cellPadding",
+  "cellSpacing",
+  "charSet",
+  "challenge",
+  "checked",
+  "cite",
+  "classID",
+  "cols",
+  "colSpan",
+  "content",
+  "controls",
+  "coords",
+  "crossOrigin",
+  "data",
+  "dateTime",
+  "default",
+  "defer",
+  "disabled",
+  "download",
+  "encType",
+  "form",
+  "formAction",
+  "formEncType",
+  "formMethod",
+  "formNoValidate",
+  "formTarget",
+  "frameBorder",
+  "headers",
+  "height",
+  "high",
+  "href",
+  "hrefLang",
+  "htmlFor",
+  "httpEquiv",
+  "integrity",
+  "keyParams",
+  "keyType",
+  "kind",
+  "label",
+  "list",
+  "loop",
+  "low",
+  "manifest",
+  "marginHeight",
+  "marginWidth",
+  "max",
+  "maxLength",
+  "media",
+  "mediaGroup",
+  "method",
+  "min",
+  "minLength",
+  "multiple",
+  "muted",
+  "name",
+  "nonce",
+  "noValidate",
+  "open",
+  "optimum",
+  "pattern",
+  "placeholder",
+  "playsInline",
+  "poster",
+  "preload",
+  "readOnly",
+  "rel",
+  "required",
+  "reversed",
+  "rows",
+  "rowSpan",
+  "sandbox",
+  "scope",
+  "scoped",
+  "scrolling",
+  "seamless",
+  "selected",
+  "shape",
+  "size",
+  "sizes",
+  "span",
+  "src",
+  "srcDoc",
+  "srcLang",
+  "srcSet",
+  "start",
+  "step",
+  "summary",
+  "target",
+  "type",
+  "useMap",
+  "value",
+  "width",
+  "wmode",
+  "wrap"
+];
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  intrinsicElements,
+  standardAttributes
+});

package/dist/cjs/util/report_util/code_block_detect.js

@@ -113,6 +113,12 @@ function pushBlockReport(blockReports, blockReport, programNode) {
       blockReport[key] = blockReport[key].filter((path) => !sameNames.includes(path));
     });
   }
+  if (blockReport.kind.startsWith("Other:")) {
+    ["added", "removed"].forEach((key) => {
+      const tailElements = blockReport[key].map((ele) => ele.split(":").at(-1)).filter(Boolean);
+      blockReport[key] = [...new Set(tailElements)];
+    });
+  }
   const addedEffectsList = mapNodePath(blockReport.addedEffects);
   const removedEffectsList = mapNodePath(blockReport.removedEffects);
   const addedEffectsPaths = addedEffectsList.map((item) => item.effects.map(({ path }) => path)).flat();

package/dist/cjs/util/report_util/createMdByJson.d.ts

@@ -0,0 +1,2 @@
+import { createDetectReport } from "../report_util";
+export declare function createMdByJson(report: ReturnType<typeof createDetectReport>): string;

package/dist/cjs/util/report_util/createMdByJson.js

@@ -0,0 +1,74 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/util/report_util/createMdByJson.ts
+var createMdByJson_exports = {};
+__export(createMdByJson_exports, {
+  createMdByJson: () => createMdByJson
+});
+module.exports = __toCommonJS(createMdByJson_exports);
+var mapReportType = {
+  modify: "修改",
+  add: "新增",
+  delete: "删除"
+};
+function createMdByJson(report) {
+  return report.map(reportItemToMd).join("\n\n\n");
+}
+function reportItemToMd(report) {
+  const { filePath, filesDependsOnMe, type, dangerIdentifiers, blockReports } = report;
+  return [
+    `## ${filePath}`,
+    `- 类型: ${mapReportType[type]}`,
+    filesDependsOnMe.length > 0 ? `- 依赖${filePath}的文件` : "",
+    ...filesDependsOnMe.map((file, i) => `${i + 1}. ${file}`),
+    dangerIdentifiers.length > 0 ? `- 重点检查使用的变量` : "",
+    dangerIdentifiers.length > 0 ? `> ${dangerIdentifiers.join(", ")}` : "",
+    blockReports.length > 0 ? `### 代码块分析` : "",
+    ...blockReports.map(blockReportToMd)
+  ].filter(Boolean).join("\n\n");
+}
+function blockReportToMd(block) {
+  const {
+    kind,
+    diff_txt,
+    added,
+    addedEffects,
+    removed,
+    removedEffects
+  } = block;
+  return [
+    `#### 修改分类: ${kind}`,
+    `- 原始diff内容`,
+    `\`\`\`txt
+${diff_txt.join("\n")}
+\`\`\``,
+    added.length > 0 ? `- 新增标识符` : "",
+    added.length > 0 ? `> ${added.join(", ")}` : "",
+    addedEffects.length > 0 ? `- 新增标识符影响` : "",
+    addedEffects.map(({ causeBy, effects }) => `> ${causeBy}相关: ${effects.join()}`).join("\n\n"),
+    removed.length > 0 ? `- 删除标识符` : "",
+    removed.length > 0 ? `> ${removed.join(", ")}` : "",
+    removedEffects.length > 0 ? `- 删除标识符影响` : "",
+    removedEffects.map(({ causeBy, effects }) => `> ${causeBy}相关: ${effects.join()}`).join("\n\n")
+  ].filter(Boolean).join("\n\n");
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  createMdByJson
+});

package/dist/cjs/util/report_util/file_identifier_detect.d.ts

@@ -0,0 +1 @@
+export declare function fileIdentifierDetect(filePath: string, absPathPrefix: string): string[];

package/dist/cjs/util/report_util/file_identifier_detect.js

@@ -0,0 +1,59 @@
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/util/report_util/file_identifier_detect.ts
+var file_identifier_detect_exports = {};
+__export(file_identifier_detect_exports, {
+  fileIdentifierDetect: () => fileIdentifierDetect
+});
+module.exports = __toCommonJS(file_identifier_detect_exports);
+var import_getAstKitByFilePath = __toESM(require("../ast_util/getAstKitByFilePath"));
+var import_AstUtil = __toESM(require("../ast_util/AstUtil"));
+function fileIdentifierDetect(filePath, absPathPrefix) {
+  const { mapUuidToNode } = (0, import_getAstKitByFilePath.default)(filePath, absPathPrefix);
+  const programNode = mapUuidToNode.get("Program");
+  const { dependenceIds } = programNode._util;
+  const ids = [...dependenceIds].filter((id) => {
+    return import_AstUtil.default.isUntrackedId(id) || id._util.crossScope.size > 0;
+  });
+  return ids.map((id) => {
+    const { name, _util } = id;
+    const { crossScope } = _util;
+    const isUntracked = import_AstUtil.default.isUntrackedId(id);
+    const notFoundInfo = isUntracked ? `${name}:「${_util.startLine}:${_util.startColumn},${_util.endLine}:${_util.endColumn}」` : "";
+    const dangerScopeInfo = [...crossScope].map((scope) => {
+      const { _util: _util2 } = scope;
+      return `${scope.name}:「${_util2.startLine}:${_util2.startColumn},${_util2.endLine}:${_util2.endColumn}」`;
+    }).join("，");
+    return [notFoundInfo, dangerScopeInfo].filter(Boolean).join("，");
+  });
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  fileIdentifierDetect
+});

package/dist/cjs/util/report_util.d.ts

@@ -1,4 +1,12 @@
 import { GitDiffDetail } from "./format_git_diff_content";
+import { BlockReport } from "./report_util/code_block_detect";
+export type DetectReport = {
+    filePath: string;
+    type: "modify" | "add" | "delete";
+    filesDependsOnMe: string[];
+    dangerIdentifiers: string[];
+    blockReports: BlockReport[];
+};
 type Arg = {
     groupGitDiffLines: GitDiffDetail[];
     tree: Record<string, string[]>;
@@ -23,7 +31,8 @@ export declare function createDetectReport(arg: Arg): {
         kind: "Import" | "Declaration" | "Assignment" | "SelfUpdate" | "Invoke" | "Other" | "Never";
     }[];
     filePath: string;
-    type: "add" | "delete" | "modify";
+    type: "modify" | "add" | "delete";
     filesDependsOnMe: string[];
+    dangerIdentifiers: string[];
 }[];
 export {};

package/dist/cjs/util/report_util.js

@@ -35,6 +35,7 @@ module.exports = __toCommonJS(report_util_exports);
 var import_code_block_detect = __toESM(require("./report_util/code_block_detect"));
 var import_getAstKitByFilePath = __toESM(require("./ast_util/getAstKitByFilePath"));
 var import_AstUtil = __toESM(require("./ast_util/AstUtil"));
+var import_file_identifier_detect = require("./report_util/file_identifier_detect");
 function createDetectReport(arg) {
   const { groupGitDiffLines, tree, absPathPrefix } = arg;
   const reports = [];
@@ -48,10 +49,12 @@ function createDetectReport(arg) {
         filePath,
         type,
         filesDependsOnMe,
+        dangerIdentifiers: [],
         blockReports: []
       };
       reports.push(reportItem);
     }
+    reportItem.dangerIdentifiers = (0, import_file_identifier_detect.fileIdentifierDetect)(filePath, absPathPrefix);
     if (type === "modify") {
       (0, import_code_block_detect.default)({ gitDiffItem: item, absPathPrefix, blockReports: reportItem.blockReports });
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "js-code-detector",
-  "version": "0.0.2",
+  "version": "0.0.4",
   "description": "",
   "main": "dist/cjs/index.js",
   "types": "dist/cjs/index.d.ts",