@shopify/ui-extensions 2025.10.0 → 2025.10.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shopify/ui-extensions",
-  "version": "2025.10.0",
+  "version": "2025.10.2",
   "scripts": {
     "docs:admin": "node ./docs/surfaces/admin/build-docs.mjs",
     "docs:checkout": "bash ./docs/surfaces/checkout/build-docs.sh",

package/src/surfaces/admin/components/Avatar/examples/basic-usage.html

@@ -0,0 +1 @@
+<s-avatar initials="SC" alt="Sarah Chen"></s-avatar>

package/src/surfaces/admin/components/Avatar/examples/color-consistency-demo.html

@@ -0,0 +1,7 @@
+<s-stack direction="inline" gap="base">
+  <s-avatar initials="AB" alt="Apparel boutique" size="base"></s-avatar>
+  <s-avatar initials="CD" alt="Coffee direct" size="base"></s-avatar>
+  <s-avatar initials="EF" alt="Electronics franchise" size="base"></s-avatar>
+  <s-avatar initials="AB" alt="Art books store" size="base"></s-avatar>
+  <!-- Note: Both AB avatars will have the same color -->
+</s-stack>

package/src/surfaces/admin/components/Avatar/examples/default-avatar-no-props.html

@@ -0,0 +1 @@
+<s-avatar alt="Customer"></s-avatar>

package/src/surfaces/admin/components/Avatar/examples/default.html

@@ -1,4 +1 @@
-<s-avatar
-  alt="John Doe"
-  initials="JD"
-></s-avatar>
+<s-avatar alt="John Doe" initials="JD"></s-avatar>

package/src/surfaces/admin/components/Avatar/examples/error-handling-example.html

@@ -0,0 +1,6 @@
+<s-avatar
+  src="/invalid-customer-photo.jpg"
+  initials="CS"
+  alt="Customer support"
+></s-avatar>
+<!-- Will display "CS" initials when image fails -->

package/src/surfaces/admin/components/Avatar/examples/fulfillment-partner-avatars.html

@@ -0,0 +1,14 @@
+<s-stack gap="small">
+  <s-stack direction="inline" gap="small">
+    <s-avatar initials="3P" alt="3PL partner" size="small"></s-avatar>
+    <s-text>Third-party logistics</s-text>
+  </s-stack>
+  <s-stack direction="inline" gap="small">
+    <s-avatar initials="DS" alt="Dropship supplier" size="small"></s-avatar>
+    <s-text>Dropship supplier</s-text>
+  </s-stack>
+  <s-stack direction="inline" gap="small">
+    <s-avatar initials="WH" alt="Warehouse hub" size="small"></s-avatar>
+    <s-text>Warehouse hub</s-text>
+  </s-stack>
+</s-stack>

package/src/surfaces/admin/components/Avatar/examples/in-customer-list-context.html

@@ -0,0 +1,24 @@
+<s-stack gap="base">
+  <s-stack direction="inline" gap="small">
+    <s-avatar
+      src="/customers/merchant-alice.jpg"
+      initials="AJ"
+      alt="Alice's jewelry store"
+      size="small"
+    ></s-avatar>
+    <s-text>Alice's jewelry store</s-text>
+  </s-stack>
+  <s-stack direction="inline" gap="small">
+    <s-avatar initials="BP" alt="Bob's pet supplies" size="small"></s-avatar>
+    <s-text>Bob's pet supplies</s-text>
+  </s-stack>
+  <s-stack direction="inline" gap="small">
+    <s-avatar
+      src="/customers/charlie-cafe.jpg"
+      initials="CC"
+      alt="Charlie's coffee corner"
+      size="small"
+    ></s-avatar>
+    <s-text>Charlie's coffee corner</s-text>
+  </s-stack>
+</s-stack>

package/src/surfaces/admin/components/Avatar/examples/long-initials-handling.html

@@ -0,0 +1,5 @@
+<s-stack direction="inline" gap="base">
+  <s-avatar initials="TC" alt="Tech customer" size="base"></s-avatar>
+  <s-avatar initials="VIP" alt="VIP customer store" size="base"></s-avatar>
+  <s-avatar initials="SHOP" alt="Shopify partner store" size="base"></s-avatar>
+</s-stack>

package/src/surfaces/admin/components/Avatar/examples/size-variations.html

@@ -0,0 +1,7 @@
+<s-stack direction="inline" gap="base">
+  <s-avatar initials="SC" alt="Store customer" size="small-200"></s-avatar>
+  <s-avatar initials="MR" alt="Merchant representative" size="small"></s-avatar>
+  <s-avatar initials="SM" alt="Store manager" size="base"></s-avatar>
+  <s-avatar initials="SF" alt="Staff member" size="large"></s-avatar>
+  <s-avatar initials="SO" alt="Store owner" size="large-200"></s-avatar>
+</s-stack>

package/src/surfaces/admin/components/Avatar/examples/staff-member-profiles.html

@@ -0,0 +1,10 @@
+<s-stack direction="inline" gap="large">
+  <s-avatar
+    src="/staff/manager-profile.jpg"
+    initials="SM"
+    alt="Store manager"
+    size="large"
+  ></s-avatar>
+  <s-avatar initials="CS" alt="Customer service rep" size="base"></s-avatar>
+  <s-avatar initials="FT" alt="Fulfillment team lead" size="small"></s-avatar>
+</s-stack>

package/src/surfaces/admin/components/Avatar/examples/with-image-source-and-fallback.html

@@ -0,0 +1,6 @@
+<s-avatar
+  src="/customers/profile-123.jpg"
+  initials="MR"
+  alt="Maria Rodriguez"
+  size="base"
+></s-avatar>

package/src/surfaces/admin/components/Avatar/examples/with-section-component.html

@@ -0,0 +1,17 @@
+<s-section>
+  <s-stack gap="base">
+    <s-stack direction="inline" gap="small">
+      <s-avatar
+        src="/merchants/premium-store.jpg"
+        initials="PS"
+        alt="Premium store"
+        size="base"
+      ></s-avatar>
+      <s-stack gap="small-400">
+        <s-heading>Premium store</s-heading>
+        <s-text color="subdued">Shopify Plus merchant</s-text>
+      </s-stack>
+    </s-stack>
+    <s-text>Monthly revenue: $45,000</s-text>
+  </s-stack>
+</s-section>

package/src/surfaces/admin/components/Badge/examples/different-sizes-for-emphasis.html

@@ -0,0 +1,4 @@
+<s-stack direction="inline" gap="base">
+  <s-badge size="base">New</s-badge>
+  <s-badge size="large">Attention needed</s-badge>
+</s-stack>

package/src/surfaces/admin/components/Badge/examples/order-status-badges.html

@@ -0,0 +1,6 @@
+<s-stack direction="inline" gap="base">
+  <s-badge tone="success">Fulfilled</s-badge>
+  <s-badge tone="warning">Partially fulfilled</s-badge>
+  <s-badge tone="neutral">Unfulfilled</s-badge>
+  <s-badge tone="critical">Cancelled</s-badge>
+</s-stack>

package/src/surfaces/admin/components/Badge/examples/status-indicators-with-icons.html

@@ -0,0 +1,15 @@
+<s-stack gap="base">
+  <!-- Product status -->
+  <s-stack direction="inline" gap="base">
+    <s-badge tone="success" icon="view">Active</s-badge>
+    <s-badge tone="warning" icon="clock">Scheduled</s-badge>
+    <s-badge tone="critical">Archived</s-badge>
+  </s-stack>
+
+  <!-- Inventory status -->
+  <s-stack direction="inline" gap="base">
+    <s-badge tone="success">In stock</s-badge>
+    <s-badge tone="warning" icon="alert-triangle">Low stock</s-badge>
+    <s-badge tone="critical">Out of stock</s-badge>
+  </s-stack>
+</s-stack>

package/src/surfaces/admin/components/Badge/examples/within-table-context.html

@@ -0,0 +1,18 @@
+<s-table>
+  <s-table-header-row>
+    <s-table-header>Order</s-table-header>
+    <s-table-header>Fulfillment</s-table-header>
+    <s-table-header>Payment</s-table-header>
+  </s-table-header-row>
+  <s-table-body>
+    <s-table-row>
+      <s-table-cell>#1001</s-table-cell>
+      <s-table-cell>
+        <s-badge tone="success">Fulfilled</s-badge>
+      </s-table-cell>
+      <s-table-cell>
+        <s-badge tone="success">Paid</s-badge>
+      </s-table-cell>
+    </s-table-row>
+  </s-table-body>
+</s-table>

package/src/surfaces/admin/components/Chip/examples/basic-usage.html

@@ -0,0 +1,3 @@
+<s-chip color="base" accessibilityLabel="Product status indicator">
+  Active
+</s-chip>

package/src/surfaces/admin/components/Chip/examples/color-variants.html

@@ -0,0 +1,12 @@
+<s-stack direction="inline" gap="base">
+  <s-chip color="subdued" accessibilityLabel="Secondary information">
+    Draft
+  </s-chip>
+  <s-chip color="base" accessibilityLabel="Standard information">
+    Published
+  </s-chip>
+  <s-chip color="strong" accessibilityLabel="Important status">
+    <s-icon slot="graphic" type="check" size="small"></s-icon>
+    Verified
+  </s-chip>
+</s-stack>

package/src/surfaces/admin/components/Chip/examples/product-status.html

@@ -0,0 +1,8 @@
+<s-stack direction="inline" gap="base">
+  <s-chip color="base" accessibilityLabel="Product status">Active</s-chip>
+  <s-chip color="subdued" accessibilityLabel="Product status">Draft</s-chip>
+  <s-chip color="strong" accessibilityLabel="Product status">
+    <s-icon slot="graphic" type="check" size="small"></s-icon>
+    Published
+  </s-chip>
+</s-stack>

package/src/surfaces/admin/components/Chip/examples/text-truncation.html

@@ -0,0 +1,12 @@
+<s-box maxInlineSize="200px">
+  <s-stack gap="base">
+    <s-chip color="base" accessibilityLabel="Long product name">
+      This is a very long product name that will be truncated with ellipsis when
+      it exceeds the container width
+    </s-chip>
+    <s-chip color="strong" accessibilityLabel="Long category name">
+      <s-icon slot="graphic" type="catalog-product" size="small"></s-icon>
+      Electronics and computer accessories category with extended description
+    </s-chip>
+  </s-stack>
+</s-box>

package/src/surfaces/admin/components/Chip/examples/with-icon-graphic.html

@@ -0,0 +1,4 @@
+<s-chip color="strong" accessibilityLabel="Product category">
+  <s-icon slot="graphic" type="catalog-product" size="small"></s-icon>
+  Electronics
+</s-chip>

package/src/surfaces/admin/components/Heading/examples/basic-heading.html

@@ -0,0 +1 @@
+<s-heading>Product details</s-heading>

package/src/surfaces/admin/components/Heading/examples/heading-with-custom-accessibility.html

@@ -0,0 +1,3 @@
+<s-heading accessibilityRole="presentation" accessibilityVisibility="hidden">
+  Sale badge
+</s-heading>

package/src/surfaces/admin/components/Heading/examples/heading-with-line-clamping.html

@@ -0,0 +1,5 @@
+<s-box inlineSize="200px">
+  <s-heading lineClamp="2">
+    Premium organic cotton t-shirt with sustainable manufacturing practices
+  </s-heading>
+</s-box>

package/src/surfaces/admin/components/Heading/examples/heading-within-section-hierarchy.html

@@ -0,0 +1,12 @@
+<s-section>
+  <s-heading>Order information</s-heading>
+  <!-- Renders as h2 -->
+  <s-section>
+    <s-heading>Shipping details</s-heading>
+    <!-- Renders as h3 -->
+    <s-section>
+      <s-heading>Tracking updates</s-heading>
+      <!-- Renders as h4 -->
+    </s-section>
+  </s-section>
+</s-section>

package/src/surfaces/admin/components/Icon/examples/basic-usage.html

@@ -0,0 +1,7 @@
+<s-stack direction="inline" gap="base">
+  <s-icon type="home"></s-icon>
+  <s-icon type="edit"></s-icon>
+  <s-icon type="duplicate"></s-icon>
+  <s-icon type="save"></s-icon>
+  <s-icon type="export"></s-icon>
+</s-stack>

package/src/surfaces/admin/components/Icon/examples/in-badge-components.html

@@ -0,0 +1,4 @@
+<s-stack direction="inline" gap="base">
+  <s-badge tone="success" icon="check-circle">Active</s-badge>
+  <s-badge tone="warning" icon="alert-triangle">Pending</s-badge>
+</s-stack>

package/src/surfaces/admin/components/Icon/examples/in-button-components.html

@@ -0,0 +1,6 @@
+<s-button-group>
+  <s-button slot="secondary-actions" icon="plus">Add product</s-button>
+  <s-button slot="secondary-actions" icon="delete" tone="critical">
+    Delete
+  </s-button>
+</s-button-group>

package/src/surfaces/admin/components/Icon/examples/small-size.html

@@ -0,0 +1 @@
+<s-icon type="search" size="small"></s-icon>

package/src/surfaces/admin/components/Icon/examples/subdued-color.html

@@ -0,0 +1 @@
+<s-icon type="question-circle" color="subdued"></s-icon>

package/src/surfaces/admin/components/Icon/examples/with-id-property.html

@@ -0,0 +1 @@
+<s-icon type="settings" id="settings-icon"></s-icon>

package/src/surfaces/admin/components/Icon/examples/with-interest-relationship.html

@@ -0,0 +1 @@
+<s-icon type="delete" tone="critical" interestFor="delete-button-1"></s-icon>

package/src/surfaces/admin/components/Icon/examples/with-semantic-tone.html

@@ -0,0 +1,6 @@
+<s-stack direction="inline" gap="base">
+  <s-icon type="alert-circle" tone="warning"></s-icon>
+  <s-icon type="check-circle" tone="success"></s-icon>
+  <s-icon type="info" tone="info"></s-icon>
+  <s-icon type="alert-triangle" tone="caution"></s-icon>
+</s-stack>

package/src/surfaces/admin/components/Image/examples/auto-sized-image.html

@@ -0,0 +1,5 @@
+<s-image
+  src="/images/product.webp"
+  alt="Product image"
+  inlineSize="auto"
+></s-image>

package/src/surfaces/admin/components/Image/examples/basic-usage.html

@@ -0,0 +1 @@
+<s-image src="/images/product.webp" alt="Product image"></s-image>

package/src/surfaces/admin/components/Image/examples/decorative-image.html

@@ -0,0 +1,7 @@
+<!-- This image will be ignored by screen readers -->
+<s-image
+  src="/images/product.webp"
+  alt=""
+  accessibilityRole="presentation"
+  objectFit="cover"
+></s-image>

package/src/surfaces/admin/components/Image/examples/responsive-images-with-srcset.html

@@ -0,0 +1,9 @@
+<s-image
+  src="/images/product.webp"
+  srcSet="/images/product.webp 400w,
+          /images/product.webp 800w"
+  sizes="(max-width: 600px) 100vw, (max-width: 1200px) 50vw, 400px"
+  alt="Product detail"
+  aspectRatio="16/9"
+  objectFit="cover"
+></s-image>

package/src/surfaces/admin/components/Image/examples/responsive-layout-with-aspect-ratio.html

@@ -0,0 +1,7 @@
+<s-image
+  src="/images/product.webp"
+  alt="Featured product"
+  aspectRatio="16/9"
+  objectFit="cover"
+  loading="lazy"
+></s-image>

package/src/surfaces/admin/components/Image/examples/with-border-styling.html

@@ -0,0 +1,12 @@
+<s-box inlineSize="300px">
+  <s-image
+    src="/images/product.webp"
+    alt="Product thumbnail"
+    borderWidth="large"
+    borderStyle="solid"
+    borderColor="strong"
+    borderRadius="large"
+    objectFit="cover"
+    aspectRatio="1/1"
+  ></s-image>
+</s-box>

package/src/surfaces/admin/components/Image/examples/within-layout-components.html

@@ -0,0 +1,26 @@
+<s-grid gridTemplateColumns="repeat(3, 150px)" gap="base" alignItems="center">
+  <s-image
+    src="/images/product.webp"
+    alt="Main view"
+    aspectRatio="1/1"
+    objectFit="cover"
+    borderRadius="base"
+    inlineSize="fill"
+  ></s-image>
+  <s-image
+    src="/images/product.webp"
+    alt="Side view"
+    aspectRatio="1/1"
+    objectFit="cover"
+    borderRadius="base"
+    inlineSize="fill"
+  ></s-image>
+  <s-image
+    src="/images/product.webp"
+    alt="Detail view"
+    aspectRatio="1/1"
+    objectFit="cover"
+    borderRadius="base"
+    inlineSize="fill"
+  ></s-image>
+</s-grid>

package/src/surfaces/admin/components/Paragraph/examples/admin-ui-patterns.html

@@ -0,0 +1,21 @@
+<s-section>
+  <s-paragraph tone="success" color="base">
+    Payment successfully processed and order confirmed.
+  </s-paragraph>
+
+  <s-paragraph tone="warning" color="base">
+    Inventory levels are running low for this product.
+  </s-paragraph>
+
+  <s-paragraph tone="critical" color="base">
+    This order requires immediate attention due to shipping delays.
+  </s-paragraph>
+
+  <s-paragraph tone="info" color="base">
+    Customer requested gift wrapping for this order.
+  </s-paragraph>
+
+  <s-paragraph tone="caution" color="base">
+    Review shipping address before processing.
+  </s-paragraph>
+</s-section>

package/src/surfaces/admin/components/Paragraph/examples/basic-usage.html

@@ -0,0 +1,3 @@
+<s-paragraph>
+  Track inventory across all your retail locations in real-time.
+</s-paragraph>

package/src/surfaces/admin/components/Paragraph/examples/line-clamping.html

@@ -0,0 +1,8 @@
+<s-box inlineSize="300px">
+  <s-paragraph lineClamp="1">
+    Premium organic cotton t-shirt featuring sustainable manufacturing
+    processes, ethically sourced materials, and carbon-neutral shipping.
+    Available in multiple colors and sizes with customization options for your
+    brand.
+  </s-paragraph>
+</s-box>

package/src/surfaces/admin/components/Paragraph/examples/rtl-support.html

@@ -0,0 +1 @@
+<s-paragraph dir="rtl">محتوى النص باللغة العربية</s-paragraph>

package/src/surfaces/admin/components/Paragraph/examples/screen-reader-text.html

@@ -0,0 +1,3 @@
+<s-paragraph accessibilityVisibility="exclusive">
+  Table sorted by date, newest first.
+</s-paragraph>

package/src/surfaces/admin/components/Paragraph/examples/tabular-numbers.html

@@ -0,0 +1,3 @@
+<s-paragraph fontVariantNumeric="tabular-nums">
+  Orders: 1,234 Revenue: $45,678.90 Customers: 890
+</s-paragraph>

package/src/surfaces/admin/components/Paragraph/examples/with-tone-and-color.html

@@ -0,0 +1,9 @@
+<s-section>
+  <s-paragraph tone="info" color="base">
+    Your order will be processed within 2-3 business days.
+  </s-paragraph>
+
+  <s-paragraph tone="success" color="subdued">
+    Payment successfully processed.
+  </s-paragraph>
+</s-section>

package/src/surfaces/admin/components/Text/examples/accessibility-hidden-text.html

@@ -0,0 +1 @@
+<s-text accessibility-visibility="exclusive">Product prices include tax</s-text>

package/src/surfaces/admin/components/Text/examples/basic-usage.html

@@ -0,0 +1 @@
+<s-text>Manage your products and inventory from one dashboard.</s-text>

package/src/surfaces/admin/components/Text/examples/interest-for-association.html

@@ -0,0 +1,6 @@
+<s-tooltip id="sku-tooltip">
+  SKU must be unique across all products and cannot be changed after creation
+</s-tooltip>
+<s-text color="subdued" interestFor="sku-tooltip">
+  What is a product SKU?
+</s-text>

package/src/surfaces/admin/components/Text/examples/right-to-left-text.html

@@ -0,0 +1 @@
+<s-text dir="rtl">محتوى النص باللغة العربية</s-text>

package/src/surfaces/admin/components/Text/examples/semantic-address.html

@@ -0,0 +1 @@
+<s-text type="address">123 Commerce Street, Toronto, ON M5V 2H1</s-text>

package/src/surfaces/admin/components/Text/examples/status-tones.html

@@ -0,0 +1,5 @@
+<s-stack gap="small">
+  <s-text tone="success">Order fulfilled</s-text>
+  <s-text tone="critical">Payment failed</s-text>
+  <s-text tone="warning">Low inventory</s-text>
+</s-stack>

package/src/surfaces/admin/components/Text/examples/strong-text.html

@@ -0,0 +1 @@
+<s-text type="strong">Free shipping on orders over $50</s-text>

package/src/surfaces/admin/components/Text/examples/subdued-color.html

@@ -0,0 +1 @@
+<s-text color="subdued">Last updated 2 hours ago</s-text>

package/src/surfaces/admin/components/Text/examples/tabular-numbers.html

@@ -0,0 +1 @@
+<s-text fontVariantNumeric="tabular-nums">$1,234.56</s-text>

package/src/surfaces/admin/components/Thumbnail/examples/basic-usage.html

@@ -0,0 +1,5 @@
+<s-thumbnail
+  src="https://fakestoreapi.com/img/61U7T1koQqL._AC_SX679_t.png"
+  alt="Product preview"
+  size="base"
+></s-thumbnail>

package/src/surfaces/admin/components/Thumbnail/examples/different-sizes.html

@@ -0,0 +1,17 @@
+<s-stack gap="large-100">
+  <s-thumbnail
+    src="https://fakestoreapi.com/img/61U7T1koQqL._AC_SX679_t.png"
+    alt="Small thumbnail"
+    size="small-200"
+  ></s-thumbnail>
+  <s-thumbnail
+    src="https://fakestoreapi.com/img/61U7T1koQqL._AC_SX679_t.png"
+    alt="Base thumbnail"
+    size="base"
+  ></s-thumbnail>
+  <s-thumbnail
+    src="https://fakestoreapi.com/img/61U7T1koQqL._AC_SX679_t.png"
+    alt="Large thumbnail"
+    size="large"
+  ></s-thumbnail>
+</s-stack>

package/src/surfaces/admin/components/Thumbnail/examples/empty-state.html

@@ -0,0 +1 @@
+<s-thumbnail alt="No image available" size="base"></s-thumbnail>

package/src/surfaces/admin/components/Thumbnail/examples/with-event-handling.html

@@ -0,0 +1,6 @@
+<!-- Event handlers can be attached via JavaScript -->
+<s-thumbnail
+  src="https://fakestoreapi.com/img/61U7T1koQqL._AC_SX679_t.png"
+  alt="Product"
+  size="base"
+></s-thumbnail>

package/src/surfaces/admin/docs-types.ts

@@ -2,23 +2,44 @@ import type {CSSProperties} from 'react';
 import {
   ReferenceEntityTemplateSchema,
   CodeTabType,
+  ExampleType,
+  ExampleSectionSchema,
+  ExampleGroupType,
 } from '@shopify/generate-docs';
 
 // Don't allow all CSS properties to be used in the customStyles property
 type AllowedCSSProperties = Pick<CSSProperties, 'minHeight' | 'minBlockSize'>;
 
+type AdminCodeTabType = CodeTabType & {
+  layout?: string;
+  customStyles?: AllowedCSSProperties;
+};
+
+interface CodeLinkType {
+  name: string;
+  url: string;
+  icon: string;
+}
+
+interface AdminCodeblockType {
+  title: string;
+  tabs: AdminCodeTabType[];
+  links?: CodeLinkType[];
+}
+
+type AdminExampleType = Omit<ExampleType, 'codeblock'> & {
+  codeblock: AdminCodeblockType | AdminCodeblockType[];
+};
+
+type AdminExampleGroupType = Omit<ExampleGroupType, 'examples'> & {
+  examples: AdminExampleType[];
+};
+
 export interface AdminReferenceEntityTemplateSchema
-  extends Omit<ReferenceEntityTemplateSchema, 'defaultExample'> {
-  defaultExample?: Omit<
-    NonNullable<ReferenceEntityTemplateSchema['defaultExample']>,
-    'codeblock'
-  > & {
-    codeblock?: {
-      title: string;
-      tabs: (CodeTabType & {
-        layout?: string;
-        customStyles?: AllowedCSSProperties;
-      })[];
-    };
+  extends Omit<ReferenceEntityTemplateSchema, 'defaultExample' | 'examples'> {
+  defaultExample?: AdminExampleType;
+  examples?: Omit<ExampleSectionSchema, 'exampleGroups' | 'examples'> & {
+    exampleGroups?: AdminExampleGroupType[] | null;
+    examples?: AdminExampleType[] | null;
   };
 }

package/src/surfaces/customer-account/api/standard-api/standard-api.ts

@@ -111,7 +111,7 @@ export interface StandardApi<Target extends ExtensionTarget = ExtensionTarget> {
    *
    * - Use noun + past tense verb format. For example, \`Changes saved\`.
    *
-   * For errors, or information that needs to persist on the page, use a [banner](/docs/api/checkout-ui-extensions/unstable/components/feedback/banner) component.
+   * For errors, or information that needs to persist on the page, use a [banner](/docs/api/checkout-ui-extensions/polaris-web-components/feedback/banner) component.
    */
   toast: ToastApi;
 

package/src/surfaces/point-of-sale/api/navigation-api/navigation-api.ts

@@ -21,16 +21,6 @@ export interface NavigationHistoryEntry {
   getState(): unknown;
 }
 
-/**
- * The NavigationCurrentEntryChangeEvent interface of the Navigation API is the event object for the currententrychange event, which fires when the Navigation.currentEntry has changed.
- */
-export interface NavigationCurrentEntryChangeEvent {
-  /**
-   * Returns the NavigationHistoryEntry that was navigated from.
-   */
-  from: NavigationHistoryEntry;
-}
-
 export interface Navigation {
   /**
    * The navigate() method navigates to a specific URL, updating any provided state in the history entries list.
@@ -44,12 +34,4 @@ export interface Navigation {
    * The back() method of the Navigation interface navigates to the previous entry in the history list.
    */
   back(): void;
-  addEventListener(
-    type: 'currententrychange',
-    cb: (event: NavigationCurrentEntryChangeEvent) => void,
-  ): void;
-  removeEventListener(
-    type: 'currententrychange',
-    cb: (event: NavigationCurrentEntryChangeEvent) => void,
-  ): void;
 }