From 8f999991dee969383c4ca8690a47577ad5721f4b Mon Sep 17 00:00:00 2001
From: Aki Hamano <54422211+t-hamano@users.noreply.github.com>
Date: Fri, 25 Oct 2024 11:26:29 +0900
Subject: [PATCH] Fix: JSON Schema Docgen doesn't work on Windows OS (#66414)

* Fix: JSON Schema Docgen doesn't work on Windows OS

* Update bin/api-docs/gen-theme-reference.mjs

Co-authored-by: Jon Surrell <sirreal@users.noreply.github.com>

* Lint

---------

Co-authored-by: t-hamano <wildworks@git.wordpress.org>
Co-authored-by: sirreal <jonsurrell@git.wordpress.org>
---
 bin/api-docs/gen-theme-reference.mjs | 29 ++++++++++++++--------------
 1 file changed, 14 insertions(+), 15 deletions(-)

diff --git a/bin/api-docs/gen-theme-reference.mjs b/bin/api-docs/gen-theme-reference.mjs
index 6dc7791e288b9..f50d194c17ee7 100644
--- a/bin/api-docs/gen-theme-reference.mjs
+++ b/bin/api-docs/gen-theme-reference.mjs
@@ -9,6 +9,7 @@
  */
 import fs from 'node:fs/promises';
 import $RefParser from '@apidevtools/json-schema-ref-parser';
+import { fileURLToPath } from 'node:url';
 
 /**
  * @typedef {import('@apidevtools/json-schema-ref-parser').JSONSchema} JSONSchema
@@ -19,9 +20,8 @@ import $RefParser from '@apidevtools/json-schema-ref-parser';
  *
  * @type {URL}
  */
-const THEME_JSON_SCHEMA_URL = new URL(
-	'../../schemas/json/theme.json',
-	import.meta.url
+const THEME_JSON_SCHEMA_PATH = fileURLToPath(
+	new URL( '../../schemas/json/theme.json', import.meta.url )
 );
 
 /**
@@ -29,9 +29,11 @@ const THEME_JSON_SCHEMA_URL = new URL(
  *
  * @type {URL}
  */
-const REFERENCE_DOC_URL = new URL(
-	'../../docs/reference-guides/theme-json-reference/theme-json-living.md',
-	import.meta.url
+const REFERENCE_DOC_PATH = fileURLToPath(
+	new URL(
+		'../../docs/reference-guides/theme-json-reference/theme-json-living.md',
+		import.meta.url
+	)
 );
 
 /**
@@ -265,15 +267,12 @@ function generateDocs( themeJson ) {
  * Main function.
  */
 async function main() {
-	const themeJson = await $RefParser.dereference(
-		THEME_JSON_SCHEMA_URL.pathname,
-		{
-			parse: { binary: false, text: false, yaml: false },
-			resolve: { external: false },
-		}
-	);
+	const themeJson = await $RefParser.dereference( THEME_JSON_SCHEMA_PATH, {
+		parse: { binary: false, text: false, yaml: false },
+		resolve: { external: false },
+	} );
 
-	const themeJsonReference = await fs.readFile( REFERENCE_DOC_URL, {
+	const themeJsonReference = await fs.readFile( REFERENCE_DOC_PATH, {
 		encoding: 'utf8',
 		flag: 'r',
 	} );
@@ -285,7 +284,7 @@ async function main() {
 		`${ START_TOKEN }\n${ generatedDocs }\n${ END_TOKEN }`
 	);
 
-	await fs.writeFile( REFERENCE_DOC_URL, updatedThemeJsonReference, {
+	await fs.writeFile( REFERENCE_DOC_PATH, updatedThemeJsonReference, {
 		encoding: 'utf8',
 	} );
 }