@openpkg-ts/extract 0.26.0 → 0.27.0

package/dist/bin/tspec.js

@@ -3,7 +3,7 @@ import {
   detectTsRuntime,
   extract,
   resolveCompiledPath
-} from "../shared/chunk-xamjhe27.js";
+} from "../shared/chunk-v9c97d62.js";
 
 // src/cli/spec.ts
 import * as fs from "node:fs";
@@ -412,7 +412,7 @@ function summary(options) {
 }
 // src/cli/spec.ts
 function createProgram() {
-  const program = new Command("tspec").description("Extract TypeScript package API to OpenPkg spec").argument("[entry]", "Entry point file").option("-o, --output <file>", "Output file", "openpkg.json").option("--max-depth <n>", "Max type depth (default: 4)").option("--skip-resolve", "Skip external type resolution").option("--runtime", "Enable Standard Schema runtime extraction").option("--only <exports>", "Only extract these exports (comma-separated, supports * wildcards)").option("--ignore <exports>", "Ignore these exports (comma-separated, supports * wildcards)").option("-v, --verbose", "Show detailed output").action(async (entry, options) => {
+  const program = new Command("tspec").description("Extract TypeScript package API to OpenPkg spec").argument("[entry]", "Entry point file").option("-o, --output <file>", "Output file", "openpkg.json").option("--max-depth <n>", "Max type depth (default: 4)").option("--skip-resolve", "Skip external type resolution").option("--runtime", "Enable Standard Schema runtime extraction").option("--only <exports>", "Only extract these exports (comma-separated, supports * wildcards)").option("--ignore <exports>", "Ignore these exports (comma-separated, supports * wildcards)").option("-v, --verbose", "Show detailed output").option("--verify", "Enable export count verification mode (exit 1 on failures)").action(async (entry, options) => {
     let entryFile;
     let fromDts = false;
     if (entry) {
@@ -499,7 +499,34 @@ Extraction completed in declaration-only mode:`);
     if (result.runtimeSchemas) {
       sum.addKeyValue("Runtime Schemas", result.runtimeSchemas.merged);
     }
+    if (result.verification) {
+      const v = result.verification;
+      sum.addKeyValue("Discovered", v.discovered);
+      sum.addKeyValue("Extracted", v.extracted);
+      if (v.failed > 0) {
+        sum.addWithThreshold("Failed", v.failed, { value: 0, operator: "<=" });
+      }
+    }
     sum.print();
+    if (result.verification?.failed) {
+      console.log(`
+Failed exports:`);
+      for (const f of result.verification.details.failed) {
+        console.log(`  - ${f.name}: ${f.error}`);
+      }
+    }
+    if (options.verbose && result.verification?.details.skipped.length) {
+      console.log(`
+Skipped exports:`);
+      for (const s of result.verification.details.skipped) {
+        console.log(`  - ${s.name}: ${s.reason}`);
+      }
+    }
+    if (options.verify && result.verification?.failed) {
+      const v = result.verification;
+      spin.fail(`Expected ${v.discovered} exports, got ${v.extracted}`);
+      process.exit(1);
+    }
   });
   return program;
 }

package/dist/shared/{chunk-xamjhe27.js → chunk-v9c97d62.js}

@@ -3142,6 +3142,31 @@ function computeDegradedStats(exports) {
   }
   return { exportsWithoutDescription, paramsWithoutDocs, missingExamples };
 }
+function buildVerificationSummary(discoveredCount, extractedCount, tracker) {
+  const skippedDetails = [];
+  const failedDetails = [];
+  for (const entry of tracker.values()) {
+    if (entry.status === "skipped" && entry.skipReason) {
+      skippedDetails.push({ name: entry.name, reason: entry.skipReason });
+    } else if (entry.status === "failed" && entry.error) {
+      failedDetails.push({ name: entry.name, error: entry.error });
+    }
+  }
+  const skipped = skippedDetails.length;
+  const failed = failedDetails.length;
+  const delta = discoveredCount - extractedCount - skipped;
+  return {
+    discovered: discoveredCount,
+    extracted: extractedCount,
+    skipped,
+    failed,
+    delta,
+    details: {
+      skipped: skippedDetails,
+      failed: failedDetails
+    }
+  };
+}
 var BUILTIN_TYPES2 = new Set([
   "Array",
   "ArrayBuffer",
@@ -3263,6 +3288,17 @@ async function extract(options) {
   for (const symbol of exportedSymbols) {
     exportedIds.add(symbol.getName());
   }
+  const exportTracker = new Map;
+  for (const symbol of exportedSymbols) {
+    const name = symbol.getName();
+    const included = shouldIncludeExport(name, only, ignore);
+    exportTracker.set(name, {
+      name,
+      discovered: true,
+      status: included ? "pending" : "skipped",
+      ...included ? {} : { skipReason: "filtered" }
+    });
+  }
   const ctx = createContext(program, sourceFile, {
     maxTypeDepth,
     maxExternalTypeDepth,
@@ -3274,24 +3310,39 @@ async function extract(options) {
   for (let i = 0;i < filteredSymbols.length; i++) {
     const symbol = filteredSymbols[i];
     const exportName = symbol.getName();
+    const tracker = exportTracker.get(exportName);
     onProgress?.(i + 1, total, exportName);
     if (i > 0 && i % YIELD_BATCH_SIZE === 0) {
       await new Promise((r) => setImmediate(r));
     }
     try {
       const { declaration, targetSymbol } = resolveExportTarget(symbol, typeChecker);
-      if (!declaration)
+      if (!declaration) {
+        tracker.status = "skipped";
+        tracker.skipReason = "no-declaration";
         continue;
+      }
       const exp = serializeDeclaration(declaration, symbol, targetSymbol, exportName, ctx);
-      if (exp)
+      if (exp) {
         exports.push(exp);
+        tracker.status = "success";
+        tracker.kind = exp.kind;
+      } else {
+        tracker.status = "skipped";
+        tracker.skipReason = "internal";
+      }
     } catch (err) {
+      const errorMsg = err instanceof Error ? err.message : String(err);
+      tracker.status = "failed";
+      tracker.error = errorMsg;
       diagnostics.push({
-        message: `Failed to serialize ${exportName}: ${err}`,
-        severity: "warning"
+        message: `Failed to serialize '${exportName}': ${errorMsg}`,
+        severity: "warning",
+        code: "SERIALIZATION_FAILED"
       });
     }
   }
+  const verification = buildVerificationSummary(exportedSymbols.length, exports.length, exportTracker);
   const meta = await getPackageMeta(entryFile, baseDir);
   const types = ctx.typeRegistry.getAll();
   const projectBaseDir = baseDir ?? path3.dirname(entryFile);
@@ -3372,9 +3423,19 @@ async function extract(options) {
   };
   const internalForgotten = forgottenExports.filter((f) => !f.isExternal);
   const degradedMode = isDtsSource ? { reason: "dts-source", stats: computeDegradedStats(normalizedExports) } : undefined;
+  if (verification.failed > 0) {
+    const failedNames = verification.details.failed.map((f) => f.name).join(", ");
+    diagnostics.push({
+      message: `Export verification: ${verification.failed} export(s) failed: ${failedNames}`,
+      severity: "warning",
+      code: "EXPORT_VERIFICATION_FAILED",
+      suggestion: "Check serialization errors for these exports"
+    });
+  }
   return {
     spec,
     diagnostics,
+    verification,
     ...internalForgotten.length > 0 ? { forgottenExports: internalForgotten } : {},
     ...runtimeMetadata ? { runtimeSchemas: runtimeMetadata } : {},
     ...degradedMode ? { degradedMode } : {}

package/dist/src/index.d.ts

@@ -268,6 +268,8 @@ interface ExtractResult {
 			missingExamples: number;
 		};
 	};
+	/** Export verification comparing discovered vs extracted */
+	verification?: ExportVerification;
 }
 interface Diagnostic {
 	message: string;
@@ -295,6 +297,29 @@ interface ForgottenExport {
 	isExternal: boolean;
 	fix?: string;
 }
+/** Verification result comparing discovered vs extracted exports */
+interface ExportVerification {
+	/** Total exports discovered by TypeScript */
+	discovered: number;
+	/** Exports successfully extracted */
+	extracted: number;
+	/** Exports skipped (filtered, no-declaration, internal) */
+	skipped: number;
+	/** Exports that failed during serialization */
+	failed: number;
+	/** Delta: discovered - extracted */
+	delta: number;
+	details: {
+		skipped: Array<{
+			name: string;
+			reason: "filtered" | "no-declaration" | "internal";
+		}>;
+		failed: Array<{
+			name: string;
+			error: string;
+		}>;
+	};
+}
 declare function extract(options: ExtractOptions): Promise<ExtractResult>;
 import ts4 from "typescript";
 interface ProgramOptions {

package/dist/src/index.js

@@ -48,7 +48,7 @@ import {
   valibotAdapter,
   withDescription,
   zodAdapter
-} from "../shared/chunk-xamjhe27.js";
+} from "../shared/chunk-v9c97d62.js";
 // src/types/utils.ts
 function isExported(node) {
   const modifiers = node.modifiers;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openpkg-ts/extract",
-  "version": "0.26.0",
+  "version": "0.27.0",
   "description": "TypeScript export extraction to OpenPkg spec",
   "keywords": [
     "openpkg",