autoremediator 0.21.2 → 0.22.0

package/dist/remediation/impact/ast.js

@@ -0,0 +1,201 @@
+/**
+ * AST helpers shared by the fix-diff and upgrade-impact analyses: parsing, walking with parents,
+ * and a canonical form of a subtree that ignores formatting and comments.
+ */
+import { createHash } from "node:crypto";
+import { parseSync } from "oxc-parser";
+export function isNode(value) {
+    return typeof value === "object" && value !== null && typeof value.type === "string";
+}
+/** Parse a file; undefined when it cannot be parsed at all (an empty program from a broken file). */
+export function parseSource(file, code) {
+    try {
+        const result = parseSync(file, code, { preserveParens: false });
+        const program = result.program;
+        if (!program)
+            return undefined;
+        const body = program.body;
+        if (result.errors.length > 0 && (body?.length ?? 0) === 0 && code.trim() !== "") {
+            return undefined;
+        }
+        return program;
+    }
+    catch {
+        return undefined;
+    }
+}
+const SKIPPED_KEYS = new Set(["start", "end", "range", "loc", "parent"]);
+/** Child nodes of a node, in source order of the parser's keys. */
+export function childNodes(node) {
+    const children = [];
+    for (const key of Object.keys(node)) {
+        if (SKIPPED_KEYS.has(key))
+            continue;
+        const value = node[key];
+        if (Array.isArray(value)) {
+            for (const item of value)
+                if (isNode(item))
+                    children.push(item);
+        }
+        else if (isNode(value)) {
+            children.push(value);
+        }
+    }
+    return children;
+}
+/**
+ * Depth-first walk with the parent chain. Return `false` from `visit` to skip a node's subtree.
+ * Iterative, so a deeply nested file cannot overflow the stack.
+ */
+export function walk(root, visit) {
+    const ancestors = [];
+    const stack = [{ node: root, depth: 0 }];
+    while (stack.length > 0) {
+        const item = stack.pop();
+        if (!item)
+            break;
+        ancestors.length = item.depth;
+        const parent = ancestors.at(-1);
+        const descend = visit(item.node, parent, ancestors);
+        if (descend === false)
+            continue;
+        ancestors.push(item.node);
+        const children = childNodes(item.node);
+        for (let index = children.length - 1; index >= 0; index--) {
+            const child = children[index];
+            if (child)
+                stack.push({ node: child, depth: item.depth + 1 });
+        }
+    }
+}
+const MAX_TOKENS = 4000;
+const MAX_STRING_TOKEN = 120;
+function literalText(node) {
+    const regex = node.regex;
+    if (regex)
+        return `/${regex.pattern ?? ""}/${regex.flags ?? ""}`;
+    if (typeof node.bigint === "string")
+        return `${node.bigint}n`;
+    const value = node.value;
+    if (typeof value === "string")
+        return value;
+    return `${typeof value}:${String(value)}`;
+}
+/**
+ * Canonical form of a subtree. `placeholder` may return a replacement label for a descendant
+ * (used to leave nested named functions out of their parent's fingerprint).
+ */
+export function canonicalForm(root, placeholder) {
+    const hash = createHash("sha256");
+    const tokens = new Set();
+    let nodeCount = 0;
+    const addToken = (token) => {
+        if (tokens.size < MAX_TOKENS && token !== "")
+            tokens.add(token.slice(0, MAX_STRING_TOKEN));
+    };
+    const feed = (node, isRoot) => {
+        if (!isRoot && placeholder) {
+            const label = placeholder(node);
+            if (label !== undefined) {
+                hash.update(`@ref(${label})`);
+                return;
+            }
+        }
+        nodeCount++;
+        hash.update(`<${node.type}`);
+        if (node.type === "Identifier" || node.type === "PrivateIdentifier") {
+            const name = String(node.name);
+            hash.update(`:${name}`);
+            addToken(name);
+        }
+        else if (node.type === "Literal") {
+            const text = literalText(node);
+            hash.update(`:${typeof node.value}:${text}`);
+            addToken(text);
+        }
+        else if (node.type === "TemplateElement") {
+            const cooked = node.value?.cooked ?? "";
+            hash.update(`:${cooked}`);
+            addToken(cooked);
+        }
+        for (const key of Object.keys(node).toSorted()) {
+            if (SKIPPED_KEYS.has(key) || key === "raw" || key === "type")
+                continue;
+            if (key === "name" && (node.type === "Identifier" || node.type === "PrivateIdentifier")) {
+                continue;
+            }
+            if (node.type === "Literal" && (key === "value" || key === "regex" || key === "bigint")) {
+                continue;
+            }
+            if (node.type === "TemplateElement" && key === "value")
+                continue;
+            const value = node[key];
+            if (isNode(value)) {
+                hash.update(`.${key}=`);
+                feed(value, false);
+            }
+            else if (Array.isArray(value)) {
+                hash.update(`.${key}=[`);
+                for (const item of value) {
+                    if (isNode(item))
+                        feed(item, false);
+                    else
+                        hash.update(`${typeof item}:${String(item)},`);
+                }
+                hash.update("]");
+            }
+            else if (typeof value === "string" ||
+                typeof value === "number" ||
+                typeof value === "boolean" ||
+                typeof value === "bigint") {
+                hash.update(`.${key}=${typeof value}:${String(value)}`);
+            }
+        }
+        hash.update(">");
+    };
+    feed(root, true);
+    return { fingerprint: hash.digest("hex").slice(0, 20), nodeCount, tokens };
+}
+/** Offsets of the start of every line, for converting a character offset to a line number. */
+export function lineStarts(code) {
+    const starts = [0];
+    for (let index = 0; index < code.length; index++) {
+        if (code.codePointAt(index) === 10)
+            starts.push(index + 1);
+    }
+    return starts;
+}
+/** 1-based line of a character offset. */
+export function lineOf(starts, offset) {
+    let low = 0;
+    let high = starts.length - 1;
+    while (low < high) {
+        const mid = Math.ceil((low + high) / 2);
+        if ((starts[mid] ?? 0) <= offset)
+            low = mid;
+        else
+            high = mid - 1;
+    }
+    return low + 1;
+}
+/** Name of an identifier or string-literal node (`{ name }` or `{ value }`). */
+export function nameOfNode(node) {
+    if (!isNode(node))
+        return undefined;
+    if (typeof node.name === "string")
+        return node.name;
+    return typeof node.value === "string" ? node.value : undefined;
+}
+/** Name of a property key that is a plain identifier or string literal; undefined when computed. */
+export function propertyName(key, computed) {
+    if (!isNode(key))
+        return undefined;
+    if (key.type === "Identifier" && !computed)
+        return String(key.name);
+    if (key.type === "Literal" && typeof key.value === "string")
+        return key.value;
+    if (key.type === "Literal" && typeof key.value === "number")
+        return String(key.value);
+    return undefined;
+}
+//# sourceMappingURL=ast.js.map

package/dist/remediation/impact/ast.js.map

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

package/dist/remediation/impact/dts-surface.d.ts

@@ -0,0 +1,48 @@
+import type { PackageIndex } from "./package-index.js";
+import type { ParamInfo } from "./types.js";
+export interface Signature {
+    params: ParamInfo[];
+    returns?: string;
+    typeParams?: string;
+    /** `<T>(a: string, b?: number) => R`, normalised. */
+    text: string;
+}
+export type MemberKind = "method" | "property" | "constructor" | "getter" | "setter" | "call" | "construct" | "index";
+export interface ApiMember {
+    /** Unique within the container: `name`, `static name`, `[call]`, `[new]`, `[index]`. */
+    key: string;
+    name: string;
+    static: boolean;
+    kind: MemberKind;
+    optional: boolean;
+    readonly: boolean;
+    signatures: Signature[];
+    /** Property type as source text. */
+    type?: string;
+}
+export type SymbolKind = "function" | "class" | "interface" | "type" | "enum" | "variable" | "namespace" | "module" | "value";
+export interface ApiSymbol {
+    name: string;
+    kind: SymbolKind;
+    signatures: Signature[];
+    members: Map<string, ApiMember>;
+    /** Type alias body, variable type or enum initialisers, as source text. */
+    type?: string;
+    /** `extends` clause as source text. */
+    extends?: string;
+    /** Types a variable is declared as, by name (`Chalk`, `ns.Options`), resolved into `members`. */
+    typeRefs?: string[];
+    /** Declarations nested in a namespace, by name. */
+    nested?: Map<string, ApiSymbol>;
+}
+export interface ApiSurface {
+    source: "types" | "js";
+    entryFile?: string;
+    symbols: Map<string, ApiSymbol>;
+    notes: string[];
+}
+/** Public API of a package from its declaration files, starting at `entryFile`. */
+export declare function extractDtsSurface(index: PackageIndex, entryFile: string): ApiSurface;
+/** Public API of a package from its JavaScript, when no declaration files are available. */
+export declare function extractJsSurface(index: PackageIndex, entryFile: string): ApiSurface;
+//# sourceMappingURL=dts-surface.d.ts.map

package/dist/remediation/impact/dts-surface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dts-surface.d.ts","sourceRoot":"","sources":["../../../src/remediation/impact/dts-surface.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,SAAS,EAAE,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,qDAAqD;IACrD,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,MAAM,UAAU,GAClB,QAAQ,GACR,UAAU,GACV,aAAa,GACb,QAAQ,GACR,QAAQ,GACR,MAAM,GACN,WAAW,GACX,OAAO,CAAC;AAEZ,MAAM,WAAW,SAAS;IACxB,wFAAwF;IACxF,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,OAAO,CAAC;IAChB,IAAI,EAAE,UAAU,CAAC;IACjB,QAAQ,EAAE,OAAO,CAAC;IAClB,QAAQ,EAAE,OAAO,CAAC;IAClB,UAAU,EAAE,SAAS,EAAE,CAAC;IACxB,oCAAoC;IACpC,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,MAAM,UAAU,GAClB,UAAU,GACV,OAAO,GACP,WAAW,GACX,MAAM,GACN,MAAM,GACN,UAAU,GACV,WAAW,GACX,QAAQ,GACR,OAAO,CAAC;AAEZ,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,UAAU,CAAC;IACjB,UAAU,EAAE,SAAS,EAAE,CAAC;IACxB,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IAChC,2EAA2E;IAC3E,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,uCAAuC;IACvC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iGAAiG;IACjG,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,mDAAmD;IACnD,MAAM,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;CACjC;AAED,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,OAAO,GAAG,IAAI,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IAChC,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAggBD,mFAAmF;AACnF,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,GAAG,UAAU,CAuFpF;AAYD,4FAA4F;AAC5F,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,GAAG,UAAU,CA4CnF"}