Function generateObjectInterface

utils/typescript.mjs:512–554

(param, allParams, options = {})

}

function generateObjectInterface(param, allParams, options = {}) {
  // Check if this is an object parameter (either required or optional)
  const isObjectParam = param.type && (
    (param.type.type === 'OptionalType' && param.type.expression?.name === 'Object') ||
    (param.type.type === 'NameExpression' && param.type.name === 'Object')
  );

  if (!isObjectParam || !param.name) {
    return null;
  }

  let nestedParams = [];


  // First, check if the parameter has a properties array (JSDoc properties field)
  if (param.properties && Array.isArray(param.properties)) {
    nestedParams = param.properties.filter(prop => 
      prop.name && prop.name.startsWith(param.name + '.')
    );
  }

  // Fallback: Look for nested parameters with dot notation in allParams
  if (nestedParams.length === 0) {
    nestedParams = allParams.filter(p => 
      p.name && p.name.startsWith(param.name + '.') && p.name !== param.name
    );
  }

  if (nestedParams.length === 0) {
    return null;
  }

  // Generate interface properties
  const properties = nestedParams.map(nestedParam => {
    const propName = nestedParam.name.substring(param.name.length + 1); // Remove 'paramName.' prefix
    const propType = nestedParam.type ? convertTypeToTypeScript(nestedParam.type, options) : 'any';
    // Properties are optional if they have a default value or are explicitly marked as optional
    const isOptional = nestedParam.optional || nestedParam.type?.type === 'OptionalType' || nestedParam.default !== undefined;
    return `${propName}${isOptional ? '?' : ''}: ${propType}`;
  });

  return `{ ${properties.join('; ')} }`;
}

function generateParamDeclaration(param, options = {}, allParams = []) {
  if (!param) return '';