@apify/docusaurus-plugin-typedoc-api 3.0.0

package/lib/plugin/data.js

@@ -0,0 +1,332 @@
+'use strict';
+
+const _excluded = ["changelogPath", "readmePath"];
+function _objectWithoutProperties(source, excluded) { if (source == null) return {}; var target = _objectWithoutPropertiesLoose(source, excluded); var key, i; if (Object.getOwnPropertySymbols) { var sourceSymbolKeys = Object.getOwnPropertySymbols(source); for (i = 0; i < sourceSymbolKeys.length; i++) { key = sourceSymbolKeys[i]; if (excluded.indexOf(key) >= 0) continue; if (!Object.prototype.propertyIsEnumerable.call(source, key)) continue; target[key] = source[key]; } } return target; }
+function _objectWithoutPropertiesLoose(source, excluded) { if (source == null) return {}; var target = {}; var sourceKeys = Object.keys(source); var key, i; for (i = 0; i < sourceKeys.length; i++) { key = sourceKeys[i]; if (excluded.indexOf(key) >= 0) continue; target[key] = source[key]; } return target; }
+function ownKeys(object, enumerableOnly) { var keys = Object.keys(object); if (Object.getOwnPropertySymbols) { var symbols = Object.getOwnPropertySymbols(object); enumerableOnly && (symbols = symbols.filter(function (sym) { return Object.getOwnPropertyDescriptor(object, sym).enumerable; })), keys.push.apply(keys, symbols); } return keys; }
+function _objectSpread(target) { for (var i = 1; i < arguments.length; i++) { var source = null != arguments[i] ? arguments[i] : {}; i % 2 ? ownKeys(Object(source), !0).forEach(function (key) { _defineProperty(target, key, source[key]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(target, Object.getOwnPropertyDescriptors(source)) : ownKeys(Object(source)).forEach(function (key) { Object.defineProperty(target, key, Object.getOwnPropertyDescriptor(source, key)); }); } return target; }
+function _defineProperty(obj, key, value) { key = _toPropertyKey(key); if (key in obj) { Object.defineProperty(obj, key, { value: value, enumerable: true, configurable: true, writable: true }); } else { obj[key] = value; } return obj; }
+function _toPropertyKey(arg) { var key = _toPrimitive(arg, "string"); return typeof key === "symbol" ? key : String(key); }
+function _toPrimitive(input, hint) { if (typeof input !== "object" || input === null) return input; var prim = input[Symbol.toPrimitive]; if (prim !== undefined) { var res = prim.call(input, hint || "default"); if (typeof res !== "object") return res; throw new TypeError("@@toPrimitive must return a primitive value."); } return (hint === "string" ? String : Number)(input); }
+const fs = require('node:fs');
+const path = require('node:path');
+const TypeDoc = require('typedoc');
+const ts = require('typescript');
+const utils = require('@docusaurus/utils');
+const _0_23 = require('./structure/0.23.js');
+const url = require('./url.js');
+const _interopDefault = e => e && e.__esModule ? e : {
+  default: e
+};
+function _interopNamespace(e) {
+  if (e && e.__esModule) return e;
+  const n = Object.create(null);
+  if (e) {
+    for (const k in e) {
+      if (k !== 'default') {
+        const d = Object.getOwnPropertyDescriptor(e, k);
+        Object.defineProperty(n, k, d.get ? d : {
+          enumerable: true,
+          get: () => e[k]
+        });
+      }
+    }
+  }
+  n.default = e;
+  return Object.freeze(n);
+}
+const fs__default = /*#__PURE__*/_interopDefault(fs);
+const path__default = /*#__PURE__*/_interopDefault(path);
+const TypeDoc__namespace = /*#__PURE__*/_interopNamespace(TypeDoc);
+const ts__default = /*#__PURE__*/_interopDefault(ts);
+function shouldEmit(projectRoot, tsconfigPath) {
+  // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment
+  const _ts__default$default$ = ts__default.default.readConfigFile(tsconfigPath, name => fs__default.default.readFileSync(name, 'utf8')),
+    config = _ts__default$default$.config,
+    error = _ts__default$default$.error;
+  if (error) {
+    throw new Error(`Failed to load ${tsconfigPath}`);
+  }
+  const result = ts__default.default.parseJsonConfigFileContent(config, ts__default.default.sys, projectRoot, {}, tsconfigPath);
+  if (result.errors.length > 0) {
+    throw new Error(`Failed to parse ${tsconfigPath}`);
+  }
+  return result.projectReferences && result.projectReferences.length > 0 ? 'docs' : 'none';
+}
+
+// Persist build state as a global, since the plugin is re-evaluated every hot reload.
+// Because of this, we can't use state in the plugin or module scope.
+if (!global.typedocBuild) {
+  global.typedocBuild = {
+    count: 0
+  };
+}
+async function generateJson(projectRoot, entryPoints, outFile, options) {
+  /* eslint-disable sort-keys */
+
+  // Running the TypeDoc compiler is pretty slow...
+  // We should only load on the 1st build, and use cache for subsequent reloads.
+  if (global.typedocBuild.count > 0 && fs__default.default.existsSync(outFile)) {
+    return true;
+  }
+  const app = new TypeDoc__namespace.Application();
+  const tsconfig = path__default.default.join(projectRoot, options.tsconfigName);
+  app.options.addReader(new TypeDoc__namespace.TSConfigReader());
+  app.options.addReader(new TypeDoc__namespace.TypeDocReader());
+  app.bootstrap(_objectSpread(_objectSpread({
+    skipErrorChecking: true,
+    // Only emit when using project references
+    emit: shouldEmit(projectRoot, tsconfig),
+    // Only document the public API by default
+    excludeExternals: true,
+    excludeInternal: true,
+    excludePrivate: true,
+    excludeProtected: true,
+    // Enable verbose logging when debugging
+    logLevel: options.debug ? 'Verbose' : 'Info',
+    inlineTags: ['@link', '@inheritDoc', '@label', '@linkcode', '@linkplain', '@apilink', '@doclink']
+  }, options.typedocOptions), {}, {
+    // Control how config and packages are detected
+    tsconfig,
+    entryPoints: entryPoints.map(ep => path__default.default.join(projectRoot, ep)),
+    entryPointStrategy: 'expand',
+    exclude: options.exclude,
+    // We use a fake category title so that we can fallback to the parent group
+    defaultCategory: 'CATEGORY'
+  }));
+  const project = app.convert();
+  if (project) {
+    await app.generateJson(project, outFile);
+    global.typedocBuild.count += 1;
+    return true;
+  }
+  return false;
+}
+function createReflectionMap(items = []) {
+  const map = {};
+  items.forEach(item => {
+    map[item.id] = item;
+  });
+  return map;
+}
+function loadPackageJsonAndDocs(initialDir, pkgFileName = 'package.json', readmeFileName = 'README.md', changelogFileName = 'CHANGELOG.md') {
+  let currentDir = initialDir;
+  while (!fs__default.default.existsSync(path__default.default.join(currentDir, pkgFileName))) {
+    currentDir = path__default.default.dirname(currentDir);
+  }
+  const readmePath = path__default.default.join(currentDir, readmeFileName);
+  const changelogPath = path__default.default.join(currentDir, changelogFileName);
+  return {
+    packageJson: JSON.parse(fs__default.default.readFileSync(path__default.default.join(currentDir, pkgFileName), 'utf8')),
+    readmePath: fs__default.default.existsSync(readmePath) ? readmePath : '',
+    changelogPath: fs__default.default.existsSync(changelogPath) ? changelogPath : ''
+  };
+}
+function addMetadataToReflections(project, packageSlug, urlPrefix) {
+  const permalink = `/${url.joinUrl(urlPrefix, packageSlug)}`;
+  if (project.children) {
+    // eslint-disable-next-line no-param-reassign
+    project.children = project.children.map(child => {
+      _0_23.migrateToVersion0230(child);
+      const kindSlugPart = url.getKindSlug(child);
+      const childSlug = kindSlugPart ? `/${kindSlugPart}/${child.name}` : `#${child.name}`;
+      const childPermalink = permalink + childSlug;
+
+      // We need to go another level deeper and only use fragments
+      if (child.kind === TypeDoc.ReflectionKind.Namespace && child.children) {
+        // eslint-disable-next-line no-param-reassign
+        child.children = child.children.map(grandChild => _objectSpread(_objectSpread({}, grandChild), {}, {
+          permalink: utils.normalizeUrl([`${childPermalink}#${grandChild.name}`])
+        }));
+      }
+      return _objectSpread(_objectSpread({}, child), {}, {
+        permalink: utils.normalizeUrl([childPermalink])
+      });
+    });
+  }
+  return _objectSpread(_objectSpread({}, project), {}, {
+    permalink: utils.normalizeUrl([permalink])
+  });
+}
+function mergeReflections(base, next) {
+  if (Array.isArray(base.children) && Array.isArray(next.children)) {
+    base.children.push(...next.children);
+  }
+  if (Array.isArray(base.groups) && Array.isArray(next.groups)) {
+    next.groups.forEach(group => {
+      const baseGroup = base.groups?.find(g => g.title === group.title);
+      if (baseGroup) {
+        baseGroup.children?.push(...(group.children ?? []));
+      } else {
+        base.groups?.push(group);
+      }
+    });
+
+    // We can remove refs since were merging all reflections into one
+    // eslint-disable-next-line no-param-reassign
+    base.groups = base.groups.filter(group => group.title !== 'References');
+  }
+}
+function sortReflectionGroups(reflections) {
+  reflections.forEach(reflection => {
+    const map = createReflectionMap(reflection.children);
+    const sort = (a, b) => map[a].name < map[b].name ? -1 : 1;
+    reflection.categories?.forEach(category => {
+      category.children?.sort(sort);
+    });
+    reflection.groups?.forEach(group => {
+      group.children?.sort(sort);
+      group.categories?.forEach(category => {
+        category.children?.sort(sort);
+      });
+    });
+  });
+}
+function matchesEntryPoint(sourceFile, entryPoint, {
+  deep,
+  single
+}) {
+  // Single package
+  if (single) {
+    return (
+      // src/index.ts === src/index.ts
+      !deep && sourceFile === entryPoint ||
+      // index.ts === src/index.ts
+      !deep && sourceFile === path__default.default.basename(entryPoint) ||
+      // some/deep/file.ts === ...
+      deep
+    );
+  }
+
+  // Multiple packages
+  return (
+    // packages/foo/src/index.ts === packages/foo/src/index.ts
+    // foo/src/index.ts ~ packages/foo/src/index.ts
+    !deep && (sourceFile === entryPoint || entryPoint.endsWith(sourceFile)) ||
+    // packages/foo/src/some/deep/file.ts === packages/foo/src/
+    deep && sourceFile.startsWith(entryPoint)
+  );
+}
+function extractReflectionModules(project, isSinglePackage) {
+  const modules = [];
+  const inheritChildren = () => {
+    project.children?.forEach(child => {
+      if (child.kind === TypeDoc.ReflectionKind.Module) {
+        modules.push(child);
+      }
+    });
+  };
+
+  // Single packages are extremely difficult, as the TypeDoc structure is
+  // different for every kind of package entry point pattern
+  if (isSinglePackage) {
+    const hasNoModules = project.children?.every(child => child.kind !== TypeDoc.ReflectionKind.Module);
+    if (hasNoModules) {
+      // No "module" children:
+      //	- Polyrepos
+      //	- Monorepos with 1 package
+      modules.push(project);
+    } else {
+      // Has "module" children:
+      //	- Polyrepos with deep imports
+      //	- Polyrepos with multi-imports
+      //	- Monorepos
+      inheritChildren();
+    }
+
+    // Multiple packages are extremely simple, as every package is a module reflection
+    // as a child on the top-level project reflection
+  } else {
+    inheritChildren();
+  }
+  return modules;
+}
+function flattenAndGroupPackages(packageConfigs, project, urlPrefix, options, versioned = false) {
+  const isSinglePackage = packageConfigs.length === 1;
+  const modules = extractReflectionModules(project, isSinglePackage);
+
+  // Loop through every TypeDoc module and group based on package and entry point
+  const packages = {};
+  const packagesWithDeepImports = [];
+  modules.forEach(mod => {
+    const relSourceFile = mod.sources?.[0]?.fileName ?? '';
+    packageConfigs.some(cfg => Object.entries(cfg.entryPoints).some(([importPath, entry]) => {
+      const relEntryPoint = url.joinUrl(cfg.packagePath, entry.path);
+      const isUsingDeepImports = !entry.path.match(/\.tsx?$/);
+      if (!matchesEntryPoint(relSourceFile, relEntryPoint, {
+        deep: isUsingDeepImports,
+        single: isSinglePackage
+      })) {
+        return false;
+      }
+
+      // We have a matching entry point, so store the record
+      if (!packages[cfg.packagePath]) {
+        const _loadPackageJsonAndDo = loadPackageJsonAndDocs(path__default.default.join(options.projectRoot, cfg.packagePath), options.packageJsonName, options.readmeName, options.changelogName),
+          packageJson = _loadPackageJsonAndDo.packageJson,
+          readmePath = _loadPackageJsonAndDo.readmePath,
+          changelogPath = _loadPackageJsonAndDo.changelogPath;
+        packages[cfg.packagePath] = {
+          entryPoints: [],
+          packageName: versioned && cfg.packageName || packageJson.name,
+          packageVersion: versioned && cfg.packageVersion || packageJson.version,
+          readmePath,
+          changelogPath
+        };
+
+        // eslint-disable-next-line no-param-reassign
+        cfg.packageName = packages[cfg.packagePath].packageName;
+        // eslint-disable-next-line no-param-reassign
+        cfg.packageVersion = packages[cfg.packagePath].packageVersion;
+      }
+
+      // Add metadata to package and children reflections
+      const urlSlug = url.getPackageSlug(cfg, importPath, isSinglePackage);
+      const reflection = addMetadataToReflections(mod, urlSlug, urlPrefix);
+      const existingEntry = packages[cfg.packagePath].entryPoints.find(ep => ep.urlSlug === urlSlug);
+      if (existingEntry) {
+        if (isUsingDeepImports) {
+          mergeReflections(existingEntry.reflection, reflection);
+        } else {
+          // eslint-disable-next-line no-console
+          console.error(`Entry point ${urlSlug} already defined. How did you get here?`);
+        }
+      } else {
+        packages[cfg.packagePath].entryPoints.push({
+          index: importPath === 'index',
+          label: entry.label,
+          reflection,
+          urlSlug
+        });
+        if (isUsingDeepImports) {
+          packagesWithDeepImports.push(reflection);
+        }
+      }
+
+      // Update the reflection name since its useless
+      reflection.name = importPath === 'index' ? packages[cfg.packagePath].packageName : url.joinUrl(packages[cfg.packagePath].packageName, importPath);
+      return true;
+    }));
+  });
+
+  // Since we merged multiple reflections together, we'll need to sort groups manually
+  sortReflectionGroups(packagesWithDeepImports);
+
+  // Sort packages by name
+  return Object.values(packages).sort((a, b) => a.packageName.localeCompare(b.packageName));
+}
+function formatPackagesWithoutHostInfo(packages) {
+  return packages.map(_ref => {
+    let changelogPath = _ref.changelogPath,
+      readmePath = _ref.readmePath,
+      pkg = _objectWithoutProperties(_ref, _excluded);
+    return pkg;
+  });
+}
+exports.addMetadataToReflections = addMetadataToReflections;
+exports.createReflectionMap = createReflectionMap;
+exports.flattenAndGroupPackages = flattenAndGroupPackages;
+exports.formatPackagesWithoutHostInfo = formatPackagesWithoutHostInfo;
+exports.generateJson = generateJson;
+exports.loadPackageJsonAndDocs = loadPackageJsonAndDocs;
+//# sourceMappingURL=data.js.map

package/lib/plugin/data.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"data.js","sources":["../../src/plugin/data.ts"],"sourcesContent":null,"names":["ts","fs","TypeDoc","path","joinUrl","migrateToVersion0230","getKindSlug","ReflectionKind","normalizeUrl","getPackageSlug"],"mappings":"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"}

package/lib/plugin/sidebar.js

@@ -0,0 +1,105 @@
+'use strict';
+
+const utils = require('@docusaurus/utils');
+const links = require('../utils/links.js');
+const data = require('./data.js');
+function groupSidebarItems(map, groups) {
+  const items = [];
+  const sortedGroups = [...groups].sort((a, b) => a.title.localeCompare(b.title));
+  function getLastItemInGroup(index) {
+    const length = sortedGroups[index]?.children?.length;
+    return length ? sortedGroups[index]?.children?.[length - 1] : undefined;
+  }
+  sortedGroups.forEach((group, groupIndex) => {
+    const children = group.children;
+    if (!children || children.length === 0) {
+      return;
+    }
+    items.push({
+      collapsed: true,
+      collapsible: true,
+      items: children.map((id, index) => {
+        const child = map[id];
+
+        // We map previous/next from here since the sidebar is grouped by type,
+        // and we only want to link based on this order.
+        const previousId = index === 0 ? getLastItemInGroup(groupIndex - 1) : children[index - 1];
+        const nextId = index === children.length - 1 ? groups[groupIndex + 1]?.children?.[0] : children[index + 1];
+        if (previousId) {
+          child.previousId = previousId;
+        }
+        if (nextId) {
+          child.nextId = nextId;
+        }
+        return {
+          href: child.permalink,
+          label: child.name,
+          type: 'link'
+        };
+      }),
+      label: group.title,
+      type: 'category'
+    });
+  });
+  return items;
+}
+function extractReflectionSidebar(pkg) {
+  return pkg.groups ? groupSidebarItems(data.createReflectionMap(pkg.children), pkg.groups) : [];
+}
+function extractSidebar(packages, scopes, changelogs, sortSidebar) {
+  if (packages.length === 0) {
+    return [];
+  }
+  const items = packages.map(pkg => {
+    let subItems = [];
+    pkg.entryPoints.forEach(entry => {
+      // Index entry point should always bubble up reflection groups
+      if (entry.index) {
+        subItems.push(...extractReflectionSidebar(entry.reflection));
+        // Otherwise nest non-index entry points behind categories
+      } else {
+        subItems.push({
+          collapsed: true,
+          collapsible: true,
+          items: extractReflectionSidebar(entry.reflection),
+          label: entry.label,
+          type: 'category'
+        });
+      }
+    });
+
+    // Always include the overview as the 1st item
+    const indexHref = pkg.entryPoints.find(entry => entry.index)?.reflection.permalink ?? '';
+    subItems = subItems.sort((a, d) => sortSidebar('label' in a ? a.label : '', 'label' in d ? d.label : ''));
+    subItems.unshift({
+      href: indexHref,
+      label: 'Overview',
+      type: 'link'
+    });
+    if (pkg.changelogPath && changelogs) {
+      subItems.push({
+        href: utils.normalizeUrl([indexHref, 'changelog']),
+        label: 'Changelog',
+        type: 'link'
+      });
+    }
+    return {
+      collapsed: true,
+      collapsible: true,
+      items: subItems,
+      label: links.removeScopes(pkg.packageName, scopes),
+      type: 'category'
+    };
+  });
+  const sidebar = items.filter(item => 'items' in item && items.length > 0);
+
+  // Collapse sidebar when only 1 package
+  if (packages.length === 1 && sidebar.length === 1 && sidebar[0].type === 'category') {
+    return sidebar[0].items;
+  }
+  return sidebar;
+}
+exports.extractReflectionSidebar = extractReflectionSidebar;
+exports.extractSidebar = extractSidebar;
+exports.groupSidebarItems = groupSidebarItems;
+//# sourceMappingURL=sidebar.js.map

package/lib/plugin/sidebar.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sidebar.js","sources":["../../src/plugin/sidebar.ts"],"sourcesContent":null,"names":["createReflectionMap","normalizeUrl","removeScopes"],"mappings":"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"}

package/lib/plugin/structure/0.23.js

@@ -0,0 +1,48 @@
+'use strict';
+
+/* eslint-disable no-param-reassign */
+
+// https://github.com/TypeStrong/typedoc/releases/tag/v0.23.0
+// https://github.com/milesj/docusaurus-plugin-typedoc-api/pull/50
+function migrateToVersion0230(reflection) {
+  if (Array.isArray(reflection.getSignature)) {
+    // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment
+    reflection.getSignature = reflection.getSignature[0];
+  }
+  if (Array.isArray(reflection.setSignature)) {
+    // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment
+    reflection.setSignature = reflection.setSignature[0];
+  }
+  if ('typeParameter' in reflection) {
+    reflection.typeParameters = reflection.typeParameter;
+  }
+  if (reflection.comment && ('shortText' in reflection.comment || 'text' in reflection.comment || 'tags' in reflection.comment)) {
+    const comment = reflection.comment;
+    const summary = [];
+    if (comment.shortText) {
+      summary.push({
+        kind: 'text',
+        text: comment.shortText
+      });
+    }
+    if (comment.text) {
+      summary.push({
+        kind: 'text',
+        text: comment.text
+      });
+    }
+    reflection.comment = {
+      blockTags: comment.tags?.map(tag => ({
+        content: [{
+          kind: 'text',
+          text: tag.text
+        }],
+        name: tag.tag,
+        tag: `@${tag.tag}`
+      })),
+      summary
+    };
+  }
+}
+exports.migrateToVersion0230 = migrateToVersion0230;
+//# sourceMappingURL=0.23.js.map

package/lib/plugin/structure/0.23.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"0.23.js","sources":["../../../src/plugin/structure/0.23.ts"],"sourcesContent":null,"names":[],"mappings":";;AAAA;AACA;AACA;AACA;AACO,SAAS,oBAAoB,CAAC,UAAU,EAAE;AACjD,EAAE,IAAI,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE;AAC9C;AACA,IAAI,UAAU,CAAC,YAAY,GAAG,UAAU,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;AACzD,GAAG;AACH,EAAE,IAAI,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE;AAC9C;AACA,IAAI,UAAU,CAAC,YAAY,GAAG,UAAU,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;AACzD,GAAG;AACH,EAAE,IAAI,eAAe,IAAI,UAAU,EAAE;AACrC,IAAI,UAAU,CAAC,cAAc,GAAG,UAAU,CAAC,aAAa,CAAC;AACzD,GAAG;AACH,EAAE,IAAI,UAAU,CAAC,OAAO,KAAK,WAAW,IAAI,UAAU,CAAC,OAAO,IAAI,MAAM,IAAI,UAAU,CAAC,OAAO,IAAI,MAAM,IAAI,UAAU,CAAC,OAAO,CAAC,EAAE;AACjI,IAAI,MAAM,OAAO,GAAG,UAAU,CAAC,OAAO,CAAC;AACvC,IAAI,MAAM,OAAO,GAAG,EAAE,CAAC;AACvB,IAAI,IAAI,OAAO,CAAC,SAAS,EAAE;AAC3B,MAAM,OAAO,CAAC,IAAI,CAAC;AACnB,QAAQ,IAAI,EAAE,MAAM;AACpB,QAAQ,IAAI,EAAE,OAAO,CAAC,SAAS;AAC/B,OAAO,CAAC,CAAC;AACT,KAAK;AACL,IAAI,IAAI,OAAO,CAAC,IAAI,EAAE;AACtB,MAAM,OAAO,CAAC,IAAI,CAAC;AACnB,QAAQ,IAAI,EAAE,MAAM;AACpB,QAAQ,IAAI,EAAE,OAAO,CAAC,IAAI;AAC1B,OAAO,CAAC,CAAC;AACT,KAAK;AACL,IAAI,UAAU,CAAC,OAAO,GAAG;AACzB,MAAM,SAAS,EAAE,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,GAAG,KAAK;AAC3C,QAAQ,OAAO,EAAE,CAAC;AAClB,UAAU,IAAI,EAAE,MAAM;AACtB,UAAU,IAAI,EAAE,GAAG,CAAC,IAAI;AACxB,SAAS,CAAC;AACV,QAAQ,IAAI,EAAE,GAAG,CAAC,GAAG;AACrB,QAAQ,GAAG,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC;AAC1B,OAAO,CAAC,CAAC;AACT,MAAM,OAAO;AACb,KAAK,CAAC;AACN,GAAG;AACH;;;;"}

package/lib/plugin/url.js

@@ -0,0 +1,49 @@
+'use strict';
+
+const path = require('node:path');
+const TypeDoc = require('typedoc');
+const _interopDefault = e => e && e.__esModule ? e : {
+  default: e
+};
+const path__default = /*#__PURE__*/_interopDefault(path);
+function joinUrl(...paths) {
+  return path__default.default.join(...paths).replace(/\\/g, '/');
+}
+function getKindSlug(decl) {
+  switch (decl.kind) {
+    case TypeDoc.ReflectionKind.Module:
+      return 'package';
+    case TypeDoc.ReflectionKind.Namespace:
+      return 'namespace';
+    case TypeDoc.ReflectionKind.Enum:
+      return 'enum';
+    case TypeDoc.ReflectionKind.Function:
+      return 'function';
+    case TypeDoc.ReflectionKind.Class:
+      return 'class';
+    case TypeDoc.ReflectionKind.Interface:
+      return 'interface';
+    default:
+      return '';
+  }
+}
+function getPackageSlug(pkgConfig, importPath, isSinglePackage) {
+  // Monorepo with 1 package has special handling
+  if (isSinglePackage && pkgConfig.packageSlug !== '.') {
+    return '.';
+  }
+
+  // packages/foo -> foo
+  const slug = pkgConfig.packageSlug ?? path__default.default.basename(pkgConfig.packagePath);
+
+  // bar/baz -> bar-baz
+  const importName = importPath.replace(/\\/g, '-');
+  if (importName === 'index') {
+    return slug;
+  }
+  return `${slug}-${importName}`;
+}
+exports.getKindSlug = getKindSlug;
+exports.getPackageSlug = getPackageSlug;
+exports.joinUrl = joinUrl;
+//# sourceMappingURL=url.js.map

package/lib/plugin/url.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"url.js","sources":["../../src/plugin/url.ts"],"sourcesContent":null,"names":["path","ReflectionKind"],"mappings":";;;;;;;;;AAEO,SAAS,OAAO,CAAC,GAAG,KAAK,EAAE;AAClC,EAAE,OAAOA,qBAAI,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;AACjD,CAAC;AACM,SAAS,WAAW,CAAC,IAAI,EAAE;AAClC,EAAE,QAAQ,IAAI,CAAC,IAAI;AACnB,IAAI,KAAKC,sBAAc,CAAC,MAAM;AAC9B,MAAM,OAAO,SAAS,CAAC;AACvB,IAAI,KAAKA,sBAAc,CAAC,SAAS;AACjC,MAAM,OAAO,WAAW,CAAC;AACzB,IAAI,KAAKA,sBAAc,CAAC,IAAI;AAC5B,MAAM,OAAO,MAAM,CAAC;AACpB,IAAI,KAAKA,sBAAc,CAAC,QAAQ;AAChC,MAAM,OAAO,UAAU,CAAC;AACxB,IAAI,KAAKA,sBAAc,CAAC,KAAK;AAC7B,MAAM,OAAO,OAAO,CAAC;AACrB,IAAI,KAAKA,sBAAc,CAAC,SAAS;AACjC,MAAM,OAAO,WAAW,CAAC;AACzB,IAAI;AACJ,MAAM,OAAO,EAAE,CAAC;AAChB,GAAG;AACH,CAAC;AACM,SAAS,cAAc,CAAC,SAAS,EAAE,UAAU,EAAE,eAAe,EAAE;AACvE;AACA,EAAE,IAAI,eAAe,IAAI,SAAS,CAAC,WAAW,KAAK,GAAG,EAAE;AACxD,IAAI,OAAO,GAAG,CAAC;AACf,GAAG;AACH;AACA;AACA,EAAE,MAAM,IAAI,GAAG,SAAS,CAAC,WAAW,IAAID,qBAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;AAC7E;AACA;AACA,EAAE,MAAM,UAAU,GAAG,UAAU,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;AACpD,EAAE,IAAI,UAAU,KAAK,OAAO,EAAE;AAC9B,IAAI,OAAO,IAAI,CAAC;AAChB,GAAG;AACH,EAAE,OAAO,CAAC,EAAE,IAAI,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC,CAAC;AACjC;;;;;;"}

package/lib/plugin/version.js

@@ -0,0 +1,83 @@
+'use strict';
+
+function ownKeys(object, enumerableOnly) { var keys = Object.keys(object); if (Object.getOwnPropertySymbols) { var symbols = Object.getOwnPropertySymbols(object); enumerableOnly && (symbols = symbols.filter(function (sym) { return Object.getOwnPropertyDescriptor(object, sym).enumerable; })), keys.push.apply(keys, symbols); } return keys; }
+function _objectSpread(target) { for (var i = 1; i < arguments.length; i++) { var source = null != arguments[i] ? arguments[i] : {}; i % 2 ? ownKeys(Object(source), !0).forEach(function (key) { _defineProperty(target, key, source[key]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(target, Object.getOwnPropertyDescriptors(source)) : ownKeys(Object(source)).forEach(function (key) { Object.defineProperty(target, key, Object.getOwnPropertyDescriptor(source, key)); }); } return target; }
+function _defineProperty(obj, key, value) { key = _toPropertyKey(key); if (key in obj) { Object.defineProperty(obj, key, { value: value, enumerable: true, configurable: true, writable: true }); } else { obj[key] = value; } return obj; }
+function _toPropertyKey(arg) { var key = _toPrimitive(arg, "string"); return typeof key === "symbol" ? key : String(key); }
+function _toPrimitive(input, hint) { if (typeof input !== "object" || input === null) return input; var prim = input[Symbol.toPrimitive]; if (prim !== undefined) { var res = prim.call(input, hint || "default"); if (typeof res !== "object") return res; throw new TypeError("@@toPrimitive must return a primitive value."); } return (hint === "string" ? String : Number)(input); }
+const path = require('node:path');
+const server = require('@docusaurus/plugin-content-docs/server');
+const utils = require('@docusaurus/utils');
+const _interopDefault = e => e && e.__esModule ? e : {
+  default: e
+};
+const path__default = /*#__PURE__*/_interopDefault(path);
+
+// BASED ON: https://github.com/facebook/docusaurus/blob/main/packages/docusaurus-plugin-content-docs/src/versions.ts
+function getVersionedDocsDirPath(siteDir, pluginId) {
+  return path__default.default.join(siteDir, pluginId === utils.DEFAULT_PLUGIN_ID ? server.VERSIONED_DOCS_DIR : `${pluginId}_${server.VERSIONED_DOCS_DIR}`);
+}
+function getDefaultLastVersionName(versionNames) {
+  if (versionNames.length === 1) {
+    return versionNames[0];
+  }
+  return versionNames.find(versionName => versionName !== server.CURRENT_VERSION_NAME) ?? '';
+}
+function createVersionMetadata({
+  versionName,
+  versionNames,
+  lastVersionName,
+  context,
+  options
+}) {
+  const isLast = versionName === lastVersionName;
+  const versionOptions = options.versions[versionName] ?? {};
+  const versionLabel = versionOptions.label ?? versionName === server.CURRENT_VERSION_NAME ? 'Next' : versionName;
+  let versionPathPart = versionOptions.path ?? versionName === server.CURRENT_VERSION_NAME ? 'next' : versionName;
+  if (isLast) {
+    versionPathPart = '';
+  }
+  const versionPath = utils.normalizeUrl([context.siteConfig.baseUrl, options.routeBasePath ?? 'api', versionPathPart]);
+  return {
+    isLast: versionName === lastVersionName,
+    routePriority: versionPathPart === '' ? -1 : undefined,
+    versionBadge: versionOptions?.badge ?? versionNames.length !== 1,
+    versionBanner: server.getDefaultVersionBanner({
+      context,
+      lastVersionName,
+      // @ts-expect-error Ignore internal options
+      options,
+      versionName,
+      versionNames
+    }),
+    versionClassName: versionOptions?.className ?? `api-version-${versionName}`,
+    versionLabel,
+    versionName,
+    versionPath
+  };
+}
+async function readVersionsMetadata(context, options) {
+  // Docusaurus internals require *every* option, but the versioning
+  // does not actually use them. We are casting the types here to
+  // ignore all the missing properties.
+  const specialOptions = options;
+  const versionNamesUnfiltered = await server.readVersionNames(context.siteDir, _objectSpread(_objectSpread({}, specialOptions), {}, {
+    disableVersioning: options.disableVersioning ?? false,
+    id: options.id ?? 'default',
+    includeCurrentVersion: options.includeCurrentVersion ?? true
+  }));
+  const versionNames = server.filterVersions(versionNamesUnfiltered, _objectSpread(_objectSpread({}, specialOptions), {}, {
+    onlyIncludeVersions: options.onlyIncludeVersions && options.onlyIncludeVersions.length > 0 ? options.onlyIncludeVersions : undefined
+  }));
+  const lastVersionName = options.lastVersion ? options.lastVersion : getDefaultLastVersionName(versionNames);
+  return versionNames.map(versionName => createVersionMetadata({
+    context,
+    lastVersionName,
+    options,
+    versionName,
+    versionNames
+  }));
+}
+exports.getVersionedDocsDirPath = getVersionedDocsDirPath;
+exports.readVersionsMetadata = readVersionsMetadata;
+//# sourceMappingURL=version.js.map