Function convertFunctionTypeForInterface

utils/typescript.mjs:364–393

(typeNode, options)

// Convert JSDoc FunctionType into a TypeScript function signature string
function convertFunctionTypeForInterface(typeNode, options) {
  const params = (typeNode.params || [])
    .map((param, i) => {
      let typeObj;
      let paramName;
      if (param.type === 'ParameterType') {
        typeObj = param.expression;
        paramName = param.name ?? `p${i}`;
      } else if (typeof param.type === 'object' && param.type !== null) {
        typeObj = param.type;
        paramName = param.name ?? `p${i}`;
      } else {
        // param itself is a plain type node
        typeObj = param;
        paramName = `p${i}`;
      }
      const paramType = convertTypeToTypeScript(typeObj, options);
      return `${paramName}: ${paramType}`;
    })
    .join(', ');

  const returnType = typeNode.result
    ? convertTypeToTypeScript(typeNode.result, options)
    : 'void';

  // Normalise 'undefined' return to 'void' for idiomatic TypeScript
  const normalisedReturn = returnType === 'undefined' ? 'void' : returnType;

  return `(${params}) => ${normalisedReturn}`;
}

// Generate a TypeScript interface from a typedef with @property fields
function generateTypedefInterface(name, typedefEntry, options = {}, indent = 2) {