@hanseltime/esm-interop-tools 1.0.0

package/dist/esm/packageGraphs/getYarnInfoPackageGraph.mjs

@@ -0,0 +1,142 @@
+function asyncGeneratorStep(gen, resolve, reject, _next, _throw, key, arg) {
+    try {
+        var info = gen[key](arg);
+        var value = info.value;
+    } catch (error) {
+        reject(error);
+        return;
+    }
+    if (info.done) {
+        resolve(value);
+    } else {
+        Promise.resolve(value).then(_next, _throw);
+    }
+}
+function _async_to_generator(fn) {
+    return function() {
+        var self = this, args = arguments;
+        return new Promise(function(resolve, reject) {
+            var gen = fn.apply(self, args);
+            function _next(value) {
+                asyncGeneratorStep(gen, resolve, reject, _next, _throw, "next", value);
+            }
+            function _throw(err) {
+                asyncGeneratorStep(gen, resolve, reject, _next, _throw, "throw", err);
+            }
+            _next(undefined);
+        });
+    };
+}
+import { execSync } from "child_process";
+import { PackageGraph } from "./PackageGraph";
+import { existsSync, readFileSync } from "fs";
+import { dirname, join } from "path";
+/**
+ * Gets the first package.json that can be found
+ */ function getRootPackageJson(start, curDir) {
+    const dir = curDir !== null && curDir !== void 0 ? curDir : start;
+    const testPath = join(dir, "package.json");
+    if (existsSync(testPath)) {
+        return testPath;
+    }
+    const oneUp = dirname(dir);
+    if (!oneUp) {
+        throw new Error(`Could not find package.json traveling up from start dir at ${start}`);
+    }
+    return getRootPackageJson(start, oneUp);
+}
+/**
+ * Retrieves the dependencies for a package in a PackageGraph
+ * @param pkgDir - the directory where the top-level package is
+ * @param recurse - get all the packages through all immediate dependencies
+ * @returns
+ */ export function getYarnInfoPackageGraph(pkgDir, recurse) {
+    return _getYarnInfoPackageGraph.apply(this, arguments);
+}
+function _getYarnInfoPackageGraph() {
+    _getYarnInfoPackageGraph = _async_to_generator(function*(pkgDir, recurse) {
+        const query = execSync(`yarn info ${recurse ? "-R" : ""} --json`, {
+            cwd: pkgDir,
+            stdio: "pipe"
+        });
+        // Get the current package name so we can determine the root
+        const rootPkgJsonPath = getRootPackageJson(pkgDir);
+        let rootPkgName = "";
+        try {
+            rootPkgName = JSON.parse(readFileSync(rootPkgJsonPath).toString()).name;
+        } catch (e) {
+            console.error("Error retrieving root package name!");
+            throw e;
+        }
+        const packageGraph = new PackageGraph(pkgDir);
+        // Since the info shows multiple versions we keep a dedup set of the serialized key to avoid longer times
+        const dedupSet = new Set();
+        return query.toString().split("\n").reduce((pkgGraph, q)=>{
+            // Make sure we have an actual value
+            if (q.trim()) {
+                const pkgInfo = JSON.parse(q);
+                const { name, version, isPatch } = parsePackage(pkgInfo.value);
+                const nameKey = packageGraph.keySerializer({
+                    name,
+                    version
+                });
+                if (!dedupSet.has(nameKey)) {
+                    dedupSet.add(nameKey);
+                    // List of package names as dependencies
+                    let deps;
+                    if (recurse) {
+                        var _pkgInfo_children_Dependencies, _pkgInfo_children;
+                        var _pkgInfo_children_Dependencies_map;
+                        deps = (_pkgInfo_children_Dependencies_map = (_pkgInfo_children = pkgInfo.children) === null || _pkgInfo_children === void 0 ? void 0 : (_pkgInfo_children_Dependencies = _pkgInfo_children.Dependencies) === null || _pkgInfo_children_Dependencies === void 0 ? void 0 : _pkgInfo_children_Dependencies.map((deps)=>{
+                            const info = parsePackage(deps.locator);
+                            return {
+                                name: info.name,
+                                version: info.version
+                            };
+                        })) !== null && _pkgInfo_children_Dependencies_map !== void 0 ? _pkgInfo_children_Dependencies_map : [];
+                    } else {
+                        // We don't actually set up the dependencies because that would make the graph incomplete
+                        deps = [];
+                    }
+                    packageGraph.addDownstreamNode({
+                        self: {
+                            name,
+                            version
+                        },
+                        value: {
+                            name,
+                            version,
+                            isPatch,
+                            isRoot: name === rootPkgName
+                        },
+                        to: deps !== null && deps !== void 0 ? deps : []
+                    });
+                }
+            }
+            return pkgGraph;
+        }, packageGraph);
+    });
+    return _getYarnInfoPackageGraph.apply(this, arguments);
+}
+function parsePackage(pkgAndVersion) {
+    const versionIdx = pkgAndVersion.indexOf("@", 1);
+    if (versionIdx < 0) {
+        throw new Error(`could not find version from name: ${pkgAndVersion}`);
+    }
+    let version = pkgAndVersion.substring(versionIdx + 1);
+    // Parse out virtual versions since those are just file directors used by yarn
+    if (version.startsWith("virtual:")) {
+        const hashIdx = version.lastIndexOf("#");
+        if (hashIdx < 1) {
+            throw new Error(`could not find the expected # for virtual locator information`);
+        }
+        version = version.substring(hashIdx + 1);
+    }
+    return {
+        name: pkgAndVersion.substring(0, versionIdx),
+        version,
+        isPatch: version.includes("patch")
+    };
+}
+
+//# sourceMappingURL=getYarnInfoPackageGraph.mjs.map

package/dist/esm/packageGraphs/getYarnInfoPackageGraph.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/packageGraphs/getYarnInfoPackageGraph.ts"],"sourcesContent":["import { execSync } from \"child_process\";\nimport { PackageGraph, PackageInfoKey } from \"./PackageGraph\";\nimport { existsSync, readFileSync } from \"fs\";\nimport { dirname, join } from \"path\";\n\n/**\n * Gets the first package.json that can be found\n */\nfunction getRootPackageJson(start: string, curDir?: string) {\n\tconst dir = curDir ?? start;\n\tconst testPath = join(dir, \"package.json\");\n\tif (existsSync(testPath)) {\n\t\treturn testPath;\n\t}\n\tconst oneUp = dirname(dir);\n\n\tif (!oneUp) {\n\t\tthrow new Error(\n\t\t\t`Could not find package.json traveling up from start dir at ${start}`,\n\t\t);\n\t}\n\treturn getRootPackageJson(start, oneUp);\n}\n\n/**\n * Retrieves the dependencies for a package in a PackageGraph\n * @param pkgDir - the directory where the top-level package is\n * @param recurse - get all the packages through all immediate dependencies\n * @returns\n */\nexport async function getYarnInfoPackageGraph(\n\tpkgDir: string,\n\trecurse: boolean,\n): Promise<PackageGraph> {\n\tconst query = execSync(`yarn info ${recurse ? \"-R\" : \"\"} --json`, {\n\t\tcwd: pkgDir,\n\t\tstdio: \"pipe\",\n\t});\n\n\t// Get the current package name so we can determine the root\n\tconst rootPkgJsonPath = getRootPackageJson(pkgDir);\n\tlet rootPkgName = \"\";\n\ttry {\n\t\trootPkgName = JSON.parse(readFileSync(rootPkgJsonPath).toString()).name;\n\t} catch (e) {\n\t\tconsole.error(\"Error retrieving root package name!\");\n\t\tthrow e;\n\t}\n\n\tconst packageGraph = new PackageGraph(pkgDir);\n\t// Since the info shows multiple versions we keep a dedup set of the serialized key to avoid longer times\n\tconst dedupSet = new Set<string>();\n\n\treturn query\n\t\t.toString()\n\t\t.split(\"\\n\")\n\t\t.reduce((pkgGraph, q) => {\n\t\t\t// Make sure we have an actual value\n\t\t\tif (q.trim()) {\n\t\t\t\tconst pkgInfo = JSON.parse(q) as YamlInfoDeps;\n\t\t\t\tconst { name, version, isPatch } = parsePackage(pkgInfo.value);\n\t\t\t\tconst nameKey = packageGraph.keySerializer({\n\t\t\t\t\tname,\n\t\t\t\t\tversion,\n\t\t\t\t});\n\t\t\t\tif (!dedupSet.has(nameKey)) {\n\t\t\t\t\tdedupSet.add(nameKey);\n\t\t\t\t\t// List of package names as dependencies\n\t\t\t\t\tlet deps: PackageInfoKey[];\n\t\t\t\t\tif (recurse) {\n\t\t\t\t\t\tdeps =\n\t\t\t\t\t\t\tpkgInfo.children?.Dependencies?.map((deps) => {\n\t\t\t\t\t\t\t\tconst info = parsePackage(deps.locator);\n\t\t\t\t\t\t\t\treturn {\n\t\t\t\t\t\t\t\t\tname: info.name,\n\t\t\t\t\t\t\t\t\tversion: info.version,\n\t\t\t\t\t\t\t\t};\n\t\t\t\t\t\t\t}) ?? [];\n\t\t\t\t\t} else {\n\t\t\t\t\t\t// We don't actually set up the dependencies because that would make the graph incomplete\n\t\t\t\t\t\tdeps = [];\n\t\t\t\t\t}\n\t\t\t\t\tpackageGraph.addDownstreamNode({\n\t\t\t\t\t\tself: {\n\t\t\t\t\t\t\tname,\n\t\t\t\t\t\t\tversion,\n\t\t\t\t\t\t},\n\t\t\t\t\t\tvalue: {\n\t\t\t\t\t\t\tname,\n\t\t\t\t\t\t\tversion,\n\t\t\t\t\t\t\tisPatch,\n\t\t\t\t\t\t\tisRoot: name === rootPkgName,\n\t\t\t\t\t\t},\n\t\t\t\t\t\tto: deps ?? [],\n\t\t\t\t\t});\n\t\t\t\t}\n\t\t\t}\n\t\t\treturn pkgGraph;\n\t\t}, packageGraph);\n}\n\nfunction parsePackage(pkgAndVersion: string): {\n\tname: string;\n\tversion: string;\n\tisPatch: boolean;\n} {\n\tconst versionIdx = pkgAndVersion.indexOf(\"@\", 1);\n\tif (versionIdx < 0) {\n\t\tthrow new Error(`could not find version from name: ${pkgAndVersion}`);\n\t}\n\tlet version = pkgAndVersion.substring(versionIdx + 1);\n\t// Parse out virtual versions since those are just file directors used by yarn\n\tif (version.startsWith(\"virtual:\")) {\n\t\tconst hashIdx = version.lastIndexOf(\"#\");\n\t\tif (hashIdx < 1) {\n\t\t\tthrow new Error(\n\t\t\t\t`could not find the expected # for virtual locator information`,\n\t\t\t);\n\t\t}\n\t\tversion = version.substring(hashIdx + 1);\n\t}\n\treturn {\n\t\tname: pkgAndVersion.substring(0, versionIdx),\n\t\tversion,\n\t\tisPatch: version.includes(\"patch\"),\n\t};\n}\n\ninterface YamlInfoDeps {\n\tvalue: string;\n\tchildren?: {\n\t\tInstances: number;\n\t\tVersion: string;\n\t\tDependencies?: {\n\t\t\tdescriptor: string;\n\t\t\tlocator: string;\n\t\t}[];\n\t};\n}\n"],"names":["execSync","PackageGraph","existsSync","readFileSync","dirname","join","getRootPackageJson","start","curDir","dir","testPath","oneUp","Error","getYarnInfoPackageGraph","pkgDir","recurse","query","cwd","stdio","rootPkgJsonPath","rootPkgName","JSON","parse","toString","name","e","console","error","packageGraph","dedupSet","Set","split","reduce","pkgGraph","q","trim","pkgInfo","version","isPatch","parsePackage","value","nameKey","keySerializer","has","add","deps","children","Dependencies","map","info","locator","addDownstreamNode","self","isRoot","to","pkgAndVersion","versionIdx","indexOf","substring","startsWith","hashIdx","lastIndexOf","includes"],"mappings":"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"}

package/dist/esm/packageGraphs/index.mjs

@@ -0,0 +1,6 @@
+export * from "./types";
+export * from "./Graph";
+export * from "./PackageGraph";
+export * from "./getYarnInfoPackageGraph";
+
+//# sourceMappingURL=index.mjs.map

package/dist/esm/packageGraphs/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/packageGraphs/index.ts"],"sourcesContent":["export * from \"./types\";\nexport * from \"./Graph\";\nexport * from \"./PackageGraph\";\nexport * from \"./getYarnInfoPackageGraph\";\n"],"names":[],"mappings":"AAAA,cAAc,UAAU;AACxB,cAAc,UAAU;AACxB,cAAc,iBAAiB;AAC/B,cAAc,4BAA4B"}

package/dist/esm/packageGraphs/types.mjs

@@ -0,0 +1,8 @@
+/**
+ * A function that should return a Package Graph for the current package in the working directory
+ *
+ * @param pkgDir - the directory where the top-level package is
+ * @param recurse - if we should get all dependencies of the direct dependencies as well
+ */ export { };
+
+//# sourceMappingURL=types.mjs.map

package/dist/esm/packageGraphs/types.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/packageGraphs/types.ts"],"sourcesContent":["import { PackageGraph } from \"./PackageGraph\";\n\n/**\n * A function that should return a Package Graph for the current package in the working directory\n *\n * @param pkgDir - the directory where the top-level package is\n * @param recurse - if we should get all dependencies of the direct dependencies as well\n */\nexport type GetPackagesGraphFn = (recurse: boolean) => Promise<PackageGraph>;\n"],"names":[],"mappings":"AAEA;;;;;CAKC,GACD,WAA6E"}

package/dist/types/bin/get-esm-packages.d.ts

@@ -0,0 +1,2 @@
+export declare function writeESMModuleOutput(packages: string[], file: string): void;
+//# sourceMappingURL=get-esm-packages.d.ts.map

package/dist/types/bin/get-esm-packages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-esm-packages.d.ts","sourceRoot":"","sources":["../../../src/bin/get-esm-packages.ts"],"names":[],"mappings":"AA6EA,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,QAYpE"}

package/dist/types/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./operations";
+export * from "./packageGraphs";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC"}

package/dist/types/operations/getESMPackages.d.ts

@@ -0,0 +1,8 @@
+import { PackageGraph } from "../packageGraphs";
+/**
+ * Returns the esm packages from a PackageGraph - Assumes we can read package.json (may not work with yarn plug'n'play)
+ * @param pkgGraph
+ * @returns
+ */
+export declare function getESMPackages(pkgGraph: PackageGraph): Promise<string[]>;
+//# sourceMappingURL=getESMPackages.d.ts.map

package/dist/types/operations/getESMPackages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getESMPackages.d.ts","sourceRoot":"","sources":["../../../src/operations/getESMPackages.ts"],"names":[],"mappings":"AAEA,OAAO,EACN,YAAY,EAIZ,MAAM,kBAAkB,CAAC;AAiD1B;;;;GAIG;AACH,wBAAsB,cAAc,CAAC,QAAQ,EAAE,YAAY,qBAgE1D"}

package/dist/types/operations/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./getESMPackages";
+export * from "./jest";
+//# sourceMappingURL=index.d.ts.map

package/dist/types/operations/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/operations/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,QAAQ,CAAC"}

package/dist/types/operations/jest.d.ts

@@ -0,0 +1,40 @@
+export interface EsmPackagesFile {
+    description: string;
+    /**
+     * Package names that are esm modules
+     */
+    packages: string[];
+}
+/**
+ * You can use this function to get get a transformIgnore pattern for jest that excludes node_modules
+ * from a file where we have written all esm files that were detected.
+ *
+ * This is specifically designed for a "post-install" script that scans on install and overwrites the file
+ * if there are new esm module types - thereby reducing the cost of tests to just a file read instead of a
+ * tree scan.
+ *
+ * @param options
+ * @returns
+ */
+export declare function getJestNodeModulesTransformIgnore(options: {
+    /**
+     * The file location where we have written the esm module info to
+     *
+     * default (esm-modules.json)
+     */
+    file: string;
+    /**
+     * Extra packages for an exception for node modules
+     */
+    extraExceptions?: string[];
+}): string;
+/**
+ * Given a set of package names, this constructs a node_modules ignore string that exempts the
+ * targeted modules from jest transform.
+ *
+ * It should be used with the transformIgnore configuration.
+ * @param packageExceptions
+ * @returns
+ */
+export declare function createNodeModulesTransformIgnore(packageExceptions: string[]): string;
+//# sourceMappingURL=jest.d.ts.map

package/dist/types/operations/jest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jest.d.ts","sourceRoot":"","sources":["../../../src/operations/jest.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,eAAe;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB;;OAEG;IACH,QAAQ,EAAE,MAAM,EAAE,CAAC;CACnB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,iCAAiC,CAAC,OAAO,EAAE;IAC1D;;;;OAIG;IACH,IAAI,EAAE,MAAM,CAAC;IACb;;OAEG;IACH,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;CAC3B,UAMA;AAmBD;;;;;;;GAOG;AACH,wBAAgB,gCAAgC,CAAC,iBAAiB,EAAE,MAAM,EAAE,UAE3E"}

package/dist/types/packageGraphs/Graph.d.ts

@@ -0,0 +1,72 @@
+/**
+ * Describes a node in a graph that has a value of a specific type
+ * and then points to values of others nodes
+ */
+export interface Node<T, NodeKey> {
+    self: NodeKey;
+    from: NodeKey[];
+    to: NodeKey[];
+    value: T;
+}
+/**
+ * A node that we only know where it goes to at the moment
+ */
+export interface DownstreamNode<T, NodeKey> {
+    self: NodeKey;
+    value: T;
+    to: NodeKey[];
+}
+/**
+ * If using a compound node key, then we require a node key serializer to get a base string out of it
+ */
+type NodeKeySerializer<T> = T extends string ? undefined : (t: T) => string;
+/**
+ * Mnimal "graph" class that takes in a bunch of nodes and then allows you to visit them in a particular order.
+ *
+ * The value of the node <T> is used as the unique node key for referencing other nodes.
+ */
+export declare class Graph<T, NodeKey, NKSerializer extends NodeKeySerializer<NodeKey> = NodeKeySerializer<NodeKey>> {
+    readonly map: Map<string, Node<T | undefined, NodeKey>>;
+    private readonly noFrom;
+    readonly keySerializer: NKSerializer;
+    /**
+     *
+     * @param keySerializer - if the graph has a compound key, then you must supply a function that converts a compound key to a string
+     */
+    constructor(keySerializer: NKSerializer);
+    private getNodeKeyStr;
+    addDownstreamNode(node: DownstreamNode<T, NodeKey>): void;
+    validate(): void;
+    /**
+     *
+     * @param visit
+     * @param firstArrivalOnly - if set to true, we are saying that we do not care about from where we get to the node, just the first arrival matters
+     *                           This will depend on your visit function, since the visit function can pass parent -> child info that may change based on the node
+     *                           it is coming from
+     */
+    topDownVisitAsync<R>(visit: VisitFunction<Node<T, NodeKey>, R>, firstArrivalOnly?: boolean): Promise<void>;
+    /**
+     *
+     * @param nodeKey - the key that we used to retrieve this node
+     * @param node - the node itself
+     * @param visit - the visit function
+     * @param guestBook - This is used to track if we have already visited the node - note this means we don't expect the visit function to change results
+     *                    regardless of the node that we come from
+     * @param prevResult - the result of the last node that got here
+     * @returns
+     */
+    visitDownNodeAsync<R>(node: Node<T, NodeKey>, visit: VisitFunction<Node<T, NodeKey>, R>, guestBook?: Set<string>, prevResult?: R): Promise<void>;
+}
+type StopVisiting = boolean;
+/**
+ * This function will be called for each visit while traversing along the "to" nodes.  You can return
+ * a result from the visit function that will be provided to any of the "to" visitors as the previous result.
+ *
+ * Additionally, if you return a boolean value in the second tuple, it can stop any further downstream visits from this
+ * particular visitor function.  (Keep in mind that a visitor can only stop further travel from itself, so if there are
+ * multiple visits from multiple nodes each visitor will need to stop further travel.  If you do use a guestbook, in a
+ * visiting function, that would stop travel fromm the visitor function that first calls stop.)
+ */
+type VisitFunction<Node, R> = (currentNode: Node, previousResult?: R) => Promise<[R, StopVisiting]>;
+export {};
+//# sourceMappingURL=Graph.d.ts.map

package/dist/types/packageGraphs/Graph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Graph.d.ts","sourceRoot":"","sources":["../../../src/packageGraphs/Graph.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,WAAW,IAAI,CAAC,CAAC,EAAE,OAAO;IAC/B,IAAI,EAAE,OAAO,CAAC;IACd,IAAI,EAAE,OAAO,EAAE,CAAC;IAChB,EAAE,EAAE,OAAO,EAAE,CAAC;IACd,KAAK,EAAE,CAAC,CAAC;CACT;AAED;;GAEG;AACH,MAAM,WAAW,cAAc,CAAC,CAAC,EAAE,OAAO;IACzC,IAAI,EAAE,OAAO,CAAC;IACd,KAAK,EAAE,CAAC,CAAC;IACT,EAAE,EAAE,OAAO,EAAE,CAAC;CACd;AAED;;GAEG;AACH,KAAK,iBAAiB,CAAC,CAAC,IAAI,CAAC,SAAS,MAAM,GAAG,SAAS,GAAG,CAAC,CAAC,EAAE,CAAC,KAAK,MAAM,CAAC;AAE5E;;;;GAIG;AACH,qBAAa,KAAK,CACjB,CAAC,EACD,OAAO,EACP,YAAY,SAAS,iBAAiB,CAAC,OAAO,CAAC,GAAG,iBAAiB,CAAC,OAAO,CAAC;IAG5E,QAAQ,CAAC,GAAG,4CAAmD;IAC/D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAqB;IAC5C,QAAQ,CAAC,aAAa,EAAE,YAAY,CAAC;IAErC;;;OAGG;gBACS,aAAa,EAAE,YAAY;IAIvC,OAAO,CAAC,aAAa;IAMrB,iBAAiB,CAAC,IAAI,EAAE,cAAc,CAAC,CAAC,EAAE,OAAO,CAAC;IA0ClD,QAAQ;IAcR;;;;;;OAMG;IACG,iBAAiB,CAAC,CAAC,EACxB,KAAK,EAAE,aAAa,CAAC,IAAI,CAAC,CAAC,EAAE,OAAO,CAAC,EAAE,CAAC,CAAC,EACzC,gBAAgB,CAAC,EAAE,OAAO;IAS3B;;;;;;;;;OASG;IACG,kBAAkB,CAAC,CAAC,EACzB,IAAI,EAAE,IAAI,CAAC,CAAC,EAAE,OAAO,CAAC,EACtB,KAAK,EAAE,aAAa,CAAC,IAAI,CAAC,CAAC,EAAE,OAAO,CAAC,EAAE,CAAC,CAAC,EACzC,SAAS,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,EACvB,UAAU,CAAC,EAAE,CAAC;CAsBf;AAED,KAAK,YAAY,GAAG,OAAO,CAAC;AAE5B;;;;;;;;GAQG;AACH,KAAK,aAAa,CAAC,IAAI,EAAE,CAAC,IAAI,CAC7B,WAAW,EAAE,IAAI,EACjB,cAAc,CAAC,EAAE,CAAC,KACd,OAAO,CAAC,CAAC,CAAC,EAAE,YAAY,CAAC,CAAC,CAAC"}

package/dist/types/packageGraphs/PackageGraph.d.ts

@@ -0,0 +1,19 @@
+import { Graph } from "./Graph";
+export interface PackageInfo {
+    name: string;
+    version: string;
+    isPatch: boolean;
+    isRoot: boolean;
+}
+export interface PackageInfoKey {
+    name: string;
+    version: string;
+}
+/**
+ * A graph of package names and their dependencies
+ */
+export declare class PackageGraph extends Graph<PackageInfo, PackageInfoKey> {
+    readonly pkgDir: string;
+    constructor(pkgDir: string);
+}
+//# sourceMappingURL=PackageGraph.d.ts.map

package/dist/types/packageGraphs/PackageGraph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PackageGraph.d.ts","sourceRoot":"","sources":["../../../src/packageGraphs/PackageGraph.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAEhC,MAAM,WAAW,WAAW;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAEhB,OAAO,EAAE,OAAO,CAAC;IAEjB,MAAM,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,cAAc;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,qBAAa,YAAa,SAAQ,KAAK,CAAC,WAAW,EAAE,cAAc,CAAC;IACnE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;gBACZ,MAAM,EAAE,MAAM;CAQ1B"}

package/dist/types/packageGraphs/getYarnInfoPackageGraph.d.ts

@@ -0,0 +1,9 @@
+import { PackageGraph } from "./PackageGraph";
+/**
+ * Retrieves the dependencies for a package in a PackageGraph
+ * @param pkgDir - the directory where the top-level package is
+ * @param recurse - get all the packages through all immediate dependencies
+ * @returns
+ */
+export declare function getYarnInfoPackageGraph(pkgDir: string, recurse: boolean): Promise<PackageGraph>;
+//# sourceMappingURL=getYarnInfoPackageGraph.d.ts.map

package/dist/types/packageGraphs/getYarnInfoPackageGraph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getYarnInfoPackageGraph.d.ts","sourceRoot":"","sources":["../../../src/packageGraphs/getYarnInfoPackageGraph.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAkB,MAAM,gBAAgB,CAAC;AAuB9D;;;;;GAKG;AACH,wBAAsB,uBAAuB,CAC5C,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,OAAO,GACd,OAAO,CAAC,YAAY,CAAC,CAkEvB"}

package/dist/types/packageGraphs/index.d.ts

@@ -0,0 +1,5 @@
+export * from "./types";
+export * from "./Graph";
+export * from "./PackageGraph";
+export * from "./getYarnInfoPackageGraph";
+//# sourceMappingURL=index.d.ts.map

package/dist/types/packageGraphs/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/packageGraphs/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,SAAS,CAAC;AACxB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,2BAA2B,CAAC"}

package/dist/types/packageGraphs/types.d.ts

@@ -0,0 +1,9 @@
+import { PackageGraph } from "./PackageGraph";
+/**
+ * A function that should return a Package Graph for the current package in the working directory
+ *
+ * @param pkgDir - the directory where the top-level package is
+ * @param recurse - if we should get all dependencies of the direct dependencies as well
+ */
+export type GetPackagesGraphFn = (recurse: boolean) => Promise<PackageGraph>;
+//# sourceMappingURL=types.d.ts.map

package/dist/types/packageGraphs/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/packageGraphs/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE9C;;;;;GAKG;AACH,MAAM,MAAM,kBAAkB,GAAG,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,YAAY,CAAC,CAAC"}

package/package.json

@@ -0,0 +1,64 @@
+{
+	"name": "@hanseltime/esm-interop-tools",
+	"main": "dist/cjs/index.js",
+	"types": "dist/types/index.d.ts",
+	"bin": {
+		"get-esm-packages": "dist/bin/get-esm-packages.js"
+	},
+	"exports": {
+		".": {
+			"require": "./dist/cjs/index.js",
+			"import": "./dist/esm/index.mjs",
+			"types": "./dist/types/index.d.ts"
+		}
+	},
+	"files": [
+		"dist",
+		"README.md"
+	],
+	"scripts": {
+		"build:esm": "tswc -- src -d dist/esm --config-file .esm.swcrc --strip-leading-paths --out-file-extension mjs",
+		"build:cjs": "tswc -- src -d dist/cjs --config-file .cjs.swcrc --strip-leading-paths",
+		"build:bin": "rspack build",
+		"build:types": "tsc",
+		"build": "yarn build:types && yarn build:esm && yarn build:cjs && yarn build:bin",
+		"lint": "biome lint",
+		"format": "biome format",
+		"test": "jest --passWithNoTests",
+		"ts-run": "./bin/ts-run.sh",
+		"release": "yarn semantic-release",
+		"get-esm-packages": "yarn ts-run src/bin/get-esm-packages.ts"
+	},
+	"devDependencies": {
+		"@biomejs/biome": "1.9.4",
+		"@commitlint/config-angular": "^19.6.0",
+		"@hanseltime/swc-plugin-node-globals-inject": "^1.0.0",
+		"@rspack/cli": "^1.1.6",
+		"@rspack/core": "^1.1.6",
+		"@semantic-release/changelog": "^6.0.3",
+		"@semantic-release/git": "^10.0.1",
+		"@swc/cli": "^0.5.2",
+		"@swc/core": "^1.10.1",
+		"@types/jest": "^29.5.14",
+		"@types/node": "^18",
+		"commitlint": "^19.6.1",
+		"husky": "^9.1.7",
+		"jest": "^29.7.0",
+		"jest-chain-transform": "^0.0.8",
+		"semantic-release": "^24.2.0",
+		"ts-jest": "^29.2.5",
+		"ts-node": "^10.9.2",
+		"tswc": "^1.4.0",
+		"tsx": "^4.19.2",
+		"typescript": "^5.0.0"
+	},
+	"dependencies": {
+		"commander": "^12.1.0",
+		"resolve-package-path": "^4.0.3"
+	},
+	"publishConfig": {
+		"access": "public"
+	},
+	"packageManager": "yarn@4.5.3",
+	"version": "1.0.0"
+}