[wp-trac] [WordPress Trac] #61728: Stabilize experimental block supports including typography, border, and common flags (was: Stabilize experimental Typography block support keys)

[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:  6.8
Component:  Editor        |     Version:  trunk
 Severity:  normal        |  Resolution:
 Keywords:  has-patch     |     Focuses:
--------------------------+---------------------
Changes (by aaronrobertshaw):

 * version:  6.7 => trunk
 * milestone:  Future Release => 6.8


Old description:

> For WordPress 6.8, stabilize the experimental Typography block support
> keys. The current experimental features and mapping to stable keys are:
>
> * `__experimentalFontFamily` → `fontFamily`
> * `__experimentalTextDecoration` → `textDecoration`
> * `__experimentalFontStyle` → `fontStyle`
> * `__experimentalFontWeight` → `fontWeight`
> * `__experimentalLetterSpacing` → `letterSpacing`
> * `__experimentalTextTransform` → `textTransform`
> * `__experimentalWritingMode` → `writingMode`
>
> This work is being tracked in the Gutenberg repo in:
> https://github.com/WordPress/gutenberg/issues/63001
>
> It will require syncing code from Gutenberg, but also a slightly
> different implementation in core so that we don't need to use filters to
> apply the transformation from experimental to stable properties.
>
> The overall goal is to stabilize the experimental typography features in
> block supports, as they have been in use for multiple releases and are
> ready for wider documentation, and are unlikely to change.

New 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

--

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