@arcgis/api-extractor 5.1.0-next.1 → 5.1.0-next.10

package/dist/{ApiExtractor-DByayOhi.js → ApiExtractor-BsCYv8eU.js}

@@ -1,5 +1,5 @@
-import { l as H, a as se, e as Re, p as fe } from "./typeScript-D4_nAmBW.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-Btg0KdqM.js";
+import { l as H, a as se, e as Re, p as fe } from "./typeScript-C42JuOpR.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-DZJ5CvpK.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,142 @@
+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], U = s.path.split("/");
+    let y = U;
+    const x = U.at(-1);
+    s.declarations.length === 1 && s.declarations[0].name === x && (y = U.slice(0, -1));
+    let w = o;
+    for (const $ of y)
+      w = L(w, $);
+    for (let $ = 0; $ < s.declarations.length; ++$) {
+      const l = s.declarations[$], S = B(l), O = l.removed === !0 ? void 0 : g(t, s.path, l, void 0), k = j(l), D = { label: S, viewUrl: O, change: k }, u = l, f = [];
+      if (u.members !== void 0)
+        for (let d = 0; d < u.members.length; ++d) {
+          const i = u.members[d], m = b(i.kind, i);
+          if (m === void 0)
+            continue;
+          const v = F(i), a = i.removed === !0 ? void 0 : g(
+            t,
+            s.path,
+            l,
+            "name" in i ? i.name : `${l.name}Properties`
+          );
+          f.push({ label: v, viewUrl: a, change: m });
+        }
+      if (u.events !== void 0)
+        for (let d = 0; d < u.events.length; ++d) {
+          const i = u.events[d], m = b("event", i);
+          if (m === void 0)
+            continue;
+          const v = i.removed === !0 ? void 0 : g(t, s.path, l, i.name);
+          f.push({ label: `@${i.name}`, viewUrl: v, change: m });
+        }
+      if (typeof u.tagName == "string") {
+        const d = u.slots, i = u.cssParts, m = u.cssProperties, v = u.cssStates;
+        if (d !== void 0)
+          for (let a = 0; a < d.length; ++a) {
+            const r = d[a], h = b("slot", r);
+            if (h === void 0)
+              continue;
+            const p = r.removed === !0 ? void 0 : g(t, s.path, l, r.name);
+            f.push({ label: r.name, viewUrl: p, change: h });
+          }
+        if (i !== void 0)
+          for (let a = 0; a < i.length; ++a) {
+            const r = i[a], h = b("css part", r);
+            if (h === void 0)
+              continue;
+            const p = r.removed === !0 ? void 0 : g(t, s.path, l, r.name);
+            f.push({ label: r.name, viewUrl: p, change: h });
+          }
+        if (m !== void 0)
+          for (let a = 0; a < m.length; ++a) {
+            const r = m[a], h = b("css property", r);
+            if (h === void 0)
+              continue;
+            const p = r.removed === !0 ? void 0 : g(t, s.path, l, r.name);
+            f.push({ label: r.name, viewUrl: p, change: h });
+          }
+        if (v !== void 0)
+          for (let a = 0; a < v.length; ++a) {
+            const r = v[a], h = b("css state", r);
+            if (h === void 0)
+              continue;
+            const p = r.removed === !0 ? void 0 : g(t, s.path, l, r.name);
+            f.push({ label: r.name, viewUrl: p, change: h });
+          }
+      }
+      f.length > 0 ? E(w, D).members.push(...f) : k !== void 0 && w.members.push(D);
+    }
+  }
+  const c = [];
+  for (const n of o.children.values())
+    M(n, "", c);
+  return c.join(`
+`);
+}
+function L(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 b(t, e);
+}
+function b(e, t) {
+  const { added: o, removed: c, deprecated: n } = t;
+  if (c) {
+    const s = `**removed** ${e}`;
+    return typeof n == "string" ? `${s} - deprecated ${N(n)}` : s;
+  }
+  if (n)
+    return typeof n == "string" ? `**deprecated** ${e} ${N(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 g(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 = L(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 N(e) {
+  return e.split(`
+`)[0];
+}
+function M(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())
+    M(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,260 @@
-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(n, s) {
+  if (n.compiler?.name !== "@arcgis/core:manual" || n.compiler?.version !== "4.34")
+    return;
+  const o = {};
+  return n.modules.forEach((e) => {
+    o[e.path] = e;
+  }), {
+    ...s,
+    modules: s.modules.filter((e) => {
+      const r = o[e.path];
+      return e.declarations = e.declarations.filter((a) => {
+        if (a.kind === "mixin")
+          return !1;
+        if (a.kind === "interface") {
+          const i = r?.declarations.find(
+            (d) => d.name === a.name && d.kind === "interface"
+          );
+          return a.members = void 0, i !== void 0;
+        }
+        return !0;
+      }), e.declarations.length > 0;
+    })
+  };
+}
+function A(n) {
+  const s = /* @__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"
+  ]), o = n.modules.filter((t) => s.has(t.path) ? !1 : (t.declarations = t.declarations.filter((e) => e.kind === "class" ? e.members === void 0 ? !0 : (e.members = e.members.filter((r) => !(r.kind === "constructor" || r.kind === "call-signature" || P.has(r.name))), e.members.length > 0) : !0), t.declarations.length > 0));
+  return { ...n, modules: o };
+}
+const P = /* @__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(n, s) {
+  const o = w(n, s), t = o ?? s, e = n.compiler?.version.startsWith("4.") === !0 && t.compiler?.version.startsWith("4.") !== !0, r = new Map(
+    n.modules.map((d) => [
+      b(d, e),
+      d
+    ])
+  ), a = [];
+  for (const d of t.modules) {
+    const l = r.get(d.path), m = y(l, d, !0);
+    m !== void 0 && a.push(m), r.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 r.values()) {
+    const l = y(
+      void 0,
+      e ? { ...d, path: b(d, e) } : d,
+      !1
+    );
+    l !== void 0 && a.push(l);
   }
-  return { modules: t };
+  const i = { modules: a };
+  return o === void 0 ? i : A(i);
 }
-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) {
+function b(n, s) {
+  return s ? n.declarations?.[0]?.importPath ?? n.path : n.path;
+}
+function y(n, s, o) {
+  const t = [], e = h(n?.declarations ?? []), r = h(s.declarations ?? []);
+  for (const a of r.values()) {
+    const i = a.at(-1), d = i.tagName, l = d ?? i.name, m = e.get(l);
+    e.delete(l);
+    const g = m === void 0 && !o ? !0 : void 0, f = (
+      // Only mark as deprecated if all overloads are deprecated
+      a.length === 1 || a.every((c) => c.deprecated !== void 0) ? i.deprecated : void 0
+    ), k = !f && m === void 0 && o ? !0 : void 0;
+    if (g || k) {
       t.push({
-        kind: o.kind,
-        name: o.name,
-        tagName: p,
+        kind: i.kind,
+        name: i.name,
+        tagName: d,
         members: void 0,
         removed: g,
-        added: D,
-        deprecated: m
+        added: k,
+        deprecated: f
       });
       continue;
-    } else if (!n)
+    } else if (!o)
       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 = i, u = m?.[0], v = {
+        kind: c.kind,
+        name: c.name,
+        tagName: c.tagName,
+        deprecated: f,
         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,
+      (f !== void 0 || v.members !== void 0 || v.events !== void 0 || v.slots !== void 0 || v.cssParts !== void 0 || v.cssProperties !== void 0 || v.cssStates !== void 0) && t.push(v);
+    } else if (i.kind === "class" || i.kind === "interface" || i.kind === "mixin") {
+      const c = m?.[0], u = {
+        kind: i.kind,
+        name: i.name,
+        deprecated: f,
         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, i.members),
+        events: "events" in i ? p(c?.events, i.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,
+      (f !== void 0 || u.members !== void 0 || u.events !== void 0) && t.push(u);
+    } else f !== void 0 && t.push({
+      kind: i.kind,
+      name: i.name,
+      deprecated: f,
       added: void 0,
       removed: void 0
     });
   }
-  if (n)
-    for (const [i] of e.values())
+  if (o)
+    for (const [a] of e.values())
       t.push({
-        kind: i.kind,
-        name: i.name,
-        tagName: i.tagName,
+        kind: a.kind,
+        name: a.name,
+        tagName: a.tagName,
         members: void 0,
         removed: !0,
         added: void 0,
-        deprecated: void 0
+        deprecated: a.deprecated
       });
   if (t.length !== 0)
     return {
-      path: a.path,
+      path: s.path,
       declarations: t
     };
 }
-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(n) {
+  const s = /* @__PURE__ */ new Map();
+  for (let o = 0; o < n.length; ++o) {
+    const t = n[o], e = t.tagName ?? t.name ?? t.kind, r = s.get(e);
+    x(t.docsTags) || (r === void 0 ? s.set(e, [t]) : r.push(t));
+  }
+  return s;
+}
+function x(n) {
+  if (n !== void 0) {
+    for (let s = 0; s < n.length; ++s)
+      if (n[s].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(n, s) {
+  const o = h(n ?? []), t = [];
+  if (s !== void 0)
+    for (const e of s)
+      o.get(e.name) === void 0 ? t.push({
         name: e.name,
         added: !0
       }) : e.deprecated && t.push({
         name: e.name,
         deprecated: e.deprecated
-      }), n.delete(e.name);
-  for (const [e] of n.values())
+      }), o.delete(e.name);
+  for (const [e] of o.values())
     t.push({
       name: e.name,
-      removed: !0
+      removed: !0,
+      deprecated: e.deprecated
     });
   return t.length ? t : 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(n, s) {
+  const o = h(n ?? []), t = h(s ?? []), e = [];
+  for (const [r, a] of t.entries()) {
+    const i = a.at(-1), d = o.get(r);
+    o.delete(r);
+    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,
+      a.length === 1 || a.every((g) => g.deprecated !== void 0) ? i.deprecated : void 0
+    ), m = r === "constructor" || r === "call-signature" ? void 0 : r;
+    l ? e.push({
+      kind: i.kind,
+      name: m,
+      deprecated: l
+    }) : d === void 0 && e.push({
+      kind: i.kind,
+      name: m,
       added: !0
     });
   }
-  for (const [s, [i]] of n.entries()) {
-    const o = s === "constructor" || s === "call-signature" ? void 0 : s;
+  for (const [r, [a]] of o.entries()) {
+    const i = r === "constructor" || r === "call-signature" ? void 0 : r;
     e.push({
-      kind: i.kind,
-      name: o,
-      removed: !0
+      kind: a.kind,
+      name: i,
+      removed: !0,
+      deprecated: a.deprecated
     });
   }
   return e.length ? e : void 0;
 }
 export {
-  M as diffApiJson
+  N as diffApiJson
 };

package/dist/diff/types.d.ts

@@ -26,8 +26,9 @@ export interface ApiDiffBase {
    */
   added?: true;
   /**
-   * Whether this declaration is deprecated in the new api.json, regardless of
-   * whether it was deprecated in the old api.json.
+   * Whether this declaration is deprecated in the new api.json. If declaration
+   * was removed, but was deprecated in the old api.json, this will show the old
+   * deprecation message as it points at the replacement API.
    * If the value is a string, it's the reason for the deprecation.
    * Deprecated takes precedence over added.
    *