Function resolveSubBlockBuilderFunction

scripts/generate-docs.ts:3333–3406

* Resolve a SubBlockConfig builder function to its field definitions. * Handles `return [...]`, `return {...}`, and `blocks.push(...)` patterns. * Searches `utilsContent` first, then `primaryContent`.

(
  funcName: string,
  utilsContent: string,
  primaryContent?: string
)

 * Searches `utilsContent` first, then `primaryContent`.
 */
function resolveSubBlockBuilderFunction(
  funcName: string,
  utilsContent: string,
  primaryContent?: string
): TriggerConfigField[] {
  const UI_ONLY_IDS = new Set(['webhookUrlDisplay', 'triggerInstructions', 'selectedTriggerId'])

  for (const content of [utilsContent, primaryContent ?? '']) {
    if (!content) continue
    const funcRegex = new RegExp(`(?:export\\s+)?function\\s+${funcName}\\s*\\(`)
    const funcMatch = funcRegex.exec(content)
    if (!funcMatch) continue

    // Find the closing ')' of the parameter list, then the '{' that opens the function body.
    // Using just indexOf('{') would pick up '{' inside object-type parameters.
    const openParen = content.indexOf('(', funcMatch.index)
    if (openParen === -1) continue
    const closeParen = findMatchingClose(content, openParen, '(', ')')
    if (closeParen === -1) continue
    const bodyStart = content.indexOf('{', closeParen)
    if (bodyStart === -1) continue
    const bodyEnd = findMatchingClose(content, bodyStart)
    if (bodyEnd === -1) continue

    const funcBody = content.substring(bodyStart + 1, bodyEnd - 1)

    // Pattern 1: `return [...]`
    const returnArrayMatch = /\breturn\s*\[/.exec(funcBody)
    if (returnArrayMatch) {
      const arrayStart = funcBody.indexOf('[', returnArrayMatch.index)
      const arrayEnd = findMatchingClose(funcBody, arrayStart, '[', ']')
      if (arrayEnd !== -1) {
        return parseSubBlockArrayContent(
          funcBody.substring(arrayStart + 1, arrayEnd - 1),
          UI_ONLY_IDS,
          content
        )
      }
    }

    // Pattern 2: `return { ... }` (single object)
    const returnObjMatch = /\breturn\s*\{/.exec(funcBody)
    if (returnObjMatch) {
      const objStart = funcBody.indexOf('{', returnObjMatch.index)
      const objEnd = findMatchingClose(funcBody, objStart)
      if (objEnd !== -1) {
        const field = parseSubBlockObject(
          funcBody.substring(objStart, objEnd),
          UI_ONLY_IDS,
          content
        )
        return field ? [field] : []
      }
    }

    // Pattern 3: `blocks.push({...})`
    const pushFields: TriggerConfigField[] = []
    const pushRegex = /\bblocks\.push\s*\(/g