Function extractTriggerConfigFields

scripts/generate-docs.ts:3459–3520

* Extract user-facing configuration fields from a TriggerConfig subBlocks definition. * Handles both inline arrays (`subBlocks: [...]`) and builder function calls * (`subBlocks: buildXSubBlocks({...})`), resolving them from the trigger file and utils.ts.

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

 * (`subBlocks: buildXSubBlocks({...})`), resolving them from the trigger file and utils.ts.
 */
function extractTriggerConfigFields(
  segment: string,
  primaryContent?: string,
  utilsContent?: string
): TriggerConfigField[] {
  const UI_ONLY_IDS = new Set(['webhookUrlDisplay', 'triggerInstructions', 'selectedTriggerId'])
  const allContent = utilsContent || primaryContent || ''

  // Case 1: Inline subBlocks: [...]
  const subBlocksMatch = /\bsubBlocks\s*:\s*\[/.exec(segment)
  if (subBlocksMatch) {
    const arrayStart = subBlocksMatch.index + subBlocksMatch[0].length - 1
    const arrayEnd = findMatchingClose(segment, arrayStart, '[', ']')
    if (arrayEnd === -1) return []
    return parseSubBlockArrayContent(
      segment.substring(arrayStart + 1, arrayEnd - 1),
      UI_ONLY_IDS,
      allContent
    )
  }

  // Case 2: Builder function call — subBlocks: buildXFunc(...)
  if (!allContent) return []
  const builderCallMatch = /\bsubBlocks\s*:\s*(\w+)\s*\(/.exec(segment)
  if (!builderCallMatch) return []

  const funcName = builderCallMatch[1]

  // Special case: buildTriggerSubBlocks — user config lives in the `extraFields` parameter
  if (funcName === 'buildTriggerSubBlocks') {
    const openParen = builderCallMatch.index + builderCallMatch[0].length - 1
    const closeParen = findMatchingClose(segment, openParen, '(', ')')
    if (closeParen === -1) return []

    const argsBody = segment.substring(openParen + 1, closeParen - 1)
    const extraFieldsMatch = /\bextraFields\s*:\s*/.exec(argsBody)
    if (!extraFieldsMatch) return []

    // Find first non-whitespace char after "extraFields:"
    let valuePos = extraFieldsMatch.index + extraFieldsMatch[0].length
    while (valuePos < argsBody.length && /\s/.test(argsBody[valuePos])) valuePos++

    if (argsBody[valuePos] === '[') {
      // extraFields: [...] — inline array, may contain function calls
      const arrayEnd = findMatchingClose(argsBody, valuePos, '[', ']')
      if (arrayEnd === -1) return []
      return parseSubBlockArrayContent(
        argsBody.substring(valuePos + 1, arrayEnd - 1),
        UI_ONLY_IDS,
        allContent
      )
    }

    // extraFields: buildXFunc(args) — resolve the builder function
    const extraFuncMatch = /^(\w+)\s*\(/.exec(argsBody.substring(valuePos))
    if (!extraFuncMatch) return []
    return resolveSubBlockBuilderFunction(extraFuncMatch[1], allContent)
  }