@openpkg-ts/sdk 0.47.1 → 0.48.0

package/dist/index.d.ts

@@ -156,6 +156,16 @@ interface ExportVerification {
 interface OpenpkgConfig {
 	/** Configuration for resolving external package re-exports */
 	externals?: ExternalsConfig;
+	/**
+	* Expand referenced types from third-party packages instead of recording
+	* them as opaque stubs. `true` follows every dependency; a string[] follows
+	* only the named packages (by declaring package name). Default: stub.
+	*/
+	followExternal?: boolean | string[];
+	/** Only extract these exports (supports * wildcards). */
+	only?: string[];
+	/** Ignore these exports (supports * wildcards). */
+	ignore?: string[];
 }
 /** Default config filename */
 declare const CONFIG_FILENAME = "openpkg.config.json";

package/dist/index.js

@@ -79,7 +79,12 @@ function mergeConfig(fileConfig, cliOptions) {
     depth: cliOptions.externals?.depth ?? fileConfig.externals?.depth
   };
   const hasExternals = externals.include || externals.exclude || externals.depth !== undefined;
-  return hasExternals ? { externals } : {};
+  return {
+    ...hasExternals ? { externals } : {},
+    followExternal: cliOptions.followExternal ?? fileConfig.followExternal,
+    only: cliOptions.only ?? fileConfig.only,
+    ignore: cliOptions.ignore ?? fileConfig.ignore
+  };
 }
 // src/core/loader.ts
 import * as fs2 from "node:fs";
@@ -3090,12 +3095,18 @@ class TypeRegistry {
     if (this.has(name))
       return name;
     if (ctx.shouldExpandExternal && !ctx.shouldExpandExternal(symbol)) {
+      const origin = getTypeOrigin(type, ctx.typeChecker);
+      const schema = {
+        "x-ts-type": renderTypeText(type, ctx.typeChecker)
+      };
+      if (origin)
+        schema["x-ts-package"] = origin;
       this.add({
         id: name,
         name,
         kind: "external",
         external: true,
-        schema: { "x-ts-type": renderTypeText(type, ctx.typeChecker) }
+        schema
       });
       return name;
     }
@@ -3213,6 +3224,11 @@ class TypeRegistry {
     if (type.flags & ts5.TypeFlags.Conditional) {
       return { "x-ts-type": renderTypeText(type, checker) };
     }
+    const constraint = checker.getBaseConstraintOfType(type);
+    const primitive = constraint && constraint.flags & ts5.TypeFlags.StringLike ? "string" : constraint && constraint.flags & ts5.TypeFlags.NumberLike ? "number" : constraint && constraint.flags & ts5.TypeFlags.BooleanLike ? "boolean" : undefined;
+    if (primitive) {
+      return { type: primitive, "x-ts-type": renderTypeText(type, checker) };
+    }
     return this.buildObjectSchemaFromProperties(type, checker, ctx);
   }
   buildEnumSchema(symbol, checker) {
@@ -6218,12 +6234,18 @@ function isLibFile(fileName) {
   return fileName.includes("/typescript/lib/lib.") || fileName.includes("\\typescript\\lib\\lib.");
 }
 function createExternalExpansionPredicate(opts) {
+  const matchesEntry = (entry, pkg) => {
+    if (!entry.includes("*"))
+      return entry === pkg;
+    const rx = new RegExp(`^${entry.replace(/[.+?^${}()|[\]\\]/g, "\\$&").replace(/\*/g, ".*")}$`);
+    return rx.test(pkg);
+  };
   const packageAllowed = (pkg) => {
     if (pkg === "typescript")
       return false;
     if (opts.followExternal === true)
       return true;
-    if (Array.isArray(opts.followExternal) && opts.followExternal.includes(pkg))
+    if (Array.isArray(opts.followExternal) && opts.followExternal.some((e) => matchesEntry(e, pkg)))
       return true;
     return opts.workspacePackages.has(pkg);
   };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openpkg-ts/sdk",
-  "version": "0.47.1",
+  "version": "0.48.0",
   "description": "TypeScript API extraction SDK - programmatic primitives for OpenPkg specs",
   "keywords": [
     "openpkg",