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

package/dist/chunks/index.js

@@ -0,0 +1,404 @@
+var C = (t, o) => (o = Symbol[t]) ? o : /* @__PURE__ */ Symbol.for("Symbol." + t), I = (t) => {
+  throw TypeError(t);
+};
+var F = (t, o, e) => {
+  if (o != null) {
+    typeof o != "object" && typeof o != "function" && I("Object expected");
+    var n, r;
+    e && (n = o[C("asyncDispose")]), n === void 0 && (n = o[C("dispose")], e && (r = n)), typeof n != "function" && I("Object not disposable"), r && (n = function() {
+      try {
+        r.call(this);
+      } catch (a) {
+        return Promise.reject(a);
+      }
+    }), t.push([e, n, o]);
+  } else e && t.push([e]);
+  return o;
+}, R = (t, o, e) => {
+  var n = typeof SuppressedError == "function" ? SuppressedError : function(i, s, l, u) {
+    return u = Error(l), u.name = "SuppressedError", u.error = i, u.suppressed = s, u;
+  }, r = (i) => o = e ? new n(i, o, "An error was suppressed during disposal") : (e = !0, i), a = (i) => {
+    for (; i = t.pop(); )
+      try {
+        var s = i[1] && i[1].call(i[2]);
+        if (i[0]) return Promise.resolve(s).then(a, (l) => (r(l), a()));
+      } catch (l) {
+        r(l);
+      }
+    if (e) throw o;
+  };
+  return a();
+};
+import { c as _ } from "./useProjectInstance.js";
+import { d as P, r as Q } from "./cli.js";
+import { f as y } from "./log.js";
+import { path as d, toPosixPathSeparators as H } from "@arcgis/node-toolkit/path";
+import { log as q } from "@arcgis/toolkit/log";
+import f from "typescript";
+import { g as D, a as G, s as K, p as V, b as X, c as Y, d as Z } from "./hardcodedBehavior.js";
+import { f as B, c as T, g as ee, i as te } from "./format.js";
+import { styleText as w } from "node:util";
+import { loadCodeowners as oe } from "@arcgis/node-toolkit/codeowners";
+function ne(t, o) {
+  if (o === "json") {
+    const e = D();
+    process.stdout.write(`${le(t, oe(), e)}
+`);
+    return;
+  }
+  if (o === "md") {
+    process.stdout.write(`${ue(t)}
+`);
+    return;
+  }
+  process.stdout.write(`${ae(t)}
+`);
+}
+function ae(t) {
+  const o = L(t), e = o.reduce((r, a) => r + a.count, 0), n = [J("Deprecation summary", e)];
+  for (const { categoryName: r, count: a, packages: i } of o) {
+    n.push(`${P[r].label} (${a})`);
+    for (const { packageName: s, count: l } of i)
+      n.push(`  ${M(s)} (${l})`);
+  }
+  n.push("", "", J("Deprecation details", e));
+  for (const { categoryName: r, count: a, packages: i } of o) {
+    const s = P[r];
+    n.push("", `${s.label} (${a})`), "description" in s && n.push(`  ${s.description}`);
+    for (const { packageName: l, count: u, apis: p } of i) {
+      n.push("", `  ${M(l)} (${u})`);
+      for (const { api: c, reasons: m, items: g } of p) {
+        n.push(`    ${ie(c)} (${g.length})`);
+        for (const v of m)
+          n.push(re(v, 6));
+        for (const { sourceFileName: v, usage: h } of se(g))
+          n.push(`      ${y(v)}:${h.line}:${h.column}`);
+      }
+    }
+  }
+  return n.join(`
+`);
+}
+function L(t) {
+  const o = [...t].flatMap(
+    ([e, n]) => n.map((r) => ({ ...r, packageName: e }))
+  );
+  return ee(o, ({ packageName: e, usage: n }) => ({
+    packageName: e,
+    api: n.name,
+    reason: n.reason
+  }));
+}
+function J(t, o) {
+  return w(["bold", "yellow"], `${t} (${o})`);
+}
+function M(t) {
+  return w("blue", t);
+}
+function ie(t) {
+  return w(["bold", "white"], t);
+}
+function re(t, o) {
+  const e = " ".repeat(o);
+  return t.split(/\r?\n/u).map((n) => `${e}${n}`).join(`
+`);
+}
+function se(t) {
+  return t.toSorted(
+    (o, e) => o.sourceFileName.localeCompare(e.sourceFileName) || o.usage.line - e.usage.line || o.usage.column - e.usage.column
+  );
+}
+function ce(t) {
+  return [...t].sort(([o], [e]) => o.localeCompare(e));
+}
+function le(t, o, e = D()) {
+  return JSON.stringify(E(t, o, e), void 0, 2);
+}
+function ue(t, o = D()) {
+  return B(E(t, void 0, o));
+}
+function E(t, o, e) {
+  const n = L(t);
+  return {
+    kind: "usages",
+    repository: e.repository,
+    ref: e.ref,
+    summary: {
+      total: n.reduce((a, { count: i }) => a + i, 0),
+      categories: n.map(({ categoryName: a, count: i, packages: s }) => ({
+        category: a,
+        label: P[a].label,
+        count: i,
+        packages: s.map(({ packageName: l, count: u }) => ({
+          package: l,
+          count: u
+        }))
+      }))
+    },
+    findings: ce(t).flatMap(
+      ([a, i]) => i.map((s) => ({
+        category: T({
+          packageName: a,
+          api: s.usage.name,
+          reason: s.usage.reason
+        }),
+        package: a,
+        api: s.usage.name,
+        reason: s.usage.reason ?? null,
+        file: G(s.sourceFileName, e.repositoryRoot),
+        line: s.usage.line,
+        column: s.usage.column,
+        codeowners: o?.getOwners(s.sourceFileName) ?? []
+      }))
+    )
+  };
+}
+async function Me(t, o) {
+  await Q(
+    {
+      meta: {
+        needsTypeInformation: !0,
+        needsFooter: !1
+      },
+      run(e) {
+        fe(e, o);
+      }
+    },
+    "deprecations audit-usages",
+    t
+  );
+}
+function fe(t, o) {
+  const e = /* @__PURE__ */ new Map(), n = /* @__PURE__ */ new Set(), r = [
+    ...new Map(
+      t.flatMap(({ packageJson: c }) => {
+        const m = c === void 0 ? void 0 : d.dirname(c.filePath), g = c?.contents.name;
+        return m !== void 0 && g !== void 0 && k(m, process.cwd()) ? [[m, { root: m, name: g }]] : [];
+      })
+    ).values()
+  ].toSorted((c, m) => m.root.length - c.root.length);
+  for (const c of t) {
+    var s = [];
+    try {
+      if (K(c.packageJson?.contents.name)) {
+        const N = c.packageJson?.filePath;
+        N !== void 0 && !n.has(N) && (n.add(N), q(
+          "warn",
+          y(N),
+          `Skipping excluded package \`${c.packageJson?.contents.name ?? c.cwd}\`.`
+        ));
+        continue;
+      }
+      const m = F(s, _(c, !1));
+      const g = m.tsMorph.getLanguageService().compilerObject;
+      const v = g.getProgram()?.getTypeChecker();
+      if (v === void 0)
+        continue;
+      const h = c.packageJson === void 0 ? void 0 : d.dirname(c.packageJson.filePath);
+      for (const N of m.getCodemodFiles()) {
+        const A = N.compilerNode;
+        for (const b of pe(
+          A,
+          g,
+          v,
+          h,
+          o.esriOnly
+        )) {
+          const $ = Pe(b.originFileNames, r, h), x = e.get($) ?? [];
+          x.push({ sourceFileName: A.fileName, usage: b }), e.set($, x);
+        }
+      }
+    } catch (l) {
+      var u = l, p = !0;
+    } finally {
+      R(s, u, p);
+    }
+  }
+  const a = me(e, o);
+  ne(a, o.outputFormat);
+  const i = [...a.values()].flat();
+  V(
+    "usages",
+    i.length,
+    new Set(i.map(({ sourceFileName: c }) => c)).size,
+    a.size
+  );
+}
+function me(t, o) {
+  const e = /* @__PURE__ */ new Map();
+  for (const [n, r] of t) {
+    if (o.packageName !== void 0 && n !== o.packageName)
+      continue;
+    const a = r.filter(
+      ({ usage: i }) => o.category === void 0 || T({ packageName: n, api: i.name, reason: i.reason }) === o.category
+    );
+    a.length > 0 && e.set(n, a);
+  }
+  return e;
+}
+function pe(t, o, e, n, r = !1) {
+  const a = /* @__PURE__ */ new Map();
+  for (const i of o.getSuggestionDiagnostics(t.fileName)) {
+    if (i.reportsDeprecated === void 0)
+      continue;
+    const s = he(t, i.start, i.start + i.length);
+    if (
+      // Don't report for imports, only for usages
+      f.findAncestor(s, f.isImportDeclaration) !== void 0 || // Don't report closing JSX - only for opening
+      f.findAncestor(s, f.isJsxClosingElement) !== void 0
+    )
+      continue;
+    const l = de(
+      s,
+      e,
+      o,
+      t.fileName,
+      i.start
+    );
+    U(l, r, n) && z(a, t, {
+      start: i.start,
+      length: i.length,
+      name: Ne(s, e, o, t.fileName, i.start) ?? ye(s),
+      originFileNames: l,
+      reason: ke(o, t.fileName, i.start) ?? Se(s, e)
+    });
+  }
+  return ge(t, e, a, n, r), [...a.values()].toSorted((i, s) => i.start - s.start);
+}
+function ge(t, o, e, n, r) {
+  function a(i) {
+    if (f.isJsxAttribute(i) && f.isIdentifier(i.name)) {
+      const s = i.parent.parent;
+      if (f.isJsxOpeningElement(s) || f.isJsxSelfClosingElement(s)) {
+        const u = o.getContextualType(s.tagName)?.getProperty(i.name.text), p = S(u, o), c = j(u);
+        p !== void 0 && U(c, r, n) && z(e, t, {
+          start: i.name.getStart(t),
+          length: i.name.getWidth(t),
+          name: i.name.text,
+          originFileNames: c,
+          reason: p
+        });
+      }
+    }
+    f.forEachChild(i, a);
+  }
+  a(t);
+}
+function de(t, o, e, n, r) {
+  const a = ve(t, o);
+  return a.length > 0 ? a : [...new Set(e.getDefinitionAtPosition(n, r)?.map(({ fileName: i }) => i))];
+}
+function j(t) {
+  return [...new Set(t?.declarations?.map((o) => o.getSourceFile().fileName))];
+}
+function ve(t, o) {
+  let e = o.getSymbolAtLocation(t);
+  for (; e !== void 0 && (e.flags & f.SymbolFlags.Alias) !== 0; ) {
+    if (S(e, o) !== void 0)
+      return j(e);
+    e = e.declarations === void 0 ? void 0 : o.getImmediateAliasedSymbol(e);
+  }
+  return [];
+}
+function Ne(t, o, e, n, r) {
+  let a = o.getSymbolAtLocation(t);
+  for (; a !== void 0 && (a.flags & f.SymbolFlags.Alias) !== 0; ) {
+    if (S(a, o) !== void 0)
+      return a.getName();
+    a = a.declarations === void 0 ? void 0 : o.getImmediateAliasedSymbol(a);
+  }
+  return e.getDefinitionAtPosition(n, r)?.[0]?.name;
+}
+function k(t, o) {
+  const e = d.relative(o, t);
+  return e !== "" && !e.startsWith("../") && !d.isAbsolute(e) && e !== "node_modules" && !e.startsWith("node_modules/");
+}
+function he(t, o, e) {
+  let n = t;
+  for (; ; ) {
+    let r;
+    if (f.forEachChild(n, (a) => {
+      r === void 0 && a.getStart(t) <= o && a.getEnd() >= e && (r = a);
+    }), r === void 0)
+      return n;
+    n = r;
+  }
+}
+function ye(t) {
+  return f.isIdentifier(t) || f.isPrivateIdentifier(t) || f.isStringLiteralLike(t) || f.isNumericLiteral(t) ? t.text : t.getText();
+}
+function O(t) {
+  const o = t?.find(({ name: e }) => e === "deprecated");
+  return o === void 0 ? void 0 : Z(o.text);
+}
+function ke(t, o, e) {
+  try {
+    return O(t.getQuickInfoAtPosition(o, e)?.tags);
+  } catch {
+    return;
+  }
+}
+function S(t, o) {
+  try {
+    return O(t?.getJsDocTags(o));
+  } catch {
+    return;
+  }
+}
+function Se(t, o) {
+  let e = o.getSymbolAtLocation(t);
+  for (; e !== void 0 && (e.flags & f.SymbolFlags.Alias) !== 0; ) {
+    const n = S(e, o);
+    if (n !== void 0)
+      return n;
+    e = e.declarations === void 0 ? void 0 : o.getImmediateAliasedSymbol(e);
+  }
+}
+function z(t, o, e) {
+  if (Y(e.name, e.reason))
+    return;
+  const { line: n, character: r } = o.getLineAndCharacterOfPosition(e.start);
+  t.set(`${e.start}:${e.length}`, {
+    ...e,
+    line: n + 1,
+    column: r + 1
+  });
+}
+function U(t, o, e) {
+  return t.some((n) => e !== void 0 && k(n, e)) ? !1 : !o || t.some((n) => {
+    const r = W(n);
+    return r === void 0 ? e === void 0 || !k(n, e) : te(r);
+  });
+}
+function W(t) {
+  const o = H(t), e = "/node_modules/", n = o.lastIndexOf(e);
+  if (n === -1)
+    return;
+  const [r, a] = o.slice(n + e.length).split("/");
+  return r.startsWith("@") ? `${r}/${a}` : r;
+}
+function Pe(t, o = [], e) {
+  const n = t[0];
+  if (n === void 0)
+    return "unknown package";
+  const r = W(n);
+  if (r !== void 0)
+    return r;
+  const a = o.find(({ root: c }) => k(n, c));
+  if (a !== void 0)
+    return a.name;
+  const i = d.dirname(y(n)), s = X(d.dirname(n), i);
+  if (s !== i)
+    return s;
+  if (e === void 0)
+    return i;
+  const u = d.relative(e, n).split("/"), p = u.findIndex((c) => c !== "..");
+  return p < 1 ? d.dirname(y(n)) : u.slice(0, p * 2).join("/");
+}
+export {
+  Me as auditDeprecatedUsages,
+  pe as collectDeprecatedApiUsages,
+  Pe as getDeprecationOriginLabel,
+  W as getNodeModulesPackageName,
+  U as shouldIncludeDeprecation
+};

package/dist/chunks/index2.js

@@ -0,0 +1,143 @@
+var k = (e, o) => (o = Symbol[e]) ? o : /* @__PURE__ */ Symbol.for("Symbol." + e), N = (e) => {
+  throw TypeError(e);
+};
+var h = (e, o, a) => {
+  if (o != null) {
+    typeof o != "object" && typeof o != "function" && N("Object expected");
+    var s, t;
+    a && (s = o[k("asyncDispose")]), s === void 0 && (s = o[k("dispose")], a && (t = s)), typeof s != "function" && N("Object not disposable"), t && (s = function() {
+      try {
+        t.call(this);
+      } catch (c) {
+        return Promise.reject(c);
+      }
+    }), e.push([a, s, o]);
+  } else a && e.push([a]);
+  return o;
+}, w = (e, o, a) => {
+  var s = typeof SuppressedError == "function" ? SuppressedError : function(n, p, r, m) {
+    return m = Error(r), m.name = "SuppressedError", m.error = n, m.suppressed = p, m;
+  }, t = (n) => o = a ? new s(n, o, "An error was suppressed during disposal") : (a = !0, n), c = (n) => {
+    for (; n = e.pop(); )
+      try {
+        var p = n[1] && n[1].call(n[2]);
+        if (n[0]) return Promise.resolve(p).then(c, (r) => (t(r), c()));
+      } catch (r) {
+        t(r);
+      }
+    if (a) throw o;
+  };
+  return c();
+};
+import { log as D } from "@arcgis/toolkit/log";
+import { path as S } from "@arcgis/node-toolkit/path";
+import { styleText as $ } from "node:util";
+import P from "typescript";
+import { f as g } from "./log.js";
+import { r as v } from "./cli.js";
+import { c as x } from "./useProjectInstance.js";
+import { g as C, s as T, e as R, a as y, b, p as j, f as E } from "./hardcodedBehavior.js";
+import { loadCodeowners as F } from "@arcgis/node-toolkit/codeowners";
+async function V(e, o) {
+  await v(
+    {
+      meta: { needsTypeInformation: !0, needsFooter: !1 },
+      run(a) {
+        O(a, o);
+      }
+    },
+    "deprecations audit-definitions",
+    e
+  );
+}
+function O(e, o) {
+  const a = [], s = /* @__PURE__ */ new Map(), t = /* @__PURE__ */ new Set(), c = C();
+  for (const i of e) {
+    var n = [];
+    try {
+      if (T(i.packageJson?.contents.name)) {
+        const d = i.packageJson?.filePath;
+        d !== void 0 && !t.has(d) && (t.add(d), D(
+          "warn",
+          g(d),
+          `Skipping excluded package \`${i.packageJson?.contents.name ?? i.cwd}\`.`
+        ));
+        continue;
+      }
+      const f = h(n, x(i, !1));
+      const J = i.packageJson?.contents.name ?? g(i.cwd);
+      for (const d of f.getCodemodFiles()) {
+        if (R(
+          y(d.compilerNode.fileName, c.repositoryRoot)
+        ))
+          continue;
+        const l = S.dirname(d.compilerNode.fileName), u = s.get(l) ?? b(l, J);
+        s.set(l, u), a.push(...z(d.compilerNode, u));
+      }
+    } catch (p) {
+      var r = p, m = !0;
+    } finally {
+      w(n, r, m);
+    }
+  }
+  if (o)
+    I(a, c);
+  else
+    for (const i of a) {
+      const f = $(
+        "blue",
+        `${g(i.sourceFileName)}:${i.line}:${i.column}`
+      );
+      D("warn", f, `\`${i.name}\` is deprecated.${i.reason ? ` ${i.reason}` : ""}`);
+    }
+  j(
+    "definitions",
+    a.length,
+    new Set(a.map(({ sourceFileName: i }) => i)).size,
+    new Set(a.map(({ package: i }) => i)).size
+  );
+}
+function z(e, o) {
+  const a = /* @__PURE__ */ new Map();
+  function s(t) {
+    const c = P.getJSDocDeprecatedTag(t), n = A(t);
+    if (c !== void 0 && n !== void 0) {
+      const p = n.getStart(e), { line: r, character: m } = e.getLineAndCharacterOfPosition(p);
+      a.set(`${p}:${n.getWidth(e)}`, {
+        package: o,
+        name: n.getText(e),
+        reason: c.comment === void 0 ? void 0 : E(c.comment),
+        sourceFileName: e.fileName,
+        line: r + 1,
+        column: m + 1
+      });
+    }
+    P.forEachChild(t, s);
+  }
+  return s(e), [...a.values()].sort((t, c) => t.line - c.line || t.column - c.column);
+}
+function A(e) {
+  return e.name;
+}
+function I(e, o) {
+  const a = F(), s = {
+    kind: "definitions",
+    repository: o.repository,
+    ref: o.ref,
+    findings: e.map((t) => ({
+      package: t.package,
+      api: t.name,
+      reason: t.reason ?? null,
+      file: y(t.sourceFileName, o.repositoryRoot),
+      line: t.line,
+      column: t.column,
+      codeowners: a?.getOwners(t.sourceFileName) ?? []
+    }))
+  };
+  process.stdout.write(`${JSON.stringify(s, void 0, 2)}
+`);
+}
+export {
+  V as auditDeprecatedDefinitions,
+  z as collectDeprecatedApiDefinitions
+};

package/dist/chunks/log.js

@@ -0,0 +1,11 @@
+import { path as e } from "@arcgis/node-toolkit/path";
+function n(t) {
+  return o(t.getFilePath());
+}
+function o(t) {
+  return e.relative(process.cwd(), t);
+}
+export {
+  n as a,
+  o as f
+};

package/dist/chunks/packageJson.js

@@ -0,0 +1,39 @@
+import { log as r } from "@arcgis/toolkit/log";
+import { writeFile as s } from "node:fs/promises";
+import { f } from "./log.js";
+async function h(n, a) {
+  const o = /* @__PURE__ */ new Set();
+  for (const i of n) {
+    const e = i.packageJson;
+    if (e === void 0 || o.has(e.filePath))
+      continue;
+    o.add(e.filePath);
+    const c = e.contents;
+    try {
+      const t = await a(c, e.filePath);
+      c !== t && await s(e.filePath, `${JSON.stringify(t, null, 2)}
+`, "utf8");
+    } catch (t) {
+      process.exitCode = 1, r(
+        "error",
+        f(e.filePath),
+        `Error occurred while migrating: ${String(t)}`,
+        typeof t == "object" && t !== null && "stack" in t ? { detail: { stack: t.stack } } : void 0
+      );
+    }
+  }
+}
+function u(n, a) {
+  for (const o of ["dependencies", "devDependencies", "peerDependencies", "optionalDependencies"]) {
+    const i = n[o];
+    if (i) {
+      const e = a(i, o);
+      e !== i && (n = { ...n, [o]: e });
+    }
+  }
+  return n;
+}
+export {
+  u as a,
+  h as f
+};