@arcgis/api-extractor 5.0.0-next.135 → 5.0.0-next.137

package/dist/typeScript-CzUTFiYO.js

@@ -0,0 +1,64 @@
+import { findPath as v, path as C, toSystemPathSeparators as y } from "@arcgis/components-build-utils";
+import t from "typescript";
+import E, { supportsColorStderr as S } from "chalk";
+import { styleText as w } from "util";
+const P = "@arcgis/api-extractor", D = "5.0.0-next.137", N = {
+  name: P,
+  version: D
+};
+let u;
+function A(o) {
+  return u ??= t.createPrinter(), u.printNode(t.EmitHint.Unspecified, o, void 0);
+}
+function F(o, r) {
+  return o.pos !== -1 && o.end !== -1 && r !== void 0 ? o.getText(r) : A(o);
+}
+const p = N.name, g = {
+  getCurrentDirectory: process.cwd,
+  getCanonicalFileName: (o) => o,
+  getNewLine: () => t.sys.newLine
+}, W = function(o, { file: r, node: n, scope: s, start: i, length: c }) {
+  this.errorCount += 1, process.exitCode = 1, i ??= n === void 0 || n.pos === -1 ? -1 : n.getStart(r, !1);
+  const a = n?.end ?? -1;
+  c ??= a === -1 ? -1 : Math.max(1, a - i);
+  const e = i >= 0 && c >= 0, d = !e && s !== void 0, f = {
+    category: t.DiagnosticCategory.Error,
+    code: e ? p : x,
+    file: d ? void 0 : r,
+    start: e ? i : 0,
+    length: e ? c : 0,
+    messageText: (d ? `${E.cyan(s)}: ` : "") + o + (e || n === void 0 ? "" : `
+
+${F(n, r)}`)
+  }, l = t.formatDiagnosticsWithColorAndContext([f], g), m = S ? l : l.replaceAll($, ""), h = e ? m : m.replace(x.toString(), p);
+  this.config.context.logger.error(h);
+}, x = 1490, $ = /\x1B\[[0-9;]*m/gu, J = w("cyan", `[${p}] `);
+function U(o = process.cwd(), r, n) {
+  const s = r === void 0 ? v("tsconfig.json", o) : C.resolve(o, r);
+  if (s === void 0)
+    throw Error(
+      `Unable to find ${y(String(r))}. Please make sure the file exists, or provide types.tsconfigPath option to useLumina()`
+    );
+  const i = t.readConfigFile(s, t.sys.readFile);
+  if (i.error !== void 0)
+    throw Error(t.formatDiagnosticsWithColorAndContext([i.error], g));
+  const c = i.config, a = n ? c : {
+    ...c,
+    include: [],
+    files: [],
+    exclude: []
+  }, e = t.parseJsonConfigFileContent(a, t.sys, C.dirname(s)), d = 18002, f = n ? e.errors : e.errors.filter((l) => l.code !== d);
+  if (f.length > 0)
+    throw Error(t.formatDiagnosticsWithColorAndContext(f, g));
+  return {
+    configPath: s,
+    config: e
+  };
+}
+export {
+  g as a,
+  U as b,
+  W as e,
+  J as l,
+  N as p
+};

package/dist/uiUtils/index.d.ts

@@ -1,21 +1,12 @@
-import { ApiType, ApiTypeReference } from '../apiJson.ts';
+import type { ApiType } from "../apiJson.js";
+import type { HydrateApiTypeCallback as HydrateApiTypeCallbackAlias } from "../utils/hydrateApiType.js";
+
 /**
- * Traverse through ApiType text string, turning type references into links.
- *
- * Also hydrates well-known JS "global" keywords (e.g. `string`, `number`), even
- * if they don't appear in ApiType.references.
- *
- * @example
- * ```ts
- * const markdownTypeString = hydrateApiType(
- *   apiProperty.type,
- *   (text, reference) => `[${text}](${reference.viewUrl})`
- * ).join("");
- * ```
- *
- * @see [Type References](../config/typeReferences/README.md)
+ * @deprecated import { hydrateApiType } from "@arcgis/api-extractor/utils/hydrateApiType" instead.
+ * @param apiType
+ * @param hydratePart
  */
-export declare function hydrateApiType<T>(apiType: Pick<ApiType, "references" | "text">, hydratePart: HydrateApiTypeCallback<T>): (T | string)[];
-export type HydrateApiTypeCallback<T> = (referenceText: string, reference: ApiTypeReference & {
-    viewUrl: NonNullable<ApiTypeReference["viewUrl"]>;
-}) => T;
+export function hydrateApiType<T>(apiType: Pick<ApiType, "references" | "text">, hydratePart: HydrateApiTypeCallbackAlias<T>): (T | string)[];
+
+/** @deprecated import { HydrateApiTypeCallback } from "@arcgis/api-extractor/utils/hydrateApiType" instead. */
+export type HydrateApiTypeCallback<T> = HydrateApiTypeCallbackAlias<T>;

package/dist/uiUtils/index.js

@@ -1,57 +1,5 @@
-const d = Object.assign(/* @__PURE__ */ Object.create(null), {
-  undefined: "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/undefined",
-  string: "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String",
-  boolean: "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Boolean",
-  null: "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/null",
-  number: "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number",
-  object: "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Object",
-  void: "https://www.typescriptlang.org/docs/handbook/2/functions.html#void",
-  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, l) {
-  const n = [];
-  let o = e.text.length;
-  if (e.references !== void 0)
-    for (let c = e.references.length - 1; c >= 0; c--) {
-      const t = e.references[c];
-      if (t.start === void 0 || t.end === void 0)
-        continue;
-      const r = e.text.slice(t.end, o);
-      r.length > 0 && i(r, l, n);
-      const s = e.text.slice(t.start, t.end);
-      o = t.start, t.viewUrl === void 0 ? n.push(s) : n.push(
-        l(s, t)
-      );
-    }
-  if (o > 0) {
-    const c = e.text.slice(0, o);
-    i(c, l, n);
-  }
-  return n.reverse();
-}
-function i(e, l, n) {
-  const o = n.length;
-  for (let c = 0; c < 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);
-    const s = t[0];
-    e = e.slice(t.index + s.length);
-    const a = d[s], b = l(s, {
-      name: s,
-      module: void 0,
-      package: s === "this" ? void 0 : "global:",
-      viewUrl: a
-    });
-    n.splice(o, 0, b);
-  }
-  e.length > 0 && n.splice(o, 0, e);
-}
+import { hydrateApiType as p } from "../utils/hydrateApiType.js";
+const r = p;
 export {
-  p as hydrateApiType
+  r as hydrateApiType
 };

package/dist/utils/apiHelpers.d.ts

@@ -1,82 +1,49 @@
-import { default as ts } from 'typescript';
-import { ApiAttribute, ApiClassDeclaration, ApiClassMember, ApiClassMethod, ApiCssCustomProperty, ApiCssCustomState, ApiCssPart, ApiCustomElementDeclaration, ApiCustomElementField, ApiCustomElementMember, ApiDeclaration, ApiEvent, ApiFunctionDeclaration, ApiInterfaceDeclaration, ApiModule, ApiSlot, ApiTypeReference, ApiVariableDeclaration } from '../apiJson.ts';
-export declare const isApiMethod: (member: ApiClassMember) => member is ApiClassMethod;
-export declare const isApiProperty: (member: ApiClassMember) => member is ApiCustomElementField;
-/**
- * Being a bit smarter than simply sorting paths alphabetically. The goal
- * is that nested components appear after their parent component. Otherwise,
- * simple alphabetical.
- *
- * @example
- * ```ts
- * [
- *  "src/components/z/z.js",
- *  "src/components/z/components/sub-a.js",
- *  "src/components/z/components/sub-z.js",
- * ]
- * ```
- */
-export declare function naturalSortModules(left: Pick<ApiModule, "sourcePath">, right: Pick<ApiModule, "sourcePath">): number;
-/**
- * This is not made up by us - defined in the custom-elements-manifest spec
- */
-export declare const globalPackageIdentifier = "global:";
-export declare const multipleJsDocTags: Set<string>;
-interface PostProcessLinkContext {
-    alternativeDocumentationHost: string;
-    normalizedDocumentationHost: string;
-    resolveJsDocLink: (text: string, match: string) => string;
-    moduleName: string;
-    file?: ts.SourceFile;
-}
-export declare function postProcessLinks(apiPart: Partial<Pick<ApiCustomElementField, "deprecated" | "description" | "docsTags" | "inheritedFrom">>, context: PostProcessLinkContext): void;
-/**
- * @privateRemarks
- * Link validation runs during post-processing, at which point we don't have easy
- * AST access.
- */
-export declare function apiExtractorJsDocError(message: string, text: string, context: PostProcessLinkContext): void;
-export declare const compareStrings: (x: string, y: string) => number;
-export declare const compareNamedNodes: (left: {
-    name: string;
-}, right: {
-    name: string;
-}) => number;
-/**
- * 1. Static members
- * 2. Constructors and call signatures
- * 3. Properties before methods
- * 4. Alphabetical
- */
-export declare const compareClassMembers: (left: ApiClassMember, right: ApiClassMember) => number;
-/**
- * Associate a start and end index with each type reference. Drop unresolved
- * references.
- */
-export declare function findReferenceRanges(references: ApiTypeReference[], resolvedString: string): ApiTypeReference[] | undefined;
+import type { ApiClassMember, ApiClassMethod, ApiCssCustomProperty, ApiCustomElementField, ApiCustomElementMember, ApiDeclaration, ApiEvent, ApiSlot } from "../apiJson.js";
+
+/** @param member */
+export function isApiMethod(member: ApiClassMember): member is ApiClassMethod;
+
+/** @param member */
+export function isApiProperty(member: ApiClassMember): member is ApiCustomElementField;
+
+/** This is not made up by us - defined in the custom-elements-manifest spec */
+export const globalPackageIdentifier: "global:";
+
 /**
  * Get a name from a class member.
  *
+ * @param member
  * @example
  * - method named "test" => "test"
  * - property named "test" => "test"
  * - constructor => "constructor"
  * - call-signature => "call-signature"
  */
-export declare const getApiMemberName: (member: ApiClassMember | ApiCustomElementMember) => string;
+export function getApiMemberName(member: ApiClassMember | ApiCustomElementMember): string;
+
 /**
  * Like `getApiMemberName`, but prefixes with `static ` if the member is static.
+ *
+ * @param member
  */
-export declare const getMaybeStaticApiMemberName: (member: ApiClassMember | ApiCustomElementMember) => string;
+export function getMaybeStaticApiMemberName(member: ApiClassMember | ApiCustomElementMember): string;
+
 /**
  * Get a UI label from a class member.
  *
+ * @param member
  * @example
  * - method named "test" => "test()"
  * - property named "test" => "test"
  * - constructor => "constructor()"
  * - call-signature => "()"
+ * - web component with tag name "my-component" => "my-component"
+ */
+export function getApiNodeLabel(member: ApiClassMember | ApiCssCustomProperty | ApiCustomElementMember | ApiDeclaration | ApiEvent | ApiSlot): string;
+
+/**
+ * Checks whether method's return type is a Promise.
+ *
+ * @param apiMethod
  */
-export declare const getApiNodeLabel: (member: ApiClassMember | ApiCssCustomProperty | ApiCustomElementMember | ApiDeclaration | ApiEvent) => string;
-export declare function mergeApiNodes<T extends ApiAttribute | ApiClassDeclaration | ApiClassMember | ApiCssCustomProperty | ApiCssCustomState | ApiCssPart | ApiCustomElementDeclaration | ApiCustomElementMember | ApiEvent | ApiFunctionDeclaration | ApiInterfaceDeclaration | ApiSlot | ApiVariableDeclaration>(source: Partial<T>, destination: T, copyDocTagIndex?: number): void;
-export {};
+export function isApiMethodAsync(apiMethod: ApiClassMethod): boolean;

package/dist/utils/apiHelpers.js

@@ -0,0 +1,80 @@
+import { getModuleContext as f } from "../extractor/privateContext.js";
+const g = (e) => e.kind === "method", v = (e) => e.kind === "field";
+function h(e, n) {
+  const o = e.sourcePath, i = n.sourcePath;
+  let t = 0;
+  for (; ; ) {
+    const c = o.indexOf("/", t), s = i.indexOf("/", t);
+    if (c === -1)
+      return s === -1 ? o.slice(t) < i.slice(t) ? -1 : 1 : -1;
+    if (s === -1)
+      return 1;
+    {
+      const r = o.slice(t, c), a = i.slice(t, s);
+      if (r !== a)
+        return r < a ? -1 : 1;
+      t = c + 1;
+    }
+  }
+}
+const p = "global:";
+function x(e, n, o) {
+  const i = f(o.apiModule).file, t = i.text.indexOf(n) ?? -1;
+  o.emitError(`${e}${t === -1 ? `. Found in: ${n}` : ""}`, {
+    file: i,
+    node: void 0,
+    scope: i === void 0 ? o.apiModule.sourcePath : void 0,
+    start: t,
+    length: n.length
+  });
+}
+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);
+  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 ??= [];
+    const c = /* @__PURE__ */ new Set();
+    for (let s = 0; s < t.docsTags.length; ++s)
+      c.add(t.docsTags[s].name);
+    for (let s = 0; s < i.length; ++s) {
+      const r = i[s];
+      c.has(r.name) && r.name !== "example" && r.name !== "see" || t.docsTags.push(r);
+    }
+  }
+}
+function y(e, n) {
+  let o = e.text;
+  if (e.references !== void 0)
+    for (let i = e.references.length - 1; i >= 0; i--) {
+      const t = e.references[i];
+      if (t.package === p || t.module === void 0 && t.package === void 0 && t.viewUrl === void 0)
+        continue;
+      const r = t.name === "default" ? "default" : t.name, u = `import("${t.package === void 0 ? `./${t.module ?? n}.js` : t.package + (t.module === void 0 ? "" : `/${t.module}`)}").${r}`;
+      o = o.slice(0, t.start) + u + o.slice(t.end);
+    }
+  return {
+    ...e,
+    text: o,
+    references: void 0
+  };
+}
+function A(e) {
+  return e.return.type.text.startsWith("Promise<");
+}
+export {
+  y as apiTypeToImportType,
+  M as compareClassMembers,
+  S as compareNamedNodes,
+  l as compareStrings,
+  x as emitJsDocError,
+  d as getApiMemberName,
+  T as getApiNodeLabel,
+  P as getMaybeStaticApiMemberName,
+  p as globalPackageIdentifier,
+  g as isApiMethod,
+  A as isApiMethodAsync,
+  v as isApiProperty,
+  k as mergeApiNodes,
+  h as naturalSortModules
+};

package/dist/utils/astHelpers.d.ts

@@ -1,27 +1,28 @@
-import { default as ts } from 'typescript';
-import { ApiPropertyLike } from '../apiJson.ts';
+import type ts from "typescript";
+
 /**
- * Check if a member has a static, private, or protected modifier.
- */
-export declare const hasIgnoredModifier: (member: ts.ClassElement) => boolean;
-/**
- * Include default value only if:
- * - it's a literal value
- * - we have `@default` tag in the JSDoc (handled in setApiDocFromJsDoc)
- * - default value is a variable or property access expression whose
- *   declaration has a JSDoc (handled further down in this file)
+ * Convert property name node into a string. Converts Identifier and
+ * StringLiteralLike nodes. Handles symbols like [Symbol.iterator]. For the
+ * rest, returns undefined.
+ *
+ * @param name
  */
-export declare function setDefaultFromInitializer(node: Pick<ts.PropertyDeclaration, "initializer">, property: Pick<ApiPropertyLike, "default">, sourceFile: ts.SourceFile): void;
+export function getMemberName(name?: ts.PropertyName): string | undefined;
+
 /**
- * Convert property name node into a string. Converts Identifier and
- * StringLiteralLike nodes. The rest return undefined.
+ * @param specifier
+ * @example
+ * ```js
+ * getPackageNameFromExternalSpecifier("@esri/calcite-components/components/calcite-button")
+ * // "@esri/calcite-components"
+ * ```
  */
-export declare function getMemberName(name?: ts.PropertyName): string | undefined;
-export declare const findDecorator: ({ modifiers }: {
-    modifiers?: readonly ts.ModifierLike[];
-}, name: string) => ts.CallExpression | undefined;
-export declare function extractBooleanInitializer(initializer: ts.Expression, sourceFile: ts.SourceFile): boolean;
+export function getPackageNameFromExternalSpecifier(specifier: string): string;
+
 /**
- * Remove the first dot after the last slash. Thus, `.d.ts` is removed.
+ * Remove the extension from a file path. In most cases, removes only the last
+ * dot segment, but also removes `.d` in case of `.d.ts`
+ *
+ * @param path
  */
-export declare function getBasename(path: string): string;
+export function getBasename(path: string): string;

package/dist/utils/astHelpers.js

@@ -0,0 +1,67 @@
+import n from "typescript";
+import { mappedFind as x } from "@arcgis/toolkit/array";
+function f(e, s, t, o) {
+  if (!s && e !== void 0) {
+    const r = i(e, o);
+    if (l(r))
+      return r.getText(t);
+  }
+  return s;
+}
+const l = (e) => n.isLiteralExpression(e) || e.kind === n.SyntaxKind.TrueKeyword || e.kind === n.SyntaxKind.FalseKeyword || n.isPrefixUnaryExpression(e) && n.isLiteralExpression(e.operand);
+function i(e, s) {
+  return n.isSatisfiesExpression(e) || n.isParenthesizedExpression(e) || !s && (n.isAsExpression(e) || n.isTypeAssertionExpression(e)) ? i(e.expression, s) : e;
+}
+function c(e) {
+  if (e !== void 0) {
+    if (n.isIdentifier(e))
+      return e.escapedText;
+    if (n.isStringLiteralLike(e))
+      return e.text;
+    if (n.isComputedPropertyName(e)) {
+      if (n.isStringLiteralLike(e.expression))
+        return e.expression.text;
+      if (n.isPropertyAccessExpression(e.expression) && n.isIdentifier(e.expression.expression) && e.expression.expression.text === "Symbol")
+        return `[Symbol.${e.expression.name.text}]`;
+    }
+  }
+}
+const p = (e, s) => e === void 0 ? void 0 : x(
+  e,
+  (t) => n.isDecorator(t) && n.isCallExpression(t.expression) && n.isIdentifier(t.expression.expression) && t.expression.expression.escapedText === s ? t.expression : void 0
+);
+function y(e) {
+  const s = e.indexOf("/");
+  if (s === -1)
+    return e;
+  if (e.startsWith("@")) {
+    const t = e.indexOf("/", s + 1);
+    return t === -1 ? e : e.slice(0, t);
+  } else
+    return e.slice(0, s);
+}
+function E(e, s) {
+  return e.kind === n.SyntaxKind.TrueKeyword ? !0 : (e.kind === n.SyntaxKind.FalseKeyword || s.emitError(
+    "Expected boolean literal (true or false) rather than variable/expression - the value must be statically analyzable",
+    {
+      file: s.file,
+      node: e
+    }
+  ), !1);
+}
+function g(e) {
+  const s = e.lastIndexOf(".");
+  if (s === -1 || e.length - s > d || e.includes("/", s))
+    return e;
+  const t = e.slice(s - 2, s) === ".d" ? s - 2 : s;
+  return e.slice(0, t);
+}
+const d = 4;
+export {
+  E as extractBooleanInitializer,
+  f as extractInitializer,
+  p as findDecorator,
+  g as getBasename,
+  c as getMemberName,
+  y as getPackageNameFromExternalSpecifier
+};

package/dist/utils/hydrateApiType.d.ts

@@ -0,0 +1,26 @@
+import type { ApiType, ApiTypeReference } from "../apiJson.js";
+
+/**
+ * Traverse through ApiType text string, turning type references into links.
+ *
+ * Also hydrates well-known JS "global" keywords (e.g. `string`, `number`), even
+ * if they don't appear in ApiType.references.
+ *
+ * @param apiType - The ApiType to hydrate
+ * @param hydratePart - A callback that converts a type reference into desired output
+ * @see [Type References](https://devtopia.esri.com/WebGIS/arcgis-web-components/blob/main/packages/support-packages/api-extractor/src/const/typeReferences/README.md)
+ * @example
+ * ```ts
+ * const markdownTypeString = hydrateApiType(
+ *   apiProperty.type,
+ *   (text, reference) => `[${text}](${reference.viewUrl})`
+ * ).join("");
+ * ```
+ */
+export function hydrateApiType<T>(apiType: Pick<ApiType, "references" | "text">, hydratePart: HydrateApiTypeCallback<T>): (T | string)[];
+
+/**
+ * @param referenceText - The text of the type reference
+ * @param reference - The metadata about the type reference
+ */
+export type HydrateApiTypeCallback<T> = (referenceText: string, reference: ApiTypeReference & { viewUrl: NonNullable<ApiTypeReference["viewUrl"]>; }) => T;

package/dist/utils/hydrateApiType.js

@@ -0,0 +1,62 @@
+const d = {
+  // Create a null prototype object to avoid collisions with Object.prototype when doing lookups
+  // eslint-disable-next-line @typescript-eslint/naming-convention
+  __proto__: null,
+  undefined: "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/undefined",
+  string: "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String",
+  boolean: "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Boolean",
+  null: "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/null",
+  number: "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number",
+  object: "https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Object",
+  void: "https://www.typescriptlang.org/docs/handbook/2/functions.html#void",
+  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;
+  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 s = e.text.slice(t.start, t.end);
+      o = t.start, t.viewUrl === void 0 ? n.push(s) : n.push(
+        c(s, t)
+      );
+    }
+  if (o > 0) {
+    const l = e.text.slice(0, o);
+    i(l, c, n);
+  }
+  return n.reverse();
+}
+function i(e, c, n) {
+  const o = n.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);
+    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:",
+      viewUrl: a,
+      start: void 0,
+      end: void 0
+    });
+    n.splice(o, 0, b);
+  }
+  e.length > 0 && n.splice(o, 0, e);
+}
+export {
+  p as hydrateApiType
+};

package/dist/utils/inferEntrypoints.d.ts

@@ -0,0 +1,17 @@
+import type { ApiJson } from "../apiJson.js";
+
+/**
+ * Given api.json, list paths of files that export public runtime APIs. These
+ * can be used as entrypoints for bundling.
+ *
+ * @param apiJson
+ * @example
+ * ```ts
+ * // See JSDoc on top of "@arcgis/api-extractor/extractor/ApiExtractor" for
+ * // a full example of producing api.json
+ * const { apiJson } = await extractor.run();
+ * import { inferEntrypoints } from "@arcgis/api-extractor/utils/inferEntrypoints";
+ * const entrypoints = inferEntrypoints(apiJson);
+ * ```
+ */
+export function inferEntrypoints(apiJson: ApiJson): string[];

package/dist/utils/inferEntrypoints.js

@@ -0,0 +1,26 @@
+function o(n) {
+  const e = [];
+  for (let t = 0; t < n.modules.length; ++t) {
+    const r = n.modules[t];
+    i(r) && e.push(r.sourcePath);
+  }
+  return e;
+}
+function i(n) {
+  if (
+    // To keep api.json size in check, api.json for now only includes default
+    // exports and custom elements exports - those are runtime declarations.
+    n.exports !== void 0 && // Ignore type-only default export (interfaces - @arcgis/core/views/layers/GeoJSONLayerView)
+    n.exports[0]?.kind !== "ts"
+  )
+    return !0;
+  for (let e = 0; e < n.declarations.length; ++e) {
+    const t = n.declarations[e];
+    if (t.kind === "class" || t.kind === "function" || t.kind === "variable")
+      return !0;
+  }
+  return !1;
+}
+export {
+  o as inferEntrypoints
+};