@arcgis/api-extractor 5.2.0-next.90 → 5.2.0-next.93

package/dist/apiJson.d.ts

@@ -452,23 +452,14 @@ export interface ApiWithInheritance {
 }
 
 /** @see [MDN Slot](https://developer.mozilla.org/docs/Web/HTML/Element/slot) */
-export interface ApiSlot extends ApiWithDescription, ApiWithUnusedSummary {
+export interface ApiSlot extends ApiWithDescription, ApiWithDocsTags, ApiWithDeprecated, ApiWithUnusedSummary {
   /**
    * The slot name, or the empty string for an unnamed slot.
    *
    * @example "header"
    */
   name: string;
-  /**
-   * Whether the slot is deprecated.
-   * If the value is a string, it's the reason for the deprecation.
-   *
-   * @deprecated
-   * Not used by `@arcgis/api-extractor`. Preserved in types for compatibility
-   * with custom-elements-manifest.
-   * @default false
-   */
-  deprecated?: string | true;
+  type?: ApiType;
 }
 
 /**
@@ -476,19 +467,10 @@ export interface ApiSlot extends ApiWithDescription, ApiWithUnusedSummary {
  *
  * @see https://developer.mozilla.org/docs/Web/CSS/CSS_shadow_parts
  */
-export interface ApiCssPart extends ApiWithDescription, ApiWithUnusedSummary {
+export interface ApiCssPart extends ApiWithDescription, ApiWithDocsTags, ApiWithDeprecated, ApiWithUnusedSummary {
   /** @example "tab" */
   name: string;
-  /**
-   * Whether the CSS shadow part is deprecated.
-   * If the value is a string, it's the reason for the deprecation.
-   *
-   * @deprecated
-   * Not used by `@arcgis/api-extractor`. Preserved in types for compatibility
-   * with custom-elements-manifest.
-   * @default false
-   */
-  deprecated?: string | true;
+  type?: ApiType;
 }
 
 /**
@@ -496,7 +478,7 @@ export interface ApiCssPart extends ApiWithDescription, ApiWithUnusedSummary {
  *
  * @see https://developer.mozilla.org/docs/Web/API/CustomStateSet
  */
-export interface ApiCssCustomState extends ApiWithDescription, ApiWithUnusedSummary {
+export interface ApiCssCustomState extends ApiWithDescription, ApiWithDocsTags, ApiWithDeprecated, ApiWithUnusedSummary {
   /**
    * The name of the state. Note: Unlike CSS custom properties, custom states
    * do not have a leading `--`.
@@ -504,55 +486,28 @@ export interface ApiCssCustomState extends ApiWithDescription, ApiWithUnusedSumm
    * @example "active"
    */
   name: string;
-  /**
-   * Whether the CSS custom state is deprecated.
-   * If the value is a string, it's the reason for the deprecation.
-   *
-   * @deprecated
-   * Not used by `@arcgis/api-extractor`. Preserved in types for compatibility
-   * with custom-elements-manifest.
-   * @default false
-   */
-  deprecated?: string | true;
 }
 
-export interface ApiCssCustomProperty extends ApiWithDescription, ApiWithUnusedSummary {
+export interface ApiCssCustomProperty extends ApiWithDescription, ApiWithDocsTags, ApiWithDeprecated, ApiWithUnusedSummary {
   /**
    * The name of the property, including leading `--`.
    *
    * @example "--calcite-text-color"
    */
   name: string;
+  type?: ApiType;
   /**
-   * The expected syntax of the defined property. Defaults to "*".
-   *
-   * The syntax must be a valid CSS
-   * [syntax string](https://developer.mozilla.org/docs/Web/CSS/@property/syntax)
-   * as defined in the CSS Properties and Values API.
-   *
-   * Examples:
-   *
-   * "<color>": accepts a color
-   * "<length> | <percentage>": accepts lengths or percentages but not calc expressions with a combination of the two
-   * "small | medium | large": accepts one of these values set as custom indents.
-   * "*": any valid token
+   * A [CSS syntax string](https://developer.mozilla.org/en-US/docs/Web/CSS/@property/syntax)
    *
    * @deprecated
    * Not used by `@arcgis/api-extractor`. Preserved in types for compatibility
    * with custom-elements-manifest.
+   *
+   * We use [ApiCssCustomProperty](https://developers.arcgis.com/javascript/latest/references/api-extractor/apiJson/#ApiCssCustomProperty-) instead, which is more
+   * powerful, and we have existing utils for dealing with it.
    */
   syntax?: string;
   default?: string;
-  /**
-   * Whether the CSS custom property is deprecated.
-   * If the value is a string, it's the reason for the deprecation.
-   *
-   * @deprecated
-   * Not used by `@arcgis/api-extractor`. Preserved in types for compatibility
-   * with custom-elements-manifest.
-   * @default false
-   */
-  deprecated?: string | true;
 }
 
 export interface ApiType extends ApiWithUnusedSource {

package/dist/config-D0cgQ7jF.js

@@ -0,0 +1,191 @@
+import { existsAsync as S } from "@arcgis/node-toolkit/file";
+import { path as y, getCwd as E } from "@arcgis/node-toolkit/path";
+import { retrievePackageJson as U } from "@arcgis/node-toolkit/packageJson";
+import { loadTypeScriptConfig as b } from "@arcgis/node-toolkit/vite/typeScript";
+import { identity as d } from "@arcgis/toolkit/function";
+import { pathToFileURL as I } from "node:url";
+import { getDefaultBasePath as J } from "./extractor/processing/links.js";
+const w = "@arcgis/api-extractor", L = "5.2.0-next.93", A = {
+  name: w,
+  version: L
+}, T = "developers.arcgis.com", k = "next.gha.afd.arcgis.com";
+function N(e) {
+  if (e.isResolvedConfig === !0)
+    return e;
+  const t = e.context, o = e.types, n = e.documentation, r = `${t?.cwd === void 0 ? E() : y.resolve(t?.cwd)}/`, s = t?.packageJson ?? U(r);
+  let c = t?.basePath ?? "src/";
+  c.endsWith("/") || (c += "/");
+  const m = "customElements" in s && "@arcgis/lumina" in (s.dependencies ?? {}), l = o?.typeCheckedExtraction ?? m, p = o?.fullTypeCheck ?? !1, a = o?.typeScriptConfig ?? (l || p ? b(r, o?.typeScriptConfigPath, !0) : {
+    configPath: "",
+    config: {
+      options: {},
+      fileNames: [],
+      errors: []
+    }
+  });
+  if (o?.typeScriptConfig?.config.fileNames.length === 0)
+    throw Error(
+      `${A.name}: Provided types.typeScriptConfig has no included files. If you used loadTypeScriptConfig, make sure to set resolveIncludedFiles to true.`
+    );
+  const h = {
+    config: {
+      ...a.config,
+      options: {
+        ...a.config.options,
+        ...o?.compilerOptions
+      }
+    },
+    configPath: a.configPath
+  }, g = t?.dtsEmitPath === void 0 || t?.dtsEmitPath === "" ? "" : `${y.resolve(r, t.dtsEmitPath)}/`, x = g !== "", P = t?.environment ?? "production", u = P === "development", v = t?.emptyDtsEmitPath ?? (!u && x), D = n?.omitInternal ?? !1, C = o?.forceProduceDts ?? !1;
+  if (D && (x || C))
+    throw Error(
+      "omitInternal must be false if emitting .d.ts files in order to produce functional types for internal APIs."
+    );
+  return {
+    isResolvedConfig: !0,
+    context: {
+      dtsEmitPath: g,
+      emptyDtsEmitPath: v,
+      apiJsonEmitPath: t?.apiJsonEmitPath ?? "",
+      environment: P,
+      cwd: r,
+      basePath: c,
+      packageJson: s,
+      logger: t?.logger ?? {
+        // We namespace manually
+        // eslint-disable-next-line webgis/consistent-logging
+        info: console.log,
+        // eslint-disable-next-line webgis/consistent-logging
+        error: console.error
+      },
+      excludedDirectories: t?.excludedDirectories ?? /* @__PURE__ */ new Set(),
+      isLuminaMinimalExtraction: t?.isLuminaMinimalExtraction ?? !1,
+      includeLuminaPrivateComponents: t?.includeLuminaPrivateComponents ?? !1,
+      supportApplyMixinsSyntax: t?.supportApplyMixinsSyntax ?? !1
+    },
+    types: {
+      typeCheckedExtraction: l,
+      fullTypeCheck: p,
+      afterDiagnostic: o?.afterDiagnostic ?? d,
+      typeScriptInstanceCreated: o?.typeScriptInstanceCreated ?? d,
+      typeScriptConfigPath: a.configPath,
+      typeScriptConfig: h,
+      compilerOptions: h.config.options,
+      declarationTextTransformers: o?.declarationTextTransformers ?? [],
+      typeReplacements: o?.typeReplacements ?? {},
+      forceProduceDts: C
+    },
+    documentation: {
+      copyDocDefinitions: n?.copyDocDefinitions ?? {},
+      noInheritMembers: n?.noInheritMembers ?? {},
+      omitInternal: D,
+      publicStoryUrlPrefix: n?.publicStoryUrlPrefix ?? !1,
+      getComponentDocsUrl: n?.getComponentDocsUrl ?? !1,
+      getComponentDemoUrl: n?.getComponentDemoUrl ?? !1,
+      host: n?.host ?? (u ? k : T),
+      alternativeHost: n?.alternativeHost ?? (u ? T : k),
+      basePath: n?.basePath ?? J(s.name.split("/").at(-1))
+    },
+    verify: {
+      typeCheckTypes: e.verify?.typeCheckTypes ?? !1,
+      filterTypeCheckDiagnostic: e.verify?.filterTypeCheckDiagnostic ?? (() => !0),
+      detectBrokenLinks: e.verify?.detectBrokenLinks ?? !0
+    },
+    watch: {
+      onUpdate: e.watch?.onUpdate ?? d,
+      // Many reads can happen in a short time (on folder moves, or if prettier re-runs)
+      // Shorter than TypeScript's default of 250ms as we are blocked until this
+      // timeout is complete. Short timeout for unchecked extraction as it is fast,
+      // so doesn't need long debounce.
+      debounceTime: e.watch?.debounceTime ?? (l || p ? 50 : 20),
+      clearScreen: e.watch?.clearScreen ?? !1,
+      skipWritingUnchanged: v ? !1 : e.watch?.skipWritingUnchanged ?? !0
+    },
+    strict: e.strict ?? !m,
+    afterApiJsonCreate: e.afterApiJsonCreate ?? d
+  };
+}
+async function V(e, t) {
+  const o = t !== void 0, n = e ?? process.cwd(), i = y.resolve(n, t ?? "api-extractor.config.ts"), r = await S(i);
+  if (o && !r)
+    throw Error(`The provided config file at ${i} does not exist.`);
+  if (!r)
+    return e === void 0 ? {} : { context: { cwd: e } };
+  const s = (await import(I(i).href)).config;
+  return {
+    ...s,
+    context: {
+      ...s.context,
+      cwd: s.context?.cwd ?? y.dirname(i)
+    }
+  };
+}
+function j(e, t) {
+  const o = e.context, n = t.context, i = e.types, r = t.types, s = e.documentation, c = t.documentation, m = e.verify, l = t.verify, p = e.watch, a = t.watch;
+  return {
+    isResolvedConfig: e.isResolvedConfig || t.isResolvedConfig || void 0,
+    context: {
+      dtsEmitPath: n?.dtsEmitPath ?? o?.dtsEmitPath,
+      emptyDtsEmitPath: n?.emptyDtsEmitPath ?? o?.emptyDtsEmitPath,
+      apiJsonEmitPath: n?.apiJsonEmitPath ?? o?.apiJsonEmitPath,
+      environment: n?.environment ?? o?.environment,
+      cwd: n?.cwd ?? o?.cwd,
+      basePath: n?.basePath ?? o?.basePath,
+      packageJson: n?.packageJson ?? o?.packageJson,
+      logger: n?.logger ?? o?.logger,
+      excludedDirectories: n?.excludedDirectories ?? o?.excludedDirectories,
+      isLuminaMinimalExtraction: n?.isLuminaMinimalExtraction ?? o?.isLuminaMinimalExtraction,
+      includeLuminaPrivateComponents: n?.includeLuminaPrivateComponents ?? o?.includeLuminaPrivateComponents,
+      supportApplyMixinsSyntax: n?.supportApplyMixinsSyntax ?? o?.supportApplyMixinsSyntax ?? !1
+    },
+    types: {
+      typeCheckedExtraction: r?.typeCheckedExtraction ?? i?.typeCheckedExtraction,
+      fullTypeCheck: r?.fullTypeCheck ?? i?.fullTypeCheck,
+      afterDiagnostic: f(r?.afterDiagnostic, i?.afterDiagnostic),
+      typeScriptInstanceCreated: f(
+        t?.types?.typeScriptInstanceCreated,
+        e?.types?.typeScriptInstanceCreated
+      ),
+      typeScriptConfigPath: r?.typeScriptConfigPath ?? i?.typeScriptConfigPath,
+      typeScriptConfig: r?.typeScriptConfig ?? i?.typeScriptConfig,
+      compilerOptions: r?.compilerOptions ?? i?.compilerOptions,
+      declarationTextTransformers: r?.declarationTextTransformers !== void 0 && i?.declarationTextTransformers !== void 0 ? [...i.declarationTextTransformers, ...r.declarationTextTransformers] : r?.declarationTextTransformers ?? i?.declarationTextTransformers,
+      typeReplacements: r?.typeReplacements ?? i?.typeReplacements,
+      forceProduceDts: r?.forceProduceDts ?? i?.forceProduceDts
+    },
+    documentation: {
+      copyDocDefinitions: c?.copyDocDefinitions ?? s?.copyDocDefinitions,
+      noInheritMembers: c?.noInheritMembers ?? s?.noInheritMembers,
+      omitInternal: c?.omitInternal ?? s?.omitInternal,
+      publicStoryUrlPrefix: c?.publicStoryUrlPrefix ?? s?.publicStoryUrlPrefix,
+      getComponentDocsUrl: c?.getComponentDocsUrl ?? s?.getComponentDocsUrl,
+      getComponentDemoUrl: c?.getComponentDemoUrl ?? s?.getComponentDemoUrl,
+      host: c?.host ?? s?.host,
+      alternativeHost: c?.alternativeHost ?? s?.alternativeHost,
+      basePath: c?.basePath ?? s?.basePath
+    },
+    verify: {
+      typeCheckTypes: l?.typeCheckTypes ?? m?.typeCheckTypes,
+      filterTypeCheckDiagnostic: l?.filterTypeCheckDiagnostic ?? m?.filterTypeCheckDiagnostic,
+      detectBrokenLinks: l?.detectBrokenLinks ?? m?.detectBrokenLinks
+    },
+    watch: {
+      onUpdate: f(a?.onUpdate, p?.onUpdate),
+      debounceTime: a?.debounceTime ?? p?.debounceTime,
+      clearScreen: a?.clearScreen ?? p?.clearScreen,
+      skipWritingUnchanged: a?.skipWritingUnchanged ?? p?.skipWritingUnchanged
+    },
+    strict: t.strict ?? e.strict,
+    afterApiJsonCreate: f(t.afterApiJsonCreate, e.afterApiJsonCreate)
+  };
+}
+function f(e, t) {
+  const o = t === d ? void 0 : t, n = e === d ? void 0 : e;
+  return o !== void 0 && n !== void 0 ? ((...i) => (o(...i), n(...i))) : n ?? o;
+}
+export {
+  V as l,
+  j as m,
+  A as p,
+  N as r
+};

package/dist/diff/diffApiJson.js

@@ -1,29 +1,29 @@
-function w(i, o) {
-  if (i.compiler?.name !== "@arcgis/core:manual" || i.compiler?.version !== "4.34")
+function w(r, a) {
+  if (r.compiler?.name !== "@arcgis/core:manual" || r.compiler?.version !== "4.34")
     return;
-  const a = {};
-  return i.modules.forEach((e) => {
-    a[e.path] = e;
+  const o = {};
+  return r.modules.forEach((t) => {
+    o[t.path] = t;
   }), {
-    ...o,
-    modules: o.modules.filter((e) => {
-      const t = a[e.path];
-      return e.declarations = e.declarations.filter((s) => {
-        if (s.kind === "mixin")
+    ...a,
+    modules: a.modules.filter((t) => {
+      const e = o[t.path];
+      return t.declarations = t.declarations.filter((n) => {
+        if (n.kind === "mixin")
           return !1;
-        if (s.kind === "interface") {
-          const r = t?.declarations.find(
-            (d) => d.name === s.name && d.kind === "interface"
+        if (n.kind === "interface") {
+          const s = e?.declarations.find(
+            (d) => d.name === n.name && d.kind === "interface"
           );
-          return s.members = void 0, r !== void 0;
+          return n.members = void 0, s !== void 0;
         }
         return !0;
-      }), e.declarations.length > 0;
+      }), t.declarations.length > 0;
     })
   };
 }
-function x(i) {
-  const o = /* @__PURE__ */ new Set([
+function x(r) {
+  const a = /* @__PURE__ */ new Set([
     // Fake class turned into a variable
     "config",
     // Wasn't visible directly before due to doc mismatch
@@ -38,13 +38,13 @@ function x(i) {
     "views/layers/PointCloudLayerView",
     // ENUM-like objects turned into const variable + interfaces
     "layers/support/rasterFunctionConstants"
-  ]), a = i.modules.filter((n) => {
-    if (o.has(n.path))
+  ]), o = r.modules.filter((i) => {
+    if (a.has(i.path))
       return !1;
-    const e = n.path.startsWith("widgets/");
-    return n.declarations = n.declarations.filter((t) => e ? t.deprecated === void 0 && t.removed === void 0 ? !1 : ((t.kind === "class" || t.kind === "interface" || t.kind === "mixin") && (t.members = void 0), !0) : t.kind === "class" ? t.members === void 0 ? !0 : (t.members = t.members.filter((s) => !(s.kind === "constructor" || s.kind === "call-signature" || A.has(s.name))), t.members.length > 0) : !0), n.declarations.length > 0;
+    const t = i.path.startsWith("widgets/");
+    return i.declarations = i.declarations.filter((e) => t ? e.deprecated === void 0 && e.removed === void 0 ? !1 : ((e.kind === "class" || e.kind === "interface" || e.kind === "mixin") && (e.members = void 0), !0) : e.kind === "class" ? e.members === void 0 ? !0 : (e.members = e.members.filter((n) => !(n.kind === "constructor" || n.kind === "call-signature" || A.has(n.name))), e.members.length > 0) : !0), i.declarations.length > 0;
   });
-  return { ...i, modules: a };
+  return { ...r, modules: o };
 }
 const A = /* @__PURE__ */ new Set([
   // Excluded from api.json inheritance to keep file size in check
@@ -96,44 +96,44 @@ const A = /* @__PURE__ */ new Set([
   // 6
   "loadWarnings"
 ]);
-function N(i, o) {
-  const a = w(i, o), n = a ?? o, e = i.compiler?.version.startsWith("4.") === !0 && n.compiler?.version.startsWith("4.") !== !0, t = new Map(
-    i.modules.map((d) => [
-      b(d, e),
+function I(r, a) {
+  const o = w(r, a), i = o ?? a, t = r.compiler?.version.startsWith("4.") === !0 && i.compiler?.version.startsWith("4.") !== !0, e = new Map(
+    r.modules.map((d) => [
+      b(d, t),
       d
     ])
-  ), s = [];
-  for (const d of n.modules) {
-    const l = t.get(d.path), m = y(l, d, !0);
-    m !== void 0 && s.push(m), t.delete(d.path);
+  ), n = [];
+  for (const d of i.modules) {
+    const l = e.get(d.path), m = y(l, d, !0);
+    m !== void 0 && n.push(m), e.delete(d.path);
   }
-  for (const d of t.values()) {
+  for (const d of e.values()) {
     const l = y(
       void 0,
-      e ? { ...d, path: b(d, e) } : d,
+      t ? { ...d, path: b(d, t) } : d,
       !1
     );
-    l !== void 0 && s.push(l);
+    l !== void 0 && n.push(l);
   }
-  const r = { modules: s };
-  return a === void 0 ? r : x(r);
+  const s = { modules: n };
+  return o === void 0 ? s : x(s);
 }
-function b(i, o) {
-  return o ? i.declarations?.[0]?.importPath ?? i.path : i.path;
+function b(r, a) {
+  return a ? r.declarations?.[0]?.importPath ?? r.path : r.path;
 }
-function y(i, o, a) {
-  const n = [], e = h(i?.declarations ?? []), t = h(o.declarations ?? []);
-  for (const s of t.values()) {
-    const r = s.at(-1), d = r.tagName, l = d ?? r.name, m = e.get(l);
-    e.delete(l);
-    const g = m === void 0 && !a ? !0 : void 0, v = (
+function y(r, a, o) {
+  const i = [], t = h(r?.declarations ?? []), e = h(a.declarations ?? []);
+  for (const n of e.values()) {
+    const s = n.at(-1), d = s.tagName, l = d ?? s.name, m = t.get(l);
+    t.delete(l);
+    const g = m === void 0 && !o ? !0 : void 0, v = (
       // Only mark as deprecated if all overloads are deprecated
-      s.length === 1 || s.every((c) => c.deprecated !== void 0) ? r.deprecated : void 0
-    ), k = !v && m === void 0 && a ? !0 : void 0;
+      n.length === 1 || n.every((c) => c.deprecated !== void 0) ? s.deprecated : void 0
+    ), k = !v && m === void 0 && o ? !0 : void 0;
     if (g || k) {
-      n.push({
-        kind: r.kind,
-        name: r.name,
+      i.push({
+        kind: s.kind,
+        name: s.name,
         tagName: d,
         members: void 0,
         removed: g,
@@ -141,10 +141,10 @@ function y(i, o, a) {
         deprecated: v
       });
       continue;
-    } else if (!a)
+    } else if (!o)
       continue;
     if (d !== void 0) {
-      const c = r, u = m?.[0], f = {
+      const c = s, u = m?.[0], f = {
         kind: c.kind,
         name: c.name,
         tagName: c.tagName,
@@ -158,108 +158,103 @@ function y(i, o, a) {
         cssProperties: p(u?.cssProperties, c.cssProperties),
         cssStates: p(u?.cssStates, c.cssStates)
       };
-      (v !== void 0 || f.members !== void 0 || f.events !== void 0 || f.slots !== void 0 || f.cssParts !== void 0 || f.cssProperties !== void 0 || f.cssStates !== void 0) && n.push(f);
-    } else if (r.kind === "class" || r.kind === "interface" || r.kind === "mixin") {
+      (v !== void 0 || f.members !== void 0 || f.events !== void 0 || f.slots !== void 0 || f.cssParts !== void 0 || f.cssProperties !== void 0 || f.cssStates !== void 0) && i.push(f);
+    } else if (s.kind === "class" || s.kind === "interface" || s.kind === "mixin") {
       const c = m?.[0], u = {
-        kind: r.kind,
-        name: r.name,
+        kind: s.kind,
+        name: s.name,
         deprecated: v,
         added: void 0,
         removed: void 0,
-        members: M(c?.members, r.members),
-        events: "events" in r ? p(c?.events, r.events) : void 0
+        members: M(c?.members, s.members),
+        events: "events" in s ? p(c?.events, s.events) : void 0
       };
-      (v !== void 0 || u.members !== void 0 || u.events !== void 0) && n.push(u);
-    } else v !== void 0 && n.push({
-      kind: r.kind,
-      name: r.name,
+      (v !== void 0 || u.members !== void 0 || u.events !== void 0) && i.push(u);
+    } else v !== void 0 && i.push({
+      kind: s.kind,
+      name: s.name,
       deprecated: v,
       added: void 0,
       removed: void 0
     });
   }
-  if (a)
-    for (const [s] of e.values())
-      n.push({
-        kind: s.kind,
-        name: s.name,
-        tagName: s.tagName,
+  if (o)
+    for (const [n] of t.values())
+      i.push({
+        kind: n.kind,
+        name: n.name,
+        tagName: n.tagName,
         members: void 0,
         removed: !0,
         added: void 0,
-        deprecated: s.deprecated
+        deprecated: n.deprecated
       });
-  if (n.length !== 0)
+  if (i.length !== 0)
     return {
-      path: o.path,
-      declarations: n
+      path: a.path,
+      declarations: i
     };
 }
-function h(i) {
-  const o = /* @__PURE__ */ new Map();
-  for (let a = 0; a < i.length; ++a) {
-    const n = i[a], e = n.tagName ?? n.name ?? n.kind, t = o.get(e);
-    P(n.docsTags) || (t === void 0 ? o.set(e, [n]) : t.push(n));
+function h(r) {
+  const a = /* @__PURE__ */ new Map();
+  for (let o = 0; o < r.length; ++o) {
+    const i = r[o], t = i.tagName ?? i.name ?? i.kind, e = a.get(t);
+    P(i.docsTags) || (e === void 0 ? a.set(t, [i]) : e.push(i));
   }
-  return o;
+  return a;
 }
-function P(i) {
-  if (i !== void 0) {
-    for (let o = 0; o < i.length; ++o)
-      if (i[o].name === "internal")
+function P(r) {
+  if (r !== void 0) {
+    for (let a = 0; a < r.length; ++a)
+      if (r[a].name === "internal")
         return !0;
   }
   return !1;
 }
-function p(i, o) {
-  const a = h(i ?? []), n = [];
-  if (o !== void 0)
-    for (const e of o)
-      a.get(e.name) === void 0 ? n.push({
-        name: e.name,
-        added: !0
-      }) : e.deprecated && n.push({
-        name: e.name,
-        deprecated: e.deprecated
-      }), a.delete(e.name);
-  for (const [e] of a.values())
-    n.push({
+function p(r, a) {
+  const o = h(r ?? []), i = h(a ?? []), t = [];
+  for (const [e, n] of i) {
+    const s = n.at(-1), d = o.get(e)?.at(-1);
+    o.delete(e), d === void 0 ? t.push({ name: e, added: !0 }) : s.deprecated && t.push({ name: e, deprecated: s.deprecated });
+  }
+  for (const [e] of o.values())
+    t.push({
       name: e.name,
       removed: !0,
       deprecated: e.deprecated
     });
-  return n.length ? n : void 0;
+  return t.length ? t : void 0;
 }
-function M(i, o) {
-  const a = h(i ?? []), n = h(o ?? []), e = [];
-  for (const [t, s] of n.entries()) {
-    const r = s.at(-1), d = a.get(t);
-    a.delete(t);
+function M(r, a) {
+  const o = h(r ?? []), i = h(a ?? []), t = [];
+  for (const [e, n] of i.entries()) {
+    const s = n.at(-1), d = o.get(e);
+    o.delete(e);
     const l = (
       // Only mark as deprecated if all overloads are deprecated
-      s.length === 1 || s.every((g) => g.deprecated !== void 0) ? r.deprecated : void 0
-    ), m = t === "constructor" || t === "call-signature" ? void 0 : t;
-    l ? e.push({
-      kind: r.kind,
+      n.length === 1 || n.every((g) => g.deprecated !== void 0) ? s.deprecated : void 0
+    ), m = e === "constructor" || e === "call-signature" ? void 0 : e;
+    l ? t.push({
+      kind: s.kind,
       name: m,
       deprecated: l
-    }) : d === void 0 && e.push({
-      kind: r.kind,
+    }) : d === void 0 && t.push({
+      kind: s.kind,
       name: m,
       added: !0
     });
   }
-  for (const [t, [s]] of a.entries()) {
-    const r = t === "constructor" || t === "call-signature" ? void 0 : t;
-    e.push({
-      kind: s.kind,
-      name: r,
+  for (const [e, [n]] of o.entries()) {
+    const s = e === "constructor" || e === "call-signature" ? void 0 : e;
+    t.push({
+      kind: n.kind,
+      name: s,
       removed: !0,
-      deprecated: s.deprecated
+      deprecated: n.deprecated
     });
   }
-  return e.length ? e : void 0;
+  return t.length ? t : void 0;
 }
 export {
-  N as diffApiJson
+  I as diffApiJson
 };

package/dist/extractor/ApiExtractor.d.ts

@@ -58,9 +58,12 @@ export class ApiExtractor {
   run(): Promise<ApiExtractorResult>;
   /**
    * The high-level API for starting a watch-mode extraction on the current project.
+   *
    * When watching, double check that the configuration options the ApiExtractor
    * was created with are appropriate for watch mode (disable full type check
    * and type verifier if not necessary).
+   *
+   * Use [ApiExtractorConfig](https://developers.arcgis.com/javascript/latest/references/api-extractor/extractor/config/#ApiExtractorConfig-watch) to configure the watch callback to receive a reference to the api.json each time it is re-generated.
    */
   watch(): Promise<ApiExtractorWatcher>;
 }

package/dist/extractor/ApiExtractor.js

@@ -1,9 +1,8 @@
-import "../typeScript-D3TNAYYk.js";
-import "./config.js";
+import "../config-D0cgQ7jF.js";
 import "./processing/links.js";
 import "typescript";
-import { A as x } from "../ApiExtractor-cixc5HhK.js";
+import { A as a } from "../ApiExtractor-C2CJZrBq.js";
 import "@arcgis/toolkit/function";
 export {
-  x as ApiExtractor
+  a as ApiExtractor
 };