add/lys xstate scaffolding

[rjchow]

• dev: added xstate 5
• add xstate scaffolding for launch your store

Submission Review Guidelines:

• I have followed the WooCommerce Contributing Guidelines and the WordPress Coding Standards.
• I have checked to ensure there aren't other open Pull Requests for the same update/change.
• I have reviewed my code for security best practices.
• Following the above guidelines will result in quick merges and clear and detailed feedback when appropriate.

Changes proposed in this Pull Request:

Closes #45116.

Note that this PR has installed xstate v5 simultaneously alongside xstate v4. There is a postinstall script which correctly symlinks the expected packages.

This arrangement will be required to be in place until we migrate the previous xstate machines over to v5.

How to test the changes in this Pull Request:

Please exclude from Solaris and GlobalStep testing as this is gated behind a feature flag and is part of the Launch Your Store feature which will be tested as a complete feature when the call for testing is released.

1. Ensure that the "launch-your-store" feature flag is enabled using WC Beta Tester plugin
2. Go to http://localhost:8888/wp-admin/admin.php?page=wc-admin&path=%2Flaunch-your-store and test around

Screen.Recording.2024-03-13.at.23.53.23.mov

Note that the browser back button will not work as expected as it has not been implemented and will be implemented in a follow up PR.

The XState inspector will also not work as the currently installed version only works for xstate v4 while this PR uses xstate v5. This will also be addressed in a follow up PR. In the mean time please use the debug output in this PR to assist.

Changelog entry

• Automatically create a changelog entry from the details below.

Significance

• Patch
• Minor
• Major

Type

• Fix - Fixes an existing bug
• Add - Adds functionality
• Update - Update existing functionality
• Dev - Development related task
• Tweak - A minor adjustment to the codebase
• Performance - Address performance issues
• Enhancement - Improvement to existing functionality

Message

Comment

[github-actions]

Hi @ilyasfoo, @adrianduffell, @woocommerce/ghidorah

Apart from reviewing the code changes, please make sure to review the testing instructions as well.

You can follow this guide to find out what good testing instructions should look like:
https://github.com/woocommerce/woocommerce/wiki/Writing-high-quality-testing-instructions

[github-actions]

Test Results Summary

Commit SHA: 13f4245

Test 🧪	Passed ✅	Failed 🚨	Broken 🚧	Skipped ⏭️	Unknown ❔	Total 📊	Duration ⏱️
API Tests	259	0	0	2	0	261	0m 38s
E2E Tests	342	0	0	11	0	353	7m 39s

---

To view the full API test report, click here.
To view the full E2E test report, click here.
To view all test reports, visit the WooCommerce Test Reports Dashboard.

[chihsuan]

Awesome, testing well! 👍

I just have one feedback. I found it a bit difficult to know whether the file is for the sidebar, main content page, or xstate machine definition from the filenames and paths. It's not a problem now, but I think it would be better if we could tell at a glance. 🙂

[adrianduffell]

It tested well! Thanks @rjchow 🚀

@chihsuan's suggestion and the inspector support for v5 sound great as follow-up issues. If you agree, could you please create those 🙏

[rjchow]

Thanks for the reviews @adrianduffell and @chihsuan! I'm doing the folder organisation this PR since it's a minor work to do here and a fair bit of work to put a new PR up for.