@doccov/sdk 0.27.0 → 0.27.2

package/dist/analysis/index.js

@@ -38,7 +38,7 @@ import {
   renderSparkline,
   saveReport,
   saveSnapshot
-} from "../shared/chunk-v62zsv8j.js";
+} from "../shared/chunk-aemmktkm.js";
 import"../shared/chunk-esptwrfq.js";
 export {
   saveSnapshot,

package/dist/index.d.ts

@@ -1498,10 +1498,18 @@ interface JSDocTag {
 /**
 * A patchable representation of a JSDoc comment
 */
+/**
+* Represents a @throws tag in a JSDoc patch
+*/
+interface JSDocThrows {
+	type?: string;
+	description?: string;
+}
 interface JSDocPatch {
 	description?: string;
 	params?: JSDocParam[];
 	returns?: JSDocReturn;
+	throws?: JSDocThrows[];
 	examples?: string[];
 	deprecated?: string | false;
 	async?: boolean;
@@ -2679,7 +2687,7 @@ interface SpecSummary {
 * ```
 */
 declare function extractSpecSummary(openpkg: OpenPkg8, doccov: DocCovSpec4): SpecSummary;
-import { OpenPkg as OpenPkg_tgtzybcxvb } from "@openpkg-ts/spec";
+import { OpenPkg as OpenPkg_evpdpkbkmv } from "@openpkg-ts/spec";
 /**
 * Build Plan types for AI-powered repository scanning.
 */
@@ -2776,7 +2784,7 @@ interface BuildPlanExecutionResult {
 	/** Whether all required steps succeeded */
 	success: boolean;
 	/** Generated OpenPkg spec (if successful) */
-	spec?: OpenPkg_tgtzybcxvb;
+	spec?: OpenPkg_evpdpkbkmv;
 	/** Results for each step */
 	stepResults: BuildPlanStepResult[];
 	/** Total execution time in milliseconds */

package/dist/index.js

@@ -60,7 +60,7 @@ import {
   saveSnapshot,
   serializeJSDoc,
   ts
-} from "./shared/chunk-v62zsv8j.js";
+} from "./shared/chunk-aemmktkm.js";
 import {
   mergeFilters,
   parseListFlag

package/dist/shared/{chunk-v62zsv8j.js → chunk-aemmktkm.js}

@@ -546,6 +546,21 @@ function parseJSDocToPatch(jsDocText) {
         patch.deprecated = content || "Deprecated";
         break;
       }
+      case "throws":
+      case "throw": {
+        if (!patch.throws)
+          patch.throws = [];
+        const throwsMatch = content.match(/^(?:\{@?link\s+([^}]+)\}|\{([^}]+)\})?\s*(.*)$/s);
+        if (throwsMatch) {
+          patch.throws.push({
+            type: (throwsMatch[1] || throwsMatch[2])?.trim(),
+            description: throwsMatch[3]?.trim()
+          });
+        } else {
+          patch.throws.push({ description: content.trim() });
+        }
+        break;
+      }
       case "async": {
         patch.async = true;
         break;
@@ -620,6 +635,9 @@ function applyPatchToJSDoc(existing, updates) {
       ...updates.returns
     };
   }
+  if (updates.throws !== undefined) {
+    result.throws = updates.throws;
+  }
   if (updates.examples !== undefined) {
     result.examples = updates.examples;
   }
@@ -643,7 +661,7 @@ function serializeJSDoc(patch, indent = "") {
       lines.push(line);
     }
   }
-  const hasTags = patch.params?.length || patch.returns || patch.examples?.length || patch.deprecated || patch.async || patch.type || patch.typeParams?.length || patch.otherTags?.length;
+  const hasTags = patch.params?.length || patch.returns || patch.throws?.length || patch.examples?.length || patch.deprecated || patch.async || patch.type || patch.typeParams?.length || patch.otherTags?.length;
   if (patch.description && hasTags) {
     lines.push("");
   }
@@ -689,6 +707,18 @@ function serializeJSDoc(patch, indent = "") {
     }
     lines.push(tagLine);
   }
+  if (patch.throws) {
+    for (const t of patch.throws) {
+      let tagLine = "@throws";
+      if (t.type) {
+        tagLine += ` {${t.type}}`;
+      }
+      if (t.description) {
+        tagLine += ` ${t.description}`;
+      }
+      lines.push(tagLine);
+    }
+  }
   if (patch.deprecated && typeof patch.deprecated === "string") {
     lines.push(`@deprecated ${patch.deprecated}`);
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@doccov/sdk",
-  "version": "0.27.0",
+  "version": "0.27.2",
   "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.16.0",
+    "@openpkg-ts/extract": "^0.16.1",
     "@openpkg-ts/spec": "^0.12.0",
     "@vercel/sandbox": "^1.0.3",
     "mdast": "^3.0.0",