fix target generation

Author: laurelthorburn

packages/ui-extensions/docs/surfaces/checkout/build-docs-targets-json.mjs

@@ -11,11 +11,10 @@ import {
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
 
-// Find the generated_docs_data.json file to determine output location
+// Find the generated_docs_data_v2.json file to determine output location
 function findGeneratedDocsPath() {
   const generatedDir = path.join(__dirname, 'generated');
 
-  // Look for generated_docs_data.json recursively
   function findFile(dir) {
     const files = fs.readdirSync(dir);
     for (const file of files) {
@@ -24,7 +23,7 @@ function findGeneratedDocsPath() {
       if (stat.isDirectory()) {
         const result = findFile(fullPath);
         if (result) return result;
-      } else if (file === 'generated_docs_data.json') {
+      } else if (file === 'generated_docs_data_v2.json') {
         return path.dirname(fullPath);
       }
     }
@@ -35,28 +34,10 @@ function findGeneratedDocsPath() {
   return docsPath || generatedDir; // Fallback to generated root if not found
 }
 
-// Accept an API version argument (e.g. 2026-04-rc) to output targets.json into
-// a versioned directory matching the customer-account pattern.
-// Falls back to the directory containing generated_docs_data.json if not provided.
-const apiVersion = process.argv[2];
-
-function resolveOutputPath() {
-  if (apiVersion) {
-    return path.join(
-      __dirname,
-      'generated',
-      'checkout_ui_extensions',
-      apiVersion,
-      'targets.json',
-    );
-  }
-  return path.join(findGeneratedDocsPath(), 'targets.json');
-}
-
 // Configuration for checkout surface
 const config = {
   basePath: path.join(__dirname, '../../../src/surfaces/checkout'),
-  outputPath: resolveOutputPath(),
+  outputPath: path.join(findGeneratedDocsPath(), 'targets.json'),
   componentTypesPath: null,
   hasComponentTypes: false,
 };

packages/ui-extensions/docs/surfaces/checkout/build-docs.sh

@@ -33,6 +33,10 @@ else
   echo "Building docs for '$API_VERSION' checkout UI extensions API."
 fi
 
+# Wipe the generated directory so stale files from previous runs don't linger.
+echo "Cleaning ./$DOCS_PATH/generated..."
+rm -rf ./$DOCS_PATH/generated
+
 COMPILE_DOCS="yarn generate-docs --overridePath ./$DOCS_PATH/typeOverride.json --input ./$SRC_PATH --output ./$DOCS_PATH/generated"
 
 # Copy all .d.ts files in components directory to .ts files so they can be picked up by the generate-docs tool
@@ -87,7 +91,7 @@ if [ $sed_exit -ne 0 ]; then
 fi
 
 # Generate targets.json (extension targets + APIs + components mapping)
-node ./$DOCS_PATH/build-docs-targets-json.mjs $API_VERSION
+node ./$DOCS_PATH/build-docs-targets-json.mjs
 targets_exit=$?
 if [ $targets_exit -ne 0 ]; then
   fail_and_exit $targets_exit
@@ -106,12 +110,6 @@ if [ -d $SHOPIFY_DEV_PATH ]; then
   mkdir -p $SHOPIFY_DEV_DEST
   cp ./$DOCS_PATH/generated/* $SHOPIFY_DEV_DEST
 
-  # Also copy the versioned targets.json generated by build-docs-targets-json.mjs
-  VERSIONED_TARGETS=./$DOCS_PATH/generated/checkout_ui_extensions/$API_VERSION/targets.json
-  if [ -f "$VERSIONED_TARGETS" ]; then
-    cp "$VERSIONED_TARGETS" $SHOPIFY_DEV_DEST/targets.json
-  fi
-
   # Replace 'latest' with the exact API version in relative doc links
   run_sed \
     "s/\/docs\/api\/checkout-ui-extensions\/latest/\/docs\/api\/checkout-ui-extensions\/$API_VERSION/gi" \