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

package/dist/chunks/cli.js

@@ -0,0 +1,380 @@
+import { log as g } from "@arcgis/toolkit/log";
+import { Command as Q, InvalidArgumentError as K } from "@commander-js/extra-typings";
+import { stat as q, realpath as B } from "node:fs/promises";
+import { path as i, getCwd as R, toPosixPathSeparators as T } from "@arcgis/node-toolkit/path";
+import { asyncFindPath as N, existsAsync as A } from "@arcgis/node-toolkit/file";
+import "ts-morph";
+import c from "typescript";
+import { asyncRetrievePackageJson as $ } from "@arcgis/node-toolkit/packageJson";
+import { glob as z } from "tinyglobby";
+import { gitIgnoreFileToGlobs as H } from "@arcgis/node-toolkit/glob";
+import { identity as _ } from "@arcgis/toolkit/function";
+import { styleText as D } from "node:util";
+const X = (t, e, s) => {
+  const o = t[e];
+  return o ? typeof o == "function" ? o() : Promise.resolve(o) : new Promise((n, l) => {
+    (typeof queueMicrotask == "function" ? queueMicrotask : setTimeout)(l.bind(null, /* @__PURE__ */ new Error("Unknown variable dynamic import: " + e + (e.split("/").length !== s ? ". Note that variables only represent file names one level deep." : ""))));
+  });
+}, xe = {
+  allowImportingTsExtensions: !0,
+  allowJs: !0,
+  allowArbitraryExtensions: !0,
+  allowSyntheticDefaultImports: !0,
+  checkJs: !0,
+  experimentalDecorators: !0,
+  forceConsistentCasingInFileNames: !1,
+  isolatedModules: !1,
+  isolatedDeclarations: !1,
+  jsx: c.JsxEmit.Preserve,
+  lib: ["lib.esnext.d.ts", "lib.dom.d.ts"],
+  module: c.ModuleKind.ESNext,
+  moduleResolution: c.ModuleResolutionKind.Bundler,
+  moduleDetection: c.ModuleDetectionKind.Auto,
+  strict: !1,
+  target: c.ScriptTarget.ESNext,
+  resolveJsonModule: !0,
+  esModuleInterop: !0
+}, P = {
+  codemod: void 0,
+  codemodName: void 0,
+  projectsData: void 0,
+  project: void 0
+};
+async function Y() {
+  const { ignorePatterns: t, globRoot: e } = await Z(), s = await ee(e);
+  return t.push(...s), { ignorePatterns: t, globRoot: e };
+}
+async function Z() {
+  const t = [], e = await N(".git"), s = e === void 0 ? void 0 : i.dirname(e);
+  let o, n = R(), l = i.dirname(n);
+  do {
+    if (o = l, s !== void 0 && o !== s && !o.startsWith(`${s}/`))
+      break;
+    const w = i.join(o, ".gitignore");
+    if (await A(w)) {
+      n = i.dirname(w);
+      const y = i.relative(n, R()).split("/"), v = H(w);
+      for (const p of v) {
+        const u = p.startsWith("!") ? p.slice(1) : p, h = u.search(/[*?[]/u), x = h === -1 ? u : u.slice(0, h), r = x.split("/"), d = h !== -1 && !x.endsWith("/");
+        let a = !0;
+        const f = Math.min(y.length, r.length);
+        for (let m = 0; m < f; m++) {
+          const C = r[m];
+          if (!(d && m === r.length - 1 ? y[m].startsWith(C) : y[m] === C) && C !== "") {
+            a = !1;
+            break;
+          }
+        }
+        a && (p.startsWith("!") || t.push(p));
+      }
+    }
+    l = i.dirname(o);
+  } while (l !== o);
+  return { ignorePatterns: t, globRoot: n };
+}
+async function ee(t) {
+  return (await z("**/.gitignore", {
+    cwd: R(),
+    // Gitignore files are unlikely to be symbolic links
+    followSymbolicLinks: !1,
+    // Don't look for ignore files in these places for speed:
+    ignore: [
+      // Hardcoded ignores in TypeScript
+      "**/node_modules/**",
+      "**/bower_components/**",
+      "**/jspm_packages/**",
+      // Default build output folder in bundlers
+      "**/dist/**"
+    ],
+    // Not applicable for our glob pattern
+    expandDirectories: !1
+  })).flatMap((s) => {
+    const o = i.relative(t, i.dirname(s)), n = H(s), l = [];
+    for (const w of n)
+      w.startsWith("!") || l.push(i.join(o, w));
+    return l;
+  });
+}
+const te = ["js", "jsx", "mjs", "cjs"], oe = ["ts", "tsx", "mts", "cts"], se = ["json"], ie = `**/*.{${[...te, ...oe, ...se].join(",")}}`;
+async function re(t) {
+  const e = await Y(), s = i.join(process.cwd(), ie), o = i.join(i.resolve(e.globRoot), "/"), n = (await z(s, {
+    cwd: e.globRoot,
+    ignore: e.ignorePatterns,
+    // The files we are looking for are unlikely to be symbolic links
+    followSymbolicLinks: !1,
+    // Not applicable for our glob pattern
+    expandDirectories: !1
+    // Files and folders starting with . are excluded (matches TypeScript's
+    // default behavior). If any tsconfig.json explicitly includes such files,
+    // they will still be codemodded.
+  })).filter(
+    (r) => r.endsWith(".json") || t === void 0 || o + r === t
+  );
+  let l = i.relative(e.globRoot, process.cwd());
+  l !== "" && (l += "/");
+  const w = o.length + l.length, E = [], y = [], v = /* @__PURE__ */ new Set();
+  for (const r of n) {
+    const d = o + r;
+    if (r.endsWith(".json")) {
+      const a = i.basename(r);
+      a === "package.json" ? E.push(d) : (a.startsWith("tsconfig.") || a.startsWith("jsconfig.")) && y.push(d);
+    } else {
+      const a = r.slice(l.length);
+      v.add(a);
+    }
+  }
+  let p = await N("tsconfig.json", i.dirname(process.cwd()));
+  p !== void 0 && (p = T(p), y.push(p)), y.sort((r, d) => {
+    const a = d.split("/").length - r.split("/").length;
+    if (a !== 0)
+      return a;
+    const f = i.basename(r), m = i.basename(d);
+    return f === m ? 0 : f.endsWith("tsconfig.json") ? -1 : m.endsWith("tsconfig.json") ? 1 : f.endsWith("tsconfig.build.json") ? -1 : m.endsWith("tsconfig.build.json") ? 1 : f.localeCompare(m);
+  });
+  let u = await N("package.json");
+  u !== void 0 && (u = T(u));
+  const h = [], x = /* @__PURE__ */ new Set();
+  if (await Promise.all(
+    y.map(async (r) => {
+      const d = i.relative(process.cwd(), r), a = c.readConfigFile(r, c.sys.readFile);
+      if (a.error !== void 0) {
+        g(
+          "error",
+          d,
+          c.formatDiagnosticsWithColorAndContext([a.error], {
+            getCanonicalFileName: _,
+            getCurrentDirectory: c.sys.getCurrentDirectory,
+            getNewLine: () => c.sys.newLine
+          })
+        );
+        return;
+      }
+      const f = c.parseJsonConfigFileContent(
+        a.config,
+        c.sys,
+        i.dirname(r),
+        void 0,
+        r
+      ), m = 18003;
+      f.errors.filter((b) => b.code !== m).length > 0 && g(
+        "warn",
+        d,
+        c.formatDiagnosticsWithColorAndContext(f.errors, {
+          getCanonicalFileName: _,
+          getCurrentDirectory: c.sys.getCurrentDirectory,
+          getNewLine: () => c.sys.newLine
+        })
+      );
+      const M = r === p, F = f.fileNames.filter((b) => {
+        if (t !== void 0 && b !== t)
+          return !1;
+        const S = b.slice(w);
+        return v.delete(S) ? (x.add(S), !0) : x.has(S) || S.endsWith(".json") || b.includes("node_modules") ? !1 : !M;
+      });
+      if (F.length === 0)
+        return;
+      const O = i.dirname(r);
+      let j = O, k = u;
+      for (; j === e.globRoot || // Stop searching outside repository root
+      j.startsWith(`${e.globRoot}/`); ) {
+        const b = i.join(j, "package.json");
+        if (E.includes(b)) {
+          k = b;
+          break;
+        }
+        if (j === e.globRoot)
+          break;
+        j = i.dirname(j);
+      }
+      const L = k === void 0 ? void 0 : { filePath: k, contents: await $(i.dirname(k)) }, V = {
+        typeScriptConfig: {
+          filePath: r,
+          compilerOptions: f.options
+        },
+        packageJson: L,
+        logName: D("blue", L?.contents?.name ?? O),
+        cwd: O,
+        filePaths: F
+      };
+      h.push(V);
+    })
+  ), v.size > 0) {
+    const r = u === void 0 ? void 0 : {
+      filePath: u,
+      contents: await $(i.dirname(u))
+    };
+    h.push({
+      typeScriptConfig: void 0,
+      packageJson: r,
+      cwd: process.cwd(),
+      logName: D("blue", r?.contents?.name ?? process.cwd()),
+      filePaths: Array.from(v).map((d) => i.join(process.cwd(), d))
+    });
+  }
+  return h.sort((r, d) => r.cwd.localeCompare(d.cwd)), P.projectsData = h, h;
+}
+function ne() {
+  P.codemod.meta.needsFooter && (P.codemod.meta.needsFooter = !1, process.exitCode !== void 0 && process.exitCode !== 0 ? g(
+    "warn",
+    P.codemodName,
+    "One or more exceptions occurred during the codemod run. Please review the output above."
+  ) : g(
+    "info",
+    P.codemodName,
+    `${D("green", "Codemod completed successfully.")} Recommended next steps:
+- Review the codemod changes.
+- If your project uses ESLint, run ESLint autofix on the changed files.
+- If your project uses Prettier, run Prettier on the changed files.
+- If your project uses TypeScript, run type checking to ensure there are no type errors.`
+  ));
+}
+async function ae(t, e, s) {
+  P.codemod = t, P.codemodName = e;
+  const o = await re(s);
+  if (o.length === 0) {
+    g("error", e, `Failed to find any .js or .ts files in ${process.cwd()} to run the codemod on.`), process.exitCode = 1;
+    return;
+  }
+  await t.run(o), ne();
+}
+const W = {
+  coreWidgets: {
+    label: "@arcgis/core widgets - high priority",
+    description: "WebGIS platform priority"
+  },
+  coreGeometryEngine: {
+    label: "@arcgis/core geometry engine - high priority",
+    description: "WebGIS platform priority"
+  },
+  codemod: {
+    label: "Codemod available - quick fix",
+    description: "A codemod is available to automate these migrations."
+  },
+  calcite: {
+    label: "Calcite components",
+    description: "This does not include visual breaking changes. See complete list in https://confluencewikidev.esri.com/spaces/Calcite/pages/464553094/Calcite+6.0+-+Breaking+Change+Release+February"
+  },
+  arcgisCoreComponents: { label: "Maps SDK for JavaScript" },
+  otherEsri: { label: "Other Esri and ArcGIS packages" },
+  coreIntl: {
+    label: "@arcgis/core translation utils",
+    description: "Use https://webgis.esri.com/references/toolkit/intl instead."
+  },
+  nonEsri: {
+    label: "Non-Esri packages and web platform - low priority",
+    description: "These deprecations do not block updating Esri packages and are not tied to an ArcGIS release."
+  }
+}, I = new Q();
+I.name("@arcgis/codemod").description("Codemod for migrating or refactoring usages of ArcGIS Maps SDK for JavaScript");
+I.command("run").description("Run a single codemod").argument("<codemodName>", "Name of the transform").argument("[path]", "Directory to transform", process.cwd()).action(async (t, e) => {
+  const s = await G(e);
+  let o;
+  try {
+    o = await X(/* @__PURE__ */ Object.assign({ "./codemods/api-extractor-strict-mode/codemod.ts": () => import("./codemod.js"), "./codemods/geometry-operator-renames/codemod.ts": () => import("./codemod2.js"), "./codemods/lumina-component-extras-improvements/codemod.ts": () => import("./codemod3.js"), "./codemods/lumina-toolkit/codemod.ts": () => import("./codemod4.js"), "./codemods/node-toolkit/codemod.ts": () => import("./codemod5.js"), "./codemods/normalize-calcite-icon-names/codemod.ts": () => import("./codemod6.js"), "./codemods/refactor-out-esri-namespace/codemod.ts": () => import("./codemod7.js"), "./codemods/toolkit-5.2-renames/codemod.ts": () => import("./codemod8.js") }), `./codemods/${t}/codemod.ts`, 4);
+  } catch (n) {
+    if (
+      // direct Node execution
+      typeof n == "object" && n !== null && "code" in n && n.code === "ERR_MODULE_NOT_FOUND" && "url" in n && typeof n.url == "string" && n.url.endsWith(`/${t}/codemod.ts`) || // Vite build execution
+      String(n).includes("Unknown variable dynamic import:")
+    ) {
+      g("error", "@arcgis/codemod", `Can't find codemod by name "${t}".`), process.exitCode = 1;
+      return;
+    } else
+      throw n;
+  }
+  if (typeof o.codemod != "object" || o.codemod === null) {
+    g("error", "@arcgis/codemod", `Can't find codemod by name "${t}".`), process.exitCode = 1;
+    return;
+  }
+  await ae(o.codemod, D("blue", t), s);
+});
+const J = I.command("deprecations").description("Audit and report deprecated APIs");
+J.command("audit-usages").description("Report deprecated API usages").argument("[path]", "Directory to audit", process.cwd()).option("--esri-only", "Only report usages of deprecated APIs from Esri and ArcGIS packages", !1).option(
+  "--category <category>",
+  `Only report usages in a category. Available categories: ${Object.keys(W).join(", ")}`,
+  de
+).option("--package <package-name>", "Only report usages of deprecated APIs from this package").option(
+  "--json",
+  "Output results as JSON. Example: npx @arcgis/codemod deprecations audit-usages --json > usages.json",
+  !1
+).option(
+  "--md",
+  "Output results as Markdown. Example: npx @arcgis/codemod deprecations audit-usages --md > usages.md",
+  !1
+).action(async (t, e) => {
+  if (e.json && e.md) {
+    g("error", "@arcgis/codemod", "The --json and --md options cannot be used together."), process.exitCode = 1;
+    return;
+  }
+  const s = await G(t), { auditDeprecatedUsages: o } = await import("./index.js"), n = e.md ? "md" : e.json ? "json" : "text";
+  await o(s, {
+    esriOnly: e.esriOnly,
+    outputFormat: n,
+    category: e.category,
+    packageName: e.package
+  });
+});
+J.command("audit-definitions").description("Report exported APIs marked as deprecated").argument("[path]", "Directory to audit", process.cwd()).option(
+  "--json",
+  "Output results as JSON. Example: npx @arcgis/codemod deprecations audit-definitions --json > definitions.json",
+  !1
+).action(async (t, e) => {
+  const s = await G(t), { auditDeprecatedDefinitions: o } = await import("./index2.js");
+  await o(s, e.json);
+});
+J.command("sync-issues").description(
+  `Create or update deprecation audit issues. Requires authenticated gh cli.
+    
+Existing open issues are updated if out of date (matched by title and invisible comment inside).
+Otherwise, a new issue is created. Assignees are determined based on CODEOWNERS.`
+).argument(
+  "<audit-json>",
+  "Path to the JSON file as output by the --json flag in the audit-usages or audit-definitions CLI"
+).option("--dry-run", "Print planned issue and comment changes without changing GitHub", !1).option("--offset <number>", "Skip the first number of issue plans", U, 0).option("--limit <number>", "Process at most this many issue plans", U).option(
+  "--label <label>",
+  "Label to add to newly created issues. Can be specified multiple times.",
+  ce,
+  []
+).action(async (t, e) => {
+  const s = i.resolve(t);
+  if (!await A(s) || !(await q(s)).isFile()) {
+    g("error", "@arcgis/codemod", `Failed to find the audit JSON file: ${t}`), process.exitCode = 1;
+    return;
+  }
+  const { syncDeprecationIssues: o } = await import("./sync.js");
+  await o(
+    await B(s),
+    e.dryRun,
+    e.offset,
+    e.limit,
+    e.label
+  );
+});
+function ce(t, e) {
+  return [...e, t];
+}
+function U(t) {
+  const e = Number(t);
+  if (!Number.isSafeInteger(e) || e < 0)
+    throw new K("Expected a non-negative integer.");
+  return e;
+}
+function de(t) {
+  if (!Object.hasOwn(W, t))
+    throw new K(`Expected one of: ${Object.keys(W).join(", ")}.`);
+  return t;
+}
+async function G(t) {
+  const e = i.resolve(t);
+  await A(e) || (g("error", "@arcgis/codemod", `Failed to find the target path: ${t}`), process.exit(1));
+  const s = await B(e), o = (await q(s)).isFile();
+  return process.chdir(o ? i.dirname(s) : s), o ? s : void 0;
+}
+I.parse();
+export {
+  xe as a,
+  W as d,
+  P as g,
+  ne as p,
+  ae as r
+};

package/dist/{codemod-BWZ_CtnT.js → chunks/codemod.js}

@@ -30,9 +30,9 @@ var D = (n, e, i) => {
   return s();
 };
 import { log as y } from "@arcgis/toolkit/log";
-import { c as V } from "./useProjectInstance-BAlKm1ad.js";
+import { c as V } from "./useProjectInstance.js";
 import { mergeApiExtractorConfigs as O, loadApiExtractorConfig as _ } from "@arcgis/api-extractor/extractor/config";
-import { g as F } from "./cli-x1Uhjnb_.js";
+import { g as F } from "./cli.js";
 import { writeFile as I, readFile as j } from "node:fs/promises";
 import { join as W, relative as Q } from "node:path";
 import { existsAsync as U } from "@arcgis/node-toolkit/file";
@@ -182,7 +182,7 @@ ${a}
 For each added declaration, remove @public from it if it is not supposed to be public. For each removed declaration, add @public JSDoc tag if it needs to remain public.`
   );
 }
-const te = "5.2.0-next.98", ne = {
+const te = "1.0.0-0", ne = {
   version: te
 };
 async function oe(n) {