@openpkg-ts/extract 0.16.0 → 0.17.0

package/dist/bin/tspec.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   extract
-} from "../shared/chunk-2v40ecks.js";
+} from "../shared/chunk-6p1dq6jb.js";
 
 // src/cli/spec.ts
 import * as fs from "node:fs";
@@ -1488,7 +1488,7 @@ function summary(options) {
 import { normalize, validateSpec } from "@openpkg-ts/spec";
 import { Command } from "commander";
 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("-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").action(async (entry, options) => {
     let entryFile;
     let fromDts = false;
     if (entry) {
@@ -1513,7 +1513,9 @@ function createProgram() {
       entryFile: path.resolve(entryFile),
       ...options.maxDepth ? { maxTypeDepth: parseInt(options.maxDepth) } : {},
       resolveExternalTypes: !options.skipResolve,
-      schemaExtraction: options.runtime ? "hybrid" : "static"
+      schemaExtraction: options.runtime ? "hybrid" : "static",
+      ...options.only ? { only: options.only.split(",").map((s) => s.trim()) } : {},
+      ...options.ignore ? { ignore: options.ignore.split(",").map((s) => s.trim()) } : {}
     });
     const normalized = normalize(result.spec);
     const validation = validateSpec(normalized);

package/dist/shared/{chunk-2v40ecks.js → chunk-6p1dq6jb.js}

@@ -661,12 +661,33 @@ function parseExamplesFromTags(tags) {
   }
   return examples;
 }
+function stripParamSeparator(text) {
+  if (!text)
+    return;
+  const stripped = text.replace(/^-\s*/, "").trim();
+  return stripped || undefined;
+}
+function stripTypeParamSeparator(text) {
+  if (!text)
+    return;
+  const match = text.match(/^\w+\s+-\s*(.*)$/s);
+  if (match) {
+    return match[1].trim() || undefined;
+  }
+  return text.trim() || undefined;
+}
 function getJSDocComment(node) {
   const jsDocTags = ts3.getJSDocTags(node);
-  const tags = jsDocTags.map((tag) => ({
-    name: tag.tagName.text,
-    text: typeof tag.comment === "string" ? tag.comment : ts3.getTextOfJSDocComment(tag.comment) ?? ""
-  }));
+  const tags = jsDocTags.map((tag) => {
+    const rawText = typeof tag.comment === "string" ? tag.comment : ts3.getTextOfJSDocComment(tag.comment) ?? "";
+    let text = rawText;
+    if (tag.tagName.text === "param") {
+      text = stripParamSeparator(rawText) ?? "";
+    } else if (tag.tagName.text === "typeParam") {
+      text = stripTypeParamSeparator(rawText) ?? "";
+    }
+    return { name: tag.tagName.text, text };
+  });
   const jsDocComments = node.jsDoc;
   let description;
   if (jsDocComments && jsDocComments.length > 0) {
@@ -694,7 +715,7 @@ function getParamDescription(propertyName, jsdocTags, inferredAlias) {
     const isMatch = tagParamName === propertyName || inferredAlias && tagParamName === `${inferredAlias}.${propertyName}` || tagParamName.endsWith(`.${propertyName}`);
     if (isMatch) {
       const comment = typeof tag.comment === "string" ? tag.comment : ts3.getTextOfJSDocComment(tag.comment);
-      return comment?.trim() || undefined;
+      return stripParamSeparator(comment);
     }
   }
   return;
@@ -1541,6 +1562,20 @@ var BUILTIN_TYPES2 = new Set([
   "InstanceType",
   "ThisType"
 ]);
+function matchesPattern(name, pattern) {
+  if (!pattern.includes("*"))
+    return name === pattern;
+  const regex = new RegExp("^" + pattern.replace(/\*/g, ".*") + "$");
+  return regex.test(name);
+}
+function shouldIncludeExport(name, only, ignore) {
+  if (ignore?.some((p) => matchesPattern(name, p)))
+    return false;
+  if (only && only.length > 0) {
+    return only.some((p) => matchesPattern(name, p));
+  }
+  return true;
+}
 function shouldSkipDanglingRef(name) {
   if (name.startsWith("__"))
     return true;
@@ -1560,7 +1595,9 @@ async function extract(options) {
     maxTypeDepth,
     maxExternalTypeDepth,
     resolveExternalTypes,
-    includeSchema
+    includeSchema,
+    only,
+    ignore
   } = options;
   const diagnostics = [];
   const exports = [];
@@ -1593,6 +1630,8 @@ async function extract(options) {
   ctx.exportedIds = exportedIds;
   for (const symbol of exportedSymbols) {
     const exportName = symbol.getName();
+    if (!shouldIncludeExport(exportName, only, ignore))
+      continue;
     try {
       const { declaration, targetSymbol } = resolveExportTarget(symbol, typeChecker);
       if (!declaration)

package/dist/src/index.d.ts

@@ -75,6 +75,10 @@ interface ExtractOptions {
 	schemaExtraction?: "static" | "hybrid";
 	/** Include $schema URL in output */
 	includeSchema?: boolean;
+	/** Only extract these exports (supports * wildcards) */
+	only?: string[];
+	/** Ignore these exports (supports * wildcards) */
+	ignore?: string[];
 }
 interface ExtractResult {
 	spec: OpenPkg;

package/dist/src/index.js

@@ -26,7 +26,7 @@ import {
   serializeTypeAlias,
   serializeVariable,
   withDescription
-} from "../shared/chunk-2v40ecks.js";
+} from "../shared/chunk-6p1dq6jb.js";
 // src/schema/registry.ts
 function isTypeReference(type) {
   return !!(type.flags & 524288 && type.objectFlags && type.objectFlags & 4);

package/package.json

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