@arcgis/codemod 5.0.0-next.162

package/dist/codemod-mjvq6uf5.js

@@ -0,0 +1,156 @@
+var m = (o, i) => (i = Symbol[o]) ? i : Symbol.for("Symbol." + o), d = (o) => {
+  throw TypeError(o);
+};
+var p = (o, i, r) => {
+  if (i != null) {
+    typeof i != "object" && typeof i != "function" && d("Object expected");
+    var a, t;
+    r && (a = i[m("asyncDispose")]), a === void 0 && (a = i[m("dispose")], r && (t = a)), typeof a != "function" && d("Object not disposable"), t && (a = function() {
+      try {
+        t.call(this);
+      } catch (s) {
+        return Promise.reject(s);
+      }
+    }), o.push([r, a, i]);
+  } else r && o.push([r]);
+  return i;
+}, f = (o, i, r) => {
+  var a = typeof SuppressedError == "function" ? SuppressedError : function(e, n, c, l) {
+    return l = Error(c), l.name = "SuppressedError", l.error = e, l.suppressed = n, l;
+  }, t = (e) => i = r ? new a(e, i, "An error was suppressed during disposal") : (r = !0, e), s = (e) => {
+    for (; e = o.pop(); )
+      try {
+        var n = e[1] && e[1].call(e[2]);
+        if (e[0]) return Promise.resolve(n).then(s, (c) => (t(c), s()));
+      } catch (c) {
+        t(c);
+      }
+    if (r) throw i;
+  };
+  return s();
+};
+import { f as k, c as u, p as E } from "./useProjectInstance-CK5Fhtu-.js";
+import { log as g } from "@arcgis/toolkit/log";
+import { writeFile as b } from "node:fs/promises";
+import { p as h, g as y } from "./cli-DB4-Ai2J.js";
+async function L(o, i) {
+  const r = /* @__PURE__ */ new Set();
+  for (const a of o) {
+    const t = a.packageJson;
+    if (t === void 0 || r.has(t.filePath))
+      continue;
+    r.add(t.filePath);
+    const s = t.contents;
+    try {
+      const e = await i(s, t.filePath);
+      s !== e && await b(t.filePath, `${JSON.stringify(e, null, 2)}
+`, "utf8");
+    } catch (e) {
+      process.exitCode = 1, g(
+        "error",
+        k(t.filePath),
+        `Error occurred while migrating: ${String(e)}`,
+        typeof e == "object" && e !== null && "stack" in e ? { detail: { stack: e.stack } } : void 0
+      );
+    }
+  }
+}
+function P(o, i) {
+  for (const r of ["dependencies", "devDependencies", "peerDependencies", "optionalDependencies"]) {
+    const a = o[r];
+    if (a) {
+      const t = i(a, r);
+      t !== a && (o = { ...o, [r]: t });
+    }
+  }
+  return o;
+}
+const C = {
+  meta: {
+    needsTypeInformation: !1
+  },
+  async run(o) {
+    await L(
+      o,
+      (s) => P(
+        s,
+        (e) => e["@arcgis/components-utils"] ? {
+          ...e,
+          "@arcgis/components-utils": void 0,
+          "@arcgis/toolkit": e["@arcgis/components-utils"]
+        } : e
+      )
+    );
+    for (const s of o) {
+      var i = [];
+      try {
+        const e = p(i, u(s));
+        for (const n of e.getCodemodFiles())
+          E(n, {
+            "@arcgis/components-utils": {
+              // Deprecated
+              setFocusOnElement: [{ do: "deprecate" }, { do: "rename", specifier: "@arcgis/toolkit/dom" }],
+              setValuesInString: [{ do: "deprecate" }, { do: "rename", specifier: "@arcgis/toolkit/string" }],
+              IHandle: [{ do: "deprecate" }, { do: "rename", specifier: "@arcgis/toolkit/type" }],
+              Deferred: [{ do: "deprecate" }, { do: "rename", specifier: "@arcgis/toolkit/promise" }],
+              // Renamed
+              addLTRMark: { do: "rename", specifier: "@arcgis/toolkit/string", name: "addLtrMark" },
+              getElementTheme: { do: "rename", specifier: "@arcgis/toolkit/dom", name: "unsafeGetCalciteModeName" },
+              getElementDir: { do: "rename", specifier: "@arcgis/toolkit/dom", name: "unsafeGetElementDirection" },
+              unsafeGetModeName: { do: "rename", specifier: "@arcgis/toolkit/dom", name: "unsafeGetCalciteModeName" },
+              getElementLocales: { do: "rename", specifier: "@arcgis/toolkit/intl", name: "getElementLocale" },
+              LocaleObserver: { do: "rename", specifier: "@arcgis/toolkit/intl", name: "LocaleObserverResult" },
+              Nil: { do: "rename", specifier: "@arcgis/toolkit/type", name: "nil" },
+              closestElement: { do: "rename", specifier: "@arcgis/toolkit/dom", name: "getClosestElement" },
+              extractMinorVersion: { do: "rename", specifier: "@arcgis/toolkit/string", name: "getMinorVersion" },
+              isURL: { do: "rename", specifier: "@arcgis/toolkit/string", name: "isUrl" },
+              mappedFind: { do: "rename", specifier: "@arcgis/toolkit/array" },
+              classes: { do: "rename", specifier: "@arcgis/toolkit/dom" },
+              // Relocated
+              observeAncestorsMutation: { do: "rename", specifier: "@arcgis/toolkit/dom" },
+              getElementAttribute: { do: "rename", specifier: "@arcgis/toolkit/dom" },
+              FocusableElement: { do: "rename", specifier: "@arcgis/toolkit/dom" },
+              focusElement: { do: "rename", specifier: "@arcgis/toolkit/dom" },
+              devToolsAwareTimeout: { do: "rename", specifier: "@arcgis/toolkit/promise" },
+              isEsriInternalEnv: { do: "rename", specifier: "@arcgis/toolkit/error" },
+              safeCall: { do: "rename", specifier: "@arcgis/toolkit/error" },
+              safeAsyncCall: { do: "rename", specifier: "@arcgis/toolkit/error" },
+              generateGuid: { do: "rename", specifier: "@arcgis/toolkit/string" },
+              getPreamble: { do: "rename", specifier: "@arcgis/toolkit/string" },
+              quoteString: { do: "rename", specifier: "@arcgis/toolkit/string" },
+              createFilterExpression: { do: "rename", specifier: "@arcgis/toolkit/string" },
+              kebabToPascal: { do: "rename", specifier: "@arcgis/toolkit/string" },
+              camelToKebab: { do: "rename", specifier: "@arcgis/toolkit/string" },
+              camelToHuman: { do: "rename", specifier: "@arcgis/toolkit/string" },
+              capitalize: { do: "rename", specifier: "@arcgis/toolkit/string" },
+              uncapitalize: { do: "rename", specifier: "@arcgis/toolkit/string" },
+              GenericT9nStrings: { do: "rename", specifier: "@arcgis/toolkit/intl" },
+              supportedLocales: { do: "rename", specifier: "@arcgis/toolkit/intl" },
+              SupportedLocale: { do: "rename", specifier: "@arcgis/toolkit/intl" },
+              defaultLocale: { do: "rename", specifier: "@arcgis/toolkit/intl" },
+              fetchT9nStringsBundle: { do: "rename", specifier: "@arcgis/toolkit/intl" },
+              normalizeLocale: { do: "rename", specifier: "@arcgis/toolkit/intl" },
+              startLocaleObserver: { do: "rename", specifier: "@arcgis/toolkit/intl" },
+              isNotNull: { do: "rename", specifier: "@arcgis/toolkit/predicate" },
+              isNotUndefined: { do: "rename", specifier: "@arcgis/toolkit/predicate" },
+              debounce: { do: "rename", specifier: "@arcgis/toolkit/function" },
+              identity: { do: "rename", specifier: "@arcgis/toolkit/function" },
+              hasSameOrigin: { do: "rename", specifier: "@arcgis/toolkit/url" }
+            }
+          });
+      } catch (r) {
+        var a = r, t = !0;
+      } finally {
+        f(i, a, t);
+      }
+    }
+    h(), g(
+      "info",
+      y.codemodName,
+      "Next step: run npm install/pnpm install/yarn install to get @arcgis/toolkit package installed."
+    );
+  }
+};
+export {
+  C as codemod
+};

package/dist/useProjectInstance-CK5Fhtu-.js

@@ -0,0 +1,398 @@
+import { path as T } from "@arcgis/components-build-utils";
+import { SyntaxKind as y, Project as j } from "ts-morph";
+import { g as h, d as C } from "./cli-DB4-Ai2J.js";
+import { ModuleResolutionKind as D } from "typescript";
+import { capitalize as q } from "@arcgis/toolkit/string";
+import { log as w } from "@arcgis/toolkit/log";
+import { styleText as S } from "node:util";
+function b(e) {
+  const t = e.typeScriptConfig?.compilerOptions?.moduleResolution ?? D.Bundler;
+  return t >= D.Node16 && t <= D.NodeNext;
+}
+function A(e) {
+  return K(e.getFilePath());
+}
+function K(e) {
+  return T.relative(process.cwd(), e);
+}
+function Z(e, t) {
+  const n = {};
+  E(e);
+  const { specifiers: r, names: f, lastImportIndex: s } = F(e), d = [], o = {};
+  let m = b(h.project.projectData);
+  for (const [a, p] of Object.entries(t)) {
+    let i = r.get(a) ?? (a.startsWith(".") ? r.get(
+      T.relative(e.getDirectoryPath(), T.resolve(h.project.projectData.cwd, a))
+    ) : void 0);
+    if (i === void 0) {
+      const c = r.get(`${a}.js`);
+      c !== void 0 && (m = !0, i === void 0 ? i = c : i = [...i, ...c]);
+    }
+    for (const [c, g] of Object.entries(p)) {
+      const N = Array.isArray(g) ? g : [g];
+      for (const I of N)
+        I.do === "deprecate" ? $(c, a, n, i) : I.do === "add" ? k(a, c, I, i, d, o, f) : I.do === "rename" && M(a, c, I, i, d, o, f);
+    }
+  }
+  const u = Object.entries(o);
+  let l = s;
+  for (let a = 0; a < u.length; a += 1) {
+    const [p, i] = u[a], c = p.startsWith(".") ? R(
+      T.relative(e.getDirectoryPath(), T.resolve(h.project.projectData.cwd, p))
+    ) : p, g = m && c.startsWith("@arcgis/core") ? `${c}.js` : c, N = i.afterDeclaration === void 0 ? l : i.afterDeclaration.getChildIndex() + 1;
+    if (i.named.length > 0) {
+      let I = !0;
+      for (let v = 0; v < i.named.length; v += 1)
+        I &&= i.named[v].isTypeOnly;
+      e.insertImportDeclaration(N, {
+        isTypeOnly: I,
+        moduleSpecifier: g,
+        namedImports: i.named.map((v) => ({
+          name: v.name,
+          alias: v.alias,
+          isTypeOnly: v.isTypeOnly && !I
+        }))
+      }), l += 1;
+    }
+    i.default !== void 0 && (e.insertImportDeclaration(N, {
+      isTypeOnly: i.default.isTypeOnly,
+      moduleSpecifier: g,
+      defaultImport: i.default.name
+    }), l += 1), i["*"] !== void 0 && (e.insertImportDeclaration(N, {
+      isTypeOnly: i["*"].isTypeOnly,
+      moduleSpecifier: g,
+      namespaceImport: i["*"].name
+    }), l += 1);
+  }
+  if (Object.keys(n).length > 0) {
+    const a = Object.entries(n).map(([p, i]) => `${i.join(", ")} from ${p}`).join("; ");
+    w("warn", A(e), `Deprecated API usages found: ${a}`);
+  }
+  return d;
+}
+function E(e) {
+  const t = e.getChildSyntaxList()?.getFirstChild();
+  if (P === t)
+    return;
+  P = t, O.clear();
+  const n = /* @__PURE__ */ new Set();
+  r(e);
+  function r(f) {
+    for (const s of f.getStatements())
+      if (s.isKind(y.ImportDeclaration)) {
+        const d = s.getDefaultImport(), o = s.getNamespaceImport(), m = s.getNamedImports();
+        d && n.add(d.getText()), o && n.add(o.getText());
+        for (const u of m)
+          n.add(u.getAliasNode()?.getText() ?? u.getName());
+      } else s.isKind(y.ImportEqualsDeclaration) ? n.add(s.getName()) : s.isKind(y.ModuleDeclaration) ? r(s) : f.forEachDescendant((d) => {
+        if (!d.isKind(y.Identifier))
+          return;
+        const o = d.getParent();
+        if (o.isKind(y.QualifiedName) && o.getLeft() !== d || o.isKind(y.PropertyAccessExpression) && o.getExpression() !== d || (o.isKind(y.PropertyDeclaration) || o.isKind(y.PropertySignature) || o.isKind(y.PropertyAssignment)) && o.getNameNode() === d)
+          return;
+        const m = d.getText();
+        n.has(m) || O.add(d.getText());
+      });
+  }
+}
+function F(e) {
+  const t = /* @__PURE__ */ new Map(), n = /* @__PURE__ */ new Set(), r = e.getStatements();
+  let f;
+  for (let d = 0; d < r.length; d += 1) {
+    const o = r[d];
+    if (!o.isKind(y.ImportDeclaration)) {
+      const c = o.getName?.();
+      c !== void 0 && n.add(c);
+      continue;
+    }
+    f = o;
+    const m = o.getModuleSpecifierValue(), u = t.get(m);
+    u === void 0 ? t.set(m, [o]) : u.push(o);
+    const l = o.getImportClause();
+    if (l === void 0)
+      continue;
+    const a = l.getDefaultImport()?.getText();
+    a !== void 0 && n.add(a);
+    const p = l.getNamedBindings();
+    if (p !== void 0)
+      if (p.isKind(y.NamedImports))
+        for (const i of p.getElements()) {
+          const c = i.getName();
+          n.add(c);
+        }
+      else {
+        const i = p.getName();
+        n.add(i);
+      }
+  }
+  const s = f === void 0 ? 0 : f.getChildIndex() + 1;
+  return { specifiers: t, names: n, lastImportIndex: s };
+}
+function $(e, t, n, r) {
+  if (r !== void 0) {
+    if (e === "default")
+      for (const f of r) {
+        const s = f.getDefaultImport();
+        if (s !== void 0) {
+          n[t] ??= [], n[t].push(s.getText());
+          return;
+        }
+      }
+    else if (e === "*")
+      for (const f of r) {
+        const s = f.getNamespaceImport();
+        if (s !== void 0) {
+          n[t] ??= [], n[t].push(s.getText());
+          return;
+        }
+      }
+    else
+      for (const f of r)
+        for (const s of f.getNamedImports())
+          if (s.getName() === e) {
+            n[t] ??= [], n[t].push(s.getName());
+            return;
+          }
+  }
+}
+function k(e, t, n, r, f, s, d) {
+  const o = t === "default";
+  if (o || t === "*") {
+    if (r !== void 0)
+      for (const u of r) {
+        const l = o ? u.getDefaultImport() : u.getNamespaceImport();
+        if (l !== void 0) {
+          n.isTypeOnly !== !0 && u.isTypeOnly() && u.setIsTypeOnly(!1), f.push({
+            specifier: e,
+            requestedName: t,
+            actualName: l.getText()
+          });
+          return;
+        }
+      }
+    const m = x(n.preferredAlias, void 0, e, d);
+    f.push({ specifier: e, requestedName: t, actualName: m }), s[e] ??= {
+      afterDeclaration: void 0,
+      named: [],
+      default: void 0,
+      "*": void 0
+    }, s[e].afterDeclaration ??= r?.[0], s[e][t] = {
+      name: m,
+      isTypeOnly: n.isTypeOnly === !0
+    };
+  } else {
+    let m, u;
+    if (r !== void 0) {
+      let p = !1;
+      for (const i of r)
+        if (i.getNamespaceImport() === void 0) {
+          u ??= i, m ??= i.isTypeOnly() && i.getDefaultImport() === void 0 ? i : void 0;
+          for (const c of i.getNamedImports())
+            if (c.getNameNode().getText() === t) {
+              if (p = !0, n.isTypeOnly !== !0) {
+                if (c.isTypeOnly())
+                  c.setIsTypeOnly(!1);
+                else if (i.isTypeOnly()) {
+                  for (const g of i.getNamedImports())
+                    g !== c && g.setIsTypeOnly(!0);
+                  i.setIsTypeOnly(!1);
+                }
+              }
+              f.push({
+                specifier: e,
+                requestedName: t,
+                actualName: c.getAliasNode()?.getText() ?? t
+              });
+              break;
+            }
+        }
+      if (p)
+        return;
+    }
+    const l = x(
+      n.preferAlias === !0 ? n.preferredAlias : t,
+      n.preferAlias === !0 ? t : n.preferredAlias,
+      e,
+      d
+    ), a = t === l ? void 0 : l;
+    if (n.isTypeOnly && m !== void 0)
+      m.addNamedImport({
+        name: t,
+        alias: a
+      });
+    else if (u !== void 0 && (!n.isTypeOnly || u.getDefaultImport() === void 0)) {
+      if (u.isTypeOnly() && !n.isTypeOnly) {
+        u.setIsTypeOnly(!1);
+        for (const p of u.getNamedImports())
+          p.setIsTypeOnly(!0);
+      }
+      u.addNamedImport({
+        name: t,
+        alias: a,
+        isTypeOnly: n.isTypeOnly && !u.isTypeOnly()
+      });
+    } else
+      s[e] ??= {
+        afterDeclaration: void 0,
+        named: [],
+        default: void 0,
+        "*": void 0
+      }, s[e].afterDeclaration ??= r?.[0], s[e].named.push({
+        name: t,
+        alias: a,
+        isTypeOnly: n.isTypeOnly === !0
+      });
+    f.push({ specifier: e, requestedName: t, actualName: l });
+  }
+}
+function M(e, t, n, r, f, s, d) {
+  if (r === void 0)
+    return;
+  const o = n.name ?? t, m = n.specifier ?? e, u = t === "default";
+  if (u || t === "*") {
+    for (const l of r) {
+      const a = u ? l.getDefaultImport() : l.getNamespaceImport();
+      if (a === void 0)
+        continue;
+      if (n.isTypeOnly === !1 && l.isTypeOnly()) {
+        l.setIsTypeOnly(!1);
+        for (const i of l.getNamedImports())
+          i.setIsTypeOnly(!0);
+      }
+      let p = o;
+      if (o !== t) {
+        const i = x(o, t, e, d);
+        o === i ? a.rename(o) : p = a.getText();
+      } else
+        p = a.getText();
+      e !== m && (l.getNamedImports().length === 0 ? l.setModuleSpecifier(m) : (u ? l.removeDefaultImport() : l.removeNamespaceImport(), s[m] ??= {
+        afterDeclaration: void 0,
+        named: [],
+        default: void 0,
+        "*": void 0
+      }, s[m].afterDeclaration ??= l, s[m][t] = {
+        name: p,
+        isTypeOnly: l.isTypeOnly()
+      })), f.push({
+        specifier: m,
+        requestedName: t,
+        actualName: p
+      });
+      break;
+    }
+    return;
+  }
+  for (const l of r)
+    for (const a of l.getNamedImports()) {
+      if (a.getNameNode().getText() !== t)
+        continue;
+      if (n.isTypeOnly === !1) {
+        if (a.isTypeOnly())
+          a.setIsTypeOnly(!1);
+        else if (l.isTypeOnly()) {
+          l.setIsTypeOnly(!1);
+          for (const c of l.getNamedImports())
+            c !== a && c.setIsTypeOnly(!0);
+        }
+      }
+      let p = o;
+      const i = a.getAliasNode();
+      if (o !== t)
+        if (i === void 0) {
+          const c = x(o, t, e, d);
+          o === c ? a.getNameNode().asKind(y.Identifier)?.rename(o) : (a.setAlias(t), a.getNameNode().replaceWithText(o), p = t);
+        } else
+          a.getNameNode().replaceWithText(o), p = i.getText();
+      if (m !== e) {
+        const g = (b(h.project.projectData) || l.getModuleSpecifierValue().endsWith(".js")) && m.startsWith("@arcgis/core") ? `${m}.js` : m;
+        l.getNamedImports().length === 1 && l.getDefaultImport() === void 0 ? l.setModuleSpecifier(g) : (s[g] ??= {
+          afterDeclaration: void 0,
+          named: [],
+          default: void 0,
+          "*": void 0
+        }, s[g].afterDeclaration ??= r?.[0], s[g].named.push({
+          name: o,
+          alias: o === p ? void 0 : p,
+          isTypeOnly: a.isTypeOnly()
+        }), a.remove());
+      }
+      f.push({
+        specifier: m,
+        requestedName: o,
+        actualName: i?.getText() ?? p
+      });
+      return;
+    }
+}
+function x(e, t, n, r) {
+  if (e !== void 0) {
+    if (!r.has(e) && !O.has(e))
+      return r.add(e), e;
+    if (t !== void 0)
+      return x(t, void 0, n, r);
+  }
+  n.startsWith("@arcgis/core") && (n = `arcgisCore${n.slice(12)}`);
+  const f = n.split("/");
+  let s = e ?? "";
+  for (let d = f.length - 1; d >= 0; d--) {
+    const o = f[d].replaceAll(W, "");
+    if (o !== s && (s = o + q(s), !r.has(s) && !O.has(s)))
+      return r.add(s), s;
+  }
+  for (let d = 2; ; d++) {
+    const o = s + d;
+    if (!r.has(o) && !O.has(o))
+      return r.add(o), o;
+  }
+}
+const W = /[^a-zA-Z0-9$_]/gu, R = (e) => e.startsWith(".") ? e : `./${e}`, O = /* @__PURE__ */ new Set();
+let P;
+function _(e) {
+  if (h.project !== void 0)
+    throw Error(
+      "A different ts-morph Project is already in use. Dispose of it before creating a new one. Example: using project = createProjectInstance(...)"
+    );
+  const t = h.codemod.meta.needsTypeInformation, n = new j({
+    // If tsconfig is missing, or project is untyped, use a permissive and
+    // compatible default config
+    compilerOptions: e.typeScriptConfig?.compilerOptions ?? {
+      ...C,
+      // Read types from JSDoc annotations if present
+      checkJs: t
+    },
+    // We take care of reading the config file
+    tsConfigFilePath: void 0,
+    // We add files manually below
+    skipAddingFilesFromTsConfig: !0,
+    // We call this manually if needed below.
+    skipFileDependencyResolution: !0,
+    skipLoadingLibFiles: !t
+  });
+  for (const s of e.filePaths)
+    n.addSourceFileAtPath(s);
+  t && n.resolveSourceFileDependencies();
+  const r = T.relative(process.cwd(), e.cwd);
+  w(
+    "info",
+    r === "" ? process.cwd() : r,
+    `Running the codemod on ${S("blue", String(e.filePaths.length))} file${e.filePaths.length !== 1 ? "s" : ""}${e.packageJson?.contents.name === void 0 ? "" : ` from ${S("blue", e.packageJson.contents.name)}`}`
+  );
+  const f = {
+    [Symbol.dispose]() {
+      n.saveSync(), n.getRootDirectories().forEach((s) => s.forget()), h.project = void 0;
+    },
+    projectData: e,
+    // Any files added after projectData.filePaths are supporting files for type
+    // checking, but are not codemod targets.
+    getCodemodFiles: () => n.getSourceFiles().slice(0, e.filePaths.length),
+    tsMorph: n
+  };
+  return h.project = f, f;
+}
+export {
+  A as a,
+  _ as c,
+  K as f,
+  Z as p,
+  E as u
+};

package/package.json

@@ -0,0 +1,24 @@
+{
+  "name": "@arcgis/codemod",
+  "version": "5.0.0-next.162",
+  "type": "module",
+  "exports": {
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist/"
+  ],
+  "bin": "./dist/cli.js",
+  "license": "SEE LICENSE IN LICENSE.md",
+  "dependencies": {
+    "@commander-js/extra-typings": "^14.0.0",
+    "commander": "^14.0.0",
+    "tinyglobby": "^0.2.15",
+    "ts-morph": "^27.0.2",
+    "tslib": "^2.8.1",
+    "typescript": "~5.9.3",
+    "vite": "^7.2.2",
+    "@arcgis/components-build-utils": "5.0.0-next.162",
+    "@arcgis/toolkit": "5.0.0-next.162"
+  }
+}