@openpkg-ts/cli 0.6.1 → 0.6.2

package/dist/bin/openpkg.js

@@ -9,7 +9,7 @@ import { Command as Command12 } from "commander";
 // package.json
 var package_default = {
   name: "@openpkg-ts/cli",
-  version: "0.6.1",
+  version: "0.6.2",
   description: "CLI for OpenPkg TypeScript API extraction and documentation generation",
   homepage: "https://github.com/ryanwaits/openpkg-ts#readme",
   repository: {
@@ -32,8 +32,8 @@ var package_default = {
     test: "bun test"
   },
   dependencies: {
-    "@openpkg-ts/adapters": "^0.3.4",
-    "@openpkg-ts/sdk": "^0.34.1",
+    "@openpkg-ts/adapters": "^0.3.5",
+    "@openpkg-ts/sdk": "^0.35.0",
     commander: "^14.0.0"
   },
   devDependencies: {
@@ -366,14 +366,33 @@ function getExtension(format) {
       return ".md";
   }
 }
+var VALID_KINDS = [
+  "function",
+  "class",
+  "variable",
+  "interface",
+  "type",
+  "enum",
+  "module",
+  "namespace",
+  "reference",
+  "external"
+];
 function applyFilters(spec, options) {
   let qb = query(spec);
   if (options.kind) {
-    const kinds = options.kind.split(",").map((k) => k.trim());
+    const kinds = options.kind.split(",").map((k) => k.trim()).filter(Boolean);
+    const invalid = kinds.filter((k) => !VALID_KINDS.includes(k));
+    if (invalid.length) {
+      throw new Error(`Invalid kind(s): ${invalid.join(", ")}. Valid: ${VALID_KINDS.join(", ")}`);
+    }
     qb = qb.byKind(...kinds);
   }
   if (options.tag) {
-    const tags = options.tag.split(",").map((t) => t.trim());
+    const tags = options.tag.split(",").map((t) => t.trim()).filter(Boolean);
+    if (tags.length === 0) {
+      throw new Error("--tag requires at least one non-empty tag");
+    }
     qb = qb.byTag(...tags);
   }
   if (options.search) {
@@ -418,6 +437,13 @@ function createGenerateCommand() {
   return new Command5("generate").description("Generate documentation from OpenPkg spec").argument("<spec>", "Path to openpkg.json spec file (use - for stdin)").option("-o, --output <path>", "Output file or directory (default: stdout)").option("-f, --format <format>", "Output format: md, json, html, react (default: md)", "md").option("--split", "Output one file per export (requires --output as directory)").option("-e, --export <name>", "Generate docs for a single export by name").option("-a, --adapter <name>", "Use adapter for generation (default: raw)").option("--collapse-unions <n>", "Collapse unions with more than N members").option("-k, --kind <kinds>", "Filter by kind(s), comma-separated").option("-t, --tag <tags>", "Filter by tag(s), comma-separated").option("-s, --search <term>", "Search name and description").option("--deprecated", "Only include deprecated exports").option("--no-deprecated", "Exclude deprecated exports").option("--variant <variant>", "React layout variant: full (single page) or index (links)", "full").option("--components-path <path>", "React components import path", "@/components/api").action(async (specPath, options) => {
     const format = options.format || "md";
     try {
+      if (options.collapseUnions) {
+        const n = parseInt(options.collapseUnions, 10);
+        if (Number.isNaN(n) || n < 1) {
+          console.error(JSON.stringify({ error: "--collapse-unions must be a positive integer" }));
+          process.exit(1);
+        }
+      }
       if (options.adapter && options.adapter !== "raw") {
         let getAdapter;
         try {
@@ -440,14 +466,24 @@ function createGenerateCommand() {
         let spec2;
         if (specPath === "-") {
           const input = await readStdin();
-          spec2 = JSON.parse(input);
+          try {
+            spec2 = JSON.parse(input);
+          } catch (err) {
+            const msg = err instanceof SyntaxError ? err.message : String(err);
+            throw new Error(`Invalid JSON in stdin: ${msg}`);
+          }
         } else {
           const specFile = path5.resolve(specPath);
           if (!fs5.existsSync(specFile)) {
             console.error(JSON.stringify({ error: `Spec file not found: ${specFile}` }));
             process.exit(1);
           }
-          spec2 = JSON.parse(fs5.readFileSync(specFile, "utf-8"));
+          try {
+            spec2 = JSON.parse(fs5.readFileSync(specFile, "utf-8"));
+          } catch (err) {
+            const msg = err instanceof SyntaxError ? err.message : String(err);
+            throw new Error(`Invalid JSON in ${specPath}: ${msg}`);
+          }
         }
         spec2 = applyFilters(spec2, options);
         await adapter.generate(spec2, path5.resolve(options.output));
@@ -457,14 +493,24 @@ function createGenerateCommand() {
       let spec;
       if (specPath === "-") {
         const input = await readStdin();
-        spec = JSON.parse(input);
+        try {
+          spec = JSON.parse(input);
+        } catch (err) {
+          const msg = err instanceof SyntaxError ? err.message : String(err);
+          throw new Error(`Invalid JSON in stdin: ${msg}`);
+        }
       } else {
         const specFile = path5.resolve(specPath);
         if (!fs5.existsSync(specFile)) {
           console.error(JSON.stringify({ error: `Spec file not found: ${specFile}` }));
           process.exit(1);
         }
-        spec = JSON.parse(fs5.readFileSync(specFile, "utf-8"));
+        try {
+          spec = JSON.parse(fs5.readFileSync(specFile, "utf-8"));
+        } catch (err) {
+          const msg = err instanceof SyntaxError ? err.message : String(err);
+          throw new Error(`Invalid JSON in ${specPath}: ${msg}`);
+        }
       }
       spec = applyFilters(spec, options);
       const docs = loadSpec4(spec);
@@ -555,7 +601,11 @@ function loadComponentsJson() {
   const configPath = path6.resolve(COMPONENTS_JSON);
   if (!fs6.existsSync(configPath))
     return null;
-  return JSON.parse(fs6.readFileSync(configPath, "utf-8"));
+  try {
+    return JSON.parse(fs6.readFileSync(configPath, "utf-8"));
+  } catch {
+    return null;
+  }
 }
 function createInitCommand() {
   return new Command6("init").description("Add @openpkg registry to components.json for shadcn CLI").option("--registry <url>", "Custom registry URL", REGISTRY_URL).action(async (options) => {
@@ -683,7 +733,7 @@ import {
 } from "@openpkg-ts/sdk";
 import { getValidationErrors } from "@openpkg-ts/spec";
 import { Command as Command11 } from "commander";
-var VALID_KINDS = [
+var VALID_KINDS2 = [
   "function",
   "class",
   "variable",
@@ -722,9 +772,9 @@ function parseList(val) {
   return val.split(",").map((s) => s.trim()).filter(Boolean);
 }
 function validateKinds(kinds) {
-  const invalid = kinds.filter((k) => !VALID_KINDS.includes(k));
+  const invalid = kinds.filter((k) => !VALID_KINDS2.includes(k));
   if (invalid.length > 0) {
-    throw new Error(`Invalid kind(s): ${invalid.join(", ")}. Valid kinds: ${VALID_KINDS.join(", ")}`);
+    throw new Error(`Invalid kind(s): ${invalid.join(", ")}. Valid kinds: ${VALID_KINDS2.join(", ")}`);
   }
   return kinds;
 }
@@ -738,7 +788,7 @@ function formatDiagnostics(diagnostics) {
   }));
 }
 function createSnapshotSubcommand() {
-  return new Command11("snapshot").description("Generate full OpenPkg spec from TypeScript entry point").argument("<entry>", "Entry point file path").option("-o, --output <file>", "Output file (default: openpkg.json)", "openpkg.json").option("--max-depth <n>", "Max type depth (default: 4)", "4").option("--skip-resolve", "Skip external type resolution").option("--runtime", "Enable Standard Schema runtime extraction").option("--only <exports>", "Filter exports (comma-separated)").option("--ignore <exports>", "Ignore exports (comma-separated)").option("--verify", "Exit 1 if any exports fail").option("--verbose", "Show detailed output").option("--include-private", "Include private/protected class members").option("--external-include <patterns...>", "Resolve re-exports from these packages").option("--external-exclude <patterns...>", "Never resolve from these packages").option("--external-depth <n>", "Max transitive depth for external resolution", "1").action(async (entry, options) => {
+  return new Command11("snapshot").description("Generate full OpenPkg spec from TypeScript entry point").argument("<entry>", "Entry point file path").option("-o, --output <file>", "Output file (default: openpkg.json)", "openpkg.json").option("--max-depth <n>", "Max type depth (default: 4)", "4").option("--skip-resolve", "Skip external type resolution").option("--runtime", "Enable Standard Schema runtime extraction").option("--only <exports>", "Filter exports (comma-separated)").option("--ignore <exports>", "Ignore exports (comma-separated)").option("--verify", "Exit 1 if any exports fail").option("--verbose", "Show detailed output").option("--quiet", "Suppress extraction warnings").option("--strict", "Exit 1 if any extraction warnings").option("--include-private", "Include private/protected class members").option("--external-include <patterns...>", "Resolve re-exports from these packages").option("--external-exclude <patterns...>", "Never resolve from these packages").option("--external-depth <n>", "Max transitive depth for external resolution", "1").action(async (entry, options) => {
     const entryFile = path8.resolve(entry);
     const entryDir = path8.dirname(entryFile);
     const fileConfig = loadConfig(entryDir);
@@ -781,6 +831,21 @@ function createSnapshotSubcommand() {
         ...externalExports.length > 0 && { external: { count: externalExports.length } }
       };
       console.error(JSON.stringify(summary, null, 2));
+      const extractionWarnings = result.runtimeSchemas?.warnings ?? [];
+      if (extractionWarnings.length > 0 && !options.quiet) {
+        console.error(`
+Skipped ${extractionWarnings.length} schema(s) with extraction errors:`);
+        for (const w of extractionWarnings) {
+          console.error(`  - ${w.exportName ?? "unknown"}: ${w.code} - ${w.message}`);
+        }
+      }
+      if (options.strict && extractionWarnings.length > 0) {
+        console.error(JSON.stringify({
+          error: "Extraction warnings present (--strict mode)",
+          warnings: extractionWarnings
+        }, null, 2));
+        process.exit(1);
+      }
       if (options.verify && result.verification && result.verification.failed > 0) {
         console.error(JSON.stringify({
           error: "Export verification failed",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openpkg-ts/cli",
-  "version": "0.6.1",
+  "version": "0.6.2",
   "description": "CLI for OpenPkg TypeScript API extraction and documentation generation",
   "homepage": "https://github.com/ryanwaits/openpkg-ts#readme",
   "repository": {
@@ -23,8 +23,8 @@
     "test": "bun test"
   },
   "dependencies": {
-    "@openpkg-ts/adapters": "^0.3.4",
-    "@openpkg-ts/sdk": "^0.34.1",
+    "@openpkg-ts/adapters": "^0.3.5",
+    "@openpkg-ts/sdk": "^0.35.0",
     "commander": "^14.0.0"
   },
   "devDependencies": {