@doccov/sdk 0.3.4 → 0.3.6

package/dist/index.js

@@ -1870,6 +1870,16 @@ function schemasAreEqual(left, right) {
   };
   return JSON.stringify(normalize(left)) === JSON.stringify(normalize(right));
 }
+function deduplicateSchemas(schemas) {
+  const result = [];
+  for (const schema of schemas) {
+    const isDuplicate = result.some((existing) => schemasAreEqual(existing, schema));
+    if (!isDuplicate) {
+      result.push(schema);
+    }
+  }
+  return result;
+}
 function formatTypeReference(type, typeChecker, typeRefs, referencedTypes, visitedAliases) {
   const visited = visitedAliases ?? new Set;
   const aliasSymbol = type.aliasSymbol;
@@ -1929,15 +1939,19 @@ function formatTypeReference(type, typeChecker, typeRefs, referencedTypes, visit
     if (type.isUnion()) {
       const unionType = type;
       const parts = unionType.types.map((t) => formatTypeReference(t, typeChecker, typeRefs, referencedTypes, visited));
+      const uniqueParts = deduplicateSchemas(parts);
+      if (uniqueParts.length === 1) {
+        return uniqueParts[0];
+      }
       const discriminatorProp = findDiscriminatorProperty(unionType.types, typeChecker);
       if (discriminatorProp) {
         return {
-          anyOf: parts,
+          anyOf: uniqueParts,
           discriminator: { propertyName: discriminatorProp }
         };
       }
       return {
-        anyOf: parts
+        anyOf: uniqueParts
       };
     }
     if (type.isIntersection()) {
@@ -2910,6 +2924,86 @@ function serializeFunctionExport(declaration, symbol, context) {
 }
 
 // src/analysis/serializers/interfaces.ts
+function serializeInterfaceMembers(declaration, checker, typeRefs, referencedTypes) {
+  const members = [];
+  for (const member of declaration.members) {
+    if (ts2.isPropertySignature(member)) {
+      const memberName = member.name?.getText();
+      if (!memberName)
+        continue;
+      const memberSymbol = member.name ? checker.getSymbolAtLocation(member.name) : undefined;
+      const memberDoc = memberSymbol ? parseJSDocComment(memberSymbol, checker) : null;
+      const memberType = member.type ? checker.getTypeAtLocation(member.type) : checker.getAnyType();
+      collectReferencedTypes(memberType, checker, referencedTypes);
+      const schema = formatTypeReference(memberType, checker, typeRefs, referencedTypes);
+      const flags = {};
+      if (member.questionToken) {
+        flags.optional = true;
+      }
+      if (member.modifiers?.some((mod) => mod.kind === ts2.SyntaxKind.ReadonlyKeyword)) {
+        flags.readonly = true;
+      }
+      members.push({
+        id: memberName,
+        name: memberName,
+        kind: "property",
+        schema,
+        description: memberDoc?.description ?? (memberSymbol ? getJSDocComment(memberSymbol, checker) : undefined),
+        flags: Object.keys(flags).length > 0 ? flags : undefined,
+        tags: memberDoc?.tags
+      });
+    } else if (ts2.isMethodSignature(member)) {
+      const methodName = member.name?.getText();
+      if (!methodName)
+        continue;
+      const memberSymbol = member.name ? checker.getSymbolAtLocation(member.name) : undefined;
+      const methodDoc = memberSymbol ? parseJSDocComment(memberSymbol, checker) : null;
+      const signature = checker.getSignatureFromDeclaration(member);
+      if (signature) {
+        const parameters = signature.getParameters().map((param) => {
+          const paramDecl = param.declarations?.find(ts2.isParameter);
+          const paramType = paramDecl ? checker.getTypeAtLocation(paramDecl) : checker.getTypeOfSymbolAtLocation(param, member);
+          collectReferencedTypes(paramType, checker, referencedTypes);
+          if (paramDecl) {
+            const paramDoc = getParameterDocumentation(param, paramDecl, checker);
+            return structureParameter(param, paramDecl, paramType, checker, typeRefs, null, paramDoc, referencedTypes);
+          }
+          return {
+            name: param.getName(),
+            required: !(param.flags & ts2.SymbolFlags.Optional),
+            schema: formatTypeReference(paramType, checker, typeRefs, referencedTypes)
+          };
+        });
+        const returnType = signature.getReturnType();
+        if (returnType) {
+          collectReferencedTypes(returnType, checker, referencedTypes);
+        }
+        const flags = {};
+        if (member.questionToken) {
+          flags.optional = true;
+        }
+        members.push({
+          id: methodName,
+          name: methodName,
+          kind: "method",
+          signatures: [
+            {
+              parameters,
+              returns: {
+                schema: returnType ? formatTypeReference(returnType, checker, typeRefs, referencedTypes) : { type: "void" }
+              },
+              description: methodDoc?.description
+            }
+          ],
+          description: methodDoc?.description ?? (memberSymbol ? getJSDocComment(memberSymbol, checker) : undefined),
+          flags: Object.keys(flags).length > 0 ? flags : undefined,
+          tags: methodDoc?.tags
+        });
+      }
+    }
+  }
+  return members;
+}
 function serializeInterface(declaration, symbol, context) {
   const { checker, typeRegistry } = context;
   const parsedDoc = parseJSDocComment(symbol, checker);
@@ -2918,6 +3012,7 @@ function serializeInterface(declaration, symbol, context) {
   const referencedTypes = typeRegistry.getReferencedTypes();
   const typeRefs = typeRegistry.getTypeRefs();
   const typeParameters = serializeTypeParameterDeclarations(declaration.typeParameters, checker, referencedTypes);
+  const members = serializeInterfaceMembers(declaration, checker, typeRefs, referencedTypes);
   const exportEntry = {
     id: symbol.getName(),
     name: symbol.getName(),
@@ -2926,6 +3021,7 @@ function serializeInterface(declaration, symbol, context) {
     deprecated: isSymbolDeprecated(symbol),
     description,
     source: getSourceLocation(declaration),
+    members,
     typeParameters,
     tags: parsedDoc?.tags,
     examples: parsedDoc?.examples
@@ -2937,6 +3033,7 @@ function serializeInterface(declaration, symbol, context) {
     ...metadata,
     kind: "interface",
     schema,
+    members,
     description,
     source: getSourceLocation(declaration),
     tags: parsedDoc?.tags

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@doccov/sdk",
-  "version": "0.3.4",
+  "version": "0.3.6",
   "description": "DocCov SDK - Documentation coverage and drift detection for TypeScript",
   "keywords": [
     "typescript",