@mnaoumov/typescript-dev-toolkit 1.3.0 → 2.0.0

package/dist/lib/cjs/docs-site/api-doc-type-merging.cjs

@@ -0,0 +1,157 @@
+/*
+THIS IS A GENERATED/BUNDLED FILE BY ESBUILD
+if you want to view the source, please visit the github repository of this plugin
+*/
+(function () {
+function ensureBrowserProcess() {
+  const browserProcess = {
+    browser: true,
+    cwd() {
+      return '/';
+    },
+    env: {},
+    platform: 'android'
+  };
+
+  const existingProcess = globalThis.process;
+
+  if (!existingProcess) {
+    globalThis.process = browserProcess;
+    return;
+  }
+
+  if (existingProcess.versions?.node) {
+    return;
+  }
+
+  const existingProcessRecord = existingProcess;
+
+  for (const [key, value] of Object.entries(browserProcess)) {
+    existingProcessRecord[key] ??= value;
+  }
+
+  existingProcessRecord['browser'] = true;
+}
+
+ensureBrowserProcess();
+})();
+
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var api_doc_type_merging_exports = {};
+__export(api_doc_type_merging_exports, {
+  buildTypeParameterMap: () => buildTypeParameterMap,
+  parseTypeArguments: () => parseTypeArguments,
+  resolveInheritedMembers: () => resolveInheritedMembers,
+  substituteMemberTypes: () => substituteMemberTypes,
+  substituteTypeParams: () => substituteTypeParams
+});
+module.exports = __toCommonJS(api_doc_type_merging_exports);
+var import_type_guards = require('@mnaoumov/typescript-lib/type-guards');
+var import_api_doc_link_rendering = require('./api-doc-link-rendering.cjs');
+function buildTypeParameterMap(baseInfo, typeArguments) {
+  const mapping = /* @__PURE__ */ new Map();
+  const count = Math.min(baseInfo.typeParameters.length, typeArguments.length);
+  for (let index = 0; index < count; index++) {
+    const parameter = (0, import_type_guards.ensureNonNullable)(baseInfo.typeParameters[index]);
+    const argument = (0, import_type_guards.ensureNonNullable)(typeArguments[index]);
+    const bareParameter = parameter.replace(/\s+extends\s+.*$/, "");
+    mapping.set(bareParameter, argument);
+  }
+  return mapping;
+}
+function parseTypeArguments(baseTypeName) {
+  const openIndex = baseTypeName.indexOf("<");
+  if (openIndex === -1) {
+    return [];
+  }
+  const inner = baseTypeName.slice(openIndex + 1, -1);
+  const $arguments = [];
+  let depth = 0;
+  let current = "";
+  for (const ch of inner) {
+    if (ch === "<") {
+      depth++;
+      current += ch;
+    } else if (ch === ">") {
+      depth--;
+      current += ch;
+    } else if (ch === "," && depth === 0) {
+      $arguments.push(current.trim());
+      current = "";
+    } else {
+      current += ch;
+    }
+  }
+  if (current.trim()) {
+    $arguments.push(current.trim());
+  }
+  return $arguments;
+}
+function resolveInheritedMembers(types) {
+  for (const [, info] of types) {
+    for (const baseTypeName of [...info.baseTypes, ...info.implementsTypes]) {
+      const cleanBase = baseTypeName.replace(/<.*>$/, "").trim();
+      const baseInfo = (0, import_api_doc_link_rendering.findType)(types, cleanBase, info.namespace);
+      if (!baseInfo) {
+        continue;
+      }
+      const typeArguments = parseTypeArguments(baseTypeName);
+      const typeParameterMap = buildTypeParameterMap(baseInfo, typeArguments);
+      for (const property of baseInfo.properties) {
+        if (info.properties.every((p) => p.name !== property.name)) {
+          info.properties.push(substituteMemberTypes({ ...property, inheritedFrom: baseInfo.name }, typeParameterMap));
+        }
+      }
+      for (const method of baseInfo.methods) {
+        const hasOwnMethod = info.methods.some((m) => m.name === method.name && m.signature === method.signature);
+        const hasInheritedMethod = info.methods.some((m) => m.inheritedFrom === baseInfo.name && m.overloadKey === method.overloadKey);
+        if (!hasOwnMethod && !hasInheritedMethod) {
+          info.methods.push(substituteMemberTypes({ ...method, inheritedFrom: baseInfo.name }, typeParameterMap));
+        }
+      }
+    }
+  }
+}
+function substituteMemberTypes(member, mapping) {
+  return mapping.size === 0 ? member : {
+    ...member,
+    parameters: member.parameters.map((p) => ({
+      ...p,
+      type: substituteTypeParams(p.type, mapping)
+    })),
+    returnType: substituteTypeParams(member.returnType, mapping),
+    signature: substituteTypeParams(member.signature, mapping),
+    type: substituteTypeParams(member.type, mapping)
+  };
+}
+function substituteTypeParams(typeText, mapping) {
+  return mapping.size === 0 ? typeText : typeText.replaceAll(/\b(?<typeName>[a-zA-Z][a-zA-Z0-9]*)\b/g, (match) => {
+    return mapping.get(match) ?? match;
+  });
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  buildTypeParameterMap,
+  parseTypeArguments,
+  resolveInheritedMembers,
+  substituteMemberTypes,
+  substituteTypeParams
+});
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJzb3VyY2VzIjpbIi4uLy4uLy4uLy4uL3NyYy9kb2NzLXNpdGUvYXBpLWRvYy10eXBlLW1lcmdpbmcudHMiXSwic291cmNlc0NvbnRlbnQiOlsiLyoqXG4gKiBAZmlsZVxuICpcbiAqIEluaGVyaXRhbmNlIHJlc29sdXRpb246IGNvcGllcyBpbmhlcml0ZWQgbWVtYmVycyBvbnRvIHN1YnR5cGVzLCBzdWJzdGl0dXRpbmcgZ2VuZXJpYyB0eXBlIGFyZ3MuXG4gKlxuICogKEEgZG9jdW1lbnRlZCBwYWNrYWdlIGlzIGEgbm9ybWFsIGxpYnJhcnksIG5vdCBhbiBhdWdtZW50YXRpb24gb2YgYW5vdGhlciBwYWNrYWdlJ3MgZGVjbGFyYXRpb25zLCBzbyB0aGVyZSBpcyBub1xuICogb2ZmaWNpYWwtdnMtdW5vZmZpY2lhbCBtZXJnZSBtYWNoaW5lcnkgaGVyZSDigJQgb25seSB0aGUgZ2VuZXJpYyBpbmhlcml0YW5jZSBoZWxwZXJzLilcbiAqL1xuXG5pbXBvcnQgeyBlbnN1cmVOb25OdWxsYWJsZSB9IGZyb20gJ0BtbmFvdW1vdi90eXBlc2NyaXB0LWxpYi90eXBlLWd1YXJkcyc7XG5cbmltcG9ydCB0eXBlIHtcbiAgTWVtYmVySW5mbyxcbiAgVHlwZUluZm9cbn0gZnJvbSAnLi9hcGktZG9jLXR5cGVzLnRzJztcblxuaW1wb3J0IHsgZmluZFR5cGUgfSBmcm9tICcuL2FwaS1kb2MtbGluay1yZW5kZXJpbmcudHMnO1xuXG4vKipcbiAqIEJ1aWxkIGEgbWFwcGluZyBmcm9tIHBhcmVudCB0eXBlIHBhcmFtZXRlciBuYW1lcyB0byBjb25jcmV0ZSB0eXBlIGFyZ3VtZW50cy5cbiAqIEUuZy4sIHBhcmVudCBoYXMgYHR5cGVQYXJhbWV0ZXJzOiBbJ0luc3RhbmNlIGV4dGVuZHMgQmFzZUluc3RhbmNlJ11gIGFuZFxuICogY2hpbGQgZXh0ZW5kcyBgUGFyZW50PENhbnZhc1BsdWdpbkluc3RhbmNlPmAg4oaSIGB7SW5zdGFuY2U6ICdDYW52YXNQbHVnaW5JbnN0YW5jZSd9YFxuICpcbiAqIEBwYXJhbSBiYXNlSW5mbyAtIFRoZSBiYXNlIHR5cGUuXG4gKiBAcGFyYW0gdHlwZUFyZ3VtZW50cyAtIFRoZSB0eXBlIGFyZ3VtZW50cyB0aGUgYmFzZSB0eXBlIGlzIGdpdmVuLlxuICogQHJldHVybnMgVGhlIHBhcmFtZXRlciBuYW1lcyBtYXBwZWQgdG8gdGhlaXIgYXJndW1lbnRzLlxuICovXG5leHBvcnQgZnVuY3Rpb24gYnVpbGRUeXBlUGFyYW1ldGVyTWFwKGJhc2VJbmZvOiBUeXBlSW5mbywgdHlwZUFyZ3VtZW50czogc3RyaW5nW10pOiBNYXA8c3RyaW5nLCBzdHJpbmc+IHtcbiAgY29uc3QgbWFwcGluZyA9IG5ldyBNYXA8c3RyaW5nLCBzdHJpbmc+KCk7XG4gIGNvbnN0IGNvdW50ID0gTWF0aC5taW4oYmFzZUluZm8udHlwZVBhcmFtZXRlcnMubGVuZ3RoLCB0eXBlQXJndW1lbnRzLmxlbmd0aCk7XG4gIGZvciAobGV0IGluZGV4ID0gMDsgaW5kZXggPCBjb3VudDsgaW5kZXgrKykge1xuICAgIC8vIEJvdGggbGlzdHMgYXJlIGxvbmdlciB0aGFuIGBpbmRleGAuXG4gICAgY29uc3QgcGFyYW1ldGVyID0gZW5zdXJlTm9uTnVsbGFibGUoYmFzZUluZm8udHlwZVBhcmFtZXRlcnNbaW5kZXhdKTtcbiAgICBjb25zdCBhcmd1bWVudCA9IGVuc3VyZU5vbk51bGxhYmxlKHR5cGVBcmd1bWVudHNbaW5kZXhdKTtcbiAgICBjb25zdCBiYXJlUGFyYW1ldGVyID0gcGFyYW1ldGVyLnJlcGxhY2UoL1xccytleHRlbmRzXFxzKy4qJC8sICcnKTtcbiAgICBtYXBwaW5nLnNldChiYXJlUGFyYW1ldGVyLCBhcmd1bWVudCk7XG4gIH1cbiAgcmV0dXJuIG1hcHBpbmc7XG59XG5cbi8qKlxuICogUGFyc2UgZ2VuZXJpYyB0eXBlIGFyZ3VtZW50cyBmcm9tIGEgYmFzZSB0eXBlIGV4cHJlc3Npb24uXG4gKiBFLmcuLCBgSW50ZXJuYWxQbHVnaW48Q2FudmFzUGx1Z2luSW5zdGFuY2U+YCDihpIgYFsnQ2FudmFzUGx1Z2luSW5zdGFuY2UnXWBcbiAqIEhhbmRsZXMgbmVzdGVkIGFuZ2xlIGJyYWNrZXRzOiBgRm9vPEJhcjxCYXo+LCBRdXg+YCDihpIgYFsnQmFyPEJhej4nLCAnUXV4J11gXG4gKlxuICogQHBhcmFtIGJhc2VUeXBlTmFtZSAtIFRoZSBiYXNlIHR5cGUgZXhwcmVzc2lvbiwgZS5nLiBgRm9vPEJhciwgQmF6PmAuXG4gKiBAcmV0dXJucyBUaGUgdHlwZSBhcmd1bWVudHMuXG4gKi9cbmV4cG9ydCBmdW5jdGlvbiBwYXJzZVR5cGVBcmd1bWVudHMoYmFzZVR5cGVOYW1lOiBzdHJpbmcpOiBzdHJpbmdbXSB7XG4gIGNvbnN0IG9wZW5JbmRleCA9IGJhc2VUeXBlTmFtZS5pbmRleE9mKCc8Jyk7XG4gIGlmIChvcGVuSW5kZXggPT09IC0xKSB7XG4gICAgcmV0dXJuIFtdO1xuICB9XG4gIGNvbnN0IGlubmVyID0gYmFzZVR5cGVOYW1lLnNsaWNlKG9wZW5JbmRleCArIDEsIC0xKTtcbiAgY29uc3QgJGFyZ3VtZW50czogc3RyaW5nW10gPSBbXTtcbiAgbGV0IGRlcHRoID0gMDtcbiAgbGV0IGN1cnJlbnQgPSAnJztcbiAgZm9yIChjb25zdCBjaCBvZiBpbm5lcikge1xuICAgIGlmIChjaCA9PT0gJzwnKSB7XG4gICAgICBkZXB0aCsrO1xuICAgICAgY3VycmVudCArPSBjaDtcbiAgICB9IGVsc2UgaWYgKGNoID09PSAnPicpIHtcbiAgICAgIGRlcHRoLS07XG4gICAgICBjdXJyZW50ICs9IGNoO1xuICAgIH0gZWxzZSBpZiAoY2ggPT09ICcsJyAmJiBkZXB0aCA9PT0gMCkge1xuICAgICAgJGFyZ3VtZW50cy5wdXNoKGN1cnJlbnQudHJpbSgpKTtcbiAgICAgIGN1cnJlbnQgPSAnJztcbiAgICB9IGVsc2Uge1xuICAgICAgY3VycmVudCArPSBjaDtcbiAgICB9XG4gIH1cbiAgaWYgKGN1cnJlbnQudHJpbSgpKSB7XG4gICAgJGFyZ3VtZW50cy5wdXNoKGN1cnJlbnQudHJpbSgpKTtcbiAgfVxuICByZXR1cm4gJGFyZ3VtZW50cztcbn1cblxuLyoqXG4gKiBDb3BpZXMgZXZlcnkgaW5oZXJpdGVkIG1lbWJlciBvbnRvIGl0cyBzdWJ0eXBlcywgc3Vic3RpdHV0aW5nIHRoZSB0eXBlIGFyZ3VtZW50cyB0aGUgc3VidHlwZSBwYXNzZXMuXG4gKlxuICogQHBhcmFtIHR5cGVzIC0gVGhlIGRvY3VtZW50ZWQgdHlwZXMsIGtleWVkIGJ5IHF1YWxpZmllZCBpZC5cbiAqL1xuZXhwb3J0IGZ1bmN0aW9uIHJlc29sdmVJbmhlcml0ZWRNZW1iZXJzKHR5cGVzOiBNYXA8c3RyaW5nLCBUeXBlSW5mbz4pOiB2b2lkIHtcbiAgZm9yIChjb25zdCBbLCBpbmZvXSBvZiB0eXBlcykge1xuICAgIGZvciAoY29uc3QgYmFzZVR5cGVOYW1lIG9mIFsuLi5pbmZvLmJhc2VUeXBlcywgLi4uaW5mby5pbXBsZW1lbnRzVHlwZXNdKSB7XG4gICAgICBjb25zdCBjbGVhbkJhc2UgPSBiYXNlVHlwZU5hbWUucmVwbGFjZSgvPC4qPiQvLCAnJykudHJpbSgpO1xuICAgICAgY29uc3QgYmFzZUluZm8gPSBmaW5kVHlwZSh0eXBlcywgY2xlYW5CYXNlLCBpbmZvLm5hbWVzcGFjZSk7XG4gICAgICBpZiAoIWJhc2VJbmZvKSB7XG4gICAgICAgIGNvbnRpbnVlO1xuICAgICAgfVxuXG4gICAgICBjb25zdCB0eXBlQXJndW1lbnRzID0gcGFyc2VUeXBlQXJndW1lbnRzKGJhc2VUeXBlTmFtZSk7XG4gICAgICBjb25zdCB0eXBlUGFyYW1ldGVyTWFwID0gYnVpbGRUeXBlUGFyYW1ldGVyTWFwKGJhc2VJbmZvLCB0eXBlQXJndW1lbnRzKTtcblxuICAgICAgZm9yIChjb25zdCBwcm9wZXJ0eSBvZiBiYXNlSW5mby5wcm9wZXJ0aWVzKSB7XG4gICAgICAgIGlmIChpbmZvLnByb3BlcnRpZXMuZXZlcnkoKHApID0+IHAubmFtZSAhPT0gcHJvcGVydHkubmFtZSkpIHtcbiAgICAgICAgICBpbmZvLnByb3BlcnRpZXMucHVzaChzdWJzdGl0dXRlTWVtYmVyVHlwZXMoeyAuLi5wcm9wZXJ0eSwgaW5oZXJpdGVkRnJvbTogYmFzZUluZm8ubmFtZSB9LCB0eXBlUGFyYW1ldGVyTWFwKSk7XG4gICAgICAgIH1cbiAgICAgIH1cblxuICAgICAgZm9yIChjb25zdCBtZXRob2Qgb2YgYmFzZUluZm8ubWV0aG9kcykge1xuICAgICAgICBjb25zdCBoYXNPd25NZXRob2QgPSBpbmZvLm1ldGhvZHMuc29tZSgobSkgPT4gbS5uYW1lID09PSBtZXRob2QubmFtZSAmJiBtLnNpZ25hdHVyZSA9PT0gbWV0aG9kLnNpZ25hdHVyZSk7XG4gICAgICAgIGNvbnN0IGhhc0luaGVyaXRlZE1ldGhvZCA9IGluZm8ubWV0aG9kcy5zb21lKChtKSA9PiBtLmluaGVyaXRlZEZyb20gPT09IGJhc2VJbmZvLm5hbWUgJiYgbS5vdmVybG9hZEtleSA9PT0gbWV0aG9kLm92ZXJsb2FkS2V5KTtcbiAgICAgICAgaWYgKCFoYXNPd25NZXRob2QgJiYgIWhhc0luaGVyaXRlZE1ldGhvZCkge1xuICAgICAgICAgIGluZm8ubWV0aG9kcy5wdXNoKHN1YnN0aXR1dGVNZW1iZXJUeXBlcyh7IC4uLm1ldGhvZCwgaW5oZXJpdGVkRnJvbTogYmFzZUluZm8ubmFtZSB9LCB0eXBlUGFyYW1ldGVyTWFwKSk7XG4gICAgICAgIH1cbiAgICAgIH1cbiAgICB9XG4gIH1cbn1cblxuLyoqXG4gKiBBcHBseSB0eXBlIHBhcmFtZXRlciBzdWJzdGl0dXRpb24gdG8gYWxsIHR5cGUtYmVhcmluZyBmaWVsZHMgb2YgYSBtZW1iZXJcbiAqXG4gKiBAcGFyYW0gbWVtYmVyIC0gVGhlIG1lbWJlci5cbiAqIEBwYXJhbSBtYXBwaW5nIC0gVHlwZSBwYXJhbWV0ZXIgbmFtZXMgbWFwcGVkIHRvIHRoZWlyIGFyZ3VtZW50cy5cbiAqIEByZXR1cm5zIFRoZSBtZW1iZXIgd2l0aCBpdHMgdHlwZXMgc3Vic3RpdHV0ZWQuXG4gKi9cbmV4cG9ydCBmdW5jdGlvbiBzdWJzdGl0dXRlTWVtYmVyVHlwZXMobWVtYmVyOiBNZW1iZXJJbmZvLCBtYXBwaW5nOiBNYXA8c3RyaW5nLCBzdHJpbmc+KTogTWVtYmVySW5mbyB7XG4gIHJldHVybiBtYXBwaW5nLnNpemUgPT09IDBcbiAgICA/IG1lbWJlclxuICAgIDoge1xuICAgICAgLi4ubWVtYmVyLFxuICAgICAgcGFyYW1ldGVyczogbWVtYmVyLnBhcmFtZXRlcnMubWFwKChwKSA9PiAoe1xuICAgICAgICAuLi5wLFxuICAgICAgICB0eXBlOiBzdWJzdGl0dXRlVHlwZVBhcmFtcyhwLnR5cGUsIG1hcHBpbmcpXG4gICAgICB9KSksXG4gICAgICByZXR1cm5UeXBlOiBzdWJzdGl0dXRlVHlwZVBhcmFtcyhtZW1iZXIucmV0dXJuVHlwZSwgbWFwcGluZyksXG4gICAgICBzaWduYXR1cmU6IHN1YnN0aXR1dGVUeXBlUGFyYW1zKG1lbWJlci5zaWduYXR1cmUsIG1hcHBpbmcpLFxuICAgICAgdHlwZTogc3Vic3RpdHV0ZVR5cGVQYXJhbXMobWVtYmVyLnR5cGUsIG1hcHBpbmcpXG4gICAgfTtcbn1cblxuLyoqXG4gKiBTdWJzdGl0dXRlIGdlbmVyaWMgdHlwZSBwYXJhbWV0ZXJzIGluIGEgdHlwZSBzdHJpbmcgdXNpbmcgYSBtYXBwaW5nXG4gKlxuICogQHBhcmFtIHR5cGVUZXh0IC0gVGhlIHR5cGUgdGV4dC5cbiAqIEBwYXJhbSBtYXBwaW5nIC0gVHlwZSBwYXJhbWV0ZXIgbmFtZXMgbWFwcGVkIHRvIHRoZWlyIGFyZ3VtZW50cy5cbiAqIEByZXR1cm5zIFRoZSBzdWJzdGl0dXRlZCB0eXBlIHRleHQuXG4gKi9cbmV4cG9ydCBmdW5jdGlvbiBzdWJzdGl0dXRlVHlwZVBhcmFtcyh0eXBlVGV4dDogc3RyaW5nLCBtYXBwaW5nOiBNYXA8c3RyaW5nLCBzdHJpbmc+KTogc3RyaW5nIHtcbiAgcmV0dXJuIG1hcHBpbmcuc2l6ZSA9PT0gMFxuICAgID8gdHlwZVRleHRcbiAgICA6IHR5cGVUZXh0LnJlcGxhY2VBbGwoL1xcYig/PHR5cGVOYW1lPlthLXpBLVpdW2EtekEtWjAtOV0qKVxcYi9nLCAobWF0Y2gpID0+IHtcbiAgICAgIHJldHVybiBtYXBwaW5nLmdldChtYXRjaCkgPz8gbWF0Y2g7XG4gICAgfSk7XG59XG4iXSwibWFwcGluZ3MiOiI7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7O0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBU0EseUJBQWtDO0FBT2xDLG9DQUF5QjtBQVdsQixTQUFTLHNCQUFzQixVQUFvQixlQUE4QztBQUN0RyxRQUFNLFVBQVUsb0JBQUksSUFBb0I7QUFDeEMsUUFBTSxRQUFRLEtBQUssSUFBSSxTQUFTLGVBQWUsUUFBUSxjQUFjLE1BQU07QUFDM0UsV0FBUyxRQUFRLEdBQUcsUUFBUSxPQUFPLFNBQVM7QUFFMUMsVUFBTSxnQkFBWSxzQ0FBa0IsU0FBUyxlQUFlLEtBQUssQ0FBQztBQUNsRSxVQUFNLGVBQVcsc0NBQWtCLGNBQWMsS0FBSyxDQUFDO0FBQ3ZELFVBQU0sZ0JBQWdCLFVBQVUsUUFBUSxvQkFBb0IsRUFBRTtBQUM5RCxZQUFRLElBQUksZUFBZSxRQUFRO0FBQUEsRUFDckM7QUFDQSxTQUFPO0FBQ1Q7QUFVTyxTQUFTLG1CQUFtQixjQUFnQztBQUNqRSxRQUFNLFlBQVksYUFBYSxRQUFRLEdBQUc7QUFDMUMsTUFBSSxjQUFjLElBQUk7QUFDcEIsV0FBTyxDQUFDO0FBQUEsRUFDVjtBQUNBLFFBQU0sUUFBUSxhQUFhLE1BQU0sWUFBWSxHQUFHLEVBQUU7QUFDbEQsUUFBTSxhQUF1QixDQUFDO0FBQzlCLE1BQUksUUFBUTtBQUNaLE1BQUksVUFBVTtBQUNkLGFBQVcsTUFBTSxPQUFPO0FBQ3RCLFFBQUksT0FBTyxLQUFLO0FBQ2Q7QUFDQSxpQkFBVztBQUFBLElBQ2IsV0FBVyxPQUFPLEtBQUs7QUFDckI7QUFDQSxpQkFBVztBQUFBLElBQ2IsV0FBVyxPQUFPLE9BQU8sVUFBVSxHQUFHO0FBQ3BDLGlCQUFXLEtBQUssUUFBUSxLQUFLLENBQUM7QUFDOUIsZ0JBQVU7QUFBQSxJQUNaLE9BQU87QUFDTCxpQkFBVztBQUFBLElBQ2I7QUFBQSxFQUNGO0FBQ0EsTUFBSSxRQUFRLEtBQUssR0FBRztBQUNsQixlQUFXLEtBQUssUUFBUSxLQUFLLENBQUM7QUFBQSxFQUNoQztBQUNBLFNBQU87QUFDVDtBQU9PLFNBQVMsd0JBQXdCLE9BQW9DO0FBQzFFLGFBQVcsQ0FBQyxFQUFFLElBQUksS0FBSyxPQUFPO0FBQzVCLGVBQVcsZ0JBQWdCLENBQUMsR0FBRyxLQUFLLFdBQVcsR0FBRyxLQUFLLGVBQWUsR0FBRztBQUN2RSxZQUFNLFlBQVksYUFBYSxRQUFRLFNBQVMsRUFBRSxFQUFFLEtBQUs7QUFDekQsWUFBTSxlQUFXLHdDQUFTLE9BQU8sV0FBVyxLQUFLLFNBQVM7QUFDMUQsVUFBSSxDQUFDLFVBQVU7QUFDYjtBQUFBLE1BQ0Y7QUFFQSxZQUFNLGdCQUFnQixtQkFBbUIsWUFBWTtBQUNyRCxZQUFNLG1CQUFtQixzQkFBc0IsVUFBVSxhQUFhO0FBRXRFLGlCQUFXLFlBQVksU0FBUyxZQUFZO0FBQzFDLFlBQUksS0FBSyxXQUFXLE1BQU0sQ0FBQyxNQUFNLEVBQUUsU0FBUyxTQUFTLElBQUksR0FBRztBQUMxRCxlQUFLLFdBQVcsS0FBSyxzQkFBc0IsRUFBRSxHQUFHLFVBQVUsZUFBZSxTQUFTLEtBQUssR0FBRyxnQkFBZ0IsQ0FBQztBQUFBLFFBQzdHO0FBQUEsTUFDRjtBQUVBLGlCQUFXLFVBQVUsU0FBUyxTQUFTO0FBQ3JDLGNBQU0sZUFBZSxLQUFLLFFBQVEsS0FBSyxDQUFDLE1BQU0sRUFBRSxTQUFTLE9BQU8sUUFBUSxFQUFFLGNBQWMsT0FBTyxTQUFTO0FBQ3hHLGNBQU0scUJBQXFCLEtBQUssUUFBUSxLQUFLLENBQUMsTUFBTSxFQUFFLGtCQUFrQixTQUFTLFFBQVEsRUFBRSxnQkFBZ0IsT0FBTyxXQUFXO0FBQzdILFlBQUksQ0FBQyxnQkFBZ0IsQ0FBQyxvQkFBb0I7QUFDeEMsZUFBSyxRQUFRLEtBQUssc0JBQXNCLEVBQUUsR0FBRyxRQUFRLGVBQWUsU0FBUyxLQUFLLEdBQUcsZ0JBQWdCLENBQUM7QUFBQSxRQUN4RztBQUFBLE1BQ0Y7QUFBQSxJQUNGO0FBQUEsRUFDRjtBQUNGO0FBU08sU0FBUyxzQkFBc0IsUUFBb0IsU0FBMEM7QUFDbEcsU0FBTyxRQUFRLFNBQVMsSUFDcEIsU0FDQTtBQUFBLElBQ0EsR0FBRztBQUFBLElBQ0gsWUFBWSxPQUFPLFdBQVcsSUFBSSxDQUFDLE9BQU87QUFBQSxNQUN4QyxHQUFHO0FBQUEsTUFDSCxNQUFNLHFCQUFxQixFQUFFLE1BQU0sT0FBTztBQUFBLElBQzVDLEVBQUU7QUFBQSxJQUNGLFlBQVkscUJBQXFCLE9BQU8sWUFBWSxPQUFPO0FBQUEsSUFDM0QsV0FBVyxxQkFBcUIsT0FBTyxXQUFXLE9BQU87QUFBQSxJQUN6RCxNQUFNLHFCQUFxQixPQUFPLE1BQU0sT0FBTztBQUFBLEVBQ2pEO0FBQ0o7QUFTTyxTQUFTLHFCQUFxQixVQUFrQixTQUFzQztBQUMzRixTQUFPLFFBQVEsU0FBUyxJQUNwQixXQUNBLFNBQVMsV0FBVywwQ0FBMEMsQ0FBQyxVQUFVO0FBQ3pFLFdBQU8sUUFBUSxJQUFJLEtBQUssS0FBSztBQUFBLEVBQy9CLENBQUM7QUFDTDsiLCJuYW1lcyI6W119

package/dist/lib/cjs/docs-site/api-doc-type-merging.d.cts

@@ -0,0 +1,51 @@
+/// <reference path="../library-references.d.cts" />
+/**
+ * @file
+ *
+ * Inheritance resolution: copies inherited members onto subtypes, substituting generic type args.
+ *
+ * (A documented package is a normal library, not an augmentation of another package's declarations, so there is no
+ * official-vs-unofficial merge machinery here — only the generic inheritance helpers.)
+ */
+import type { MemberInfo, TypeInfo } from './api-doc-types.cjs';
+/**
+ * Build a mapping from parent type parameter names to concrete type arguments.
+ * E.g., parent has `typeParameters: ['Instance extends BaseInstance']` and
+ * child extends `Parent<CanvasPluginInstance>` → `{Instance: 'CanvasPluginInstance'}`
+ *
+ * @param baseInfo - The base type.
+ * @param typeArguments - The type arguments the base type is given.
+ * @returns The parameter names mapped to their arguments.
+ */
+export declare function buildTypeParameterMap(baseInfo: TypeInfo, typeArguments: string[]): Map<string, string>;
+/**
+ * Parse generic type arguments from a base type expression.
+ * E.g., `InternalPlugin<CanvasPluginInstance>` → `['CanvasPluginInstance']`
+ * Handles nested angle brackets: `Foo<Bar<Baz>, Qux>` → `['Bar<Baz>', 'Qux']`
+ *
+ * @param baseTypeName - The base type expression, e.g. `Foo<Bar, Baz>`.
+ * @returns The type arguments.
+ */
+export declare function parseTypeArguments(baseTypeName: string): string[];
+/**
+ * Copies every inherited member onto its subtypes, substituting the type arguments the subtype passes.
+ *
+ * @param types - The documented types, keyed by qualified id.
+ */
+export declare function resolveInheritedMembers(types: Map<string, TypeInfo>): void;
+/**
+ * Apply type parameter substitution to all type-bearing fields of a member
+ *
+ * @param member - The member.
+ * @param mapping - Type parameter names mapped to their arguments.
+ * @returns The member with its types substituted.
+ */
+export declare function substituteMemberTypes(member: MemberInfo, mapping: Map<string, string>): MemberInfo;
+/**
+ * Substitute generic type parameters in a type string using a mapping
+ *
+ * @param typeText - The type text.
+ * @param mapping - Type parameter names mapped to their arguments.
+ * @returns The substituted type text.
+ */
+export declare function substituteTypeParams(typeText: string, mapping: Map<string, string>): string;

package/dist/lib/cjs/docs-site/api-doc-types.cjs

@@ -0,0 +1,22 @@
+/*
+THIS IS A GENERATED/BUNDLED FILE BY ESBUILD
+if you want to view the source, please visit the github repository of this plugin
+*/
+
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var api_doc_types_exports = {};
+module.exports = __toCommonJS(api_doc_types_exports);
+//# sourceMappingURL=data:application/json;base64,ewogICJ2ZXJzaW9uIjogMywKICAic291cmNlcyI6IFsiLi4vLi4vLi4vLi4vc3JjL2RvY3Mtc2l0ZS9hcGktZG9jLXR5cGVzLnRzIl0sCiAgInNvdXJjZXNDb250ZW50IjogWyIvKipcbiAqIEBmaWxlXG4gKlxuICogU2hhcmVkIGRhdGEtbW9kZWwgdHlwZXMgZm9yIHRoZSBBUEkgZG9jdW1lbnRhdGlvbiBnZW5lcmF0b3IuXG4gKi9cblxuLyoqXG4gKiBBIGZlbmNlZCBjb2RlIGJsb2NrIG9mIGEgbWFya2Rvd24gdGV4dCwgd2l0aCB0aGUgbGFuZ3VhZ2UgaXRzIGZlbmNlIG5hbWVzIChlbXB0eSB3aGVuIG5vbmUpLlxuICovXG5leHBvcnQgaW50ZXJmYWNlIENvZGVTZWdtZW50IHtcbiAgbGFuZzogc3RyaW5nO1xuICB0ZXh0OiBzdHJpbmc7XG4gIHR5cGU6ICdjb2RlJztcbn1cblxuLyoqXG4gKiBBIGRvY3VtZW50ZWQgZW51bSBtZW1iZXIuXG4gKi9cbmV4cG9ydCBpbnRlcmZhY2UgRW51bU1lbWJlckluZm8ge1xuICBkZXNjcmlwdGlvbjogc3RyaW5nO1xuICBuYW1lOiBzdHJpbmc7XG4gIHZhbHVlOiBzdHJpbmc7XG59XG5cbi8qKlxuICogQSBydW4gb2YgYSBtYXJrZG93biB0ZXh0OiBwcm9zZSwgb3IgYSBmZW5jZWQgY29kZSBibG9jay5cbiAqL1xuZXhwb3J0IHR5cGUgTWFya2Rvd25TZWdtZW50ID0gQ29kZVNlZ21lbnQgfCBQcm9zZVNlZ21lbnQ7XG5cbi8qKlxuICogQSBkb2N1bWVudGVkIHByb3BlcnR5LCBtZXRob2QsIGNvbnN0cnVjdG9yIG9yIGZ1bmN0aW9uIHNpZ25hdHVyZS5cbiAqL1xuZXhwb3J0IGludGVyZmFjZSBNZW1iZXJJbmZvIHtcbiAgZGVzY3JpcHRpb246IHN0cmluZztcbiAgZXhhbXBsZXM6IHN0cmluZ1tdO1xuICBpbmhlcml0ZWRGcm9tOiBzdHJpbmc7XG4gIGlzU3RhdGljOiBib29sZWFuO1xuICBuYW1lOiBzdHJpbmc7XG4gIG92ZXJsb2FkS2V5OiBzdHJpbmc7XG4gIHBhcmFtZXRlcnM6IFBhcmFtZXRlckluZm9bXTtcbiAgcmVtYXJrczogc3RyaW5nO1xuICByZXR1cm5EZXNjcmlwdGlvbjogc3RyaW5nO1xuICByZXR1cm5UeXBlOiBzdHJpbmc7XG4gIHNpZ25hdHVyZTogc3RyaW5nO1xuICBzaW5jZTogc3RyaW5nO1xuICB0eXBlOiBzdHJpbmc7XG59XG5cbi8qKlxuICogQSBnZW5lcmF0ZWQgcGFnZSdzIGNvbnRlbnQgYW5kIHRoZSBwYXRoIGl0IGlzIHdyaXR0ZW4gdG8uXG4gKi9cbmV4cG9ydCBpbnRlcmZhY2UgUGFnZUNvbnRlbnQge1xuICBjb250ZW50OiBzdHJpbmc7XG4gIGZpbGVQYXRoOiBzdHJpbmc7XG59XG5cbi8qKlxuRnJvbnRtYXR0ZXIgc2hhcmVkIGJ5IGV2ZXJ5IGdlbmVyYXRlZCBwYWdlLiBgZGVzY3JpcHRpb25gIGFuZCBgc2lnbmF0dXJlYCBhcmUgb3B0aW9uYWwgYmVjYXVzZSBub3RcbmV2ZXJ5IHBhZ2UgaGFzIHRoZW0sIGJ1dCBhIHBhZ2UgdGhhdCBIQVMgb25lIG11c3QgZW1pdCBpdDogYm90aCBmZWVkIHRoZSBwYWdlJ3MgT0cgY2FyZC5cbiAqL1xuZXhwb3J0IGludGVyZmFjZSBQYWdlRnJvbnRNYXR0ZXIge1xuICBkZXNjcmlwdGlvbj86IHN0cmluZyB8IHVuZGVmaW5lZDtcbiAgc2lkZWJhckxhYmVsOiBzdHJpbmc7XG4gIHNpZ25hdHVyZT86IHN0cmluZyB8IHVuZGVmaW5lZDtcbiAgc2x1Zzogc3RyaW5nO1xuICB0aXRsZTogc3RyaW5nO1xufVxuXG4vKipcbiAqIEEgZG9jdW1lbnRlZCBwYXJhbWV0ZXIuXG4gKi9cbmV4cG9ydCBpbnRlcmZhY2UgUGFyYW1ldGVySW5mbyB7XG4gIGRlc2NyaXB0aW9uOiBzdHJpbmc7XG4gIG5hbWU6IHN0cmluZztcbiAgdHlwZTogc3RyaW5nO1xufVxuXG4vKipcbiAqIEEgcnVuIG9mIG1hcmtkb3duIHByb3NlIGJldHdlZW4gY29kZSBibG9ja3MuXG4gKi9cbmV4cG9ydCBpbnRlcmZhY2UgUHJvc2VTZWdtZW50IHtcbiAgdGV4dDogc3RyaW5nO1xuICB0eXBlOiAncHJvc2UnO1xufVxuXG4vKipcbiAqIFRoZSBwYXJ0IG9mIGEgdHMtbW9ycGggbWV0aG9kIG9yIGZ1bmN0aW9uIHRoZSBkZWNsYXJlZCByZXR1cm4gdHlwZSBpcyByZWFkIGZyb20uXG4gKi9cbmV4cG9ydCBpbnRlcmZhY2UgUmV0dXJuVHlwZVByb3ZpZGVyIHtcbiAgZ2V0UmV0dXJuVHlwZTogKCkgPT4gVGV4dFByb3ZpZGVyO1xuICBnZXRSZXR1cm5UeXBlTm9kZT86ICgpID0+IFRleHRQcm92aWRlciB8IHVuZGVmaW5lZDtcbn1cblxuLyoqXG4gKiBBIGNvbGxhcHNpYmxlIFN0YXJsaWdodCBzaWRlYmFyIGdyb3VwLlxuICovXG5leHBvcnQgaW50ZXJmYWNlIFNpZGViYXJFbnRyeSB7XG4gIGNvbGxhcHNlZDogYm9vbGVhbjtcbiAgaXRlbXM6IChTaWRlYmFyRW50cnkgfCBTaWRlYmFyTGluaylbXTtcbiAgbGFiZWw6IHN0cmluZztcbn1cblxuLyoqXG4gKiBBIFN0YXJsaWdodCBzaWRlYmFyIGxpbmsuXG4gKi9cbmV4cG9ydCBpbnRlcmZhY2UgU2lkZWJhckxpbmsge1xuICBsYWJlbDogc3RyaW5nO1xuICBsaW5rOiBzdHJpbmc7XG59XG5cbi8qKlxuUmVjdXJzaXZlIHRyZWUgbm9kZSBmb3IgYnVpbGRpbmcgdGhlIHNpZGViYXJcbiAqL1xuZXhwb3J0IGludGVyZmFjZSBTaWRlYmFyVHJlZU5vZGUge1xuICBjaGlsZHJlbjogTWFwPHN0cmluZywgU2lkZWJhclRyZWVOb2RlPjtcbiAgdHlwZXM6IFR5cGVJbmZvW107XG59XG5cbi8qKlxuICogQSB0cy1tb3JwaCBub2RlIG9yIHR5cGUgd2hvc2UgdGV4dCBjYW4gYmUgcHJpbnRlZC5cbiAqL1xuZXhwb3J0IGludGVyZmFjZSBUZXh0UHJvdmlkZXIge1xuICBnZXRUZXh0OiAoKSA9PiBzdHJpbmc7XG59XG5cbi8qKlxuICogQSBkb2N1bWVudGVkIGV4cG9ydDogYSBjbGFzcywgaW50ZXJmYWNlLCBlbnVtLCB0eXBlIGFsaWFzLCBmdW5jdGlvbiBvciB2YXJpYWJsZS5cbiAqL1xuZXhwb3J0IGludGVyZmFjZSBUeXBlSW5mbyB7XG4gIGJhc2VUeXBlczogc3RyaW5nW107XG4gIC8qKlxuICBGb3IgY2xhc3NlczogdGhlIGNvbnN0cnVjdG9yIChwdWJsaWMvcHJvdGVjdGVkKSwgaWYgYW55XG4gICAqL1xuICBjb25zdHJ1Y3RvckluZm8/OiBNZW1iZXJJbmZvIHwgdW5kZWZpbmVkO1xuICBkZXNjcmlwdGlvbjogc3RyaW5nO1xuICAvKipcbiAgRm9yIGVudW1zOiB0aGUgZW51bSBtZW1iZXJzXG4gICAqL1xuICBlbnVtTWVtYmVyczogRW51bU1lbWJlckluZm9bXTtcbiAgZXhhbXBsZXM6IHN0cmluZ1tdO1xuICAvKipcbiAgRm9yIGNsYXNzZXM6IHR5cGVzIGluIHRoZSBgaW1wbGVtZW50c2AgY2xhdXNlXG4gICAqL1xuICBpbXBsZW1lbnRzVHlwZXM6IHN0cmluZ1tdO1xuICBraW5kOiAnY2xhc3MnIHwgJ2VudW0nIHwgJ2Z1bmN0aW9uJyB8ICdpbnRlcmZhY2UnIHwgJ3R5cGUnIHwgJ3ZhcmlhYmxlJztcbiAgbWV0aG9kczogTWVtYmVySW5mb1tdO1xuICBuYW1lOiBzdHJpbmc7XG4gIG5hbWVzcGFjZTogc3RyaW5nO1xuICBwcm9wZXJ0aWVzOiBNZW1iZXJJbmZvW107XG4gIHJlbWFya3M6IHN0cmluZztcbiAgLyoqXG4gIEZvciB0eXBlIGFsaWFzZXM6IHRoZSByaWdodC1oYW5kLXNpZGUgdHlwZSB0ZXh0XG4gICAqL1xuICB0eXBlQWxpYXNUZXh0Pzogc3RyaW5nO1xuICB0eXBlUGFyYW1ldGVyczogc3RyaW5nW107XG4gIC8qKlxuICBGb3IgdmFyaWFibGVzOiB0aGUgZGVjbGFyYXRpb24ga2V5d29yZCAobGV0L2NvbnN0L3ZhcilcbiAgICovXG4gIHZhcmlhYmxlS2V5d29yZD86IHN0cmluZztcbiAgLyoqXG4gIEZvciB2YXJpYWJsZXM6IHRoZSB0eXBlIGFubm90YXRpb25cbiAgICovXG4gIHZhcmlhYmxlVHlwZT86IHN0cmluZztcbn1cblxuLyoqXG4gKiBBbiBvYmplY3QgZW50cnkgb2YgdGhlIGB0eXBlZG9jLXBsdWdpbi1tZG4tbGlua3NgIFdlYiBBUEkgZGF0YS5cbiAqL1xuZXhwb3J0IGludGVyZmFjZSBXZWJBcGlFbnRyeSB7XG4gIHVybDogc3RyaW5nO1xufVxuIl0sCiAgIm1hcHBpbmdzIjogIjs7Ozs7Ozs7Ozs7Ozs7Ozs7OztBQUFBO0FBQUE7IiwKICAibmFtZXMiOiBbXQp9Cg==

package/dist/lib/cjs/docs-site/api-doc-types.d.cts

@@ -0,0 +1,157 @@
+/// <reference path="../library-references.d.cts" />
+/**
+ * @file
+ *
+ * Shared data-model types for the API documentation generator.
+ */
+/**
+ * A fenced code block of a markdown text, with the language its fence names (empty when none).
+ */
+export interface CodeSegment {
+    lang: string;
+    text: string;
+    type: 'code';
+}
+/**
+ * A documented enum member.
+ */
+export interface EnumMemberInfo {
+    description: string;
+    name: string;
+    value: string;
+}
+/**
+ * A run of a markdown text: prose, or a fenced code block.
+ */
+export type MarkdownSegment = CodeSegment | ProseSegment;
+/**
+ * A documented property, method, constructor or function signature.
+ */
+export interface MemberInfo {
+    description: string;
+    examples: string[];
+    inheritedFrom: string;
+    isStatic: boolean;
+    name: string;
+    overloadKey: string;
+    parameters: ParameterInfo[];
+    remarks: string;
+    returnDescription: string;
+    returnType: string;
+    signature: string;
+    since: string;
+    type: string;
+}
+/**
+ * A generated page's content and the path it is written to.
+ */
+export interface PageContent {
+    content: string;
+    filePath: string;
+}
+/**
+Frontmatter shared by every generated page. `description` and `signature` are optional because not
+every page has them, but a page that HAS one must emit it: both feed the page's OG card.
+ */
+export interface PageFrontMatter {
+    description?: string | undefined;
+    sidebarLabel: string;
+    signature?: string | undefined;
+    slug: string;
+    title: string;
+}
+/**
+ * A documented parameter.
+ */
+export interface ParameterInfo {
+    description: string;
+    name: string;
+    type: string;
+}
+/**
+ * A run of markdown prose between code blocks.
+ */
+export interface ProseSegment {
+    text: string;
+    type: 'prose';
+}
+/**
+ * The part of a ts-morph method or function the declared return type is read from.
+ */
+export interface ReturnTypeProvider {
+    getReturnType: () => TextProvider;
+    getReturnTypeNode?: () => TextProvider | undefined;
+}
+/**
+ * A collapsible Starlight sidebar group.
+ */
+export interface SidebarEntry {
+    collapsed: boolean;
+    items: (SidebarEntry | SidebarLink)[];
+    label: string;
+}
+/**
+ * A Starlight sidebar link.
+ */
+export interface SidebarLink {
+    label: string;
+    link: string;
+}
+/**
+Recursive tree node for building the sidebar
+ */
+export interface SidebarTreeNode {
+    children: Map<string, SidebarTreeNode>;
+    types: TypeInfo[];
+}
+/**
+ * A ts-morph node or type whose text can be printed.
+ */
+export interface TextProvider {
+    getText: () => string;
+}
+/**
+ * A documented export: a class, interface, enum, type alias, function or variable.
+ */
+export interface TypeInfo {
+    baseTypes: string[];
+    /**
+    For classes: the constructor (public/protected), if any
+     */
+    constructorInfo?: MemberInfo | undefined;
+    description: string;
+    /**
+    For enums: the enum members
+     */
+    enumMembers: EnumMemberInfo[];
+    examples: string[];
+    /**
+    For classes: types in the `implements` clause
+     */
+    implementsTypes: string[];
+    kind: 'class' | 'enum' | 'function' | 'interface' | 'type' | 'variable';
+    methods: MemberInfo[];
+    name: string;
+    namespace: string;
+    properties: MemberInfo[];
+    remarks: string;
+    /**
+    For type aliases: the right-hand-side type text
+     */
+    typeAliasText?: string;
+    typeParameters: string[];
+    /**
+    For variables: the declaration keyword (let/const/var)
+     */
+    variableKeyword?: string;
+    /**
+    For variables: the type annotation
+     */
+    variableType?: string;
+}
+/**
+ * An object entry of the `typedoc-plugin-mdn-links` Web API data.
+ */
+export interface WebApiEntry {
+    url: string;
+}

package/dist/lib/cjs/docs-site/api-docs.cjs

@@ -0,0 +1,143 @@
+/*
+THIS IS A GENERATED/BUNDLED FILE BY ESBUILD
+if you want to view the source, please visit the github repository of this plugin
+*/
+(function () {
+function ensureBrowserProcess() {
+  const browserProcess = {
+    browser: true,
+    cwd() {
+      return '/';
+    },
+    env: {},
+    platform: 'android'
+  };
+
+  const existingProcess = globalThis.process;
+
+  if (!existingProcess) {
+    globalThis.process = browserProcess;
+    return;
+  }
+
+  if (existingProcess.versions?.node) {
+    return;
+  }
+
+  const existingProcessRecord = existingProcess;
+
+  for (const [key, value] of Object.entries(browserProcess)) {
+    existingProcessRecord[key] ??= value;
+  }
+
+  existingProcessRecord['browser'] = true;
+}
+
+ensureBrowserProcess();
+})();
+
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var api_docs_exports = {};
+__export(api_docs_exports, {
+  generateApiDocs: () => generateApiDocs
+});
+module.exports = __toCommonJS(api_docs_exports);
+var import_node_fs = require('node:fs');
+var import_promises = require('node:fs/promises');
+var import_node_path = require('node:path');
+var import_node_url = require('node:url');
+var import_ts_morph = require('ts-morph');
+var import_api_doc_jsdoc = require('./api-doc-jsdoc.cjs');
+var import_api_doc_link_rendering = require('./api-doc-link-rendering.cjs');
+var import_api_doc_package_sites = require('./api-doc-package-sites.cjs');
+var import_api_doc_page_generation = require('./api-doc-page-generation.cjs');
+var import_api_doc_settings = require('./api-doc-settings.cjs');
+var import_api_doc_source_processing = require('./api-doc-source-processing.cjs');
+var import_api_doc_type_merging = require('./api-doc-type-merging.cjs');
+var __import_meta_url = globalThis["import.meta.url"] ?? (function getCjsImportMetaUrl() {
+  if (typeof __filename === "string") {
+    const localRequire = require;
+    const url = localRequire("node:url");
+    if (typeof url.pathToFileURL === "function") {
+      return url.pathToFileURL(__filename).href;
+    }
+  }
+  return globalThis.location?.href ?? "";
+})();
+const CACHE_FILE_NAME = ".cache-hash";
+async function generateApiDocs(options) {
+  const { rootDirectory, settings, sourceDirectory } = options;
+  (0, import_api_doc_settings.configureApiDocs)(settings);
+  (0, import_api_doc_link_rendering.loadExternalTypeMaps)(rootDirectory);
+  const entryFiles = (0, import_api_doc_source_processing.findEntryFiles)(sourceDirectory);
+  console.warn(`Found ${String(entryFiles.length)} entry source files`);
+  const cacheFile = (0, import_node_path.join)(settings.outputDirectory, CACHE_FILE_NAME);
+  const currentHash = (0, import_api_doc_source_processing.computeCacheHash)(entryFiles, (0, import_node_path.dirname)((0, import_node_url.fileURLToPath)(__import_meta_url)));
+  if ((0, import_node_fs.existsSync)(cacheFile) && (0, import_node_fs.existsSync)(settings.sidebarFile) && (0, import_node_fs.readFileSync)(cacheFile, "utf-8").trim() === currentHash) {
+    console.warn("Source files and generator unchanged \u2014 skipping generation.");
+    return;
+  }
+  const project = new import_ts_morph.Project({
+    skipAddingFilesFromTsConfig: true,
+    tsConfigFilePath: (0, import_node_path.join)(rootDirectory, "tsconfig.json")
+  });
+  const sourceFiles = project.addSourceFilesAtPaths(entryFiles);
+  const types = /* @__PURE__ */ new Map();
+  const moduleOverviews = /* @__PURE__ */ new Map();
+  (0, import_api_doc_package_sites.clearPackageDeclarations)();
+  for (const src of sourceFiles) {
+    const namespace = (0, import_api_doc_source_processing.computeNamespace)(sourceDirectory, (0, import_node_path.normalize)(src.getFilePath()));
+    const overview = (0, import_api_doc_jsdoc.extractFileOverview)(src);
+    if (overview) {
+      moduleOverviews.set(namespace, overview);
+    }
+    (0, import_api_doc_source_processing.collectPackageDeclarations)(src);
+    (0, import_api_doc_source_processing.processSourceFile)(src, types, namespace);
+    (0, import_api_doc_source_processing.collectFunctions)(src, types, namespace);
+    (0, import_api_doc_source_processing.collectVariables)(src, types, namespace);
+  }
+  (0, import_api_doc_type_merging.resolveInheritedMembers)(types);
+  for (const info of types.values()) {
+    info.properties.sort((a, b) => a.name.localeCompare(b.name));
+    info.methods.sort((a, b) => a.name.localeCompare(b.name));
+  }
+  (0, import_api_doc_source_processing.registerGenericTypeParams)(types);
+  (0, import_api_doc_link_rendering.registerRouteSegments)(types);
+  (0, import_api_doc_link_rendering.registerMemberPages)(types);
+  await (0, import_promises.rm)(settings.outputDirectory, { force: true, recursive: true });
+  await (0, import_promises.mkdir)(settings.outputDirectory, { recursive: true });
+  await (0, import_api_doc_page_generation.generateNamespaceIndexPages)(types, types, moduleOverviews);
+  const pageContents = /* @__PURE__ */ new Map();
+  for (const [key, info] of types) {
+    pageContents.set(key, await (0, import_api_doc_page_generation.generateOverviewPage)(info.name, info, types));
+    if (info.kind === "class" || info.kind === "interface") {
+      await (0, import_api_doc_page_generation.generateMemberPages)(info.name, info, types);
+    }
+  }
+  await (0, import_api_doc_page_generation.appendBacklinksAndWrite)(pageContents, types);
+  await (0, import_api_doc_page_generation.generateSidebarJson)(types);
+  await (0, import_promises.writeFile)(cacheFile, currentHash, "utf-8");
+  console.warn(`Generated docs for ${String(types.size)} types across ${String(moduleOverviews.size)} documented modules`);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  generateApiDocs
+});
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJzb3VyY2VzIjpbIi4uLy4uLy4uLy4uL3NyYy9kb2NzLXNpdGUvYXBpLWRvY3MudHMiXSwic291cmNlc0NvbnRlbnQiOlsidmFyIF9faW1wb3J0X21ldGFfdXJsID0gZ2xvYmFsVGhpc1snaW1wb3J0Lm1ldGEudXJsJ10gPz8gKGZ1bmN0aW9uIGdldENqc0ltcG9ydE1ldGFVcmwoKSB7XG4gIGlmICh0eXBlb2YgX19maWxlbmFtZSA9PT0gJ3N0cmluZycpIHtcbiAgICBjb25zdCBsb2NhbFJlcXVpcmUgPSByZXF1aXJlO1xuICAgIGNvbnN0IHVybCA9IGxvY2FsUmVxdWlyZSgnbm9kZTp1cmwnKTtcbiAgICBpZiAodHlwZW9mIHVybC5wYXRoVG9GaWxlVVJMID09PSAnZnVuY3Rpb24nKSB7XG4gICAgICByZXR1cm4gdXJsLnBhdGhUb0ZpbGVVUkwoX19maWxlbmFtZSkuaHJlZjtcbiAgICB9XG4gIH1cblxuICAvLyBGYWxsYmFjayB0byB0aGUgcGFnZSBVUkwsIG9yIGFuIGVtcHR5IHN0cmluZyBpZiB0aGUgZW52aXJvbm1lbnQgaXMgdW5rbm93bi5cbiAgcmV0dXJuIGdsb2JhbFRoaXMubG9jYXRpb24/LmhyZWYgPz8gJyc7XG59KSgpO1xuLyoqXG4gKiBAZmlsZVxuICpcbiAqIFRoZSBBUEkgZG9jdW1lbnRhdGlvbiBnZW5lcmF0b3I6IHdhbGtzIGEgcGFja2FnZSdzIGBzcmNgLCBleHRyYWN0cyBldmVyeSBkb2N1bWVudGFibGUgZXhwb3J0ZWQgZGVjbGFyYXRpb24gdmlhXG4gKiB0cy1tb3JwaCwgYW5kIHdyaXRlcyBTdGFybGlnaHQtY29tcGF0aWJsZSBNRFggcGFnZXMgcGx1cyBhIHNpZGViYXIgSlNPTi4gVGhlIG91dHB1dCB0cmVlIG1pcnJvcnMgdGhlIHBhY2thZ2Unc1xuICogbW9kdWxlIHN0cnVjdHVyZTogYSB0eXBlJ3MgbmFtZXNwYWNlIGlzIGl0cyBzb3VyY2UgcGF0aCByZWxhdGl2ZSB0byBgc3JjYCwgd2hpY2ggaXMgYWxzbyBpdHMgaW1wb3J0IHN1YnBhdGguXG4gKi9cblxuaW1wb3J0IHtcbiAgZXhpc3RzU3luYyxcbiAgcmVhZEZpbGVTeW5jXG59IGZyb20gJ25vZGU6ZnMnO1xuaW1wb3J0IHtcbiAgbWtkaXIsXG4gIHJtLFxuICB3cml0ZUZpbGVcbn0gZnJvbSAnbm9kZTpmcy9wcm9taXNlcyc7XG5pbXBvcnQge1xuICBkaXJuYW1lLFxuICBqb2luLFxuICBub3JtYWxpemVcbn0gZnJvbSAnbm9kZTpwYXRoJztcbmltcG9ydCB7IGZpbGVVUkxUb1BhdGggfSBmcm9tICdub2RlOnVybCc7XG5pbXBvcnQgeyBQcm9qZWN0IH0gZnJvbSAndHMtbW9ycGgnO1xuXG5pbXBvcnQgdHlwZSB7IEFwaURvY1NldHRpbmdzIH0gZnJvbSAnLi9hcGktZG9jLXNldHRpbmdzLnRzJztcbmltcG9ydCB0eXBlIHtcbiAgUGFnZUNvbnRlbnQsXG4gIFR5cGVJbmZvXG59IGZyb20gJy4vYXBpLWRvYy10eXBlcy50cyc7XG5cbmltcG9ydCB7IGV4dHJhY3RGaWxlT3ZlcnZpZXcgfSBmcm9tICcuL2FwaS1kb2MtanNkb2MudHMnO1xuaW1wb3J0IHtcbiAgbG9hZEV4dGVybmFsVHlwZU1hcHMsXG4gIHJlZ2lzdGVyTWVtYmVyUGFnZXMsXG4gIHJlZ2lzdGVyUm91dGVTZWdtZW50c1xufSBmcm9tICcuL2FwaS1kb2MtbGluay1yZW5kZXJpbmcudHMnO1xuaW1wb3J0IHsgY2xlYXJQYWNrYWdlRGVjbGFyYXRpb25zIH0gZnJvbSAnLi9hcGktZG9jLXBhY2thZ2Utc2l0ZXMudHMnO1xuaW1wb3J0IHtcbiAgYXBwZW5kQmFja2xpbmtzQW5kV3JpdGUsXG4gIGdlbmVyYXRlTWVtYmVyUGFnZXMsXG4gIGdlbmVyYXRlTmFtZXNwYWNlSW5kZXhQYWdlcyxcbiAgZ2VuZXJhdGVPdmVydmlld1BhZ2UsXG4gIGdlbmVyYXRlU2lkZWJhckpzb25cbn0gZnJvbSAnLi9hcGktZG9jLXBhZ2UtZ2VuZXJhdGlvbi50cyc7XG5pbXBvcnQgeyBjb25maWd1cmVBcGlEb2NzIH0gZnJvbSAnLi9hcGktZG9jLXNldHRpbmdzLnRzJztcbmltcG9ydCB7XG4gIGNvbGxlY3RGdW5jdGlvbnMsXG4gIGNvbGxlY3RQYWNrYWdlRGVjbGFyYXRpb25zLFxuICBjb2xsZWN0VmFyaWFibGVzLFxuICBjb21wdXRlQ2FjaGVIYXNoLFxuICBjb21wdXRlTmFtZXNwYWNlLFxuICBmaW5kRW50cnlGaWxlcyxcbiAgcHJvY2Vzc1NvdXJjZUZpbGUsXG4gIHJlZ2lzdGVyR2VuZXJpY1R5cGVQYXJhbXNcbn0gZnJvbSAnLi9hcGktZG9jLXNvdXJjZS1wcm9jZXNzaW5nLnRzJztcbmltcG9ydCB7IHJlc29sdmVJbmhlcml0ZWRNZW1iZXJzIH0gZnJvbSAnLi9hcGktZG9jLXR5cGUtbWVyZ2luZy50cyc7XG5cbi8qKlxuICogT3B0aW9ucyBmb3Ige0BsaW5rIGdlbmVyYXRlQXBpRG9jc30uXG4gKi9cbmV4cG9ydCBpbnRlcmZhY2UgR2VuZXJhdGVBcGlEb2NzUGFyYW1zIHtcbiAgLyoqXG4gICAqIFRoZSByZXBvc2l0b3J5IHJvb3Q6IHRoZSBmb2xkZXIgaG9sZGluZyBgdHNjb25maWcuanNvbmAgYW5kIGBub2RlX21vZHVsZXNgLlxuICAgKi9cbiAgcmVhZG9ubHkgcm9vdERpcmVjdG9yeTogc3RyaW5nO1xuXG4gIC8qKlxuICAgKiBUaGUgc2V0dGluZ3MgZXZlcnkgcGFnZSBhbmQgbGluayBpcyByZW5kZXJlZCB3aXRoLlxuICAgKi9cbiAgcmVhZG9ubHkgc2V0dGluZ3M6IEFwaURvY1NldHRpbmdzO1xuXG4gIC8qKlxuICAgKiBUaGUgZm9sZGVyIHdob3NlIG1vZHVsZXMgYXJlIGRvY3VtZW50ZWQsIG5vcm1hbGx5IGA8cm9vdD4vc3JjYC5cbiAgICovXG4gIHJlYWRvbmx5IHNvdXJjZURpcmVjdG9yeTogc3RyaW5nO1xufVxuXG5jb25zdCBDQUNIRV9GSUxFX05BTUUgPSAnLmNhY2hlLWhhc2gnO1xuXG4vKipcbiAqIEdlbmVyYXRlcyB0aGUgQVBJIHJlZmVyZW5jZSBwYWdlcyBhbmQgdGhlIHNpZGViYXIuXG4gKlxuICogU2tpcHMgdGhlIHdvcmsgd2hlbiBuZWl0aGVyIHRoZSBzb3VyY2VzLCB0aGUgc2V0dGluZ3Mgbm9yIHRoZSBnZW5lcmF0b3IgY2hhbmdlZCBzaW5jZSB0aGUgbGFzdCBydW4uXG4gKlxuICogQHBhcmFtIG9wdGlvbnMgLSBUaGUgb3B0aW9ucy5cbiAqL1xuZXhwb3J0IGFzeW5jIGZ1bmN0aW9uIGdlbmVyYXRlQXBpRG9jcyhvcHRpb25zOiBHZW5lcmF0ZUFwaURvY3NQYXJhbXMpOiBQcm9taXNlPHZvaWQ+IHtcbiAgY29uc3QgeyByb290RGlyZWN0b3J5LCBzZXR0aW5ncywgc291cmNlRGlyZWN0b3J5IH0gPSBvcHRpb25zO1xuICBjb25maWd1cmVBcGlEb2NzKHNldHRpbmdzKTtcbiAgbG9hZEV4dGVybmFsVHlwZU1hcHMocm9vdERpcmVjdG9yeSk7XG5cbiAgY29uc3QgZW50cnlGaWxlcyA9IGZpbmRFbnRyeUZpbGVzKHNvdXJjZURpcmVjdG9yeSk7XG4gIGNvbnNvbGUud2FybihgRm91bmQgJHtTdHJpbmcoZW50cnlGaWxlcy5sZW5ndGgpfSBlbnRyeSBzb3VyY2UgZmlsZXNgKTtcblxuICBjb25zdCBjYWNoZUZpbGUgPSBqb2luKHNldHRpbmdzLm91dHB1dERpcmVjdG9yeSwgQ0FDSEVfRklMRV9OQU1FKTtcbiAgY29uc3QgY3VycmVudEhhc2ggPSBjb21wdXRlQ2FjaGVIYXNoKGVudHJ5RmlsZXMsIGRpcm5hbWUoZmlsZVVSTFRvUGF0aChpbXBvcnQubWV0YS51cmwpKSk7XG4gIGlmIChleGlzdHNTeW5jKGNhY2hlRmlsZSkgJiYgZXhpc3RzU3luYyhzZXR0aW5ncy5zaWRlYmFyRmlsZSkgJiYgcmVhZEZpbGVTeW5jKGNhY2hlRmlsZSwgJ3V0Zi04JykudHJpbSgpID09PSBjdXJyZW50SGFzaCkge1xuICAgIGNvbnNvbGUud2FybignU291cmNlIGZpbGVzIGFuZCBnZW5lcmF0b3IgdW5jaGFuZ2VkIOKAlCBza2lwcGluZyBnZW5lcmF0aW9uLicpO1xuICAgIHJldHVybjtcbiAgfVxuXG4gIC8vIExvYWQgdmlhIHRoZSByZXBvJ3MgdHNjb25maWcgc28gaW5mZXJyZWQgdHlwZXMgcmVzb2x2ZS5cbiAgY29uc3QgcHJvamVjdCA9IG5ldyBQcm9qZWN0KHtcbiAgICBza2lwQWRkaW5nRmlsZXNGcm9tVHNDb25maWc6IHRydWUsXG4gICAgdHNDb25maWdGaWxlUGF0aDogam9pbihyb290RGlyZWN0b3J5LCAndHNjb25maWcuanNvbicpXG4gIH0pO1xuICBjb25zdCBzb3VyY2VGaWxlcyA9IHByb2plY3QuYWRkU291cmNlRmlsZXNBdFBhdGhzKGVudHJ5RmlsZXMpO1xuXG4gIGNvbnN0IHR5cGVzID0gbmV3IE1hcDxzdHJpbmcsIFR5cGVJbmZvPigpO1xuICBjb25zdCBtb2R1bGVPdmVydmlld3MgPSBuZXcgTWFwPHN0cmluZywgc3RyaW5nPigpO1xuICBjbGVhclBhY2thZ2VEZWNsYXJhdGlvbnMoKTtcblxuICBmb3IgKGNvbnN0IHNyYyBvZiBzb3VyY2VGaWxlcykge1xuICAgIGNvbnN0IG5hbWVzcGFjZSA9IGNvbXB1dGVOYW1lc3BhY2Uoc291cmNlRGlyZWN0b3J5LCBub3JtYWxpemUoc3JjLmdldEZpbGVQYXRoKCkpKTtcbiAgICBjb25zdCBvdmVydmlldyA9IGV4dHJhY3RGaWxlT3ZlcnZpZXcoc3JjKTtcbiAgICBpZiAob3ZlcnZpZXcpIHtcbiAgICAgIG1vZHVsZU92ZXJ2aWV3cy5zZXQobmFtZXNwYWNlLCBvdmVydmlldyk7XG4gICAgfVxuICAgIGNvbGxlY3RQYWNrYWdlRGVjbGFyYXRpb25zKHNyYyk7XG4gICAgcHJvY2Vzc1NvdXJjZUZpbGUoc3JjLCB0eXBlcywgbmFtZXNwYWNlKTtcbiAgICBjb2xsZWN0RnVuY3Rpb25zKHNyYywgdHlwZXMsIG5hbWVzcGFjZSk7XG4gICAgY29sbGVjdFZhcmlhYmxlcyhzcmMsIHR5cGVzLCBuYW1lc3BhY2UpO1xuICB9XG5cbiAgcmVzb2x2ZUluaGVyaXRlZE1lbWJlcnModHlwZXMpO1xuXG4gIGZvciAoY29uc3QgaW5mbyBvZiB0eXBlcy52YWx1ZXMoKSkge1xuICAgIGluZm8ucHJvcGVydGllcy5zb3J0KChhLCBiKSA9PiBhLm5hbWUubG9jYWxlQ29tcGFyZShiLm5hbWUpKTtcbiAgICBpbmZvLm1ldGhvZHMuc29ydCgoYSwgYikgPT4gYS5uYW1lLmxvY2FsZUNvbXBhcmUoYi5uYW1lKSk7XG4gIH1cblxuICByZWdpc3RlckdlbmVyaWNUeXBlUGFyYW1zKHR5cGVzKTtcbiAgcmVnaXN0ZXJSb3V0ZVNlZ21lbnRzKHR5cGVzKTtcbiAgcmVnaXN0ZXJNZW1iZXJQYWdlcyh0eXBlcyk7XG5cbiAgYXdhaXQgcm0oc2V0dGluZ3Mub3V0cHV0RGlyZWN0b3J5LCB7IGZvcmNlOiB0cnVlLCByZWN1cnNpdmU6IHRydWUgfSk7XG4gIGF3YWl0IG1rZGlyKHNldHRpbmdzLm91dHB1dERpcmVjdG9yeSwgeyByZWN1cnNpdmU6IHRydWUgfSk7XG5cbiAgYXdhaXQgZ2VuZXJhdGVOYW1lc3BhY2VJbmRleFBhZ2VzKHR5cGVzLCB0eXBlcywgbW9kdWxlT3ZlcnZpZXdzKTtcblxuICAvLyBQYXNzIDE6IGdlbmVyYXRlIGFsbCBwYWdlcyB3aXRob3V0IGJhY2tsaW5rcywgY29sbGVjdCBjb250ZW50IChrZXllZCBieSBxdWFsaWZpZWQgaWQpXG4gIGNvbnN0IHBhZ2VDb250ZW50cyA9IG5ldyBNYXA8c3RyaW5nLCBQYWdlQ29udGVudD4oKTtcbiAgZm9yIChjb25zdCBba2V5LCBpbmZvXSBvZiB0eXBlcykge1xuICAgIHBhZ2VDb250ZW50cy5zZXQoa2V5LCBhd2FpdCBnZW5lcmF0ZU92ZXJ2aWV3UGFnZShpbmZvLm5hbWUsIGluZm8sIHR5cGVzKSk7XG4gICAgaWYgKGluZm8ua2luZCA9PT0gJ2NsYXNzJyB8fCBpbmZvLmtpbmQgPT09ICdpbnRlcmZhY2UnKSB7XG4gICAgICBhd2FpdCBnZW5lcmF0ZU1lbWJlclBhZ2VzKGluZm8ubmFtZSwgaW5mbywgdHlwZXMpO1xuICAgIH1cbiAgfVxuXG4gIC8vIFBhc3MgMjogc2NhbiBjb250ZW50IGZvciBsaW5rcywgYXBwZW5kIGJhY2tsaW5rcywgd3JpdGUgZmlsZXNcbiAgYXdhaXQgYXBwZW5kQmFja2xpbmtzQW5kV3JpdGUocGFnZUNvbnRlbnRzLCB0eXBlcyk7XG5cbiAgYXdhaXQgZ2VuZXJhdGVTaWRlYmFySnNvbih0eXBlcyk7XG4gIGF3YWl0IHdyaXRlRmlsZShjYWNoZUZpbGUsIGN1cnJlbnRIYXNoLCAndXRmLTgnKTtcblxuICBjb25zb2xlLndhcm4oYEdlbmVyYXRlZCBkb2NzIGZvciAke1N0cmluZyh0eXBlcy5zaXplKX0gdHlwZXMgYWNyb3NzICR7U3RyaW5nKG1vZHVsZU92ZXJ2aWV3cy5zaXplKX0gZG9jdW1lbnRlZCBtb2R1bGVzYCk7XG59XG4iXSwibWFwcGluZ3MiOiI7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7O0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQW9CQSxxQkFHTztBQUNQLHNCQUlPO0FBQ1AsdUJBSU87QUFDUCxzQkFBOEI7QUFDOUIsc0JBQXdCO0FBUXhCLDJCQUFvQztBQUNwQyxvQ0FJTztBQUNQLG1DQUF5QztBQUN6QyxxQ0FNTztBQUNQLDhCQUFpQztBQUNqQyx1Q0FTTztBQUNQLGtDQUF3QztBQXBFeEMsSUFBSSxvQkFBb0IsV0FBVyxpQkFBaUIsTUFBTSxTQUFTLHNCQUFzQjtBQUN2RixNQUFJLE9BQU8sZUFBZSxVQUFVO0FBQ2xDLFVBQU0sZUFBZTtBQUNyQixVQUFNLE1BQU0sYUFBYSxVQUFVO0FBQ25DLFFBQUksT0FBTyxJQUFJLGtCQUFrQixZQUFZO0FBQzNDLGFBQU8sSUFBSSxjQUFjLFVBQVUsRUFBRTtBQUFBLElBQ3ZDO0FBQUEsRUFDRjtBQUdBLFNBQU8sV0FBVyxVQUFVLFFBQVE7QUFDdEMsR0FBRztBQStFSCxNQUFNLGtCQUFrQjtBQVN4QixlQUFzQixnQkFBZ0IsU0FBK0M7QUFDbkYsUUFBTSxFQUFFLGVBQWUsVUFBVSxnQkFBZ0IsSUFBSTtBQUNyRCxnREFBaUIsUUFBUTtBQUN6QiwwREFBcUIsYUFBYTtB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

package/dist/lib/cjs/docs-site/api-docs.d.cts

@@ -0,0 +1,34 @@
+/// <reference path="../library-references.d.cts" />
+/**
+ * @file
+ *
+ * The API documentation generator: walks a package's `src`, extracts every documentable exported declaration via
+ * ts-morph, and writes Starlight-compatible MDX pages plus a sidebar JSON. The output tree mirrors the package's
+ * module structure: a type's namespace is its source path relative to `src`, which is also its import subpath.
+ */
+import type { ApiDocSettings } from './api-doc-settings.cjs';
+/**
+ * Options for {@link generateApiDocs}.
+ */
+export interface GenerateApiDocsParams {
+    /**
+     * The repository root: the folder holding `tsconfig.json` and `node_modules`.
+     */
+    readonly rootDirectory: string;
+    /**
+     * The settings every page and link is rendered with.
+     */
+    readonly settings: ApiDocSettings;
+    /**
+     * The folder whose modules are documented, normally `<root>/src`.
+     */
+    readonly sourceDirectory: string;
+}
+/**
+ * Generates the API reference pages and the sidebar.
+ *
+ * Skips the work when neither the sources, the settings nor the generator changed since the last run.
+ *
+ * @param options - The options.
+ */
+export declare function generateApiDocs(options: GenerateApiDocsParams): Promise<void>;