@arcgis/api-extractor 5.1.0-next.3 → 5.1.0-next.30

package/dist/{ApiExtractor-CrpDQ5W0.js → ApiExtractor-BgMBwjdY.js}

@@ -1,5 +1,5 @@
-import { l as H, a as se, e as Re, p as fe } from "./typeScript-BssxHUy7.js";
-import { a as be, o as Me, t as Ge, b as De, c as Le, e as Oe, d as _, p as Ne, f as Be, i as me, g as We, h as Ue, j as ze, k as je, n as He, r as Je } from "./worker-BzfmcnyC.js";
+import { l as H, a as se, e as Re, p as fe } from "./typeScript-Cp7xTsD-.js";
+import { a as be, o as Me, t as Ge, b as De, c as Le, e as Oe, p as Ne, d as Be, f as _, i as me, g as We, h as Ue, j as ze, k as je, n as He, r as Je } from "./worker-fSgFrme6.js";
 import { getViewUrl as Ve, postProcessDeprecated as ee, postProcessDescription as G, postProcessDocsTags as V, resolveJsDocLink as Xe } from "./extractor/processing/links.js";
 import E from "typescript";
 import { path as N, toPosixPathSeparators as Ye } from "@arcgis/components-build-utils";
@@ -7,7 +7,7 @@ import { mkdir as ae, writeFile as xe } from "fs/promises";
 import x from "chalk";
 import { styleText as qe } from "util";
 import { kebabToPascal as Ze } from "@arcgis/toolkit/string";
-import { g as h, a as Q, b as _e, c as Ke, d as le, e as Pe, f as oe, p as Qe, h as et, i as ce, m as Ie, n as tt, j as it, k as nt } from "./apiHelpers-BYzO767m.js";
+import { g as h, a as Q, b as _e, c as Ke, d as le, e as Pe, f as oe, p as Qe, h as et, i as ce, m as Ie, n as tt, j as it, k as nt } from "./apiHelpers-DWMIGwi4.js";
 import { printTypeParameters as ie, printTypeAlias as ot } from "./utils/partPrinter.js";
 import { identity as Se, debounce as rt } from "@arcgis/toolkit/function";
 import { opendirSync as st, watch as at, readFileSync as lt, statSync as ct } from "node:fs";
@@ -1101,12 +1101,12 @@ function mt(e, t) {
   const s = e.exports?.[0]?.declaration.name, a = h(e);
   if (a.constructorPropertiesInterface !== void 0) {
     const o = a.constructorPropertiesInterface;
-    ue(o), w.length !== 0 && (n += pe(o, U, o.name, t));
+    ue(o), A.length !== 0 && (n += pe(o, U, o.name, t));
   }
   let r;
   for (let o = 0; o < e.declarations.length; ++o) {
     const l = e.declarations[o];
-    if (ue(l), w.length === 0)
+    if (ue(l), A.length === 0)
       continue;
     const c = l.name === s, d = c ? "default" : l.name, m = l.kind === "function", f = l.kind === "variable";
     if (m || f) {
@@ -1114,10 +1114,10 @@ function mt(e, t) {
         if (l.name === r)
           continue;
         if (r = l.name, c) {
-          w.length !== 1 && t.emitError("Expected only a single @esriCompatibilityName tag on a default export function.", {
+          A.length !== 1 && t.emitError("Expected only a single @esriCompatibilityName tag on a default export function.", {
             file: h(e).file,
             node: void 0
-          }), Z(w[0], t), D === void 0 && t.emitError("Expected default export @esriCompatibilityName tag to include a #", {
+          }), Z(A[0], t), D === void 0 && t.emitError("Expected default export @esriCompatibilityName tag to include a #", {
             file: h(e).file,
             node: void 0
           }), n += `  ${k}
@@ -1132,10 +1132,10 @@ function mt(e, t) {
           continue;
         }
       } else if (f && c) {
-        w.length !== 1 && t.emitError("Expected only a single @esriCompatibilityName tag on a default export variable.", {
+        A.length !== 1 && t.emitError("Expected only a single @esriCompatibilityName tag on a default export variable.", {
           file: h(e).file,
           node: void 0
-        }), Z(w[0], t), (D !== void 0 || B !== void 0) && t.emitError("Expected default export @esriCompatibilityName tag to not include a # or .", {
+        }), Z(A[0], t), (D !== void 0 || B !== void 0) && t.emitError("Expected default export @esriCompatibilityName tag to not include a # or .", {
           file: h(e).file,
           node: void 0
         }), n += `  export const ${O}: typeof ${i}.default;
@@ -1143,14 +1143,14 @@ function mt(e, t) {
 `;
         continue;
       }
-      for (let p = 0; p < w.length; ++p)
-        Z(w[p], t), f && z !== void 0 ? q += `    export const ${O}: ${i}.${d};
+      for (let p = 0; p < A.length; ++p)
+        Z(A[p], t), f && z !== void 0 ? q += `    export const ${O}: ${i}.${d};
 ` : te += `    ${O}: typeof ${i}.${d};
 `;
     } else if (l.kind === "class" || l.kind === "mixin" || l.kind === "interface" && Q(l).isMixinBaseClass === !0) {
       const p = ie(K(l.typeParameters, !1, U)), g = ie(K(l.typeParameters, !1, void 0)), u = ie(K(l.typeParameters, !0, void 0)), v = ` ${i}.${d}`;
-      for (let C = 0; C < w.length; ++C) {
-        if (Z(w[C], t), O.startsWith("$")) {
+      for (let C = 0; C < A.length; ++C) {
+        if (Z(A[C], t), O.startsWith("$")) {
           const M = O.slice(1);
           n += pt(M, l, d, U);
           continue;
@@ -1188,8 +1188,8 @@ ${te}  }
 function pe(e, t, i, n) {
   const s = ie(K(e.typeParameters, !1, void 0)), a = K(e.typeParameters, !1, t), r = `import("./${t}.js").${i}${s}`;
   let o = "";
-  for (let l = 0; l < w.length; ++l) {
-    Z(w[l], n);
+  for (let l = 0; l < A.length; ++l) {
+    Z(A[l], n);
     const c = ot(O, a, void 0, r);
     B === void 0 ? o += `  ${k}
   ${c}
@@ -1243,9 +1243,9 @@ function K(e, t, i) {
   return n.length === 0 ? void 0 : n;
 }
 const ne = [];
-let w = ne;
+let A = ne;
 function ue(e) {
-  e.kind === "variable" ? w = _e(e).esriCompatibilityNames ?? ne : e.kind === "function" ? w = Ke(e).esriCompatibilityNames ?? ne : w = Q(e).esriCompatibilityNames ?? ne;
+  e.kind === "variable" ? A = _e(e).esriCompatibilityNames ?? ne : e.kind === "function" ? A = Ke(e).esriCompatibilityNames ?? ne : A = Q(e).esriCompatibilityNames ?? ne;
 }
 function Z(e, t) {
   const i = e.indexOf(".");
@@ -1276,7 +1276,7 @@ function Z(e, t) {
 }
 function pt(e, t, i, n) {
   const s = ut(e, t.events), r = `${// IdentityManager fake class got renamed to IdentityManagerBase real class
-  t.name.startsWith(w[0]) ? w[0] : t.name}${Ze(e)}Event`, o = yt(s, n) ?? ` = import("./${n}.js").${i}["@eventTypes"]["${e}"]`, l = o.startsWith("<") ? o.indexOf(">") + 1 : -1, c = l !== -1 ? o.slice(0, l) : "";
+  t.name.startsWith(A[0]) ? A[0] : t.name}${Ze(e)}Event`, o = yt(s, n) ?? ` = import("./${n}.js").${i}["@eventTypes"]["${e}"]`, l = o.startsWith("<") ? o.indexOf(">") + 1 : -1, c = l !== -1 ? o.slice(0, l) : "";
   return `  ${k}
   export type ${r}${o};
   ${k}
@@ -1734,7 +1734,10 @@ function xt(e, t) {
 function he(e, t, i) {
   if (e.package !== void 0)
     return;
-  const n = t.moduleMap.get(e.module), s = h(n), a = s.constructorPropertiesInterface;
+  const n = t.moduleMap.get(e.module);
+  if (n === void 0)
+    return;
+  const s = h(n), a = s.constructorPropertiesInterface;
   if (a === void 0) {
     const o = s.inheritance;
     if (typeof o == "object" && o.hasSettableField) {
@@ -1899,7 +1902,7 @@ function Fe(e, t, i, n, s) {
       Fe(c, t, l, n, s);
     }
 }
-function we(e, t, i) {
+function Ae(e, t, i) {
   const n = h(e);
   if (n.inheritance !== void 0)
     return;
@@ -1999,7 +2002,7 @@ function ge(e, t, i, n) {
     a.cssStates,
     s.cssStates,
     e.indexedCssStates
-  ));
+  )), s.formAssociated === !0 && (a.formAssociated = !0);
 }
 function X(e = [], t, i, n) {
   const s = /* @__PURE__ */ new Set();
@@ -2020,7 +2023,7 @@ function ve(e, t, i) {
   if (s === !1 || n === void 0)
     return a !== void 0 ? a.inheritance = de.skip : t && i.privateMixinModuleNames.add(e), de.skip;
   const [r, o] = s, l = o;
-  we(n, o, i);
+  Ae(n, o, i);
   let c, d = !1;
   if (o.members !== void 0) {
     c = /* @__PURE__ */ Object.create(null);
@@ -2118,7 +2121,7 @@ function Ft(e, t) {
           file: h(n).file,
           node: void 0
         }
-      ), "members" in o && o.kind !== "interface" && (we(n, o, t), o.events?.sort(it));
+      ), "members" in o && o.kind !== "interface" && (Ae(n, o, t), o.events?.sort(it));
     }
   }
   for (let i = 0; i < e.length; ++i) {
@@ -2200,7 +2203,7 @@ function Ft(e, t) {
     s.constructorPropertiesInterface !== void 0 && xt(s, t), gt(n, s, t), Tt(n, s, t);
   }
 }
-const wt = async function() {
+const At = async function() {
   if (this.isRunInProgress)
     throw Error(
       "The ApiExtractor.run() is already in progress, or previous run crashed with unrecoverable error. Await the previous run first or create a new ApiExtractor"
@@ -2223,7 +2226,7 @@ const wt = async function() {
       });
       this.program = d, e.types.typeScriptInstanceCreated(d, c);
     }
-    Ae(this, o);
+    we(this, o);
   }
   const n = _(), s = await Oe(this);
   $t(s, this);
@@ -2265,7 +2268,7 @@ const wt = async function() {
       for (const [c, d] of this.dtsFiles)
         l.get(c) !== d && this.changedDtsFiles.set(c, d);
     if (t) {
-      await i, await ae(e.context.dtsEmitPath, { recursive: !0 }), await At(e.context.dtsEmitPath, !0, this.changedDtsFiles ?? this.dtsFiles);
+      await i, await ae(e.context.dtsEmitPath, { recursive: !0 }), await wt(e.context.dtsEmitPath, !0, this.changedDtsFiles ?? this.dtsFiles);
       const c = N.join(N.relative(process.cwd(), e.context.dtsEmitPath), "/");
       e.context.logger.info(
         `${H}Wrote ${c}**/*${x.blue(".d.ts")} in ${x.green(`${o()}s`)}`
@@ -2285,7 +2288,7 @@ const wt = async function() {
     `${H}${x.red(`Found ${this.errorCount} ${this.errorCount === 1 ? "error" : "errors"}`)}`
   ), this.silencedBrokenLinkCount > 0 && e.context.logger.info(`${H}Silenced ${this.silencedBrokenLinkCount} broken link errors.`), this.isRunInProgress = !1, this.produceDts && (r.dtsFiles = this.dtsFiles), r;
 };
-async function At(e, t, i) {
+async function wt(e, t, i) {
   const n = /* @__PURE__ */ new Set(), s = Array.from(i.entries());
   for (let l = 0; l < s.length; ++l) {
     const [c, d] = s[l];
@@ -2309,7 +2312,7 @@ async function At(e, t, i) {
   }
   await Promise.all(r);
 }
-function Ae(e, t) {
+function we(e, t) {
   if (e.config.types.fullTypeCheck)
     if ("getSemanticDiagnostics" in e.program) {
       const i = e.builderProgram === void 0 ? E.getPreEmitDiagnostics(e.program) : e.builderProgram.getSemanticDiagnostics();
@@ -2414,13 +2417,13 @@ const Rt = async function() {
   if (e.types.typeCheckedExtraction || e.types.fullTypeCheck) {
     const u = e.types.fullTypeCheck ? E.createSemanticDiagnosticsBuilderProgram : E.createAbstractBuilder;
     let v;
-    const C = (S, F, T, ...A) => (v = T, u(
+    const C = (S, F, T, ...w) => (v = T, u(
       // If not doing full type check, don't scout test files
       // If non-tests import tests, they will be included implicitly anyway
       e.types.fullTypeCheck ? S : S?.filter(($) => !ze($)),
       F,
       T,
-      ...A
+      ...w
       // Type cast to keep types simpler&aligned between two branches
     )), y = E.createWatchCompilerHost(
       // This parses the config file again (we already do it) and computes the
@@ -2458,17 +2461,17 @@ const Rt = async function() {
       e.types.typeScriptInstanceCreated(F, v);
       for (const $ of this.watchFiles.values())
         $.wasRemoved = !0;
-      let A = !1;
+      let w = !1;
       for (let $ = 0; $ < T.length; ++$) {
         const R = T[$];
         if (!me(R.fileName, this))
           continue;
         const j = R.fileName.slice(e.context.cwd.length), J = this.watchFiles.get(j);
-        J === void 0 ? (o(j, R, void 0), A = !0) : J.file !== R ? (s(J, j, R), A = !0) : J.wasRemoved = !1;
+        J === void 0 ? (o(j, R, void 0), w = !0) : J.file !== R ? (s(J, j, R), w = !0) : J.wasRemoved = !1;
       }
       for (const [$, R] of this.watchFiles)
-        R.wasRemoved && (a(R, $), A = !0);
-      A ? p() : (Ae(this, _()), f(void 0));
+        R.wasRemoved && (a(R, $), w = !0);
+      w ? p() : (we(this, _()), f(void 0));
     }, t = E.createWatchProgram(y);
   } else {
     let u = function(y) {
@@ -2486,7 +2489,7 @@ const Rt = async function() {
       if (I || P === void 0) {
         const S = u(b);
         if (S === !1) {
-          let T, A = !1;
+          let T, w = !1;
           try {
             T = st(b, { recursive: !0 });
             let $;
@@ -2494,12 +2497,12 @@ const Rt = async function() {
               if ($.isDirectory())
                 continue;
               const j = `${$.parentPath}/${$.name}`.slice(e.context.cwd.length);
-              We(j) && (A = C(j, !1) || A);
+              We(j) && (w = C(j, !1) || w);
             }
           } finally {
             T?.closeSync();
           }
-          return A;
+          return w;
         }
         const F = S === !0;
         if (L) {
@@ -2514,9 +2517,9 @@ const Rt = async function() {
             return o(y, void 0, void 0), !0;
           {
             let T = !1;
-            const A = `${y}/`;
+            const w = `${y}/`;
             for (const [$, R] of this.watchFiles)
-              $.startsWith(A) && (a(R, $), T = !0);
+              $.startsWith(w) && (a(R, $), T = !0);
             return T;
           }
         }
@@ -2625,7 +2628,7 @@ class qt {
    * @param rawConfig Optional configuration for the extractor.
    */
   constructor(t = {}) {
-    this.componentStories = /* @__PURE__ */ Object.create(null), this.dtsFiles = /* @__PURE__ */ new Map(), this.changedDtsFiles = void 0, this.isRunInProgress = !1, this.watchFiles = void 0, this.program = void 0, this.builderProgram = void 0, this.componentPathMapping = void 0, this.componentCssFileDocs = void 0, this.vanillaComponentTypes = void 0, this.isInLuminaMinimalExtraction = !1, this.errorCount = 0, this.silencedBrokenLinkCount = 0, this.loggedBooleanWarning = !1, this.moduleMap = void 0, this.privateMixinModuleNames = /* @__PURE__ */ new Set(), this.implicitPublicModules = void 0, this.file = void 0, this.apiModule = void 0, this.componentTagName = void 0, this.pairedSetter = void 0, this.statementJsDocs = [], this.jsDoc = void 0, this.apiObject = void 0, this.moduleContext = void 0, this.localDeclarations = /* @__PURE__ */ new Set(), this.exportDefaultName = void 0, this.objectLikeTypeParameters = void 0, this.functionLikeTypeParameters = void 0, this.apiClassLikeName = void 0, this.mixinName = void 0, this.mixinMixins = void 0, this.moduleHasAccessorLikeClass = !1, this.moduleHasClass = !1, this.inheritedModuleName = void 0, this.run = wt.bind(this), this.watch = Rt.bind(this), this.emitError = Re.bind(this);
+    this.componentStories = /* @__PURE__ */ Object.create(null), this.dtsFiles = /* @__PURE__ */ new Map(), this.changedDtsFiles = void 0, this.isRunInProgress = !1, this.watchFiles = void 0, this.program = void 0, this.builderProgram = void 0, this.componentPathMapping = void 0, this.componentCssFileDocs = void 0, this.vanillaComponentTypes = void 0, this.isInLuminaMinimalExtraction = !1, this.errorCount = 0, this.silencedBrokenLinkCount = 0, this.loggedBooleanWarning = !1, this.moduleMap = void 0, this.privateMixinModuleNames = /* @__PURE__ */ new Set(), this.implicitPublicModules = void 0, this.file = void 0, this.apiModule = void 0, this.componentTagName = void 0, this.pairedSetter = void 0, this.statementJsDocs = [], this.jsDoc = void 0, this.apiObject = void 0, this.moduleContext = void 0, this.localDeclarations = /* @__PURE__ */ new Set(), this.exportDefaultName = void 0, this.objectLikeTypeParameters = void 0, this.functionLikeTypeParameters = void 0, this.apiClassLikeName = void 0, this.mixinName = void 0, this.mixinMixins = void 0, this.moduleHasAccessorLikeClass = !1, this.moduleHasClass = !1, this.inheritedModuleName = void 0, this.run = At.bind(this), this.watch = Rt.bind(this), this.emitError = Re.bind(this);
     const i = Je(t);
     this.config = i, this.produceDts = i.types.forceProduceDts || i.context.dtsEmitPath !== "" || i.verify.typeCheckTypes, this.basePath = `${i.context.cwd}${i.context.basePath}`, this.normalizedApiReferencePrefix = `https://${this.config.documentation.host}${this.config.documentation.basePath}`, this.runtimeDependencyNames = /* @__PURE__ */ new Set([
       ...Object.keys(i.context.packageJson.dependencies ?? {}),
@@ -2657,5 +2660,5 @@ class qt {
 }
 export {
   qt as A,
-  At as w
+  wt as w
 };

package/dist/{apiHelpers-BYzO767m.js → apiHelpers-DWMIGwi4.js}

@@ -155,7 +155,7 @@ export {
   C as t,
   M as u,
   $ as v,
-  k as w,
-  S as x,
-  l as y
+  l as w,
+  k as x,
+  S as y
 };

package/dist/apiJson.d.ts

@@ -328,6 +328,13 @@ export interface ApiCustomElementDeclaration extends ApiClassDeclaration, ApiWit
    * @example "ArcgisCounter" (even if class name is `Counter`)
    */
   pascalCaseName: string;
+  /**
+   * True if the custom element is
+   * [form-associated](https://html.spec.whatwg.org/dev/custom-elements.html).
+   *
+   * @default false
+   */
+  formAssociated?: boolean;
   members: ApiCustomElementMember[];
   /**
    * The attributes that this element is known to understand.

package/dist/cli-7PX_wNxb.js

@@ -0,0 +1,34 @@
+import { writeFile as r, readFile as d } from "node:fs/promises";
+import { diffApiJson as m } from "./diff/diffApiJson.js";
+async function k({
+  oldPath: t,
+  newPath: i,
+  outputPath: o,
+  docsUrlPrefix: e
+}) {
+  const c = f(t), w = f(i), p = await c, l = await w, n = m(p, l);
+  if (typeof o == "string")
+    if (o.endsWith(".md")) {
+      const { apiDiffToMarkdown: s } = await import("./diff/apiDiffToMarkdown.js"), a = s(n, e);
+      await r(o, a, "utf-8");
+    } else
+      await r(o, JSON.stringify(n, null, 2), "utf-8");
+  else {
+    const { apiDiffToMarkdown: s } = await import("./diff/apiDiffToMarkdown.js"), a = s(n, e);
+    console.log(a);
+  }
+}
+async function f(t) {
+  if (t.startsWith("http://") || t.startsWith("https://")) {
+    const i = await fetch(t);
+    if (!i.ok)
+      throw new Error(`Failed to fetch api.json: ${i.statusText}`);
+    return await i.json();
+  } else {
+    const i = await d(t, "utf-8");
+    return JSON.parse(i);
+  }
+}
+export {
+  k as diffApiCli
+};

package/dist/cli.js

@@ -1,15 +1,15 @@
 #!/usr/bin/env node
-import { Command as p } from "@commander-js/extra-typings";
-const e = new p();
-e.name("api-extractor").description("Extract public API from a TypeScript project to produce .d.ts types and api.json docs");
-e.command("run").description("Generate .d.ts types and api.json API reference for a project").option("--cwd <arcgis-js-api>", "Path to the root of the project (default: process.cwd())").option("--dts <outputDirectory>", "Destination for the .d.ts files (example: dist/)").option("--api-json <outputLocation>", "Destination for the api.json file (example: dist/docs/api.json)").option("--environment <environment>", "Environment to run in (production or development) (default: production)").option("--type-check", "Run full type checking before the extraction (default: false)").option("--verify", "Run type checker on the emitted types (default: false)").option("--watch", "Watch for file changes and re-run the extraction automatically", !1).option(
+import { Command as c } from "@commander-js/extra-typings";
+const o = new c();
+o.name("api-extractor").description("Extract public API from a TypeScript project to produce .d.ts types and api.json docs");
+o.command("run").description("Generate .d.ts types and api.json API reference for a project").option("--cwd <arcgis-js-api>", "Path to the root of the project (default: process.cwd())").option("--dts <outputDirectory>", "Destination for the .d.ts files (example: dist/)").option("--api-json <outputLocation>", "Destination for the api.json file (example: dist/docs/api.json)").option("--environment <environment>", "Environment to run in (production or development) (default: production)").option("--type-check", "Run full type checking before the extraction (default: false)").option("--verify", "Run type checker on the emitted types (default: false)").option("--watch", "Watch for file changes and re-run the extraction automatically", !1).option(
   "--config <configPath>",
   "Path to the ./api-extractor.config.ts file. The provided path will be used as is in import(). The config file should export a `config` object of type ApiExtractorConfig (default: api-extractor.config.ts in the cwd)"
 ).option(
   "--silence-broken-links",
   "(deprecated) Do not emit errors for broken @links in JSDoc comments. Temporary option for migration period (default: false)"
 ).action(async (t) => {
-  const { loadApiExtractorConfig: o, mergeApiExtractorConfigs: n } = await import("./extractor/config.js"), a = await o(t.cwd, t.config), r = n(a, {
+  const { loadApiExtractorConfig: e, mergeApiExtractorConfigs: n } = await import("./extractor/config.js"), a = await e(t.cwd, t.config), r = n(a, {
     context: {
       dtsEmitPath: t.dts,
       apiJsonEmitPath: t.apiJson,
@@ -23,16 +23,35 @@ e.command("run").description("Generate .d.ts types and api.json API reference fo
       typeCheckTypes: t.verify,
       detectBrokenLinks: t.silenceBrokenLinks === !0 ? !1 : void 0
     }
-  }), { ApiExtractor: c } = await import("./extractor/ApiExtractor.js"), i = new c(r);
+  }), { ApiExtractor: p } = await import("./extractor/ApiExtractor.js"), i = new p(r);
   t.watch ? await i.watch() : await i.run();
 });
-e.command("diff-types").description("Generate a types diff summary .md file").requiredOption("--original-dts <originalTypings>", "Path to the original types folder").requiredOption("--new-dts <newTypings>", "Path to the new types folder").option("--output-md <outputMd>", "Path to the output markdown file", "types-diff.md").option("--no-truncate", "Do not truncate output if it is longer than 1000 lines", !0).action(async (t) => {
-  const { diffTypes: o } = await import("./diffTypes/index.js");
-  await o({
+o.command("diff").description("Produce a diff of two api.json files").requiredOption(
+  "--old <string>",
+  "URL or file path to the old api.json file. Example: https://unpkg.com/@arcgis/map-components@latest/dist/docs/api.json"
+).requiredOption(
+  "--new <string>",
+  "URL or file path to the new api.json file. Example: ./packages/map-packages/map-components/dist/docs/api.json"
+).option("--output <path>", "Path to the output .md or .json file. If not provided, will print markdown to console").option(
+  "--docs-url-prefix <string>",
+  "Base URL for documentation links. Used only if output format is Markdown",
+  "https://developers.arcgis.com/javascript/latest/references/core/"
+).action(async (t) => {
+  const { diffApiCli: e } = await import("./cli-7PX_wNxb.js");
+  await e({
+    oldPath: t.old,
+    newPath: t.new,
+    outputPath: t.output,
+    docsUrlPrefix: t.docsUrlPrefix
+  });
+});
+o.command("diff-types").description("Generate a types diff summary .md file").requiredOption("--original-dts <originalTypings>", "Path to the original types folder").requiredOption("--new-dts <newTypings>", "Path to the new types folder").option("--output-md <outputMd>", "Path to the output markdown file", "types-diff.md").option("--no-truncate", "Do not truncate output if it is longer than 1000 lines", !0).action(async (t) => {
+  const { diffTypes: e } = await import("./diffTypes/index.js");
+  await e({
     originalDtsPath: t.originalDts,
     newDtsPath: t.newDts,
     outputMdPath: t.outputMd,
     truncate: t.truncate
   });
 });
-e.parse();
+o.parse();

package/dist/diff/apiDiffToMarkdown.d.ts

@@ -0,0 +1,9 @@
+import type { ApiDiff } from "./types.js";
+
+/**
+ * Render an ApiDiff to a markdown nested lists tree.
+ *
+ * @param apiJson
+ * @param docsUrlPrefix
+ */
+export function apiDiffToMarkdown(apiJson: Pick<ApiDiff, "modules">, docsUrlPrefix: string): string;

package/dist/diff/apiDiffToMarkdown.js

@@ -0,0 +1,140 @@
+import { buildViewUrl as T } from "../extractor/processing/links.js";
+function K({ modules: e }, t) {
+  const o = {
+    children: /* @__PURE__ */ new Map(),
+    members: []
+  };
+  for (let n = 0; n < e.length; ++n) {
+    const s = e[n], w = s.path.split("/");
+    let y = w;
+    const M = w.at(-1);
+    s.declarations.length === 1 && s.declarations[0].name === M && (y = w.slice(0, -1));
+    let U = o;
+    for (const g of y)
+      U = N(U, g);
+    for (let g = 0; g < s.declarations.length; ++g) {
+      const h = s.declarations[g], S = B(h), O = h.removed === !0 ? void 0 : $(t, s.path, h, void 0), k = j(h), x = { label: S, viewUrl: O, change: k }, d = h, m = [];
+      if (d.members !== void 0)
+        for (let l = 0; l < d.members.length; ++l) {
+          const a = d.members[l], f = p(a.kind, a);
+          if (f === void 0)
+            continue;
+          const v = F(a), r = a.removed === !0 ? void 0 : $(
+            t,
+            s.path,
+            h,
+            "name" in a ? a.name : `${h.name}Properties`
+          );
+          m.push({ label: v, viewUrl: r, change: f });
+        }
+      if (d.events !== void 0)
+        for (let l = 0; l < d.events.length; ++l) {
+          const a = d.events[l], f = p("event", a);
+          if (f === void 0)
+            continue;
+          const v = a.removed === !0 ? void 0 : $(t, s.path, h, `event-${a.name}`);
+          m.push({ label: `@${a.name}`, viewUrl: v, change: f });
+        }
+      if (typeof d.tagName == "string") {
+        const l = d.slots, a = d.cssParts, f = d.cssProperties, v = d.cssStates;
+        if (l !== void 0)
+          for (let r = 0; r < l.length; ++r) {
+            const i = l[r], u = p("slot", i);
+            if (u === void 0)
+              continue;
+            const b = i.removed === !0 ? void 0 : $(t, s.path, h, `slot-${i.name}`);
+            m.push({ label: i.name, viewUrl: b, change: u });
+          }
+        if (a !== void 0)
+          for (let r = 0; r < a.length; ++r) {
+            const i = a[r], u = p("css part", i);
+            if (u === void 0)
+              continue;
+            m.push({ label: i.name, viewUrl: void 0, change: u });
+          }
+        if (f !== void 0)
+          for (let r = 0; r < f.length; ++r) {
+            const i = f[r], u = p("css property", i);
+            if (u === void 0)
+              continue;
+            const b = i.removed === !0 ? void 0 : $(t, s.path, h, i.name);
+            m.push({ label: i.name, viewUrl: b, change: u });
+          }
+        if (v !== void 0)
+          for (let r = 0; r < v.length; ++r) {
+            const i = v[r], u = p("css state", i);
+            if (u === void 0)
+              continue;
+            m.push({ label: i.name, viewUrl: void 0, change: u });
+          }
+      }
+      m.length > 0 ? E(U, x).members.push(...m) : k !== void 0 && U.members.push(x);
+    }
+  }
+  const c = [];
+  for (const n of o.children.values())
+    L(n, "", c);
+  return c.join(`
+`);
+}
+function N(e, t) {
+  const o = e.children.get(t);
+  if (o !== void 0)
+    return o;
+  const c = { name: t, children: /* @__PURE__ */ new Map(), members: [], node: void 0 };
+  return e.children.set(t, c), c;
+}
+function j(e) {
+  const t = e.tagName !== void 0 ? "component" : e.kind === "interface" ? "type declaration" : e.kind;
+  return p(t, e);
+}
+function p(e, t) {
+  const { added: o, removed: c, deprecated: n } = t;
+  if (c) {
+    const s = `**removed** ${e}`;
+    return typeof n == "string" ? `${s} - deprecated ${D(n)}` : s;
+  }
+  if (n)
+    return typeof n == "string" ? `**deprecated** ${e} ${D(n)}` : `**deprecated** ${e}`;
+  if (o)
+    return `**added** ${e}`;
+}
+function B(e) {
+  const t = e.tagName;
+  return typeof t == "string" && t.length > 0 ? t : C(e.name) + (e.kind === "function" ? "()" : "");
+}
+function $(e, t, o, c) {
+  const n = `${e}${t}/`;
+  return T(n, o.kind === "class" ? void 0 : o.name, c);
+}
+function E(e, t) {
+  const o = N(e, t.label);
+  return o.node = t, o;
+}
+function F(e) {
+  return e.kind === "constructor" ? "constructor" : e.kind === "call-signature" ? "call signature" : e.kind === "method" ? `${C(e.name)}()` : C(e.name);
+}
+function C(e) {
+  return e.replace(/[\\\[\]\(\)]/gu, "\\$&");
+}
+function D(e) {
+  return e.split(`
+`)[0];
+}
+function L(e, t, o) {
+  if (e.node) {
+    const n = e.node.viewUrl === void 0 ? e.node.label : `[${e.node.label}](${e.node.viewUrl})`;
+    e.node.change ? o.push(`${t}- ${n} - ${e.node.change}`) : o.push(`${t}- ${n}`);
+  } else
+    o.push(`${t}- ${e.name}/`);
+  const c = `${t}  `;
+  for (const n of e.members) {
+    const s = n.viewUrl === void 0 ? n.label : `[${n.label}](${n.viewUrl})`;
+    n.change ? o.push(`${c}- ${s} - ${n.change}`) : o.push(`${c}- ${s}`);
+  }
+  for (const n of e.children.values())
+    L(n, c, o);
+}
+export {
+  K as apiDiffToMarkdown
+};

package/dist/diff/diffApiJson.d.ts

@@ -1,4 +1,4 @@
-import type { ApiJson } from "../apiJson.js";
+import type { ApiJson, ApiJsonCompiler } from "../apiJson.js";
 import type { ApiDiff } from "./types.js";
 
 /**
@@ -6,8 +6,8 @@ import type { ApiDiff } from "./types.js";
  * @param newApiJson
  * @example
  * ```js
- * import { diffApiJson, fetchApiJsonFromNpm } from "@arcgis/api-extractor/diff";
- * import { readFileSync, writeFileSync } from "node:fs";
+ * import { diffApiJson } from "@arcgis/api-extractor/diff/diffApiJson";
+ * import { fetchApiJsonFromNpm } from "@arcgis/api-extractor/diff/fetchApiJsonFromNpm";
  *
  * // Read -next api.json from file system:
  * const apiJson = JSON.parse(
@@ -23,4 +23,4 @@ import type { ApiDiff } from "./types.js";
  * writeFileSync("api-diff.json", JSON.stringify(diff, null, 2));
  * ```
  */
-export function diffApiJson(oldApiJson: Pick<ApiJson, "modules">, newApiJson: Pick<ApiJson, "modules">): ApiDiff;
+export function diffApiJson(oldApiJson: Pick<ApiJson, "modules"> & { compiler?: ApiJsonCompiler; }, newApiJson: Pick<ApiJson, "modules"> & { compiler?: ApiJsonCompiler; }): ApiDiff;