Stable Release 1.0.0

[dereuromark]

I think within a few months or even weeks of stabilizing the API and internals, we should be able to release a stable version.
Any concerns so far? Issues or improvements that are worth mentioning?

I am currently on the fence about the following:

Defaults

Should array trailing commas be the default? Yes/No?
I like it, not sure how people using TOML feel so far.

Any other reasonable defaults?
Or should the default be "roundtrip" safe, minimal changes.
And instead, adding the ::diffFriendly() wrapper it becomes quickly what we want anyway here?

Also

1. Null byte property names - Currently fails 1 valid test due to PHP limitation. Document as known limitation or find
   workaround?
2. Control character validation - Currently lenient for performance. Should 1.0 enforce strict validation by default?
3. TOML version default - Should the default be TOML 1.0 (more widely supported) or 1.1? (Do we have to major every time we want to go with next minor release?)

Feature Completeness

1. Roadmap items (Issue Feature roadmap: potential enhancements #8) - Should any encoder options or schema validation be in 1.0, or defer to 1.1+?
2. Streaming/incremental parsing - Explicitly out of scope for 1.0, or planned?
3. GMP-backed integers - Same question - out of scope or planned?

Finally

1. Semver guarantees - What constitutes a breaking change going forward?

[roxblnfk]

Hi. I would prefer default behavior that ensures maximum stability during updates:

• Encoding by the minimum version. If it's a loaded document, then by its minimum version. This way, the PHP service won't break the contract with other services if they are not ready for a newer TOML version.
• Decoding by the maximum version.

[dereuromark]

I think this makes sense:

• encoding: min (defaults to 1.0 always)
• decoding: max (currently 1.1)

If there are no further comments or feedback, should we plan a 1.0 stable release with those settings?
Anything else we need before doing so?

[roxblnfk]

What about php8.1? Is it possible to support it?

For example in v1.0.x
And drop since 1.1.x

In this case, I would deprecate my package in favor of this one.

[dereuromark]

Whats the reason for 8.1 for you?

[roxblnfk]

Open-source packages that provide a wide range of supported php versions.
https://packagist.org/packages/internal/toml/dependents

It's not a lot, but it's the reason why I created my package.

[dereuromark]

At this point no one should be using lower than 8.2
That said: feel free to make a PR
If no big draw backs, we can downgrade release a minor here anytime.