docs-util: add support for workflows in markdown theme

[shahednasser]

This PR adds support for displaying workflows and their diagrams in the markdown theme used when generating references. It also makes changes to docs-ui and typedoc-plugin-workflows.

Changes

Markdown Theme

• Detect workflows to show in a workflow's reference its diagram, input, output, and hooks details.

typedoc-plugin-workflows

• Add support for parallelize and when when picking up steps.

docs-ui

Stole and adapted the workflows execution canvas from the admin to show a diagram of the workflow's steps.

---

Demo

The references aren't generated in this PR so they aren't viewable in the preview.

General

This isn't shown in the video, but clicking on a step takes you to its own reference, and clicking on a hook takes you to its section within the same workflow's reference.

Screen.Recording.2024-08-07.at.3.54.31.PM.mov

Steps in When condition

---

Next Steps

• Workflow inputs and steps that aren't exported in core-flows can't be generated in the reference. So, I'll open a PR to export them (If the file changes are big I'll open PRs in chunks)
• Separate workflows and steps into namespaces to show them in the main reference / sidebar under "Workflows" and "Steps"
• Add TSDocs for the workflows, inputs, etc... for better explanations and examples. This isn't a high priority at the moment.

Closes DOCS-862

[vercel]

The latest updates on your projects. Learn more about Vercel for Git ↗︎

Name	Status	Preview	Comments	Updated (UTC)
medusa-dashboard	✅ Ready (Inspect)	Visit Preview	💬 Add feedback	Aug 9, 2024 0:48am

6 Skipped Deployments

Name	Status	Preview	Comments	Updated (UTC)
api-reference	⬜️ Ignored (Inspect)			Aug 9, 2024 0:48am
api-reference-v2	⬜️ Ignored (Inspect)	Visit Preview		Aug 9, 2024 0:48am
docs-ui	⬜️ Ignored (Inspect)	Visit Preview		Aug 9, 2024 0:48am
docs-v2	⬜️ Ignored (Inspect)	Visit Preview		Aug 9, 2024 0:48am
medusa-docs	⬜️ Ignored (Inspect)	Visit Preview		Aug 9, 2024 0:48am
resources-docs	⬜️ Ignored (Inspect)	Visit Preview		Aug 9, 2024 0:48am

[changeset-bot]

⚠️ No Changeset found

Latest commit: 51bd4b0

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR

[olivermrbl]

🚢 🚢 🚢

[thetutlage]

Wow! This looks so cool :)