@arcgis/codemod 5.2.0-next.12 → 5.2.0-next.120

package/dist/codeowners-CarwYwHK.js

@@ -0,0 +1,118 @@
+import { findPath as u } from "@arcgis/node-toolkit/file";
+import { path as s, toPosixPathSeparators as l } from "@arcgis/node-toolkit/path";
+import { collectOutputSync as d } from "@arcgis/node-toolkit/shell";
+import m from "typescript";
+import { retrievePackageJson as f } from "@arcgis/node-toolkit/packageJson";
+import { readFileSync as h } from "node:fs";
+import x from "picomatch";
+function E() {
+  const e = u(".git");
+  if (e === void 0)
+    throw new Error("Unable to find a Git repository for the deprecation audit.");
+  const t = s.dirname(e), r = d("git", ["remote", "get-url", "origin"], { cwd: t }), n = d("git", ["rev-parse", "HEAD"], { cwd: t });
+  return { repository: S(r), repositoryRoot: t, ref: n };
+}
+function O(e, t) {
+  return l(s.relative(t, e));
+}
+function W(e, t, r, n) {
+  const o = e === "usages" ? "usage" : "definition";
+  process.stderr.write(
+    `Deprecations: ${t} ${o}${t === 1 ? "" : "s"} across ${r} file${r === 1 ? "" : "s"} from ${n} package${n === 1 ? "" : "s"}.
+`
+  );
+}
+function S(e) {
+  const t = e.replace(/\.git$/u, "");
+  if (t.startsWith("http://") || t.startsWith("https://"))
+    return new URL(t).href.replace(/^https?:\/\//u, "").replace(/\/$/u, "");
+  const r = /^(?:ssh:\/\/)?git@([^/:]+)[:/](.+)$/u.exec(t);
+  if (r !== null)
+    return `${r[1]}/${r[2]}`;
+  throw new Error(`Unsupported Git remote URL: ${e}`);
+}
+function b(e) {
+  return typeof e == "string" ? e : e.map((t) => t.kind === m.SyntaxKind.JSDocText ? t.text : w(t.getText())).join("");
+}
+function F(e) {
+  return e === void 0 ? void 0 : $(m.displayPartsToString([...e]));
+}
+function $(e) {
+  return e.replace(
+    /\{@link(?:code|plain)?\s+([\s\S]*?)\}/gu,
+    (t, r) => g(r)
+  );
+}
+function w(e) {
+  const t = /^\{@link(?:code|plain)?\s+([\s\S]*?)\}$/u.exec(e)?.[1];
+  return t === void 0 ? e : g(t);
+}
+function g(e) {
+  const t = e.trim().replace(/^(\S+)\s+([/:#!.])/u, "$1$2"), r = t.indexOf("|");
+  if (r !== -1)
+    return t.slice(r + 1).trim() || t.slice(0, r).trim();
+  const [n, ...o] = t.split(/\s+/u);
+  return o.join(" ") || n;
+}
+function L(e, t) {
+  const r = u("package.json", e);
+  return r === void 0 ? t : f(s.dirname(r)).name ?? t;
+}
+const c = {
+  excludedPackageNames: /* @__PURE__ */ new Set([
+    "@arcgis/charts-components-react",
+    "@arcgis/coding-components-react",
+    "@arcgis/components-build-utils",
+    "@arcgis/map-components-react",
+    "@arcgis/portal-components-react",
+    "@arcgis-test/lit-components-react"
+  ]),
+  excludedDefinitionPathFragments: ["test-package"],
+  ignoreDeprecatedApis: ["getReactWrapperOptions"],
+  ignoredDeprecationsByIncludes: ["React wrappers are not needed in React 19 or above"]
+};
+function U(e) {
+  return e !== void 0 && c.excludedPackageNames.has(e);
+}
+function C(e) {
+  return c.excludedDefinitionPathFragments.some(
+    (t) => e.includes(t)
+  );
+}
+function I(e, t) {
+  return c.ignoreDeprecatedApis.some((r) => r === e) || t != null && c.ignoredDeprecationsByIncludes.some((r) => t.includes(r));
+}
+function j() {
+  const e = u(".github/CODEOWNERS");
+  return e === void 0 ? void 0 : v(h(e, "utf8"), s.dirname(s.dirname(e)));
+}
+function v(e, t) {
+  const r = e.split(/\r?\n/u).map((n) => n.trim()).filter((n) => n !== "" && !n.startsWith("#")).map((n) => {
+    const [o, ...a] = n.split(/\s+/u), i = o.startsWith("/") ? o.slice(1) : o, p = i.includes("/") ? i : `**/${i}`;
+    return {
+      matches: x([p, `${p.replace(/\/$/u, "")}/**`], { dot: !0 }),
+      owners: a
+    };
+  });
+  return {
+    getOwners(n) {
+      const o = l(s.relative(t, n));
+      let a = [];
+      for (const i of r)
+        i.matches(o) && (a = i.owners);
+      return a;
+    }
+  };
+}
+export {
+  O as a,
+  L as b,
+  I as c,
+  F as d,
+  C as e,
+  b as f,
+  E as g,
+  j as l,
+  W as p,
+  U as s
+};

package/dist/config-BP6HDIQa.js

@@ -0,0 +1,19 @@
+const s = /(?:esri|arcgis)/iu, a = "@arcgis/codemod", t = {
+  usages: "Refactor-out deprecated API usages",
+  definitions: "Remove deprecated APIs in next breaking changes release"
+}, i = {
+  usages: "The following deprecated APIs are used in files owned by assigned CODEOWNERS. Refactor them before the APIs are removed.",
+  definitions: "The following deprecated APIs are owned by assigned CODEOWNERS. Remove them in the next breaking changes release."
+}, n = "This issue is autogenerated and updated regularly based on remaining items. Feel free to add comments and labels, update assignees, set milestone, or create sub-issues. Close it once completed. A new issue will be created if new findings are detected.", o = "Task", r = "deprecations sync-issues";
+function d(e) {
+  return s.test(e);
+}
+export {
+  t as a,
+  a as b,
+  i as c,
+  n as d,
+  o as e,
+  r as f,
+  d as i
+};

package/dist/index-2_o7gSlk.js

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

package/dist/index-DomCHjnu.js

@@ -0,0 +1,142 @@
+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-B76HBvov.js";
+import { r as v } from "./cli-DfAgo-jb.js";
+import { c as x } from "./useProjectInstance-DtWpxhlT.js";
+import { g as C, s as T, e as R, a as y, b, p as j, l as E, f as F } from "./codeowners-CarwYwHK.js";
+async function U(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 : F(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 = E(), 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 {
+  U as auditDeprecatedDefinitions,
+  z as collectDeprecatedApiDefinitions
+};

package/dist/log-B76HBvov.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/packageJson-sf04hyfN.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-B76HBvov.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
+};