From 9ab0c7ccf060d6778341927dfddd276a51c8145e Mon Sep 17 00:00:00 2001
From: aramissennyeydd <aramis.sennyey@doordash.com>
Date: Fri, 14 Feb 2025 10:59:04 -0500
Subject: [PATCH] move to a peer dep and hide the command

Signed-off-by: aramissennyeydd <aramis.sennyey@doordash.com>
---
 package.json                                             | 1 +
 packages/repo-tools/package.json                         | 8 ++++++--
 packages/repo-tools/src/commands/index.ts                | 3 ++-
 packages/repo-tools/src/commands/package-docs/command.ts | 6 +++++-
 yarn.lock                                                | 4 ++++
 5 files changed, 18 insertions(+), 4 deletions(-)

diff --git a/package.json b/package.json
index 37ef893865..5444b44e42 100644
--- a/package.json
+++ b/package.json
@@ -134,6 +134,7 @@
     "shx": "^0.3.2",
     "sloc": "^0.3.1",
     "sort-package-json": "^2.8.0",
+    "typedoc": "^0.27.6",
     "typescript": "~5.2.0"
   },
   "packageManager": "yarn@3.8.1",
diff --git a/packages/repo-tools/package.json b/packages/repo-tools/package.json
index 63682dc484..a4689c1d82 100644
--- a/packages/repo-tools/package.json
+++ b/packages/repo-tools/package.json
@@ -81,7 +81,6 @@
     "portfinder": "^1.0.32",
     "tar": "^6.1.12",
     "ts-morph": "^24.0.0",
-    "typedoc": "^0.27.6",
     "yaml-diff-patch": "^2.0.0"
   },
   "devDependencies": {
@@ -90,7 +89,8 @@
     "@backstage/types": "workspace:^",
     "@types/is-glob": "^4.0.2",
     "@types/node": "^20.16.0",
-    "@types/prettier": "^2.0.0"
+    "@types/prettier": "^2.0.0",
+    "typedoc": "^0.27.6"
   },
   "peerDependencies": {
     "@microsoft/api-extractor-model": "*",
@@ -98,11 +98,15 @@
     "@microsoft/tsdoc-config": "*",
     "@useoptic/optic": "^1.0.0",
     "prettier": "^2.8.1",
+    "typedoc": "^0.27.0",
     "typescript": "> 3.0.0"
   },
   "peerDependenciesMeta": {
     "prettier": {
       "optional": true
+    },
+    "typedoc": {
+      "optional": true
     }
   }
 }
diff --git a/packages/repo-tools/src/commands/index.ts b/packages/repo-tools/src/commands/index.ts
index 773ba3b024..b737d918bd 100644
--- a/packages/repo-tools/src/commands/index.ts
+++ b/packages/repo-tools/src/commands/index.ts
@@ -263,7 +263,8 @@ export function registerCommands(program: Command) {
     );
 
   program
-    .command('package-docs [paths...]')
+    .command('package-docs [paths...]', { hidden: true })
+    .description('EXPERIMENTAL: Generate package documentation')
     .action(lazy(() => import('./package-docs/command'), 'default'));
 
   registerPackageCommand(program);
diff --git a/packages/repo-tools/src/commands/package-docs/command.ts b/packages/repo-tools/src/commands/package-docs/command.ts
index 7f6b950b10..8c30b06145 100644
--- a/packages/repo-tools/src/commands/package-docs/command.ts
+++ b/packages/repo-tools/src/commands/package-docs/command.ts
@@ -71,7 +71,10 @@ async function generateDocJson(pkg: string) {
   );
 
   const exports = getExports(packageJson);
-  if (!exports.length || !exports.some(e => e.startsWith('src'))) {
+  if (
+    !exports.length ||
+    !exports.some(e => e.startsWith('src') || e.startsWith('./src'))
+  ) {
     return;
   }
 
@@ -110,6 +113,7 @@ async function generateDocJson(pkg: string) {
 }
 
 export default async function packageDocs(paths: string[] = [], opts: any) {
+  console.warn('!!! This is an experimental command !!!');
   const selectedPackageDirs = await resolvePackagePaths({
     paths,
     include: opts.include,
diff --git a/yarn.lock b/yarn.lock
index bf00de630b..9f5a98ab5b 100644
--- a/yarn.lock
+++ b/yarn.lock
@@ -8733,10 +8733,13 @@ __metadata:
     "@microsoft/tsdoc-config": "*"
     "@useoptic/optic": ^1.0.0
     prettier: ^2.8.1
+    typedoc: ^0.27.0
     typescript: "> 3.0.0"
   peerDependenciesMeta:
     prettier:
       optional: true
+    typedoc:
+      optional: true
   bin:
     backstage-repo-tools: bin/backstage-repo-tools
   languageName: unknown
@@ -42812,6 +42815,7 @@ __metadata:
     shx: ^0.3.2
     sloc: ^0.3.1
     sort-package-json: ^2.8.0
+    typedoc: ^0.27.6
     typescript: ~5.2.0
   languageName: unknown
   linkType: soft