@arcgis/api-extractor 5.0.0-next.3 → 5.0.0-next.31

package/dist/apiJson.d.ts

@@ -115,6 +115,12 @@ export type ApiJavaScriptModule = {
      * Whether the module is deprecated.
      * If the value is a string, it's the reason for the deprecation.
      *
+     * @remarks
+     * If module is marked as deprecated, all its declarations should also be
+     * marked as deprecated. This is because in TypeScript, a usage of a
+     * declaration will only be marked as deprecated if the declaration itself
+     * is marked as deprecated, rather than its module.
+     *
      * @default false
      */
     deprecated?: boolean | string;
@@ -283,10 +289,6 @@ export type ApiCustomElementDeclaration = Omit<ApiClassDeclaration, "members"> &
      * "attributes" is not necessary.
      */
     attributes?: ApiAttribute[];
-    /**
-     * The events that this element fires.
-     */
-    events?: ApiEvent[];
     /**
      * The shadow dom content slots that this element accepts.
      */
@@ -736,6 +738,10 @@ export type ApiClassDeclaration = {
      */
     mixins?: ApiReference[];
     members?: ApiClassMember[];
+    /**
+     * The events that this element fires.
+     */
+    events?: ApiEvent[];
     /**
      * @remarks
      * Not used by `@arcgis/api-extractor`. Preserved in typings for compatibility

package/dist/diff/diffApiJson.d.ts

@@ -0,0 +1,3 @@
+import { ApiJson } from '../apiJson';
+import { ApiDiff } from './types';
+export declare function diffApiJson(oldApiJson: Pick<ApiJson, "modules">, newApiJson: Pick<ApiJson, "modules">): ApiDiff;

package/dist/diff/fetchApiJsonFromNpm.d.ts

@@ -0,0 +1,7 @@
+import { ApiJson } from '../apiJson';
+/**
+ * Read dist/docs/api.json for a given NPM package.
+ *
+ * @example fetchApiJsonFromNpm("@arcgis/map-components", "latest");
+ */
+export declare function fetchApiJsonFromNpm(packageName: string, semverVersion: string): Promise<ApiJson>;

package/dist/diff/index.d.ts

@@ -0,0 +1,3 @@
+export { fetchApiJsonFromNpm } from './fetchApiJsonFromNpm';
+export { diffApiJson } from './diffApiJson';
+export type * from './types';

package/dist/diff/index.js

@@ -0,0 +1,147 @@
+async function b(d, i) {
+  const o = await fetch(`https://unpkg.com/${d}@${i}/dist/docs/api.json`);
+  if (!o.ok)
+    throw new Error(`Failed to fetch api.json: ${o.statusText}`);
+  return await o.json();
+}
+function M(d, i) {
+  const o = new Map(d.modules.map((e) => [e.path, e])), t = [];
+  for (const e of i.modules) {
+    const a = o.get(e.path), s = D(a, e, !0);
+    s !== void 0 && t.push(s), o.delete(e.path);
+  }
+  for (const e of o.values()) {
+    const a = D(void 0, e, !1);
+    a !== void 0 && t.push(a);
+  }
+  return { modules: t };
+}
+function D(d, i, o) {
+  const t = [], e = p(d?.declarations ?? []), a = p(i.declarations ?? []);
+  for (const s of a.values()) {
+    const n = s.at(-1), l = "tagName" in n ? n.tagName : void 0, v = l ?? n.name, u = e.get(v);
+    e.delete(v);
+    const h = u === void 0 && !o ? !0 : void 0, m = o && // Only mark as deprecated if all overloads are deprecated
+    (s.length === 1 || s.every((r) => r.deprecated !== void 0)) ? n.deprecated : void 0, g = !m && u === void 0 && o ? !0 : void 0;
+    if (h || g) {
+      t.push({
+        kind: n.kind,
+        name: n.name,
+        tagName: l,
+        members: void 0,
+        removed: h,
+        added: g,
+        deprecated: m
+      });
+      continue;
+    } else if (!o)
+      continue;
+    if ("tagName" in n) {
+      const r = u?.[0], c = {
+        kind: n.kind,
+        name: n.name,
+        tagName: n.tagName,
+        deprecated: m,
+        added: void 0,
+        removed: void 0,
+        members: k(r?.members, n.members),
+        events: f(r?.events, n.events),
+        slots: f(r?.slots, n.slots),
+        cssParts: f(r?.cssParts, n.cssParts),
+        cssProperties: f(r?.cssProperties, n.cssProperties),
+        cssStates: f(r?.cssStates, n.cssStates)
+      };
+      (m !== void 0 || c.members !== void 0 || c.events !== void 0 || c.slots !== void 0 || c.cssParts !== void 0 || c.cssProperties !== void 0 || c.cssStates !== void 0) && t.push(c);
+    } else if (n.kind === "class") {
+      const r = u?.[0], c = {
+        kind: n.kind,
+        name: n.name,
+        deprecated: m,
+        added: void 0,
+        removed: void 0,
+        members: k(r?.members, n.members),
+        events: f(r?.events, n.events)
+      };
+      (m !== void 0 || c.members !== void 0 || c.events !== void 0) && t.push(c);
+    } else m !== void 0 && t.push({
+      kind: n.kind,
+      name: n.name,
+      deprecated: m,
+      added: void 0,
+      removed: void 0
+    });
+  }
+  if (o)
+    for (const [s] of e.values())
+      t.push({
+        kind: s.kind,
+        name: s.name,
+        tagName: "tagName" in s ? s.tagName : void 0,
+        members: void 0,
+        removed: !0,
+        added: void 0,
+        deprecated: void 0
+      });
+  if (t.length !== 0)
+    return {
+      path: i.path,
+      declarations: t
+    };
+}
+function p(d) {
+  const i = /* @__PURE__ */ new Map();
+  for (let o = 0; o < d.length; o++) {
+    const t = d[o], e = "tagName" in t ? t.tagName : t.name, a = i.get(e);
+    a === void 0 ? i.set(e, [t]) : a.push(t);
+  }
+  return i;
+}
+function f(d, i) {
+  const o = p(d ?? []), t = [];
+  if (i !== void 0)
+    for (const e of i)
+      o.get(e.name) === void 0 ? t.push({
+        name: e.name,
+        added: !0
+      }) : e.deprecated && t.push({
+        name: e.name,
+        deprecated: e.deprecated
+      }), o.delete(e.name);
+  for (const [e] of o.values())
+    t.push({
+      name: e.name,
+      removed: !0
+    });
+  return t.length ? t : void 0;
+}
+function k(d, i) {
+  const o = p(d ?? []), t = p(i ?? []), e = [];
+  for (const a of t.values()) {
+    const s = a.at(-1), n = o.get(s.name);
+    o.delete(s.name);
+    const l = (
+      // Only mark as deprecated if all overloads are deprecated
+      a.length === 1 || a.every((v) => v.deprecated !== void 0) ? s.deprecated : void 0
+    );
+    l ? e.push({
+      kind: s.kind,
+      name: s.name,
+      deprecated: l
+    }) : n === void 0 && e.push({
+      kind: s.kind,
+      name: s.name,
+      added: !0
+    });
+  }
+  for (const [a] of o.values())
+    e.push({
+      kind: a.kind,
+      name: a.name,
+      removed: !0
+    });
+  return e.length ? e : void 0;
+}
+export {
+  M as diffApiJson,
+  b as fetchApiJsonFromNpm
+};

package/dist/diff/types.d.ts

@@ -0,0 +1,66 @@
+import { ApiClassDeclaration, ApiClassField, ApiClassMethod, ApiCustomElementDeclaration, ApiFunctionDeclaration, ApiModule, ApiVariableDeclaration } from '../apiJson';
+export interface ApiDiff {
+    modules: ApiModuleDiff[];
+}
+export interface ApiModuleDiff {
+    path: ApiModule["path"];
+    declarations: ApiDeclarationDiff[];
+}
+export interface ApiDiffBase {
+    name: string;
+    /**
+     * True if this declaration was removed in the new api.json.
+     * If class is removed, members are not listed.
+     * @default false
+     */
+    removed?: true;
+    /**
+     * True if this declaration was added in the new api.json.
+     * If class is added, members are not listed.
+     *
+     * @default false
+     */
+    added?: true;
+    /**
+     * Whether this declaration is deprecated in the new api.json, regardless of
+     * whether it was deprecated in the old api.json.
+     * If the value is a string, it's the reason for the deprecation.
+     * Deprecated takes precedence over added.
+     *
+     * @default false
+     */
+    deprecated?: boolean | string;
+}
+export type ApiDeclarationDiff = ApiClassDeclarationDiff | ApiCustomElementDeclarationDiff | ApiFunctionDeclarationDiff | ApiVariableDeclarationDiff;
+export interface ApiClassDeclarationDiff extends ApiDiffBase {
+    kind: ApiClassDeclaration["kind"];
+    /**
+     * Inherited members are not included in the diff.
+     * Also, if entire class is added/removed, members are not included in the diff.
+     */
+    members?: ApiClassMemberDiff[];
+    events?: ApiDiffBase[];
+}
+export interface ApiCustomElementDeclarationDiff extends ApiClassDeclarationDiff {
+    /**
+     * Attributes diff is not included as attributes are based on members.
+     */
+    tagName: ApiCustomElementDeclaration["tagName"];
+    slots?: ApiDiffBase[];
+    cssParts?: ApiDiffBase[];
+    cssProperties?: ApiDiffBase[];
+    cssStates?: ApiDiffBase[];
+}
+export type ApiClassMemberDiff = ApiClassFieldDiff | ApiClassMethodDiff;
+export interface ApiClassFieldDiff extends ApiDiffBase {
+    kind: ApiClassField["kind"];
+}
+export interface ApiClassMethodDiff extends ApiDiffBase {
+    kind: ApiClassMethod["kind"];
+}
+export interface ApiFunctionDeclarationDiff extends ApiDiffBase {
+    kind: ApiFunctionDeclaration["kind"];
+}
+export interface ApiVariableDeclarationDiff extends ApiDiffBase {
+    kind: ApiVariableDeclaration["kind"];
+}

package/dist/index.js

@@ -1,12 +1,13 @@
 import c from "typescript";
-import { path as P } from "@arcgis/components-build-utils";
-import { mappedFind as R } from "@arcgis/toolkit/array";
-const N = "@arcgis/api-extractor", K = "5.0.0-next.3", ye = (t) => t.kind === "method", Te = (t) => t.kind === "field";
-function W(t, e) {
-  const n = t.path.split("/"), o = n.pop(), s = n.join("/"), r = e.path.split("/"), i = r.pop(), a = r.join("/");
-  return s === a ? o < i ? -1 : 1 : s.startsWith(a) ? 1 : a.startsWith(s) || s < a ? -1 : 1;
+import { path as y } from "@arcgis/components-build-utils";
+import T, { supportsColorStderr as S } from "chalk";
+import { mappedFind as D } from "@arcgis/toolkit/array";
+const m = "@arcgis/api-extractor", E = "5.0.0-next.31", H = (t) => t.kind === "method", q = (t) => t.kind === "field";
+function k(t, e) {
+  const s = t.path.split("/"), n = s.pop(), o = s.join("/"), i = e.path.split("/"), r = i.pop(), a = i.join("/");
+  return o === a ? n < r ? -1 : 1 : o.startsWith(a) ? 1 : a.startsWith(o) || o < a ? -1 : 1;
 }
-const Se = "global:", G = /* @__PURE__ */ new Set([
+const G = "global:", C = /* @__PURE__ */ new Set([
   "example",
   "see",
   "param",
@@ -15,315 +16,44 @@ const Se = "global:", G = /* @__PURE__ */ new Set([
   "slot",
   "csspart",
   "cssstate"
-]), v = 10, M = (t = 0) => (e) => `\x1B[${e + t}m`, k = (t = 0) => (e) => `\x1B[${38 + t};5;${e}m`, w = (t = 0) => (e, n, o) => `\x1B[${38 + t};2;${e};${n};${o}m`, l = {
-  modifier: {
-    reset: [0, 0],
-    // 21 isn't widely supported and 22 does the same thing
-    bold: [1, 22],
-    dim: [2, 22],
-    italic: [3, 23],
-    underline: [4, 24],
-    overline: [53, 55],
-    inverse: [7, 27],
-    hidden: [8, 28],
-    strikethrough: [9, 29]
-  },
-  color: {
-    black: [30, 39],
-    red: [31, 39],
-    green: [32, 39],
-    yellow: [33, 39],
-    blue: [34, 39],
-    magenta: [35, 39],
-    cyan: [36, 39],
-    white: [37, 39],
-    // Bright color
-    blackBright: [90, 39],
-    gray: [90, 39],
-    // Alias of `blackBright`
-    grey: [90, 39],
-    // Alias of `blackBright`
-    redBright: [91, 39],
-    greenBright: [92, 39],
-    yellowBright: [93, 39],
-    blueBright: [94, 39],
-    magentaBright: [95, 39],
-    cyanBright: [96, 39],
-    whiteBright: [97, 39]
-  },
-  bgColor: {
-    bgBlack: [40, 49],
-    bgRed: [41, 49],
-    bgGreen: [42, 49],
-    bgYellow: [43, 49],
-    bgBlue: [44, 49],
-    bgMagenta: [45, 49],
-    bgCyan: [46, 49],
-    bgWhite: [47, 49],
-    // Bright color
-    bgBlackBright: [100, 49],
-    bgGray: [100, 49],
-    // Alias of `bgBlackBright`
-    bgGrey: [100, 49],
-    // Alias of `bgBlackBright`
-    bgRedBright: [101, 49],
-    bgGreenBright: [102, 49],
-    bgYellowBright: [103, 49],
-    bgBlueBright: [104, 49],
-    bgMagentaBright: [105, 49],
-    bgCyanBright: [106, 49],
-    bgWhiteBright: [107, 49]
-  }
-};
-Object.keys(l.modifier);
-const V = Object.keys(l.color), Y = Object.keys(l.bgColor);
-[...V, ...Y];
-function J() {
-  const t = /* @__PURE__ */ new Map();
-  for (const [e, n] of Object.entries(l)) {
-    for (const [o, s] of Object.entries(n))
-      l[o] = {
-        open: `\x1B[${s[0]}m`,
-        close: `\x1B[${s[1]}m`
-      }, n[o] = l[o], t.set(s[0], s[1]);
-    Object.defineProperty(l, e, {
-      value: n,
-      enumerable: !1
-    });
-  }
-  return Object.defineProperty(l, "codes", {
-    value: t,
-    enumerable: !1
-  }), l.color.close = "\x1B[39m", l.bgColor.close = "\x1B[49m", l.color.ansi = M(), l.color.ansi256 = k(), l.color.ansi16m = w(), l.bgColor.ansi = M(v), l.bgColor.ansi256 = k(v), l.bgColor.ansi16m = w(v), Object.defineProperties(l, {
-    rgbToAnsi256: {
-      value(e, n, o) {
-        return e === n && n === o ? e < 8 ? 16 : e > 248 ? 231 : Math.round((e - 8) / 247 * 24) + 232 : 16 + 36 * Math.round(e / 255 * 5) + 6 * Math.round(n / 255 * 5) + Math.round(o / 255 * 5);
-      },
-      enumerable: !1
-    },
-    hexToRgb: {
-      value(e) {
-        const n = /[a-f\d]{6}|[a-f\d]{3}/i.exec(e.toString(16));
-        if (!n)
-          return [0, 0, 0];
-        let [o] = n;
-        o.length === 3 && (o = [...o].map((r) => r + r).join(""));
-        const s = Number.parseInt(o, 16);
-        return [
-          /* eslint-disable no-bitwise */
-          s >> 16 & 255,
-          s >> 8 & 255,
-          s & 255
-          /* eslint-enable no-bitwise */
-        ];
-      },
-      enumerable: !1
-    },
-    hexToAnsi256: {
-      value: (e) => l.rgbToAnsi256(...l.hexToRgb(e)),
-      enumerable: !1
-    },
-    ansi256ToAnsi: {
-      value(e) {
-        if (e < 8)
-          return 30 + e;
-        if (e < 16)
-          return 90 + (e - 8);
-        let n, o, s;
-        if (e >= 232)
-          n = ((e - 232) * 10 + 8) / 255, o = n, s = n;
-        else {
-          e -= 16;
-          const a = e % 36;
-          n = Math.floor(e / 36) / 5, o = Math.floor(a / 6) / 5, s = a % 6 / 5;
-        }
-        const r = Math.max(n, o, s) * 2;
-        if (r === 0)
-          return 30;
-        let i = 30 + (Math.round(s) << 2 | Math.round(o) << 1 | Math.round(n));
-        return r === 2 && (i += 60), i;
-      },
-      enumerable: !1
-    },
-    rgbToAnsi: {
-      value: (e, n, o) => l.ansi256ToAnsi(l.rgbToAnsi256(e, n, o)),
-      enumerable: !1
-    },
-    hexToAnsi: {
-      value: (e) => l.ansi256ToAnsi(l.hexToAnsi256(e)),
-      enumerable: !1
-    }
-  }), l;
-}
-const d = J(), B = (() => {
-  if (!("navigator" in globalThis))
-    return 0;
-  if (globalThis.navigator.userAgentData) {
-    const t = navigator.userAgentData.brands.find(({ brand: e }) => e === "Chromium");
-    if (t && t.version > 93)
-      return 3;
-  }
-  return /\b(Chrome|Chromium)\//.test(globalThis.navigator.userAgent) ? 1 : 0;
-})(), j = B !== 0 && {
-  level: B
-}, U = {
-  stdout: j,
-  stderr: j
-};
-function z(t, e, n) {
-  let o = t.indexOf(e);
-  if (o === -1)
-    return t;
-  const s = e.length;
-  let r = 0, i = "";
-  do
-    i += t.slice(r, o) + e + n, r = o + s, o = t.indexOf(e, r);
-  while (o !== -1);
-  return i += t.slice(r), i;
-}
-function H(t, e, n, o) {
-  let s = 0, r = "";
-  do {
-    const i = t[o - 1] === "\r";
-    r += t.slice(s, i ? o - 1 : o) + e + (i ? `\r
-` : `
-`) + n, s = o + 1, o = t.indexOf(`
-`, s);
-  } while (o !== -1);
-  return r += t.slice(s), r;
-}
-const { stdout: $, stderr: S } = U, A = Symbol("GENERATOR"), f = Symbol("STYLER"), h = Symbol("IS_EMPTY"), D = [
-  "ansi",
-  "ansi",
-  "ansi256",
-  "ansi16m"
-], p = /* @__PURE__ */ Object.create(null), q = (t, e = {}) => {
-  if (e.level && !(Number.isInteger(e.level) && e.level >= 0 && e.level <= 3))
-    throw new Error("The `level` option should be an integer from 0 to 3");
-  const n = $ ? $.level : 0;
-  t.level = e.level === void 0 ? n : e.level;
-}, Q = (t) => {
-  const e = (...n) => n.join(" ");
-  return q(e, t), Object.setPrototypeOf(e, m.prototype), e;
-};
-function m(t) {
-  return Q(t);
-}
-Object.setPrototypeOf(m.prototype, Function.prototype);
-for (const [t, e] of Object.entries(d))
-  p[t] = {
-    get() {
-      const n = x(this, E(e.open, e.close, this[f]), this[h]);
-      return Object.defineProperty(this, t, { value: n }), n;
-    }
-  };
-p.visible = {
-  get() {
-    const t = x(this, this[f], !0);
-    return Object.defineProperty(this, "visible", { value: t }), t;
-  }
-};
-const C = (t, e, n, ...o) => t === "rgb" ? e === "ansi16m" ? d[n].ansi16m(...o) : e === "ansi256" ? d[n].ansi256(d.rgbToAnsi256(...o)) : d[n].ansi(d.rgbToAnsi(...o)) : t === "hex" ? C("rgb", e, n, ...d.hexToRgb(...o)) : d[n][t](...o), X = ["rgb", "hex", "ansi256"];
-for (const t of X) {
-  p[t] = {
-    get() {
-      const { level: n } = this;
-      return function(...o) {
-        const s = E(C(t, D[n], "color", ...o), d.color.close, this[f]);
-        return x(this, s, this[h]);
-      };
-    }
-  };
-  const e = "bg" + t[0].toUpperCase() + t.slice(1);
-  p[e] = {
-    get() {
-      const { level: n } = this;
-      return function(...o) {
-        const s = E(C(t, D[n], "bgColor", ...o), d.bgColor.close, this[f]);
-        return x(this, s, this[h]);
-      };
-    }
-  };
-}
-const Z = Object.defineProperties(() => {
-}, {
-  ...p,
-  level: {
-    enumerable: !0,
-    get() {
-      return this[A].level;
-    },
-    set(t) {
-      this[A].level = t;
-    }
-  }
-}), E = (t, e, n) => {
-  let o, s;
-  return n === void 0 ? (o = t, s = e) : (o = n.openAll + t, s = e + n.closeAll), {
-    open: t,
-    close: e,
-    openAll: o,
-    closeAll: s,
-    parent: n
-  };
-}, x = (t, e, n) => {
-  const o = (...s) => _(o, s.length === 1 ? "" + s[0] : s.join(" "));
-  return Object.setPrototypeOf(o, Z), o[A] = t, o[f] = e, o[h] = n, o;
-}, _ = (t, e) => {
-  if (t.level <= 0 || !e)
-    return t[h] ? "" : e;
-  let n = t[f];
-  if (n === void 0)
-    return e;
-  const { openAll: o, closeAll: s } = n;
-  if (e.includes("\x1B"))
-    for (; n !== void 0; )
-      e = z(e, n.close, n.open), n = n.parent;
-  const r = e.indexOf(`
-`);
-  return r !== -1 && (e = H(e, s, o, r)), o + e + s;
-};
-Object.defineProperties(m.prototype, p);
-const ee = m();
-m({ level: S ? S.level : 0 });
-const te = c.createPrinter();
-function ne(t) {
-  return te.printNode(c.EmitHint.Unspecified, t, void 0);
+]), $ = c.createPrinter();
+function w(t) {
+  return $.printNode(c.EmitHint.Unspecified, t, void 0);
 }
-function oe(t, e) {
-  return t.pos !== -1 && t.end !== -1 && e !== void 0 ? t.getText(e) : ne(t);
+function L(t, e) {
+  return t.pos !== -1 && t.end !== -1 && e !== void 0 ? t.getText(e) : w(t);
 }
-let se = 0;
-const re = /* @__PURE__ */ new Set();
-let I = console.error;
-function Ae(t) {
-  I = t;
+let A = 0;
+const I = /* @__PURE__ */ new Set();
+let g = console.error;
+function Q(t) {
+  g = t;
 }
-const ie = {
+const M = {
   getCurrentDirectory: process.cwd,
   getCanonicalFileName: (t) => t,
   getNewLine: () => c.sys.newLine
 };
-function le(t, { file: e, node: n, scope: o, start: s, length: r }) {
-  se += 1, process.exitCode = 1;
-  const i = e?.fileName;
-  i !== void 0 && re.add(i), s ??= n?.getStart(e, !1) ?? -1;
-  const a = n?.end ?? -1;
-  r ??= a === -1 ? -1 : Math.max(1, a - s);
-  const u = s >= 0 && r >= 0, g = !u && o !== void 0, b = {
+function N(t, { file: e, node: s, scope: n, start: o, length: i }) {
+  A += 1, process.exitCode = 1;
+  const r = e?.fileName;
+  r !== void 0 && I.add(r), o ??= s?.getStart(e, !1) ?? -1;
+  const a = s?.end ?? -1;
+  i ??= a === -1 ? -1 : Math.max(1, a - o);
+  const d = o >= 0 && i >= 0, l = !d && n !== void 0, f = {
     category: c.DiagnosticCategory.Error,
-    code: u ? N : ce,
-    file: g ? void 0 : e,
-    start: u ? s : 0,
-    length: u ? r : 0,
-    messageText: (g ? `${ee.cyan(o)}: ` : "") + t + (u || n === void 0 ? "" : `
+    code: d ? m : K,
+    file: l ? void 0 : e,
+    start: d ? o : 0,
+    length: d ? i : 0,
+    messageText: (l ? `${T.cyan(n)}: ` : "") + t + (d || s === void 0 ? "" : `
 
-${oe(n, e)}`)
-  }, O = c.formatDiagnosticsWithColorAndContext([b], ie), F = S ? O : O.replaceAll(ae, "");
-  I(F);
+${L(s, e)}`)
+  }, x = c.formatDiagnosticsWithColorAndContext([f], M), v = S ? x : x.replaceAll(j, "");
+  g(v);
 }
-const ce = 1490, ae = /\x1B\[[0-9;]*m/gu;
-class Ce {
+const K = 1490, j = /\x1B\[[0-9;]*m/gu;
+class X {
   constructor(e) {
     this.options = e;
   }
@@ -332,8 +62,8 @@ class Ce {
     return {
       timestamp: (/* @__PURE__ */ new Date()).toISOString().split(".")[0],
       compiler: {
-        name: N,
-        version: K,
+        name: m,
+        version: E,
         typescriptVersion: c.version
       },
       schemaVersion: "1.0.0",
@@ -341,215 +71,215 @@ class Ce {
     };
   }
   extractModules(e) {
-    const n = [];
-    for (const o of e)
-      this.file = o, n.push(this.extractModule(o));
-    return this.options.isFullApiExtraction && n.sort(W), n;
+    const s = [];
+    for (const n of e)
+      this.file = n, s.push(this.extractModule(n));
+    return this.options.isFullApiExtraction && s.sort(k), s;
   }
   extractModule(e) {
-    const n = {
+    const s = {
       kind: "javascript-module",
-      path: P.relative(this.options.cwd, e.fileName),
+      path: y.relative(this.options.cwd, e.fileName),
       declarations: void 0,
       exports: void 0
     };
-    this.apiModule = n;
-    const o = this.extractDeclarations(e);
-    if (n.declarations = o, this.options.isFullApiExtraction) {
-      const s = this.inferExports(o);
-      s.length > 0 && (n.exports = s);
+    this.apiModule = s;
+    const n = this.extractDeclarations(e);
+    if (s.declarations = n, this.options.isFullApiExtraction) {
+      const o = this.inferExports(n);
+      o.length > 0 && (s.exports = o);
     }
-    return n;
+    return s;
   }
   /**
    * For a given module, extract all public declarations.
    */
   extractDeclarations(e) {
-    const n = [];
-    for (const o of e.statements) {
-      const s = this.extractDeclaration(o);
-      s !== void 0 && n.push(s);
+    const s = [];
+    for (const n of e.statements) {
+      const o = this.extractDeclaration(n);
+      o !== void 0 && s.push(o);
     }
-    return n;
+    return s;
   }
   /**
    * Infer ApiModule.exports based on ApiModule.declarations.
    */
   inferExports(e) {
-    const n = [];
-    for (const o of e) {
-      const s = this.inferExport(o);
-      s !== void 0 && n.push(s);
+    const s = [];
+    for (const n of e) {
+      const o = this.inferExport(n);
+      o !== void 0 && s.push(o);
     }
-    return n;
+    return s;
   }
-  copyDoc(e, n, o, s) {
-    const r = o.docsTags?.findIndex((u) => u.name === "copyDoc");
-    if (r === void 0 || r === -1)
+  copyDoc(e, s, n, o) {
+    const i = n.docsTags?.findIndex((d) => d.name === "copyDoc");
+    if (i === void 0 || i === -1)
       return;
-    n === void 0 && le("@copyDoc tag was used, but failed to find copyDoc definition for it.", {
+    s === void 0 && N("@copyDoc tag was used, but failed to find copyDoc definition for it.", {
       file: this.file,
       node: e
     });
-    const i = n?.(o, s);
-    if (i === void 0)
+    const r = s?.(n, o);
+    if (r === void 0)
       return;
-    for (const [u, g] of Object.entries(i))
-      u !== "docsTags" && (o[u] = o[u] ?? g);
-    o.docsTags.splice(r, 1);
-    const a = new Set(o.docsTags.map(({ name: u }) => u));
-    for (const u of i.docsTags ?? [])
-      a.has(u.name) && !G.has(u.name) || o.docsTags.push(u);
-    o.docsTags.length === 0 && (o.docsTags = void 0);
+    for (const [d, l] of Object.entries(r))
+      d !== "docsTags" && (n[d] = n[d] ?? l);
+    n.docsTags.splice(i, 1);
+    const a = new Set(n.docsTags.map(({ name: d }) => d));
+    for (const d of r.docsTags ?? [])
+      a.has(d.name) && !C.has(d.name) || n.docsTags.push(d);
+    n.docsTags.length === 0 && (n.docsTags = void 0);
   }
 }
-const Ee = (t) => t.modifiers?.some?.(
+const Y = (t) => t.modifiers?.some?.(
   (e) => e.kind === c.SyntaxKind.StaticKeyword || e.kind === c.SyntaxKind.PrivateKeyword || e.kind === c.SyntaxKind.ProtectedKeyword
 ) ?? !1;
-function Oe(t, e, n) {
+function Z(t, e, s) {
   if (!e.default && "initializer" in t && t.initializer) {
-    const o = L(t.initializer);
-    ue(o) && (e.default = o.getText(n));
+    const n = h(t.initializer);
+    F(n) && (e.default = n.getText(s));
   }
 }
-const ue = (t) => c.isLiteralExpression(t) || t.kind === c.SyntaxKind.TrueKeyword || t.kind === c.SyntaxKind.FalseKeyword || c.isPrefixUnaryExpression(t) && c.isLiteralExpression(t.operand);
-function L(t) {
-  return c.isSatisfiesExpression(t) || c.isParenthesizedExpression(t) ? L(t.expression) : t;
+const F = (t) => c.isLiteralExpression(t) || t.kind === c.SyntaxKind.TrueKeyword || t.kind === c.SyntaxKind.FalseKeyword || c.isPrefixUnaryExpression(t) && c.isLiteralExpression(t.operand);
+function h(t) {
+  return c.isSatisfiesExpression(t) || c.isParenthesizedExpression(t) ? h(t.expression) : t;
 }
-function Me(t) {
+function _(t) {
   if (t !== void 0 && (c.isIdentifier(t) || c.isStringLiteralLike(t)))
     return t.text;
 }
-const ke = ({ modifiers: t = [] }, e) => R(
+const tt = ({ modifiers: t = [] }, e) => D(
   t,
-  (n) => c.isDecorator(n) && c.isCallExpression(n.expression) && c.isIdentifier(n.expression.expression) && n.expression.expression.text === e ? n.expression : void 0
+  (s) => c.isDecorator(s) && c.isCallExpression(s.expression) && c.isIdentifier(s.expression.expression) && s.expression.expression.text === e ? s.expression : void 0
 );
-function de(t, e) {
-  const n = ge(e.getJsDocTags());
-  let o = c.displayPartsToString(e.getDocumentationComment(t));
-  const s = n.at(-1), r = s?.text?.indexOf(pe);
-  if (r !== void 0 && r !== -1) {
-    const i = s.text.indexOf(fe);
-    i !== -1 && (o += s.text.slice(i), s.text = s.text?.slice(0, i));
+function P(t, e) {
+  const s = W(e.getJsDocTags());
+  let n = c.displayPartsToString(e.getDocumentationComment(t));
+  const o = s.at(-1), i = o?.text?.indexOf(O);
+  if (i !== void 0 && i !== -1) {
+    const r = o.text.indexOf(b);
+    r !== -1 && (n += o.text.slice(r), o.text = o.text?.slice(0, r));
   }
   return {
-    docsTags: n,
-    description: o || void 0
+    docsTags: s,
+    description: n || void 0
   };
 }
-const fe = `
+const b = `
 
-{@link `, pe = "Read more...}", ge = (t) => t.filter((e) => e.name !== "privateRemarks").map((e) => ({
+{@link `, O = "Read more...}", W = (t) => t.filter((e) => e.name !== "privateRemarks").map((e) => ({
   name: e.name,
-  text: e.text?.map((n) => n.text).join("")
+  text: e.text?.map((s) => s.text).join("")
 }));
-function we(t) {
-  const e = Array.from(t.docsTags ?? []), n = t, o = t;
+function et(t) {
+  const e = Array.from(t.docsTags ?? []), s = t, n = t;
   if (t.deprecated && e.push({
     name: "deprecated",
     text: t.deprecated === !0 ? void 0 : t.deprecated
-  }), n.default && e.push({
+  }), s.default && e.push({
     name: "default",
-    text: n.default
-  }), o.cssParts)
-    for (const r of o.cssParts)
+    text: s.default
+  }), n.cssParts)
+    for (const i of n.cssParts)
       e.push({
         name: "csspart",
-        text: T(r)
+        text: u(i)
       });
-  if (o.cssStates)
-    for (const r of o.cssStates)
+  if (n.cssStates)
+    for (const i of n.cssStates)
       e.push({
         name: "cssstate",
-        text: T(r)
+        text: u(i)
       });
-  if (o.slots)
-    for (const r of o.slots)
+  if (n.slots)
+    for (const i of n.slots)
       e.push({
         name: "slot",
-        text: T(r)
+        text: u(i)
       });
-  o.privacy === "private" && e.push({
+  n.privacy === "private" && e.push({
     name: "private",
     text: void 0
   });
-  const s = t.description ?? "";
-  return e.length === 0 && s.length === 0 ? [] : [he(s, e)];
+  const o = t.description ?? "";
+  return e.length === 0 && o.length === 0 ? [] : [J(o, e)];
 }
-function he(t = "", e = []) {
+function J(t = "", e = []) {
   return {
     kind: c.SyntaxKind.MultiLineCommentTrivia,
     pos: -1,
     end: -1,
-    text: me(t, e),
+    text: R(t, e),
     hasTrailingNewLine: !0
   };
 }
-function me(t = "", e = []) {
-  const n = t === "" ? [] : t.split(`
-`), s = n.length + e.length > 1 || (e.at(0)?.text?.includes(`
+function R(t = "", e = []) {
+  const s = t === "" ? [] : t.split(`
+`), o = s.length + e.length > 1 || (e.at(0)?.text?.includes(`
 `) ?? !1);
-  return `*${s ? n.map((r) => `
- * ${r}`).join("") : ` ${t}`}${n.length > 0 && e.length > 0 ? `
- *` : ""}${e.map((r) => {
-    const i = `@${r.name}`, a = r.text ?? "", u = r.text?.includes(`
+  return `*${o ? s.map((i) => `
+ * ${i}`).join("") : ` ${t}`}${s.length > 0 && e.length > 0 ? `
+ *` : ""}${e.map((i) => {
+    const r = `@${i.name}`, a = i.text ?? "", d = i.text?.includes(`
 `) ?? !1;
-    return `${s ? `
- * ` : ""}${i}${u ? a.split(`
-`).map((b) => `
- * ${b}`).join("") : a.length > 0 ? ` ${a}` : ""}`;
-  }).join("")}${s ? `
+    return `${o ? `
+ * ` : ""}${r}${d ? a.split(`
+`).map((f) => `
+ * ${f}`).join("") : a.length > 0 ? ` ${a}` : ""}`;
+  }).join("")}${o ? `
 ` : ""} `;
 }
-function Be(t, e, n, o) {
-  const s = e.getSymbolAtLocation(t);
-  if (o ??= s === void 0 ? void 0 : de(e, s), o !== void 0) {
-    for (const r of o.docsTags) {
-      const { name: i, text: a } = r;
-      i === "deprecated" ? n.deprecated = a || !0 : i === "default" ? n.default = a : i === "readonly" ? n.readonly = !0 : i === "private" ? n.privacy = "private" : i === "csspart" ? n.cssParts.push(y(a)) : i === "cssstate" ? n.cssStates.push(y(a)) : i === "slot" ? n.slots.push(y(a)) : (n.docsTags ??= [], n.docsTags.push(r));
+function st(t, e, s, n) {
+  const o = e.getSymbolAtLocation(t);
+  if (n ??= o === void 0 ? void 0 : P(e, o), n !== void 0) {
+    for (const i of n.docsTags) {
+      const { name: r, text: a } = i;
+      r === "deprecated" ? s.deprecated = a || !0 : r === "default" ? s.default = a : r === "readonly" ? s.readonly = !0 : r === "private" ? s.privacy = "private" : r === "csspart" ? s.cssParts.push(p(a)) : r === "cssstate" ? s.cssStates.push(p(a)) : r === "slot" ? s.slots.push(p(a)) : (s.docsTags ??= [], s.docsTags.push(i));
     }
-    n.description = o.description;
+    s.description = n.description;
   }
 }
-function y(t) {
+function p(t) {
   if (t === void 0)
     return { name: "" };
   const e = t.indexOf(" - ");
   if (e === -1)
     return t.startsWith("- ") ? { name: "", description: t.slice(2) } : { name: t };
-  let n, o = t.slice(0, e);
-  if (o.startsWith("[") && o.endsWith("]")) {
-    const r = o.slice(1, -1), i = r.indexOf("=");
-    o = r.slice(0, i), n = r.slice(i + 1);
+  let s, n = t.slice(0, e);
+  if (n.startsWith("[") && n.endsWith("]")) {
+    const i = n.slice(1, -1), r = i.indexOf("=");
+    n = i.slice(0, r), s = i.slice(r + 1);
   }
-  const s = t.slice(e + 3);
+  const o = t.slice(e + 3);
   return {
-    name: o,
-    default: n,
-    description: s
+    name: n,
+    default: s,
+    description: o
   };
 }
-function T(t) {
-  const e = t.name + (t.default !== void 0 ? `=${t.default}` : ""), n = e.length > 0 ? `[${e}]` : "", o = t.description ?? "", s = o.length > 0 ? ` - ${o}` : "";
-  return `${n}${s}`;
+function u(t) {
+  const e = t.name + (t.default !== void 0 ? `=${t.default}` : ""), s = e.length > 0 ? `[${e}]` : "", n = t.description ?? "", o = n.length > 0 ? ` - ${n}` : "";
+  return `${s}${o}`;
 }
 export {
-  Ce as ApiExtractor,
-  le as apiExtractorError,
-  se as apiExtractorErrorCount,
-  re as apiExtractorErrorFiles,
-  we as apiMemberToSynthesizedComments,
-  oe as debugPrintNode,
-  ke as findDecorator,
-  Me as getMemberName,
-  Se as globalPackageIdentifier,
-  Ee as hasIgnoredModifier,
-  ye as isApiMethod,
-  Te as isApiProperty,
-  G as multipleJsDocTags,
-  ne as printNode,
-  Be as setApiDocFromJsDoc,
-  Ae as setApiExtractorErrorLogger,
-  Oe as setDefaultFromInitializer,
-  de as symbolToDocs
+  X as ApiExtractor,
+  N as apiExtractorError,
+  A as apiExtractorErrorCount,
+  I as apiExtractorErrorFiles,
+  et as apiMemberToSynthesizedComments,
+  L as debugPrintNode,
+  tt as findDecorator,
+  _ as getMemberName,
+  G as globalPackageIdentifier,
+  Y as hasIgnoredModifier,
+  H as isApiMethod,
+  q as isApiProperty,
+  C as multipleJsDocTags,
+  w as printNode,
+  st as setApiDocFromJsDoc,
+  Q as setApiExtractorErrorLogger,
+  Z as setDefaultFromInitializer,
+  P as symbolToDocs
 };

package/package.json

@@ -1,12 +1,13 @@
 {
   "name": "@arcgis/api-extractor",
-  "version": "5.0.0-next.3",
+  "version": "5.0.0-next.31",
   "type": "module",
   "main": "dist/index.cjs",
   "module": "dist/index.js",
   "types": "dist/index.d.ts",
   "exports": {
     ".": "./dist/index.js",
+    "./diff": "./dist/diff/index.js",
     "./package.json": "./package.json"
   },
   "files": [
@@ -14,8 +15,9 @@
   ],
   "license": "SEE LICENSE IN LICENSE.md",
   "dependencies": {
-    "@arcgis/components-build-utils": "5.0.0-next.3",
-    "@arcgis/toolkit": "5.0.0-next.3",
+    "@arcgis/components-build-utils": "5.0.0-next.31",
+    "@arcgis/toolkit": "5.0.0-next.31",
+    "chalk": "^5.4.1",
     "tslib": "^2.8.1",
     "typescript": "~5.8.3"
   }