Port work from https://github.com/Shopify/extensibility/pull/517

[gwyneplaine]

Background

Port over work from https://github.com/Shopify/extensibility/pull/517

cc @mpshopify

Checklist

• I have 🎩'd these changes
• I have updated relevant documentation

[gwyneplaine]

• Port work from https://github.com/Shopify/extensibility/pull/517 #3016 👈 (View in Graphite)
• 2025-10-rc

This stack of pull requests is managed by Graphite. Learn more about stacking.

[alex-page]

Looks good just needs some CI fixes

[themarkappleby]

Hi @gwyneplaine. I'm trying to tophat this PR by running yarn docs:admin 2025-10-rc but I'm getting the following error:

Error: Unable to find code file, '../../examples/patterns/details.jsx', in the doc file: 'src/surfaces/admin/components/patterns/details.ab.doc.js'.
    at /Users/markappleby/src/github.com/Shopify/ui-extensions/node_modules/@shopify/generate-docs/dist/generate-docs/src/assembler/contentModifications/createCodeTabs.js:42:19
    at Array.map (<anonymous>)
    at createCodeTabs (/Users/markappleby/src/github.com/Shopify/ui-extensions/node_modules/@shopify/generate-docs/dist/generate-docs/src/assembler/contentModifications/createCodeTabs.js:33:71)
    at addExamplesToDocs (/Users/markappleby/src/github.com/Shopify/ui-extensions/node_modules/@shopify/generate-docs/dist/generate-docs/src/assembler/docModifications/addExamplesToDocs.js:13:58)
    at /Users/markappleby/src/github.com/Shopify/ui-extensions/node_modules/@shopify/generate-docs/dist/generate-docs/src/assembler/docModifications/addGeneratedContentToDocs.js:13:51
    at Array.forEach (<anonymous>)
    at addGeneratedContentToDocs (/Users/markappleby/src/github.com/Shopify/ui-extensions/node_modules/@shopify/generate-docs/dist/generate-docs/src/assembler/docModifications/addGeneratedContentToDocs.js:8:18)
    at parseDocFiles (/Users/markappleby/src/github.com/Shopify/ui-extensions/node_modules/@shopify/generate-docs/dist/generate-docs/src/assembler/assembler.js:80:63)
    at async Promise.all (index 0)
node:fs:581
  return binding.open(
                 ^

Error: ENOENT: no such file or directory, open ''
    at Object.openSync (node:fs:581:18)
    at Object.writeFileSync (node:fs:2342:35)
    at /Users/markappleby/src/github.com/Shopify/ui-extensions/node_modules/@shopify/generate-docs/dist/generate-docs/src/assembler/assembler.js:100:12 {
  errno: -2,
  code: 'ENOENT',
  syscall: 'open',
  path: ''
}

Re: the shopify-dev repo, I'm on the latest version of main. Am I doing something wrong?

[mpshopify]

@gwyneplaine I think this wasn't merged after all, what would be the best way to port these changes over? I see there are a few conflicts now.

[mpshopify]

Closing, merged with #3119