@arcgis/codemod 6.0.0-next.1 → 6.0.0-next.3

package/dist/chunks/classification.js

@@ -0,0 +1,232 @@
+import { findPath as S } from "@arcgis/node-toolkit/file";
+import { path as g, toPosixPathSeparators as h } from "@arcgis/node-toolkit/path";
+import { collectOutputSync as w } from "@arcgis/node-toolkit/shell";
+import s from "typescript";
+import { retrievePackageJson as P } from "@arcgis/node-toolkit/packageJson";
+import { d as b } from "./cli.js";
+function F(e) {
+  const t = JSON.parse(e);
+  if (typeof t != "object" || t === null || !("kind" in t) || t.kind !== "usages" && t.kind !== "definitions")
+    throw new Error("Invalid deprecation audit JSON.");
+  return t;
+}
+function G() {
+  const e = S(".git");
+  if (e === void 0)
+    throw new Error("Unable to find a Git repository for the deprecation audit.");
+  const t = g.dirname(e), r = w("git", ["remote", "get-url", "origin"], { cwd: t }), i = w("git", ["rev-parse", "HEAD"], { cwd: t });
+  return { repository: A(r), repositoryRoot: t, ref: i };
+}
+function J(e, t) {
+  return h(g.relative(t, e));
+}
+function K(e, t, r, i) {
+  const n = e === "usages" ? "usage" : "definition";
+  process.stderr.write(
+    `Deprecations: ${t} ${n}${t === 1 ? "" : "s"} across ${r} file${r === 1 ? "" : "s"} from ${i} package${i === 1 ? "" : "s"}.
+`
+  );
+}
+function A(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 _(e) {
+  const t = e.memberOf === void 0 ? e.api : `${e.memberOf}.${e.api}`;
+  return e.apiKind === "method" || e.apiKind === "function" ? `${t}()` : t;
+}
+function H(e, t = "dash") {
+  return e === void 0 || e === "property" || e === "method" || e === "function" ? "" : t === "parentheses" ? ` (${e})` : ` - ${e}`;
+}
+function U(e) {
+  if (e === void 0)
+    return {};
+  const t = O(e), r = e.parent, i = r !== void 0 && (s.isClassLike(r) || s.isInterfaceDeclaration(r)) ? r : r !== void 0 && s.isTypeLiteralNode(r) && s.isTypeAliasDeclaration(r.parent) ? r.parent : void 0, n = i?.name === void 0 ? void 0 : L(i, i.name.text);
+  return {
+    ...t === void 0 ? {} : { apiKind: t },
+    ...n === void 0 ? {} : { memberOf: n }
+  };
+}
+function L(e, t) {
+  const r = [];
+  for (let i = e?.parent; i !== void 0; i = i.parent) {
+    if (s.isClassLike(i) || s.isInterfaceDeclaration(i) || s.isTypeLiteralNode(i))
+      return t;
+    s.isModuleDeclaration(i) && s.isIdentifier(i.name) && r.unshift(i.name.text);
+  }
+  return [...r, t].join(".");
+}
+function O(e) {
+  if (s.isPropertyDeclaration(e) || s.isPropertySignature(e) || s.isGetAccessorDeclaration(e) || s.isSetAccessorDeclaration(e))
+    return "property";
+  if (s.isMethodDeclaration(e) || s.isMethodSignature(e))
+    return "method";
+  if (s.isClassLike(e))
+    return "class";
+  if (s.isInterfaceDeclaration(e))
+    return "interface";
+  if (s.isTypeAliasDeclaration(e))
+    return "type";
+  if (s.isFunctionDeclaration(e))
+    return "function";
+  if (s.isVariableDeclaration(e))
+    return "variable";
+  if (s.isModuleDeclaration(e))
+    return "namespace";
+}
+const C = /(?:esri|arcgis)/iu, q = "@arcgis/codemod", Q = {
+  usages: "Refactor-out deprecated API usages",
+  definitions: "Remove deprecated APIs in next breaking changes release"
+}, X = {
+  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."
+}, Y = "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.", Z = "Task", ee = "deprecations sync-issues";
+function k(e) {
+  return C.test(e);
+}
+const $ = /* @__PURE__ */ new Map([
+  ["MapView", "arcgis-map"],
+  ["SceneView", "arcgis-scene"],
+  ["LinkChartView", "arcgis-link-chart"],
+  ["VideoView", "arcgis-video"]
+]), V = /* @__PURE__ */ new Set([
+  "MessageBundleLoader",
+  "createJSONLoader",
+  "fetchMessageBundle",
+  "messageBundle",
+  "normalizeMessageBundleLocale",
+  "registerMessageBundleLoader"
+]), R = /* @__PURE__ */ new Set([
+  "AreaMeasurement2D",
+  "AreaMeasurement3D",
+  "BasemapGallery",
+  "BasemapToggle",
+  "BatchAttributeForm",
+  "BinaryColorSizeSlider",
+  "ClassedColorSlider",
+  "ColorSlider",
+  "ColorSizeSlider",
+  "CoordinateConversion",
+  "Daylight",
+  "DirectLineMeasurement3D",
+  "DistanceMeasurement2D",
+  "Editor",
+  "FeatureForm",
+  "FeatureTable",
+  "GridControls",
+  "HeatmapSlider",
+  "Home",
+  "HistogramRangeSlider",
+  "LayerList",
+  "Legend",
+  "LineOfSight",
+  "Locate",
+  "NavigationToggle",
+  "OpacitySlider",
+  "OrientedImageryViewer",
+  "Print",
+  "ScaleBar",
+  "Search",
+  "Sketch",
+  "SketchLabelOptions",
+  "SketchTooltipOptions",
+  "Slice",
+  "SizeSlider",
+  "Slider",
+  "SnappingOptions",
+  "TableList",
+  "useLegacyCreateTools"
+]);
+function B({
+  package: e,
+  api: t,
+  category: r,
+  memberOf: i,
+  module: n,
+  reason: l
+}) {
+  const a = e.toLowerCase(), o = l?.toLowerCase() ?? "";
+  return e === "@arcgis/core" && r === "coreViews" && $.has(t) || e === "@arcgis/core" && t === "ui" && [
+    "DOMContainer",
+    "DOMContainerProperties",
+    "MapView",
+    "MapViewProperties",
+    "SceneView",
+    "SceneViewProperties",
+    "LinkChartView",
+    "LinkChartViewProperties",
+    "VideoView",
+    "VideoViewProperties"
+  ].includes(i?.replace(/^__esri\./u, "") ?? "") ? "coreViews" : e === "@arcgis/core" && (R.has(t) || o.includes("components-transition-plan")) ? "coreWidgets" : e === "@arcgis/core" && (/^(?:__esri\.)?(?:geometryEngine(?:Async)?|projection)(?:\.|$)/u.test(t) || t === "extendedSpatialReferenceInfo" || n?.startsWith("geometry/geometryEngine") || n?.startsWith("geometry/projection")) ? "coreGeometryEngine" : /\bcodemod\b/iu.test(o) ? "codemod" : e === "@arcgis/core" && (V.has(t) || o.includes("widget translations")) ? "coreIntl" : a.includes("calcite") ? "calcite" : a.startsWith("@arcgis/") && a.includes("components") ? "arcgisComponents" : e === "@arcgis/core" ? "arcgisCore" : a.startsWith("@arcgis/") ? "arcgisSupport" : k(e) ? "otherEsri" : "nonEsri";
+}
+function te(e, t) {
+  return x(E(e, t));
+}
+function x(e) {
+  return e?.replace(/^(components?\/[^/]+-[^/]+)\/customElement$/u, "$1");
+}
+function E(e, t) {
+  const r = `/node_modules/${t}/`, i = e.map(h).sort((n, l) => Number(l.includes(r)) - Number(n.includes(r)));
+  for (const n of i) {
+    const l = n.lastIndexOf(r);
+    if (l !== -1)
+      return n.slice(l + r.length).replace(/^(?:src|dist)\//u, "").replace(f, "");
+    const a = [...n.matchAll(/\/(?:src|dist)(?=\/)/gu)];
+    if (a.length === 1) {
+      const m = a[0];
+      return n.slice(m.index + m[0].length + 1).replace(f, "");
+    }
+    const o = S("package.json", g.dirname(n));
+    if (o === void 0)
+      continue;
+    const c = g.dirname(o);
+    if (P(c).name === t)
+      return h(g.relative(c, n)).replace(/^(?:src|dist)\//u, "").replace(f, "");
+  }
+}
+const f = /\.(?:d\.)?(?:[cm]?ts|tsx)$/u;
+function re(e, t) {
+  const r = Map.groupBy(e, (i) => B(t(i)));
+  return Object.keys(b).flatMap((i) => {
+    const n = r.get(i);
+    if (n === void 0)
+      return [];
+    const a = [...Map.groupBy(n, (o) => t(o).package)].map(([o, c]) => {
+      const y = [...Map.groupBy(c, (u) => {
+        const p = t(u);
+        return JSON.stringify([p.api, p.memberOf]);
+      }).values()].map((u) => {
+        const p = t(u[0]).api, v = u.map((d) => t(d).reason).filter((d) => d != null && d !== ""), D = [...new Set(v)].sort((d, M) => d.localeCompare(M));
+        return { api: p, reasons: D, items: u };
+      });
+      return y.sort((u, p) => p.items.length - u.items.length || u.api.localeCompare(p.api)), { packageName: o, count: c.length, apis: y };
+    });
+    return a.sort((o, c) => c.count - o.count || o.packageName.localeCompare(c.packageName)), [{ categoryName: i, count: n.length, packages: a }];
+  });
+}
+export {
+  _ as a,
+  H as b,
+  re as c,
+  te as d,
+  J as e,
+  B as f,
+  G as g,
+  U as h,
+  k as i,
+  L as j,
+  $ as k,
+  Z as l,
+  F as m,
+  ee as n,
+  Q as o,
+  K as p,
+  q,
+  X as r,
+  Y as s
+};

package/dist/chunks/cli.js

@@ -12,7 +12,7 @@ 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) => {
+  return o ? typeof o == "function" ? o() : Promise.resolve(o) : new Promise((r, 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 = {
@@ -46,21 +46,21 @@ async function Y() {
 }
 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);
+  let o, r = R(), l = i.dirname(r);
   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);
+      r = i.dirname(w);
+      const b = i.relative(r, 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("/");
+        const u = p.startsWith("!") ? p.slice(1) : p, h = u.search(/[*?[]/u), x = h === -1 ? u : u.slice(0, h), n = x.split("/"), d = h !== -1 && !x.endsWith("/");
         let a = !0;
-        const f = Math.min(y.length, r.length);
+        const f = Math.min(b.length, n.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 !== "") {
+          const C = n[m];
+          if (!(d && m === n.length - 1 ? b[m].startsWith(C) : b[m] === C) && C !== "") {
             a = !1;
             break;
           }
@@ -70,7 +70,7 @@ async function Z() {
     }
     l = i.dirname(o);
   } while (l !== o);
-  return { ignorePatterns: t, globRoot: n };
+  return { ignorePatterns: t, globRoot: r };
 }
 async function ee(t) {
   return (await z("**/.gitignore", {
@@ -89,15 +89,15 @@ async function ee(t) {
     // 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)
+    const o = i.relative(t, i.dirname(s)), r = H(s), l = [];
+    for (const w of r)
       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, {
+async function ne(t) {
+  const e = await Y(), s = i.join(process.cwd(), ie), o = i.join(i.resolve(e.globRoot), "/"), r = (await z(s, {
     cwd: e.globRoot,
     ignore: e.ignorePatterns,
     // The files we are looking for are unlikely to be symbolic links
@@ -108,35 +108,35 @@ async function re(t) {
     // 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
+    (n) => n.endsWith(".json") || t === void 0 || o + n === 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);
+  const w = o.length + l.length, E = [], b = [], v = /* @__PURE__ */ new Set();
+  for (const n of r) {
+    const d = o + n;
+    if (n.endsWith(".json")) {
+      const a = i.basename(n);
+      a === "package.json" ? E.push(d) : (a.startsWith("tsconfig.") || a.startsWith("jsconfig.")) && b.push(d);
     } else {
-      const a = r.slice(l.length);
+      const a = n.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;
+  p !== void 0 && (p = T(p), b.push(p)), b.sort((n, d) => {
+    const a = d.split("/").length - n.split("/").length;
     if (a !== 0)
       return a;
-    const f = i.basename(r), m = i.basename(d);
+    const f = i.basename(n), 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);
+    b.map(async (n) => {
+      const d = i.relative(process.cwd(), n), a = c.readConfigFile(n, c.sys.readFile);
       if (a.error !== void 0) {
         g(
           "error",
@@ -152,11 +152,11 @@ async function re(t) {
       const f = c.parseJsonConfigFileContent(
         a.config,
         c.sys,
-        i.dirname(r),
+        i.dirname(n),
         void 0,
-        r
+        n
       ), m = 18003;
-      f.errors.filter((b) => b.code !== m).length > 0 && g(
+      f.errors.filter((y) => y.code !== m).length > 0 && g(
         "warn",
         d,
         c.formatDiagnosticsWithColorAndContext(f.errors, {
@@ -165,21 +165,21 @@ async function re(t) {
           getNewLine: () => c.sys.newLine
         })
       );
-      const M = r === p, F = f.fileNames.filter((b) => {
-        if (t !== void 0 && b !== t)
+      const M = n === p, F = f.fileNames.filter((y) => {
+        if (t !== void 0 && y !== 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;
+        const S = y.slice(w);
+        return v.delete(S) ? (x.add(S), !0) : x.has(S) || S.endsWith(".json") || y.includes("node_modules") ? !1 : !M;
       });
       if (F.length === 0)
         return;
-      const O = i.dirname(r);
+      const O = i.dirname(n);
       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;
+        const y = i.join(j, "package.json");
+        if (E.includes(y)) {
+          k = y;
           break;
         }
         if (j === e.globRoot)
@@ -188,7 +188,7 @@ async function re(t) {
       }
       const L = k === void 0 ? void 0 : { filePath: k, contents: await $(i.dirname(k)) }, V = {
         typeScriptConfig: {
-          filePath: r,
+          filePath: n,
           compilerOptions: f.options
         },
         packageJson: L,
@@ -199,21 +199,21 @@ async function re(t) {
       h.push(V);
     })
   ), v.size > 0) {
-    const r = u === void 0 ? void 0 : {
+    const n = u === void 0 ? void 0 : {
       filePath: u,
       contents: await $(i.dirname(u))
     };
     h.push({
       typeScriptConfig: void 0,
-      packageJson: r,
+      packageJson: n,
       cwd: process.cwd(),
-      logName: D("blue", r?.contents?.name ?? process.cwd()),
+      logName: D("blue", n?.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;
+  return h.sort((n, d) => n.cwd.localeCompare(d.cwd)), P.projectsData = h, h;
 }
-function ne() {
+function re() {
   P.codemod.meta.needsFooter && (P.codemod.meta.needsFooter = !1, process.exitCode !== void 0 && process.exitCode !== 0 ? g(
     "warn",
     P.codemodName,
@@ -230,20 +230,24 @@ function ne() {
 }
 async function ae(t, e, s) {
   P.codemod = t, P.codemodName = e;
-  const o = await re(s);
+  const o = await ne(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();
+  await t.run(o), re();
 }
 const W = {
+  coreViews: {
+    label: "@arcgis/core views and UI - highest priority",
+    description: "Use map components and slots instead. Directly constructed views will no longer include .ui (like zoom buttons) in 6.0."
+  },
   coreWidgets: {
     label: "@arcgis/core widgets - high priority",
     description: "WebGIS platform priority"
   },
   coreGeometryEngine: {
-    label: "@arcgis/core geometry engine - high priority",
+    label: "@arcgis/core geometry engine and projection - high priority",
     description: "WebGIS platform priority"
   },
   codemod: {
@@ -254,7 +258,9 @@ const W = {
     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" },
+  arcgisCore: { label: "@arcgis/core" },
+  arcgisComponents: { label: "WebGIS SDK components" },
+  arcgisSupport: { label: "WebGIS SDK support packages" },
   otherEsri: { label: "Other Esri and ArcGIS packages" },
   coreIntl: {
     label: "@arcgis/core translation utils",
@@ -271,16 +277,16 @@ I.command("run").description("Run a single codemod").argument("<codemodName>", "
   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) {
+  } catch (r) {
     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:")
+      typeof r == "object" && r !== null && "code" in r && r.code === "ERR_MODULE_NOT_FOUND" && "url" in r && typeof r.url == "string" && r.url.endsWith(`/${t}/codemod.ts`) || // Vite build execution
+      String(r).includes("Unknown variable dynamic import:")
     ) {
       g("error", "@arcgis/codemod", `Can't find codemod by name "${t}".`), process.exitCode = 1;
       return;
     } else
-      throw n;
+      throw r;
   }
   if (typeof o.codemod != "object" || o.codemod === null) {
     g("error", "@arcgis/codemod", `Can't find codemod by name "${t}".`), process.exitCode = 1;
@@ -288,8 +294,14 @@ I.command("run").description("Run a single codemod").argument("<codemodName>", "
   }
   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(
+const J = I.command("deprecations").description(
+  `Audit and report deprecated APIs.
+ 
+Documentation: https://webgis.esri.com/references/codemod/deprecations`
+);
+J.command("audit-usages").description(
+  "Report deprecated API usages. Documentation: https://webgis.esri.com/references/codemod/deprecations#audit-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
@@ -306,15 +318,17 @@ J.command("audit-usages").description("Report deprecated API usages").argument("
     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";
+  const s = await G(t), { auditDeprecatedUsages: o } = await import("./index.js"), r = e.md ? "md" : e.json ? "json" : "text";
   await o(s, {
     esriOnly: e.esriOnly,
-    outputFormat: n,
+    outputFormat: r,
     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(
+J.command("audit-definitions").description(
+  "Report exported APIs marked as deprecated. Documentation: https://webgis.esri.com/references/codemod/deprecations#audit-definitions"
+).argument("[path]", "Directory to audit", process.cwd()).option(
   "--json",
   "Output results as JSON. Example: npx @arcgis/codemod deprecations audit-definitions --json > definitions.json",
   !1
@@ -375,6 +389,6 @@ export {
   xe as a,
   W as d,
   P as g,
-  ne as p,
+  re as p,
   ae as r
 };