@openpkg-ts/sdk 0.52.1 → 0.53.0

package/dist/index.js

@@ -1,11 +1,9 @@
 import {
   KIND_ORDER,
   QueryBuilder,
-  analyzeSpec,
   buildSignatureString,
   filterExports,
   findExport,
-  findMissingParamDocs,
   formatBadges,
   formatConditionalType,
   formatMappedType,
@@ -13,13 +11,11 @@ import {
   formatReturnType,
   formatSchema,
   formatTypeParameters,
-  getDeprecationMessage,
   getMemberBadges,
   getMethods,
   getProperties,
   groupByKind,
   groupByVisibility,
-  hasDeprecatedTag,
   isMethod,
   isProperty,
   query,
@@ -29,7 +25,7 @@ import {
   toPagefindRecords,
   toSearchIndex,
   toSearchIndexJSON
-} from "./shared/chunk-zrx9s0n4.js";
+} from "./shared/chunk-7287tqkx.js";
 
 // src/primitives/diff.ts
 import {
@@ -75,10 +71,9 @@ function mergeConfig(fileConfig, cliOptions) {
   }
   const externals = {
     include: cliOptions.externals?.include ?? fileConfig.externals?.include,
-    exclude: cliOptions.externals?.exclude ?? fileConfig.externals?.exclude,
-    depth: cliOptions.externals?.depth ?? fileConfig.externals?.depth
+    exclude: cliOptions.externals?.exclude ?? fileConfig.externals?.exclude
   };
-  const hasExternals = externals.include || externals.exclude || externals.depth !== undefined;
+  const hasExternals = externals.include || externals.exclude;
   return {
     ...hasExternals ? { externals } : {},
     followExternal: cliOptions.followExternal ?? fileConfig.followExternal,
@@ -1266,6 +1261,7 @@ import { spawn, spawnSync } from "node:child_process";
 import * as fs3 from "node:fs";
 import * as os from "node:os";
 import * as path2 from "node:path";
+import picomatch from "picomatch";
 var SKIP_DIRS = new Set(["node_modules", "dist", ".git", "target", "coverage", ".next", "out"]);
 var CONV = ["src/index.ts", "src/index.tsx", "src/index.mts", "index.ts", "index.tsx"];
 var ENTRY_EXT = /\.(c|m)?[tj]sx?$/;
@@ -1276,6 +1272,17 @@ function isRemoteInput(input) {
 function isEntryFilePath(input) {
   return ENTRY_EXT.test(input) || /\.d\.(ts|mts|cts)$/.test(input);
 }
+function isPathLikeInput(input) {
+  if (!input)
+    return false;
+  if (path2.isAbsolute(input))
+    return true;
+  if (input.startsWith("./") || input.startsWith("../"))
+    return true;
+  if (input.includes("/") || input.includes("\\"))
+    return true;
+  return isEntryFilePath(input);
+}
 function parseGithubRepo(input) {
   const trimmed = input.trim().replace(/\.git$/, "");
   const https = trimmed.match(/github\.com[/:]([^/]+)\/([^/#?]+)/i);
@@ -1341,6 +1348,17 @@ function existsDir(p) {
     return false;
   }
 }
+function isDirentDir(parent, entry) {
+  if (entry.isDirectory())
+    return true;
+  if (!entry.isSymbolicLink())
+    return false;
+  try {
+    return fs3.statSync(path2.join(parent, entry.name)).isDirectory();
+  } catch {
+    return false;
+  }
+}
 function readJson(file) {
   try {
     return JSON.parse(fs3.readFileSync(file, "utf-8"));
@@ -1370,53 +1388,45 @@ function parsePnpmWorkspace(yaml) {
   }
   return globs;
 }
-function expandGlob(root, pattern) {
-  const parts = pattern.split("/").filter(Boolean);
-  const out = [];
-  const walk = (dir, i) => {
-    if (out.length >= MAX_PACKAGES)
-      return;
-    if (i === parts.length) {
-      if (existsFile(path2.join(dir, "package.json")))
-        out.push(dir);
-      return;
-    }
-    const part = parts[i];
-    if (!existsDir(dir))
+function expandWorkspaceGlobs(root, globs) {
+  const include = [];
+  const exclude = [];
+  for (const g of globs) {
+    if (g.startsWith("!"))
+      exclude.push(g.slice(1));
+    else
+      include.push(g);
+  }
+  if (!include.length)
+    return [];
+  const dirs = [];
+  const walk = (dir, depth) => {
+    if (dirs.length >= MAX_PACKAGES || depth > 12)
       return;
-    if (part === "**") {
-      walk(dir, i + 1);
-      let entries = [];
-      try {
-        entries = fs3.readdirSync(dir, { withFileTypes: true });
-      } catch {
-        return;
-      }
-      for (const ent of entries) {
-        if (!ent.isDirectory() || SKIP_DIRS.has(ent.name))
-          continue;
-        walk(path2.join(dir, ent.name), i);
-      }
+    if (existsFile(path2.join(dir, "package.json")))
+      dirs.push(dir);
+    let entries = [];
+    try {
+      entries = fs3.readdirSync(dir, { withFileTypes: true });
+    } catch {
       return;
     }
-    if (part === "*") {
-      let entries = [];
-      try {
-        entries = fs3.readdirSync(dir, { withFileTypes: true });
-      } catch {
-        return;
-      }
-      for (const ent of entries) {
-        if (!ent.isDirectory() || SKIP_DIRS.has(ent.name))
-          continue;
-        walk(path2.join(dir, ent.name), i + 1);
-      }
-      return;
+    for (const ent of entries) {
+      if (SKIP_DIRS.has(ent.name) || ent.name.startsWith("."))
+        continue;
+      if (!isDirentDir(dir, ent))
+        continue;
+      walk(path2.join(dir, ent.name), depth + 1);
     }
-    walk(path2.join(dir, part), i + 1);
   };
   walk(root, 0);
-  return out;
+  const isMatch = picomatch(include, { ignore: exclude, dot: false, nocase: false });
+  return dirs.filter((dir) => {
+    const rel = path2.relative(root, dir).split(path2.sep).join("/");
+    if (!rel || rel === ".")
+      return include.includes(".");
+    return isMatch(rel);
+  });
 }
 function workspaceGlobs(dir) {
   const pnpm = path2.join(dir, "pnpm-workspace.yaml");
@@ -1486,10 +1496,8 @@ function catalogPackages(start) {
   };
   const globs = workspaceGlobs(root);
   if (globs?.length) {
-    for (const glob of globs) {
-      for (const dir2 of expandGlob(root, glob))
-        add(dir2);
-    }
+    for (const dir2 of expandWorkspaceGlobs(root, globs))
+      add(dir2);
   }
   let dir = abs;
   for (let i = 0;i < 8; i++) {
@@ -1541,9 +1549,9 @@ function collectCandidates(pkgDir, pkg) {
     add(pkg.types, "types");
   if (typeof pkg.typings === "string")
     add(pkg.typings, "typings");
-  if (pkg.exports && typeof pkg.exports === "object") {
+  if (pkg.exports != null) {
     const exp = pkg.exports;
-    const root = "." in exp ? exp["."] : exp;
+    const root = typeof exp === "object" && exp !== null && !Array.isArray(exp) && "." in exp ? exp["."] : exp;
     const paths = [];
     collectFromExports(root, paths);
     for (const p of paths)
@@ -1617,7 +1625,7 @@ function isExtractable(pkg) {
     return false;
   if (isIgnoredPath(pkg.dir))
     return false;
-  return pkg.hasSrc || Boolean(pkg.types || pkg.typings);
+  return pickEntry(pkg.dir) !== null;
 }
 function intentScore(pkg, intent) {
   const q = intent.toLowerCase().trim();
@@ -1821,10 +1829,16 @@ async function resolveTarget(options = {}) {
     }
   }
   if (isRemoteInput(raw)) {
+    const owned = !options.clone;
     try {
       const cloned = await (options.clone ?? cloneRemote)(raw);
-      const startDir2 = cloned;
-      return resolveLocal(startDir2, startDir2, ctx);
+      const result = await resolveLocal(cloned, cloned, ctx);
+      if (!owned)
+        return result;
+      return {
+        ...result,
+        cleanup: () => fs3.rmSync(cloned, { recursive: true, force: true })
+      };
     } catch (err) {
       return {
         kind: "empty",
@@ -1836,6 +1850,9 @@ async function resolveTarget(options = {}) {
   if (existsFile(abs) && isEntryFilePath(abs)) {
     return { kind: "explicit", entryFile: abs, entryPointSource: "explicit" };
   }
+  if (!existsFile(abs) && !existsDir(abs) && isPathLikeInput(options.input?.trim() || raw)) {
+    return { kind: "empty", reason: `input does not exist: ${options.input?.trim() || raw}` };
+  }
   const startDir = existsDir(abs) ? abs : cwd;
   return resolveLocal(abs, startDir, ctx);
 }
@@ -2344,6 +2361,42 @@ function resolveWorkspaceEntry(pkgDir) {
   } catch {}
   return candidates.find((c) => fs4.existsSync(c));
 }
+function isDirentDir2(parent, entry) {
+  if (entry.isDirectory())
+    return true;
+  if (!entry.isSymbolicLink())
+    return false;
+  try {
+    return fs4.statSync(path4.join(parent, entry.name)).isDirectory();
+  } catch {
+    return false;
+  }
+}
+function extensionOf(file) {
+  if (file.endsWith(".d.mts"))
+    return ts2.Extension.Dmts;
+  if (file.endsWith(".d.cts"))
+    return ts2.Extension.Dcts;
+  if (file.endsWith(".d.ts"))
+    return ts2.Extension.Dts;
+  if (file.endsWith(".mts"))
+    return ts2.Extension.Mts;
+  if (file.endsWith(".cts"))
+    return ts2.Extension.Cts;
+  if (file.endsWith(".tsx"))
+    return ts2.Extension.Tsx;
+  if (file.endsWith(".ts"))
+    return ts2.Extension.Ts;
+  if (file.endsWith(".mjs"))
+    return ts2.Extension.Mjs;
+  if (file.endsWith(".cjs"))
+    return ts2.Extension.Cjs;
+  if (file.endsWith(".jsx"))
+    return ts2.Extension.Jsx;
+  if (file.endsWith(".js"))
+    return ts2.Extension.Js;
+  return ts2.Extension.Ts;
+}
 function resolveProjectReferences(configPath, parsedConfig) {
   const additionalFiles = [];
   if (!parsedConfig.projectReferences?.length) {
@@ -2427,7 +2480,7 @@ function buildWorkspaceMap(baseDir) {
       continue;
     const entries = fs4.readdirSync(globDir, { withFileTypes: true });
     for (const entry of entries) {
-      if (!entry.isDirectory())
+      if (!isDirentDir2(globDir, entry))
         continue;
       const pkgDir = path4.join(globDir, entry.name);
       const pkgJsonPath = path4.join(pkgDir, "package.json");
@@ -2452,7 +2505,7 @@ function discoverAmbientTypePackages(baseDir) {
     try {
       if (fs4.existsSync(typesDir) && fs4.statSync(typesDir).isDirectory()) {
         for (const entry of fs4.readdirSync(typesDir, { withFileTypes: true })) {
-          if (!entry.isDirectory() || entry.name.startsWith("."))
+          if (entry.name.startsWith(".") || !isDirentDir2(typesDir, entry))
             continue;
           if (seen.has(entry.name))
             continue;
@@ -2518,24 +2571,23 @@ function createProgram(options) {
   const compilerHost = ts2.createCompilerHost(compilerOptions, true);
   let inMemorySource;
   if (workspaceMap) {
-    const originalResolveModuleNames = compilerHost.resolveModuleNames?.bind(compilerHost);
-    compilerHost.resolveModuleNames = (moduleNames, containingFile, _reusedNames, redirectedReference, options2) => {
-      return moduleNames.map((moduleName) => {
-        const pkgDir = workspaceMap.packages.get(moduleName);
-        if (pkgDir) {
-          const entryPath = resolveWorkspaceEntry(pkgDir);
-          if (entryPath) {
-            return { resolvedFileName: entryPath, isExternalLibraryImport: false };
-          }
-        }
-        if (originalResolveModuleNames) {
-          const result = originalResolveModuleNames([moduleName], containingFile, _reusedNames, redirectedReference, options2);
-          return result[0];
+    compilerHost.resolveModuleNameLiterals = (moduleLiterals, containingFile, redirectedReference, options2, containingSourceFile) => moduleLiterals.map((literal) => {
+      const pkgDir = workspaceMap.packages.get(literal.text);
+      if (pkgDir) {
+        const entryPath = resolveWorkspaceEntry(pkgDir);
+        if (entryPath) {
+          return {
+            resolvedModule: {
+              resolvedFileName: entryPath,
+              isExternalLibraryImport: false,
+              extension: extensionOf(entryPath)
+            }
+          };
         }
-        const resolved = ts2.resolveModuleName(moduleName, containingFile, options2, compilerHost);
-        return resolved.resolvedModule;
-      });
-    };
+      }
+      const mode = ts2.getModeForUsageLocation(containingSourceFile, literal, options2);
+      return ts2.resolveModuleName(literal.text, containingFile, options2, compilerHost, undefined, redirectedReference, mode);
+    });
   }
   if (content !== undefined) {
     inMemorySource = ts2.createSourceFile(entryFile, content, ts2.ScriptTarget.Latest, true, getScriptKind(entryFile));
@@ -4165,9 +4217,7 @@ function createContext(program, sourceFile, options = {}) {
     program,
     sourceFile,
     maxTypeDepth: options.maxTypeDepth ?? 5,
-    maxExternalTypeDepth: options.maxExternalTypeDepth ?? 2,
     currentDepth: 0,
-    resolveExternalTypes: options.resolveExternalTypes ?? true,
     typeRegistry: new TypeRegistry,
     exportedIds: new Set,
     visitedTypes: new Set,
@@ -6799,17 +6849,17 @@ async function extractStandardSchemasFromProject(entryFile, baseDir, options = {
 // src/builder/external-resolver.ts
 import * as fs6 from "node:fs";
 import * as path8 from "node:path";
-import picomatch from "picomatch";
+import picomatch2 from "picomatch";
 import ts16 from "typescript";
 function matchesExternalPattern(packageName, include, exclude) {
   if (!include?.length)
     return false;
   const matchOptions = { bash: true };
-  const isIncluded = include.some((p) => picomatch.isMatch(packageName, p, matchOptions));
+  const isIncluded = include.some((p) => picomatch2.isMatch(packageName, p, matchOptions));
   if (!isIncluded)
     return false;
   if (exclude?.length) {
-    const isExcluded = exclude.some((p) => picomatch.isMatch(packageName, p, matchOptions));
+    const isExcluded = exclude.some((p) => picomatch2.isMatch(packageName, p, matchOptions));
     if (isExcluded)
       return false;
   }
@@ -7232,9 +7282,6 @@ function collectReferencedExternals(exportedSymbols, checker, workspacePackages)
     visited.add(type);
     const symbol = type.aliasSymbol ?? type.getSymbol();
     consider(symbol);
-    const match = symbol?.declarations?.[0]?.getSourceFile().fileName.match(NODE_MODULES_PKG2);
-    if (match && !workspacePackages.has(match[1]))
-      return;
     for (const arg of type.aliasTypeArguments ?? [])
       visit(arg, depth + 1);
     const typeRef = type;
@@ -7246,11 +7293,33 @@ function collectReferencedExternals(exportedSymbols, checker, workspacePackages)
       for (const t of type.types)
         visit(t, depth + 1);
     }
+    const fileName = symbol?.declarations?.[0]?.getSourceFile().fileName;
+    if (fileName) {
+      if (isLibFile(fileName))
+        return;
+      const match = fileName.match(NODE_MODULES_PKG2);
+      if (match && !workspacePackages.has(match[1]))
+        return;
+    }
+    if (!(type.flags & ts18.TypeFlags.Object || type.isClassOrInterface()))
+      return;
+    if (type.isClassOrInterface()) {
+      for (const base of checker.getBaseTypes(type) ?? [])
+        visit(base, depth + 1);
+    }
+    for (const prop of type.getProperties()) {
+      if (prop.getName().startsWith("__@"))
+        continue;
+      visit(checker.getTypeOfSymbol(prop), depth + 1);
+    }
     for (const sig of [...type.getCallSignatures(), ...type.getConstructSignatures()]) {
       for (const param of sig.getParameters())
         visit(checker.getTypeOfSymbol(param), depth + 1);
       visit(sig.getReturnType(), depth + 1);
     }
+    for (const info of checker.getIndexInfosOfType(type)) {
+      visit(info.type, depth + 1);
+    }
   };
   for (const symbol of exportedSymbols) {
     visit(checker.getTypeOfSymbol(symbol), 0);
@@ -7635,27 +7704,6 @@ function collectForgottenExports(exports, types, program, sourceFile, exportedId
 
 // src/builder/spec-builder.ts
 var YIELD_BATCH_SIZE = 5;
-function computeDegradedStats(exports) {
-  let exportsWithoutDescription = 0;
-  let paramsWithoutDocs = 0;
-  let missingExamples = 0;
-  for (const exp of exports) {
-    if (!exp.description)
-      exportsWithoutDescription++;
-    if (!exp.examples || exp.examples.length === 0)
-      missingExamples++;
-    const signatures = exp.signatures;
-    if (signatures) {
-      for (const sig of signatures) {
-        for (const param of sig.parameters ?? []) {
-          if (!param.description)
-            paramsWithoutDocs++;
-        }
-      }
-    }
-  }
-  return { exportsWithoutDescription, paramsWithoutDocs, missingExamples };
-}
 function matchesPattern(name, pattern) {
   if (!pattern.includes("*"))
     return name === pattern;
@@ -7683,8 +7731,6 @@ async function extract(options) {
       baseDir,
       content,
       maxTypeDepth,
-      maxExternalTypeDepth,
-      resolveExternalTypes,
       includeSchema,
       only,
       ignore,
@@ -7751,7 +7797,15 @@ async function extract(options) {
     }
     let followExternal = options.followExternal;
     let evaluate = options.evaluate;
-    const wantsJev = options.decisions === "jev" || followExternal === "auto";
+    if (followExternal === "auto" && !evaluate && options.decisions !== "jev") {
+      diagnostics.push({
+        message: "followExternal auto requires decisions: 'jev' (or an injected evaluate)",
+        severity: "error",
+        code: "JEV_UNAVAILABLE"
+      });
+      followExternal = undefined;
+    }
+    const wantsJev = options.decisions === "jev";
     if (wantsJev && !evaluate) {
       if (process.env.AI_GATEWAY_API_KEY) {
         try {
@@ -7781,8 +7835,6 @@ async function extract(options) {
     }
     const ctx = createContext(program, sourceFile, {
       maxTypeDepth,
-      maxExternalTypeDepth,
-      resolveExternalTypes,
       includePrivate,
       maxProperties,
       onTruncation,
@@ -8014,7 +8066,6 @@ 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({
@@ -8032,8 +8083,7 @@ async function extract(options) {
       diagnostics,
       verification,
       ...internalForgotten.length > 0 ? { forgottenExports: internalForgotten } : {},
-      ...runtimeMetadata ? { runtimeSchemas: runtimeMetadata } : {},
-      ...degradedMode ? { degradedMode } : {}
+      ...runtimeMetadata ? { runtimeSchemas: runtimeMetadata } : {}
     };
   } finally {
     clearTypeDefinitionCache();
@@ -8878,13 +8928,13 @@ export {
   isPureRefSchema,
   isProperty,
   isPrimitiveName,
+  isPathLikeInput,
   isMethod,
   isExported,
   isEntryFilePath,
   isBuiltinSymbol,
   isBuiltinGeneric,
   isAnonymous,
-  hasDeprecatedTag,
   groupByVisibility,
   getValidationErrors,
   getTypeOrigin,
@@ -8898,7 +8948,6 @@ export {
   getJSDocComment,
   getExportKind,
   getExport,
-  getDeprecationMessage,
   getAvailableVersions,
   toMarkdown as generateDocs,
   formatTypeParameters,
@@ -8909,7 +8958,6 @@ export {
   formatConditionalType,
   formatBadges,
   findWorkspaceRoot,
-  findMissingParamDocs,
   findDiscriminatorProperty,
   findAdapter,
   filterSpec,
@@ -8944,7 +8992,6 @@ export {
   assertSpec,
   asStandardSchema,
   arktypeAdapter,
-  analyzeSpec,
   TypeRegistry,
   STRING_PROTOTYPE_METHODS,
   QueryBuilder,

package/dist/shared/{chunk-zrx9s0n4.js → chunk-7287tqkx.js}

@@ -1,80 +1,3 @@
-// src/core/diagnostics.ts
-function hasDeprecatedTag(exp) {
-  if (exp.deprecated === true)
-    return true;
-  return exp.tags?.some((t) => t.name === "deprecated" || t.name === "@deprecated") ?? false;
-}
-function getDeprecationMessage(exp) {
-  const tag = exp.tags?.find((t) => t.name === "deprecated" || t.name === "@deprecated");
-  if (tag?.text.trim()) {
-    return tag.text.trim();
-  }
-  return;
-}
-function findMissingParamDocs(exp) {
-  const missing = [];
-  for (const sig of exp.signatures ?? []) {
-    for (const param of sig.parameters ?? []) {
-      if (!param.description?.trim()) {
-        missing.push(param.name);
-      }
-    }
-  }
-  return missing;
-}
-function checkMemberDescriptions(exp, members) {
-  const items = [];
-  for (const member of members) {
-    if (!member.description?.trim() && member.name) {
-      items.push({
-        exportId: exp.id,
-        exportName: exp.name,
-        issue: "member missing description",
-        member: member.name
-      });
-    }
-  }
-  return items;
-}
-function analyzeSpec(spec) {
-  const missingDescriptions = [];
-  const deprecatedNoReason = [];
-  const missingParamDocs = [];
-  for (const exp of spec.exports) {
-    if (!exp.description?.trim()) {
-      missingDescriptions.push({
-        exportId: exp.id,
-        exportName: exp.name,
-        issue: "missing description"
-      });
-    }
-    if (exp.members) {
-      missingDescriptions.push(...checkMemberDescriptions(exp, exp.members));
-    }
-    if (hasDeprecatedTag(exp) && !getDeprecationMessage(exp)) {
-      deprecatedNoReason.push({
-        exportId: exp.id,
-        exportName: exp.name,
-        issue: "deprecated without reason"
-      });
-    }
-    const missingParams = findMissingParamDocs(exp);
-    for (const param of missingParams) {
-      missingParamDocs.push({
-        exportId: exp.id,
-        exportName: exp.name,
-        issue: "param missing description",
-        param
-      });
-    }
-  }
-  return {
-    missingDescriptions,
-    deprecatedNoReason,
-    missingParamDocs
-  };
-}
-
 // src/core/format.ts
 function getMemberBadges(member) {
   const badges = [];
@@ -592,4 +515,4 @@ function query(spec) {
   return new QueryBuilder(spec);
 }
 
-export { hasDeprecatedTag, getDeprecationMessage, findMissingParamDocs, analyzeSpec, getMemberBadges, formatBadges, formatSchema, formatTypeParameters, formatParameters, formatReturnType, buildSignatureString, resolveTypeRef, isMethod, isProperty, getMethods, getProperties, groupByVisibility, sortByName, KIND_ORDER, groupByKind, formatConditionalType, formatMappedType, findExport, filterExports, toSearchIndex, toPagefindRecords, toAlgoliaRecords, toSearchIndexJSON, QueryBuilder, query };
+export { getMemberBadges, formatBadges, formatSchema, formatTypeParameters, formatParameters, formatReturnType, buildSignatureString, resolveTypeRef, isMethod, isProperty, getMethods, getProperties, groupByVisibility, sortByName, KIND_ORDER, groupByKind, formatConditionalType, formatMappedType, findExport, filterExports, toSearchIndex, toPagefindRecords, toAlgoliaRecords, toSearchIndexJSON, QueryBuilder, query };

package/package.json

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