WordPress.org
Get WordPress

Make WordPress Core

Changeset 58328


Ignore:
Timestamp:
06/04/2024 11:53:37 AM (4 months ago)
Author:
ellatrix
Message:

Editor: Add theme.json v3 migrations.

See ​https://github.com/WordPress/wordpress-develop/pull/6616.
See also the original Gutenberg PRs:

Fixes #61282.

Props ajlende, talldanwp, ramonopoly, ellatrix.

Location:
trunk
Files:
34 edited

Legend:

Unmodified
Added
Removed

  • trunk/src/wp-includes/block-editor.php

    r56736 r58328  
    815815 *
    816816 * @since 6.2.0
     817 * @since 6.6.0 Add support for 'editor-spacing-sizes' theme support.
    817818 *
    818819 * @return array The classic theme supports settings.
    … …  
    845846    }
    846847
     848    $spacing_sizes = current( (array) get_theme_support( 'editor-spacing-sizes' ) );
     849    if ( false !== $spacing_sizes ) {
     850        $theme_settings['spacingSizes'] = $spacing_sizes;
     851    }
     852
    847853    return $theme_settings;
    848854}

  • trunk/src/wp-includes/class-wp-theme-json-data.php

    r58185 r58328  
    4040     * @param string $origin The origin of the data: default, theme, user.
    4141     */
    42     public function __construct( $data = array(), $origin = 'theme' ) {
     42    public function __construct( $data = array( 'version' => WP_Theme_JSON::LATEST_SCHEMA ), $origin = 'theme' ) {
    4343        $this->origin     = $origin;
    4444        $this->theme_json = new WP_Theme_JSON( $data, $this->origin );

  • trunk/src/wp-includes/class-wp-theme-json-resolver.php

    r58265 r58328  
    221221     * @since 5.9.0 Theme supports have been inlined and the `$theme_support_data` argument removed.
    222222     * @since 6.0.0 Added an `$options` parameter to allow the theme data to be returned without theme supports.
     223     * @since 6.6.0 Add support for 'default-font-sizes' and 'default-spacing-sizes' theme supports.
    223224     *
    224225     * @param array $deprecated Deprecated. Not used.
    … …  
    244245                $theme_json_data = static::translate( $theme_json_data, $wp_theme->get( 'TextDomain' ) );
    245246            } else {
    246                 $theme_json_data = array();
     247                $theme_json_data = array( 'version' => WP_Theme_JSON::LATEST_SCHEMA );
    247248            }
    248249
    … …  
    311312            $theme_support_data['settings']['color']['defaultGradients'] = $default_gradients;
    312313
     314            if ( ! isset( $theme_support_data['settings']['typography'] ) ) {
     315                $theme_support_data['settings']['typography'] = array();
     316            }
     317            $default_font_sizes = false;
     318            if ( current_theme_supports( 'default-font-sizes' ) ) {
     319                $default_font_sizes = true;
     320            }
     321            if ( ! isset( $theme_support_data['settings']['typography']['fontSizes'] ) ) {
     322                // If the theme does not have any font sizes, we still want to show the core one.
     323                $default_font_sizes = true;
     324            }
     325            $theme_support_data['settings']['typography']['defaultFontSizes'] = $default_font_sizes;
     326
     327            if ( ! isset( $theme_support_data['settings']['spacing'] ) ) {
     328                $theme_support_data['settings']['spacing'] = array();
     329            }
     330            $default_spacing_sizes = false;
     331            if ( current_theme_supports( 'default-spacing-sizes' ) ) {
     332                $default_spacing_sizes = true;
     333            }
     334            if ( ! isset( $theme_support_data['settings']['spacing']['spacingSizes'] ) ) {
     335                // If the theme does not have any spacing sizes, we still want to show the core one.
     336                $default_spacing_sizes = true;
     337            }
     338            $theme_support_data['settings']['spacing']['defaultSpacingSizes'] = $default_spacing_sizes;
     339
    313340            if ( ! isset( $theme_support_data['settings']['shadow'] ) ) {
    314341                $theme_support_data['settings']['shadow'] = array();
    … …  
    360387        }
    361388
    362         $config = array( 'version' => 2 );
     389        $config = array( 'version' => WP_Theme_JSON::LATEST_SCHEMA );
    363390        foreach ( $blocks as $block_name => $block_type ) {
    364391            if ( isset( $block_type->supports['__experimentalStyle'] ) ) {
    … …  
    495522     *
    496523     * @since 5.9.0
     524     * @since 6.6.0 The 'isGlobalStylesUserThemeJSON' flag is left on the user data.
    497525     *
    498526     * @return WP_Theme_JSON Entity that holds styles for user data.
    … …  
    532560                $decoded_data['isGlobalStylesUserThemeJSON']
    533561            ) {
    534                 unset( $decoded_data['isGlobalStylesUserThemeJSON'] );
    535562                $config = $decoded_data;
    536563            }
    … …  
    538565
    539566        /** This filter is documented in wp-includes/class-wp-theme-json-resolver.php */
    540         $theme_json   = apply_filters( 'wp_theme_json_data_user', new WP_Theme_JSON_Data( $config, 'custom' ) );
    541         static::$user = $theme_json->get_theme_json();
     567        $theme_json = apply_filters( 'wp_theme_json_data_user', new WP_Theme_JSON_Data( $config, 'custom' ) );
     568        $config     = $theme_json->get_data();
     569
     570        // Needs to be set for schema migrations of user data.
     571        $config['isGlobalStylesUserThemeJSON'] = true;
     572
     573        static::$user = new WP_Theme_JSON( $config, 'custom' );
    542574
    543575        return static::$user;
    … …  
    587619        $result->merge( static::get_core_data() );
    588620        if ( 'default' === $origin ) {
    589             $result->set_spacing_sizes();
    590621            return $result;
    591622        }
    … …  
    598629        $result->merge( static::get_theme_data() );
    599630        if ( 'theme' === $origin ) {
    600             $result->set_spacing_sizes();
    601631            return $result;
    602632        }
    603633
    604634        $result->merge( static::get_user_data() );
    605         $result->set_spacing_sizes();
    606635
    607636        return $result;

  • trunk/src/wp-includes/class-wp-theme-json-schema.php

    r56753 r58328  
    3636     *
    3737     * @since 5.9.0
     38     * @since 6.6.0 Migrate up to v3.
    3839     *
    3940     * @param array $theme_json The structure to migrate.
    … …  
    4849        }
    4950
    50         if ( 1 === $theme_json['version'] ) {
    51             $theme_json = self::migrate_v1_to_v2( $theme_json );
     51        // Migrate each version in order starting with the current version.
     52        switch ( $theme_json['version'] ) {
     53            case 1:
     54                $theme_json = self::migrate_v1_to_v2( $theme_json );
     55                // no break
     56            case 2:
     57                $theme_json = self::migrate_v2_to_v3( $theme_json );
     58                // no break
    5259        }
    5360
    … …  
    8188        // Set the new version.
    8289        $new['version'] = 2;
     90
     91        return $new;
     92    }
     93
     94    /**
     95     * Migrates from v2 to v3.
     96     *
     97     * - Sets settings.typography.defaultFontSizes to false.
     98     *
     99     * @since 6.6.0
     100     *
     101     * @param array $old Data to migrate.
     102     *
     103     * @return array Data with defaultFontSizes set to false.
     104     */
     105    private static function migrate_v2_to_v3( $old ) {
     106        // Copy everything.
     107        $new = $old;
     108
     109        // Set the new version.
     110        $new['version'] = 3;
     111
     112        /*
     113         * Remaining changes do not need to be applied to the custom origin,
     114         * as they should take on the value of the theme origin.
     115         */
     116        if (
     117            isset( $new['isGlobalStylesUserThemeJSON'] ) &&
     118            true === $new['isGlobalStylesUserThemeJSON']
     119        ) {
     120            return $new;
     121        }
     122
     123        /*
     124         * Even though defaultFontSizes and defaultSpacingSizes are new
     125         * settings, we need to migrate them as they each control
     126         * PRESETS_METADATA prevent_override values which were previously
     127         * hardcoded to false. This only needs to happen when the theme provides
     128         * fontSizes or spacingSizes as they could match the default ones and
     129         * affect the generated CSS.
     130         */
     131        if ( isset( $old['settings']['typography']['fontSizes'] ) ) {
     132            if ( ! isset( $new['settings'] ) ) {
     133                $new['settings'] = array();
     134            }
     135            if ( ! isset( $new['settings']['typography'] ) ) {
     136                $new['settings']['typography'] = array();
     137            }
     138            $new['settings']['typography']['defaultFontSizes'] = false;
     139        }
     140
     141        /*
     142         * Similarly to defaultFontSizes, we need to migrate defaultSpacingSizes
     143         * as it controls the PRESETS_METADATA prevent_override which was
     144         * previously hardcoded to false. This only needs to happen when the
     145         * theme provided spacing sizes via spacingSizes or spacingScale.
     146         */
     147        if (
     148            isset( $old['settings']['spacing']['spacingSizes'] ) ||
     149            isset( $old['settings']['spacing']['spacingScale'] )
     150        ) {
     151            if ( ! isset( $new['settings'] ) ) {
     152                $new['settings'] = array();
     153            }
     154            if ( ! isset( $new['settings']['spacing'] ) ) {
     155                $new['settings']['spacing'] = array();
     156            }
     157            $new['settings']['spacing']['defaultSpacingSizes'] = false;
     158        }
     159
     160        /*
     161         * In v3 spacingSizes is merged with the generated spacingScale sizes
     162         * instead of completely replacing them. The v3 behavior is what was
     163         * documented for the v2 schema, but the code never actually did work
     164         * that way. Instead of surprising users with a behavior change two
     165         * years after the fact at the same time as a v3 update is introduced,
     166         * we'll continue using the "bugged" behavior for v2 themes. And treat
     167         * the "bug fix" as a breaking change for v3.
     168         */
     169        if ( isset( $old['settings']['spacing']['spacingSizes'] ) ) {
     170            unset( $new['settings']['spacing']['spacingScale'] );
     171        }
    83172
    84173        return $new;

  • trunk/src/wp-includes/class-wp-theme-json.php

    r58314 r58328  
    124124     * @since 6.2.0 Added 'shadow' presets.
    125125     * @since 6.3.0 Replaced value_func for duotone with `null`. Custom properties are handled by class-wp-duotone.php.
    126      * @since 6.6.0 Added the `dimensions.aspectRatios` & `dimensions.defaultAspectRatios` preset.
     126     * @since 6.6.0 Added the `dimensions.aspectRatios` and `dimensions.defaultAspectRatios` presets.
     127     *              Updated the 'prevent_override' value for font size presets to use 'typography.defaultFontSizes'
     128     *              and spacing size presets to use `spacing.defaultSpacingSizes`.
    127129     * @var array
    128130     */
    … …  
    170172        array(
    171173            'path'              => array( 'typography', 'fontSizes' ),
    172             'prevent_override'  => false,
     174            'prevent_override'  => array( 'typography', 'defaultFontSizes' ),
    173175            'use_default_names' => true,
    174176            'value_func'        => 'wp_get_typography_font_size_value',
    … …  
    188190        array(
    189191            'path'              => array( 'spacing', 'spacingSizes' ),
    190             'prevent_override'  => false,
     192            'prevent_override'  => array( 'spacing', 'defaultSpacingSizes' ),
    191193            'use_default_names' => true,
    192194            'value_key'         => 'size',
    … …  
    379381     * @since 6.5.0 Added support for `layout.allowCustomContentAndWideSize`,
    380382     *              `background.backgroundSize` and `dimensions.aspectRatio`.
    381      * @since 6.6.0 Added support for `dimensions.aspectRatios` and `dimensions.defaultAspectRatios`.
     383     * @since 6.6.0 Added support for 'dimensions.aspectRatios', 'dimensions.defaultAspectRatios',
     384     *              'typography.defaultFontSizes', and 'spacing.defaultSpacingSizes'.
    382385     * @var array
    383386     */
    … …  
    434437        ),
    435438        'spacing'                       => array(
    436             'customSpacingSize' => null,
    437             'spacingSizes'      => null,
    438             'spacingScale'      => null,
    439             'blockGap'          => null,
    440             'margin'            => null,
    441             'padding'           => null,
    442             'units'             => null,
     439            'customSpacingSize'   => null,
     440            'defaultSpacingSizes' => null,
     441            'spacingSizes'        => null,
     442            'spacingScale'        => null,
     443            'blockGap'            => null,
     444            'margin'              => null,
     445            'padding'             => null,
     446            'units'               => null,
    443447        ),
    444448        'shadow'                        => array(
    … …  
    447451        ),
    448452        'typography'                    => array(
    449             'fluid'          => null,
    450             'customFontSize' => null,
    451             'dropCap'        => null,
    452             'fontFamilies'   => null,
    453             'fontSizes'      => null,
    454             'fontStyle'      => null,
    455             'fontWeight'     => null,
    456             'letterSpacing'  => null,
    457             'lineHeight'     => null,
    458             'textAlign'      => null,
    459             'textColumns'    => null,
    460             'textDecoration' => null,
    461             'textTransform'  => null,
    462             'writingMode'    => null,
     453            'fluid'            => null,
     454            'customFontSize'   => null,
     455            'defaultFontSizes' => null,
     456            'dropCap'          => null,
     457            'fontFamilies'     => null,
     458            'fontSizes'        => null,
     459            'fontStyle'        => null,
     460            'fontWeight'       => null,
     461            'letterSpacing'    => null,
     462            'lineHeight'       => null,
     463            'textAlign'        => null,
     464            'textColumns'      => null,
     465            'textDecoration'   => null,
     466            'textTransform'    => null,
     467            'writingMode'      => null,
    463468        ),
    464469    );
    … …  
    729734     * @since 5.8.0
    730735     * @since 5.9.0 Changed value from 1 to 2.
     736     * @since 6.6.0 Changed value from 2 to 3.
    731737     * @var int
    732738     */
    733     const LATEST_SCHEMA = 2;
     739    const LATEST_SCHEMA = 3;
    734740
    735741    /**
    … …  
    737743     *
    738744     * @since 5.8.0
     745     * @since 6.6.0 Key spacingScale by origin, and Pre-generate the
     746     *              spacingSizes from spacingScale.
    739747     *
    740748     * @param array  $theme_json A structure that follows the theme.json schema.
    … …  
    742750     *                           One of 'default', 'theme', or 'custom'. Default 'theme'.
    743751     */
    744     public function __construct( $theme_json = array(), $origin = 'theme' ) {
     752    public function __construct( $theme_json = array( 'version' => WP_Theme_JSON::LATEST_SCHEMA ), $origin = 'theme' ) {
    745753        if ( ! in_array( $origin, static::VALID_ORIGINS, true ) ) {
    746754            $origin = 'theme';
    … …  
    751759        $valid_element_names = array_keys( static::ELEMENTS );
    752760        $valid_variations    = static::get_valid_block_style_variations();
    753         $theme_json          = static::sanitize( $this->theme_json, $valid_block_names, $valid_element_names, $valid_variations );
    754         $this->theme_json    = static::maybe_opt_in_into_settings( $theme_json );
     761        $this->theme_json    = static::sanitize( $this->theme_json, $valid_block_names, $valid_element_names, $valid_variations );
     762        $this->theme_json    = static::maybe_opt_in_into_settings( $this->theme_json );
    755763
    756764        // Internally, presets are keyed by origin.
    … …  
    770778                }
    771779            }
     780        }
     781
     782        // In addition to presets, spacingScale (which generates presets) is also keyed by origin.
     783        $scale_path    = array( 'settings', 'spacing', 'spacingScale' );
     784        $spacing_scale = _wp_array_get( $this->theme_json, $scale_path, null );
     785        if ( null !== $spacing_scale ) {
     786            // If the spacingScale is not already keyed by origin.
     787            if ( empty( array_intersect( array_keys( $spacing_scale ), static::VALID_ORIGINS ) ) ) {
     788                _wp_array_set( $this->theme_json, $scale_path, array( $origin => $spacing_scale ) );
     789            }
     790        }
     791
     792        // Pre-generate the spacingSizes from spacingScale.
     793        $scale_path    = array( 'settings', 'spacing', 'spacingScale', $origin );
     794        $spacing_scale = _wp_array_get( $this->theme_json, $scale_path, null );
     795        if ( isset( $spacing_scale ) ) {
     796            $sizes_path           = array( 'settings', 'spacing', 'spacingSizes', $origin );
     797            $spacing_sizes        = _wp_array_get( $this->theme_json, $sizes_path, array() );
     798            $spacing_scale_sizes  = static::compute_spacing_sizes( $spacing_scale );
     799            $merged_spacing_sizes = static::merge_spacing_sizes( $spacing_scale_sizes, $spacing_sizes );
     800            _wp_array_set( $this->theme_json, $sizes_path, $merged_spacing_sizes );
    772801        }
    773802    }
    … …  
    29152944        $incoming_data    = $incoming->get_raw_data();
    29162945        $this->theme_json = array_replace_recursive( $this->theme_json, $incoming_data );
     2946
     2947        /*
     2948         * Recompute all the spacing sizes based on the new hierarchy of data. In the constructor
     2949         * spacingScale and spacingSizes are both keyed by origin and VALID_ORIGINS is ordered, so
     2950         * we can allow partial spacingScale data to inherit missing data from earlier layers when
     2951         * computing the spacing sizes.
     2952         *
     2953         * This happens before the presets are merged to ensure that default spacing sizes can be
     2954         * removed from the theme origin if $prevent_override is true.
     2955         */
     2956        $flattened_spacing_scale = array();
     2957        foreach ( static::VALID_ORIGINS as $origin ) {
     2958            $scale_path = array( 'settings', 'spacing', 'spacingScale', $origin );
     2959
     2960            // Apply the base spacing scale to the current layer.
     2961            $base_spacing_scale      = _wp_array_get( $this->theme_json, $scale_path, array() );
     2962            $flattened_spacing_scale = array_replace( $flattened_spacing_scale, $base_spacing_scale );
     2963
     2964            $spacing_scale = _wp_array_get( $incoming_data, $scale_path, null );
     2965            if ( ! isset( $spacing_scale ) ) {
     2966                continue;
     2967            }
     2968
     2969            // Allow partial scale settings by merging with lower layers.
     2970            $flattened_spacing_scale = array_replace( $flattened_spacing_scale, $spacing_scale );
     2971
     2972            // Generate and merge the scales for this layer.
     2973            $sizes_path           = array( 'settings', 'spacing', 'spacingSizes', $origin );
     2974            $spacing_sizes        = _wp_array_get( $incoming_data, $sizes_path, array() );
     2975            $spacing_scale_sizes  = static::compute_spacing_sizes( $flattened_spacing_scale );
     2976            $merged_spacing_sizes = static::merge_spacing_sizes( $spacing_scale_sizes, $spacing_sizes );
     2977
     2978            _wp_array_set( $incoming_data, $sizes_path, $merged_spacing_sizes );
     2979        }
    29172980
    29182981        /*
    … …  
    29523015
    29533016            // Replace the presets.
    2954             foreach ( static::PRESETS_METADATA as $preset ) {
    2955                 $override_preset = ! static::get_metadata_boolean( $this->theme_json['settings'], $preset['prevent_override'], true );
     3017            foreach ( static::PRESETS_METADATA as $preset_metadata ) {
     3018                $prevent_override = $preset_metadata['prevent_override'];
     3019                if ( is_array( $prevent_override ) ) {
     3020                    $prevent_override = _wp_array_get( $this->theme_json['settings'], $preset_metadata['prevent_override'] );
     3021                }
    29563022
    29573023                foreach ( static::VALID_ORIGINS as $origin ) {
    29583024                    $base_path = $node['path'];
    2959                     foreach ( $preset['path'] as $leaf ) {
     3025                    foreach ( $preset_metadata['path'] as $leaf ) {
    29603026                        $base_path[] = $leaf;
    29613027                    }
    … …  
    29693035                    }
    29703036
    2971                     if ( 'theme' === $origin && $preset['use_default_names'] ) {
     3037                    // Set names for theme presets based on the slug if they are not set and can use default names.
     3038                    if ( 'theme' === $origin && $preset_metadata['use_default_names'] ) {
    29723039                        foreach ( $content as $key => $item ) {
    29733040                            if ( ! isset( $item['name'] ) ) {
    … …  
    29803047                    }
    29813048
    2982                     if (
    2983                         ( 'theme' !== $origin ) ||
    2984                         ( 'theme' === $origin && $override_preset )
    2985                     ) {
    2986                         _wp_array_set( $this->theme_json, $path, $content );
    2987                     } else {
    2988                         $slugs_node = static::get_default_slugs( $this->theme_json, $node['path'] );
    2989                         $slugs      = array_merge_recursive( $slugs_global, $slugs_node );
    2990 
    2991                         $slugs_for_preset = _wp_array_get( $slugs, $preset['path'], array() );
    2992                         $content          = static::filter_slugs( $content, $slugs_for_preset );
    2993                         _wp_array_set( $this->theme_json, $path, $content );
     3049                    // Filter out default slugs from theme presets when defaults should not be overridden.
     3050                    if ( 'theme' === $origin && $prevent_override ) {
     3051                        $slugs_node    = static::get_default_slugs( $this->theme_json, $node['path'] );
     3052                        $preset_global = _wp_array_get( $slugs_global, $preset_metadata['path'], array() );
     3053                        $preset_node   = _wp_array_get( $slugs_node, $preset_metadata['path'], array() );
     3054                        $preset_slugs  = array_merge_recursive( $preset_global, $preset_node );
     3055
     3056                        $content = static::filter_slugs( $content, $preset_slugs );
    29943057                    }
     3058
     3059                    _wp_array_set( $this->theme_json, $path, $content );
    29953060                }
    29963061            }
    … …  
    35293594            }
    35303595            $theme_settings['settings']['spacing']['padding'] = $settings['enableCustomSpacing'];
     3596        }
     3597
     3598        if ( isset( $settings['spacingSizes'] ) ) {
     3599            if ( ! isset( $theme_settings['settings']['spacing'] ) ) {
     3600                $theme_settings['settings']['spacing'] = array();
     3601            }
     3602            $theme_settings['settings']['spacing']['spacingSizes'] = $settings['spacingSizes'];
    35313603        }
    35323604
    … …  
    37043776     *
    37053777     * @since 6.1.0
     3778     * @deprecated 6.6.0
     3779     *
     3780     * @param string $origin Optional. What source of data to set the spacing sizes for.
     3781     *                       One of 'default', 'theme', or 'custom'. Default 'default'.
    37063782     *
    37073783     * @return null|void
    37083784     */
    37093785    public function set_spacing_sizes() {
     3786        _deprecated_function( __METHOD__, '6.6.0' );
     3787
    37103788        $spacing_scale = isset( $this->theme_json['settings']['spacing']['spacingScale'] )
    37113789            ? $this->theme_json['settings']['spacing']['spacingScale']
    … …  
    37413819        }
    37423820
     3821        $spacing_sizes = static::compute_spacing_sizes( $spacing_scale );
     3822
     3823        // If there are 7 or fewer steps in the scale revert to numbers for labels instead of t-shirt sizes.
     3824        if ( $spacing_scale['steps'] <= 7 ) {
     3825            for ( $spacing_sizes_count = 0; $spacing_sizes_count < count( $spacing_sizes ); $spacing_sizes_count++ ) {
     3826                $spacing_sizes[ $spacing_sizes_count ]['name'] = (string) ( $spacing_sizes_count + 1 );
     3827            }
     3828        }
     3829
     3830        _wp_array_set( $this->theme_json, array( 'settings', 'spacing', 'spacingSizes', 'default' ), $spacing_sizes );
     3831    }
     3832
     3833    /**
     3834     * Merges two sets of spacing size presets.
     3835     *
     3836     * @since 6.6.0
     3837     *
     3838     * @param array $base     The base set of spacing sizes.
     3839     * @param array $incoming The set of spacing sizes to merge with the base. Duplicate slugs will override the base values.
     3840     * @return array The merged set of spacing sizes.
     3841     */
     3842    private static function merge_spacing_sizes( $base, $incoming ) {
     3843        // Preserve the order if there are no base (spacingScale) values.
     3844        if ( empty( $base ) ) {
     3845            return $incoming;
     3846        }
     3847        $merged = array();
     3848        foreach ( $base as $item ) {
     3849            $merged[ $item['slug'] ] = $item;
     3850        }
     3851        foreach ( $incoming as $item ) {
     3852            $merged[ $item['slug'] ] = $item;
     3853        }
     3854        ksort( $merged, SORT_NUMERIC );
     3855        return array_values( $merged );
     3856    }
     3857
     3858    /**
     3859     * Generates a set of spacing sizes by starting with a medium size and
     3860     * applying an operator with an increment value to generate the rest of the
     3861     * sizes outward from the medium size. The medium slug is '50' with the rest
     3862     * of the slugs being 10 apart. The generated names use t-shirt sizing.
     3863     *
     3864     * Example:
     3865     *
     3866     *     $spacing_scale = array(
     3867     *         'steps'      => 4,
     3868     *         'mediumStep' => 16,
     3869     *         'unit'       => 'px',
     3870     *         'operator'   => '+',
     3871     *         'increment'  => 2,
     3872     *     );
     3873     *     $spacing_sizes = static::compute_spacing_sizes( $spacing_scale );
     3874     *     // -> array(
     3875     *     //        array( 'name' => 'Small',   'slug' => '40', 'size' => '14px' ),
     3876     *     //        array( 'name' => 'Medium',  'slug' => '50', 'size' => '16px' ),
     3877     *     //        array( 'name' => 'Large',   'slug' => '60', 'size' => '18px' ),
     3878     *     //        array( 'name' => 'X-Large', 'slug' => '70', 'size' => '20px' ),
     3879     *     //    )
     3880     *
     3881     * @since 6.6.0
     3882     *
     3883     * @param array $spacing_scale {
     3884     *      The spacing scale values. All are required.
     3885     *
     3886     *      @type int    $steps      The number of steps in the scale. (up to 10 steps are supported.)
     3887     *      @type float  $mediumStep The middle value that gets the slug '50'. (For even number of steps, this becomes the first middle value.)
     3888     *      @type string $unit       The CSS unit to use for the sizes.
     3889     *      @type string $operator   The mathematical operator to apply to generate the other sizes. Either '+' or '*'.
     3890     *      @type float  $increment  The value used with the operator to generate the other sizes.
     3891     * }
     3892     * @return array The spacing sizes presets or an empty array if some spacing scale values are missing or invalid.
     3893     */
     3894    private static function compute_spacing_sizes( $spacing_scale ) {
     3895        /*
     3896         * This condition is intentionally missing some checks on ranges for the values in order to
     3897         * keep backwards compatibility with the previous implementation.
     3898         */
     3899        if (
     3900            ! isset( $spacing_scale['steps'] ) ||
     3901            ! is_numeric( $spacing_scale['steps'] ) ||
     3902            0 === $spacing_scale['steps'] ||
     3903            ! isset( $spacing_scale['mediumStep'] ) ||
     3904            ! is_numeric( $spacing_scale['mediumStep'] ) ||
     3905            ! isset( $spacing_scale['unit'] ) ||
     3906            ! isset( $spacing_scale['operator'] ) ||
     3907            ( '+' !== $spacing_scale['operator'] && '*' !== $spacing_scale['operator'] ) ||
     3908            ! isset( $spacing_scale['increment'] ) ||
     3909            ! is_numeric( $spacing_scale['increment'] )
     3910        ) {
     3911            return array();
     3912        }
     3913
    37433914        $unit            = '%' === $spacing_scale['unit'] ? '%' : sanitize_title( $spacing_scale['unit'] );
    37443915        $current_step    = $spacing_scale['mediumStep'];
    … …  
    38233994        }
    38243995
    3825         // If there are 7 or fewer steps in the scale revert to numbers for labels instead of t-shirt sizes.
    3826         if ( $spacing_scale['steps'] <= 7 ) {
    3827             for ( $spacing_sizes_count = 0; $spacing_sizes_count < count( $spacing_sizes ); $spacing_sizes_count++ ) {
    3828                 $spacing_sizes[ $spacing_sizes_count ]['name'] = (string) ( $spacing_sizes_count + 1 );
    3829             }
    3830         }
    3831 
    3832         _wp_array_set( $this->theme_json, array( 'settings', 'spacing', 'spacingSizes', 'default' ), $spacing_sizes );
     3996        return $spacing_sizes;
    38333997    }
    38343998

  • trunk/src/wp-includes/rest-api/endpoints/class-wp-rest-font-faces-controller.php

    r57868 r58328  
    1919     * @var int
    2020     */
    21     const LATEST_THEME_JSON_VERSION_SUPPORTED = 2;
     21    const LATEST_THEME_JSON_VERSION_SUPPORTED = 3;
    2222
    2323    /**

  • trunk/src/wp-includes/rest-api/endpoints/class-wp-rest-font-families-controller.php

    r57548 r58328  
    2121     * @var int
    2222     */
    23     const LATEST_THEME_JSON_VERSION_SUPPORTED = 2;
     23    const LATEST_THEME_JSON_VERSION_SUPPORTED = 3;
    2424
    2525    /**

  • trunk/src/wp-includes/theme.json

    r58314 r58328  
    11{
    22    "$schema": "https://schemas.wp.org/trunk/theme.json",
    3     "version": 2,
     3    "version": 3,
    44    "settings": {
    55        "appearanceTools": false,
    … …  
    266266            "padding": false,
    267267            "customSpacingSize": true,
     268            "defaultSpacingSizes": true,
    268269            "units": [ "px", "em", "rem", "vh", "vw", "%" ],
    269270            "spacingScale": {
    … …  
    277278        "typography": {
    278279            "customFontSize": true,
     280            "defaultFontSizes": true,
    279281            "dropCap": true,
    280282            "fontSizes": [

  • trunk/src/wp-includes/theme.php

    r58213 r58328  
    26432643 * @since 6.5.0 The `appearance-tools` feature enables a few design tools for blocks,
    26442644 *              see `WP_Theme_JSON::APPEARANCE_TOOLS_OPT_INS` for a complete list.
     2645 * @since 6.6.0 The `editor-spacing-sizes` feature was added.
    26452646 *
    26462647 * @global array $_wp_theme_features
    … …  
    26702671 *                          - 'editor-gradient-presets'
    26712672 *                          - 'editor-font-sizes'
     2673 *                          - 'editor-spacing-sizes'
    26722674 *                          - 'editor-styles'
    26732675 *                          - 'featured-content'
    … …  
    42284230    );
    42294231    register_theme_feature(
     4232        'editor-spacing-sizes',
     4233        array(
     4234            'type'         => 'array',
     4235            'description'  => __( 'Custom spacing sizes if defined by the theme.' ),
     4236            'show_in_rest' => array(
     4237                'schema' => array(
     4238                    'items' => array(
     4239                        'type'       => 'object',
     4240                        'properties' => array(
     4241                            'name' => array(
     4242                                'type' => 'string',
     4243                            ),
     4244                            'size' => array(
     4245                                'type' => 'string',
     4246                            ),
     4247                            'slug' => array(
     4248                                'type' => 'string',
     4249                            ),
     4250                        ),
     4251                    ),
     4252                ),
     4253            ),
     4254        )
     4255    );
     4256    register_theme_feature(
    42304257        'editor-styles',
    42314258        array(

  • trunk/tests/phpunit/data/themedir1/block-theme-child-with-fluid-layout/theme.json

    r57336 r58328  
    11{
    22    "$schema": "https://schemas.wp.org/trunk/theme.json",
    3     "version": 2,
     3    "version": 3,
    44    "settings": {
    55        "appearanceTools": true,

  • trunk/tests/phpunit/data/themedir1/block-theme-child-with-fluid-typography-config/theme.json

    r57336 r58328  
    11{
    22    "$schema": "https://schemas.wp.org/trunk/theme.json",
    3     "version": 2,
     3    "version": 3,
    44    "settings": {
    55        "appearanceTools": true,

  • trunk/tests/phpunit/data/themedir1/block-theme-child-with-fluid-typography/theme.json

    r57336 r58328  
    11{
    22    "$schema": "https://schemas.wp.org/trunk/theme.json",
    3     "version": 2,
     3    "version": 3,
    44    "settings": {
    55        "appearanceTools": true,

  • trunk/tests/phpunit/data/themedir1/block-theme-child/styles/variation-a.json

    r57662 r58328  
    11{
    2     "version": 2,
     2    "version": 3,
    33    "settings": {
    44        "blocks": {

  • trunk/tests/phpunit/data/themedir1/block-theme-child/styles/variation-b.json

    r55231 r58328  
    11{
    2     "version": 2,
     2    "version": 3,
    33    "settings": {
    44        "blocks": {

  • trunk/tests/phpunit/data/themedir1/block-theme-child/theme.json

    r57662 r58328  
    11{
    22    "$schema": "https://schemas.wp.org/trunk/theme.json",
    3     "version": 2,
     3    "version": 3,
    44    "settings": {
    55        "color": {

  • trunk/tests/phpunit/data/themedir1/block-theme-deprecated-path/styles/variation.json

    r53416 r58328  
    11{
    2     "version": 2,
    3     "settings": {
    4         "color": {
    5             "palette": [
    6                 {
    7                     "slug": "foreground",
    8                     "color": "#3F67C6",
    9                     "name": "Foreground"
    10                 }
    11             ]
    12         }
    13     },
    14     "styles": {
    15         "blocks": {
    16             "core/post-title": {
    17                 "typography": {
    18                     "fontWeight": "700"
    19                 }
    20             }
    21         }
    22     }
     2    "version": 3,
     3    "settings": {
     4        "color": {
     5            "palette": [
     6                {
     7                    "slug": "foreground",
     8                    "color": "#3F67C6",
     9                    "name": "Foreground"
     10                }
     11            ]
     12        }
     13    },
     14    "styles": {
     15        "blocks": {
     16            "core/post-title": {
     17                "typography": {
     18                    "fontWeight": "700"
     19                }
     20            }
     21        }
     22    }
    2323}

  • trunk/tests/phpunit/data/themedir1/block-theme-with-hooked-blocks/theme.json

    r56759 r58328  
    11{
    22    "$schema": "https://schemas.wp.org/trunk/theme.json",
    3     "version": 2,
     3    "version": 3,
    44    "templateParts": [
    55        {

  • trunk/tests/phpunit/data/themedir1/block-theme/styles/variation-a.json

    r57662 r58328  
    11{
    2     "version": 2,
     2    "version": 3,
    33    "settings": {
    44        "blocks": {

  • trunk/tests/phpunit/data/themedir1/block-theme/styles/variation-b.json

    r58262 r58328  
    11{
    2     "version": 2,
     2    "version": 3,
    33    "settings": {
    44        "blocks": {

  • trunk/tests/phpunit/data/themedir1/block-theme/styles/variation.json

    r54036 r58328  
    11{
    2     "version": 2,
     2    "version": 3,
    33    "title": "Block theme variation",
    44    "settings": {

  • trunk/tests/phpunit/data/themedir1/block-theme/theme.json

    r57885 r58328  
    11{
    22    "$schema": "https://schemas.wp.org/trunk/theme.json",
    3     "version": 2,
     3    "version": 3,
    44    "title": "Block theme",
    55    "settings": {

  • trunk/tests/phpunit/data/themedir1/empty-fontface-theme/theme.json

    r57336 r58328  
    11{
    22    "$schema": "https://schemas.wp.org/trunk/theme.json",
    3   "version": 2,
    4   "customTemplates": [
    5     {
    6       "name": "blank",
    7       "title": "Blank",
    8       "postTypes": [
    9         "page",
    10         "post"
    11       ]
    12     }
    13   ],
    14   "settings": {
    15     "appearanceTools": true,
    16     "color": {
    17       "duotone": [],
    18       "gradients": [],
    19       "palette": []
     3    "version": 3,
     4    "customTemplates": [
     5        {
     6            "name": "blank",
     7            "title": "Blank",
     8            "postTypes": [ "page", "post" ]
     9        }
     10    ],
     11    "settings": {
     12        "appearanceTools": true,
     13        "color": {
     14            "duotone": [],
     15            "gradients": [],
     16            "palette": []
     17        },
     18        "custom": {},
     19        "spacing": {
     20            "units": [ "%", "px", "em", "rem", "vh", "vw" ]
     21        },
     22        "typography": {
     23            "dropCap": false,
     24            "fontFamilies": [
     25                {
     26                    "fontFamily": "Roboto",
     27                    "name": "Roboto",
     28                    "slug": "roboto",
     29                    "fontFace": []
     30                }
     31            ],
     32            "fontSizes": [
     33                {
     34                    "size": "1rem",
     35                    "slug": "small"
     36                },
     37                {
     38                    "size": "1.125rem",
     39                    "slug": "medium"
     40                },
     41                {
     42                    "size": "1.75rem",
     43                    "slug": "large"
     44                },
     45                {
     46                    "size": "clamp(1.75rem, 3vw, 2.25rem)",
     47                    "slug": "x-large"
     48                }
     49            ]
     50        },
     51        "layout": {
     52            "contentSize": "650px",
     53            "wideSize": "1000px"
     54        }
    2055    },
    21     "custom": {},
    22     "spacing": {
    23       "units": [
    24         "%",
    25         "px",
    26         "em",
    27         "rem",
    28         "vh",
    29         "vw"
    30       ]
     56    "styles": {
     57        "blocks": {},
     58        "color": {
     59            "background": "var(--wp--preset--color--background)",
     60            "text": "var(--wp--preset--color--foreground)"
     61        },
     62        "elements": {},
     63        "spacing": {
     64            "blockGap": "1.5rem"
     65        },
     66        "typography": {
     67            "fontFamily": "var(--wp--preset--font-family--system-font)",
     68            "lineHeight": "var(--wp--custom--typography--line-height--normal)",
     69            "fontSize": "var(--wp--preset--font-size--medium)"
     70        }
    3171    },
    32     "typography": {
    33       "dropCap": false,
    34       "fontFamilies": [
     72    "templateParts": [
    3573        {
    36           "fontFamily": "Roboto",
    37           "name": "Roboto",
    38           "slug": "roboto",
    39           "fontFace": []
     74            "name": "header",
     75            "title": "Header",
     76            "area": "header"
    4077        }
    41       ],
    42       "fontSizes": [
    43         {
    44           "size": "1rem",
    45           "slug": "small"
    46         },
    47         {
    48           "size": "1.125rem",
    49           "slug": "medium"
    50         },
    51         {
    52           "size": "1.75rem",
    53           "slug": "large"
    54         },
    55         {
    56           "size": "clamp(1.75rem, 3vw, 2.25rem)",
    57           "slug": "x-large"
    58         }
    59       ]
    60     },
    61     "layout": {
    62       "contentSize": "650px",
    63       "wideSize": "1000px"
    64     }
    65   },
    66   "styles": {
    67     "blocks": {},
    68     "color": {
    69       "background": "var(--wp--preset--color--background)",
    70       "text": "var(--wp--preset--color--foreground)"
    71     },
    72     "elements": {},
    73     "spacing": {
    74       "blockGap": "1.5rem"
    75     },
    76     "typography": {
    77       "fontFamily": "var(--wp--preset--font-family--system-font)",
    78       "lineHeight": "var(--wp--custom--typography--line-height--normal)",
    79       "fontSize": "var(--wp--preset--font-size--medium)"
    80     }
    81   },
    82   "templateParts": [
    83     {
    84       "name": "header",
    85       "title": "Header",
    86       "area": "header"
    87     }
    88   ]
     78    ]
    8979}

  • trunk/tests/phpunit/data/themedir1/fonts-block-theme/styles/variation-duplicate-fonts.json

    r56500 r58328  
    11{
    2     "version": 2,
     2    "version": 3,
    33    "title": "Variation: duplicate fonts",
    44    "settings": {

  • trunk/tests/phpunit/data/themedir1/fonts-block-theme/styles/variation-new-font-family.json

    r57788 r58328  
    11{
    2     "version": 2,
     2    "version": 3,
    33    "title": "Variation: new font family",
    44    "settings": {

  • trunk/tests/phpunit/data/themedir1/fonts-block-theme/styles/variation-new-font-variations.json

    r56500 r58328  
    11{
    2     "version": 2,
     2    "version": 3,
    33    "title": "Variation: new font variations",
    44    "settings": {

  • trunk/tests/phpunit/data/themedir1/fonts-block-theme/styles/variation-no-fonts.json

    r56500 r58328  
    11{
    2     "version": 2,
     2    "version": 3,
    33    "title": "Variation - no fonts",
    44    "styles": {

  • trunk/tests/phpunit/data/themedir1/fonts-block-theme/theme.json

    r57336 r58328  
    11{
    22    "$schema": "https://schemas.wp.org/trunk/theme.json",
    3     "version": 2,
     3    "version": 3,
    44    "settings": {
    55        "appearanceTools": true,

  • trunk/tests/phpunit/tests/fonts/font-library/wpRestFontFacesController.php

    r57548 r58328  
    624624        return array(
    625625            array( 1 ),
    626             array( 3 ),
     626            array( 4 ),
    627627        );
    628628    }

  • trunk/tests/phpunit/tests/fonts/font-library/wpRestFontFamiliesController.php

    r57987 r58328  
    432432        return array(
    433433            array( 1 ),
    434             array( 3 ),
     434            array( 4 ),
    435435        );
    436436    }

  • trunk/tests/phpunit/tests/rest-api/rest-global-styles-controller.php

    r58262 r58328  
    151151        $expected = array(
    152152            array(
    153                 'version'  => 2,
     153                'version'  => WP_Theme_JSON::LATEST_SCHEMA,
    154154                'settings' => array(
    155155                    'blocks' => array(
    … …  
    172172            ),
    173173            array(
    174                 'version'  => 2,
     174                'version'  => WP_Theme_JSON::LATEST_SCHEMA,
    175175                'settings' => array(
    176176                    'blocks' => array(
    … …  
    217217            ),
    218218            array(
    219                 'version'  => 2,
     219                'version'  => WP_Theme_JSON::LATEST_SCHEMA,
    220220                'title'    => 'Block theme variation',
    221221                'settings' => array(

  • trunk/tests/phpunit/tests/rest-api/rest-themes-controller.php

    r58282 r58328  
    420420        $this->assertArrayHasKey( 'editor-font-sizes', $theme_supports );
    421421        $this->assertArrayHasKey( 'editor-gradient-presets', $theme_supports );
     422        $this->assertArrayHasKey( 'editor-spacing-sizes', $theme_supports );
    422423        $this->assertArrayHasKey( 'editor-styles', $theme_supports );
    423424        $this->assertArrayHasKey( 'formats', $theme_supports );
    … …  
    427428        $this->assertArrayHasKey( 'title-tag', $theme_supports );
    428429        $this->assertArrayHasKey( 'wp-block-styles', $theme_supports );
    429         $this->assertCount( 23, $theme_supports, 'There should be 23 theme supports' );
     430        $this->assertCount( 24, $theme_supports, 'There should be 23 theme supports' );
    430431    }
    431432

  • trunk/tests/phpunit/tests/theme/wpThemeJson.php

    r58314 r58328  
    33013301        $theme = new WP_Theme_JSON(
    33023302            array(
    3303                 'version'  => 2,
     3303                'version'  => WP_Theme_JSON::LATEST_SCHEMA,
    33043304                'settings' => array(
    33053305                    'color' => array(
    … …  
    33223322        $user  = new WP_Theme_JSON(
    33233323            array(
    3324                 'version'  => 2,
     3324                'version'  => WP_Theme_JSON::LATEST_SCHEMA,
    33253325                'settings' => array(
    33263326                    'color' => array(
    … …  
    33463346        $actual   = $theme->get_data();
    33473347        $expected = array(
    3348             'version'  => 2,
     3348            'version'  => WP_Theme_JSON::LATEST_SCHEMA,
    33493349            'settings' => array(
    33503350                'color' => array(
    … …  
    33793379        $theme = new WP_Theme_JSON(
    33803380            array(
    3381                 'version'  => 2,
     3381                'version'  => WP_Theme_JSON::LATEST_SCHEMA,
    33823382                'settings' => array(
    33833383                    'color' => array(
    … …  
    34013401        $actual   = $theme->get_data();
    34023402        $expected = array(
    3403             'version'  => 2,
     3403            'version'  => WP_Theme_JSON::LATEST_SCHEMA,
    34043404            'settings' => array(
    34053405                'color' => array(
    … …  
    34293429        $user = new WP_Theme_JSON(
    34303430            array(
    3431                 'version'  => 2,
     3431                'version'  => WP_Theme_JSON::LATEST_SCHEMA,
    34323432                'settings' => array(
    34333433                    'color' => array(
    … …  
    34523452        $actual   = $user->get_data();
    34533453        $expected = array(
    3454             'version'  => 2,
     3454            'version'  => WP_Theme_JSON::LATEST_SCHEMA,
    34553455            'settings' => array(
    34563456                'color' => array(
    … …  
    34783478     */
    34793479    public function test_export_data_deals_with_empty_data() {
    3480         $theme_v2    = new WP_Theme_JSON(
    3481             array(
    3482                 'version' => 2,
     3480        $theme    = new WP_Theme_JSON(
     3481            array(
     3482                'version' => WP_Theme_JSON::LATEST_SCHEMA,
    34833483            ),
    34843484            'theme'
    34853485        );
    3486         $actual_v2   = $theme_v2->get_data();
    3487         $expected_v2 = array( 'version' => 2 );
    3488         $this->assertEqualSetsWithIndex( $expected_v2, $actual_v2 );
    3489 
    3490         $theme_v1    = new WP_Theme_JSON(
    3491             array(
    3492                 'version' => 1,
    3493             ),
    3494             'theme'
    3495         );
    3496         $actual_v1   = $theme_v1->get_data();
    3497         $expected_v1 = array( 'version' => 2 );
    3498         $this->assertEqualSetsWithIndex( $expected_v1, $actual_v1 );
     3486        $actual   = $theme->get_data();
     3487        $expected = array( 'version' => WP_Theme_JSON::LATEST_SCHEMA );
     3488        $this->assertEqualSetsWithIndex( $expected, $actual );
    34993489    }
    35003490
    … …  
    35053495        $theme = new WP_Theme_JSON(
    35063496            array(
    3507                 'version'  => 2,
     3497                'version'  => WP_Theme_JSON::LATEST_SCHEMA,
    35083498                'settings' => array(
    35093499                    'appearanceTools' => true,
    … …  
    35193509        $actual   = $theme->get_data();
    35203510        $expected = array(
    3521             'version'  => 2,
     3511            'version'  => WP_Theme_JSON::LATEST_SCHEMA,
    35223512            'settings' => array(
    35233513                'appearanceTools' => true,
    … …  
    35393529        $theme = new WP_Theme_JSON(
    35403530            array(
    3541                 'version'  => 2,
     3531                'version'  => WP_Theme_JSON::LATEST_SCHEMA,
    35423532                'settings' => array(
    35433533                    'useRootPaddingAwareAlignments' => true,
    … …  
    35533543        $actual   = $theme->get_data();
    35543544        $expected = array(
    3555             'version'  => 2,
     3545            'version'  => WP_Theme_JSON::LATEST_SCHEMA,
    35563546            'settings' => array(
    35573547                'useRootPaddingAwareAlignments' => true,
    … …  
    36453635        $theme_json = new WP_Theme_JSON(
    36463636            array(
    3647                 'version' => 2,
     3637                'version' => WP_Theme_JSON::LATEST_SCHEMA,
    36483638                'styles'  => array(
    36493639                    'color'    => array(
    … …  
    37303720        $theme_json = new WP_Theme_JSON(
    37313721            array(
    3732                 'version' => 2,
     3722                'version' => WP_Theme_JSON::LATEST_SCHEMA,
    37333723                'styles'  => array(
    37343724                    'color'    => array(
    … …  
    37683758        $theme_json = new WP_Theme_JSON(
    37693759            array(
    3770                 'version' => 2,
     3760                'version' => WP_Theme_JSON::LATEST_SCHEMA,
    37713761                'styles'  => array(
    37723762                    'color'    => array(
    … …  
    38053795        $theme_json = new WP_Theme_JSON(
    38063796            array(
    3807                 'version' => 2,
     3797                'version' => WP_Theme_JSON::LATEST_SCHEMA,
    38083798                'styles'  => array(
    38093799                    'color' => array(
    … …  
    38313821        $theme_json = new WP_Theme_JSON(
    38323822            array(
    3833                 'version'  => 2,
     3823                'version'  => WP_Theme_JSON::LATEST_SCHEMA,
    38343824                'styles'   => array(
    38353825                    'spacing' => array(
    … …  
    38683858        $theme_json = new WP_Theme_JSON(
    38693859            array(
    3870                 'version' => 2,
     3860                'version' => WP_Theme_JSON::LATEST_SCHEMA,
    38713861                'styles'  => array(
    38723862                    'spacing' => array(
    … …  
    39013891        $theme_json = new WP_Theme_JSON(
    39023892            array(
    3903                 'version'  => 2,
     3893                'version'  => WP_Theme_JSON::LATEST_SCHEMA,
    39043894                'settings' => array(
    39053895                    'layout' => array(
    … …  
    39323922        $theme_json = new WP_Theme_JSON(
    39333923            array(
    3934                 'version'  => 2,
     3924                'version'  => WP_Theme_JSON::LATEST_SCHEMA,
    39353925                'settings' => array(
    39363926                    'appearanceTools' => true,
    … …  
    39553945        $theme_json = new WP_Theme_JSON(
    39563946            array(
    3957                 'version' => 2,
     3947                'version' => WP_Theme_JSON::LATEST_SCHEMA,
    39583948                'styles'  => array(
    39593949                    'spacing' => array(
    … …  
    39743964        $actual   = $theme_json->get_raw_data();
    39753965        $expected = array(
    3976             'version' => 2,
     3966            'version' => WP_Theme_JSON::LATEST_SCHEMA,
    39773967            'styles'  => array(
    39783968                'spacing' => array(
    … …  
    39983988        $theme_json = new WP_Theme_JSON(
    39993989            array(
    4000                 'version' => 2,
     3990                'version' => WP_Theme_JSON::LATEST_SCHEMA,
    40013991                'styles'  => array(
    40023992                    'blocks' => array(
    … …  
    40224012        $sanitized_theme_json = $theme_json->get_raw_data();
    40234013        $expected             = array(
    4024             'version' => 2,
     4014            'version' => WP_Theme_JSON::LATEST_SCHEMA,
    40254015            'styles'  => array(
    40264016                'blocks' => array(
    … …  
    40514041        $theme_json = new WP_Theme_JSON(
    40524042            array(
    4053                 'version' => 2,
     4043                'version' => WP_Theme_JSON::LATEST_SCHEMA,
    40544044                'styles'  => array(
    40554045                    'blocks' => array(
    … …  
    41354125        $theme_json = new WP_Theme_JSON(
    41364126            array(
    4137                 'version'  => '2',
     4127                'version'  => WP_Theme_JSON::LATEST_SCHEMA,
    41384128                'badKey2'  => 'I am Evil!',
    41394129                'settings' => array(
    … …  
    42034193
    42044194        $expected_sanitized   = array(
    4205             'version'  => '2',
     4195            'version'  => WP_Theme_JSON::LATEST_SCHEMA,
    42064196            'settings' => array(
    42074197                'typography' => array(
    … …  
    42724262        $theme_json = new WP_Theme_JSON(
    42734263            array(
    4274                 'version' => 2,
     4264                'version' => WP_Theme_JSON::LATEST_SCHEMA,
    42754265                'styles'  => array(
    42764266                    'blocks' => array(
    … …  
    43204310        $theme_json = new WP_Theme_JSON(
    43214311            array(
    4322                 'version' => 2,
     4312                'version' => WP_Theme_JSON::LATEST_SCHEMA,
    43234313                'styles'  => array(
    43244314                    'blocks' => array(
    … …  
    44744464        $theme_json = new WP_Theme_JSON(
    44754465            array(
    4476                 'version'  => 2,
     4466                'version'  => WP_Theme_JSON::LATEST_SCHEMA,
    44774467                'settings' => array(
    44784468                    'spacing' => array(
    … …  
    44804470                    ),
    44814471                ),
    4482             )
    4483         );
    4484 
    4485         $theme_json->set_spacing_sizes();
     4472            ),
     4473            'default'
     4474        );
     4475
    44864476        $this->assertSame( $expected_output, _wp_array_get( $theme_json->get_raw_data(), array( 'settings', 'spacing', 'spacingSizes', 'default' ) ) );
    44874477    }
    … …  
    45064496                'expected_output' => array(
    45074497                    array(
    4508                         'name' => '1',
     4498                        'name' => 'Medium',
    45094499                        'slug' => '50',
    45104500                        'size' => '4rem',
    … …  
    45224512                'expected_output' => array(
    45234513                    array(
    4524                         'name' => '1',
     4514                        'name' => 'Medium',
    45254515                        'slug' => '50',
    45264516                        'size' => '4rem',
    45274517                    ),
    45284518                    array(
    4529                         'name' => '2',
     4519                        'name' => 'Large',
    45304520                        'slug' => '60',
    45314521                        'size' => '5.5rem',
    … …  
    45434533                'expected_output' => array(
    45444534                    array(
    4545                         'name' => '1',
     4535                        'name' => 'Small',
    45464536                        'slug' => '40',
    45474537                        'size' => '2.5rem',
    45484538                    ),
    45494539                    array(
    4550                         'name' => '2',
     4540                        'name' => 'Medium',
    45514541                        'slug' => '50',
    45524542                        'size' => '4rem',
    45534543                    ),
    45544544                    array(
    4555                         'name' => '3',
     4545                        'name' => 'Large',
    45564546                        'slug' => '60',
    45574547                        'size' => '5.5rem',
    … …  
    45694559                'expected_output' => array(
    45704560                    array(
    4571                         'name' => '1',
     4561                        'name' => 'Small',
    45724562                        'slug' => '40',
    45734563                        'size' => '2.5rem',
    45744564                    ),
    45754565                    array(
    4576                         'name' => '2',
     4566                        'name' => 'Medium',
    45774567                        'slug' => '50',
    45784568                        'size' => '4rem',
    45794569                    ),
    45804570                    array(
    4581                         'name' => '3',
     4571                        'name' => 'Large',
    45824572                        'slug' => '60',
    45834573                        'size' => '5.5rem',
    45844574                    ),
    45854575                    array(
    4586                         'name' => '4',
     4576                        'name' => 'X-Large',
    45874577                        'slug' => '70',
    45884578                        'size' => '7rem',
    … …  
    46004590                'expected_output' => array(
    46014591                    array(
    4602                         'name' => '1',
     4592                        'name' => 'Small',
    46034593                        'slug' => '40',
    46044594                        'size' => '2.5rem',
    46054595                    ),
    46064596                    array(
    4607                         'name' => '2',
     4597                        'name' => 'Medium',
    46084598                        'slug' => '50',
    46094599                        'size' => '5rem',
    46104600                    ),
    46114601                    array(
    4612                         'name' => '3',
     4602                        'name' => 'Large',
    46134603                        'slug' => '60',
    46144604                        'size' => '7.5rem',
    46154605                    ),
    46164606                    array(
    4617                         'name' => '4',
     4607                        'name' => 'X-Large',
    46184608                        'slug' => '70',
    46194609                        'size' => '10rem',
    46204610                    ),
    46214611                    array(
    4622                         'name' => '5',
     4612                        'name' => '2X-Large',
    46234613                        'slug' => '80',
    46244614                        'size' => '12.5rem',
    … …  
    46364626                'expected_output' => array(
    46374627                    array(
    4638                         'name' => '1',
     4628                        'name' => 'X-Small',
    46394629                        'slug' => '30',
    46404630                        'size' => '0.67rem',
    46414631                    ),
    46424632                    array(
    4643                         'name' => '2',
     4633                        'name' => 'Small',
    46444634                        'slug' => '40',
    46454635                        'size' => '1rem',
    46464636                    ),
    46474637                    array(
    4648                         'name' => '3',
     4638                        'name' => 'Medium',
    46494639                        'slug' => '50',
    46504640                        'size' => '1.5rem',
    46514641                    ),
    46524642                    array(
    4653                         'name' => '4',
     4643                        'name' => 'Large',
    46544644                        'slug' => '60',
    46554645                        'size' => '2.25rem',
    46564646                    ),
    46574647                    array(
    4658                         'name' => '5',
     4648                        'name' => 'X-Large',
    46594649                        'slug' => '70',
    46604650                        'size' => '3.38rem',
    … …  
    46724662                'expected_output' => array(
    46734663                    array(
    4674                         'name' => '1',
     4664                        'name' => 'X-Small',
    46754665                        'slug' => '30',
    46764666                        'size' => '0.09rem',
    46774667                    ),
    46784668                    array(
    4679                         'name' => '2',
     4669                        'name' => 'Small',
    46804670                        'slug' => '40',
    46814671                        'size' => '0.38rem',
    46824672                    ),
    46834673                    array(
    4684                         'name' => '3',
     4674                        'name' => 'Medium',
    46854675                        'slug' => '50',
    46864676                        'size' => '1.5rem',
    46874677                    ),
    46884678                    array(
    4689                         'name' => '4',
     4679                        'name' => 'Large',
    46904680                        'slug' => '60',
    46914681                        'size' => '6rem',
    46924682                    ),
    46934683                    array(
    4694                         'name' => '5',
     4684                        'name' => 'X-Large',
    46954685                        'slug' => '70',
    46964686                        'size' => '24rem',
    … …  
    47634753     */
    47644754    public function test_set_spacing_sizes_when_invalid( $spacing_scale, $expected_output ) {
    4765         $this->expectException( Exception::class );
    4766         $this->expectExceptionMessage( 'Some of the theme.json settings.spacing.spacingScale values are invalid' );
    4767 
    47684755        $theme_json = new WP_Theme_JSON(
    47694756            array(
    4770                 'version'  => 2,
     4757                'version'  => WP_Theme_JSON::LATEST_SCHEMA,
    47714758                'settings' => array(
    47724759                    'spacing' => array(
    … …  
    47744761                    ),
    47754762                ),
    4776             )
    4777         );
    4778 
    4779         // Ensure PHPUnit 10 compatibility.
    4780         set_error_handler(
    4781             static function ( $errno, $errstr ) {
    4782                 restore_error_handler();
    4783                 throw new Exception( $errstr, $errno );
    4784             },
    4785             E_ALL
    4786         );
    4787 
    4788         $theme_json->set_spacing_sizes();
    4789 
    4790         restore_error_handler();
     4763            ),
     4764            'default'
     4765        );
    47914766
    47924767        $this->assertSame( $expected_output, _wp_array_get( $theme_json->get_raw_data(), array( 'settings', 'spacing', 'spacingSizes', 'default' ) ) );
    … …  
    48104785                    'unit'       => 'rem',
    48114786                ),
    4812                 'expected_output' => null,
     4787                'expected_output' => array(),
    48134788            ),
    48144789            'non numeric increment'   => array(
    … …  
    48204795                    'unit'       => 'rem',
    48214796                ),
    4822                 'expected_output' => null,
     4797                'expected_output' => array(),
    48234798            ),
    48244799            'non numeric steps'       => array(
    … …  
    48304805                    'unit'       => 'rem',
    48314806                ),
    4832                 'expected_output' => null,
     4807                'expected_output' => array(),
    48334808            ),
    48344809            'non numeric medium step' => array(
    … …  
    48404815                    'unit'       => 'rem',
    48414816                ),
    4842                 'expected_output' => null,
     4817                'expected_output' => array(),
    48434818            ),
    48444819            'missing unit value'      => array(
    … …  
    48494824                    'mediumStep' => 4,
    48504825                ),
    4851                 'expected_output' => null,
     4826                'expected_output' => array(),
    48524827            ),
    48534828        );

  • trunk/tests/phpunit/tests/theme/wpThemeJsonSchema.php

    r57662 r58328  
    4242                ),
    4343                'typography' => array(
     44                    'fontSizes'      => array(
     45                        array(
     46                            'name' => 'Small',
     47                            'slug' => 'small',
     48                            'size' => 12,
     49                        ),
     50                        array(
     51                            'name' => 'Normal',
     52                            'slug' => 'normal',
     53                            'size' => 16,
     54                        ),
     55                    ),
    4456                    'fontStyle'      => false,
    4557                    'fontWeight'     => false,
    … …  
    127139                ),
    128140                'typography' => array(
    129                     'fontStyle'      => false,
    130                     'fontWeight'     => false,
    131                     'letterSpacing'  => false,
    132                     'textDecoration' => false,
    133                     'textTransform'  => false,
     141                    'defaultFontSizes' => false,
     142                    'fontSizes'        => array(
     143                        array(
     144                            'name' => 'Small',
     145                            'slug' => 'small',
     146                            'size' => 12,
     147                        ),
     148                        array(
     149                            'name' => 'Normal',
     150                            'slug' => 'normal',
     151                            'size' => 16,
     152                        ),
     153                    ),
     154                    'fontStyle'        => false,
     155                    'fontWeight'       => false,
     156                    'letterSpacing'    => false,
     157                    'textDecoration'   => false,
     158                    'textTransform'    => false,
    134159                ),
    135160                'blocks'     => array(
    … …  
    186211        $this->assertEqualSetsWithIndex( $expected, $actual );
    187212    }
     213
     214    public function test_migrate_v2_to_latest() {
     215        $theme_json_v2 = array(
     216            'version'  => 2,
     217            'settings' => array(
     218                'typography' => array(
     219                    'fontSizes' => array(
     220                        array(
     221                            'name' => 'Small',
     222                            'slug' => 'small',
     223                            'size' => 12,
     224                        ),
     225                        array(
     226                            'name' => 'Normal',
     227                            'slug' => 'normal',
     228                            'size' => 16,
     229                        ),
     230                    ),
     231                ),
     232                'spacing'    => array(
     233                    'spacingSizes' => array(
     234                        array(
     235                            'name' => 'Small',
     236                            'slug' => 20,
     237                            'size' => '20px',
     238                        ),
     239                        array(
     240                            'name' => 'Large',
     241                            'slug' => 80,
     242                            'size' => '80px',
     243                        ),
     244                    ),
     245                ),
     246            ),
     247        );
     248
     249        $actual = WP_Theme_JSON_Schema::migrate( $theme_json_v2 );
     250
     251        $expected = array(
     252            'version'  => WP_Theme_JSON::LATEST_SCHEMA,
     253            'settings' => array(
     254                'typography' => array(
     255                    'defaultFontSizes' => false,
     256                    'fontSizes'        => array(
     257                        array(
     258                            'name' => 'Small',
     259                            'slug' => 'small',
     260                            'size' => 12,
     261                        ),
     262                        array(
     263                            'name' => 'Normal',
     264                            'slug' => 'normal',
     265                            'size' => 16,
     266                        ),
     267                    ),
     268                ),
     269                'spacing'    => array(
     270                    'defaultSpacingSizes' => false,
     271                    'spacingSizes'        => array(
     272                        array(
     273                            'name' => 'Small',
     274                            'slug' => 20,
     275                            'size' => '20px',
     276                        ),
     277                        array(
     278                            'name' => 'Large',
     279                            'slug' => 80,
     280                            'size' => '80px',
     281                        ),
     282                    ),
     283                ),
     284            ),
     285        );
     286
     287        $this->assertEqualSetsWithIndex( $expected, $actual );
     288    }
    188289}

  • trunk/tests/qunit/fixtures/wp-api-generated.js

    r58326 r58328  
    78567856                            "description": "Version of the theme.json schema used for the typography settings.",
    78577857                            "type": "integer",
    7858                             "default": 2,
     7858                            "default": 3,
    78597859                            "minimum": 2,
    7860                             "maximum": 2,
     7860                            "maximum": 3,
    78617861                            "required": false
    78627862                        },
    … …  
    79257925                            "description": "Version of the theme.json schema used for the typography settings.",
    79267926                            "type": "integer",
    7927                             "default": 2,
     7927                            "default": 3,
    79287928                            "minimum": 2,
    7929                             "maximum": 2,
     7929                            "maximum": 3,
    79307930                            "required": false
    79317931                        },
    … …  
    80588058                            "description": "Version of the theme.json schema used for the typography settings.",
    80598059                            "type": "integer",
    8060                             "default": 2,
     8060                            "default": 3,
    80618061                            "minimum": 2,
    8062                             "maximum": 2,
     8062                            "maximum": 3,
    80638063                            "required": false
    80648064                        },
Note: See TracChangeset for help on using the changeset viewer.