Merge pull request #3687 from Shopify/cappslock/chore/2026-01-rc/bug-bash-cleanups

POS PWC 2026-01-RC cleanups from bug bash

Author: cappslock

packages/ui-extensions/docs/surfaces/point-of-sale/screenshots/tab-default.png

@@ -3,7 +3,7 @@ import {ReferenceEntityTemplateSchema} from '@shopify/generate-docs';
 const data: ReferenceEntityTemplateSchema = {
   name: 'Embed',
   description:
-    'The `Embed` component displays a preview of printable content from a specified source URL. Use it to show users what will be printed before triggering the actual print operation.\n\n`Embed` works in conjunction with the Print API to provide complete print functionality from preview to execution.\n\nSupported document types:\n\n- **HTML documents** (`.html`, `.htm`) - Best printing experience with full CSS styling, embedded images, and complex layouts. Use for receipts, invoices, and formatted reports.\n\n- **Text files** (`.txt`, `.csv`) - Plain text with basic content and tabular data support. Use for simple receipts and data exports.\n\n- **Image files** (`.png`, `.jpg`, `.jpeg`, `.gif`, `.bmp`, `.webp`) - Common web formats with format-specific optimizations. Use for logos, charts, QR codes, and barcodes.\n\n- **PDF files** (`.pdf`) - Behavior varies by platform: prints directly on iOS/desktop, but downloads to external viewer on Android. Use for complex documents and compliance requirements.\n\n[Learn how to build a print extension in POS](/docs/apps/build/pos/build-print-extension).',
+    'The `Embed` component displays a preview of printable content from a specified source URL. Use it to show users what will be printed before triggering the actual print operation.\n\n`Embed` works in conjunction with the Print API to provide complete print functionality from preview to execution.\n\nSupported document types:\n\n- **HTML documents** (`.html`, `.htm`) - Best printing experience with full CSS styling, embedded images, and complex layouts. Use for receipts, invoices, and formatted reports.\n\n- **Text files** (`.txt`, `.csv`) - Plain text with basic content and tabular data support. Use for simple receipts and data exports.\n\n- **PDF files** (`.pdf`) - Behavior varies by platform: prints directly on iOS/desktop, but downloads to external viewer on Android. Use for complex documents and compliance requirements.\n\n[Learn how to build a print extension in POS](/docs/apps/build/pos/build-print-extension).',
   isVisualComponent: true,
   type: 'component',
   thumbnail: 'embed-thumbnail.png',
@@ -21,7 +21,7 @@ const data: ReferenceEntityTemplateSchema = {
   defaultExample: {
     image: 'embed-default.png',
     description:
-      'Display a preview of printable content before triggering the print operation. This example shows how to use Embed with HTML documents, PDFs, images, or text files, supporting various document formats with proper rendering for receipts, invoices, and formatted reports.',
+      'Display a preview of printable content before triggering the print operation. This example shows how to use Embed with HTML documents, PDFs, or text files, supporting various document formats with proper rendering for receipts, invoices, and formatted reports.',
     codeblock: {
       title: 'Preview printable content',
       tabs: [{code: './examples/embed.html', language: 'html'}],

packages/ui-extensions/docs/surfaces/point-of-sale/screenshots/tab-thumbnail.png

@@ -15,6 +15,12 @@ const data: ReferenceEntityTemplateSchema = {
         'Configure the following properties on the `Link` component.',
       type: 'Link',
     },
+    {
+      title: 'Events',
+      description:
+        'The `Link` component provides event callbacks for handling user interactions. Learn more about [handling events](/docs/api/polaris/using-polaris-web-components#handling-events).',
+      type: 'LinkEvents',
+    },
   ],
   category: 'Polaris web components',
   subCategory: 'Actions',

packages/ui-extensions/src/surfaces/point-of-sale/components/Embed/Embed.doc.ts

@@ -1 +1 @@
-<s-link>Tappable link</s-link>
+<s-link onClick={handleLinkTap}>Tappable link</s-link>

packages/ui-extensions/src/surfaces/point-of-sale/components/Link/Link.doc.ts

@@ -41,7 +41,7 @@ const data: ReferenceEntityTemplateSchema = {
 - **Provide accessibility labels:** Always use \`accessibilityLabel\` to describe what is loading, helping screen reader users understand the context.
 - **Position strategically:** Place spinners where content will appear, or center them in the loading area to provide clear visual feedback.
 - **Don't overuse:** Avoid multiple spinners on the same screen. Use a single spinner to represent the overall loading state when possible.
-- **Consider alternatives for long waits:** For operations taking more than a few seconds, consider using progress indicators or status messages instead.
+- **Consider alternatives for long waits:** For operations taking more than a few seconds, consider using status messages instead.
 `,
     },
   ],

packages/ui-extensions/src/surfaces/point-of-sale/components/Link/examples/default.html

@@ -26,8 +26,7 @@ const data: ReferenceEntityTemplateSchema = {
   subCategory: 'Forms',
   defaultExample: {
     image: 'switch-default.png',
-    description:
-      'Toggle settings on or off using a `Switch` component. This example shows a basic switch with a label.',
+    description: 'Toggle settings on or off using a `Switch` component.',
     codeblock: {
       title: 'Create a toggle switch',
       tabs: [

packages/ui-extensions/src/surfaces/point-of-sale/components/Spinner/Spinner.doc.ts

@@ -1,2 +1,2 @@
-<s-switch label="Option 1" />
-<s-switch label="Option 2" defaultChecked />
+<s-switch />
+<s-switch defaultChecked />

packages/ui-extensions/src/surfaces/point-of-sale/components/Switch/Switch.doc.ts

@@ -64,7 +64,7 @@ const data: ReferenceEntityTemplateSchema = {
       sectionContent: `
 - **Provide accessibility labels:** Use the \`accessibilityLabel\` prop on the \`Tabs\` component to describe the purpose of the tab group.
 - **Ensure keyboard navigation:** The component supports arrow key navigation between tabs and Enter/Space to activate tabs.
-- **Connect tabs and panels:** Always use matching \`controls\` (on Tab) and \`id\` (on TabPanel) properties to maintain proper ARIA relationships.
+- **Connect tabs and panels:** Always use matching \`controls\` (on Tab) and \`id\` (on TabPanel) properties to maintain proper semantic relationships.
 `,
     },
   ],