Function generateAllBlockDocs

scripts/generate-docs.ts:3830–3866

()

}

async function generateAllBlockDocs() {
  try {
    // Copy icons from sim app to docs app
    copyIconsFile()

    // Generate icon mappings from block definitions
    const docsIconMapping = await generateIconMapping({ includeHidden: true })
    const visibleIconMapping = await generateIconMapping({ includeHidden: false })
    writeIconMapping(docsIconMapping)

    // Generate landing integrations page data (JSON + icon mapping)
    await writeIntegrationsJson(visibleIconMapping)
    writeIntegrationsIconMapping(visibleIconMapping)

    // Compute the canonical set of tool docs and clean up anything stale —
    // covers hidden blocks AND blocks re-categorized away from `'tools'`.
    const validToolDocs = await getCanonicalToolDocNames()
    cleanupStaleToolDocs(validToolDocs)

    const blockFiles = (await glob(`${BLOCKS_PATH}/*.ts`)).sort()

    for (const blockFile of blockFiles) {
      await generateBlockDoc(blockFile)
    }

    // Merge trigger sections into the per-service pages (and write trigger-only pages)
    await generateAllTriggerDocs()

    // Write the integrations meta after both passes so trigger-only pages are included
    updateMetaJson()

    return true
  } catch (error) {
    console.error('Error generating documentation:', error)
    return false
  }
}

function updateMetaJson() {
  const metaJsonPath = path.join(DOCS_OUTPUT_PATH, 'meta.json')