@arcgis/codemod 5.2.0-next.98 → 6.0.0-next.0

package/dist/chunks/sync.js

@@ -0,0 +1,165 @@
+import { readFile as f } from "node:fs/promises";
+import { log as h } from "@arcgis/toolkit/log";
+import { a as m, b as g, d as c, e as d } from "./format.js";
+import { collectOutput as u } from "@arcgis/node-toolkit/shell";
+class l {
+  constructor(s, e = !1) {
+    this.changes = [], this.#i = /* @__PURE__ */ new Map(), this.#n = -1;
+    const [i, t, o, ...r] = s.split("/");
+    if (i === void 0 || t === void 0 || o === void 0 || r.length > 0)
+      throw new Error(`Invalid repository: ${s}`);
+    this.#e = i, this.#s = `${t}/${o}`, this.dryRun = e;
+  }
+  #e;
+  #s;
+  #i;
+  #n;
+  async #t(s, e, i) {
+    if (process.env.VITEST !== void 0)
+      throw new Error("GitHub requests are disabled while running Vitest.");
+    const t = await u(
+      "gh",
+      ["api", "--hostname", this.#e, "--method", s, e, ...i === void 0 ? [] : ["--input", "-"]],
+      i === void 0 ? {} : { input: JSON.stringify(i) }
+    );
+    return t === "" ? void 0 : JSON.parse(t);
+  }
+  async listOpenIssues(s) {
+    const e = await u("gh", [
+      "api",
+      "--hostname",
+      this.#e,
+      "--method",
+      "GET",
+      "--paginate",
+      "--slurp",
+      "-f",
+      `q="${s}" in:title repo:${this.#s} is:issue is:open`,
+      "-f",
+      "per_page=100",
+      "/search/issues"
+    ]);
+    return JSON.parse(e).flatMap(({ items: i }) => i);
+  }
+  async createIssue(s, e, i, t) {
+    if (this.dryRun) {
+      const o = this.#n--;
+      return this.#i.set(o, s), this.changes.push(`CREATE issue: ${s}`), { number: o, title: s, body: e, assignees: i.map((r) => ({ login: r })) };
+    }
+    return await this.#t("POST", `/repos/${this.#s}/issues`, {
+      title: s,
+      body: e,
+      assignees: i,
+      labels: t,
+      type: m
+    });
+  }
+  async updateIssueBody(s, e) {
+    if (this.dryRun) {
+      this.changes.push(`UPDATE issue #${s} body`);
+      return;
+    }
+    await this.#t("PATCH", `/repos/${this.#s}/issues/${s}`, { body: e });
+  }
+  async listComments(s) {
+    if (this.#i.has(s))
+      return [];
+    const e = await u("gh", [
+      "api",
+      "--hostname",
+      this.#e,
+      "--method",
+      "GET",
+      "--paginate",
+      "--slurp",
+      `/repos/${this.#s}/issues/${s}/comments?per_page=100`
+    ]);
+    return JSON.parse(e).flat();
+  }
+  async createComment(s, e) {
+    if (this.dryRun) {
+      const i = this.#i.get(s), t = i === void 0 ? `issue #${s}` : `new issue: ${i}`;
+      this.changes.push(`ADD comment to ${t}`);
+      return;
+    }
+    await this.#t("POST", `/repos/${this.#s}/issues/${s}/comments`, { body: e });
+  }
+  async updateComment(s, e) {
+    if (this.dryRun) {
+      this.changes.push(`UPDATE comment #${s}`);
+      return;
+    }
+    await this.#t("PATCH", `/repos/${this.#s}/issues/comments/${s}`, { body: e });
+  }
+  async deleteComment(s) {
+    if (this.dryRun) {
+      this.changes.push(`REMOVE comment #${s}`);
+      return;
+    }
+    await this.#t("DELETE", `/repos/${this.#s}/issues/comments/${s}`);
+  }
+}
+async function k(n, s, e = 0, i, t = []) {
+  const o = w(await f(n, "utf8")), r = y(g(o), e, i), a = new l(o.repository, s);
+  await $(r, a, t), s && process.stdout.write(`${E(r)}
+`);
+}
+function y(n, s, e) {
+  return n.slice(s, e === void 0 ? void 0 : s + e);
+}
+async function $(n, s, e = []) {
+  const i = /* @__PURE__ */ new Map();
+  for (const t of n) {
+    let o = i.get(t.title);
+    o === void 0 && (o = await s.listOpenIssues(t.title), i.set(t.title, o));
+    const r = I(o, t);
+    let a;
+    r === void 0 ? (a = (await s.createIssue(t.title, t.chunks[0], t.assignees, e)).number, s.dryRun || h("info", c, `Created issue #${a}: ${t.title}`)) : (a = r.number, r.body !== t.chunks[0] && (await s.updateIssueBody(a, t.chunks[0]), s.dryRun || h("info", c, `Updated issue #${a}: ${t.title}`))), await T(s, a, t.chunks.slice(1)), t.changes.push(...s.changes.splice(0));
+  }
+}
+function w(n) {
+  const s = JSON.parse(n);
+  if (s.kind !== "usages" && s.kind !== "definitions" || typeof s.repository != "string" || typeof s.ref != "string" || !Array.isArray(s.findings))
+    throw new Error("Invalid deprecation audit JSON.");
+  return s;
+}
+function E(n) {
+  return n.map(
+    (s) => `ACTIONS: ${s.changes.length === 0 ? "No changes" : s.changes.join("; ")}
+
+CODEOWNERS: ${s.owners.length === 0 ? "unowned" : s.owners.join(", ")}
+ASSIGNEES: ${s.assignees.length === 0 ? "none" : s.assignees.join(", ")}
+TITLE: ${s.title}
+
+${s.chunks.map((e, i) => `--- ${i === 0 ? "BODY" : "COMMENT"} (${i + 1}/${s.chunks.length}) ---
+${e}`).join(`
+
+`)}`
+  ).join(`
+
+`);
+}
+function I(n, s) {
+  const e = p(s.chunks[0]);
+  return n.find((i) => i.title === s.title && p(i.body) === e);
+}
+function p(n) {
+  const s = n?.split(`
+`, 1)[0];
+  return s?.startsWith(d) === !0 ? s : void 0;
+}
+async function T(n, s, e) {
+  const i = (await n.listComments(s)).filter(({ body: t }) => t.startsWith(d));
+  for (const [t, o] of e.entries()) {
+    const r = i[t];
+    r === void 0 ? await n.createComment(s, o) : r.body !== o && await n.updateComment(r.id, o);
+  }
+  for (const t of i.slice(e.length))
+    await n.deleteComment(t.id);
+}
+export {
+  E as formatDryRun,
+  y as sliceIssuePlans,
+  k as syncDeprecationIssues,
+  $ as synchronizeIssuePlans
+};

package/dist/chunks/useProjectInstance.js

@@ -0,0 +1,51 @@
+import { Project as p } from "ts-morph";
+import { log as d } from "@arcgis/toolkit/log";
+import { path as a } from "@arcgis/node-toolkit/path";
+import { g as i, a as m } from "./cli.js";
+import { styleText as s } from "node:util";
+function v(e, l = !0) {
+  if (i.project !== void 0)
+    throw Error(
+      "A different ts-morph Project is already in use. Dispose of it before creating a new one. Example: using project = createProjectInstance(...)"
+    );
+  const n = i.codemod.meta.needsTypeInformation, t = new p({
+    // If tsconfig is missing, or project is untyped, use a permissive and
+    // compatible default config
+    compilerOptions: e.typeScriptConfig?.compilerOptions ?? {
+      ...m,
+      // Read types from JSDoc annotations if present
+      checkJs: n
+    },
+    // We take care of reading the config file
+    tsConfigFilePath: void 0,
+    // We add files manually below
+    skipAddingFilesFromTsConfig: !0,
+    // We call this manually if needed below.
+    skipFileDependencyResolution: !0,
+    skipLoadingLibFiles: !n
+  }), f = e.filePaths.flatMap((o) => {
+    const c = t.addSourceFileAtPathIfExists(o);
+    return c === void 0 ? [] : [c];
+  });
+  if (n && t.resolveSourceFileDependencies(), l) {
+    const o = a.relative(process.cwd(), e.cwd);
+    process.stdout.write(""), d(
+      "info",
+      s("blue", o === "" ? process.cwd() : o),
+      `Running the codemod on ${s("blue", String(e.filePaths.length))} file${e.filePaths.length !== 1 ? "s" : ""}${e.packageJson?.contents.name === void 0 ? "" : ` from ${s("blue", e.packageJson.contents.name)}`}`
+    );
+  }
+  const r = {
+    [Symbol.dispose]() {
+      t.saveSync(), t.getRootDirectories().forEach((o) => o.forget()), i.project = void 0;
+    },
+    projectData: e,
+    // Resolved dependencies support type checking but are not codemod targets.
+    getCodemodFiles: () => f,
+    tsMorph: t
+  };
+  return i.project = r, r;
+}
+export {
+  v as c
+};

package/dist/cli.js

@@ -1,6 +1,7 @@
-import "./cli-x1Uhjnb_.js";
+import "./chunks/cli.js";
 import "@arcgis/toolkit/log";
 import "@commander-js/extra-typings";
-import "node:fs";
+import "node:fs/promises";
 import "@arcgis/node-toolkit/path";
+import "@arcgis/node-toolkit/file";
 import "node:util";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@arcgis/codemod",
-  "version": "5.2.0-next.98",
+  "version": "6.0.0-next.0",
   "description": "A codemod toolkit for updating and modernizing ArcGIS Maps SDK for JavaScript codebases.",
   "type": "module",
   "exports": {
@@ -11,9 +11,9 @@
   ],
   "license": "SEE LICENSE IN LICENSE.md",
   "dependencies": {
-    "@arcgis/api-extractor": "5.2.0-next.98",
-    "@arcgis/node-toolkit": "5.2.0-next.98",
-    "@arcgis/toolkit": "5.2.0-next.98",
+    "@arcgis/api-extractor": "6.0.0-next.0",
+    "@arcgis/node-toolkit": "6.0.0-next.0",
+    "@arcgis/toolkit": "6.0.0-next.0",
     "@commander-js/extra-typings": "^15.0.0",
     "commander": "^15.0.0",
     "tinyglobby": "~0.2.17",

package/dist/actions-CE74rP-z.js

@@ -1,354 +0,0 @@
-import { path as T } from "@arcgis/node-toolkit/path";
-import { SyntaxKind as g } from "ts-morph";
-import { g as x } from "./cli-x1Uhjnb_.js";
-import { ModuleResolutionKind as D } from "typescript";
-import { capitalize as S } from "@arcgis/toolkit/string";
-import { log as q } from "@arcgis/toolkit/log";
-function w(e) {
-  const n = e.typeScriptConfig?.compilerOptions?.moduleResolution ?? D.Bundler;
-  return n >= D.Node16 && n <= D.NodeNext;
-}
-function b(e) {
-  return C(e.getFilePath());
-}
-function C(e) {
-  return T.relative(process.cwd(), e);
-}
-function J(e, n) {
-  const o = {};
-  K(e);
-  const { specifiers: l, names: u, lastImportIndex: a } = A(e), d = [], t = {};
-  let c = w(x.project.projectData);
-  for (const [i, m] of Object.entries(n)) {
-    let s = l.get(i) ?? (i.startsWith(".") ? l.get(
-      T.relative(e.getDirectoryPath(), T.resolve(x.project.projectData.cwd, i))
-    ) : void 0);
-    if (s === void 0) {
-      const f = l.get(`${i}.js`);
-      f !== void 0 && (c = !0, s === void 0 ? s = f : s = [...s, ...f]);
-    }
-    for (const [f, y] of Object.entries(m)) {
-      const N = Array.isArray(y) ? y : [y];
-      for (const I of N)
-        I.do === "deprecate" ? P(f, i, o, s) : I.do === "add" ? E(i, f, I, s, d, t, u) : I.do === "rename" && W(i, f, I, s, d, t, u);
-    }
-  }
-  const p = Object.entries(t);
-  let r = a;
-  for (let i = 0; i < p.length; i += 1) {
-    const [m, s] = p[i], f = m.startsWith(".") ? M(
-      T.relative(e.getDirectoryPath(), T.resolve(x.project.projectData.cwd, m))
-    ) : m, y = c && f.startsWith("@arcgis/core") ? `${f}.js` : f, N = s.afterDeclaration === void 0 ? r : s.afterDeclaration.getChildIndex() + 1;
-    if (s.named.length > 0) {
-      let I = !0;
-      for (let v = 0; v < s.named.length; v += 1)
-        I &&= s.named[v].isTypeOnly;
-      e.insertImportDeclaration(N, {
-        isTypeOnly: I,
-        moduleSpecifier: y,
-        namedImports: s.named.map((v) => ({
-          name: v.name,
-          alias: v.alias,
-          isTypeOnly: v.isTypeOnly && !I
-        }))
-      }), r += 1;
-    }
-    s.default !== void 0 && (e.insertImportDeclaration(N, {
-      isTypeOnly: s.default.isTypeOnly,
-      moduleSpecifier: y,
-      defaultImport: s.default.name
-    }), r += 1), s["*"] !== void 0 && (e.insertImportDeclaration(N, {
-      isTypeOnly: s["*"].isTypeOnly,
-      moduleSpecifier: y,
-      namespaceImport: s["*"].name
-    }), r += 1);
-  }
-  if (Object.keys(o).length > 0) {
-    const i = Object.entries(o).map(([m, s]) => `${s.join(", ")} from ${m}`).join("; ");
-    q("warn", b(e), `Deprecated API usages found: ${i}`);
-  }
-  return d;
-}
-function K(e) {
-  const n = e.getChildSyntaxList()?.getFirstChild();
-  if (j === n)
-    return;
-  j = n, h.clear();
-  const o = /* @__PURE__ */ new Set();
-  l(e);
-  function l(u) {
-    for (const a of u.getStatements())
-      if (a.isKind(g.ImportDeclaration)) {
-        const d = a.getDefaultImport(), t = a.getNamespaceImport(), c = a.getNamedImports();
-        d && o.add(d.getText()), t && o.add(t.getText());
-        for (const p of c)
-          o.add(p.getAliasNode()?.getText() ?? p.getName());
-      } else a.isKind(g.ImportEqualsDeclaration) ? o.add(a.getName()) : a.isKind(g.ModuleDeclaration) ? l(a) : u.forEachDescendant((d) => {
-        if (!d.isKind(g.Identifier))
-          return;
-        const t = d.getParent();
-        if (t.isKind(g.QualifiedName) && t.getLeft() !== d || t.isKind(g.PropertyAccessExpression) && t.getExpression() !== d || (t.isKind(g.PropertyDeclaration) || t.isKind(g.PropertySignature) || t.isKind(g.PropertyAssignment)) && t.getNameNode() === d)
-          return;
-        const c = d.getText();
-        o.has(c) || h.add(d.getText());
-      });
-  }
-}
-function A(e) {
-  const n = /* @__PURE__ */ new Map(), o = /* @__PURE__ */ new Set(), l = e.getStatements();
-  let u;
-  for (let d = 0; d < l.length; d += 1) {
-    const t = l[d];
-    if (!t.isKind(g.ImportDeclaration)) {
-      const f = t.getName?.();
-      f !== void 0 && o.add(f);
-      continue;
-    }
-    u = t;
-    const c = t.getModuleSpecifierValue(), p = n.get(c);
-    p === void 0 ? n.set(c, [t]) : p.push(t);
-    const r = t.getImportClause();
-    if (r === void 0)
-      continue;
-    const i = r.getDefaultImport()?.getText();
-    i !== void 0 && o.add(i);
-    const m = r.getNamedBindings();
-    if (m !== void 0)
-      if (m.isKind(g.NamedImports))
-        for (const s of m.getElements()) {
-          const f = s.getName();
-          o.add(f);
-        }
-      else {
-        const s = m.getName();
-        o.add(s);
-      }
-  }
-  const a = u === void 0 ? 0 : u.getChildIndex() + 1;
-  return { specifiers: n, names: o, lastImportIndex: a };
-}
-function P(e, n, o, l) {
-  if (l !== void 0) {
-    if (e === "default")
-      for (const u of l) {
-        const a = u.getDefaultImport();
-        if (a !== void 0) {
-          o[n] ??= [], o[n].push(a.getText());
-          return;
-        }
-      }
-    else if (e === "*")
-      for (const u of l) {
-        const a = u.getNamespaceImport();
-        if (a !== void 0) {
-          o[n] ??= [], o[n].push(a.getText());
-          return;
-        }
-      }
-    else
-      for (const u of l)
-        for (const a of u.getNamedImports())
-          if (a.getName() === e) {
-            o[n] ??= [], o[n].push(a.getName());
-            return;
-          }
-  }
-}
-function E(e, n, o, l, u, a, d) {
-  const t = n === "default";
-  if (t || n === "*") {
-    if (l !== void 0)
-      for (const p of l) {
-        const r = t ? p.getDefaultImport() : p.getNamespaceImport();
-        if (r !== void 0) {
-          o.isTypeOnly !== !0 && p.isTypeOnly() && p.setIsTypeOnly(!1), u.push({
-            specifier: e,
-            requestedName: n,
-            actualName: r.getText()
-          });
-          return;
-        }
-      }
-    const c = O(o.preferredAlias, void 0, e, d);
-    u.push({ specifier: e, requestedName: n, actualName: c }), a[e] ??= {
-      afterDeclaration: void 0,
-      named: [],
-      default: void 0,
-      "*": void 0
-    }, a[e].afterDeclaration ??= l?.[0], a[e][n] = {
-      name: c,
-      isTypeOnly: o.isTypeOnly === !0
-    };
-  } else {
-    let c, p;
-    if (l !== void 0) {
-      let m = !1;
-      for (const s of l)
-        if (s.getNamespaceImport() === void 0) {
-          p ??= s, c ??= s.isTypeOnly() && s.getDefaultImport() === void 0 ? s : void 0;
-          for (const f of s.getNamedImports())
-            if (f.getNameNode().getText() === n) {
-              if (m = !0, o.isTypeOnly !== !0) {
-                if (f.isTypeOnly())
-                  f.setIsTypeOnly(!1);
-                else if (s.isTypeOnly()) {
-                  for (const y of s.getNamedImports())
-                    y !== f && y.setIsTypeOnly(!0);
-                  s.setIsTypeOnly(!1);
-                }
-              }
-              u.push({
-                specifier: e,
-                requestedName: n,
-                actualName: f.getAliasNode()?.getText() ?? n
-              });
-              break;
-            }
-        }
-      if (m)
-        return;
-    }
-    const r = O(
-      o.preferAlias === !0 ? o.preferredAlias : n,
-      o.preferAlias === !0 ? n : o.preferredAlias,
-      e,
-      d
-    ), i = n === r ? void 0 : r;
-    if (o.isTypeOnly && c !== void 0)
-      c.addNamedImport({
-        name: n,
-        alias: i
-      });
-    else if (p !== void 0 && (!o.isTypeOnly || p.getDefaultImport() === void 0)) {
-      if (p.isTypeOnly() && !o.isTypeOnly) {
-        p.setIsTypeOnly(!1);
-        for (const m of p.getNamedImports())
-          m.setIsTypeOnly(!0);
-      }
-      p.addNamedImport({
-        name: n,
-        alias: i,
-        isTypeOnly: o.isTypeOnly && !p.isTypeOnly()
-      });
-    } else
-      a[e] ??= {
-        afterDeclaration: void 0,
-        named: [],
-        default: void 0,
-        "*": void 0
-      }, a[e].afterDeclaration ??= l?.[0], a[e].named.push({
-        name: n,
-        alias: i,
-        isTypeOnly: o.isTypeOnly === !0
-      });
-    u.push({ specifier: e, requestedName: n, actualName: r });
-  }
-}
-function W(e, n, o, l, u, a, d) {
-  if (l === void 0)
-    return;
-  const t = o.name ?? n, c = o.specifier ?? e, p = n === "default";
-  if (p || n === "*") {
-    for (const r of l) {
-      const i = p ? r.getDefaultImport() : r.getNamespaceImport();
-      if (i === void 0)
-        continue;
-      if (o.isTypeOnly === !1 && r.isTypeOnly()) {
-        r.setIsTypeOnly(!1);
-        for (const s of r.getNamedImports())
-          s.setIsTypeOnly(!0);
-      }
-      let m = t;
-      if (t !== n) {
-        const s = O(t, n, e, d);
-        t === s ? i.rename(t) : m = i.getText();
-      } else
-        m = i.getText();
-      e !== c && (r.getNamedImports().length === 0 ? r.setModuleSpecifier(c) : (p ? r.removeDefaultImport() : r.removeNamespaceImport(), a[c] ??= {
-        afterDeclaration: void 0,
-        named: [],
-        default: void 0,
-        "*": void 0
-      }, a[c].afterDeclaration ??= r, a[c][n] = {
-        name: m,
-        isTypeOnly: r.isTypeOnly()
-      })), u.push({
-        specifier: c,
-        requestedName: n,
-        actualName: m
-      });
-      break;
-    }
-    return;
-  }
-  for (const r of l)
-    for (const i of r.getNamedImports()) {
-      if (i.getNameNode().getText() !== n)
-        continue;
-      if (o.isTypeOnly === !1) {
-        if (i.isTypeOnly())
-          i.setIsTypeOnly(!1);
-        else if (r.isTypeOnly()) {
-          r.setIsTypeOnly(!1);
-          for (const f of r.getNamedImports())
-            f !== i && f.setIsTypeOnly(!0);
-        }
-      }
-      let m = t;
-      const s = i.getAliasNode();
-      if (t !== n)
-        if (s === void 0) {
-          const f = O(t, n, e, d);
-          t === f ? i.getNameNode().asKind(g.Identifier)?.rename(t) : (i.setAlias(n), i.getNameNode().replaceWithText(t), m = n);
-        } else
-          i.getNameNode().replaceWithText(t), m = s.getText();
-      if (c !== e) {
-        const y = (w(x.project.projectData) || r.getModuleSpecifierValue().endsWith(".js")) && c.startsWith("@arcgis/core") ? `${c}.js` : c;
-        r.getNamedImports().length === 1 && r.getDefaultImport() === void 0 ? r.setModuleSpecifier(y) : (a[y] ??= {
-          afterDeclaration: void 0,
-          named: [],
-          default: void 0,
-          "*": void 0
-        }, a[y].afterDeclaration ??= l?.[0], a[y].named.push({
-          name: t,
-          alias: t === m ? void 0 : m,
-          isTypeOnly: i.isTypeOnly()
-        }), i.remove());
-      }
-      u.push({
-        specifier: c,
-        requestedName: t,
-        actualName: s?.getText() ?? m
-      });
-      return;
-    }
-}
-function O(e, n, o, l) {
-  if (e !== void 0) {
-    if (!l.has(e) && !h.has(e))
-      return l.add(e), e;
-    if (n !== void 0)
-      return O(n, void 0, o, l);
-  }
-  o.startsWith("@arcgis/core") && (o = `arcgisCore${o.slice(12)}`);
-  const u = o.split("/");
-  let a = e ?? "";
-  for (let d = u.length - 1; d >= 0; d--) {
-    const t = u[d].replaceAll($, "");
-    if (t !== a && (a = t + S(a), !l.has(a) && !h.has(a)))
-      return l.add(a), a;
-  }
-  for (let d = 2; ; d++) {
-    const t = a + d;
-    if (!l.has(t) && !h.has(t))
-      return l.add(t), t;
-  }
-}
-const $ = /[^a-zA-Z0-9$_]/gu, M = (e) => e.startsWith(".") ? e : `./${e}`, h = /* @__PURE__ */ new Set();
-let j;
-export {
-  b as a,
-  C as f,
-  J as p,
-  K as u
-};