@arcgis/api-extractor 5.1.0-next.99 → 5.2.0-next.1

package/dist/apiJson.d.ts

@@ -6,6 +6,14 @@
  * @see https://custom-elements-manifest.open-wc.org/analyzer/getting-started/
  */
 export interface ApiJson {
+  /**
+   * The name of the package this api.json describes.
+   *
+   * > Not present in vanilla custom-elements-manifest.
+   *
+   * @example "@arcgis/map-components"
+   */
+  name: string;
   /**
    * The timestamp at which the api.json was generated, in the format
    * `YYYY-MM-DDThh:mm:ss`.

package/dist/extractor/ApiExtractor.js

@@ -1,8 +1,8 @@
-import "../typeScript-BJ98xoUG.js";
-import "../worker-BKOEQXzG.js";
+import "../typeScript-Bi6LkUmP.js";
+import "../worker-C9agsAIe.js";
 import "./processing/links.js";
 import "typescript";
-import { A as x } from "../ApiExtractor-CYe0v4qU.js";
+import { A as x } from "../ApiExtractor-CZfBqER_.js";
 import "@arcgis/toolkit/function";
 export {
   x as ApiExtractor

package/dist/extractor/config.js

@@ -1,6 +1,6 @@
 import "@arcgis/components-build-utils";
-import "../typeScript-BJ98xoUG.js";
-import { l, m as n, r as A } from "../worker-BKOEQXzG.js";
+import "../typeScript-Bi6LkUmP.js";
+import { l, m as n, r as A } from "../worker-C9agsAIe.js";
 import "./processing/links.js";
 import "typescript";
 import "fs/promises";

package/dist/extractor/extractors/copyDoc.d.ts

@@ -1,6 +1,6 @@
 import type { ApiClassDeclaration, ApiClassMethod, ApiCustomElementDeclaration, ApiCustomElementField, ApiEvent, ApiFunctionDeclaration, ApiInterfaceDeclaration, ApiModule, ApiVariableDeclaration } from "../../apiJson.js";
 
-/** [Documentation](https://webgis.esri.com/sdk/contributing/core/core/documenting-api#copydoc) */
+/** [Documentation](https://webgis.esri.com/references/api-extractor/tags-reference#copydoc)) */
 export interface CopyDocDefinitions {
   properties?: CopyDocMemberDeclarations<ApiCustomElementField>;
   methods?: CopyDocMemberDeclarations<ApiClassMethod>;

package/dist/extractor/processing/links.js

@@ -23,18 +23,18 @@ function J(e, n) {
       d.text && (d.text = d.text.replaceAll(F, n.resolveJsDocLink).replaceAll(n.config.documentation.alternativeHost, n.config.documentation.host), d.text.includes("](.") && a(P, d.text, n));
     }
 }
-const P = "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/sdk/contributing/core/core/documenting-api#link", F = /\{@link +([^}]+)\}/gu;
+const P = "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 N(e, n, i) {
   let d = i.indexOf(" ");
   d === -1 && (d = i.length);
   const u = i.slice(0, d), m = i.slice(d + 1);
   if (u.startsWith("https://"))
     return e.config.strict ? (a(
-      "Did not expect absolute URLs in a @link tag. Please use markdown links for external links. See https://webgis.esri.com/sdk/contributing/core/core/documenting-api#link",
+      "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)",
       n,
       e
     ), "") : `[${m || u}](${u})`;
-  const [k, s] = u.split("#"), [f, L] = k.split("!");
+  const [k, t] = u.split("#"), [f, L] = k.split("!");
   if (f === "")
     return a(
       `Expected @link reference to start with a module name (before ! or #), but got: ${u}`,
@@ -57,12 +57,12 @@ function N(e, n, i) {
     ) : e.silencedBrokenLinkCount += 1, n;
   const v = y(g), D = e.inheritedModuleName === void 0 ? e.apiModule : e.moduleMap.get(e.inheritedModuleName) ?? e.apiModule;
   if (e.watchFiles !== void 0 && f !== D.path && y(D).isStale) {
-    const r = y(D).file.fileName.slice(e.config.context.cwd.length), t = v.file.fileName.slice(e.config.context.cwd.length);
-    e.watchFiles.get(r).docLinks.push(i), e.watchFiles.get(r).dependencies.add(t);
-    const b = e.watchFiles.get(t).dependents;
+    const r = y(D).file.fileName.slice(e.config.context.cwd.length), s = v.file.fileName.slice(e.config.context.cwd.length);
+    e.watchFiles.get(r).docLinks.push(i), e.watchFiles.get(r).dependencies.add(s);
+    const b = e.watchFiles.get(s).dependents;
     b.has(r) || b.set(r, !1);
   }
-  let h = M(g.path, L, s, e);
+  let h = M(g.path, L, t, e);
   if (L !== void 0) {
     const r = v.index.named[L];
     return r === void 0 ? (e.config.verify.detectBrokenLinks ? a(
@@ -74,96 +74,96 @@ function N(e, n, i) {
       n,
       e
     ), n) : `[${m || w(r)}](${h})`;
-  } else if (s !== void 0) {
-    const r = g.path === D.path, t = v.index.class;
-    if (t === void 0)
-      return v.index.named[s] === void 0 ? e.config.verify.detectBrokenLinks ? a(
+  } else if (t !== void 0) {
+    const r = g.path === D.path, s = v.index.class;
+    if (s === void 0)
+      return v.index.named[t] === void 0 ? e.config.verify.detectBrokenLinks ? a(
         '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-"',
         n,
         e
       ) : e.silencedBrokenLinkCount += 1 : a(
-        `Invalid reference syntax used. This syntax is only permitted on modules that export a class/mixin/web component. Perhaps you meant to use ${C("red", `${f}!${s}`)} instead? Linking to properties in interfaces is not yet supported`,
+        `Invalid reference syntax used. This syntax is only permitted on modules that export a class/mixin/web component. Perhaps you meant to use ${C("red", `${f}!${t}`)} instead? Linking to properties in interfaces is not yet supported`,
         n,
         e
       ), n;
     const b = v.inheritance, p = typeof b == "object" ? b : void 0;
     let c;
-    if (s.startsWith("event-")) {
-      const o = s.slice(6);
+    if (t.startsWith("event-")) {
+      const o = t.slice(6);
       if (p !== void 0)
         c = p.indexedEvents?.[o];
-      else if (t.events !== void 0)
-        for (let l = 0; l < t.events.length; ++l) {
-          const $ = t.events[l];
+      else if (s.events !== void 0)
+        for (let l = 0; l < s.events.length; ++l) {
+          const $ = s.events[l];
           if (o === $.name) {
             c = $;
             break;
           }
         }
-    } else if (s.startsWith("slot-")) {
-      const o = s.slice(5);
+    } else if (t.startsWith("slot-")) {
+      const o = t.slice(5);
       if (p !== void 0)
         c = p.indexedSlots?.[o];
-      else if (t.slots !== void 0)
-        for (let l = 0; l < t.slots.length; ++l) {
-          const $ = t.slots[l];
+      else if (s.slots !== void 0)
+        for (let l = 0; l < s.slots.length; ++l) {
+          const $ = s.slots[l];
           if (o === $.name) {
             c = $;
             break;
           }
         }
-    } else if (s.startsWith("--")) {
+    } else if (t.startsWith("--")) {
       if (p !== void 0)
-        c = p.indexedCssProperties?.[s];
-      else if (t.cssProperties !== void 0)
-        for (let o = 0; o < t.cssProperties.length; ++o) {
-          const l = t.cssProperties[o];
-          if (s === l.name) {
+        c = p.indexedCssProperties?.[t];
+      else if (s.cssProperties !== void 0)
+        for (let o = 0; o < s.cssProperties.length; ++o) {
+          const l = s.cssProperties[o];
+          if (t === l.name) {
             c = l;
             break;
           }
         }
-    } else if (p?.indexedMembers !== void 0 && (c = p.indexedMembers[s] ?? p.indexedMembers[`static ${s}`]), c === void 0 && t.members !== void 0) {
-      for (let o = 0; o < t.members.length; ++o) {
-        const l = t.members[o];
-        if (s === l.name) {
+    } else if (p?.indexedMembers !== void 0 && (c = p.indexedMembers[t] ?? p.indexedMembers[`static ${t}`]), c === void 0 && s.members !== void 0) {
+      for (let o = 0; o < s.members.length; ++o) {
+        const l = s.members[o];
+        if (t === l.name) {
           c = l;
           break;
         }
       }
-      if (c === void 0 && !e.config.strict && e.isComponentProject && t.events !== void 0)
-        for (let o = 0; o < t.events.length; ++o) {
-          const l = t.events[o];
-          if (s === l.name) {
+      if (c === void 0 && !e.config.strict && e.isComponentProject && s.events !== void 0)
+        for (let o = 0; o < s.events.length; ++o) {
+          const l = s.events[o];
+          if (t === l.name) {
             c = l, h = h.replace("#", "#event-");
             break;
           }
         }
     }
-    return c === void 0 ? (e.config.verify.detectBrokenLinks ? a("Failed to find the referenced class member", n, e) : e.silencedBrokenLinkCount += 1, n) : `[${m || (r ? w(c) : `${w(t)}.${w(c)}`)}](${h})`;
+    return c === void 0 ? (e.config.verify.detectBrokenLinks ? a("Failed to find the referenced class member", n, e) : e.silencedBrokenLinkCount += 1, n) : `[${m || (r ? w(c) : `${w(s)}.${w(c)}`)}](${h})`;
   } else {
-    const r = v.index.class === void 0 ? A(f) : w(v.index.class);
+    const r = v.index.class === void 0 ? U(f) : w(v.index.class);
     return `[${m || r}](${h})`;
   }
 }
 function M(e, n, i, d) {
   let u;
   if (d.isComponentProject && typeof d.config.documentation.getComponentDocsUrl == "function" && e.startsWith("components/")) {
-    const m = e.slice(11), k = m.indexOf("/"), s = k === -1 ? m : m.slice(0, k), f = d.config.documentation.getComponentDocsUrl(s, I(s));
+    const m = e.slice(11), k = m.indexOf("/"), t = k === -1 ? m : m.slice(0, k), f = d.config.documentation.getComponentDocsUrl(t, I(t));
     f !== void 0 && (u = f + (k === -1 ? "" : m.slice(k + 1)));
   }
-  return u ??= `${d.normalizedApiReferencePrefix}${e}/`, U(u, n, i);
+  return u ??= `${d.normalizedApiReferencePrefix}${e}/`, x(u, n, i);
 }
-function U(e, n, i) {
+function x(e, n, i) {
   return n !== void 0 ? i === void 0 ? `${e}#${encodeURIComponent(n)}` : `${e}#${encodeURIComponent(n)}-${encodeURIComponent(i)}` : i !== void 0 ? `${e}#${encodeURIComponent(i)}` : e;
 }
-function A(e) {
+function U(e) {
   const n = e.lastIndexOf("/");
   return n === -1 ? e : e.slice(n + 1);
 }
 const E = (e) => `/javascript/latest/references/${e}/`;
 export {
-  U as buildViewUrl,
+  x as buildViewUrl,
   E as getDefaultBasePath,
   M as getViewUrl,
   W as postProcessDeprecated,

package/dist/{typeScript-BJ98xoUG.js → typeScript-Bi6LkUmP.js}

@@ -1,7 +1,7 @@
 import { findPath as E, path as u, toSystemPathSeparators as S } from "@arcgis/components-build-utils";
 import t from "typescript";
 import { styleText as f } from "util";
-const w = "@arcgis/api-extractor", P = "5.1.0-next.99", D = {
+const w = "@arcgis/api-extractor", P = "5.2.0-next.1", D = {
   name: w,
   version: P
 };

package/dist/utils/inferEntrypoints.js

@@ -22,5 +22,6 @@ function i(n) {
   return !1;
 }
 export {
+  i as hasRuntimeDeclaration,
   o as inferEntrypoints
 };

package/dist/vite/plugin.js

@@ -1,6 +1,6 @@
-import { l as O, m as J } from "../worker-BKOEQXzG.js";
-import { A as S, w as T } from "../ApiExtractor-CYe0v4qU.js";
-import { p as A, l as C } from "../typeScript-BJ98xoUG.js";
+import { l as O, m as J } from "../worker-C9agsAIe.js";
+import { A as S, w as T } from "../ApiExtractor-CZfBqER_.js";
+import { p as A, l as C } from "../typeScript-Bi6LkUmP.js";
 import { writeFile as M } from "node:fs/promises";
 import { path as w } from "@arcgis/components-build-utils";
 const N = A.name;

package/dist/vite/typeScript.js

@@ -1,6 +1,6 @@
 import "@arcgis/components-build-utils";
 import "typescript";
-import { b as t } from "../typeScript-BJ98xoUG.js";
+import { b as t } from "../typeScript-Bi6LkUmP.js";
 export {
   t as loadTypeScriptConfig
 };