@plexcord-companion/plexcord-ast-parser 2.0.0

package/dist/PlexcordAstParser.d.ts

@@ -0,0 +1,53 @@
+import { type Expression, type Identifier, type Node, type ObjectLiteralExpression } from "typescript";
+import { AstParser, type Import } from "@plexcord-companion/ast-parser";
+import { type Logger } from "@plexcord-companion/shared/Logger";
+import type { FindUse, FunctionNode, IFindType, IReplacement, PatchData, RegexNode, SourcePatch, StringNode } from "./types.js";
+export declare function setLogger(newLogger: Logger): void;
+export declare class PlexcordAstParser extends AstParser {
+    private readonly _path;
+    get path(): string;
+    /**
+     * @CacheGetter
+     */
+    get imports(): Map<Identifier, Import>;
+    constructor(content: string, path: string);
+    /**
+     * @Cache
+     */
+    private findDefinePlugin;
+    getPluginName(): string | null;
+    /**
+     * @Cache
+     */
+    getPatches(): SourcePatch[];
+    parseFind(patch: ObjectLiteralExpression): IFindType | null;
+    /**
+     * Try to parse a string literal
+     *
+     * if it is a template literal, attempt to extract the string content by inlining variables
+     */
+    tryParseStringLiteral(node: Node): string | null;
+    tryParseStringLiteralToStringNode(node: Node): StringNode | null;
+    tryParseFunction(node: Node): FunctionNode | null;
+    parseReplace(node: Expression): StringNode | FunctionNode | null;
+    parseMatch(node: Expression): StringNode | RegexNode | null;
+    parseReplacement(patch: ObjectLiteralExpression): IReplacement[] | null;
+    parsePatch(patch: ObjectLiteralExpression): PatchData | null;
+    /**
+     * @returns true if this file is the entry point (if it has a definePlugin call)
+     */
+    isRootPluginFile(): boolean;
+    /**
+     * @Cache
+     */
+    getFinds(): FindUse[];
+    /**
+     * @Cache
+     */
+    private getFindUses;
+    /**
+     * returns the import if this identifier is imported
+     */
+    private isIdentifierImported;
+    private listImports;
+}

package/dist/PlexcordAstParser.js

@@ -0,0 +1,325 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+import { DeclarationDomain } from "ts-api-utils";
+import { createPrinter, EmitHint, isArrayLiteralExpression, isArrowFunction, isCallExpression, isFunctionExpression, isIdentifier, isNamespaceImport, isObjectLiteralExpression, isPropertyAssignment, isRegularExpressionLiteral, isStringLiteral, isStringLiteralLike, isTemplateExpression, isVariableDeclaration, ScriptTarget, transpileModule, } from "typescript";
+import { AstParser, findObjectLiteralByKey, findParent, getImportName, getImportSource, isDefaultImport, isInImportStatment, } from "@plexcord-companion/ast-parser";
+import { Cache, CacheGetter } from "@plexcord-companion/shared/decorators";
+import { NoopLogger } from "@plexcord-companion/shared/Logger";
+import { tryParseRegularExpressionLiteral } from "./util.js";
+let logger = NoopLogger;
+export function setLogger(newLogger) {
+    logger = newLogger;
+}
+export class PlexcordAstParser extends AstParser {
+    _path;
+    get path() {
+        return this._path;
+    }
+    /**
+     * @CacheGetter
+     */
+    get imports() {
+        return this.listImports();
+    }
+    constructor(content, path) {
+        super(content);
+        this._path = path;
+    }
+    /**
+     * @Cache
+     */
+    findDefinePlugin() {
+        const define = [...this.imports.values()].find((x) => {
+            if (!x.default)
+                return;
+            if (x.source !== "@utils/types")
+                return;
+            return true;
+        });
+        if (!define)
+            return;
+        const uses = this.vars.get(define.as)?.uses;
+        if (!uses)
+            return;
+        const definePlugin = uses.find(({ location }) => {
+            if (!isCallExpression(location.parent))
+                return;
+            return location.parent.arguments.length === 1 && isObjectLiteralExpression(location.parent.arguments[0]);
+        });
+        return (definePlugin?.location.parent).arguments[0];
+    }
+    // TODO: work on files in the plugin folder but not the root plugin file
+    getPluginName() {
+        const definePlugin = this.findDefinePlugin();
+        if (!definePlugin)
+            return null;
+        const nameProp = findObjectLiteralByKey(definePlugin, "name");
+        if (!nameProp || !isPropertyAssignment(nameProp) || !isStringLiteral(nameProp.initializer))
+            return null;
+        return nameProp.initializer.text;
+    }
+    /**
+     * @Cache
+     */
+    getPatches() {
+        const definePlugin = this.findDefinePlugin();
+        if (!definePlugin)
+            return [];
+        const patchesProp = findObjectLiteralByKey(definePlugin, "patches");
+        if (!patchesProp || !isPropertyAssignment(patchesProp) || !isArrayLiteralExpression(patchesProp.initializer))
+            return [];
+        return patchesProp.initializer.elements
+            .map((x, origIndex) => {
+            if (!isObjectLiteralExpression(x))
+                return null;
+            const res = this.parsePatch(x);
+            if (!res)
+                return null;
+            return {
+                ...res,
+                range: this.makeRangeFromAstNode(x.getChildAt(1)),
+                origIndex,
+            };
+        })
+            .filter((x) => x !== null);
+    }
+    parseFind(patch) {
+        const find = findObjectLiteralByKey(patch, "find");
+        if (!find || !isPropertyAssignment(find))
+            return null;
+        if (!(isStringLiteral(find.initializer) || isRegularExpressionLiteral(find.initializer)))
+            return null;
+        return {
+            findType: isStringLiteral(find.initializer) ? "string" : "regex",
+            find: find.initializer.text,
+        };
+    }
+    /**
+     * Try to parse a string literal
+     *
+     * if it is a template literal, attempt to extract the string content by inlining variables
+     */
+    tryParseStringLiteral(node) {
+        tryParse: if (isStringLiteralLike(node)) {
+            return node.text;
+            // resolve template literals if they are constant
+        }
+        else if (isTemplateExpression(node)) {
+            const resolvedSpans = [];
+            for (const span of node.templateSpans) {
+                const spanExpr = span.expression;
+                if (!isIdentifier(spanExpr)) {
+                    logger.debug(`[PlexcordAstParser] Trying to parse template literal with non-identifier span: ${span.getText()}, FileName: ${span.getSourceFile().fileName}`);
+                    break tryParse;
+                }
+                const usageInfo = this.getVarInfoFromUse(spanExpr);
+                if (!usageInfo) {
+                    break tryParse;
+                }
+                else if (usageInfo.declarations.length === 0) {
+                    logger.trace(`[PlexcordAstParser] Could not resolve identifier ${spanExpr.text} to a variable declaration. Is it a global?`);
+                    break tryParse;
+                }
+                const isConst = this.isConstDeclared(usageInfo);
+                if (!isConst) {
+                    break tryParse;
+                }
+                const decl = findParent(isConst[0], isVariableDeclaration);
+                if (!decl) {
+                    break tryParse;
+                }
+                const init = decl.initializer;
+                if (!init) {
+                    break tryParse;
+                }
+                const initValue = this.tryParseStringLiteral(init);
+                // explicitly check for null to avoid empty string
+                if (initValue == null) {
+                    break tryParse;
+                }
+                resolvedSpans.push(initValue + span.literal.text);
+            }
+            return node.head.text + resolvedSpans.join("");
+        }
+        return null;
+    }
+    tryParseStringLiteralToStringNode(node) {
+        const str = this.tryParseStringLiteral(node);
+        if (str == null)
+            return null;
+        return {
+            type: "string",
+            value: str,
+        };
+    }
+    tryParseFunction(node) {
+        if (!isArrowFunction(node) && !isFunctionExpression(node))
+            return null;
+        const code = createPrinter()
+            .printNode(EmitHint.Expression, node, node.getSourceFile());
+        const res = transpileModule(code, {
+            compilerOptions: {
+                target: ScriptTarget.ESNext,
+                strict: true,
+            },
+        });
+        if (res.diagnostics && res.diagnostics.length > 0)
+            return null;
+        return {
+            type: "function",
+            value: res.outputText,
+        };
+    }
+    parseReplace(node) {
+        return this.tryParseStringLiteralToStringNode(node) ?? this.tryParseFunction(node);
+    }
+    parseMatch(node) {
+        return this.tryParseStringLiteralToStringNode(node) ?? tryParseRegularExpressionLiteral(node);
+    }
+    parseReplacement(patch) {
+        const replacementObj = findObjectLiteralByKey(patch, "replacement");
+        if (!replacementObj || !isPropertyAssignment(replacementObj))
+            return null;
+        const replacement = replacementObj.initializer;
+        const replacements = isArrayLiteralExpression(replacement) ? replacement.elements : [replacement];
+        if (!replacements.every(isObjectLiteralExpression))
+            return null;
+        const replacementValues = replacements.map((r) => {
+            const match = findObjectLiteralByKey(r, "match");
+            const replace = findObjectLiteralByKey(r, "replace");
+            if (!replace || !isPropertyAssignment(replace) || !match || !isPropertyAssignment(match))
+                return null;
+            const matchValue = this.parseMatch(match.initializer);
+            if (!matchValue)
+                return null;
+            const replaceValue = this.parseReplace(replace.initializer);
+            if (replaceValue == null)
+                return null;
+            return {
+                match: matchValue,
+                replace: replaceValue,
+            };
+        })
+            .filter((x) => x != null);
+        return replacementValues.length > 0 ? replacementValues : null;
+    }
+    parsePatch(patch) {
+        const find = this.parseFind(patch);
+        const replacement = this.parseReplacement(patch);
+        if (!replacement || !find)
+            return null;
+        return {
+            ...find,
+            replacement,
+        };
+    }
+    /**
+     * @returns true if this file is the entry point (if it has a definePlugin call)
+     */
+    isRootPluginFile() {
+        return !!this.findDefinePlugin();
+    }
+    /**
+     * @Cache
+     */
+    getFinds() {
+        return this.getFindUses()
+            .map((x) => {
+            const call = x.parent;
+            if (call.arguments.length === 0)
+                return false;
+            const args = call.arguments.map((x) => {
+                return this.tryParseStringLiteralToStringNode(x)
+                    ?? tryParseRegularExpressionLiteral(x)
+                    ?? this.tryParseFunction(x);
+            });
+            const range = this.makeRangeFromAstNode(call);
+            return {
+                range,
+                use: {
+                    type: "testFind",
+                    data: {
+                        type: x.getText(),
+                        args: args.filter((x) => x != null),
+                    },
+                },
+            };
+        })
+            .filter((x) => x !== false);
+    }
+    /**
+     * @Cache
+     */
+    getFindUses() {
+        const imports = [...this.imports.entries()].flatMap(([k, v]) => {
+            if (v.source !== "@webpack")
+                return [];
+            const origName = (v.orig ?? v.as).getText();
+            if (!origName.startsWith("find"))
+                return [];
+            return k;
+        });
+        const toRet = [];
+        for (const i of imports) {
+            const uses = this.vars.get(i)?.uses;
+            if (!uses)
+                continue;
+            for (const { location } of uses) {
+                if (!isCallExpression(location.parent))
+                    continue;
+                toRet.push(location);
+            }
+        }
+        return toRet;
+    }
+    /**
+     * returns the import if this identifier is imported
+     */
+    isIdentifierImported(i) {
+        const { declarations, domain } = this.vars.get(i) ?? {};
+        if (!declarations || declarations.length === 0)
+            return;
+        if (!(domain & DeclarationDomain.Import))
+            return;
+        const source = declarations.flatMap((x) => {
+            if (!isInImportStatment(x))
+                return [];
+            return x;
+        });
+        if (source.length !== 1)
+            return;
+        const [importIdent] = source;
+        return {
+            default: isDefaultImport(importIdent),
+            namespace: isNamespaceImport(importIdent),
+            ...getImportName(importIdent),
+            source: getImportSource(importIdent),
+        };
+    }
+    listImports() {
+        return new Map([...this.vars.entries()].flatMap(([k]) => {
+            const ret = this.isIdentifierImported(k);
+            return ret ? [[k, ret]] : [];
+        }));
+    }
+}
+__decorate([
+    CacheGetter()
+], PlexcordAstParser.prototype, "imports", null);
+__decorate([
+    Cache()
+], PlexcordAstParser.prototype, "findDefinePlugin", null);
+__decorate([
+    Cache()
+], PlexcordAstParser.prototype, "getPatches", null);
+__decorate([
+    Cache()
+], PlexcordAstParser.prototype, "getFinds", null);
+__decorate([
+    Cache()
+], PlexcordAstParser.prototype, "getFindUses", null);
+//# sourceMappingURL=PlexcordAstParser.js.map

package/dist/PlexcordAstParser.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./PlexcordAstParser.js";
+export * from "./types.js";
+export * from "./util.js";

package/dist/index.js

@@ -0,0 +1,4 @@
+export * from "./PlexcordAstParser.js";
+export * from "./types.js";
+export * from "./util.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,cAAc,SAAS,CAAC;AACxB,cAAc,QAAQ,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,57 @@
+import { Range } from "@plexcord-companion/shared/Range";
+export type AnyFindType = `find${"Component" | "ByProps" | "Store" | "ByCode" | "ModuleId" | "ComponentByCode" | ""}${"Lazy" | ""}`;
+export type StringNode = {
+    type: "string";
+    value: string;
+};
+export type RegexNode = {
+    type: "regex";
+    value: {
+        pattern: string;
+        flags: string;
+    };
+};
+export type FunctionNode = {
+    type: "function";
+    value: string;
+};
+export type FindNode = StringNode | RegexNode | FunctionNode;
+export type FindData = {
+    type: AnyFindType;
+    args: FindNode[];
+};
+export type IReplacement = {
+    match: StringNode | RegexNode;
+    replace: StringNode | FunctionNode;
+};
+export type IFindType = {
+    findType: "string";
+    /**
+           * the find string
+           */
+    find: string;
+} | {
+    findType: "regex";
+    /**
+           * stringified regex
+           */
+    find: string;
+};
+export type PatchData = IFindType & {
+    replacement: IReplacement[];
+};
+/**
+ * a parsed patch, as it appears in a source file
+ */
+export type SourcePatch = PatchData & {
+    range: Range;
+    origIndex: number;
+};
+export type FindUse = {
+    range: Range;
+    use: TestFind;
+};
+export type TestFind = {
+    type: "testFind";
+    data: FindData;
+};

package/dist/types.js

@@ -0,0 +1,2 @@
+import { Range } from "@plexcord-companion/shared/Range";
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,kCAAkC,CAAC"}

package/dist/util.d.ts

@@ -0,0 +1,5 @@
+import { type Node } from "typescript";
+import type { FunctionNode, RegexNode, StringNode } from "./types.js";
+export declare function tryParseStringLiteral(node: Node): StringNode | null;
+export declare function tryParseRegularExpressionLiteral(node: Node): RegexNode | null;
+export declare function tryParseFunction(path: string, node: Node): FunctionNode | null;

package/dist/util.js

@@ -0,0 +1,42 @@
+import { createPrinter, EmitHint, findConfigFile, isArrowFunction, isFunctionExpression, isRegularExpressionLiteral, isStringLiteral, parseJsonConfigFileContent, readConfigFile, sys, transpileModule, } from "typescript";
+import { basename } from "node:path";
+export function tryParseStringLiteral(node) {
+    if (!isStringLiteral(node))
+        return null;
+    return {
+        type: "string",
+        value: node.text,
+    };
+}
+export function tryParseRegularExpressionLiteral(node) {
+    if (!isRegularExpressionLiteral(node))
+        return null;
+    const m = node.text.match(/^\/(.+)\/(.*?)$/);
+    return m && {
+        type: "regex",
+        value: {
+            pattern: m[1],
+            flags: m[2],
+        },
+    };
+}
+export function tryParseFunction(path, node) {
+    if (!isArrowFunction(node) && !isFunctionExpression(node))
+        return null;
+    const code = createPrinter()
+        .printNode(EmitHint.Expression, node, node.getSourceFile());
+    let compilerOptions = {};
+    const tsConfigPath = findConfigFile(path, sys.fileExists);
+    if (tsConfigPath) {
+        const configFile = readConfigFile(tsConfigPath, sys.readFile);
+        compilerOptions = parseJsonConfigFileContent(configFile.config, sys, basename(tsConfigPath)).options;
+    }
+    const res = transpileModule(code, { compilerOptions });
+    if (res.diagnostics && res.diagnostics.length > 0)
+        return null;
+    return {
+        type: "function",
+        value: res.outputText,
+    };
+}
+//# sourceMappingURL=util.js.map

package/dist/util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"util.js","sourceRoot":"","sources":["../src/util.ts"],"names":[],"mappings":"AAAA,OAAO,EAEH,aAAa,EACb,QAAQ,EACR,cAAc,EACd,eAAe,EACf,oBAAoB,EACpB,0BAA0B,EAC1B,eAAe,EAEf,0BAA0B,EAC1B,cAAc,EACd,GAAG,EACH,eAAe,GAClB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAKrC,MAAM,UAAU,qBAAqB,CAAC,IAAU;IAC5C,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC;QACtB,OAAO,IAAI,CAAC;IAEhB,OAAO;QACH,IAAI,EAAE,QAAQ;QACd,KAAK,EAAE,IAAI,CAAC,IAAI;KACnB,CAAC;AACN,CAAC;AAED,MAAM,UAAU,gCAAgC,CAAC,IAAU;IACvD,IAAI,CAAC,0BAA0B,CAAC,IAAI,CAAC;QACjC,OAAO,IAAI,CAAC;IAEhB,MAAM,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC;IAE7C,OAAO,CAAC,IAAI;QACR,IAAI,EAAE,OAAO;QACb,KAAK,EAAE;YACH,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC;YACb,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC;SACd;KACJ,CAAC;AACN,CAAC;AACD,MAAM,UAAU,gBAAgB,CAAC,IAAY,EAAE,IAAU;IACrD,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,oBAAoB,CAAC,IAAI,CAAC;QACrD,OAAO,IAAI,CAAC;IAEhB,MAAM,IAAI,GAAG,aAAa,EAAE;SACvB,SAAS,CAAC,QAAQ,CAAC,UAAU,EAAE,IAAI,EAAE,IAAI,CAAC,aAAa,EAAE,CAAC,CAAC;IAEhE,IAAI,eAAe,GAAoB,EAAE,CAAC;IAC1C,MAAM,YAAY,GAAG,cAAc,CAAC,IAAI,EAAE,GAAG,CAAC,UAAU,CAAC,CAAC;IAE1D,IAAI,YAAY,EAAE,CAAC;QACf,MAAM,UAAU,GAAG,cAAc,CAAC,YAAY,EAAE,GAAG,CAAC,QAAQ,CAAC,CAAC;QAE9D,eAAe,GAAG,0BAA0B,CAAC,UAAU,CAAC,MAAM,EAAE,GAAG,EAAE,QAAQ,CAAC,YAAY,CAAC,CAAC,CAAC,OAAO,CAAC;IACzG,CAAC;IAED,MAAM,GAAG,GAAG,eAAe,CAAC,IAAI,EAAE,EAAE,eAAe,EAAE,CAAC,CAAC;IAEvD,IAAI,GAAG,CAAC,WAAW,IAAI,GAAG,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC;QAC7C,OAAO,IAAI,CAAC;IAEhB,OAAO;QACH,IAAI,EAAE,UAAU;QAChB,KAAK,EAAE,GAAG,CAAC,UAAU;KACxB,CAAC;AACN,CAAC"}

package/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "@plexcord-companion/plexcord-ast-parser",
+  "version": "2.0.0",
+  "description": "",
+  "author": {
+    "name": "MutanPlex",
+    "url": "https://mutanplex.com"
+  },
+  "main": "index.js",
+  "exports": {
+    "./*": "./dist/*.js",
+    ".": "./dist/index.js"
+  },
+  "keywords": [],
+  "license": "LGPL-3.0-or-later",
+  "dependencies": {
+    "@plexcord-companion/ast-parser": "2.0.0",
+    "@plexcord-companion/shared": "2.0.0"
+  },
+  "peerDependencies": {
+    "ts-api-utils": "^2.1.0",
+    "typescript": "^5.9.0"
+  },
+  "devDependencies": {
+    "@types/node": "^24.6.0",
+    "vitest": "^3.2.4"
+  },
+  "scripts": {
+    "preversion": "mkdir .git || :",
+    "bump": "npm version",
+    "postversion": "rmdir .git",
+    "build": "tsc -b && tsc-alias -f"
+  }
+}

package/src/PlexcordAstParser.ts

@@ -0,0 +1,429 @@
+import { DeclarationDomain } from "ts-api-utils";
+import {
+    type CallExpression,
+    createPrinter,
+    EmitHint,
+    type Expression,
+    type Identifier,
+    isArrayLiteralExpression,
+    isArrowFunction,
+    isCallExpression,
+    isFunctionExpression,
+    isIdentifier,
+    isNamespaceImport,
+    isObjectLiteralExpression,
+    isPropertyAssignment,
+    isRegularExpressionLiteral,
+    isStringLiteral,
+    isStringLiteralLike,
+    isTemplateExpression,
+    isVariableDeclaration,
+    type Node,
+    type ObjectLiteralExpression,
+    ScriptTarget,
+    transpileModule,
+} from "typescript";
+
+import {
+    AstParser,
+    findObjectLiteralByKey,
+    findParent,
+    getImportName,
+    getImportSource,
+    type Import,
+    isDefaultImport,
+    isInImportStatment,
+    type WithParent,
+} from "@plexcord-companion/ast-parser";
+import { Cache, CacheGetter } from "@plexcord-companion/shared/decorators";
+import { type Logger, NoopLogger } from "@plexcord-companion/shared/Logger";
+
+import type { FindUse, FunctionNode, IFindType, IReplacement, PatchData, RegexNode, SourcePatch, StringNode, TestFind } from "./types";
+import { tryParseRegularExpressionLiteral } from "./util";
+
+
+let logger: Logger = NoopLogger;
+
+export function setLogger(newLogger: Logger): void {
+    logger = newLogger;
+}
+
+export class PlexcordAstParser extends AstParser {
+    private readonly _path: string;
+
+    public get path(): string {
+        return this._path;
+    }
+
+    /**
+     * @CacheGetter
+     */
+    @CacheGetter()
+    public get imports(): Map<Identifier, Import> {
+        return this.listImports();
+    }
+
+    constructor(content: string, path: string) {
+        super(content);
+        this._path = path;
+    }
+
+    /**
+     * @Cache
+     */
+    @Cache()
+    private findDefinePlugin(): ObjectLiteralExpression | undefined {
+        const define = [...this.imports.values()].find((x) => {
+            if (!x.default)
+                return;
+            if (x.source !== "@utils/types")
+                return;
+            return true;
+        });
+
+        if (!define)
+            return;
+
+        const uses = this.vars.get(define.as)?.uses;
+
+        if (!uses)
+            return;
+
+        const definePlugin = uses.find(({ location }) => {
+            if (!isCallExpression(location.parent))
+                return;
+            return location.parent.arguments.length === 1 && isObjectLiteralExpression(location.parent.arguments[0]);
+        });
+
+        return (definePlugin?.location.parent as CallExpression).arguments[0] as ObjectLiteralExpression;
+    }
+
+    // TODO: work on files in the plugin folder but not the root plugin file
+    public getPluginName(): string | null {
+        const definePlugin = this.findDefinePlugin();
+
+        if (!definePlugin)
+            return null;
+
+        const nameProp = findObjectLiteralByKey(definePlugin, "name");
+
+        if (!nameProp || !isPropertyAssignment(nameProp) || !isStringLiteral(nameProp.initializer))
+            return null;
+        return nameProp.initializer.text;
+    }
+
+    /**
+     * @Cache
+     */
+    @Cache()
+    public getPatches(): SourcePatch[] {
+        const definePlugin = this.findDefinePlugin();
+
+        if (!definePlugin)
+            return [];
+
+        const patchesProp = findObjectLiteralByKey(definePlugin, "patches");
+
+        if (!patchesProp || !isPropertyAssignment(patchesProp) || !isArrayLiteralExpression(patchesProp.initializer))
+            return [];
+        return patchesProp.initializer.elements
+            .map((x, origIndex) => {
+                if (!isObjectLiteralExpression(x))
+                    return null;
+
+                const res = this.parsePatch(x);
+
+                if (!res)
+                    return null;
+                return {
+                    ...res,
+                    range: this.makeRangeFromAstNode(x.getChildAt(1)),
+                    origIndex,
+                };
+            })
+            .filter((x) => x !== null);
+    }
+
+    parseFind(patch: ObjectLiteralExpression): IFindType | null {
+        const find = findObjectLiteralByKey(patch, "find");
+
+        if (!find || !isPropertyAssignment(find))
+            return null;
+        if (!(isStringLiteral(find.initializer) || isRegularExpressionLiteral(find.initializer)))
+            return null;
+
+        return {
+            findType: isStringLiteral(find.initializer) ? "string" : "regex",
+            find: find.initializer.text,
+        };
+    }
+
+    /**
+     * Try to parse a string literal
+     *
+     * if it is a template literal, attempt to extract the string content by inlining variables
+     */
+    tryParseStringLiteral(node: Node): string | null {
+        tryParse: if (isStringLiteralLike(node)) {
+            return node.text;
+            // resolve template literals if they are constant
+        } else if (isTemplateExpression(node)) {
+            const resolvedSpans = [] as string[];
+
+            for (const span of node.templateSpans) {
+                const spanExpr = span.expression;
+
+                if (!isIdentifier(spanExpr)) {
+                    logger.debug(`[PlexcordAstParser] Trying to parse template literal with non-identifier span: ${span.getText()}, FileName: ${span.getSourceFile().fileName}`);
+                    break tryParse;
+                }
+
+                const usageInfo = this.getVarInfoFromUse(spanExpr);
+
+                if (!usageInfo) {
+                    break tryParse;
+                } else if (usageInfo.declarations.length === 0) {
+                    logger.trace(`[PlexcordAstParser] Could not resolve identifier ${spanExpr.text} to a variable declaration. Is it a global?`);
+                    break tryParse;
+                }
+
+                const isConst = this.isConstDeclared(usageInfo);
+
+                if (!isConst) {
+                    break tryParse;
+                }
+
+                const decl = findParent(isConst[0], isVariableDeclaration);
+
+                if (!decl) {
+                    break tryParse;
+                }
+
+                const init = decl.initializer;
+
+                if (!init) {
+                    break tryParse;
+                }
+
+                const initValue = this.tryParseStringLiteral(init);
+
+                // explicitly check for null to avoid empty string
+                if (initValue == null) {
+                    break tryParse;
+                }
+
+                resolvedSpans.push(initValue + span.literal.text);
+            }
+
+            return node.head.text + resolvedSpans.join("");
+        }
+        return null;
+    }
+
+    tryParseStringLiteralToStringNode(node: Node): StringNode | null {
+        const str = this.tryParseStringLiteral(node);
+
+        if (str == null)
+            return null;
+
+        return {
+            type: "string",
+            value: str,
+        };
+    }
+
+    tryParseFunction(node: Node): FunctionNode | null {
+        if (!isArrowFunction(node) && !isFunctionExpression(node))
+            return null;
+
+        const code = createPrinter()
+            .printNode(EmitHint.Expression, node, node.getSourceFile());
+
+        const res = transpileModule(code, {
+            compilerOptions: {
+                target: ScriptTarget.ESNext,
+                strict: true,
+            },
+        });
+
+        if (res.diagnostics && res.diagnostics.length > 0)
+            return null;
+
+        return {
+            type: "function",
+            value: res.outputText,
+        };
+    }
+
+    parseReplace(node: Expression): StringNode | FunctionNode | null {
+        return this.tryParseStringLiteralToStringNode(node) ?? this.tryParseFunction(node);
+    }
+
+    parseMatch(node: Expression): StringNode | RegexNode | null {
+        return this.tryParseStringLiteralToStringNode(node) ?? tryParseRegularExpressionLiteral(node);
+    }
+
+    parseReplacement(patch: ObjectLiteralExpression): IReplacement[] | null {
+        const replacementObj = findObjectLiteralByKey(patch, "replacement");
+
+        if (!replacementObj || !isPropertyAssignment(replacementObj))
+            return null;
+
+        const replacement = replacementObj.initializer;
+        const replacements = isArrayLiteralExpression(replacement) ? replacement.elements : [replacement];
+
+        if (!replacements.every(isObjectLiteralExpression))
+            return null;
+
+        const replacementValues = (replacements as ObjectLiteralExpression[]).map((r: ObjectLiteralExpression) => {
+            const match = findObjectLiteralByKey(r, "match");
+            const replace = findObjectLiteralByKey(r, "replace");
+
+            if (!replace || !isPropertyAssignment(replace) || !match || !isPropertyAssignment(match))
+                return null;
+
+            const matchValue = this.parseMatch(match.initializer);
+
+            if (!matchValue)
+                return null;
+
+            const replaceValue = this.parseReplace(replace.initializer);
+
+            if (replaceValue == null)
+                return null;
+
+            return {
+                match: matchValue,
+                replace: replaceValue,
+            };
+        })
+            .filter((x) => x != null);
+
+        return replacementValues.length > 0 ? replacementValues : null;
+    }
+
+    parsePatch(patch: ObjectLiteralExpression): PatchData | null {
+        const find = this.parseFind(patch);
+        const replacement = this.parseReplacement(patch);
+
+        if (!replacement || !find)
+            return null;
+
+        return {
+            ...find,
+            replacement,
+        };
+    }
+
+
+    /**
+     * @returns true if this file is the entry point (if it has a definePlugin call)
+     */
+    public isRootPluginFile(): boolean {
+        return !!this.findDefinePlugin();
+    }
+
+    /**
+     * @Cache
+     */
+    @Cache()
+    public getFinds(): FindUse[] {
+        return this.getFindUses()
+            .map<FindUse | false>((x) => {
+                const call = x.parent;
+
+                if (call.arguments.length === 0)
+                    return false;
+
+                const args = call.arguments.map((x) => {
+                    return this.tryParseStringLiteralToStringNode(x)
+                      ?? tryParseRegularExpressionLiteral(x)
+                      ?? this.tryParseFunction(x);
+                });
+
+                const range = this.makeRangeFromAstNode(call);
+
+                return {
+                    range,
+                    use: {
+                        type: "testFind",
+                        data: {
+                            type: x.getText() as TestFind["data"]["type"],
+                            args: args.filter((x) => x != null),
+                        },
+                    },
+                };
+            })
+            .filter((x) => x !== false);
+    }
+
+    /**
+     * @Cache
+     */
+    @Cache()
+    private getFindUses(): WithParent<Identifier, CallExpression>[] {
+        const imports = [...this.imports.entries()].flatMap(([k, v]) => {
+            if (v.source !== "@webpack")
+                return [];
+
+            const origName = (v.orig ?? v.as).getText();
+
+            if (!origName.startsWith("find"))
+                return [];
+            return k;
+        });
+
+        const toRet: WithParent<Identifier, CallExpression>[] = [];
+
+        for (const i of imports) {
+            const uses = this.vars.get(i)?.uses;
+
+            if (!uses)
+                continue;
+            for (const { location } of uses) {
+                if (!isCallExpression(location.parent))
+                    continue;
+                toRet.push(location as WithParent<Identifier, CallExpression>);
+            }
+        }
+        return toRet;
+    }
+
+    /**
+     * returns the import if this identifier is imported
+     */
+    private isIdentifierImported(i: Identifier): Import | undefined {
+        const { declarations, domain } = this.vars.get(i) ?? {};
+
+        if (!declarations || declarations.length === 0)
+            return;
+        if (!(domain! & DeclarationDomain.Import))
+            return;
+
+        const source = declarations.flatMap((x) => {
+            if (!isInImportStatment(x))
+                return [];
+            return x;
+        });
+
+        if (source.length !== 1)
+            return;
+
+        const [importIdent] = source;
+
+        return {
+            default: isDefaultImport(importIdent),
+            namespace: isNamespaceImport(importIdent),
+            ...getImportName(importIdent),
+            source: getImportSource(importIdent),
+        };
+    }
+
+    private listImports(): Map<Identifier, Import> {
+        return new Map([...this.vars.entries()].flatMap(([k]) => {
+            const ret = this.isIdentifierImported(k);
+
+            return ret ? [[k, ret]] : [];
+        }));
+    }
+}

package/src/index.ts

@@ -0,0 +1,3 @@
+export * from "./PlexcordAstParser";
+export * from "./types";
+export * from "./util";

package/src/types.ts

@@ -0,0 +1,64 @@
+import { Range } from "@plexcord-companion/shared/Range";
+export type AnyFindType
+    = `find${"Component" | "ByProps" | "Store" | "ByCode" | "ModuleId" | "ComponentByCode" | ""}${"Lazy" | ""}`;
+
+export type StringNode = {
+    type: "string";
+    value: string;
+};
+
+export type RegexNode = {
+    type: "regex";
+    value: {
+        pattern: string;
+        flags: string;
+    };
+};
+
+export type FunctionNode = {
+    type: "function";
+    value: string;
+};
+
+export type FindNode = StringNode | RegexNode | FunctionNode;
+
+export type FindData = {
+    type: AnyFindType;
+    args: FindNode[];
+};
+export type IReplacement = {
+    match: StringNode | RegexNode;
+    replace: StringNode | FunctionNode;
+};
+export type IFindType
+    = | {
+        findType: "string";
+        /**
+               * the find string
+               */
+        find: string;
+    }
+    | {
+        findType: "regex";
+        /**
+               * stringified regex
+               */
+        find: string;
+    };
+export type PatchData = IFindType & {
+    replacement: IReplacement[];
+};
+/**
+ * a parsed patch, as it appears in a source file
+ */
+export type SourcePatch = PatchData & { range: Range;
+    origIndex: number; };
+export type FindUse = {
+    range: Range;
+    use: TestFind;
+};
+
+export type TestFind = {
+    type: "testFind";
+    data: FindData;
+};

package/src/util.ts

@@ -0,0 +1,71 @@
+import {
+    type CompilerOptions,
+    createPrinter,
+    EmitHint,
+    findConfigFile,
+    isArrowFunction,
+    isFunctionExpression,
+    isRegularExpressionLiteral,
+    isStringLiteral,
+    type Node,
+    parseJsonConfigFileContent,
+    readConfigFile,
+    sys,
+    transpileModule,
+} from "typescript";
+
+import { basename } from "node:path";
+
+import type { FunctionNode, RegexNode, StringNode } from "./types";
+
+
+export function tryParseStringLiteral(node: Node): StringNode | null {
+    if (!isStringLiteral(node))
+        return null;
+
+    return {
+        type: "string",
+        value: node.text,
+    };
+}
+
+export function tryParseRegularExpressionLiteral(node: Node): RegexNode | null {
+    if (!isRegularExpressionLiteral(node))
+        return null;
+
+    const m = node.text.match(/^\/(.+)\/(.*?)$/);
+
+    return m && {
+        type: "regex",
+        value: {
+            pattern: m[1],
+            flags: m[2],
+        },
+    };
+}
+export function tryParseFunction(path: string, node: Node): FunctionNode | null {
+    if (!isArrowFunction(node) && !isFunctionExpression(node))
+        return null;
+
+    const code = createPrinter()
+        .printNode(EmitHint.Expression, node, node.getSourceFile());
+
+    let compilerOptions: CompilerOptions = {};
+    const tsConfigPath = findConfigFile(path, sys.fileExists);
+
+    if (tsConfigPath) {
+        const configFile = readConfigFile(tsConfigPath, sys.readFile);
+
+        compilerOptions = parseJsonConfigFileContent(configFile.config, sys, basename(tsConfigPath)).options;
+    }
+
+    const res = transpileModule(code, { compilerOptions });
+
+    if (res.diagnostics && res.diagnostics.length > 0)
+        return null;
+
+    return {
+        type: "function",
+        value: res.outputText,
+    };
+}