theme.json schema: Allow object type on style properties (#45897)

* Allow objects on color properties

* Add definition for ref property

* Reduce repetition in property definitions

* Move properties def to oneOf array

* Fix $ref path

* Move ref def to global scope

* Apply ref type to all style properties

* Update docs

* Result of docs:build script

* Run docs:build to update docs

* Make ref logic more specific

bin/api-docs/gen-theme-reference.js

@@ -176,8 +176,9 @@ const formatType = ( prop ) => {
 
 		propTypes.forEach( ( item ) => {
 			if ( item.type ) types.push( item.type );
-			// $ref is always an object
-			if ( item.$ref ) types.push( 'object' );
+			// refComplete is always an object
+			if ( item.$ref && item.$ref === '#/definitions/refComplete' )
+				types.push( 'object' );
 		} );
 
 		type = [ ...new Set( types ) ].join( ', ' );

docs/reference-guides/theme-json-reference/theme-json-living.md

@@ -145,10 +145,10 @@ Border styles.
 
 | Property  | Type   |  Props  |
 | ---       | ---    |---   |
-| color | string |  |
+| color | string, object |  |
 | radius | string, object |  |
-| style | string |  |
-| width | string |  |
+| style | string, object |  |
+| width | string, object |  |
 | top | object | color, style, width |
 | right | object | color, style, width |
 | bottom | object | color, style, width |
@@ -162,9 +162,9 @@ Color styles.
 
 | Property  | Type   |  Props  |
 | ---       | ---    |---   |
-| background | string |  |
-| gradient | string |  |
-| text | string |  |
+| background | string, object |  |
+| gradient | string, object |  |
+| text | string, object |  |
 
 ---
 
@@ -174,7 +174,7 @@ Spacing styles.
 
 | Property  | Type   |  Props  |
 | ---       | ---    |---   |
-| blockGap | string |  |
+| blockGap | string, object |  |
 | margin | object | bottom, left, right, top |
 | padding | object | bottom, left, right, top |
 
@@ -186,14 +186,14 @@ Typography styles.
 
 | Property  | Type   |  Props  |
 | ---       | ---    |---   |
-| fontFamily | string |  |
-| fontSize | string |  |
-| fontStyle | string |  |
-| fontWeight | string |  |
-| letterSpacing | string |  |
-| lineHeight | string |  |
-| textDecoration | string |  |
-| textTransform | string |  |
+| fontFamily | string, object |  |
+| fontSize | string, object |  |
+| fontStyle | string, object |  |
+| fontWeight | string, object |  |
+| letterSpacing | string, object |  |
+| lineHeight | string, object |  |
+| textDecoration | string, object |  |
+| textTransform | string, object |  |
 
 ---
 
@@ -203,7 +203,7 @@ CSS and SVG filter styles.
 
 | Property  | Type   |  Props  |
 | ---       | ---    |---   |
-| duotone | string |  |
+| duotone | string, object |  |
 
 ---
 
@@ -220,10 +220,10 @@ Outline styles.
 
 | Property  | Type   |  Props  |
 | ---       | ---    |---   |
-| color | string |  |
-| offset | string |  |
-| style | string |  |
-| width | string |  |
+| color | string, object |  |
+| offset | string, object |  |
+| style | string, object |  |
+| width | string, object |  |
 
 ---