@openpkg-ts/cli 0.10.0 → 0.11.1

package/dist/index.js

@@ -13,12 +13,14 @@ import {
   getAvailableVersions,
   getValidationErrors,
   listExports,
+  loadConfig,
+  mergeConfig,
   recommendSemverBump
 } from "@openpkg-ts/sdk";
 var HELP = `openpkg - extract TypeScript API specs and generate docs
 
 Usage:
-  openpkg spec <entry.ts> [-o spec.json]
+  openpkg spec <entry.ts> [-o spec.json] [--follow-external <pkg,...>]
   openpkg docs <entry.ts | spec.json> [-f md|html|json] [-o out]
   openpkg list <entry.ts> [--json]
   openpkg validate <spec.json>
@@ -32,11 +34,20 @@ Commands:
   diff      Compare two spec files and recommend a semver bump
 
 Options:
-  -o, --output   Write to file instead of stdout
-  -f, --format   docs output format: md (default), html, json
-      --json     list/diff output as JSON
-  -h, --help     Show this help
-  -v, --version  Show version
+  -o, --output            Write to file instead of stdout
+  -f, --format            docs output format: md (default), html, json
+      --json              list/diff output as JSON
+      --follow-external   Expand types from these packages (comma-separated,
+                          globs ok: "@ai-sdk/*"). Default: stub externals.
+      --follow-external-all   Expand every external package (use with care)
+      --only              Only extract these exports (comma-separated, * ok)
+      --ignore            Ignore these exports (comma-separated, * ok)
+  -h, --help              Show this help
+  -v, --version           Show version
+
+Config: reads openpkg.config.json (or package.json "openpkg" field) from the
+cwd. Flags override the file. Example openpkg.config.json:
+  { "followExternal": ["@acme/payment-kit", "@ai-sdk/*"] }
 `;
 function fail(message) {
   console.error(`error: ${message}`);
@@ -65,17 +76,59 @@ function reportDiagnostics(diagnostics) {
     process.exit(1);
   }
 }
+function toList(value) {
+  if (!value)
+    return;
+  const items = value.split(",").map((s) => s.trim()).filter(Boolean);
+  return items.length > 0 ? items : undefined;
+}
+function reportStubbedExternals(spec) {
+  const counts = new Map;
+  for (const t of spec.types ?? []) {
+    if (!t.external)
+      continue;
+    const pkg = t.schema?.["x-ts-package"];
+    const key = typeof pkg === "string" ? pkg : "(unknown origin)";
+    counts.set(key, (counts.get(key) ?? 0) + 1);
+  }
+  if (counts.size === 0)
+    return;
+  const summary = [...counts.entries()].sort((a, b) => b[1] - a[1]).map(([pkg, n]) => `${pkg} (${n})`).join(", ");
+  console.error(`external types stubbed from: ${summary}`);
+  console.error("  → add package names to followExternal (config or --follow-external) to expand them");
+}
 async function specCommand(args) {
   const { values, positionals } = parseArgs({
     args,
-    options: { output: { type: "string", short: "o" } },
+    options: {
+      output: { type: "string", short: "o" },
+      "follow-external": { type: "string" },
+      "follow-external-all": { type: "boolean" },
+      only: { type: "string" },
+      ignore: { type: "string" }
+    },
     allowPositionals: true
   });
   const entryFile = positionals[0];
   if (!entryFile)
     fail("spec requires an entry file (openpkg spec src/index.ts)");
-  const { spec, diagnostics } = await extractSpec({ entryFile });
+  const fileConfig = loadConfig(process.cwd());
+  const cliConfig = {
+    followExternal: values["follow-external-all"] ? true : toList(values["follow-external"]),
+    only: toList(values.only),
+    ignore: toList(values.ignore)
+  };
+  const config = mergeConfig(fileConfig, cliConfig);
+  const { spec, diagnostics } = await extractSpec({
+    entryFile,
+    followExternal: config.followExternal,
+    only: config.only,
+    ignore: config.ignore,
+    externals: config.externals
+  });
   reportDiagnostics(diagnostics);
+  if (!config.followExternal)
+    reportStubbedExternals(spec);
   write(JSON.stringify(spec, null, 2), values.output);
 }
 async function docsCommand(args) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openpkg-ts/cli",
-  "version": "0.10.0",
+  "version": "0.11.1",
   "description": "CLI for OpenPkg - extract TypeScript API specs and generate docs",
   "keywords": [
     "openpkg",
@@ -35,7 +35,7 @@
     "test": "bun test"
   },
   "dependencies": {
-    "@openpkg-ts/sdk": "^0.47.0"
+    "@openpkg-ts/sdk": "^0.49.0"
   },
   "devDependencies": {
     "@types/bun": "latest",