Function generateTypedefInterface

utils/typescript.mjs:396–445

(name, typedefEntry, options = {}, indent = 2)

// Generate a TypeScript interface from a typedef with @property fields
function generateTypedefInterface(name, typedefEntry, options = {}, indent = 2) {
  const pad = ' '.repeat(indent);
  const innerPad = ' '.repeat(indent + 2);
  let output = '';

  if (typedefEntry.description) {
    const descStr = typeof typedefEntry.description === 'string'
      ? typedefEntry.description
      : descriptionStringForTypeScript(typedefEntry.description);
    if (descStr) {
      output += `${pad}/**\n`;
      output += formatJSDocComment(descStr, indent) + '\n';
      output += `${pad} */\n`;
    }
  }

  output += `${pad}interface ${name} {\n`;

  for (const prop of typedefEntry.properties) {
    // Each prop: { name, type, description, optional }
    const propName = prop.name;
    const rawType = prop.type;
    const isOptional = prop.optional || rawType?.type === 'OptionalType';
    const optMark = isOptional ? '?' : '';

    if (prop.description) {
      const propDescStr = typeof prop.description === 'string'
        ? prop.description.trim()
        : descriptionStringForTypeScript(prop.description);
      if (propDescStr) {
        output += `${innerPad}/** ${propDescStr} */\n`;
      }
    }

    if (rawType?.type === 'FunctionType') {
      // Render FunctionType properties as method signatures instead of arrow properties
      const sig = convertFunctionTypeForInterface(rawType, options);
      const arrowIdx = sig.lastIndexOf('=>');
      const paramsPart = sig.substring(0, arrowIdx).trim();
      const retPart = sig.substring(arrowIdx + 2).trim();
      output += `${innerPad}${propName}${paramsPart}: ${retPart};\n`;
    } else {
      const tsType = rawType ? convertTypeToTypeScript(rawType, options) : 'any';
      output += `${innerPad}${propName}${optMark}: ${tsType};\n`;
    }
  }

  output += `${pad}}\n\n`;
  return output;
}

// Strategy for TypeScript output
const typescriptStrategy = {