[wp-trac] [WordPress Trac] #61728: Stabilize experimental block supports including typography, border, and common flags

[WordPress Trac]

#61728: Stabilize experimental block supports including typography, border, and
common flags
--------------------------+------------------------------
 Reporter:  andrewserong  |       Owner:  (none)
     Type:  defect (bug)  |      Status:  new
 Priority:  normal        |   Milestone:  Awaiting Review
Component:  Editor        |     Version:  trunk
 Severity:  normal        |  Resolution:
 Keywords:  has-patch     |     Focuses:
--------------------------+------------------------------
Changes (by ramonopoly):

 * milestone:  6.8 => Awaiting Review


Old description:

> For WordPress 6.8, stabilize the experimental block support keys.
>
> The only current block support requiring stabilization is border support,
> its mapping to a stable key is: `__experimentalBorder` → `border`.
>
> Typography support has several experimental features that will be mapped
> to stable keys as follows:
>
> * `__experimentalFontFamily` → `fontFamily`
> * `__experimentalTextDecoration` → `textDecoration`
> * `__experimentalFontStyle` → `fontStyle`
> * `__experimentalFontWeight` → `fontWeight`
> * `__experimentalLetterSpacing` → `letterSpacing`
> * `__experimentalTextTransform` → `textTransform`
>
> There are also a couple of shared experimental support flags common
> across block supports. They will be mapped to stable keys as follows:
>
> * `__experimentalSkipSerialization` → `skipSerialization`
> * `__experimentalDefaultControls` → `defaultControls`
>
> This work is being tracked in the Gutenberg repo in:
>
> - https://github.com/WordPress/gutenberg/issues/63001
> - https://github.com/WordPress/gutenberg/issues/64312
>
> These updates will require syncing code from Gutenberg however, a
> slightly different implementation in core will be required to avoid the
> need for filters to apply the transformation of experimental to stable
> properties.
>
> The overall goal is to stabilize the experimental block support features.
> They have been in use for multiple releases, are ready for wider
> documentation, and are unlikely to change.
>
> This issue will track the backporting of changes from the following
> Gutenberg PRs:
>
> Typography Stabilization:
> https://github.com/WordPress/gutenberg/pull/63401
> Border Stabilization: https://github.com/WordPress/gutenberg/pull/66918
> Common Flag Stabilization:
> https://github.com/WordPress/gutenberg/pull/67018

New description:

 Stabilize the experimental block support keys.

 The only current block support requiring stabilization is border support,
 its mapping to a stable key is: `__experimentalBorder` → `border`.

 Typography support has several experimental features that will be mapped
 to stable keys as follows:

 * `__experimentalFontFamily` → `fontFamily`
 * `__experimentalTextDecoration` → `textDecoration`
 * `__experimentalFontStyle` → `fontStyle`
 * `__experimentalFontWeight` → `fontWeight`
 * `__experimentalLetterSpacing` → `letterSpacing`
 * `__experimentalTextTransform` → `textTransform`

 There are also a couple of shared experimental support flags common across
 block supports. They will be mapped to stable keys as follows:

 * `__experimentalSkipSerialization` → `skipSerialization`
 * `__experimentalDefaultControls` → `defaultControls`

 This work is being tracked in the Gutenberg repo in:

 - https://github.com/WordPress/gutenberg/issues/63001
 - https://github.com/WordPress/gutenberg/issues/64312

 These updates will require syncing code from Gutenberg however, a slightly
 different implementation in core will be required to avoid the need for
 filters to apply the transformation of experimental to stable properties.

 The overall goal is to stabilize the experimental block support features.
 They have been in use for multiple releases, are ready for wider
 documentation, and are unlikely to change.

 This issue will track the backporting of changes from the following
 Gutenberg PRs:

 Typography Stabilization:
 https://github.com/WordPress/gutenberg/pull/63401
 Border Stabilization: https://github.com/WordPress/gutenberg/pull/66918
 Common Flag Stabilization:
 https://github.com/WordPress/gutenberg/pull/67018

--

Comment:

 Punting this for 6.9/TBD

-- 
Ticket URL: <https://core.trac.wordpress.org/ticket/61728#comment:14>
WordPress Trac <https://core.trac.wordpress.org/>
WordPress publishing platform