JSON Schema Docgen Rework

[ajlende]

What?

Reworks the theme.json reference docgen.

Key features include:

• Descriptions for styles and settings properties.
• Reworked type serialization to remove the props heading for styles and settings.
• Better types everywhere in the document.
• Details for settings and styles.
• The useRootPaddingAwareAlignments top-level property returns.
• Cleaner code.

Why?

Split out of #63591 so that both the schema changes and codegen changes can be reviewed independently from one another.

How?

Slow refactoring of the docgen code bit by bit. Check out the commits for details.

Testing Instructions

See that the new docs look correct.

Testing Instructions for Keyboard

N/A

Screenshots or screencast

N/A

[github-actions]

The following accounts have interacted with this PR and/or linked issues. I will continue to update these lists as activity occurs. You can also manually ask me to refresh this list by adding the props-bot label.

If you're merging code through a pull request on GitHub, copy and paste the following into the bottom of the merge commit message.

Co-authored-by: ajlende <ajlende@git.wordpress.org>
Co-authored-by: scruffian <scruffian@git.wordpress.org>
Co-authored-by: t-hamano <wildworks@git.wordpress.org>

To understand the WordPress project's expectations around crediting contributors, please review the Contributor Attribution page in the Core Handbook.

[scruffian]

I much prefer these headings.

[scruffian]

This is looking good. I deleted the auto generated section and ran node bin/api-docs/gen-theme-reference.mjs and it restored things as they are.

[t-hamano]

LGTM! Compared to previous documents, it is much easier to read, and the document generation logic seems to have been greatly refined.

Here's what the Block Editor Handbook might look like with this PR applied. I tested it by making a temporary change to one table:

61da15d550c203d2cd5e2faa7a76aa84.mp4