@arcgis/api-extractor 4.34.0-next.99 → 5.0.0-next.1

package/LICENSE.md

@@ -0,0 +1,17 @@
+# Licensing
+
+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.
+You may redistribute and use this code without modification, provided you adhere to the terms of the MLA and include this copyright notice.
+
+For additional information, contact:
+Environmental Systems Research Institute, Inc.
+Attn: Contracts and Legal Services Department
+380 New York Street
+Redlands, California, USA 92373
+USA
+
+email: legal@esri.com

package/README.md

@@ -8,18 +8,6 @@ It is not intended to be used directly, but rather used as a dependency by other
 
 ## License
 
-COPYRIGHT © 2025 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.
-You may redistribute and use this code without modification, provided you adhere to the terms of the MLA and include this copyright notice.
-
-For additional information, contact:
-Environmental Systems Research Institute, Inc.
-Attn: Contracts and Legal Services Department
-380 New York Street
-Redlands, California, USA 92373
-USA
-
-email: legal@esri.com
+This package is licensed under the terms described in the `LICENSE.md` file, located in the root of the package.

package/dist/extractor/index.d.ts

@@ -40,7 +40,7 @@ export declare abstract class ApiExtractor {
      * Infer ApiExport based on ApiDeclaration
      */
     protected abstract inferExport(declaration: ApiDeclaration): ApiExport | undefined;
-    copyDoc(copyDocDefinition: CopyPropertyDoc | undefined, property: ApiCustomElementField, component: ApiCustomElementDeclaration): void;
-    copyDoc(copyDocDefinition: CopyMethodDoc | undefined, method: ApiClassMethod, component: ApiCustomElementDeclaration): void;
-    copyDoc(copyDocDefinition: CopyEventDoc | undefined, event: ApiEvent, component: ApiCustomElementDeclaration): void;
+    copyDoc(errorReportingNode: ts.Node, copyDocDefinition: CopyPropertyDoc | undefined, property: ApiCustomElementField, component: ApiCustomElementDeclaration): void;
+    copyDoc(errorReportingNode: ts.Node, copyDocDefinition: CopyMethodDoc | undefined, method: ApiClassMethod, component: ApiCustomElementDeclaration): void;
+    copyDoc(errorReportingNode: ts.Node, copyDocDefinition: CopyEventDoc | undefined, event: ApiEvent, component: ApiCustomElementDeclaration): void;
 }

package/dist/index.d.ts

@@ -2,5 +2,7 @@ export { ApiExtractor, type ApiExtractorOptions } from './extractor';
 export type * from './apiJson';
 export { hasIgnoredModifier, setDefaultFromInitializer, getMemberName, findDecorator } from './utils/astHelpers';
 export { isApiMethod, isApiProperty, globalPackageIdentifier, multipleJsDocTags } from './utils/apiHelpers';
+export { apiExtractorError, apiExtractorErrorCount, apiExtractorErrorFiles, setApiExtractorErrorLogger, type ApiExtractorErrorContext, } from './utils/error';
+export { debugPrintNode, printNode } from './utils/print';
 export type { CopyDocDefinitions } from './types';
 export { symbolToDocs, apiMemberToSynthesizedComments, setApiDocFromJsDoc } from './utils/docHelpers';

package/dist/index.js

@@ -1,12 +1,12 @@
-import a from "typescript";
-import { path as x } from "@arcgis/components-build-utils";
-import { mappedFind as m } from "@arcgis/toolkit/array";
-const h = "@arcgis/api-extractor", g = "4.34.0-next.99", j = (e) => e.kind === "method", A = (e) => e.kind === "field";
-function v(e, s) {
-  const t = e.path.split("/"), n = t.pop(), i = t.join("/"), o = s.path.split("/"), c = o.pop(), r = o.join("/");
-  return i === r ? n < c ? -1 : 1 : i.startsWith(r) ? 1 : r.startsWith(i) || i < r ? -1 : 1;
-}
-const C = "global:", T = /* @__PURE__ */ new Set([
+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.1", 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;
+}
+const Se = "global:", G = /* @__PURE__ */ new Set([
   "example",
   "see",
   "param",
@@ -15,228 +15,541 @@ const C = "global:", T = /* @__PURE__ */ new Set([
   "slot",
   "csspart",
   "cssstate"
-]);
-class F {
-  constructor(s) {
-    this.options = s;
+]), 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);
+}
+function oe(t, e) {
+  return t.pos !== -1 && t.end !== -1 && e !== void 0 ? t.getText(e) : ne(t);
+}
+let se = 0;
+const re = /* @__PURE__ */ new Set();
+let I = console.error;
+function Ae(t) {
+  I = t;
+}
+const ie = {
+  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 = {
+    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 ? "" : `
+
+${oe(n, e)}`)
+  }, O = c.formatDiagnosticsWithColorAndContext([b], ie), F = S ? O : O.replaceAll(ae, "");
+  I(F);
+}
+const ce = 1490, ae = /\x1B\[[0-9;]*m/gu;
+class Ce {
+  constructor(e) {
+    this.options = e;
   }
   /** Given an array of TypeScript source files, generate an api.json file */
-  extract(s) {
+  extract(e) {
     return {
       timestamp: (/* @__PURE__ */ new Date()).toISOString().split(".")[0],
       compiler: {
-        name: h,
-        version: g,
-        typescriptVersion: a.version
+        name: N,
+        version: K,
+        typescriptVersion: c.version
       },
       schemaVersion: "1.0.0",
-      modules: this.extractModules(s)
+      modules: this.extractModules(e)
     };
   }
-  extractModules(s) {
-    const t = [];
-    for (const n of s)
-      this.file = n, t.push(this.extractModule(n));
-    return this.options.isFullApiExtraction && t.sort(v), t;
+  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;
   }
-  extractModule(s) {
-    const t = {
+  extractModule(e) {
+    const n = {
       kind: "javascript-module",
-      path: x.relative(this.options.cwd, s.fileName),
+      path: P.relative(this.options.cwd, e.fileName),
       declarations: void 0,
       exports: void 0
     };
-    this.apiModule = t;
-    const n = this.extractDeclarations(s);
-    if (t.declarations = n, this.options.isFullApiExtraction) {
-      const i = this.inferExports(n);
-      i.length > 0 && (t.exports = i);
+    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);
     }
-    return t;
+    return n;
   }
   /**
    * For a given module, extract all public declarations.
    */
-  extractDeclarations(s) {
-    const t = [];
-    for (const n of s.statements) {
-      const i = this.extractDeclaration(n);
-      i !== void 0 && t.push(i);
+  extractDeclarations(e) {
+    const n = [];
+    for (const o of e.statements) {
+      const s = this.extractDeclaration(o);
+      s !== void 0 && n.push(s);
     }
-    return t;
+    return n;
   }
   /**
    * Infer ApiModule.exports based on ApiModule.declarations.
    */
-  inferExports(s) {
-    const t = [];
-    for (const n of s) {
-      const i = this.inferExport(n);
-      i !== void 0 && t.push(i);
+  inferExports(e) {
+    const n = [];
+    for (const o of e) {
+      const s = this.inferExport(o);
+      s !== void 0 && n.push(s);
     }
-    return t;
+    return n;
   }
-  copyDoc(s, t, n) {
-    const i = t.docsTags?.findIndex((r) => r.name === "copyDoc");
-    if (i === void 0 || i === -1)
+  copyDoc(e, n, o, s) {
+    const r = o.docsTags?.findIndex((u) => u.name === "copyDoc");
+    if (r === void 0 || r === -1)
       return;
-    if (s === void 0)
-      throw Error(
-        `The ${t.name} ${"kind" in t ? t.kind : "event"} in ${n.name} has @copyDoc tag, but failed to find copyDoc definition for it.`
-      );
-    const o = s?.(t, n);
-    if (o === void 0)
+    n === void 0 && le("@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)
       return;
-    for (const [r, d] of Object.entries(o))
-      r !== "docsTags" && (t[r] = t[r] ?? d);
-    t.docsTags.splice(i, 1);
-    const c = new Set(t.docsTags.map(({ name: r }) => r));
-    for (const r of o.docsTags ?? [])
-      c.has(r.name) && !T.has(r.name) || t.docsTags.push(r);
-    t.docsTags.length === 0 && (t.docsTags = void 0);
+    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);
   }
 }
-const N = (e) => e.modifiers?.some?.(
-  (s) => s.kind === a.SyntaxKind.StaticKeyword || s.kind === a.SyntaxKind.PrivateKeyword || s.kind === a.SyntaxKind.ProtectedKeyword
+const Ee = (t) => t.modifiers?.some?.(
+  (e) => e.kind === c.SyntaxKind.StaticKeyword || e.kind === c.SyntaxKind.PrivateKeyword || e.kind === c.SyntaxKind.ProtectedKeyword
 ) ?? !1;
-function O(e, s, t) {
-  if (!s.default && "initializer" in e && e.initializer) {
-    const n = u(e.initializer);
-    y(n) && (s.default = n.getText(t));
+function Oe(t, e, n) {
+  if (!e.default && "initializer" in t && t.initializer) {
+    const o = L(t.initializer);
+    ue(o) && (e.default = o.getText(n));
   }
 }
-const y = (e) => a.isLiteralExpression(e) || e.kind === a.SyntaxKind.TrueKeyword || e.kind === a.SyntaxKind.FalseKeyword || a.isPrefixUnaryExpression(e) && a.isLiteralExpression(e.operand);
-function u(e) {
-  return a.isSatisfiesExpression(e) || a.isParenthesizedExpression(e) ? u(e.expression) : e;
+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;
 }
-function b(e) {
-  if (e !== void 0 && (a.isIdentifier(e) || a.isStringLiteralLike(e)))
-    return e.text;
+function Me(t) {
+  if (t !== void 0 && (c.isIdentifier(t) || c.isStringLiteralLike(t)))
+    return t.text;
 }
-const W = ({ modifiers: e = [] }, s) => m(
-  e,
-  (t) => a.isDecorator(t) && a.isCallExpression(t.expression) && a.isIdentifier(t.expression.expression) && t.expression.expression.text === s ? t.expression : void 0
+const ke = ({ modifiers: t = [] }, e) => R(
+  t,
+  (n) => c.isDecorator(n) && c.isCallExpression(n.expression) && c.isIdentifier(n.expression.expression) && n.expression.expression.text === e ? n.expression : void 0
 );
-function S(e, s) {
-  const t = $(s.getJsDocTags());
-  let n = a.displayPartsToString(s.getDocumentationComment(e));
-  const i = t.at(-1), o = i?.text?.indexOf(k);
-  if (o !== void 0 && o !== -1) {
-    const c = i.text.indexOf(D);
-    c !== -1 && (n += i.text.slice(c), i.text = i.text?.slice(0, c));
+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));
   }
   return {
-    docsTags: t,
-    description: n || void 0
+    docsTags: n,
+    description: o || void 0
   };
 }
-const D = `
+const fe = `
 
-{@link `, k = "Read more...}", $ = (e) => e.map((s) => ({
-  name: s.name,
-  text: s.text?.map((t) => t.text).join("")
+{@link `, pe = "Read more...}", ge = (t) => t.filter((e) => e.name !== "privateRemarks").map((e) => ({
+  name: e.name,
+  text: e.text?.map((n) => n.text).join("")
 }));
-function J(e) {
-  const s = Array.from(e.docsTags ?? []), t = e, n = e;
-  if (e.deprecated && s.push({
+function we(t) {
+  const e = Array.from(t.docsTags ?? []), n = t, o = t;
+  if (t.deprecated && e.push({
     name: "deprecated",
-    text: e.deprecated === !0 ? void 0 : e.deprecated
-  }), t.default && s.push({
+    text: t.deprecated === !0 ? void 0 : t.deprecated
+  }), n.default && e.push({
     name: "default",
-    text: t.default
-  }), n.cssParts)
-    for (const o of n.cssParts)
-      s.push({
+    text: n.default
+  }), o.cssParts)
+    for (const r of o.cssParts)
+      e.push({
         name: "csspart",
-        text: f(o)
+        text: T(r)
       });
-  if (n.cssStates)
-    for (const o of n.cssStates)
-      s.push({
+  if (o.cssStates)
+    for (const r of o.cssStates)
+      e.push({
         name: "cssstate",
-        text: f(o)
+        text: T(r)
       });
-  if (n.slots)
-    for (const o of n.slots)
-      s.push({
+  if (o.slots)
+    for (const r of o.slots)
+      e.push({
         name: "slot",
-        text: f(o)
+        text: T(r)
       });
-  n.privacy === "private" && s.push({
+  o.privacy === "private" && e.push({
     name: "private",
     text: void 0
   });
-  const i = e.description ?? "";
-  return s.length === 0 && i.length === 0 ? [] : [E(i, s)];
+  const s = t.description ?? "";
+  return e.length === 0 && s.length === 0 ? [] : [he(s, e)];
 }
-function E(e = "", s = []) {
+function he(t = "", e = []) {
   return {
-    kind: a.SyntaxKind.MultiLineCommentTrivia,
+    kind: c.SyntaxKind.MultiLineCommentTrivia,
     pos: -1,
     end: -1,
-    text: I(e, s),
+    text: me(t, e),
     hasTrailingNewLine: !0
   };
 }
-function I(e = "", s = []) {
-  const t = e === "" ? [] : e.split(`
-`), i = t.length + s.length > 1 || (s.at(0)?.text?.includes(`
+function me(t = "", e = []) {
+  const n = t === "" ? [] : t.split(`
+`), s = n.length + e.length > 1 || (e.at(0)?.text?.includes(`
 `) ?? !1);
-  return `*${i ? t.map((o) => `
- * ${o}`).join("") : ` ${e}`}${t.length > 0 && s.length > 0 ? `
- *` : ""}${s.map((o) => {
-    const c = `@${o.name}`, r = o.text ?? "", d = o.text?.includes(`
+  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(`
 `) ?? !1;
-    return `${i ? `
- * ` : ""}${c}${d ? r.split(`
-`).map((p) => `
- * ${p}`).join("") : r.length > 0 ? ` ${r}` : ""}`;
-  }).join("")}${i ? `
+    return `${s ? `
+ * ` : ""}${i}${u ? a.split(`
+`).map((b) => `
+ * ${b}`).join("") : a.length > 0 ? ` ${a}` : ""}`;
+  }).join("")}${s ? `
 ` : ""} `;
 }
-function V(e, s, t, n) {
-  const i = s.getSymbolAtLocation(e);
-  if (n ??= i === void 0 ? void 0 : S(s, i), n !== void 0) {
-    for (const o of n.docsTags) {
-      const { name: c, text: r } = o;
-      c === "deprecated" ? t.deprecated = r || !0 : c === "default" ? t.default = r : c === "readonly" ? t.readonly = !0 : c === "private" ? t.privacy = "private" : c === "csspart" ? t.cssParts.push(l(r)) : c === "cssstate" ? t.cssStates.push(l(r)) : c === "slot" ? t.slots.push(l(r)) : (t.docsTags ??= [], t.docsTags.push(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));
     }
-    t.description = n.description;
+    n.description = o.description;
   }
 }
-function l(e) {
-  if (e === void 0)
+function y(t) {
+  if (t === void 0)
     return { name: "" };
-  const s = e.indexOf(" - ");
-  if (s === -1)
-    return e.startsWith("- ") ? { name: "", description: e.slice(2) } : { name: e };
-  let t, n = e.slice(0, s);
-  if (n.startsWith("[") && n.endsWith("]")) {
-    const o = n.slice(1, -1), c = o.indexOf("=");
-    n = o.slice(0, c), t = o.slice(c + 1);
-  }
-  const i = e.slice(s + 3);
+  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);
+  }
+  const s = t.slice(e + 3);
   return {
-    name: n,
-    default: t,
-    description: i
+    name: o,
+    default: n,
+    description: s
   };
 }
-function f(e) {
-  const s = e.name + (e.default !== void 0 ? `=${e.default}` : ""), t = s.length > 0 ? `[${s}]` : "", n = e.description ?? "", i = n.length > 0 ? ` - ${n}` : "";
-  return `${t}${i}`;
+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}`;
 }
 export {
-  F as ApiExtractor,
-  J as apiMemberToSynthesizedComments,
-  W as findDecorator,
-  b as getMemberName,
-  C as globalPackageIdentifier,
-  N as hasIgnoredModifier,
-  j as isApiMethod,
-  A as isApiProperty,
-  T as multipleJsDocTags,
-  V as setApiDocFromJsDoc,
-  O as setDefaultFromInitializer,
-  S as symbolToDocs
+  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
 };

package/dist/utils/error.d.ts

@@ -0,0 +1,12 @@
+import { default as ts } from 'typescript';
+export declare let apiExtractorErrorCount: number;
+export declare const apiExtractorErrorFiles: Set<string>;
+export declare function setApiExtractorErrorLogger(logger: (msg: string) => void): void;
+export interface ApiExtractorErrorContext {
+    file: ts.SourceFile | undefined;
+    node: ts.Node | undefined;
+    scope?: string;
+    start?: number;
+    length?: number;
+}
+export declare function apiExtractorError(message: string, { file, node, scope, start, length }: ApiExtractorErrorContext): void;

package/dist/utils/print.d.ts

@@ -0,0 +1,7 @@
+import { default as ts } from 'typescript';
+export declare function printNode(node: ts.Node): string;
+/**
+ * For usage in error messages. Print original node text if available. Otherwise,
+ * print the AST.
+ */
+export declare function debugPrintNode(node: ts.Node, sourceFile: ts.SourceFile | undefined): string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@arcgis/api-extractor",
-  "version": "4.34.0-next.99",
+  "version": "5.0.0-next.1",
   "type": "module",
   "main": "dist/index.cjs",
   "module": "dist/index.js",
@@ -14,8 +14,8 @@
   ],
   "license": "SEE LICENSE IN LICENSE.md",
   "dependencies": {
-    "@arcgis/components-build-utils": "4.34.0-next.99",
-    "@arcgis/toolkit": "4.34.0-next.99",
+    "@arcgis/components-build-utils": "5.0.0-next.1",
+    "@arcgis/toolkit": "5.0.0-next.1",
     "tslib": "^2.8.1",
     "typescript": "~5.8.3"
   }