WP_Theme_JSON_Schema

20#[AllowDynamicProperties]21class WP_Theme_JSON_Schema {22 23	/**24	 * Maps old properties to their new location within the schema's settings.25	 * This will be applied at both the defaults and individual block levels.26	 */27	const V1_TO_V2_RENAMED_PATHS = array(28		'border.customRadius'         => 'border.radius',29		'spacing.customMargin'        => 'spacing.margin',30		'spacing.customPadding'       => 'spacing.padding',31		'typography.customLineHeight' => 'typography.lineHeight',32	);33 34	/**35	 * Function that migrates a given theme.json structure to the last version.36	 *37	 * @since 5.9.038	 * @since 6.6.0 Migrate up to v3 and add $origin parameter.39	 *40	 * @param array $theme_json The structure to migrate.41	 * @param string $origin    Optional. What source of data this object represents.42	 *                          One of 'blocks', 'default', 'theme', or 'custom'. Default 'theme'.43	 * @return array The structure in the last version.44	 */45	public static function migrate( $theme_json, $origin = 'theme' ) {46		if ( ! isset( $theme_json['version'] ) ) {47			$theme_json = array(48				'version' => WP_Theme_JSON::LATEST_SCHEMA,49			);50		}51 52		// Migrate each version in order starting with the current version.53		switch ( $theme_json['version'] ) {54			case 1:55				$theme_json = self::migrate_v1_to_v2( $theme_json );56				// Deliberate fall through. Once migrated to v2, also migrate to v3.57			case 2:58				$theme_json = self::migrate_v2_to_v3( $theme_json, $origin );59		}60 61		return $theme_json;62	}63 64	/**65	 * Removes the custom prefixes for a few properties66	 * that were part of v1:67	 *68	 * 'border.customRadius'         => 'border.radius',69	 * 'spacing.customMargin'        => 'spacing.margin',70	 * 'spacing.customPadding'       => 'spacing.padding',71	 * 'typography.customLineHeight' => 'typography.lineHeight',72	 *73	 * @since 5.9.074	 *75	 * @param array $old Data to migrate.76	 *77	 * @return array Data without the custom prefixes.78	 */79	private static function migrate_v1_to_v2( $old ) {80		// Copy everything.81		$new = $old;82 83		// Overwrite the things that changed.84		if ( isset( $old['settings'] ) ) {85			$new['settings'] = self::rename_paths( $old['settings'], self::V1_TO_V2_RENAMED_PATHS );86		}87 88		// Set the new version.89		$new['version'] = 2;90 91		return $new;92	}93 94	/**95	 * Migrates from v2 to v3.96	 *97	 * - Sets settings.typography.defaultFontSizes to false if settings.typography.fontSizes are defined.98	 * - Sets settings.spacing.defaultSpacingSizes to false if settings.spacing.spacingSizes are defined.99	 * - Prevents settings.spacing.spacingSizes from merging with settings.spacing.spacingScale by