@arcgis/api-extractor 5.2.0-next.124 → 5.2.0-next.126

package/dist/{cli-7PX_wNxb.js → chunks/cli.js}

@@ -1,5 +1,5 @@
 import { writeFile as r, readFile as d } from "node:fs/promises";
-import { diffApiJson as m } from "./diff/diffApiJson.js";
+import { diffApiJson as m } from "../diff/diffApiJson.js";
 async function k({
   oldPath: t,
   newPath: i,
@@ -9,12 +9,12 @@ async function k({
   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);
+      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);
+    const { apiDiffToMarkdown: s } = await import("../diff/apiDiffToMarkdown.js"), a = s(n, e);
     console.log(a);
   }
 }

package/dist/{config-C9uAPo7G.js → chunks/config.js}

@@ -4,18 +4,18 @@ 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 = "1.0.0-0", A = {
-  name: w,
-  version: L
-}, T = "developers.arcgis.com", k = "next.gha.afd.arcgis.com";
+import { g as J } from "./links.js";
+const L = "@arcgis/api-extractor", w = "1.0.0-0", A = {
+  name: L,
+  version: w
+}, C = "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);
+  const t = e.context, n = e.types, o = 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) : {
+  const m = "customElements" in s && "@arcgis/lumina" in (s.dependencies ?? {}), p = n?.typeCheckedExtraction ?? m, l = n?.fullTypeCheck ?? !1, a = n?.typeScriptConfig ?? (p || l ? b(r, n?.typeScriptConfigPath, !0) : {
     configPath: "",
     config: {
       options: {},
@@ -23,7 +23,7 @@ function N(e) {
       errors: []
     }
   });
-  if (o?.typeScriptConfig?.config.fileNames.length === 0)
+  if (n?.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.`
     );
@@ -32,12 +32,12 @@ function N(e) {
       ...a.config,
       options: {
         ...a.config.options,
-        ...o?.compilerOptions
+        ...n?.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))
+  }, 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 = o?.omitInternal ?? !1, T = n?.forceProduceDts ?? !1;
+  if (D && (x || T))
     throw Error(
       "omitInternal must be false if emitting .d.ts files in order to produce functional types for internal APIs."
     );
@@ -64,31 +64,32 @@ function N(e) {
       supportApplyMixinsSyntax: t?.supportApplyMixinsSyntax ?? !1
     },
     types: {
-      typeCheckedExtraction: l,
-      fullTypeCheck: p,
-      afterDiagnostic: o?.afterDiagnostic ?? d,
-      typeScriptInstanceCreated: o?.typeScriptInstanceCreated ?? d,
+      typeCheckedExtraction: p,
+      fullTypeCheck: l,
+      afterDiagnostic: n?.afterDiagnostic ?? d,
+      typeScriptInstanceCreated: n?.typeScriptInstanceCreated ?? d,
       typeScriptConfigPath: a.configPath,
       typeScriptConfig: h,
       compilerOptions: h.config.options,
-      declarationTextTransformers: o?.declarationTextTransformers ?? [],
-      typeReplacements: o?.typeReplacements ?? {},
-      forceProduceDts: C
+      declarationTextTransformers: n?.declarationTextTransformers ?? [],
+      typeReplacements: n?.typeReplacements ?? {},
+      forceProduceDts: T
     },
     documentation: {
-      copyDocDefinitions: n?.copyDocDefinitions ?? {},
-      noInheritMembers: n?.noInheritMembers ?? {},
+      copyDocDefinitions: o?.copyDocDefinitions ?? {},
+      noInheritMembers: o?.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))
+      publicStoryUrlPrefix: o?.publicStoryUrlPrefix ?? !1,
+      getComponentDocsUrl: o?.getComponentDocsUrl ?? !1,
+      getComponentDemoUrl: o?.getComponentDemoUrl ?? !1,
+      host: o?.host ?? (u ? k : C),
+      alternativeHost: o?.alternativeHost ?? (u ? C : k),
+      basePath: o?.basePath ?? J(s.name.split("/").at(-1))
     },
     verify: {
       typeCheckTypes: e.verify?.typeCheckTypes ?? !1,
       filterTypeCheckDiagnostic: e.verify?.filterTypeCheckDiagnostic ?? (() => !0),
+      filterUnreferencedType: e.verify?.filterUnreferencedType ?? (() => !0),
       detectBrokenLinks: e.verify?.detectBrokenLinks ?? !0
     },
     watch: {
@@ -97,7 +98,7 @@ function N(e) {
       // 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),
+      debounceTime: e.watch?.debounceTime ?? (p || l ? 50 : 20),
       clearScreen: e.watch?.clearScreen ?? !1,
       skipWritingUnchanged: v ? !1 : e.watch?.skipWritingUnchanged ?? !0
     },
@@ -106,8 +107,8 @@ function N(e) {
   };
 }
 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)
+  const n = t !== void 0, o = e ?? process.cwd(), i = y.resolve(o, t ?? "api-extractor.config.ts"), r = await S(i);
+  if (n && !r)
     throw Error(`The provided config file at ${i} does not exist.`);
   if (!r)
     return e === void 0 ? {} : { context: { cwd: e } };
@@ -121,22 +122,22 @@ async function V(e, t) {
   };
 }
 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;
+  const n = e.context, o = t.context, i = e.types, r = t.types, s = e.documentation, c = t.documentation, m = e.verify, p = t.verify, l = 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
+      dtsEmitPath: o?.dtsEmitPath ?? n?.dtsEmitPath,
+      emptyDtsEmitPath: o?.emptyDtsEmitPath ?? n?.emptyDtsEmitPath,
+      apiJsonEmitPath: o?.apiJsonEmitPath ?? n?.apiJsonEmitPath,
+      environment: o?.environment ?? n?.environment,
+      cwd: o?.cwd ?? n?.cwd,
+      basePath: o?.basePath ?? n?.basePath,
+      packageJson: o?.packageJson ?? n?.packageJson,
+      logger: o?.logger ?? n?.logger,
+      excludedDirectories: o?.excludedDirectories ?? n?.excludedDirectories,
+      isLuminaMinimalExtraction: o?.isLuminaMinimalExtraction ?? n?.isLuminaMinimalExtraction,
+      includeLuminaPrivateComponents: o?.includeLuminaPrivateComponents ?? n?.includeLuminaPrivateComponents,
+      supportApplyMixinsSyntax: o?.supportApplyMixinsSyntax ?? n?.supportApplyMixinsSyntax ?? !1
     },
     types: {
       typeCheckedExtraction: r?.typeCheckedExtraction ?? i?.typeCheckedExtraction,
@@ -165,23 +166,24 @@ function j(e, t) {
       basePath: c?.basePath ?? s?.basePath
     },
     verify: {
-      typeCheckTypes: l?.typeCheckTypes ?? m?.typeCheckTypes,
-      filterTypeCheckDiagnostic: l?.filterTypeCheckDiagnostic ?? m?.filterTypeCheckDiagnostic,
-      detectBrokenLinks: l?.detectBrokenLinks ?? m?.detectBrokenLinks
+      typeCheckTypes: p?.typeCheckTypes ?? m?.typeCheckTypes,
+      filterTypeCheckDiagnostic: p?.filterTypeCheckDiagnostic ?? m?.filterTypeCheckDiagnostic,
+      filterUnreferencedType: p?.filterUnreferencedType ?? m?.filterUnreferencedType,
+      detectBrokenLinks: p?.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
+      onUpdate: f(a?.onUpdate, l?.onUpdate),
+      debounceTime: a?.debounceTime ?? l?.debounceTime,
+      clearScreen: a?.clearScreen ?? l?.clearScreen,
+      skipWritingUnchanged: a?.skipWritingUnchanged ?? l?.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;
+  const n = t === d ? void 0 : t, o = e === d ? void 0 : e;
+  return n !== void 0 && o !== void 0 ? ((...i) => (n(...i), o(...i))) : o ?? n;
 }
 export {
   V as l,

package/dist/chunks/links.js

@@ -0,0 +1,412 @@
+import { styleText as D } from "node:util";
+import { emitJsDocError as g, getApiNodeLabel as T } from "../utils/apiHelpers.js";
+import { b as A, e as W, d as S, g as L } from "./privateContext.js";
+import { kebabToPascal as M } from "@arcgis/toolkit/string";
+import R from "typescript";
+function q(e, i, n) {
+  return N(e, i, n) ?? void 0;
+}
+function z(e, i, n, t) {
+  const s = N(e, i, n);
+  return s === void 0 ? t : s ?? void 0;
+}
+function N(e, i, n) {
+  const t = R.getLeadingCommentRanges(n.file.text, e.pos);
+  if (t === void 0)
+    return;
+  let s;
+  for (const l of t) {
+    const d = n.file.text.slice(l.pos, l.end);
+    d.startsWith("/**") && (s !== void 0 && n.config.strict && n.emitError(
+      `Found multiple JSDoc comments for the same node. This is not allowed.
+If one of these was meant to be a file-level comment, read the documentation: https://webgis.esri.com/references/api-extractor/api-node-kinds#module-level-documentation
+If this is meant to be a function overload, read the documentation: https://webgis.esri.com/references/api-extractor/api-node-kinds#function-overloads`,
+      {
+        file: n.file,
+        node: e
+      }
+    ), s = d);
+  }
+  if (s === void 0)
+    return;
+  const o = n.config.documentation.omitInternal;
+  return J(s, i, o, n);
+}
+function J(e, i, n, t) {
+  if (i && !e.includes("* @public") && (n || !e.includes("* @internal")))
+    return null;
+  const s = e.length - 2;
+  let o = 3, l = "";
+  const d = [];
+  let r, k, h = !1;
+  for (; o < s; ) {
+    let v = e.indexOf(`
+`, o);
+    v === -1 && (v = s);
+    let f = e.slice(o, v).trim();
+    if (o = v + 1, f === "*" ? f = "" : f.startsWith("*") && (f[1] === " " ? f = f.slice(2) : t.config.strict ? t.emitError(
+      `For consistency, include a space character after '*' in JSDoc. Did not find it in "${e}"`,
+      {
+        file: t.file,
+        node: void 0
+      }
+    ) : f = f.slice(1)), f.startsWith("@")) {
+      r !== void 0 && !h && d.push(
+        y[r] ?? {
+          name: r,
+          text: k.trim().replaceAll("\\@", "@") || void 0
+        }
+      );
+      const b = f.indexOf(" "), c = b === -1 ? f.slice(1) : f.slice(1, b);
+      if (c === "internal") {
+        if (n)
+          return null;
+        i = !1;
+      } else c === "public" ? (i = !1, h = !0) : h = c === "privateRemarks";
+      const a = b === -1 ? "" : f.slice(b + 1);
+      r = c, k = a;
+    } else r !== void 0 ? k = `${k}
+${f}` : l += `${f}
+`;
+  }
+  return i ? null : (r !== void 0 && !h && d.push(
+    y[r] ?? {
+      name: r,
+      text: k.trim().replaceAll("\\@", "@") || void 0
+    }
+  ), {
+    description: l.trim().replaceAll("\\@", "@") || void 0,
+    docsTags: d
+  });
+}
+function G(e, i) {
+  for (let n = 0; n < i.docsTags.length; ++n) {
+    const t = i.docsTags[n], { name: s, text: o } = t;
+    s === "deprecated" ? e.deprecated = o || !0 : (e.docsTags ??= [], e.docsTags.push(t));
+  }
+  e.description = i.description;
+}
+function K(e, i) {
+  for (let n = 0; n < i.docsTags.length; ++n) {
+    const t = i.docsTags[n], { name: s, text: o } = t;
+    if (s === "deprecated")
+      e.deprecated = o || !0;
+    else if (t === y.private)
+      e.privacy = "private";
+    else if (s === "csspart")
+      e.cssParts ??= [], e.cssParts.push(w(o));
+    else if (s === "cssstate")
+      e.cssStates ??= [], e.cssStates.push(w(o));
+    else if (s === "slot")
+      e.slots ??= [], e.slots.push(w(o));
+    else if (s === "esriCompatibilityName") {
+      const l = A(e);
+      l.esriCompatibilityNames ??= [], l.esriCompatibilityNames.push(o ?? "");
+    } else s === "readonly" || (e.docsTags ??= [], e.docsTags.push(t));
+  }
+  e.description = i.description;
+}
+function Q(e, i) {
+  const n = e, t = [];
+  for (let s = 0; s < i.docsTags.length; ++s) {
+    const o = i.docsTags[s], { name: l, text: d } = o;
+    if (l === "deprecated")
+      e.deprecated = d || !0;
+    else if (o === y.private)
+      e.privacy = "private";
+    else if (l === "param")
+      t.push(o);
+    else if (l === "returns")
+      n.return.description = o.text;
+    else if (l === "esriCompatibilityName") {
+      const r = S(e);
+      r.esriCompatibilityNames ??= [], r.esriCompatibilityNames.push(d ?? "");
+    } else
+      e.docsTags ??= [], e.docsTags.push(o);
+  }
+  return e.description = i.description, t;
+}
+function X(e, i) {
+  for (let n = 0; n < i.docsTags.length; ++n) {
+    const t = i.docsTags[n], { name: s, text: o } = t;
+    s === "deprecated" ? e.deprecated = o || !0 : s === "default" ? e.default = o : t === y.readonly ? e.readonly = !0 : t === y.private ? e.privacy = "private" : (e.docsTags ??= [], e.docsTags.push(t));
+  }
+  e.description = i.description;
+}
+function Y(e, i) {
+  for (let n = 0; n < i.docsTags.length; ++n) {
+    const t = i.docsTags[n], { name: s, text: o } = t;
+    if (s === "deprecated")
+      e.deprecated = o || !0;
+    else if (s === "default")
+      e.default = o;
+    else if (s !== "readonly") if (s === "esriCompatibilityName") {
+      const l = W(e);
+      l.esriCompatibilityNames ??= [], l.esriCompatibilityNames.push(o ?? "");
+    } else
+      e.docsTags ??= [], e.docsTags.push(t);
+  }
+  e.description = i.description;
+}
+function Z(e, i) {
+  for (let n = 0; n < i.docsTags.length; ++n) {
+    const t = i.docsTags[n], { name: s, text: o } = t;
+    s === "deprecated" ? e.deprecated = o || !0 : t === y.private ? e.privacy = "private" : (e.docsTags ??= [], e.docsTags.push(t));
+  }
+  e.description = i.description;
+}
+function w(e) {
+  if (e === void 0)
+    return {
+      name: "",
+      deprecated: void 0,
+      summary: void 0,
+      description: void 0,
+      docsTags: void 0,
+      type: void 0,
+      syntax: void 0,
+      default: void 0
+    };
+  const i = e.indexOf(" - ");
+  if (i === -1)
+    return e.startsWith("- ") ? {
+      name: "",
+      deprecated: void 0,
+      summary: void 0,
+      description: e.slice(2),
+      docsTags: void 0,
+      type: void 0,
+      syntax: void 0,
+      default: void 0
+    } : {
+      name: e,
+      deprecated: void 0,
+      summary: void 0,
+      description: void 0,
+      docsTags: void 0,
+      type: void 0,
+      syntax: void 0,
+      default: void 0
+    };
+  let n, t = e.slice(0, i);
+  if (t.startsWith("[") && t.endsWith("]")) {
+    const o = t.slice(1, -1), l = o.indexOf("=");
+    t = o.slice(0, l), n = o.slice(l + 1);
+  }
+  const s = e.slice(i + 3);
+  return {
+    name: t,
+    deprecated: void 0,
+    summary: void 0,
+    description: s,
+    docsTags: void 0,
+    type: void 0,
+    syntax: void 0,
+    default: n
+  };
+}
+const y = {
+  // Create a null prototype object to avoid collisions with Object.prototype when doing lookups
+  // eslint-disable-next-line @typescript-eslint/naming-convention
+  __proto__: null,
+  internal: { name: "internal", text: void 0 },
+  private: { name: "private", text: void 0 },
+  copyDoc: { name: "copyDoc", text: void 0 },
+  beta: { name: "beta", text: void 0 },
+  experimental: { name: "experimental", text: void 0 },
+  readonly: { name: "readonly", text: void 0 },
+  required: { name: "required", text: void 0 }
+}, ee = {
+  description: void 0,
+  docsTags: []
+}, ie = {
+  description: void 0,
+  docsTags: [y.private]
+};
+function ne(e, i) {
+  if (typeof e == "string") {
+    const n = e.replaceAll(F, i.resolveJsDocLink).replaceAll(i.config.documentation.alternativeHost, i.config.documentation.host);
+    return e.includes("](.") && g(I, e, i), n;
+  }
+  return e;
+}
+function te(e, i) {
+  if (e) {
+    const n = e.replaceAll(F, i.resolveJsDocLink).replaceAll(i.config.documentation.alternativeHost, i.config.documentation.host);
+    return n.includes("](.") && g(I, n, i), n;
+  }
+  return e;
+}
+function se(e, i) {
+  if (e !== void 0 && i.inheritedModuleName === void 0)
+    for (let n = 0; n < e.length; ++n) {
+      const t = e[n];
+      t.text && (t.text = t.text.replaceAll(F, i.resolveJsDocLink).replaceAll(i.config.documentation.alternativeHost, i.config.documentation.host), t.text.includes("](.") && g(I, t.text, i));
+    }
+}
+const I = "Unexpected relative markdown link. For links to API within the package use {@link}. For all other links, use absolute markdown. Documentation: https://webgis.esri.com/references/api-extractor/tags-reference#link)", F = /\{@link +([^}]+)\}/gu;
+function oe(e, i, n) {
+  let t = n.indexOf(" ");
+  t === -1 && (t = n.length);
+  const s = n.slice(0, t);
+  let o = n.slice(t + 1);
+  if (s.startsWith("https://"))
+    return e.config.strict ? (g(
+      "Did not expect absolute URLs in a @link tag. Please use markdown links for external links. See https://webgis.esri.com/references/api-extractor/tags-reference#link)",
+      i,
+      e
+    ), "") : `[${o || s}](${s})`;
+  const [l, d] = s.split("#"), [r, k] = l.split("!");
+  if (r === "")
+    return g(
+      `Expected @link reference to start with a module name (before ! or #), but got: ${s}`,
+      i,
+      e
+    ), i;
+  let h = e.moduleMap.get(r);
+  if (h === void 0 && e.isComponentProject && !e.config.strict) {
+    for (const c of e.moduleMap.values())
+      if (L(c).index.class?.name === r) {
+        h = c;
+        break;
+      }
+  }
+  if (h === void 0)
+    return e.config.verify.detectBrokenLinks ? g(
+      `Failed to find referenced module: ${D("red", r)}${r.startsWith("module:") ? '. Module name in @link does not need the "module:" prefix' : r.startsWith("esri/") ? '. Module name in @link does not need to start with the "esri/" prefix.' : ""}`,
+      i,
+      e
+    ) : e.silencedBrokenLinkCount += 1, i;
+  const v = L(h), f = e.inheritedModuleName === void 0 ? e.apiModule : e.moduleMap.get(e.inheritedModuleName) ?? e.apiModule;
+  if (e.watchFiles !== void 0 && r !== f.path && L(f).isStale) {
+    const c = L(f).file.fileName.slice(e.config.context.cwd.length), a = v.file.fileName.slice(e.config.context.cwd.length);
+    e.watchFiles.get(c).docLinks.push(n), e.watchFiles.get(c).dependencies.add(a);
+    const $ = e.watchFiles.get(a).dependents;
+    $.has(c) || $.set(c, !1);
+  }
+  let b = O(h.path, k, d, e);
+  if (k !== void 0) {
+    const c = v.index.named[k];
+    return c === void 0 ? (e.config.verify.detectBrokenLinks ? g(
+      `Failed to find the referenced declaration inside the module: ${D("red", `${r}!${k}`)}`,
+      i,
+      e
+    ) : e.silencedBrokenLinkCount += 1, i) : c === v.index.class ? (g(
+      `Invalid reference syntax used. Class/mixin/custom element declarations must be referenced without specifying the class name. Expected ${D("green", r)}`,
+      i,
+      e
+    ), i) : (P(e, i, c), `[${o || T(c)}](${b})`);
+  } else if (d !== void 0) {
+    const c = h.path === f.path, a = v.index.class;
+    if (a === void 0)
+      return v.index.named[d] === void 0 ? e.config.verify.detectBrokenLinks ? g(
+        'Failed to find the referenced member. Class member reference syntax was used, yet current module does not expose a class/mixin/custom element? Linking to properties in interfaces is not yet supported. For event links, prefix with "event-"',
+        i,
+        e
+      ) : e.silencedBrokenLinkCount += 1 : g(
+        `Invalid reference syntax used. This syntax is only permitted on modules that export a class/mixin/web component. Perhaps you meant to use ${D("red", `${r}!${d}`)} instead? Linking to properties in interfaces is not yet supported`,
+        i,
+        e
+      ), i;
+    const $ = v.inheritance, x = typeof $ == "object" ? $ : void 0;
+    let m;
+    if (d.startsWith("event-")) {
+      const u = d.slice(6);
+      if (x !== void 0)
+        m = x.indexedEvents?.[u];
+      else if (a.events !== void 0)
+        for (let p = 0; p < a.events.length; ++p) {
+          const C = a.events[p];
+          if (u === C.name) {
+            m = C;
+            break;
+          }
+        }
+    } else if (d.startsWith("slot-")) {
+      const u = d.slice(5);
+      if (x !== void 0)
+        m = x.indexedSlots?.[u];
+      else if (a.slots !== void 0)
+        for (let p = 0; p < a.slots.length; ++p) {
+          const C = a.slots[p];
+          if (u === C.name) {
+            m = C;
+            break;
+          }
+        }
+      m?.name === "" && (o ||= `${T(a)}.default-slot`);
+    } else if (d.startsWith("--")) {
+      if (x !== void 0)
+        m = x.indexedCssProperties?.[d];
+      else if (a.cssProperties !== void 0)
+        for (let u = 0; u < a.cssProperties.length; ++u) {
+          const p = a.cssProperties[u];
+          if (d === p.name) {
+            m = p;
+            break;
+          }
+        }
+    } else if (x?.indexedMembers !== void 0 && (m = x.indexedMembers[d] ?? x.indexedMembers[`static ${d}`]), m === void 0 && a.members !== void 0) {
+      for (let u = 0; u < a.members.length; ++u) {
+        const p = a.members[u];
+        if (d === p.name) {
+          m = p;
+          break;
+        }
+      }
+      if (m === void 0 && !e.config.strict && e.isComponentProject && a.events !== void 0)
+        for (let u = 0; u < a.events.length; ++u) {
+          const p = a.events[u];
+          if (d === p.name) {
+            m = p, b = b.replace("#", "#event-");
+            break;
+          }
+        }
+    }
+    return m === void 0 ? (e.config.verify.detectBrokenLinks ? g("Failed to find the referenced class member", i, e) : e.silencedBrokenLinkCount += 1, i) : (P(e, i, m), `[${o || (c ? T(m) : `${T(a)}.${T(m)}`)}](${b})`);
+  } else {
+    P(e, i, v.index.class);
+    const c = v.index.class === void 0 ? B(r) : T(v.index.class);
+    return `[${o || c}](${b})`;
+  }
+}
+function O(e, i, n, t) {
+  let s;
+  if (t.isComponentProject && typeof t.config.documentation.getComponentDocsUrl == "function" && e.startsWith("components/")) {
+    const o = e.slice(11), l = o.indexOf("/"), d = l === -1 ? o : o.slice(0, l), r = t.config.documentation.getComponentDocsUrl(d, M(d));
+    r !== void 0 && (s = r + (l === -1 ? "" : o.slice(l + 1)));
+  }
+  return s ??= `${t.normalizedApiReferencePrefix}${e}/`, U(s, i, n);
+}
+function U(e, i, n) {
+  return i !== void 0 ? n === void 0 ? `${e}#${encodeURIComponent(i)}` : `${e}#${encodeURIComponent(i)}-${encodeURIComponent(n)}` : n !== void 0 ? `${e}#${encodeURIComponent(n)}` : e;
+}
+function B(e) {
+  const i = e.lastIndexOf("/");
+  return i === -1 ? e : e.slice(i + 1);
+}
+const de = (e) => `/javascript/latest/references/${e}/`;
+function P(e, i, n) {
+  const t = e.typeVerifier?.linkSource;
+  t === void 0 || n?.docsTags?.includes(y.internal) !== !0 || t.docsTags?.includes(y.internal) !== !0 && g("@public API must not link to @internal API - leads to 404 in public doc", i, e);
+}
+export {
+  O as a,
+  U as b,
+  q as c,
+  Z as d,
+  Q as e,
+  X as f,
+  de as g,
+  K as h,
+  z as i,
+  ee as j,
+  Y as k,
+  y as l,
+  G as m,
+  ne as n,
+  te as o,
+  ie as p,
+  se as q,
+  oe as r
+};

package/dist/{privateContext-DR6YTcm2.js → chunks/privateContext.js}

@@ -73,13 +73,13 @@ function l(t) {
   return t[e];
 }
 export {
-  f as a,
-  C as b,
-  v as c,
-  u as d,
-  s as e,
+  s as a,
+  x as b,
+  u as c,
+  C as d,
+  f as e,
   l as f,
-  x as g,
+  v as g,
   p as h,
   c as i,
   a as j,

package/dist/cli.js

@@ -36,7 +36,7 @@ o.command("diff").description("Produce a diff of two api.json files").requiredOp
   "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");
+  const { diffApiCli: e } = await import("./chunks/cli.js");
   await e({
     oldPath: t.old,
     newPath: t.new,

package/dist/diff/apiDiffToMarkdown.js

@@ -1,4 +1,4 @@
-import { buildViewUrl as T } from "../extractor/processing/links.js";
+import { b as T } from "../chunks/links.js";
 function K({ modules: e }, t) {
   const o = {
     children: /* @__PURE__ */ new Map(),

package/dist/extractor/ApiExtractor.js

@@ -1,7 +1,7 @@
-import "../config-C9uAPo7G.js";
-import "./processing/links.js";
+import "../chunks/config.js";
+import "../chunks/links.js";
 import "typescript";
-import { A as x } from "../ApiExtractor-CvENLVIq.js";
+import { A as x } from "../chunks/ApiExtractor.js";
 import "@arcgis/toolkit/function";
 import "@arcgis/node-toolkit/workspace";
 export {