@backstage/repo-tools 0.19.2 → 0.19.3-next.1

package/CHANGELOG.md

@@ -1,5 +1,29 @@
 # @backstage/repo-tools
 
+## 0.19.3-next.1
+
+### Patch Changes
+
+- 1892d2f: chore(deps): bump `minimatch` from 10.2.6 to 11.0.1
+- 9120c46: Updated dependency `glob` to `^14.0.0`.
+- 5eb2381: The generated API reference documentation no longer overwrites pages when a package exports declarations whose names only differ in case, or that share a name but are of different kinds, for example a variable and an interface or namespace. One of them keeps the existing page, and the others get a page with their kind added to the filename, for example `-interface` or `-namespace`, or a number if they are of the same kind.
+- 1fba2bb: The peer dependency check no longer enforces a shared `react-router-dom` version, so packages can declare their own supported major version. See the [1.57 migration notes](https://backstage.io/docs/frontend-system/architecture/migrations#157) for background on the routing changes this supports.
+- Updated dependencies
+  - @backstage/cli-node@0.3.6-next.2
+  - @backstage/backend-plugin-api@1.12.0-next.1
+  - @backstage/errors@1.4.0-next.0
+  - @backstage/catalog-model@1.10.3-next.0
+  - @backstage/cli-common@0.3.3-next.0
+  - @backstage/config-loader@1.11.5-next.0
+
+## 0.19.3-next.0
+
+### Patch Changes
+
+- Updated dependencies
+  - @backstage/cli-node@0.3.6-next.0
+  - @backstage/backend-plugin-api@1.11.1-next.0
+
 ## 0.19.2
 
 ### Patch Changes

package/dist/commands/api-reports/api-reports/buildDocs.cjs.js

@@ -14,6 +14,61 @@ function _interopDefaultCompat (e) { return e && typeof e === 'object' && 'defau
 
 var fs__default = /*#__PURE__*/_interopDefaultCompat(fs);
 
+const FILENAME_KIND_PRIORITY = [
+  apiExtractorModel.ApiItemKind.Class,
+  apiExtractorModel.ApiItemKind.Function,
+  apiExtractorModel.ApiItemKind.Variable,
+  apiExtractorModel.ApiItemKind.Enum,
+  apiExtractorModel.ApiItemKind.Namespace,
+  apiExtractorModel.ApiItemKind.Interface,
+  apiExtractorModel.ApiItemKind.TypeAlias
+];
+const SKIPPED_FILENAME_KINDS = [
+  apiExtractorModel.ApiItemKind.Model,
+  apiExtractorModel.ApiItemKind.EntryPoint,
+  apiExtractorModel.ApiItemKind.EnumMember,
+  apiExtractorModel.ApiItemKind.Package
+];
+function getKindPriority(kind) {
+  const index = FILENAME_KIND_PRIORITY.indexOf(kind);
+  return index === -1 ? FILENAME_KIND_PRIORITY.length : index;
+}
+function compareCollidingItems(a, b) {
+  const byKind = getKindPriority(a.kind) - getKindPriority(b.kind);
+  if (byKind !== 0) {
+    return byKind;
+  }
+  if (a.displayName === b.displayName) {
+    return 0;
+  }
+  return a.displayName < b.displayName ? -1 : 1;
+}
+function getCollisionSuffix(item) {
+  const name = item.displayName.toLowerCase();
+  const siblings = item.parent?.members ?? [];
+  const colliding = siblings.filter(
+    (sibling) => sibling === item || sibling.displayName.toLowerCase() === name && (sibling.kind !== item.kind || sibling.displayName !== item.displayName)
+  ).sort(compareCollidingItems);
+  if (colliding[0] === item) {
+    return "";
+  }
+  const sameKind = colliding.filter((sibling) => sibling.kind === item.kind);
+  const kindSuffix = colliding[0].kind === item.kind ? "" : `-${item.kind.toLowerCase()}`;
+  const index = sameKind.indexOf(item);
+  const isFirstOfKind = index === 0 && kindSuffix !== "";
+  return isFirstOfKind ? kindSuffix : `${kindSuffix}-${index + 1}`;
+}
+function disambiguateFilename(filename, apiItem) {
+  const segments = filename.slice(0, -".md".length).split(".");
+  const items = apiItem.getHierarchy().filter((item) => !SKIPPED_FILENAME_KINDS.includes(item.kind));
+  if (segments.length !== items.length + 1) {
+    return filename;
+  }
+  items.forEach((item, index) => {
+    segments[index + 1] += getCollisionSuffix(item);
+  });
+  return `${segments.join(".")}.md`;
+}
 class ExcerptTokenMatcher {
   #tokens;
   constructor(tokens) {
@@ -308,7 +363,10 @@ async function buildDocs({
       this._markdownEmitter = new CustomCustomMarkdownEmitter(newModel);
     }
     _getFilenameForApiItem(apiItem) {
-      const filename = super._getFilenameForApiItem(apiItem);
+      let filename = super._getFilenameForApiItem(apiItem);
+      if (filename !== "index.md") {
+        filename = disambiguateFilename(filename, apiItem);
+      }
       if (filename.includes(".html.")) {
         return filename.replace(/\.html\./g, "._html.");
       }
@@ -440,4 +498,5 @@ async function buildDocs({
 }
 
 exports.buildDocs = buildDocs;
+exports.disambiguateFilename = disambiguateFilename;
 //# sourceMappingURL=buildDocs.cjs.js.map

package/dist/commands/peer-deps/peer-deps.cjs.js

@@ -9,22 +9,23 @@ var fs = require('node:fs');
 const desiredLocalVersionsOfDependencies = {
   "@types/react": "^18.0.0",
   react: "^18.0.2",
-  "react-dom": "^18.0.2",
-  "react-router-dom": "^6.30.2"
+  "react-dom": "^18.0.2"
 };
 const peerDependencies = {
   "@types/react": "^17.0.0 || ^18.0.0",
   react: "^17.0.0 || ^18.0.0",
-  "react-dom": "^17.0.0 || ^18.0.0",
-  "react-router-dom": "^6.30.2"
+  "react-dom": "^17.0.0 || ^18.0.0"
 };
 const peerDependenciesReact18Only = {
   "@types/react": "^18.0.0",
   react: "^18.0.0",
-  "react-dom": "^18.0.0",
-  "react-router-dom": "^6.30.2"
+  "react-dom": "^18.0.0"
 };
-const react18OnlyPackages = /* @__PURE__ */ new Set(["@backstage/ui"]);
+const react18OnlyPackages = /* @__PURE__ */ new Set([
+  "@backstage/frontend-adapter-react-router-v7",
+  "@backstage/frontend-adapter-tanstack-router",
+  "@backstage/ui"
+]);
 const groupsOfPeerDependencies = [["@types/react", "react", "react-dom"]];
 const optionalPeerDependencies = /* @__PURE__ */ new Set(["@types/react"]);
 const isOptional = (dep) => {

package/dist/package.json.cjs.js

@@ -1,6 +1,6 @@
 'use strict';
 
-var version = "0.19.2";
+var version = "0.19.3-next.1";
 
 exports.version = version;
 //# sourceMappingURL=package.json.cjs.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@backstage/repo-tools",
-  "version": "0.19.2",
+  "version": "0.19.3-next.1",
   "description": "CLI for Backstage repo tooling ",
   "backstage": {
     "role": "cli"
@@ -43,12 +43,12 @@
   "dependencies": {
     "@apidevtools/swagger-parser": "^10.1.0",
     "@apisyouwonthate/style-guide": "^1.4.0",
-    "@backstage/backend-plugin-api": "^1.11.0",
-    "@backstage/catalog-model": "^1.10.2",
-    "@backstage/cli-common": "^0.3.2",
-    "@backstage/cli-node": "^0.3.5",
-    "@backstage/config-loader": "^1.11.4",
-    "@backstage/errors": "^1.3.2",
+    "@backstage/backend-plugin-api": "1.12.0-next.1",
+    "@backstage/catalog-model": "1.10.3-next.0",
+    "@backstage/cli-common": "0.3.3-next.0",
+    "@backstage/cli-node": "0.3.6-next.2",
+    "@backstage/config-loader": "1.11.5-next.0",
+    "@backstage/errors": "1.4.0-next.0",
     "@electric-sql/pglite": "^0.5.8",
     "@manypkg/get-packages": "^1.1.3",
     "@microsoft/api-documenter": "^7.28.1",
@@ -69,7 +69,7 @@
     "commander": "^14.0.3",
     "diff": "^9.0.0",
     "fs-extra": "^11.2.0",
-    "glob": "^13.0.0",
+    "glob": "^14.0.0",
     "globby": "^11.0.0",
     "is-glob": "^4.0.3",
     "js-yaml": "^5.0.0",
@@ -78,7 +78,7 @@
     "knex-pglite": "^0.14.0",
     "knip": "^5.42.0",
     "lodash": "^4.17.21",
-    "minimatch": "^10.2.1",
+    "minimatch": "^11.0.1",
     "openapi-types": "^12.0.0",
     "p-limit": "^3.0.2",
     "tar": "^7.5.21",
@@ -87,11 +87,11 @@
     "zod": "^3.25.76 || ^4.0.0"
   },
   "devDependencies": {
-    "@backstage/backend-test-utils": "^1.11.8",
-    "@backstage/cli": "^0.36.7",
-    "@backstage/types": "^1.2.2",
+    "@backstage/backend-test-utils": "1.12.0-next.2",
+    "@backstage/cli": "0.36.8-next.2",
+    "@backstage/types": "1.2.2",
     "@types/is-glob": "^4.0.2",
-    "@types/node": "^22.13.14",
+    "@types/node": "^24.0.0",
     "@types/prettier": "^2.0.0",
     "typedoc": "^0.28.0"
   },