2024-10 target docs

[johndcollett]

Background

Part of: https://github.com/Shopify/shopify-dev/issues/66648

We want to parse target information for the dev docs for each surface.

Solution

Added scripts for each surface to pull target information from extension-targets.ts or targets.ts into a format that shopify-dev needs to display that information.

The scripts handle:

• @private JSDoc tags: Targets marked with @private are excluded from the generated output
• RunnableExtension targets: Included with components: [] since they don't render UI
• Pick<> and Omit<> types: Correctly resolved to their component lists
• Union types: Component types like AllComponents | OrderRoutingComponents are correctly merged

Also updated the build-docs.sh script to run the above script to create the targets output in the same place as other docs information for the reference.

🎩

Run the docs generation script for the different surfaces and verify that targets.json gets created correctly:

# 1. Admin surface
yarn docs:admin 2024-10

# 2. Checkout surface
yarn docs:checkout 2024-10

# 3. Point-of-Sale surface
yarn docs:point-of-sale 2024-10

# 4. Customer account surface
yarn docs:customer-account 2024-10

Verify that:

• Targets with @private JSDoc tags are NOT included in the output (e.g., Playground in admin, purchase.checkout.gift-card.render in checkout)
• RunnableExtension targets (e.g., purchase.address-autocomplete.suggest) have components: []
• Component types using Pick<> resolve to only the picked components (e.g., pos.home.tile.render should have only ['Tile'])
• Component types using Omit<> resolve to all components except the omitted ones

Checklist

• I have 🎩'd these changes