Function functionSignature

repos/effect/packages/tools/jsdocs/src/Jsdocs.ts:2833–2872

(
  name: string,
  symbol: ts.Symbol,
  location: ts.Node,
  checker: ts.TypeChecker,
  cwd: string
)

function signatureParameterName(parameter: ts.Symbol): string {
  const declaration = signatureParameterDeclaration(parameter)
  if (declaration !== undefined && ts.isIdentifier(declaration.name)) return declaration.name.text
  return parameter.getName()
}

function signatureFunctionThisKind(type: ts.Type, checker: ts.TypeChecker, location: ts.Node): string {
  const thisParameter = checker.getSignaturesOfType(type, ts.SignatureKind.Call)[0]?.thisParameter
  if (thisParameter === undefined) return "none"
  const thisType = checker.typeToString(
    checker.getTypeOfSymbolAtLocation(thisParameter, location),
    location,
    signatureTypeFormatFlags
  )
  return thisType === "unassigned" ? "unassigned" : "self"
}

function isSignatureFunctionKind(kind: string): boolean {
  return kind.startsWith("body:") || kind.startsWith("function:")
}

function signatureTransformCountKind(count: number): string {
  if (count <= 3) return String(count)
  if (count <= 7) return "4"
  if (count <= 15) return "8"
  return "16"
}

function signatureParameterKind(
  parameter: ts.Symbol | undefined,
  checker: ts.TypeChecker,
  location: ts.Node
): string {
  if (parameter === undefined) return "none"
  const declaration = signatureParameterDeclaration(parameter)
  if (declaration?.dotDotDotToken !== undefined) return "rest"
  const name = signatureParameterName(parameter).replace(/_$/, "").toLowerCase()
  const type = checker.getTypeOfSymbolAtLocation(parameter, declaration ?? location)
  if (name === "self" || name === "that") return "self"
  if (name === "body") return `body:${signatureFunctionThisKind(type, checker, location)}`
  if (name === "name" || name === "spanname") return "name"
  if (name.includes("refinement")) return "refinement"
  if (name.includes("predicate")) return "predicate"
  if (name === "options" || name === "option" || name === "opts" || name === "config" || name === "args") {