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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,21 +1,22 @@
1
- import { log as g } from "@arcgis/toolkit/log";
2
- import { Command as Q, InvalidArgumentError as K } from "@commander-js/extra-typings";
3
- import { stat as q, realpath as B } from "node:fs/promises";
4
- import { path as i, getCwd as R, toPosixPathSeparators as T } from "@arcgis/node-toolkit/path";
5
- import { asyncFindPath as N, existsAsync as A } from "@arcgis/node-toolkit/file";
1
+ import { log as m } from "@arcgis/toolkit/log";
2
+ import { Command as de, InvalidArgumentError as F } from "@commander-js/extra-typings";
3
+ import { stat as Y, realpath as Z } from "node:fs/promises";
4
+ import { path as r, getCwd as W, toPosixPathSeparators as q } from "@arcgis/node-toolkit/path";
5
+ import { asyncFindPath as $, existsAsync as J } from "@arcgis/node-toolkit/file";
6
6
  import "ts-morph";
7
- import c from "typescript";
8
- import { asyncRetrievePackageJson as $ } from "@arcgis/node-toolkit/packageJson";
9
- import { glob as z } from "tinyglobby";
10
- import { gitIgnoreFileToGlobs as H } from "@arcgis/node-toolkit/glob";
11
- import { identity as _ } from "@arcgis/toolkit/function";
12
- import { styleText as D } from "node:util";
13
- const X = (t, e, s) => {
14
- const o = t[e];
15
- return o ? typeof o == "function" ? o() : Promise.resolve(o) : new Promise((r, l) => {
16
- (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." : ""))));
7
+ import d from "typescript";
8
+ import { asyncRetrievePackageJson as le } from "@arcgis/node-toolkit/packageJson";
9
+ import { glob as ee } from "tinyglobby";
10
+ import { gitIgnoreFileToGlobs as te } from "@arcgis/node-toolkit/glob";
11
+ import { identity as z } from "@arcgis/toolkit/function";
12
+ import { styleText as M } from "node:util";
13
+ import { randomUUID as ue } from "node:crypto";
14
+ const me = (t, e, o) => {
15
+ const s = t[e];
16
+ return s ? typeof s == "function" ? s() : Promise.resolve(s) : new Promise((n, l) => {
17
+ (typeof queueMicrotask == "function" ? queueMicrotask : setTimeout)(l.bind(null, /* @__PURE__ */ new Error("Unknown variable dynamic import: " + e + (e.split("/").length !== o ? ". Note that variables only represent file names one level deep." : ""))));
17
18
  });
18
- }, xe = {
19
+ }, Me = {
19
20
  allowImportingTsExtensions: !0,
20
21
  allowJs: !0,
21
22
  allowArbitraryExtensions: !0,
@@ -25,81 +26,93 @@ const X = (t, e, s) => {
25
26
  forceConsistentCasingInFileNames: !1,
26
27
  isolatedModules: !1,
27
28
  isolatedDeclarations: !1,
28
- jsx: c.JsxEmit.Preserve,
29
+ jsx: d.JsxEmit.Preserve,
29
30
  lib: ["lib.esnext.d.ts", "lib.dom.d.ts"],
30
- module: c.ModuleKind.ESNext,
31
- moduleResolution: c.ModuleResolutionKind.Bundler,
32
- moduleDetection: c.ModuleDetectionKind.Auto,
31
+ module: d.ModuleKind.ESNext,
32
+ moduleResolution: d.ModuleResolutionKind.Bundler,
33
+ moduleDetection: d.ModuleDetectionKind.Auto,
33
34
  strict: !1,
34
- target: c.ScriptTarget.ESNext,
35
+ target: d.ScriptTarget.ESNext,
35
36
  resolveJsonModule: !0,
36
37
  esModuleInterop: !0
37
- }, P = {
38
+ }, v = {
38
39
  codemod: void 0,
39
40
  codemodName: void 0,
40
41
  projectsData: void 0,
41
42
  project: void 0
42
- };
43
- async function Y() {
44
- const { ignorePatterns: t, globRoot: e } = await Z(), s = await ee(e);
45
- return t.push(...s), { ignorePatterns: t, globRoot: e };
43
+ }, oe = [
44
+ // Hardcoded ignores in TypeScript
45
+ "**/node_modules/**",
46
+ "**/bower_components/**",
47
+ "**/jspm_packages/**",
48
+ // Default build output folder in bundlers
49
+ "**/dist/**"
50
+ ];
51
+ async function pe() {
52
+ const { ignorePatterns: t, globRoot: e, hasIgnoreFiles: o } = await ge(), s = await fe(e);
53
+ return t.push(...s.ignorePatterns), !o && !s.hasIgnoreFiles && t.push(...oe), { ignorePatterns: t, globRoot: e };
46
54
  }
47
- async function Z() {
48
- const t = [], e = await N(".git"), s = e === void 0 ? void 0 : i.dirname(e);
49
- let o, r = R(), l = i.dirname(r);
55
+ async function ge() {
56
+ const t = [];
57
+ let e = !1;
58
+ const o = await $(".git"), s = o === void 0 ? void 0 : r.dirname(o);
59
+ let n, l = W(), f = r.dirname(l);
50
60
  do {
51
- if (o = l, s !== void 0 && o !== s && !o.startsWith(`${s}/`))
61
+ if (n = f, s !== void 0 && n !== s && !n.startsWith(`${s}/`))
52
62
  break;
53
- const w = i.join(o, ".gitignore");
54
- if (await A(w)) {
55
- r = i.dirname(w);
56
- const b = i.relative(r, R()).split("/"), v = H(w);
57
- for (const p of v) {
58
- 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("/");
59
- let a = !0;
60
- const f = Math.min(b.length, n.length);
61
- for (let m = 0; m < f; m++) {
62
- const C = n[m];
63
- if (!(d && m === n.length - 1 ? b[m].startsWith(C) : b[m] === C) && C !== "") {
64
- a = !1;
63
+ const p = r.join(n, ".gitignore");
64
+ if (await J(p)) {
65
+ e = !0, l = r.dirname(p);
66
+ const h = r.relative(l, W()).split("/"), T = te(p);
67
+ for (const b of T) {
68
+ const w = b.startsWith("!") ? b.slice(1) : b, y = w.search(/[*?[]/u), P = y === -1 ? w : w.slice(0, y), g = P.split("/"), I = y !== -1 && !P.endsWith("/");
69
+ let x = !0;
70
+ const D = Math.min(h.length, g.length);
71
+ for (let i = 0; i < D; i++) {
72
+ const a = g[i];
73
+ if (!(I && i === g.length - 1 ? h[i].startsWith(a) : h[i] === a) && a !== "") {
74
+ x = !1;
65
75
  break;
66
76
  }
67
77
  }
68
- a && (p.startsWith("!") || t.push(p));
78
+ x && (b.startsWith("!") || t.push(b));
69
79
  }
70
80
  }
71
- l = i.dirname(o);
72
- } while (l !== o);
73
- return { ignorePatterns: t, globRoot: r };
81
+ f = r.dirname(n);
82
+ } while (f !== n);
83
+ return { ignorePatterns: t, globRoot: l, hasIgnoreFiles: e };
74
84
  }
75
- async function ee(t) {
76
- return (await z("**/.gitignore", {
77
- cwd: R(),
85
+ async function fe(t) {
86
+ const e = await ee("**/.gitignore", {
87
+ cwd: W(),
78
88
  // Gitignore files are unlikely to be symbolic links
79
89
  followSymbolicLinks: !1,
80
90
  // Don't look for ignore files in these places for speed:
81
- ignore: [
82
- // Hardcoded ignores in TypeScript
83
- "**/node_modules/**",
84
- "**/bower_components/**",
85
- "**/jspm_packages/**",
86
- // Default build output folder in bundlers
87
- "**/dist/**"
88
- ],
91
+ ignore: oe,
89
92
  // Not applicable for our glob pattern
90
93
  expandDirectories: !1
91
- })).flatMap((s) => {
92
- const o = i.relative(t, i.dirname(s)), r = H(s), l = [];
93
- for (const w of r)
94
- w.startsWith("!") || l.push(i.join(o, w));
95
- return l;
96
94
  });
95
+ return { ignorePatterns: e.flatMap((s) => {
96
+ const n = r.relative(t, r.dirname(s)), l = te(s), f = [];
97
+ for (const p of l)
98
+ p.startsWith("!") || f.push(r.join(n, p));
99
+ return f;
100
+ }), hasIgnoreFiles: e.length > 0 };
97
101
  }
98
- const te = ["js", "jsx", "mjs", "cjs"], oe = ["ts", "tsx", "mts", "cts"], se = ["json"], ie = `**/*.{${[...te, ...oe, ...se].join(",")}}`;
99
- async function ne(t) {
100
- const e = await Y(), s = i.join(process.cwd(), ie), o = i.join(i.resolve(e.globRoot), "/"), r = (await z(s, {
101
- cwd: e.globRoot,
102
- ignore: e.ignorePatterns,
102
+ const se = ["js", "jsx", "mjs", "cjs"], ie = ["ts", "tsx", "mts", "cts"], he = /* @__PURE__ */ new Set([...se, ...ie]), be = ["json"], we = ["css", "scss", "sass", "html"];
103
+ async function ye({
104
+ targetFilePath: t,
105
+ includeComponentFiles: e = !1,
106
+ includeTsConfigFiles: o = !1
107
+ } = {}) {
108
+ const s = await pe(), l = `**/*.{${[
109
+ ...se,
110
+ ...ie,
111
+ ...be,
112
+ ...e ? we : []
113
+ ].join(",")}}`, f = r.join(process.cwd(), l), p = r.join(r.resolve(s.globRoot), "/"), L = (await ee(f, {
114
+ cwd: s.globRoot,
115
+ ignore: s.ignorePatterns,
103
116
  // The files we are looking for are unlikely to be symbolic links
104
117
  followSymbolicLinks: !1,
105
118
  // Not applicable for our glob pattern
@@ -108,136 +121,159 @@ async function ne(t) {
108
121
  // default behavior). If any tsconfig.json explicitly includes such files,
109
122
  // they will still be codemodded.
110
123
  })).filter(
111
- (n) => n.endsWith(".json") || t === void 0 || o + n === t
124
+ (i) => i.endsWith(".json") || t === void 0 || p + i === t
112
125
  );
113
- let l = i.relative(e.globRoot, process.cwd());
114
- l !== "" && (l += "/");
115
- const w = o.length + l.length, E = [], b = [], v = /* @__PURE__ */ new Set();
116
- for (const n of r) {
117
- const d = o + n;
118
- if (n.endsWith(".json")) {
119
- const a = i.basename(n);
120
- a === "package.json" ? E.push(d) : (a.startsWith("tsconfig.") || a.startsWith("jsconfig.")) && b.push(d);
126
+ let h = r.relative(s.globRoot, process.cwd());
127
+ h !== "" && (h += "/");
128
+ const T = p.length + h.length, b = [], w = [], y = /* @__PURE__ */ new Set();
129
+ for (const i of L) {
130
+ const a = p + i;
131
+ if (i.endsWith(".json")) {
132
+ const c = r.basename(i);
133
+ c === "package.json" ? b.push(a) : (c.startsWith("tsconfig.") || c.startsWith("jsconfig.")) && w.push(a);
121
134
  } else {
122
- const a = n.slice(l.length);
123
- v.add(a);
135
+ const c = i.slice(h.length);
136
+ y.add(c);
124
137
  }
125
138
  }
126
- let p = await N("tsconfig.json", i.dirname(process.cwd()));
127
- p !== void 0 && (p = T(p), b.push(p)), b.sort((n, d) => {
128
- const a = d.split("/").length - n.split("/").length;
129
- if (a !== 0)
130
- return a;
131
- const f = i.basename(n), m = i.basename(d);
132
- 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);
139
+ let P = await $("tsconfig.json", r.dirname(process.cwd()));
140
+ P !== void 0 && (P = q(P), w.push(P)), w.sort((i, a) => {
141
+ const c = a.split("/").length - i.split("/").length;
142
+ if (c !== 0)
143
+ return c;
144
+ const u = r.basename(i), S = r.basename(a);
145
+ return u === S ? 0 : u.endsWith("tsconfig.json") ? -1 : S.endsWith("tsconfig.json") ? 1 : u.endsWith("tsconfig.build.json") ? -1 : S.endsWith("tsconfig.build.json") ? 1 : u.localeCompare(S);
133
146
  });
134
- let u = await N("package.json");
135
- u !== void 0 && (u = T(u));
136
- const h = [], x = /* @__PURE__ */ new Set();
147
+ let g = await $("package.json");
148
+ g !== void 0 && (g = q(g));
149
+ const I = [
150
+ .../* @__PURE__ */ new Set([...b, ...g === void 0 ? [] : [g]])
151
+ ].sort((i, a) => a.length - i.length), x = [], D = /* @__PURE__ */ new Set();
137
152
  if (await Promise.all(
138
- b.map(async (n) => {
139
- const d = i.relative(process.cwd(), n), a = c.readConfigFile(n, c.sys.readFile);
140
- if (a.error !== void 0) {
141
- g(
153
+ w.map(async (i) => {
154
+ const a = r.relative(process.cwd(), i), c = d.readConfigFile(i, d.sys.readFile);
155
+ if (c.error !== void 0) {
156
+ m(
142
157
  "error",
143
- d,
144
- c.formatDiagnosticsWithColorAndContext([a.error], {
145
- getCanonicalFileName: _,
146
- getCurrentDirectory: c.sys.getCurrentDirectory,
147
- getNewLine: () => c.sys.newLine
158
+ a,
159
+ d.formatDiagnosticsWithColorAndContext([c.error], {
160
+ getCanonicalFileName: z,
161
+ getCurrentDirectory: d.sys.getCurrentDirectory,
162
+ getNewLine: () => d.sys.newLine
148
163
  })
149
164
  );
150
165
  return;
151
166
  }
152
- const f = c.parseJsonConfigFileContent(
153
- a.config,
154
- c.sys,
155
- i.dirname(n),
167
+ const u = d.parseJsonConfigFileContent(
168
+ c.config,
169
+ d.sys,
170
+ r.dirname(i),
156
171
  void 0,
157
- n
158
- ), m = 18003;
159
- f.errors.filter((y) => y.code !== m).length > 0 && g(
172
+ i
173
+ ), S = 18003;
174
+ u.errors.filter((k) => k.code !== S).length > 0 && m(
160
175
  "warn",
161
- d,
162
- c.formatDiagnosticsWithColorAndContext(f.errors, {
163
- getCanonicalFileName: _,
164
- getCurrentDirectory: c.sys.getCurrentDirectory,
165
- getNewLine: () => c.sys.newLine
176
+ a,
177
+ d.formatDiagnosticsWithColorAndContext(u.errors, {
178
+ getCanonicalFileName: z,
179
+ getCurrentDirectory: d.sys.getCurrentDirectory,
180
+ getNewLine: () => d.sys.newLine
166
181
  })
167
182
  );
168
- const M = n === p, F = f.fileNames.filter((y) => {
169
- if (t !== void 0 && y !== t)
183
+ const K = i === P, _ = u.fileNames.filter((k) => {
184
+ if (t !== void 0 && k !== t)
170
185
  return !1;
171
- const S = y.slice(w);
172
- return v.delete(S) ? (x.add(S), !0) : x.has(S) || S.endsWith(".json") || y.includes("node_modules") ? !1 : !M;
173
- });
174
- if (F.length === 0)
186
+ const E = k.slice(T);
187
+ return y.delete(E) ? (D.add(E), !0) : D.has(E) || E.endsWith(".json") || k.includes("node_modules") || K ? !1 : d.sys.fileExists(k);
188
+ }), ae = (
189
+ // Scanning tsconfig.json
190
+ o && // Don't include tsconfig outside the scanned scope
191
+ !K && // If filtering by file, ensure this tsconfig is the one being targeted
192
+ (t === void 0 || t === i)
193
+ );
194
+ if (_.length === 0 && !ae)
175
195
  return;
176
- const O = i.dirname(n);
177
- let j = O, k = u;
178
- for (; j === e.globRoot || // Stop searching outside repository root
179
- j.startsWith(`${e.globRoot}/`); ) {
180
- const y = i.join(j, "package.json");
181
- if (E.includes(y)) {
182
- k = y;
183
- break;
184
- }
185
- if (j === e.globRoot)
186
- break;
187
- j = i.dirname(j);
188
- }
189
- const L = k === void 0 ? void 0 : { filePath: k, contents: await $(i.dirname(k)) }, V = {
190
- typeScriptConfig: {
191
- filePath: n,
192
- compilerOptions: f.options
193
- },
194
- packageJson: L,
195
- logName: D("blue", L?.contents?.name ?? O),
196
- cwd: O,
197
- filePaths: F
198
- };
199
- h.push(V);
196
+ const H = r.dirname(i), ce = B(H, I) ?? g;
197
+ x.push(
198
+ await V(_, H, ce, {
199
+ filePath: i,
200
+ compilerOptions: u.options
201
+ })
202
+ );
200
203
  })
201
- ), v.size > 0) {
202
- const n = u === void 0 ? void 0 : {
203
- filePath: u,
204
- contents: await $(i.dirname(u))
205
- };
206
- h.push({
207
- typeScriptConfig: void 0,
208
- packageJson: n,
209
- cwd: process.cwd(),
210
- logName: D("blue", n?.contents?.name ?? process.cwd()),
211
- filePaths: Array.from(v).map((d) => i.join(process.cwd(), d))
212
- });
204
+ ), y.size > 0) {
205
+ const i = [...y].map((c) => r.join(process.cwd(), c)), a = Map.groupBy(i, (c) => B(c, I));
206
+ x.push(
207
+ ...await Promise.all(
208
+ [...a].map(async ([c, u]) => await V(u, process.cwd(), c))
209
+ )
210
+ );
213
211
  }
214
- return h.sort((n, d) => n.cwd.localeCompare(d.cwd)), P.projectsData = h, h;
212
+ return x.sort(
213
+ (i, a) => i.cwd.localeCompare(a.cwd) || (i.typeScriptConfig?.filePath ?? "").localeCompare(a.typeScriptConfig?.filePath ?? "") || (i.packageJson?.filePath ?? "").localeCompare(a.packageJson?.filePath ?? "")
214
+ ), v.projectsData = x, x;
215
+ }
216
+ function Ue(t) {
217
+ const e = r.extname(t).slice(1);
218
+ return he.has(e);
219
+ }
220
+ function B(t, e) {
221
+ return e.find((o) => {
222
+ const s = r.dirname(o);
223
+ return t === s || t.startsWith(`${s}/`);
224
+ });
215
225
  }
216
- function re() {
217
- P.codemod.meta.needsFooter && (P.codemod.meta.needsFooter = !1, process.exitCode !== void 0 && process.exitCode !== 0 ? g(
226
+ async function V(t, e, o, s) {
227
+ const n = o === void 0 ? void 0 : {
228
+ filePath: o,
229
+ contents: await le(r.dirname(o))
230
+ };
231
+ return {
232
+ typeScriptConfig: s,
233
+ packageJson: n,
234
+ cwd: e,
235
+ filePaths: t.sort(),
236
+ logName: M("blue", n?.contents.name ?? e)
237
+ };
238
+ }
239
+ function Pe() {
240
+ v.codemod.meta.needsFooter && (v.codemod.meta.needsFooter = !1, process.exitCode !== void 0 && process.exitCode !== 0 ? m(
218
241
  "warn",
219
- P.codemodName,
242
+ v.codemodName,
220
243
  "One or more exceptions occurred during the codemod run. Please review the output above."
221
- ) : g(
244
+ ) : m(
222
245
  "info",
223
- P.codemodName,
224
- `${D("green", "Codemod completed successfully.")} Recommended next steps:
246
+ v.codemodName,
247
+ `${M("green", "Codemod completed successfully.")} Recommended next steps:
225
248
  - Review the codemod changes.
226
249
  - If your project uses ESLint, run ESLint autofix on the changed files.
227
250
  - If your project uses Prettier, run Prettier on the changed files.
228
251
  - If your project uses TypeScript, run type checking to ensure there are no type errors.`
229
252
  ));
230
253
  }
231
- async function ae(t, e, s) {
232
- P.codemod = t, P.codemodName = e;
233
- const o = await ne(s);
234
- if (o.length === 0) {
235
- g("error", e, `Failed to find any .js or .ts files in ${process.cwd()} to run the codemod on.`), process.exitCode = 1;
254
+ async function xe(t, e, o) {
255
+ v.codemod = t, v.codemodName = e;
256
+ const s = await ye({
257
+ targetFilePath: o,
258
+ includeComponentFiles: t.meta.includeComponentFiles,
259
+ includeTsConfigFiles: t.meta.includeTsConfigFiles
260
+ });
261
+ if (s.length === 0) {
262
+ const n = t.meta.includeComponentFiles ? "source files or component manifests" : ".js or .ts files";
263
+ m("error", e, `Failed to find any ${n} in ${process.cwd()} to run the codemod on.`), process.exitCode = 1;
236
264
  return;
237
265
  }
238
- await t.run(o), re();
266
+ await t.run(s), Pe();
239
267
  }
240
- const W = {
268
+ const R = {
269
+ outdatedDependencies: {
270
+ label: "Outdated SDK dependencies - highest priority",
271
+ description: "Out of date SDK packages hide APIs that may be deprecated in the most recent version."
272
+ },
273
+ mismatchedDependencies: {
274
+ label: "Mismatched SDK dependency versions",
275
+ description: "Web GIS SDK packages within the same package.json must use the same exact version - that is the only tested combination."
276
+ },
241
277
  coreViews: {
242
278
  label: "@arcgis/core views and UI - highest priority",
243
279
  description: "Use map components and slots instead. Directly constructed views will no longer include .ui (like zoom buttons) in 6.0."
@@ -252,16 +288,20 @@ const W = {
252
288
  },
253
289
  codemod: {
254
290
  label: "Codemod available - quick fix",
255
- description: "A codemod is available to automate these migrations."
291
+ description: "A codemod is available to automate these migrations. See https://webgis.esri.com/references/codemod/introduction."
256
292
  },
257
293
  calcite: {
258
- label: "Calcite components",
294
+ label: "Calcite design system",
259
295
  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"
260
296
  },
261
297
  arcgisCore: { label: "@arcgis/core" },
262
298
  arcgisComponents: { label: "WebGIS SDK components" },
263
299
  arcgisSupport: { label: "WebGIS SDK support packages" },
264
300
  otherEsri: { label: "Other Esri and ArcGIS packages" },
301
+ outdatedTypeScriptConfig: {
302
+ label: "Outdated TypeScript configuration",
303
+ description: "Legacy compiler settings and targets below the Web GIS SDK baseline are not supported in the ArcGIS ecosystem. They may cause incompatibilities with newer packages."
304
+ },
265
305
  coreIntl: {
266
306
  label: "@arcgis/core translation utils",
267
307
  description: "Use https://webgis.esri.com/references/toolkit/intl instead."
@@ -270,42 +310,88 @@ const W = {
270
310
  label: "Non-Esri packages and web platform - low priority",
271
311
  description: "These deprecations do not block updating Esri packages and are not tied to an ArcGIS release."
272
312
  }
273
- }, I = new Q();
274
- I.name("@arcgis/codemod").description("Codemod for migrating or refactoring usages of ArcGIS Maps SDK for JavaScript");
275
- 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) => {
276
- const s = await G(e);
277
- let o;
313
+ }, A = "https://webgis.esri.com/api/deprecations";
314
+ async function Le(t, e) {
315
+ const o = ue();
316
+ process.stderr.write(`Submitting deprecation report (${o}).
317
+ `);
318
+ let s;
319
+ try {
320
+ s = await fetch(e, {
321
+ method: "POST",
322
+ headers: { "Content-Type": "application/json" },
323
+ body: JSON.stringify({
324
+ submissionId: o,
325
+ report: t
326
+ }),
327
+ signal: AbortSignal.timeout(12e4),
328
+ redirect: "error"
329
+ });
330
+ } catch (l) {
331
+ throw new Error(`Deprecation reporting failed; check submission ${o} before retrying.`, {
332
+ cause: l
333
+ });
334
+ }
335
+ if (!s.ok)
336
+ throw new Error(`Deprecation reporting failed: HTTP ${s.status}. Submission ID: ${o}`);
337
+ const n = await s.json();
338
+ if (typeof n != "object" || n === null || !("submissionId" in n) || n.submissionId !== o)
339
+ throw new Error(`Invalid collector acknowledgement. Check submission ${o} before retrying.`);
340
+ process.stderr.write(`Deprecation report submitted to ${e} (${o}).
341
+ `);
342
+ }
343
+ const ve = /(?:esri|arcgis)/iu, Se = ["/.astro/"], G = ["all", "repositories", "apis", "unused-apis"], Ke = {
344
+ usages: "Refactor-out deprecated API usages",
345
+ definitions: "Remove deprecated APIs in next breaking changes release"
346
+ }, _e = {
347
+ usages: "The following deprecated APIs are used in files owned by assigned CODEOWNERS. Refactor them before the APIs are removed.",
348
+ definitions: "The following deprecated APIs are owned by assigned CODEOWNERS. Remove them in the next breaking changes release."
349
+ }, He = "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.", qe = "Task", ze = "deprecations sync-issues";
350
+ function Be(t) {
351
+ return ve.test(t);
352
+ }
353
+ function Ve(t) {
354
+ return Se.some((e) => `/${t}`.includes(e));
355
+ }
356
+ const N = new de(), O = "See https://www.npmjs.com/package/@arcgis/codemod for a list of available public codemods. [Esri internal] Non-public codemods are documented at https://webgis.esri.com/references/codemod/introduction.";
357
+ N.name("@arcgis/codemod").description("Codemod for migrating or refactoring usages of ArcGIS Maps SDK for JavaScript");
358
+ N.command("run").description("Run a single codemod").argument("<codemodName>", `Name of the codemod. ${O}`).argument("[path]", "Directory to transform", process.cwd()).showHelpAfterError(O).action(async (t, e) => {
359
+ const o = await U(e);
360
+ let s;
278
361
  try {
279
- 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);
280
- } catch (r) {
362
+ s = await me(/* @__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);
363
+ } catch (n) {
281
364
  if (
282
365
  // direct Node execution
283
- 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
284
- String(r).includes("Unknown variable dynamic import:")
366
+ 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
367
+ String(n).includes("Unknown variable dynamic import:")
285
368
  ) {
286
- g("error", "@arcgis/codemod", `Can't find codemod by name "${t}".`), process.exitCode = 1;
369
+ m("error", "@arcgis/codemod", `Can't find codemod by name "${t}". ${O}`), process.exitCode = 1;
287
370
  return;
288
371
  } else
289
- throw r;
372
+ throw n;
290
373
  }
291
- if (typeof o.codemod != "object" || o.codemod === null) {
292
- g("error", "@arcgis/codemod", `Can't find codemod by name "${t}".`), process.exitCode = 1;
374
+ if (typeof s.codemod != "object" || s.codemod === null) {
375
+ m("error", "@arcgis/codemod", `Can't find codemod by name "${t}". ${O}`), process.exitCode = 1;
293
376
  return;
294
377
  }
295
- await ae(o.codemod, D("blue", t), s);
378
+ await xe(s.codemod, M("blue", t), o);
296
379
  });
297
- const J = I.command("deprecations").description(
380
+ const C = N.command("deprecations").description(
298
381
  `Audit and report deprecated APIs.
299
382
 
300
383
  Documentation: https://webgis.esri.com/references/codemod/deprecations`
301
- );
302
- J.command("audit-usages").description(
384
+ ), ne = "Globs to exclude from the scan (relative to cwd). Example: deprecated-package/**. Can provide --exclude multiple times. Use this sparingly. Use cases: deprecated packages, unmaintained test apps";
385
+ C.command("audit-usages").description(
303
386
  "Report deprecated API usages. Documentation: https://webgis.esri.com/references/codemod/deprecations#audit-usages"
304
- ).argument("[path]", "Directory to audit", process.cwd()).option("--esri-only", "Only report usages of deprecated APIs from Esri and ArcGIS packages", !1).option(
387
+ ).argument("[path]", "Directory to audit", process.cwd()).option("--exclude <glob>", ne, j, []).option("--esri-only", "Only report usages of deprecated APIs from Esri and ArcGIS packages", !1).option(
305
388
  "--category <category>",
306
- `Only report usages in a category. Available categories: ${Object.keys(W).join(", ")}`,
307
- de
389
+ `Only report usages in a category. Available categories: ${Object.keys(R).join(", ")}`,
390
+ re
308
391
  ).option("--package <package-name>", "Only report usages of deprecated APIs from this package").option(
392
+ "--report [url]",
393
+ `Submit a complete repository scan to the WebGIS collector (default: ${A})`
394
+ ).option(
309
395
  "--json",
310
396
  "Output results as JSON. Example: npx @arcgis/codemod deprecations audit-usages --json > usages.json",
311
397
  !1
@@ -315,28 +401,89 @@ J.command("audit-usages").description(
315
401
  !1
316
402
  ).action(async (t, e) => {
317
403
  if (e.json && e.md) {
318
- g("error", "@arcgis/codemod", "The --json and --md options cannot be used together."), process.exitCode = 1;
404
+ m("error", "@arcgis/codemod", "The --json and --md options cannot be used together."), process.exitCode = 1;
319
405
  return;
320
406
  }
321
- const s = await G(t), { auditDeprecatedUsages: o } = await import("./index.js"), r = e.md ? "md" : e.json ? "json" : "text";
322
- await o(s, {
407
+ const o = await U(t), { auditDeprecatedUsages: s } = await import("./index.js"), n = e.md ? "md" : e.json ? "json" : "text";
408
+ await s(o, {
323
409
  esriOnly: e.esriOnly,
324
- outputFormat: r,
410
+ outputFormat: n,
325
411
  category: e.category,
326
- packageName: e.package
412
+ packageName: e.package,
413
+ exclude: e.exclude,
414
+ reportingUrl: e.report === !0 ? A : e.report || void 0
327
415
  });
328
416
  });
329
- J.command("audit-definitions").description(
417
+ C.command("audit-definitions").description(
330
418
  "Report exported APIs marked as deprecated. Documentation: https://webgis.esri.com/references/codemod/deprecations#audit-definitions"
331
- ).argument("[path]", "Directory to audit", process.cwd()).option(
419
+ ).argument("[path]", "Directory to audit", process.cwd()).option("--exclude <glob>", ne, j, []).option(
332
420
  "--json",
333
421
  "Output results as JSON. Example: npx @arcgis/codemod deprecations audit-definitions --json > definitions.json",
334
422
  !1
335
423
  ).action(async (t, e) => {
336
- const s = await G(t), { auditDeprecatedDefinitions: o } = await import("./index2.js");
337
- await o(s, e.json);
424
+ const o = await U(t), { auditDeprecatedDefinitions: s } = await import("./index2.js");
425
+ await s(o, e.json, e.exclude);
426
+ });
427
+ C.command("aggregate-usages").description(
428
+ "Aggregate audit-usages reports into repository summaries and an API usage tree. Documentation: https://webgis.esri.com/references/codemod/deprecations#analyze-the-ecosystem"
429
+ ).argument("[reports...]", "Paths to audit-usages JSON files").option(
430
+ "--section <section>",
431
+ `Reports to include in the markdown report: ${G.join(", ")}`,
432
+ ke,
433
+ "all"
434
+ ).option(
435
+ "--remote [url]",
436
+ `Read the latest stored audit per repository from the WebGIS collector (default: ${A})`
437
+ ).option(
438
+ "--repository <repository>",
439
+ "Select a remote repository (host/owner/repo); repeat to select multiple",
440
+ j,
441
+ []
442
+ ).option("--branch <branch>", "Select remote audits from this branch").option("--since <date>", "Select remote audits on or after this ISO date", Q).option("--until <date>", "Select remote audits on or before this ISO date", Q).option(
443
+ "--definitions <report>",
444
+ "Compare an audit-definitions JSON report to list APIs with zero detected usages. Can be specified multiple times.",
445
+ j,
446
+ []
447
+ ).option("--esri-only", "Only report usages of deprecated APIs from Esri and ArcGIS packages", !1).option(
448
+ "--category <category>",
449
+ `Only report usages in a category. Available categories: ${Object.keys(R).join(", ")}`,
450
+ re
451
+ ).option("--package <package-name>", "Only report usages of deprecated APIs from this package").option("--json", "Output results as JSON", !1).option("--md", "Output results as Markdown", !1).action(async (t, e) => {
452
+ if (!t.length && !e.remote || !e.remote && (e.repository.length || e.branch || e.since || e.until))
453
+ throw new Error("Provide report files or --remote. Repository, branch, and date selection require --remote.");
454
+ if (e.since && e.until && e.since > e.until)
455
+ throw new Error("--since must not be after --until.");
456
+ if (e.json && e.md) {
457
+ m("error", "@arcgis/codemod", "The --json and --md options cannot be used together."), process.exitCode = 1;
458
+ return;
459
+ }
460
+ const { aggregateUsagesFromFiles: o } = await import("./index3.js");
461
+ await o(
462
+ t,
463
+ e.md ? "md" : e.json ? "json" : "text",
464
+ {
465
+ esriOnly: e.esriOnly,
466
+ category: e.category,
467
+ packageName: e.package,
468
+ section: e.section
469
+ },
470
+ e.definitions,
471
+ e.remote ? {
472
+ url: e.remote === !0 ? A : e.remote,
473
+ repositories: e.repository,
474
+ branch: e.branch,
475
+ since: e.since,
476
+ until: e.until
477
+ } : void 0
478
+ );
338
479
  });
339
- J.command("sync-issues").description(
480
+ function ke(t) {
481
+ const e = G.find((o) => o === t);
482
+ if (e !== void 0)
483
+ return e;
484
+ throw new F(`Expected one of: ${G.join(", ")}.`);
485
+ }
486
+ C.command("sync-issues").description(
340
487
  `Create or update deprecation audit issues. Requires authenticated gh cli.
341
488
 
342
489
  Existing open issues are updated if out of date (matched by title and invisible comment inside).
@@ -344,51 +491,70 @@ Otherwise, a new issue is created. Assignees are determined based on CODEOWNERS.
344
491
  ).argument(
345
492
  "<audit-json>",
346
493
  "Path to the JSON file as output by the --json flag in the audit-usages or audit-definitions CLI"
347
- ).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(
494
+ ).option("--dry-run", "Print planned issue and comment changes without changing GitHub", !1).option("--close-resolved", "Close stale managed issues after a complete, unfiltered repository-root audit", !1).option("--offset <number>", "Skip the first number of issue plans", X, 0).option("--limit <number>", "Process at most this many issue plans", X).option(
348
495
  "--label <label>",
349
- "Label to add to newly created issues. Can be specified multiple times.",
350
- ce,
496
+ "Label to add to managed issues. Can be specified multiple times. .github/labeler.yml config is applied by default",
497
+ j,
351
498
  []
352
499
  ).action(async (t, e) => {
353
- const s = i.resolve(t);
354
- if (!await A(s) || !(await q(s)).isFile()) {
355
- g("error", "@arcgis/codemod", `Failed to find the audit JSON file: ${t}`), process.exitCode = 1;
500
+ const o = r.resolve(t);
501
+ if (!await J(o) || !(await Y(o)).isFile()) {
502
+ m("error", "@arcgis/codemod", `Failed to find the audit JSON file: ${t}`), process.exitCode = 1;
356
503
  return;
357
504
  }
358
- const { syncDeprecationIssues: o } = await import("./sync.js");
359
- await o(
360
- await B(s),
361
- e.dryRun,
362
- e.offset,
363
- e.limit,
364
- e.label
365
- );
505
+ const { syncDeprecationIssues: s } = await import("./sync.js");
506
+ await s(await Z(o), e.dryRun, e.offset, e.limit, {
507
+ labels: e.label,
508
+ closeResolved: e.closeResolved
509
+ });
366
510
  });
367
- function ce(t, e) {
511
+ function Q(t) {
512
+ const e = new Date(t);
513
+ if (!Number.isFinite(e.getTime()))
514
+ throw new F("Expected an ISO date.");
515
+ return e.toISOString();
516
+ }
517
+ function j(t, e) {
368
518
  return [...e, t];
369
519
  }
370
- function U(t) {
520
+ function X(t) {
371
521
  const e = Number(t);
372
522
  if (!Number.isSafeInteger(e) || e < 0)
373
- throw new K("Expected a non-negative integer.");
523
+ throw new F("Expected a non-negative integer.");
374
524
  return e;
375
525
  }
376
- function de(t) {
377
- if (!Object.hasOwn(W, t))
378
- throw new K(`Expected one of: ${Object.keys(W).join(", ")}.`);
526
+ function re(t) {
527
+ if (!Object.hasOwn(R, t))
528
+ throw new F(`Expected one of: ${Object.keys(R).join(", ")}.`);
379
529
  return t;
380
530
  }
381
- async function G(t) {
382
- const e = i.resolve(t);
383
- await A(e) || (g("error", "@arcgis/codemod", `Failed to find the target path: ${t}`), process.exit(1));
384
- const s = await B(e), o = (await q(s)).isFile();
385
- return process.chdir(o ? i.dirname(s) : s), o ? s : void 0;
531
+ async function U(t) {
532
+ const e = r.resolve(t);
533
+ await J(e) || (m("error", "@arcgis/codemod", `Failed to find the target path: ${t}`), process.exit(1));
534
+ const o = await Z(e), s = (await Y(o)).isFile();
535
+ return process.chdir(s ? r.dirname(o) : o), s ? o : void 0;
386
536
  }
387
- I.parse();
537
+ C.command("sync-markdown").description(
538
+ "Update managed Markdown comments on an existing issue, leaving its body untouched. Requires authenticated gh cli."
539
+ ).argument("<markdown-file>", "Path to the Markdown report").requiredOption("--issue <url>", "HTTPS URL of the existing GitHub issue").option("--dry-run", "Print planned comment changes without changing GitHub", !1).action(async (t, e) => {
540
+ const { syncMarkdown: o } = await import("./syncMarkdown.js");
541
+ await o(r.resolve(t), e.issue, e.dryRun);
542
+ });
543
+ N.parse();
388
544
  export {
389
- xe as a,
390
- W as d,
391
- P as g,
392
- re as p,
393
- ae as r
545
+ Le as a,
546
+ Be as b,
547
+ Me as c,
548
+ R as d,
549
+ A as e,
550
+ ze as f,
551
+ v as g,
552
+ Ke as h,
553
+ Ue as i,
554
+ _e as j,
555
+ He as k,
556
+ qe as l,
557
+ Pe as p,
558
+ xe as r,
559
+ Ve as s
394
560
  };