import type { TSTypeKind } from "ast-types/gen/kinds"
import type * as cs from "jscodeshift"
//
// this is needed to resolve a bug in jscodeshift that
// forgets to traverse type parameters in call expressions
//
declare module "ast-types/gen/namedTypes.js" {
namespace namedTypes {
interface CallExpression extends TSHasOptionalTypeParameterInstantiation {}
}
}
export default function transformer(file: cs.FileInfo, api: cs.API) {
const j = api.jscodeshift
const root = j(file.source)
root.find(j.ExportNamedDeclaration).forEach((path) => {
const declaration = path.node.declaration
if (!j.VariableDeclaration.check(declaration)) return
const comments = path.node.comments ?? []
declaration.declarations.forEach((declarator) => {
if (!j.VariableDeclarator.check(declarator) || !j.Identifier.check(declarator.id)) return
const annotation = declarator.id.typeAnnotation
if (annotation) {
// An explicit annotation is the public type; leave the initializer alone.
if (!j.TSTypeAnnotation.check(annotation) || !j.TSTypeLiteral.check(annotation.typeAnnotation)) return
annotation.typeAnnotation.members.forEach((member) => {
if (!j.TSCallSignatureDeclaration.check(member) || hasComments(member)) return
member.comments = comments
})
return
}
const init = declarator.init
if (!j.CallExpression.check(init)) return
const callee = init.callee
const isDual = j.Identifier.check(callee) && callee.name === "dual"
|| j.MemberExpression.check(callee) && !callee.computed
&& j.Identifier.check(callee.object) && callee.object.name === "Dual"
&& j.Identifier.check(callee.property) && callee.property.name === "dual"
if (!isDual) return
// Only the dual call's own type arguments describe the public overloads.
init.typeParameters?.params.forEach((param) => {
// Don't override comments if they already exist
if (hasLeadingCommentRanges(param) || hasComments(param)) return
param.comments = comments
})
})
})
return root.toSource()
}
function hasComments(node: cs.Node) {
return Array.isArray(node.comments)
}
function hasLeadingCommentRanges(node: TSTypeKind) {
return "leadingComments" in node && Array.isArray(node.leadingComments) && node.leadingComments.length > 0
}