From 62ecf4a4bdb4aceee01031ca2e08adeb3a250bf4 Mon Sep 17 00:00:00 2001
From: Matias Benedetto <matias.benedetto@gmail.com>
Date: Tue, 5 Dec 2023 16:17:25 -0600
Subject: [PATCH] Font Library: add font family and font face preview keys to
 schema (#56793)

* Add preview key  to theme.json schema

* add preview key to php data sanitization schema

* update description text

Co-authored-by: Jeff Ong <jonger4@gmail.com>

* update docs

---------

Co-authored-by: Jeff Ong <jonger4@gmail.com>
---
 .../theme-json-reference/theme-json-living.md             | 2 +-
 lib/class-wp-theme-json-gutenberg.php                     | 2 ++
 schemas/json/theme.json                                   | 8 ++++++++
 3 files changed, 11 insertions(+), 1 deletion(-)

diff --git a/docs/reference-guides/theme-json-reference/theme-json-living.md b/docs/reference-guides/theme-json-reference/theme-json-living.md
index 24a5845381bfda..627fee6071816f 100644
--- a/docs/reference-guides/theme-json-reference/theme-json-living.md
+++ b/docs/reference-guides/theme-json-reference/theme-json-living.md
@@ -188,7 +188,7 @@ Settings related to typography.
 | textTransform | boolean | true |  |
 | dropCap | boolean | true |  |
 | fontSizes | array |  | fluid, name, size, slug |
-| fontFamilies | array |  | fontFace, fontFamily, name, slug |
+| fontFamilies | array |  | fontFace, fontFamily, name, preview, slug |
 
 ---
 
diff --git a/lib/class-wp-theme-json-gutenberg.php b/lib/class-wp-theme-json-gutenberg.php
index 9311001f2edd14..43a3772a1c3af0 100644
--- a/lib/class-wp-theme-json-gutenberg.php
+++ b/lib/class-wp-theme-json-gutenberg.php
@@ -431,6 +431,7 @@ class WP_Theme_JSON_Gutenberg {
 			'fontFamily' => null,
 			'name'       => null,
 			'slug'       => null,
+			'preview'    => null,
 			'fontFace'   => array(
 				array(
 					'ascentOverride'        => null,
@@ -446,6 +447,7 @@ class WP_Theme_JSON_Gutenberg {
 					'sizeAdjust'            => null,
 					'src'                   => null,
 					'unicodeRange'          => null,
+					'preview'               => null,
 				),
 			),
 		),
diff --git a/schemas/json/theme.json b/schemas/json/theme.json
index 782e59794a5d18..10695f493c40dd 100644
--- a/schemas/json/theme.json
+++ b/schemas/json/theme.json
@@ -623,6 +623,10 @@
 										"description": "CSS font-family value.",
 										"type": "string"
 									},
+									"preview": {
+										"description": "URL to a preview image of the font family.",
+										"type": "string"
+									},
 									"fontFace": {
 										"description": "Array of font-face declarations.",
 										"type": "array",
@@ -713,6 +717,10 @@
 												"unicodeRange": {
 													"description": "CSS unicode-range value.",
 													"type": "string"
+												},
+												"preview": {
+													"description": "URL to a preview image of the font face.",
+													"type": "string"
 												}
 											},
 											"required": [ "fontFamily", "src" ],