[UI components]: Docs updates for components for remote-dom release (#2861)

* changes for docs

* updating examples

* build script

* Update packages/ui-extensions/src/surfaces/checkout/components/Button/examples/basic-button.example.html

Co-authored-by: Jean-Frederic Fortier <[email protected]>

* Update packages/ui-extensions/src/surfaces/checkout/components/Paragraph/examples/basic-paragraph.example.html

Co-authored-by: Jean-Frederic Fortier <[email protected]>

* feedback

* optimized images

* adding missing shared components

* banner to new category

* Update packages/ui-extensions/src/surfaces/checkout/components/Banner/examples/basic-banner.example.html

Co-authored-by: Jean-Frederic Fortier <[email protected]>

* Update packages/ui-extensions/src/surfaces/checkout/components/Button/examples/basic-button.example.html

Co-authored-by: Jean-Frederic Fortier <[email protected]>

* Update packages/ui-extensions/docs/surfaces/checkout/categories/components.doc.ts

Co-authored-by: Jean-Frederic Fortier <[email protected]>

* removing image

* adding alt text

---------

Co-authored-by: Jean-Frederic Fortier <[email protected]>

Author: oliverigor

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

@@ -35,21 +35,22 @@ fi
 
 COMPILE_DOCS="yarn tsc --project $DOCS_PATH/tsconfig.docs.json --types react --moduleResolution node  --target esNext  --module CommonJS && yarn generate-docs --overridePath ./$DOCS_PATH/typeOverride.json --input ./$DOCS_PATH/reference ./$SRC_PATH --typesInput ./$SRC_PATH --output ./$DOCS_PATH/generated"
 COMPILE_STATIC_PAGES="yarn tsc $DOCS_PATH/staticPages/*.doc.ts --types react --moduleResolution node  --target esNext  --module CommonJS && yarn generate-docs --isLandingPage --input ./$DOCS_PATH/staticPages --output ./$DOCS_PATH/generated"
+COMPILE_CATEGORIES="yarn tsc $DOCS_PATH/categories/*.doc.ts --moduleResolution node --target esNext --module CommonJS && pnpm exec generate-docs --isCategoryPage --input ./$DOCS_PATH/categories --output ./$DOCS_PATH/generated"
 
 # Rename components.d.ts to components.ts so it can be picked up be the generate-docs tool
 cp $COMPONENTS_DEFINITIONS $COMPONENTS_TS
 
 if echo "$PWD" | grep -q '\checkout-web'; then
   # We are generating docs from the private package, which does not have other surfaces aside from checkout
-  eval $COMPILE_DOCS && eval $COMPILE_STATIC_PAGES
+  eval $COMPILE_DOCS && eval $COMPILE_STATIC_PAGES && eval $COMPILE_CATEGORIES
   build_exit=$?
 else
   # Other surfaces may have duplicate types that cause issues with documentation generation,
   # so we erase their contents and replace them afterwards
   echo "export {}" > src/surfaces/customer-account.ts
   echo "export {}" > src/surfaces/admin.ts
   echo "export {}" > src/surfaces/point-of-sale.ts
-  eval $COMPILE_DOCS && eval $COMPILE_STATIC_PAGES
+  eval $COMPILE_DOCS && eval $COMPILE_STATIC_PAGES && eval $COMPILE_CATEGORIES
   build_exit=$?
   git checkout HEAD -- src/surfaces/customer-account.ts
   git checkout HEAD -- src/surfaces/admin.ts

packages/ui-extensions/docs/surfaces/checkout/categories/components.doc.ts

@@ -0,0 +1,23 @@
+import type {CategoryTemplateSchema} from '@shopify/generate-docs';
+
+const data: CategoryTemplateSchema = {
+  category: 'polaris-web-components',
+  sections: [
+    {
+      type: 'Generic',
+      anchorLink: 'notification-banner',
+      title: '',
+      sectionContent: '',
+      sectionNotice: [
+        {
+          type: 'info',
+          title: 'Early access',
+          sectionContent:
+            'This is an early access preview of Polaris built with web components. If you’re looking for a stable React implementation, see the [Checkout React documentation](/docs/api/checkout-ui-extensions/2025-04/components).',
+        },
+      ],
+    },
+  ],
+};
+
+export default data;