describe-package: document anything with an @function tag

Not sure I like this but it's consistent with the main docsite

packages/describe-package/package.json

@@ -32,7 +32,8 @@
     "build:worker": "tsm esbuild-worker.ts",
     "build:node": "tsup --config tsup.config.js src/index.ts",
     "build": "pnpm clean && pnpm build:node && pnpm build:worker",
-    "pack": "pnpm pack --pack-destination ../../dist"
+    "pack": "pnpm pack --pack-destination ../../dist",
+    "cli": "npx tsx src/cli.ts"
   },
   "keywords": [],
   "devDependencies": {
@@ -44,7 +45,6 @@
     "esbuild": "^0.18.14",
     "rimraf": "^3.0.2",
     "threads": "1.7.0",
-    "ts-node": "^10.9.1",
     "tslib": "^2.4.0",
     "tsm": "^2.2.1",
     "tsup": "^7.2.0"

packages/describe-package/src/api.ts

@@ -64,7 +64,7 @@ export type ParameterDescription = {
  */
 export const describePackage = async (
   specifier: string,
-  _options: Options
+  _options: Options = {}
 ): Promise<PackageDescription> => {
   const { name, version } = getNameAndVersion(specifier);
   const project = new Project();

packages/describe-package/src/cli.ts

@@ -0,0 +1,12 @@
+import { describePackage } from './api';
+
+const a = process.argv[2];
+
+async function run(specifier: string) {
+  const result = await describePackage(specifier, {});
+
+  console.log(result);
+}
+
+console.log('GENERATING FOR', a);
+run(a);

packages/describe-package/src/describe-project.ts

@@ -97,7 +97,7 @@ const describeProject = (
         return true;
       }
       // Return all export aliases and public symbols
-      return symbol.isExportAlias || symbol.isPublic;
+      return symbol.isExportAlias || symbol.hasFunctionTag;
     })
     .reduce((symbols, symbol) => {
       if (symbol.isFunctionDeclaration) {

packages/describe-package/src/typescript/wrapped-symbol.ts

@@ -86,10 +86,11 @@ export class WrappedSymbol {
     return this.symbol.valueDeclaration?.type;
   }
 
-  // A function is private unless it has a public tag
-  public get isPublic(): boolean {
-    return this.jsDocTags.some(
-      (tag: ts.JSDocTag) => tag.tagName.escapedText === 'public'
+  public get hasFunctionTag(): boolean {
+    return Boolean(
+      this.jsDocTags.find(
+        (tag: ts.JSDocTag) => tag.tagName.escapedText === 'function'
+      )
     );
   }
 

packages/describe-package/tsconfig.json

@@ -4,6 +4,7 @@
   "exclude": ["node_modules", "**/*.spec.ts", "dist"],
   "compilerOptions": {
     "typeRoots": ["./node_modules/@types"],
-    "target": "ESNext"
+    "target": "ESNext",
+    "esModuleInterop": true,
   }
 }