Function generateTypeDefinitions

utils/typescript.mjs:709–944

()

// Generate TypeScript definitions
function generateTypeDefinitions() {
  let output = '// This file is auto-generated from JSDoc documentation\n\n';

  // First, define all constants at the top level with their actual values
  const seenConstants = new Set();
  const p5Constants = processed.classitems.filter(item => {
    if (item.class === 'p5' && item.itemtype === 'property' && item.name in processed.consts) {
      // Skip defineProperty, undefined and avoid duplicates
      if (item.name === 'defineProperty' || !item.name) {
        return false;
      }
      if (seenConstants.has(item.name)) {
        return false;
      }
      // Skip typedefs that have real object shapes
      if (typedefs[item.name] && hasTypedefProperties(typedefs[item.name])) {
        return false;
      }
      seenConstants.add(item.name);
      return true;
    }
    return false;
  });

  p5Constants.forEach(constant => {
    if (constant.description) {
      output += '/**\n';
      output += formatJSDocComment(constant.description, 0) + '\n';
      output += ' */\n';
    }
    const type = convertTypeToTypeScript(constant.type, { isInsideNamespace: false, isConstantDef: true });
    const isMutable = mutableProperties.has(constant.name);
    const declaration = isMutable ? 'declare let' : 'declare const';
    output += `${declaration} ${constant.name}: ${type};\n\n`;
    // Duplicate with a private identifier so we can re-export in the namespace later
    output += `${declaration} __${constant.name}: typeof ${constant.name};\n\n`;
  });

  // Generate main p5 class
  output += 'declare class p5 {\n';
  output += '  constructor(sketch?: (p: p5) => void, node?: HTMLElement, sync?: boolean);\n\n';

  const p5Options = { currentClass: 'p5', isInsideNamespace: false };

  // Generate p5 static methods
  const p5StaticMethods = Object.values(processed.classMethods.p5 || {}).filter(method => method.static);
  p5StaticMethods.forEach(method => {
    output += generateMethodDeclaration(method, p5Options);
  });

  // Generate p5 instance methods
  const p5InstanceMethods = Object.values(processed.classMethods.p5 || {}).filter(method => !method.static);
  p5InstanceMethods.forEach(method => {
    output += generateMethodDeclaration(method, p5Options);
  });

  // Add strands functions to p5 instance
  const strandsMethods = processStrandsFunctions();