Function buildTriggersSection

scripts/generate-docs.ts:3652–3710

* Build the "## Triggers" section for an integration page. A trigger is a block * that starts a workflow, so this is appended to the service's actions page (or * used as the body of a trigger-only service page).

(triggers: TriggerFullInfo[])

 * used as the body of a trigger-only service page).
 */
function buildTriggersSection(triggers: TriggerFullInfo[]): string {
  const allPolling = triggers.every((t) => t.polling)
  const mixedTypes = triggers.some((t) => t.polling) && triggers.some((t) => !t.polling)

  let typeNote = ''
  if (allPolling) {
    typeNote =
      '\nThese run on a schedule \\(**polling-based**\\) — they check for new data rather than receiving push notifications.\n'
  } else if (mixedTypes) {
    typeNote =
      '\nSome of these are **polling-based** \\(checked on a schedule\\) while others are push-based webhooks.\n'
  }

  let triggersSection = ''
  for (let i = 0; i < triggers.length; i++) {
    const trigger = triggers[i]

    // Configuration table
    let configSection = ''
    if (trigger.configFields.length > 0) {
      configSection = '#### Configuration\n\n'
      configSection += '| Parameter | Type | Required | Description |\n'
      configSection += '| --------- | ---- | -------- | ----------- |\n'
      for (const field of trigger.configFields) {
        const type = toSemanticType(field.type)
        const desc = escapeMdxCell(field.description ?? field.placeholder ?? '')
        configSection += `| \`${field.id}\` | ${type} | ${field.required ? 'Yes' : 'No'} | ${desc} |\n`
      }
      configSection += '\n'
    }

    // Output table
    let outputSection = ''
    if (Object.keys(trigger.outputs).length > 0) {
      outputSection = '#### Output\n\n'
      outputSection += '| Parameter | Type | Description |\n'
      outputSection += '| --------- | ---- | ----------- |\n'
      outputSection += formatOutputStructure(trigger.outputs)
      outputSection += '\n'
    }

    const separator = i < triggers.length - 1 ? '\n---\n\n' : ''

    triggersSection += `### ${trigger.name}\n\n`
    const escapedTriggerDescription = trigger.description
      .replace(/\{/g, '\\{')
      .replace(/\}/g, '\\}')
    triggersSection += `${escapedTriggerDescription}\n\n`
    triggersSection += configSection
    triggersSection += outputSection
    triggersSection += separator
  }

  return `## Triggers

A **Trigger** is a block that starts a workflow when an event happens in this service.
${typeNote}
${triggersSection}`