@doccov/sdk 0.30.4 → 0.30.7

package/dist/analysis/index.d.ts

@@ -82,6 +82,11 @@ interface ExportRegistry {
 	types: Set<string>;
 	/** Combined set of all names (for backward compatibility) */
 	all: Set<string>;
+	/** Pre-computed candidate lists for fuzzy matching (performance optimization) */
+	callableNames: string[];
+	typeNames: string[];
+	allExportNames: string[];
+	allNames: string[];
 }
 /**
 * Extended drift with category and fixability metadata.

package/dist/analysis/index.js

@@ -36,7 +36,7 @@ import {
   renderSparkline,
   saveReport,
   saveSnapshot
-} from "../shared/chunk-fdjehkbt.js";
+} from "../shared/chunk-ehne5cde.js";
 import"../shared/chunk-r4wa72ae.js";
 export {
   saveSnapshot,

package/dist/index.d.ts

@@ -87,6 +87,11 @@ interface ExportRegistry {
 	types: Set<string>;
 	/** Combined set of all names (for backward compatibility) */
 	all: Set<string>;
+	/** Pre-computed candidate lists for fuzzy matching (performance optimization) */
+	callableNames: string[];
+	typeNames: string[];
+	allExportNames: string[];
+	allNames: string[];
 }
 /**
 * Extended drift with category and fixability metadata.
@@ -2632,7 +2637,7 @@ interface SpecSummary {
 * ```
 */
 declare function extractSpecSummary(openpkg: OpenPkg8, doccov: DocCovSpec4): SpecSummary;
-import { OpenPkg as OpenPkg_wnxvpqssax } from "@openpkg-ts/spec";
+import { OpenPkg as OpenPkg_lwtdjapvef } from "@openpkg-ts/spec";
 /**
 * Build Plan types for AI-powered repository scanning.
 */
@@ -2729,7 +2734,7 @@ interface BuildPlanExecutionResult {
 	/** Whether all required steps succeeded */
 	success: boolean;
 	/** Generated OpenPkg spec (if successful) */
-	spec?: OpenPkg_wnxvpqssax;
+	spec?: OpenPkg_lwtdjapvef;
 	/** Results for each step */
 	stepResults: BuildPlanStepResult[];
 	/** Total execution time in milliseconds */

package/dist/index.js

@@ -66,7 +66,7 @@ import {
   saveSnapshot,
   serializeJSDoc,
   ts
-} from "./shared/chunk-fdjehkbt.js";
+} from "./shared/chunk-ehne5cde.js";
 import {
   mergeFilters,
   parseListFlag
@@ -109,7 +109,7 @@ function findRepoRoot(startDir) {
   }
   return startDir;
 }
-var DEFAULT_MAX_TYPE_DEPTH = 20;
+var DEFAULT_MAX_TYPE_DEPTH = 4;
 var DEFAULT_OPTIONS = {
   includePrivate: false,
   followImports: true,
@@ -226,13 +226,7 @@ async function runAnalysis(input) {
   const packageJsonPath = findNearestPackageJson(baseDir);
   const hasNodeModules = canResolveExternalModules(program, baseDir);
   const resolveExternalTypes = options.resolveExternalTypes !== undefined ? options.resolveExternalTypes : hasNodeModules;
-  const diagnostics = ts.getPreEmitDiagnostics(context.program).filter((d) => {
-    if (d.code === 5053)
-      return false;
-    const msg = ts.flattenDiagnosticMessageText(d.messageText, `
-`);
-    return !/allowJs/i.test(msg);
-  });
+  const diagnostics = [];
   const specDiagnostics = [];
   if (!hasNodeModules && hasExternalImports(context.sourceFile)) {
     specDiagnostics.push({

package/dist/shared/{chunk-fdjehkbt.js → chunk-ehne5cde.js}

@@ -1247,10 +1247,21 @@ function findClosestMatch(source, candidates) {
   if (candidates.length === 0) {
     return;
   }
+  const sourceLen = source.length;
+  const sourceLower = source.toLowerCase();
+  const sourceFirst = sourceLower[0];
+  const filtered = candidates.filter((c) => {
+    if (Math.abs(c.length - sourceLen) > 3)
+      return false;
+    if (c[0]?.toLowerCase() !== sourceFirst)
+      return false;
+    return true;
+  });
+  const toCheck = filtered.length > 0 ? filtered : candidates.slice(0, 50);
   const sourceWords = splitCamelCase(source);
   let bestMatch;
   let bestScore = 0;
-  for (const candidate of candidates) {
+  for (const candidate of toCheck) {
     if (candidate === source)
       continue;
     const candidateWords = splitCamelCase(candidate);
@@ -1273,6 +1284,10 @@ function findClosestMatch(source, candidates) {
     if (matchingWords < 2)
       continue;
     const wordScore = matchingWords / Math.max(sourceWords.length, candidateWords.length);
+    if (!suffixMatch && wordScore < 0.3)
+      continue;
+    if (suffixMatch && wordScore < 0.2)
+      continue;
     const editDistance = levenshtein(source.toLowerCase(), candidate.toLowerCase());
     const maxLen = Math.max(source.length, candidate.length);
     const levScore = 1 - editDistance / maxLen;
@@ -1394,11 +1409,14 @@ function isIdentifierReference(node) {
     return false;
   return true;
 }
-function detectExampleDrift(entry, registry) {
-  if (!registry || !entry.examples?.length)
+function stripCodeBlockMarkers(example) {
+  return example.replace(/^```(?:ts|typescript|js|javascript)?\n?/i, "").replace(/\n?```$/i, "").trim();
+}
+function detectAllExampleIssues(entry, registry) {
+  if (!entry.examples?.length)
     return [];
   const drifts = [];
-  for (const example of entry.examples) {
+  for (let i = 0;i < entry.examples.length; i++) {
     let visit = function(node) {
       if (ts2.isIdentifier(node)) {
         const text = node.text;
@@ -1418,12 +1436,28 @@ function detectExampleDrift(entry, registry) {
       }
       ts2.forEachChild(node, visit);
     };
+    const example = entry.examples[i];
     if (typeof example !== "string")
       continue;
-    const codeContent = example.replace(/^```(?:ts|typescript|js|javascript)?\n?/i, "").replace(/\n?```$/i, "").trim();
+    const codeContent = stripCodeBlockMarkers(example);
     if (!codeContent)
       continue;
-    const sourceFile = ts2.createSourceFile("example.ts", codeContent, ts2.ScriptTarget.Latest, true, ts2.ScriptKind.TS);
+    const sourceFile = ts2.createSourceFile(`example-${i}.ts`, codeContent, ts2.ScriptTarget.Latest, true, ts2.ScriptKind.TS);
+    const parseDiagnostics = sourceFile.parseDiagnostics;
+    if (parseDiagnostics && parseDiagnostics.length > 0) {
+      const firstError = parseDiagnostics[0];
+      const message = ts2.flattenDiagnosticMessageText(firstError.messageText, `
+`);
+      drifts.push({
+        type: "example-syntax-error",
+        target: `example[${i}]`,
+        issue: `@example contains invalid syntax: ${message}`,
+        suggestion: "Check for missing brackets, semicolons, or typos."
+      });
+      continue;
+    }
+    if (!registry)
+      continue;
     const localDeclarations = new Set;
     const referencedIdentifiers = new Map;
     visit(sourceFile);
@@ -1434,14 +1468,11 @@ function detectExampleDrift(entry, registry) {
       if (!registry.all.has(identifier)) {
         let candidates;
         if (context === "call") {
-          candidates = Array.from(registry.exports.values()).filter((e) => e.isCallable).map((e) => e.name);
+          candidates = registry.callableNames;
         } else if (context === "type") {
-          candidates = [
-            ...Array.from(registry.types),
-            ...Array.from(registry.exports.values()).filter((e) => ["class", "interface", "type", "enum"].includes(e.kind)).map((e) => e.name)
-          ];
+          candidates = registry.typeNames;
         } else {
-          candidates = Array.from(registry.exports.keys());
+          candidates = registry.allExportNames;
         }
         const suggestion = findClosestMatch(identifier, candidates);
         const isPascal = /^[A-Z]/.test(identifier);
@@ -1459,34 +1490,6 @@ function detectExampleDrift(entry, registry) {
   }
   return drifts;
 }
-function detectExampleSyntaxErrors(entry) {
-  if (!entry.examples || entry.examples.length === 0) {
-    return [];
-  }
-  const drifts = [];
-  for (let i = 0;i < entry.examples.length; i++) {
-    const example = entry.examples[i];
-    if (typeof example !== "string")
-      continue;
-    const codeContent = example.replace(/^```(?:ts|typescript|js|javascript)?\n?/i, "").replace(/\n?```$/i, "").trim();
-    if (!codeContent)
-      continue;
-    const sourceFile = ts2.createSourceFile(`example-${i}.ts`, codeContent, ts2.ScriptTarget.Latest, true, ts2.ScriptKind.TS);
-    const parseDiagnostics = sourceFile.parseDiagnostics;
-    if (parseDiagnostics && parseDiagnostics.length > 0) {
-      const firstError = parseDiagnostics[0];
-      const message = ts2.flattenDiagnosticMessageText(firstError.messageText, `
-`);
-      drifts.push({
-        type: "example-syntax-error",
-        target: `example[${i}]`,
-        issue: `@example contains invalid syntax: ${message}`,
-        suggestion: "Check for missing brackets, semicolons, or typos."
-      });
-    }
-  }
-  return drifts;
-}
 function detectExampleRuntimeErrors(entry, runtimeResults) {
   if (!entry.examples || entry.examples.length === 0 || runtimeResults.size === 0) {
     return [];
@@ -1912,7 +1915,7 @@ function detectBrokenLinks(entry, registry) {
         continue;
       }
       if (!registry.all.has(rootName) && !registry.all.has(target)) {
-        const suggestion = findClosestMatch(rootName, Array.from(registry.all));
+        const suggestion = findClosestMatch(rootName, registry.allNames);
         drifts.push({
           type: "broken-link",
           target,
@@ -2104,7 +2107,15 @@ function buildExportRegistry(spec) {
     if (type.id)
       all.add(type.id);
   }
-  return { exports, types, all };
+  const callableNames = Array.from(exports.values()).filter((e) => e.isCallable).map((e) => e.name);
+  const typeKinds = new Set(["class", "interface", "type", "enum"]);
+  const typeNames = [
+    ...Array.from(types),
+    ...Array.from(exports.values()).filter((e) => typeKinds.has(e.kind)).map((e) => e.name)
+  ];
+  const allExportNames = Array.from(exports.keys());
+  const allNames = Array.from(all);
+  return { exports, types, all, callableNames, typeNames, allExportNames, allNames };
 }
 function computeDrift(spec) {
   const registry = buildExportRegistry(spec);
@@ -2116,20 +2127,23 @@ function computeDrift(spec) {
   return { exports };
 }
 function computeExportDrift(entry, registry) {
-  return [
-    ...detectParamDrift(entry),
-    ...detectOptionalityDrift(entry),
-    ...detectParamTypeDrift(entry),
-    ...detectReturnTypeDrift(entry),
-    ...detectGenericConstraintDrift(entry),
-    ...detectDeprecatedDrift(entry),
-    ...detectVisibilityDrift(entry),
-    ...detectExampleDrift(entry, registry),
-    ...detectBrokenLinks(entry, registry),
-    ...detectExampleSyntaxErrors(entry),
-    ...detectAsyncMismatch(entry),
-    ...detectPropertyTypeDrift(entry)
-  ];
+  const hasDescription = Boolean(entry.description);
+  const hasTags = (entry.tags?.length ?? 0) > 0;
+  const hasExamples = (entry.examples?.length ?? 0) > 0;
+  if (!hasDescription && !hasTags && !hasExamples) {
+    return [];
+  }
+  const drifts = [];
+  if (hasTags) {
+    drifts.push(...detectParamDrift(entry), ...detectOptionalityDrift(entry), ...detectParamTypeDrift(entry), ...detectReturnTypeDrift(entry), ...detectGenericConstraintDrift(entry), ...detectDeprecatedDrift(entry), ...detectVisibilityDrift(entry), ...detectAsyncMismatch(entry), ...detectPropertyTypeDrift(entry));
+  }
+  if (hasExamples) {
+    drifts.push(...detectAllExampleIssues(entry, registry));
+  }
+  if (hasDescription || hasTags) {
+    drifts.push(...detectBrokenLinks(entry, registry));
+  }
+  return drifts;
 }
 
 // src/analysis/health.ts

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@doccov/sdk",
-  "version": "0.30.4",
+  "version": "0.30.7",
   "description": "DocCov SDK - Documentation coverage and drift detection for TypeScript",
   "keywords": [
     "typescript",
@@ -48,7 +48,7 @@
   ],
   "dependencies": {
     "@doccov/spec": "^0.27.0",
-    "@openpkg-ts/extract": "^0.23.1",
+    "@openpkg-ts/extract": "0.23.2",
     "@openpkg-ts/spec": "^0.23.0",
     "@vercel/sandbox": "^1.0.3",
     "mdast": "^3.0.0",