Function parseSubBlockObject

scripts/generate-docs.ts:3288–3326

* Parse a single SubBlockConfig object literal into a TriggerConfigField. * Returns null for blocks that should be skipped (UI-only IDs, text type, readOnly). * Accepts optional `resolverContent` to resolve const-reference field IDs.

(
  obj: string,
  uiOnlyIds: Set<string>,
  resolverContent?: string
)

 * Accepts optional `resolverContent` to resolve const-reference field IDs.
 */
function parseSubBlockObject(
  obj: string,
  uiOnlyIds: Set<string>,
  resolverContent?: string
): TriggerConfigField | null {
  let id: string | undefined = /\bid\s*:\s*['"]([^'"]+)['"]/.exec(obj)?.[1]

  // Handle const-reference ids: `id: SCREAMING_CASE_IDENTIFIER`
  if (!id) {
    const constRefMatch = /\bid\s*:\s*([A-Z][A-Z0-9_]+)\b/.exec(obj)
    if (constRefMatch) {
      id = resolveConstStringValue(constRefMatch[1], resolverContent ?? '') ?? undefined
    }
  }

  if (!id || uiOnlyIds.has(id)) return null

  const typeMatch = /\btype\s*:\s*['"]([^'"]+)['"]/.exec(obj)
  if (typeMatch?.[1] === 'text') return null
  if (/\breadOnly\s*:\s*true/.test(obj)) return null

  const titleMatch = /\btitle\s*:\s*['"]([^'"]+)['"]/.exec(obj)
  const requiredMatch = /\brequired\s*:\s*(true)/.exec(obj)
  const placeholderMatch = /\bplaceholder\s*:\s*['"]([^'"]+)['"]/.exec(obj)
  const descMatch = /\bdescription\s*:\s*['"]([^'"]+)['"]/.exec(obj)

  // Use title as description fallback so oauth-input and other fields without
  // an explicit description still show something meaningful in the docs table.
  const description = descMatch?.[1] ?? (titleMatch ? `${titleMatch[1]}` : undefined)

  return {
    id,
    title: titleMatch?.[1] ?? id,
    type: typeMatch?.[1] ?? 'short-input',
    required: Boolean(requiredMatch),
    placeholder: placeholderMatch?.[1],
    description,
  }
}

/**
 * Resolve a SubBlockConfig builder function to its field definitions.