@arcgis/api-extractor 5.1.0-next.2 → 5.1.0-next.21

package/dist/{ApiExtractor-BAlbk5aI.js → ApiExtractor-CedoYImr.js}

@@ -1,5 +1,5 @@
-import { l as H, a as se, e as Re, p as fe } from "./typeScript-CWDJzPiS.js";
-import { a as be, o as Me, t as Ge, b as De, c as Le, e as Oe, d as _, p as Ne, f as Be, i as me, g as We, h as Ue, j as ze, k as je, n as He, r as Je } from "./worker-Dd5059jd.js";
+import { l as H, a as se, e as Re, p as fe } from "./typeScript-BDnFfwUK.js";
+import { a as be, o as Me, t as Ge, b as De, c as Le, e as Oe, d as _, p as Ne, f as Be, i as me, g as We, h as Ue, j as ze, k as je, n as He, r as Je } from "./worker-D8J9SUI5.js";
 import { getViewUrl as Ve, postProcessDeprecated as ee, postProcessDescription as G, postProcessDocsTags as V, resolveJsDocLink as Xe } from "./extractor/processing/links.js";
 import E from "typescript";
 import { path as N, toPosixPathSeparators as Ye } from "@arcgis/components-build-utils";
@@ -1734,7 +1734,10 @@ function xt(e, t) {
 function he(e, t, i) {
   if (e.package !== void 0)
     return;
-  const n = t.moduleMap.get(e.module), s = h(n), a = s.constructorPropertiesInterface;
+  const n = t.moduleMap.get(e.module);
+  if (n === void 0)
+    return;
+  const s = h(n), a = s.constructorPropertiesInterface;
   if (a === void 0) {
     const o = s.inheritance;
     if (typeof o == "object" && o.hasSettableField) {

package/dist/cli-7PX_wNxb.js

@@ -0,0 +1,34 @@
+import { writeFile as r, readFile as d } from "node:fs/promises";
+import { diffApiJson as m } from "./diff/diffApiJson.js";
+async function k({
+  oldPath: t,
+  newPath: i,
+  outputPath: o,
+  docsUrlPrefix: e
+}) {
+  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);
+      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);
+    console.log(a);
+  }
+}
+async function f(t) {
+  if (t.startsWith("http://") || t.startsWith("https://")) {
+    const i = await fetch(t);
+    if (!i.ok)
+      throw new Error(`Failed to fetch api.json: ${i.statusText}`);
+    return await i.json();
+  } else {
+    const i = await d(t, "utf-8");
+    return JSON.parse(i);
+  }
+}
+export {
+  k as diffApiCli
+};

package/dist/cli.js

@@ -1,15 +1,15 @@
 #!/usr/bin/env node
-import { Command as p } from "@commander-js/extra-typings";
-const e = new p();
-e.name("api-extractor").description("Extract public API from a TypeScript project to produce .d.ts types and api.json docs");
-e.command("run").description("Generate .d.ts types and api.json API reference for a project").option("--cwd <arcgis-js-api>", "Path to the root of the project (default: process.cwd())").option("--dts <outputDirectory>", "Destination for the .d.ts files (example: dist/)").option("--api-json <outputLocation>", "Destination for the api.json file (example: dist/docs/api.json)").option("--environment <environment>", "Environment to run in (production or development) (default: production)").option("--type-check", "Run full type checking before the extraction (default: false)").option("--verify", "Run type checker on the emitted types (default: false)").option("--watch", "Watch for file changes and re-run the extraction automatically", !1).option(
+import { Command as c } from "@commander-js/extra-typings";
+const o = new c();
+o.name("api-extractor").description("Extract public API from a TypeScript project to produce .d.ts types and api.json docs");
+o.command("run").description("Generate .d.ts types and api.json API reference for a project").option("--cwd <arcgis-js-api>", "Path to the root of the project (default: process.cwd())").option("--dts <outputDirectory>", "Destination for the .d.ts files (example: dist/)").option("--api-json <outputLocation>", "Destination for the api.json file (example: dist/docs/api.json)").option("--environment <environment>", "Environment to run in (production or development) (default: production)").option("--type-check", "Run full type checking before the extraction (default: false)").option("--verify", "Run type checker on the emitted types (default: false)").option("--watch", "Watch for file changes and re-run the extraction automatically", !1).option(
   "--config <configPath>",
   "Path to the ./api-extractor.config.ts file. The provided path will be used as is in import(). The config file should export a `config` object of type ApiExtractorConfig (default: api-extractor.config.ts in the cwd)"
 ).option(
   "--silence-broken-links",
   "(deprecated) Do not emit errors for broken @links in JSDoc comments. Temporary option for migration period (default: false)"
 ).action(async (t) => {
-  const { loadApiExtractorConfig: o, mergeApiExtractorConfigs: n } = await import("./extractor/config.js"), a = await o(t.cwd, t.config), r = n(a, {
+  const { loadApiExtractorConfig: e, mergeApiExtractorConfigs: n } = await import("./extractor/config.js"), a = await e(t.cwd, t.config), r = n(a, {
     context: {
       dtsEmitPath: t.dts,
       apiJsonEmitPath: t.apiJson,
@@ -23,16 +23,35 @@ e.command("run").description("Generate .d.ts types and api.json API reference fo
       typeCheckTypes: t.verify,
       detectBrokenLinks: t.silenceBrokenLinks === !0 ? !1 : void 0
     }
-  }), { ApiExtractor: c } = await import("./extractor/ApiExtractor.js"), i = new c(r);
+  }), { ApiExtractor: p } = await import("./extractor/ApiExtractor.js"), i = new p(r);
   t.watch ? await i.watch() : await i.run();
 });
-e.command("diff-types").description("Generate a types diff summary .md file").requiredOption("--original-dts <originalTypings>", "Path to the original types folder").requiredOption("--new-dts <newTypings>", "Path to the new types folder").option("--output-md <outputMd>", "Path to the output markdown file", "types-diff.md").option("--no-truncate", "Do not truncate output if it is longer than 1000 lines", !0).action(async (t) => {
-  const { diffTypes: o } = await import("./diffTypes/index.js");
-  await o({
+o.command("diff").description("Produce a diff of two api.json files").requiredOption(
+  "--old <string>",
+  "URL or file path to the old api.json file. Example: https://unpkg.com/@arcgis/map-components@latest/dist/docs/api.json"
+).requiredOption(
+  "--new <string>",
+  "URL or file path to the new api.json file. Example: ./packages/map-packages/map-components/dist/docs/api.json"
+).option("--output <path>", "Path to the output .md or .json file. If not provided, will print markdown to console").option(
+  "--docs-url-prefix <string>",
+  "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");
+  await e({
+    oldPath: t.old,
+    newPath: t.new,
+    outputPath: t.output,
+    docsUrlPrefix: t.docsUrlPrefix
+  });
+});
+o.command("diff-types").description("Generate a types diff summary .md file").requiredOption("--original-dts <originalTypings>", "Path to the original types folder").requiredOption("--new-dts <newTypings>", "Path to the new types folder").option("--output-md <outputMd>", "Path to the output markdown file", "types-diff.md").option("--no-truncate", "Do not truncate output if it is longer than 1000 lines", !0).action(async (t) => {
+  const { diffTypes: e } = await import("./diffTypes/index.js");
+  await e({
     originalDtsPath: t.originalDts,
     newDtsPath: t.newDts,
     outputMdPath: t.outputMd,
     truncate: t.truncate
   });
 });
-e.parse();
+o.parse();

package/dist/diff/apiDiffToMarkdown.d.ts

@@ -0,0 +1,9 @@
+import type { ApiDiff } from "./types.js";
+
+/**
+ * Render an ApiDiff to a markdown nested lists tree.
+ *
+ * @param apiJson
+ * @param docsUrlPrefix
+ */
+export function apiDiffToMarkdown(apiJson: Pick<ApiDiff, "modules">, docsUrlPrefix: string): string;

package/dist/diff/apiDiffToMarkdown.js

@@ -0,0 +1,140 @@
+import { buildViewUrl as T } from "../extractor/processing/links.js";
+function K({ modules: e }, t) {
+  const o = {
+    children: /* @__PURE__ */ new Map(),
+    members: []
+  };
+  for (let n = 0; n < e.length; ++n) {
+    const s = e[n], w = s.path.split("/");
+    let y = w;
+    const M = w.at(-1);
+    s.declarations.length === 1 && s.declarations[0].name === M && (y = w.slice(0, -1));
+    let U = o;
+    for (const g of y)
+      U = N(U, g);
+    for (let g = 0; g < s.declarations.length; ++g) {
+      const h = s.declarations[g], S = B(h), O = h.removed === !0 ? void 0 : $(t, s.path, h, void 0), k = j(h), x = { label: S, viewUrl: O, change: k }, d = h, m = [];
+      if (d.members !== void 0)
+        for (let l = 0; l < d.members.length; ++l) {
+          const a = d.members[l], f = p(a.kind, a);
+          if (f === void 0)
+            continue;
+          const v = F(a), r = a.removed === !0 ? void 0 : $(
+            t,
+            s.path,
+            h,
+            "name" in a ? a.name : `${h.name}Properties`
+          );
+          m.push({ label: v, viewUrl: r, change: f });
+        }
+      if (d.events !== void 0)
+        for (let l = 0; l < d.events.length; ++l) {
+          const a = d.events[l], f = p("event", a);
+          if (f === void 0)
+            continue;
+          const v = a.removed === !0 ? void 0 : $(t, s.path, h, `event-${a.name}`);
+          m.push({ label: `@${a.name}`, viewUrl: v, change: f });
+        }
+      if (typeof d.tagName == "string") {
+        const l = d.slots, a = d.cssParts, f = d.cssProperties, v = d.cssStates;
+        if (l !== void 0)
+          for (let r = 0; r < l.length; ++r) {
+            const i = l[r], u = p("slot", i);
+            if (u === void 0)
+              continue;
+            const b = i.removed === !0 ? void 0 : $(t, s.path, h, `slot-${i.name}`);
+            m.push({ label: i.name, viewUrl: b, change: u });
+          }
+        if (a !== void 0)
+          for (let r = 0; r < a.length; ++r) {
+            const i = a[r], u = p("css part", i);
+            if (u === void 0)
+              continue;
+            m.push({ label: i.name, viewUrl: void 0, change: u });
+          }
+        if (f !== void 0)
+          for (let r = 0; r < f.length; ++r) {
+            const i = f[r], u = p("css property", i);
+            if (u === void 0)
+              continue;
+            const b = i.removed === !0 ? void 0 : $(t, s.path, h, i.name);
+            m.push({ label: i.name, viewUrl: b, change: u });
+          }
+        if (v !== void 0)
+          for (let r = 0; r < v.length; ++r) {
+            const i = v[r], u = p("css state", i);
+            if (u === void 0)
+              continue;
+            m.push({ label: i.name, viewUrl: void 0, change: u });
+          }
+      }
+      m.length > 0 ? E(U, x).members.push(...m) : k !== void 0 && U.members.push(x);
+    }
+  }
+  const c = [];
+  for (const n of o.children.values())
+    L(n, "", c);
+  return c.join(`
+`);
+}
+function N(e, t) {
+  const o = e.children.get(t);
+  if (o !== void 0)
+    return o;
+  const c = { name: t, children: /* @__PURE__ */ new Map(), members: [], node: void 0 };
+  return e.children.set(t, c), c;
+}
+function j(e) {
+  const t = e.tagName !== void 0 ? "component" : e.kind === "interface" ? "type declaration" : e.kind;
+  return p(t, e);
+}
+function p(e, t) {
+  const { added: o, removed: c, deprecated: n } = t;
+  if (c) {
+    const s = `**removed** ${e}`;
+    return typeof n == "string" ? `${s} - deprecated ${D(n)}` : s;
+  }
+  if (n)
+    return typeof n == "string" ? `**deprecated** ${e} ${D(n)}` : `**deprecated** ${e}`;
+  if (o)
+    return `**added** ${e}`;
+}
+function B(e) {
+  const t = e.tagName;
+  return typeof t == "string" && t.length > 0 ? t : C(e.name) + (e.kind === "function" ? "()" : "");
+}
+function $(e, t, o, c) {
+  const n = `${e}${t}/`;
+  return T(n, o.kind === "class" ? void 0 : o.name, c);
+}
+function E(e, t) {
+  const o = N(e, t.label);
+  return o.node = t, o;
+}
+function F(e) {
+  return e.kind === "constructor" ? "constructor" : e.kind === "call-signature" ? "call signature" : e.kind === "method" ? `${C(e.name)}()` : C(e.name);
+}
+function C(e) {
+  return e.replace(/[\\\[\]\(\)]/gu, "\\$&");
+}
+function D(e) {
+  return e.split(`
+`)[0];
+}
+function L(e, t, o) {
+  if (e.node) {
+    const n = e.node.viewUrl === void 0 ? e.node.label : `[${e.node.label}](${e.node.viewUrl})`;
+    e.node.change ? o.push(`${t}- ${n} - ${e.node.change}`) : o.push(`${t}- ${n}`);
+  } else
+    o.push(`${t}- ${e.name}/`);
+  const c = `${t}  `;
+  for (const n of e.members) {
+    const s = n.viewUrl === void 0 ? n.label : `[${n.label}](${n.viewUrl})`;
+    n.change ? o.push(`${c}- ${s} - ${n.change}`) : o.push(`${c}- ${s}`);
+  }
+  for (const n of e.children.values())
+    L(n, c, o);
+}
+export {
+  K as apiDiffToMarkdown
+};

package/dist/diff/diffApiJson.d.ts

@@ -1,4 +1,4 @@
-import type { ApiJson } from "../apiJson.js";
+import type { ApiJson, ApiJsonCompiler } from "../apiJson.js";
 import type { ApiDiff } from "./types.js";
 
 /**
@@ -6,8 +6,8 @@ import type { ApiDiff } from "./types.js";
  * @param newApiJson
  * @example
  * ```js
- * import { diffApiJson, fetchApiJsonFromNpm } from "@arcgis/api-extractor/diff";
- * import { readFileSync, writeFileSync } from "node:fs";
+ * import { diffApiJson } from "@arcgis/api-extractor/diff/diffApiJson";
+ * import { fetchApiJsonFromNpm } from "@arcgis/api-extractor/diff/fetchApiJsonFromNpm";
  *
  * // Read -next api.json from file system:
  * const apiJson = JSON.parse(
@@ -23,4 +23,4 @@ import type { ApiDiff } from "./types.js";
  * writeFileSync("api-diff.json", JSON.stringify(diff, null, 2));
  * ```
  */
-export function diffApiJson(oldApiJson: Pick<ApiJson, "modules">, newApiJson: Pick<ApiJson, "modules">): ApiDiff;
+export function diffApiJson(oldApiJson: Pick<ApiJson, "modules"> & { compiler?: ApiJsonCompiler; }, newApiJson: Pick<ApiJson, "modules"> & { compiler?: ApiJsonCompiler; }): ApiDiff;

package/dist/diff/diffApiJson.js

@@ -1,142 +1,265 @@
-function M(r, a) {
-  const n = new Map(r.modules.map((e) => [e.path, e])), t = [];
-  for (const e of a.modules) {
-    const s = n.get(e.path), i = k(s, e, !0);
-    i !== void 0 && t.push(i), n.delete(e.path);
+function w(i, o) {
+  if (i.compiler?.name !== "@arcgis/core:manual" || i.compiler?.version !== "4.34")
+    return;
+  const a = {};
+  return i.modules.forEach((e) => {
+    a[e.path] = e;
+  }), {
+    ...o,
+    modules: o.modules.filter((e) => {
+      const t = a[e.path];
+      return e.declarations = e.declarations.filter((s) => {
+        if (s.kind === "mixin")
+          return !1;
+        if (s.kind === "interface") {
+          const r = t?.declarations.find(
+            (d) => d.name === s.name && d.kind === "interface"
+          );
+          return s.members = void 0, r !== void 0;
+        }
+        return !0;
+      }), e.declarations.length > 0;
+    })
+  };
+}
+function x(i) {
+  const o = /* @__PURE__ */ new Set([
+    // Fake class turned into a variable
+    "config",
+    // Wasn't visible directly before due to doc mismatch
+    "identity/IdentityManagerBase",
+    // Fake class turned into a variable
+    "identity/IdentityManager",
+    // Fake class turned into an interface
+    "views/layers/GeoRSSLayerView",
+    "views/layers/GraphicsLayerView",
+    "views/layers/KMLLayerView",
+    "views/layers/VectorTileLayerView",
+    "views/layers/PointCloudLayerView",
+    // ENUM-like objects turned into const variable + interfaces
+    "layers/support/rasterFunctionConstants"
+  ]), a = i.modules.filter((n) => {
+    if (o.has(n.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;
+  });
+  return { ...i, modules: a };
+}
+const A = /* @__PURE__ */ new Set([
+  // Excluded from api.json inheritance to keep file size in check
+  "addHandles",
+  "hasHandles",
+  "removeHandles",
+  // These are coming from mixins. Exclude them from the diff to reduce noise
+  // compared to more valuable new 5.0 fields.
+  // Added 77 times
+  "emit",
+  // 77
+  "hasEventListener",
+  // 73
+  "fromJSON",
+  // 72
+  "on",
+  // 71
+  "toJSON",
+  // 63
+  "declaredClass",
+  // 63
+  "getAtOrigin",
+  // 63
+  "originOf",
+  // 63
+  "revertAllToOrigin",
+  // 63
+  "revertToOrigin",
+  // 54
+  "clone",
+  // 50
+  "fromPortalItem",
+  // 49
+  "fromArcGISServerUrl",
+  // 28
+  "isFulfilled",
+  // 28
+  "isRejected",
+  // 28
+  "isResolved",
+  // 28
+  "when",
+  // 6
+  "cancelLoad",
+  // 6
+  "loadError",
+  // 6
+  "loadStatus",
+  // 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),
+      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);
   }
-  for (const e of n.values()) {
-    const s = k(void 0, e, !1);
-    s !== void 0 && t.push(s);
+  for (const d of t.values()) {
+    const l = y(
+      void 0,
+      e ? { ...d, path: b(d, e) } : d,
+      !1
+    );
+    l !== void 0 && s.push(l);
   }
-  return { modules: t };
+  const r = { modules: s };
+  return a === void 0 ? r : x(r);
+}
+function b(i, o) {
+  return o ? i.declarations?.[0]?.importPath ?? i.path : i.path;
 }
-function k(r, a, n) {
-  const t = [], e = h(r?.declarations ?? []), s = h(a.declarations ?? []);
-  for (const i of s.values()) {
-    const o = i.at(-1), p = o.tagName, u = p ?? o.name, f = e.get(u);
-    e.delete(u);
-    const g = f === void 0 && !n ? !0 : void 0, m = n && // Only mark as deprecated if all overloads are deprecated
-    (i.length === 1 || i.every((d) => d.deprecated !== void 0)) ? o.deprecated : void 0, D = !m && f === void 0 && n ? !0 : void 0;
-    if (g || D) {
-      t.push({
-        kind: o.kind,
-        name: o.name,
-        tagName: p,
+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 = (
+      // 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;
+    if (g || k) {
+      n.push({
+        kind: r.kind,
+        name: r.name,
+        tagName: d,
         members: void 0,
         removed: g,
-        added: D,
-        deprecated: m
+        added: k,
+        deprecated: v
       });
       continue;
-    } else if (!n)
+    } else if (!a)
       continue;
-    if (p !== void 0) {
-      const d = o, c = f?.[0], l = {
-        kind: d.kind,
-        name: d.name,
-        tagName: d.tagName,
-        deprecated: m,
+    if (d !== void 0) {
+      const c = r, u = m?.[0], f = {
+        kind: c.kind,
+        name: c.name,
+        tagName: c.tagName,
+        deprecated: v,
         added: void 0,
         removed: void 0,
-        members: b(c?.members, d.members),
-        events: v(c?.events, d.events),
-        slots: v(c?.slots, d.slots),
-        cssParts: v(c?.cssParts, d.cssParts),
-        cssProperties: v(c?.cssProperties, d.cssProperties),
-        cssStates: v(c?.cssStates, d.cssStates)
+        members: M(u?.members, c.members),
+        events: p(u?.events, c.events),
+        slots: p(u?.slots, c.slots),
+        cssParts: p(u?.cssParts, c.cssParts),
+        cssProperties: p(u?.cssProperties, c.cssProperties),
+        cssStates: p(u?.cssStates, c.cssStates)
       };
-      (m !== void 0 || l.members !== void 0 || l.events !== void 0 || l.slots !== void 0 || l.cssParts !== void 0 || l.cssProperties !== void 0 || l.cssStates !== void 0) && t.push(l);
-    } else if (o.kind === "class" || o.kind === "interface" || o.kind === "mixin") {
-      const d = f?.[0], c = {
-        kind: o.kind,
-        name: o.name,
-        deprecated: m,
+      (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") {
+      const c = m?.[0], u = {
+        kind: r.kind,
+        name: r.name,
+        deprecated: v,
         added: void 0,
         removed: void 0,
-        members: b(d?.members, o.members),
-        events: "events" in o ? v(d?.events, o.events) : void 0
+        members: M(c?.members, r.members),
+        events: "events" in r ? p(c?.events, r.events) : void 0
       };
-      (m !== void 0 || c.members !== void 0 || c.events !== void 0) && t.push(c);
-    } else m !== void 0 && t.push({
-      kind: o.kind,
-      name: o.name,
-      deprecated: m,
+      (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,
+      deprecated: v,
       added: void 0,
       removed: void 0
     });
   }
-  if (n)
-    for (const [i] of e.values())
-      t.push({
-        kind: i.kind,
-        name: i.name,
-        tagName: i.tagName,
+  if (a)
+    for (const [s] of e.values())
+      n.push({
+        kind: s.kind,
+        name: s.name,
+        tagName: s.tagName,
         members: void 0,
         removed: !0,
         added: void 0,
-        deprecated: void 0
+        deprecated: s.deprecated
       });
-  if (t.length !== 0)
+  if (n.length !== 0)
     return {
-      path: a.path,
-      declarations: t
+      path: o.path,
+      declarations: n
     };
 }
-function h(r) {
-  const a = /* @__PURE__ */ new Map();
-  for (let n = 0; n < r.length; ++n) {
-    const t = r[n], e = t.tagName ?? t.name ?? t.kind, s = a.get(e);
-    s === void 0 ? a.set(e, [t]) : s.push(t);
+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));
+  }
+  return o;
+}
+function P(i) {
+  if (i !== void 0) {
+    for (let o = 0; o < i.length; ++o)
+      if (i[o].name === "internal")
+        return !0;
   }
-  return a;
+  return !1;
 }
-function v(r, a) {
-  const n = h(r ?? []), t = [];
-  if (a !== void 0)
-    for (const e of a)
-      n.get(e.name) === void 0 ? t.push({
+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 && t.push({
+      }) : e.deprecated && n.push({
         name: e.name,
         deprecated: e.deprecated
-      }), n.delete(e.name);
-  for (const [e] of n.values())
-    t.push({
+      }), a.delete(e.name);
+  for (const [e] of a.values())
+    n.push({
       name: e.name,
-      removed: !0
+      removed: !0,
+      deprecated: e.deprecated
     });
-  return t.length ? t : void 0;
+  return n.length ? n : void 0;
 }
-function b(r, a) {
-  const n = h(r ?? []), t = h(a ?? []), e = [];
-  for (const [s, i] of t.entries()) {
-    const o = i.at(-1), p = n.get(s);
-    n.delete(s);
-    const u = (
+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);
+    const l = (
       // Only mark as deprecated if all overloads are deprecated
-      i.length === 1 || i.every((g) => g.deprecated !== void 0) ? o.deprecated : void 0
-    ), f = s === "constructor" || s === "call-signature" ? void 0 : s;
-    u ? e.push({
-      kind: o.kind,
-      name: f,
-      deprecated: u
-    }) : p === void 0 && e.push({
-      kind: o.kind,
-      name: f,
+      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,
+      name: m,
+      deprecated: l
+    }) : d === void 0 && e.push({
+      kind: r.kind,
+      name: m,
       added: !0
     });
   }
-  for (const [s, [i]] of n.entries()) {
-    const o = s === "constructor" || s === "call-signature" ? void 0 : s;
+  for (const [t, [s]] of a.entries()) {
+    const r = t === "constructor" || t === "call-signature" ? void 0 : t;
     e.push({
-      kind: i.kind,
-      name: o,
-      removed: !0
+      kind: s.kind,
+      name: r,
+      removed: !0,
+      deprecated: s.deprecated
     });
   }
   return e.length ? e : void 0;
 }
 export {
-  M as diffApiJson
+  N as diffApiJson
 };