Enable appearance tools via theme_support (#43337)

* Enable appearance tools via theme_support
Co-authored-by: Jeff Ong <jonger4@gmail.com>

Author: pbking

docs/how-to-guides/themes/theme-json.md

@@ -334,6 +334,7 @@ To retain backward compatibility, the existing `add_theme_support` declarations
 | `editor-font-sizes`         | Provide the list of font size via `typography.fontSizes`. |
 | `editor-gradient-presets`   | Provide the list of gradients via `color.gradients`.      |
 | `experimental-link-color`   | Set `color.link` to `true`. `experimental-link-color` will be removed when the plugin requires WordPress 5.9 as the minimum version. |
+| `appearance-tools`          | Set `appearanceTools` to `true`.                          |
 
 #### Presets
 

docs/how-to-guides/themes/theme-support.md

@@ -463,3 +463,16 @@ where
 - `<link-color>` is either `var(--wp--preset--color--slug)` (if the user selected a preset value) or a raw color value (if the user selected a custom value)
 
 The block will get attached the class `.wp-elements-<uuid>`.
+
+## Appearance Tools
+
+Use this setting to enable the following Global Styles settings:
+
+- border: color, radius, style, width
+- color: link
+- spacing: blockGap, margin, padding
+- typography: lineHeight
+
+```php
+add_theme_support( 'appearance-tools' );
+```

lib/experimental/class-wp-theme-json-resolver-gutenberg.php

@@ -92,6 +92,11 @@ public static function get_theme_data( $deprecated = array(), $settings = array(
 
 			// Classic themes without a theme.json don't support global duotone.
 			$theme_support_data['settings']['color']['defaultDuotone'] = false;
+
+			// Allow themes to enable appearance tools via theme_support.
+			if ( current_theme_supports( 'appearance-tools' ) ) {
+				$theme_support_data['settings']['appearanceTools'] = true;
+			}
 		}
 		$with_theme_supports = new WP_Theme_JSON_Gutenberg( $theme_support_data );
 		$with_theme_supports->merge( static::$theme );

packages/core-data/src/entity-types/theme.ts

@@ -78,6 +78,10 @@ declare module './base-entity-records' {
 			 * Whether theme opts in to wide alignment CSS class.
 			 */
 			'align-wide': boolean;
+			/**
+			 * Whether appearanceTools are enabled in Global Styles.
+			 */
+			'appearance-tools': boolean;
 			/**
 			 * Whether posts and comments RSS feed links are added to head.
 			 */