@arcgis/codemod 5.2.0-next.9 → 5.2.0-next.90

package/LICENSE.md

@@ -1,12 +1,14 @@
 # Licensing
 
-COPYRIGHT © Esri
+COPYRIGHT Esri
 
 All rights reserved under the copyright laws of the United States and applicable international laws, treaties, and conventions.
 
-This material is licensed for use under the [Esri Master License Agreement (MLA)](https://www.esri.com/content/dam/esrisites/en-us/media/legal/ma-full/ma-full.pdf), and is bound by the terms of that agreement.
+This material is licensed for use under the Esri Master License Agreement (MLA), and is bound by the terms of that agreement.
 You may redistribute and use this code without modification, provided you adhere to the terms of the MLA and include this copyright notice.
 
+See use restrictions at https://www.esri.com/content/dam/esrisites/en-us/media/legal/ma-full/ma-full.pdf.
+
 For additional information, contact:
 Environmental Systems Research Institute, Inc.
 Attn: Contracts and Legal Services Department

package/README.md

@@ -8,6 +8,7 @@ This package provides automated refactors to help migrate away from deprecated o
 
 - Automated refactor to remove `__esri` namespace usage
 - Converts global namespace types to explicit `@arcgis/core` imports
+- Normalizes legacy Calcite icon names
 - Detects edge cases and warns when changes can’t be safely automated
 - Respects `.gitignore` by default
 
@@ -17,9 +18,18 @@ This package provides automated refactors to help migrate away from deprecated o
 - A project using the ArcGIS Maps SDK for JavaScript
 - This codemod operates exclusively on TypeScript files. Do not need to run this tool, if the project does not use TypeScript.
 
+## Before you begin
+
+If your project uses **ESLint, Prettier, or other formatters/linters**, run them after the codemod to ensure consistent formatting.
+
+> [!Note]
+> This codemod modifies files in place and does not provide an interactive dry-run mode. We recommend running it in a project that is under version control (Git) so you can review changes using `git diff` or your IDE’s diff tools. If your project is not under version control, create a backup before running the codemod.
+
 ## Usage
 
-The codemod replaces `__esri` types with explicit imports from @arcgis/core.
+### Refactor out the `__esri` namespace
+
+The `refactor-out-esri-namespace` codemod replaces `__esri` types with explicit imports from `@arcgis/core`.
 
 > Note: Before running the codemod, update all `@arcgis/*` packages in your `package.json` to the most recent version.
 
@@ -36,7 +46,7 @@ You can manually run it on a different directory by providing an argument:
 npx @arcgis/codemod run refactor-out-esri-namespace target-directory
 ```
 
-### What codemod does
+#### What the codemod does
 
 **Before:**
 
@@ -56,7 +66,7 @@ let geometry: Geometry;
 let featureSet: FeatureSet;
 ```
 
-### Warnings (Manual review required)
+#### Warnings (manual review required)
 
 The codemod will emit warnings for cases it cannot safely rewrite, including:
 
@@ -65,11 +75,36 @@ The codemod will emit warnings for cases it cannot safely rewrite, including:
 - Unresolvable symbols
 
 These will be reported in the console, manually review all changes before committing.
-If your project uses **ESLint, Prettier, or other formatters/linters**, run them after the codemod to ensure consistent formatting.
 
-> Note: This codemod modifies files in place and does not provide an interactive dry-run mode. We recommend running it in a project that is under version control (Git) so you can review changes using `git diff` or your IDE’s diff tools. If your project is not under version control, create a backup before running the codemod.
+### Normalize Calcite icon names
+
+The `normalize-calcite-icon-names` codemod updates camelCase and legacy Calcite icon names to their normalized kebab-case equivalents. It handles icon attributes on Calcite components and traces icon values through variables, properties, assignments, function returns, and forwarded component properties. This helps prepare for [calcite-design-system#14967](https://github.com/Esri/calcite-design-system/issues/14967) and [calcite-design-system#14966](https://github.com/Esri/calcite-design-system/issues/14966).
+
+Run it in the root of your project:
+
+```sh
+npx @arcgis/codemod run normalize-calcite-icon-names
+```
+
+You can also provide a target directory:
+
+```sh
+npx @arcgis/codemod run normalize-calcite-icon-names target-directory
+```
+
+**Before:**
+
+```tsx
+<calcite-button iconStart="i3dGlasses" iconEnd="arrowLeft10" />
+```
+
+**After:**
+
+```tsx
+<calcite-button iconStart="3d-glasses" iconEnd="arrow-left-10" />
+```
 
 ## License
 
-This package is licensed under the terms described in the `LICENSE.md` file, located in the root of the package, and at https://js.arcgis.com/5.1/LICENSE.txt.
-For third party notices, see https://js.arcgis.com/5.1/third-party-notices.txt.
+This package is licensed under the terms described in the `LICENSE.md` file, located in the root of the package, and at https://js.arcgis.com/5.2/LICENSE.txt.
+For third party notices, see https://js.arcgis.com/5.2/third-party-notices.txt.

package/dist/{actions-BBxr-9ge.js → actions-ACvjOtUF.js}

@@ -1,6 +1,6 @@
-import { path as T } from "@arcgis/components-build-utils";
+import { path as T } from "@arcgis/node-toolkit/path";
 import { SyntaxKind as g } from "ts-morph";
-import { g as x } from "./cli-DPzs7oKq.js";
+import { g as x } from "./cli-CJfbqFa-.js";
 import { ModuleResolutionKind as D } from "typescript";
 import { capitalize as S } from "@arcgis/toolkit/string";
 import { log as q } from "@arcgis/toolkit/log";

package/dist/actions-CKBQcIhe.js

@@ -0,0 +1,354 @@
+import { path as T } from "@arcgis/node-toolkit/path";
+import { SyntaxKind as g } from "ts-morph";
+import { g as x } from "./cli-BJ6P_2T-.js";
+import { ModuleResolutionKind as D } from "typescript";
+import { capitalize as S } from "@arcgis/toolkit/string";
+import { log as q } from "@arcgis/toolkit/log";
+function w(e) {
+  const n = e.typeScriptConfig?.compilerOptions?.moduleResolution ?? D.Bundler;
+  return n >= D.Node16 && n <= D.NodeNext;
+}
+function b(e) {
+  return C(e.getFilePath());
+}
+function C(e) {
+  return T.relative(process.cwd(), e);
+}
+function J(e, n) {
+  const o = {};
+  K(e);
+  const { specifiers: l, names: u, lastImportIndex: a } = A(e), d = [], t = {};
+  let c = w(x.project.projectData);
+  for (const [i, m] of Object.entries(n)) {
+    let s = l.get(i) ?? (i.startsWith(".") ? l.get(
+      T.relative(e.getDirectoryPath(), T.resolve(x.project.projectData.cwd, i))
+    ) : void 0);
+    if (s === void 0) {
+      const f = l.get(`${i}.js`);
+      f !== void 0 && (c = !0, s === void 0 ? s = f : s = [...s, ...f]);
+    }
+    for (const [f, y] of Object.entries(m)) {
+      const N = Array.isArray(y) ? y : [y];
+      for (const I of N)
+        I.do === "deprecate" ? P(f, i, o, s) : I.do === "add" ? E(i, f, I, s, d, t, u) : I.do === "rename" && W(i, f, I, s, d, t, u);
+    }
+  }
+  const p = Object.entries(t);
+  let r = a;
+  for (let i = 0; i < p.length; i += 1) {
+    const [m, s] = p[i], f = m.startsWith(".") ? M(
+      T.relative(e.getDirectoryPath(), T.resolve(x.project.projectData.cwd, m))
+    ) : m, y = c && f.startsWith("@arcgis/core") ? `${f}.js` : f, N = s.afterDeclaration === void 0 ? r : s.afterDeclaration.getChildIndex() + 1;
+    if (s.named.length > 0) {
+      let I = !0;
+      for (let v = 0; v < s.named.length; v += 1)
+        I &&= s.named[v].isTypeOnly;
+      e.insertImportDeclaration(N, {
+        isTypeOnly: I,
+        moduleSpecifier: y,
+        namedImports: s.named.map((v) => ({
+          name: v.name,
+          alias: v.alias,
+          isTypeOnly: v.isTypeOnly && !I
+        }))
+      }), r += 1;
+    }
+    s.default !== void 0 && (e.insertImportDeclaration(N, {
+      isTypeOnly: s.default.isTypeOnly,
+      moduleSpecifier: y,
+      defaultImport: s.default.name
+    }), r += 1), s["*"] !== void 0 && (e.insertImportDeclaration(N, {
+      isTypeOnly: s["*"].isTypeOnly,
+      moduleSpecifier: y,
+      namespaceImport: s["*"].name
+    }), r += 1);
+  }
+  if (Object.keys(o).length > 0) {
+    const i = Object.entries(o).map(([m, s]) => `${s.join(", ")} from ${m}`).join("; ");
+    q("warn", b(e), `Deprecated API usages found: ${i}`);
+  }
+  return d;
+}
+function K(e) {
+  const n = e.getChildSyntaxList()?.getFirstChild();
+  if (j === n)
+    return;
+  j = n, h.clear();
+  const o = /* @__PURE__ */ new Set();
+  l(e);
+  function l(u) {
+    for (const a of u.getStatements())
+      if (a.isKind(g.ImportDeclaration)) {
+        const d = a.getDefaultImport(), t = a.getNamespaceImport(), c = a.getNamedImports();
+        d && o.add(d.getText()), t && o.add(t.getText());
+        for (const p of c)
+          o.add(p.getAliasNode()?.getText() ?? p.getName());
+      } else a.isKind(g.ImportEqualsDeclaration) ? o.add(a.getName()) : a.isKind(g.ModuleDeclaration) ? l(a) : u.forEachDescendant((d) => {
+        if (!d.isKind(g.Identifier))
+          return;
+        const t = d.getParent();
+        if (t.isKind(g.QualifiedName) && t.getLeft() !== d || t.isKind(g.PropertyAccessExpression) && t.getExpression() !== d || (t.isKind(g.PropertyDeclaration) || t.isKind(g.PropertySignature) || t.isKind(g.PropertyAssignment)) && t.getNameNode() === d)
+          return;
+        const c = d.getText();
+        o.has(c) || h.add(d.getText());
+      });
+  }
+}
+function A(e) {
+  const n = /* @__PURE__ */ new Map(), o = /* @__PURE__ */ new Set(), l = e.getStatements();
+  let u;
+  for (let d = 0; d < l.length; d += 1) {
+    const t = l[d];
+    if (!t.isKind(g.ImportDeclaration)) {
+      const f = t.getName?.();
+      f !== void 0 && o.add(f);
+      continue;
+    }
+    u = t;
+    const c = t.getModuleSpecifierValue(), p = n.get(c);
+    p === void 0 ? n.set(c, [t]) : p.push(t);
+    const r = t.getImportClause();
+    if (r === void 0)
+      continue;
+    const i = r.getDefaultImport()?.getText();
+    i !== void 0 && o.add(i);
+    const m = r.getNamedBindings();
+    if (m !== void 0)
+      if (m.isKind(g.NamedImports))
+        for (const s of m.getElements()) {
+          const f = s.getName();
+          o.add(f);
+        }
+      else {
+        const s = m.getName();
+        o.add(s);
+      }
+  }
+  const a = u === void 0 ? 0 : u.getChildIndex() + 1;
+  return { specifiers: n, names: o, lastImportIndex: a };
+}
+function P(e, n, o, l) {
+  if (l !== void 0) {
+    if (e === "default")
+      for (const u of l) {
+        const a = u.getDefaultImport();
+        if (a !== void 0) {
+          o[n] ??= [], o[n].push(a.getText());
+          return;
+        }
+      }
+    else if (e === "*")
+      for (const u of l) {
+        const a = u.getNamespaceImport();
+        if (a !== void 0) {
+          o[n] ??= [], o[n].push(a.getText());
+          return;
+        }
+      }
+    else
+      for (const u of l)
+        for (const a of u.getNamedImports())
+          if (a.getName() === e) {
+            o[n] ??= [], o[n].push(a.getName());
+            return;
+          }
+  }
+}
+function E(e, n, o, l, u, a, d) {
+  const t = n === "default";
+  if (t || n === "*") {
+    if (l !== void 0)
+      for (const p of l) {
+        const r = t ? p.getDefaultImport() : p.getNamespaceImport();
+        if (r !== void 0) {
+          o.isTypeOnly !== !0 && p.isTypeOnly() && p.setIsTypeOnly(!1), u.push({
+            specifier: e,
+            requestedName: n,
+            actualName: r.getText()
+          });
+          return;
+        }
+      }
+    const c = O(o.preferredAlias, void 0, e, d);
+    u.push({ specifier: e, requestedName: n, actualName: c }), a[e] ??= {
+      afterDeclaration: void 0,
+      named: [],
+      default: void 0,
+      "*": void 0
+    }, a[e].afterDeclaration ??= l?.[0], a[e][n] = {
+      name: c,
+      isTypeOnly: o.isTypeOnly === !0
+    };
+  } else {
+    let c, p;
+    if (l !== void 0) {
+      let m = !1;
+      for (const s of l)
+        if (s.getNamespaceImport() === void 0) {
+          p ??= s, c ??= s.isTypeOnly() && s.getDefaultImport() === void 0 ? s : void 0;
+          for (const f of s.getNamedImports())
+            if (f.getNameNode().getText() === n) {
+              if (m = !0, o.isTypeOnly !== !0) {
+                if (f.isTypeOnly())
+                  f.setIsTypeOnly(!1);
+                else if (s.isTypeOnly()) {
+                  for (const y of s.getNamedImports())
+                    y !== f && y.setIsTypeOnly(!0);
+                  s.setIsTypeOnly(!1);
+                }
+              }
+              u.push({
+                specifier: e,
+                requestedName: n,
+                actualName: f.getAliasNode()?.getText() ?? n
+              });
+              break;
+            }
+        }
+      if (m)
+        return;
+    }
+    const r = O(
+      o.preferAlias === !0 ? o.preferredAlias : n,
+      o.preferAlias === !0 ? n : o.preferredAlias,
+      e,
+      d
+    ), i = n === r ? void 0 : r;
+    if (o.isTypeOnly && c !== void 0)
+      c.addNamedImport({
+        name: n,
+        alias: i
+      });
+    else if (p !== void 0 && (!o.isTypeOnly || p.getDefaultImport() === void 0)) {
+      if (p.isTypeOnly() && !o.isTypeOnly) {
+        p.setIsTypeOnly(!1);
+        for (const m of p.getNamedImports())
+          m.setIsTypeOnly(!0);
+      }
+      p.addNamedImport({
+        name: n,
+        alias: i,
+        isTypeOnly: o.isTypeOnly && !p.isTypeOnly()
+      });
+    } else
+      a[e] ??= {
+        afterDeclaration: void 0,
+        named: [],
+        default: void 0,
+        "*": void 0
+      }, a[e].afterDeclaration ??= l?.[0], a[e].named.push({
+        name: n,
+        alias: i,
+        isTypeOnly: o.isTypeOnly === !0
+      });
+    u.push({ specifier: e, requestedName: n, actualName: r });
+  }
+}
+function W(e, n, o, l, u, a, d) {
+  if (l === void 0)
+    return;
+  const t = o.name ?? n, c = o.specifier ?? e, p = n === "default";
+  if (p || n === "*") {
+    for (const r of l) {
+      const i = p ? r.getDefaultImport() : r.getNamespaceImport();
+      if (i === void 0)
+        continue;
+      if (o.isTypeOnly === !1 && r.isTypeOnly()) {
+        r.setIsTypeOnly(!1);
+        for (const s of r.getNamedImports())
+          s.setIsTypeOnly(!0);
+      }
+      let m = t;
+      if (t !== n) {
+        const s = O(t, n, e, d);
+        t === s ? i.rename(t) : m = i.getText();
+      } else
+        m = i.getText();
+      e !== c && (r.getNamedImports().length === 0 ? r.setModuleSpecifier(c) : (p ? r.removeDefaultImport() : r.removeNamespaceImport(), a[c] ??= {
+        afterDeclaration: void 0,
+        named: [],
+        default: void 0,
+        "*": void 0
+      }, a[c].afterDeclaration ??= r, a[c][n] = {
+        name: m,
+        isTypeOnly: r.isTypeOnly()
+      })), u.push({
+        specifier: c,
+        requestedName: n,
+        actualName: m
+      });
+      break;
+    }
+    return;
+  }
+  for (const r of l)
+    for (const i of r.getNamedImports()) {
+      if (i.getNameNode().getText() !== n)
+        continue;
+      if (o.isTypeOnly === !1) {
+        if (i.isTypeOnly())
+          i.setIsTypeOnly(!1);
+        else if (r.isTypeOnly()) {
+          r.setIsTypeOnly(!1);
+          for (const f of r.getNamedImports())
+            f !== i && f.setIsTypeOnly(!0);
+        }
+      }
+      let m = t;
+      const s = i.getAliasNode();
+      if (t !== n)
+        if (s === void 0) {
+          const f = O(t, n, e, d);
+          t === f ? i.getNameNode().asKind(g.Identifier)?.rename(t) : (i.setAlias(n), i.getNameNode().replaceWithText(t), m = n);
+        } else
+          i.getNameNode().replaceWithText(t), m = s.getText();
+      if (c !== e) {
+        const y = (w(x.project.projectData) || r.getModuleSpecifierValue().endsWith(".js")) && c.startsWith("@arcgis/core") ? `${c}.js` : c;
+        r.getNamedImports().length === 1 && r.getDefaultImport() === void 0 ? r.setModuleSpecifier(y) : (a[y] ??= {
+          afterDeclaration: void 0,
+          named: [],
+          default: void 0,
+          "*": void 0
+        }, a[y].afterDeclaration ??= l?.[0], a[y].named.push({
+          name: t,
+          alias: t === m ? void 0 : m,
+          isTypeOnly: i.isTypeOnly()
+        }), i.remove());
+      }
+      u.push({
+        specifier: c,
+        requestedName: t,
+        actualName: s?.getText() ?? m
+      });
+      return;
+    }
+}
+function O(e, n, o, l) {
+  if (e !== void 0) {
+    if (!l.has(e) && !h.has(e))
+      return l.add(e), e;
+    if (n !== void 0)
+      return O(n, void 0, o, l);
+  }
+  o.startsWith("@arcgis/core") && (o = `arcgisCore${o.slice(12)}`);
+  const u = o.split("/");
+  let a = e ?? "";
+  for (let d = u.length - 1; d >= 0; d--) {
+    const t = u[d].replaceAll($, "");
+    if (t !== a && (a = t + S(a), !l.has(a) && !h.has(a)))
+      return l.add(a), a;
+  }
+  for (let d = 2; ; d++) {
+    const t = a + d;
+    if (!l.has(t) && !h.has(t))
+      return l.add(t), t;
+  }
+}
+const $ = /[^a-zA-Z0-9$_]/gu, M = (e) => e.startsWith(".") ? e : `./${e}`, h = /* @__PURE__ */ new Set();
+let j;
+export {
+  b as a,
+  C as f,
+  J as p,
+  K as u
+};