Stabilisation Roadmap

[JohnnyMorganz]

StyLua is pretty stable now, with the formatting not changing wildly anymore. We should look to stabilise to something like v2.0.0

Stabilisation Guarantees:

• The formatting output is stable, and should not change excessively
• Major code formatting changes will be classified as a breaking change and will require a major version bump
• Minor version bumps will still allow minor style changes, especially around edge cases.
• With the above three points, a minor/patch version bump should not result in excessive diff noise

Checklist before stabilisation:

• Runtime syntax selection support (syntax = "Lua51"/"Lua52"/"Luau") [Build Release Assets for all StyLua variants #103, Lua 5.2 label syntax error when using binary built all features enabled #407]. This requires support upstream in full-moon
• Allow ignore comments to be used in places other than before statements #448
• Investigate ways to allow users to pin to an exact version of stylua easily in their tools (to prevent mismatching diffs - Provide ways to enforce StyLua versions in codebase #398)
• (Potentially) Lua 5.3 and Lua 5.4 support [Support Lua5.4 local var attributes like <const> ?  #533, Support Lua 5.3 syntax #534]. This requires support upstream in full-moon
• Make stdin support respect-ignores flag: Support --respect-ignores #765
• Remove legacy build artifacts (old names) from releases

... and a bit more as I continue to think on it. (All issues labelled as "bug" should also be resolved beforehand)

[JohnnyMorganz]

It is time :)

[chenrui333]

@JohnnyMorganz 👋 just curious, why not go with 1.0.0 before 2.0.0? :)

[JohnnyMorganz]

I didn't think v1 made much sense given StyLua has been in use for several years and across several versions now: v1 almost indicates to me it's the "initial release" of the project

[chenrui333]

cool, thanks for confirming it. 👍 (and congrats on the v2.0.0 release 🚀 )