@arcgis/api-extractor 5.2.0-next.1 → 5.2.0-next.11

package/dist/apiJson.d.ts

@@ -451,7 +451,7 @@ export interface ApiWithInheritance {
   inheritedFrom?: ApiReference;
 }
 
-/** @see [MDN Slot](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/slot) */
+/** @see [MDN Slot](https://developer.mozilla.org/docs/Web/HTML/Element/slot) */
 export interface ApiSlot extends ApiWithDescription, ApiWithUnusedSummary {
   /**
    * The slot name, or the empty string for an unnamed slot.
@@ -474,7 +474,7 @@ export interface ApiSlot extends ApiWithDescription, ApiWithUnusedSummary {
 /**
  * The description of exposed CSS Parts
  *
- * @see https://developer.mozilla.org/en-US/docs/Web/CSS/CSS_shadow_parts
+ * @see https://developer.mozilla.org/docs/Web/CSS/CSS_shadow_parts
  */
 export interface ApiCssPart extends ApiWithDescription, ApiWithUnusedSummary {
   /** @example "tab" */
@@ -494,7 +494,7 @@ export interface ApiCssPart extends ApiWithDescription, ApiWithUnusedSummary {
 /**
  * The description of a CSS Custom State.
  *
- * @see https://developer.mozilla.org/en-US/docs/Web/API/CustomStateSet
+ * @see https://developer.mozilla.org/docs/Web/API/CustomStateSet
  */
 export interface ApiCssCustomState extends ApiWithDescription, ApiWithUnusedSummary {
   /**
@@ -527,7 +527,7 @@ export interface ApiCssCustomProperty extends ApiWithDescription, ApiWithUnusedS
    * The expected syntax of the defined property. Defaults to "*".
    *
    * The syntax must be a valid CSS
-   * [syntax string](https://developer.mozilla.org/en-US/docs/Web/CSS/@property/syntax)
+   * [syntax string](https://developer.mozilla.org/docs/Web/CSS/@property/syntax)
    * as defined in the CSS Properties and Values API.
    *
    * Examples:

package/dist/extractor/ApiExtractor.js

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

package/dist/extractor/config.js

@@ -1,17 +1,18 @@
 import "@arcgis/components-build-utils";
-import "../typeScript-Bi6LkUmP.js";
-import { l, m as n, r as A } from "../worker-C9agsAIe.js";
+import "../typeScript-rpB6x3rO.js";
+import { l as n, m as A, r as C } from "../worker-B9PXR8bT.js";
 import "./processing/links.js";
 import "typescript";
 import "fs/promises";
 import "node:util";
 import "@arcgis/toolkit/string";
 import "../utils/apiHelpers.js";
+import "@arcgis/toolkit/array";
 import "@arcgis/toolkit/function";
 import "node:fs";
 import "node:url";
 export {
-  l as loadApiExtractorConfig,
-  n as mergeApiExtractorConfigs,
-  A as resolveApiExtractorConfig
+  n as loadApiExtractorConfig,
+  A as mergeApiExtractorConfigs,
+  C as resolveApiExtractorConfig
 };

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

@@ -1,4 +1,4 @@
-import type { ApiClassDeclaration, ApiClassMethod, ApiCustomElementDeclaration, ApiCustomElementField, ApiEvent, ApiFunctionDeclaration, ApiInterfaceDeclaration, ApiModule, ApiVariableDeclaration } from "../../apiJson.js";
+import type { ApiClassDeclaration, ApiClassMethod, ApiCustomElementDeclaration, ApiCustomElementField, ApiEvent, ApiFunctionDeclaration, ApiInterfaceDeclaration, ApiModule, ApiVariableDeclaration, ApiWithDeprecated, ApiWithDescription, ApiWithDocsTags } from "../../apiJson.js";
 
 /** [Documentation](https://webgis.esri.com/references/api-extractor/tags-reference#copydoc)) */
 export interface CopyDocDefinitions {
@@ -18,8 +18,14 @@ export interface CopyDocDefinitions {
   interfaces?: CopyDocDeclarations<ApiInterfaceDeclaration>;
 }
 
-export type CopiableFields = "deprecated" | "description" | "docsTags" | "readonly" | "return";
+/**
+ * A common shape for metadata that can be included in declarative copy doc.
+ * Extra fields can be specified by imperatively mutating the API declaration.
+ */
+export interface CopyDocCommonBase extends Partial<ApiWithDescription>, Partial<ApiWithDocsTags>, Partial<ApiWithDeprecated> {
+  return?: ApiWithDescription;
+}
 
-export type CopyDocDeclarations<ApiType extends Partial<Record<CopiableFields, unknown>>> = Record<string, Partial<Pick<ApiType, CopiableFields>> | ((apiDeclaration: ApiType, module: ApiModule) => Partial<Pick<ApiType, CopiableFields>>) | undefined>;
+export type CopyDocDeclarations<ApiType extends Partial<CopyDocCommonBase>> = Record<string, Pick<CopyDocCommonBase, keyof ApiType & keyof CopyDocCommonBase> | ((apiDeclaration: ApiType, module: ApiModule) => Pick<CopyDocCommonBase, keyof ApiType & keyof CopyDocCommonBase>) | undefined>;
 
-export type CopyDocMemberDeclarations<ApiType extends Partial<Record<CopiableFields, unknown>>> = Record<string, Partial<Pick<ApiType, CopiableFields>> | ((apiDeclaration: ApiType, classOrComponent: ApiClassDeclaration | ApiCustomElementDeclaration, module: ApiModule) => Partial<Pick<ApiType, CopiableFields>>) | undefined>;
+export type CopyDocMemberDeclarations<ApiType extends Partial<CopyDocCommonBase>> = Record<string, Pick<CopyDocCommonBase, keyof ApiType & keyof CopyDocCommonBase> | ((apiDeclaration: ApiType, classOrComponent: ApiClassDeclaration | ApiCustomElementDeclaration, module: ApiModule) => Pick<CopyDocCommonBase, keyof ApiType & keyof CopyDocCommonBase> | undefined) | undefined>;

package/dist/{typeScript-Bi6LkUmP.js → typeScript-rpB6x3rO.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.2.0-next.1", D = {
+const w = "@arcgis/api-extractor", P = "5.2.0-next.11", D = {
   name: w,
   version: P
 };

package/dist/utils/apiHelpers.d.ts

@@ -12,6 +12,9 @@ export const globalPackageIdentifier: "global:";
 /**
  * Get a name from a class member.
  *
+ * > We don't need a similar utility for ApiModule declarations as each
+ * > declaration has a name.
+ *
  * @param member
  * @example
  * - method named "test" => "test"

package/dist/utils/apiHelpers.js

@@ -30,7 +30,7 @@ function x(e, n, o) {
 }
 const l = new Intl.Collator("en", { numeric: !0 }).compare, S = (e, n) => l(e.name, n.name), M = (e, n) => e.static !== void 0 && n.static === void 0 ? -1 : n.static !== void 0 && e.static === void 0 ? 1 : e.name === void 0 ? n.name === void 0 ? 0 : -1 : n.name === void 0 || "return" in e && !("return" in n) ? 1 : "return" in n && !("return" in e) ? -1 : l(e.name, n.name), d = (e) => e.name ?? (e.kind === "constructor" ? "constructor" : "call-signature"), P = (e) => e.static === !0 ? `static ${d(e)}` : d(e), T = (e) => ("bubbles" in e ? "@" : "") + (e.tagName ?? e.name ?? (e.kind === "constructor" ? "constructor" : "")) + ("return" in e ? "()" : "");
 function k(e, n, o = -1) {
-  "description" in n && (n.description ??= e.description), "deprecated" in n && (n.deprecated ??= e.deprecated), "return" in n && e.return !== void 0 && (n.return.description ??= e.return?.description), "readonly" in n && (n.readonly ??= e.readonly);
+  "description" in n && (n.description ??= e.description), "deprecated" in n && (n.deprecated ??= e.deprecated), "return" in n && e.return !== void 0 && (n.return.description ??= e.return?.description);
   const { docsTags: i } = e, t = n;
   if (o !== -1 && (i === void 0 && t.docsTags.length === 1 ? t.docsTags = void 0 : t.docsTags.splice(o, 1)), i !== void 0) {
     t.docsTags ??= [];
@@ -43,7 +43,7 @@ function k(e, n, o = -1) {
     }
   }
 }
-function y(e, n) {
+function A(e, n) {
   let o = e.text;
   if (e.references !== void 0)
     for (let i = e.references.length - 1; i >= 0; i--) {
@@ -59,11 +59,11 @@ function y(e, n) {
     references: void 0
   };
 }
-function A(e) {
+function N(e) {
   return e.return.type.text.startsWith("Promise<");
 }
 export {
-  y as apiTypeToImportType,
+  A as apiTypeToImportType,
   M as compareClassMembers,
   S as compareNamedNodes,
   l as compareStrings,
@@ -73,7 +73,7 @@ export {
   P as getMaybeStaticApiMemberName,
   p as globalPackageIdentifier,
   g as isApiMethod,
-  A as isApiMethodAsync,
+  N as isApiMethodAsync,
   v as isApiProperty,
   k as mergeApiNodes,
   h as naturalSortModules

package/dist/utils/hydrateApiType.js

@@ -1,3 +1,4 @@
+import { globalPackageIdentifier as h } from "./apiHelpers.js";
 const d = {
   // Create a null prototype object to avoid collisions with Object.prototype when doing lookups
   // eslint-disable-next-line @typescript-eslint/naming-convention
@@ -12,51 +13,52 @@ const d = {
   unknown: "https://www.typescriptlang.org/docs/handbook/2/functions.html#unknown",
   never: "https://www.typescriptlang.org/docs/handbook/2/functions.html#never",
   any: "https://www.typescriptlang.org/docs/handbook/2/everyday-types.html#any",
-  this: "#"
-}, h = Object.keys(d).join("|"), g = new RegExp(`(?<!["'-])\\b(?:${h})\\b(?!["'-])`, "u");
-function p(e, c) {
-  const n = [];
-  let o = e.text.length;
+  this: "#",
+  symbol: "https://www.typescriptlang.org/docs/handbook/symbols.html"
+}, p = Object.keys(d).join("|"), g = new RegExp(`(?<!["'-])\\b(?:${p})\\b(?!["'-])`, "u");
+function v(e, c) {
+  const o = [];
+  let n = e.text.length;
   if (e.references !== void 0)
     for (let l = e.references.length - 1; l >= 0; l--) {
       const t = e.references[l];
       if (t.start === void 0 || t.end === void 0)
         continue;
-      const r = e.text.slice(t.end, o);
-      r.length > 0 && i(r, c, n);
+      const r = e.text.slice(t.end, n);
+      r.length > 0 && i(r, c, o);
       const s = e.text.slice(t.start, t.end);
-      o = t.start, t.viewUrl === void 0 ? n.push(s) : n.push(
+      n = t.start, t.viewUrl === void 0 ? o.push(s) : o.push(
         c(s, t)
       );
     }
-  if (o > 0) {
-    const l = e.text.slice(0, o);
-    i(l, c, n);
+  if (n > 0) {
+    const l = e.text.slice(0, n);
+    i(l, c, o);
   }
-  return n.reverse();
+  return o.reverse();
 }
-function i(e, c, n) {
-  const o = n.length;
+function i(e, c, o) {
+  const n = o.length;
   for (let l = 0; l < e.length; ) {
     const t = e.match(g);
     if (t?.index === void 0)
       break;
     const r = e.slice(0, t.index);
-    r.length > 0 && n.splice(o, 0, r);
+    r.length > 0 && o.splice(n, 0, r);
     const s = t[0];
     e = e.slice(t.index + s.length);
     const a = d[s], b = c(s, {
       name: s,
       module: void 0,
-      package: s === "this" ? void 0 : "global:",
+      package: s === "this" ? void 0 : h,
       viewUrl: a,
       start: void 0,
       end: void 0
     });
-    n.splice(o, 0, b);
+    o.splice(n, 0, b);
   }
-  e.length > 0 && n.splice(o, 0, e);
+  e.length > 0 && o.splice(n, 0, e);
 }
 export {
-  p as hydrateApiType
+  v as hydrateApiType
 };

package/dist/vite/plugin.js

@@ -1,6 +1,6 @@
-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 { l as O, m as J } from "../worker-B9PXR8bT.js";
+import { A as S, w as T } from "../ApiExtractor-DKbuT3yq.js";
+import { p as A, l as C } from "../typeScript-rpB6x3rO.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-Bi6LkUmP.js";
+import { b as t } from "../typeScript-rpB6x3rO.js";
 export {
   t as loadTypeScriptConfig
 };