@shopify/ui-extensions 2026.7.0-rc.7 → 2026.7.0

package/src/surfaces/admin/components.d.ts

@@ -5413,7 +5413,7 @@ export interface BoxProps
    *
    * **Examples:** `base`, `large none`, `base large-100 base small`
    *
-   * Use `auto` to inherit padding from the nearest container with removed padding. Also accepts a [responsive value](/docs/api/polaris/using-web-components#responsive-values) string with the supported `PaddingKeyword` as a query value.
+   * Use `auto` to inherit padding from the nearest container with removed padding. Also accepts a [responsive value](/docs/api/polaris/using-polaris-web-components#responsive-values) string with the supported `PaddingKeyword` as a query value.
    *
    * @default 'none'
    */
@@ -5425,7 +5425,7 @@ export interface BoxProps
    *
    * **Example:** `large none` applies `large` to the top and `none` to the bottom.
    *
-   * Overrides the block value from `padding`. Also accepts a [responsive value](/docs/api/polaris/using-web-components#responsive-values) string with the supported `PaddingKeyword` as a query value.
+   * Overrides the block value from `padding`. Also accepts a [responsive value](/docs/api/polaris/using-polaris-web-components#responsive-values) string with the supported `PaddingKeyword` as a query value.
    *
    * @default '' - meaning no override
    */
@@ -5433,7 +5433,7 @@ export interface BoxProps
   /**
    * The block-start padding (top in horizontal writing modes).
    *
-   * Overrides the block-start value from `paddingBlock`. Also accepts a [responsive value](/docs/api/polaris/using-web-components#responsive-values) string with the supported `PaddingKeyword` as a query value.
+   * Overrides the block-start value from `paddingBlock`. Also accepts a [responsive value](/docs/api/polaris/using-polaris-web-components#responsive-values) string with the supported `PaddingKeyword` as a query value.
    *
    * @default '' - meaning no override
    */
@@ -5441,7 +5441,7 @@ export interface BoxProps
   /**
    * The block-end padding (bottom in horizontal writing modes).
    *
-   * Overrides the block-end value from `paddingBlock`. Also accepts a [responsive value](/docs/api/polaris/using-web-components#responsive-values) string with the supported `PaddingKeyword` as a query value.
+   * Overrides the block-end value from `paddingBlock`. Also accepts a [responsive value](/docs/api/polaris/using-polaris-web-components#responsive-values) string with the supported `PaddingKeyword` as a query value.
    *
    * @default '' - meaning no override
    */
@@ -5453,7 +5453,7 @@ export interface BoxProps
    *
    * **Example:** `large none` applies `large` to the left and `none` to the right.
    *
-   * Overrides the inline value from `padding`. Also accepts a [responsive value](/docs/api/polaris/using-web-components#responsive-values) string with the supported `PaddingKeyword` as a query value.
+   * Overrides the inline value from `padding`. Also accepts a [responsive value](/docs/api/polaris/using-polaris-web-components#responsive-values) string with the supported `PaddingKeyword` as a query value.
    *
    * @default '' - meaning no override
    */
@@ -5461,7 +5461,7 @@ export interface BoxProps
   /**
    * The inline-start padding (left in LTR writing modes, right in RTL).
    *
-   * Overrides the inline-start value from `paddingInline`. Also accepts a [responsive value](/docs/api/polaris/using-web-components#responsive-values) string with the supported `PaddingKeyword` as a query value.
+   * Overrides the inline-start value from `paddingInline`. Also accepts a [responsive value](/docs/api/polaris/using-polaris-web-components#responsive-values) string with the supported `PaddingKeyword` as a query value.
    *
    * @default '' - meaning no override
    */
@@ -5469,7 +5469,7 @@ export interface BoxProps
   /**
    * The inline-end padding (right in LTR writing modes, left in RTL).
    *
-   * Overrides the inline-end value from `paddingInline`. Also accepts a [responsive value](/docs/api/polaris/using-web-components#responsive-values) string with the supported `PaddingKeyword` as a query value.
+   * Overrides the inline-end value from `paddingInline`. Also accepts a [responsive value](/docs/api/polaris/using-polaris-web-components#responsive-values) string with the supported `PaddingKeyword` as a query value.
    *
    * @default '' - meaning no override
    */
@@ -6871,9 +6871,9 @@ export interface GridProps
    * Adjusts spacing between elements.
    *
    * Accepts:
-   * - A single [`SpacingKeyword`](/docs/api/polaris/using-web-components#scale) value applied to both axes, such as `large-100`
+   * - A single [`SpacingKeyword`](/docs/api/polaris/using-polaris-web-components#scale) value applied to both axes, such as `large-100`
    * - A pair of values, such as `large-100 large-500`, to set the inline and block axes respectively
-   * - A [responsive value](/docs/api/polaris/using-web-components#responsive-values) string with the supported SpacingKeyword as a query value
+   * - A [responsive value](/docs/api/polaris/using-polaris-web-components#responsive-values) string with the supported SpacingKeyword as a query value
    *
    * @default 'none'
    */
@@ -6882,8 +6882,8 @@ export interface GridProps
    * s spacing between elements in the block axis. This overrides the row value of `gap`.
    *
    * Accepts:
-   * - A single [`SpacingKeyword`](/docs/api/polaris/using-web-components#scale) value, such as `large-100`
-   * - A [responsive value](/docs/api/polaris/using-web-components#responsive-values) string with the supported SpacingKeyword as a query value
+   * - A single [`SpacingKeyword`](/docs/api/polaris/using-polaris-web-components#scale) value, such as `large-100`
+   * - A [responsive value](/docs/api/polaris/using-polaris-web-components#responsive-values) string with the supported SpacingKeyword as a query value
    *
    * @default '' - meaning no override
    */
@@ -6892,8 +6892,8 @@ export interface GridProps
    * Adjusts spacing between elements in the inline axis. This overrides the column value of `gap`.
    *
    * Accepts:
-   * - A single [`SpacingKeyword`](/docs/api/polaris/using-web-components#scale) value, such as `large-100`
-   * - A [responsive value](/docs/api/polaris/using-web-components#responsive-values) string with the supported SpacingKeyword as a query value
+   * - A single [`SpacingKeyword`](/docs/api/polaris/using-polaris-web-components#scale) value, such as `large-100`
+   * - A [responsive value](/docs/api/polaris/using-polaris-web-components#responsive-values) string with the supported SpacingKeyword as a query value
    *
    * @default '' - meaning no override
    */
@@ -6903,7 +6903,7 @@ export interface GridProps
    *
    * Accepts:
    * - [Track sizing values](https://developer.mozilla.org/en-US/docs/Web/CSS/CSS_grid_layout/Basic_concepts_of_grid_layout#fixed_and_flexible_track_sizes), such as `1fr auto`
-   * - A [responsive value](/docs/api/polaris/using-web-components#responsive-values) string with the supported track sizing values as a query value
+   * - A [responsive value](/docs/api/polaris/using-polaris-web-components#responsive-values) string with the supported track sizing values as a query value
    *
    * @default 'none'
    */
@@ -6913,7 +6913,7 @@ export interface GridProps
    *
    * Accepts:
    * - [Track sizing values](https://developer.mozilla.org/en-US/docs/Web/CSS/CSS_grid_layout/Basic_concepts_of_grid_layout#fixed_and_flexible_track_sizes), such as `1fr auto`
-   * - A [responsive value](/docs/api/polaris/using-web-components#responsive-values) string with the supported track sizing values as a query value
+   * - A [responsive value](/docs/api/polaris/using-polaris-web-components#responsive-values) string with the supported track sizing values as a query value
    *
    * @default 'none'
    */
@@ -8388,9 +8388,9 @@ export interface StackProps
    * Adjusts spacing between elements.
    *
    * Accepts:
-   * - A single [`SpacingKeyword`](/docs/api/polaris/using-web-components#scale) value applied to both axes, such as `large-100`
+   * - A single [`SpacingKeyword`](/docs/api/polaris/using-polaris-web-components#scale) value applied to both axes, such as `large-100`
    * - A pair of values, such as `large-100 large-500`, to set the inline and block axes respectively
-   * - A [responsive value](/docs/api/polaris/using-web-components#responsive-values) string with the supported SpacingKeyword as a query value
+   * - A [responsive value](/docs/api/polaris/using-polaris-web-components#responsive-values) string with the supported SpacingKeyword as a query value
    *
    * @default 'none'
    */
@@ -8399,8 +8399,8 @@ export interface StackProps
    * Adjusts spacing between elements in the block axis. This overrides the row value of `gap`.
    *
    * Accepts:
-   * - A single [`SpacingKeyword`](/docs/api/polaris/using-web-components#scale) value, such as `large-100`
-   * - A [responsive value](/docs/api/polaris/using-web-components#responsive-values) string with the supported SpacingKeyword as a query value
+   * - A single [`SpacingKeyword`](/docs/api/polaris/using-polaris-web-components#scale) value, such as `large-100`
+   * - A [responsive value](/docs/api/polaris/using-polaris-web-components#responsive-values) string with the supported SpacingKeyword as a query value
    *
    * @default '' - meaning no override
    */
@@ -8409,8 +8409,8 @@ export interface StackProps
    * Adjusts spacing between elements in the inline axis. This overrides the column value of `gap`.
    *
    * Accepts:
-   * - A single [`SpacingKeyword`](/docs/api/polaris/using-web-components#scale) value, such as `large-100`
-   * - A [responsive value](/docs/api/polaris/using-web-components#responsive-values) string with the supported SpacingKeyword as a query value
+   * - A single [`SpacingKeyword`](/docs/api/polaris/using-polaris-web-components#scale) value, such as `large-100`
+   * - A [responsive value](/docs/api/polaris/using-polaris-web-components#responsive-values) string with the supported SpacingKeyword as a query value
    *
    * @default '' - meaning no override
    */
@@ -8420,7 +8420,7 @@ export interface StackProps
    *
    * Accepts:
    * - A single value, either `inline` or `block`
-   * - A [responsive value](/docs/api/polaris/using-web-components#responsive-values) string with the supported direction values as a query value
+   * - A [responsive value](/docs/api/polaris/using-polaris-web-components#responsive-values) string with the supported direction values as a query value
    *
    * @default 'block'
    *

package/src/surfaces/checkout/api/shipping/shipping-option-item.ts

@@ -23,17 +23,22 @@ export interface ShippingOptionItemApi {
 
   /**
    * The render mode of this shipping option, indicating how the extension is displayed in the checkout UI.
+   *
+   * @deprecated Do not rely on render context. This target can render inside an overlay, so use inline UI instead of opening overlays such as modals.
    */
   renderMode: ShippingOptionItemRenderMode;
 }
 
 /**
  * The render mode of a shipping option.
+ *
  * @publicDocs
  */
 export interface ShippingOptionItemRenderMode {
   /**
    * Whether the shipping option is rendered in an overlay. When `true`, the extension appears in a modal or sheet on top of the checkout page. When `false`, the extension renders inline within the shipping options list.
+   *
+   * @deprecated Do not rely on render context. Use inline UI instead of opening overlays such as modals.
    */
   overlay: boolean;
 }

package/src/surfaces/checkout/api/standard/standard.ts

@@ -486,6 +486,9 @@ export interface BuyerJourney {
    * either by passing validation errors to the checkout UI or rendering the errors in your extension.
    *
    * If the merchant hasn't allowed your extension to block checkout progress, show a warning in the [checkout editor](https://shopify.dev/docs/apps/build/checkout/test-checkout-ui-extensions#test-the-extension-in-the-checkout-editor).
+   *
+   * @deprecated Use a cart and checkout validation function instead. The buyer
+   * journey intercept will be removed in a future version of the API.
    */
   intercept(interceptor: Interceptor): Promise<() => void>;
 
@@ -631,9 +634,6 @@ export interface StandardApi<Target extends ExtensionTarget = ExtensionTarget> {
 
   /**
    * Provides details on the buyer's progression through the checkout and lets you intercept navigation to validate data before the buyer continues.
-   *
-   * Refer to [buyer journey](https://shopify.dev/docs/api/checkout-ui-extensions/{API_VERSION}/apis/buyer-journey#examples)
-   * examples for more information.
    */
   buyerJourney: BuyerJourney;
 

package/src/surfaces/checkout/components/Chat.d.ts

@@ -10,11 +10,109 @@
 /// <reference lib="DOM" />
 import type {ChatProps$1} from './components-shared.d.ts';
 
+/**
+ * The base properties for elements that don't have children, providing essential attributes like keys and refs for component management.
+ */
+export interface BaseElementProps<TClass = HTMLElement> {
+    /**
+     * A unique identifier for this element within its parent. This is used by the rendering engine for efficient reconciliation when lists change.
+     */
+    key?: preact.Key;
+    /**
+     * A reference to the underlying DOM element, typically created using `useRef()`. This allows you to access and manipulate the DOM element directly in your component logic.
+     */
+    ref?: preact.Ref<TClass>;
+    /**
+     * Assigns the element to a named slot in a parent component that uses slot-based composition patterns.
+     */
+    slot?: Lowercase<string>;
+}
+/**
+ * The base properties for elements that have children, extending `BaseElementProps` with children support.
+ * @publicDocs
+ */
+export interface BaseElementPropsWithChildren<TClass = HTMLElement> extends BaseElementProps<TClass> {
+    /**
+     * The child elements to render within this component.
+     */
+    children?: preact.ComponentChildren;
+}
+/**
+ * An event type that narrows the `currentTarget` to the specific HTML element associated with the custom element tag. This provides type-safe event handling in callback listeners.
+ * @publicDocs
+ */
+export type CallbackEvent<TTagName extends keyof HTMLElementTagNameMap, TEvent extends Event = Event> = TEvent & {
+    currentTarget: HTMLElementTagNameMap[TTagName];
+};
+/**
+ * A typed event listener for custom element events. The listener receives a `CallbackEvent` with the correct `currentTarget` type for the associated custom element tag.
+ * @publicDocs
+ */
+export type CallbackEventListener<TTagName extends keyof HTMLElementTagNameMap, TData = object> = (EventListener & ((event: CallbackEvent<TTagName, Event> & TData) => void)) | null;
+
+declare const tagName = "s-chat";
 /** @publicDocs */
-export interface ChatProps extends Pick<ChatProps$1, 'accessibilityLabel' | 'blockSize' | 'id' | 'inlineSize' | 'onMessage' | 'onReady'> {
+export interface ChatElementProps extends Pick<ChatProps$1, 'accessibilityLabel' | 'blockSize' | 'id' | 'inlineSize'> {
+    /**
+     * A label that describes the purpose of the chat, announced by assistive technologies like screen readers.
+     */
+    accessibilityLabel?: ChatProps$1['accessibilityLabel'];
+    /**
+     * Adjust the block size.
+     *
+     * Checkout imposes [sizing restrictions](/docs/apps/build/checkout/chat#component-states) for the component, therefore the size set may not be the actual size rendered.
+     *
+     * Learn more about [block size on MDN](https://developer.mozilla.org/en-US/docs/Web/CSS/block-size).
+     */
     blockSize?: Extract<ChatProps$1['blockSize'], `${number}px` | '0'>;
+    /**
+     * Adjust the inline size.
+     *
+     * Checkout imposes [sizing restrictions](/docs/apps/build/checkout/chat#component-states) for the component, therefore the size set may not be the actual size rendered.
+     *
+     * Learn more about [inline size on MDN](https://developer.mozilla.org/en-US/docs/Web/CSS/inline-size).
+     */
     inlineSize?: Extract<ChatProps$1['inlineSize'], `${number}px` | '0'>;
-    remoteMethods?: Record<string, (...args: unknown[]) => unknown>;
+}
+/**
+ * The event callbacks for monitoring the chat lifecycle.
+ */
+export interface ChatEvents extends Pick<ChatProps$1, 'onReady'> {
+}
+/** @publicDocs */
+export interface ChatElementEvents {
+    /**
+     * A callback that fires when the embedded page is ready and a message port has been created to communicate with the host page.
+     */
+    ready?: CallbackEventListener<typeof tagName>;
+}
+/** @publicDocs */
+export interface ChatElementMethods {
+    /**
+     * Returns an object exposing a `postMessage` method used to send messages to the embedded page rendered inside the chat iframe. Pair this with the `ready` event (or `onReady` callback) to know when the message channel is available.
+     */
+    readonly contentWindow: {
+        postMessage(message: any): void;
+    };
+}
+/** @publicDocs */
+export interface ChatElement extends ChatElementProps, ChatElementMethods, Omit<HTMLElement, 'id' | 'title'> {
+    onready: ChatEvents['onReady'];
+}
+/** @publicDocs */
+export interface ChatProps extends ChatElementProps, ChatEvents {
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        [tagName]: ChatElement;
+    }
+}
+declare module 'preact' {
+    namespace createElement.JSX {
+        interface IntrinsicElements {
+            [tagName]: ChatProps & BaseElementPropsWithChildren<ChatElement>;
+        }
+    }
 }
 
-export type { ChatProps };
+export type { ChatElement, ChatElementEvents, ChatElementMethods, ChatElementProps, ChatProps };

package/src/surfaces/checkout/preact/buyer-journey.ts

@@ -50,6 +50,9 @@ export function useBuyerJourneyCompleted<
  *
  * It is good practice to show a warning in the checkout editor when the merchant has not given permission for your extension
  * to block checkout progress.
+ *
+ * @deprecated Use a cart and checkout validation function instead. The buyer
+ * journey intercept will be removed in a future version of the API.
  * @publicDocs
  */
 export function useBuyerJourneyIntercept<

package/src/surfaces/checkout/preact/shipping-option-target.ts

@@ -17,6 +17,9 @@ import {useSubscription} from './subscription';
 export function useShippingOptionTarget(): {
   shippingOptionTarget: ShippingOption;
   isTargetSelected: boolean;
+  /**
+   * @deprecated Do not rely on render context. This target can render inside an overlay, so use inline UI instead of opening overlays such as modals.
+   */
   renderMode: ShippingOptionItemRenderMode;
 } {
   const api = useApi<

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

@@ -1,5 +1,6 @@
 import type {ReadonlySignalLike} from '../../../../shared';
 import type {
+  AddLineItemOptions,
   Address,
   Cart,
   CartUpdateInput,
@@ -123,12 +124,19 @@ export interface MutableCartApiContent {
   /**
    * Add a product variant to the cart by its numeric `ID` with the specified quantity. Returns the `UUID` of the newly added line item, or an empty string if the user dismissed an oversell guard modal. Throws an error if POS fails to add the line item due to validation or system errors.
    *
+   * Pass `options` to attach line-item properties in the same operation, instead of following up with a separate `addLineItemProperties` call.
+   *
    * @param variantId the product variant's numeric ID to add to the cart
    * @param quantity the number of this variant to add to the cart
+   * @param options optional line-item properties to apply to the new line item in the same operation
    * @returns {string} the UUID of the line item added, or the empty string if the user dismissed an oversell guard modal
    * @throws {Error} if POS fails to add the line item
    */
-  addLineItem(variantId: number, quantity: number): Promise<string>;
+  addLineItem(
+    variantId: number,
+    quantity: number,
+    options?: AddLineItemOptions,
+  ): Promise<string>;
 
   /**
    * Remove a specific line item from the cart using its `UUID`. The line item will be completely removed from the cart along with any associated discounts, properties, or selling plans.

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

@@ -0,0 +1,11 @@
+import type {BackgroundShopifyGlobal} from '../globals';
+
+/**
+ * Methods available on the `shopify` global for app background extensions.
+ * @publicDocs
+ */
+export interface Docs_AppBackgroundEventMethods
+  extends Pick<
+    BackgroundShopifyGlobal,
+    'addEventListener' | 'removeEventListener'
+  > {}

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

@@ -1,5 +1,7 @@
 /**
  * The `PrintApi` object provides methods for triggering document printing. Access these methods through `shopify.print` to initiate print operations with various document types.
+ *
+ * @deprecated Use `shopify.printing` instead. The Printing API supersedes `shopify.print`, adding hardware printer discovery via `getPrinters()` and direct-to-printer printing via the `printer` option on `print()`.
  * @publicDocs
  */
 export interface PrintApiContent {
@@ -20,6 +22,8 @@ export interface PrintApiContent {
 
 /**
  * The `PrintApi` object provides methods for triggering document printing. Access these methods through `shopify.print` to initiate print operations with various document types.
+ *
+ * @deprecated Use `shopify.printing` instead. The Printing API supersedes `shopify.print`, adding hardware printer discovery via `getPrinters()` and direct-to-printer printing via the `printer` option on `print()`.
  * @publicDocs
  */
 export interface PrintApi {

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

@@ -0,0 +1,105 @@
+/**
+ * The Printing API provides methods for triggering document printing and
+ * discovering available hardware printers. Content is fetched from a URL
+ * and can be sent to a specific printer or to the system print dialog.
+ *
+ * Accessed via `shopify.printing`, aligning with the web platform's
+ * `navigator.printing` namespace from the WICG Web Printing proposal.
+ *
+ * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/Window/print | Window.print()}
+ *   for the web platform equivalent (no parameters, prints current document).
+ *   This API extends the concept with URL-based content and printer selection.
+ * @see {@link https://github.com/WICG/web-printing | WICG Web Printing} for the
+ *   emerging web standard for printer enumeration and job submission. This API
+ *   aligns with WICG's instance-level printer selection model.
+ * @publicDocs
+ */
+export interface PrintingApiContent {
+  /**
+   * Returns the list of hardware printers currently available to the
+   * device. Each printer includes its connection status and a reference
+   * that can be passed to `print()`.
+   *
+   * When no hardware printers are available, returns an empty array.
+   * The system print dialog is not included in this list — it is the
+   * default behavior when no `printer` option is provided to `print()`.
+   *
+   * @see {@link https://github.com/WICG/web-printing | WICG Web Printing}
+   *   for the emerging web standard this aligns with.
+   * @returns A promise that resolves with the list of available hardware printers.
+   */
+  getPrinters(): Promise<Printer[]>;
+
+  /**
+   * Triggers a print operation for the specified document source.
+   *
+   * When called without a `printer` option, opens the device's system
+   * print dialog (e.g., AirPrint on iOS, Android print service). When
+   * a `printer` reference is provided (from `getPrinters()`), sends
+   * the content directly to that printer without showing a dialog.
+   *
+   * The `src` parameter accepts either:
+   * - A relative path that will be appended to your app's [`application_url`](/docs/apps/build/cli-for-apps/app-configuration)
+   * - A full URL to your app's backend
+   *
+   * The content at the URL is fetched with the extension's session token
+   * for authentication. HTML, PDFs, and images are supported content types.
+   * PDFs can only be printed via the system print dialog: selecting a
+   * `printer` with a PDF `src` throws, because hardware (receipt) printers
+   * render HTML and image content only.
+   *
+   * @param src the source URL of the content to print.
+   * @param options optional configuration for the print operation.
+   * @returns A promise that resolves when the print job has been
+   *   successfully sent. For hardware printers, this means the rasterized
+   *   content has been dispatched — it does not wait for physical printing
+   *   to complete. For the system print dialog, this resolves when the
+   *   content is ready and the dialog appears.
+   * @throws {Error} when the content cannot be fetched from `src`.
+   * @throws {Error} when the specified `printer` is not connected.
+   * @throws {Error} when `src` is a PDF and a `printer` is selected, since
+   *   receipt printers render HTML and image content only.
+   */
+  print(src: string, options?: PrintOptions): Promise<void>;
+}
+
+/**
+ * Options for `shopify.printing.print()`.
+ * @publicDocs
+ */
+export interface PrintOptions {
+  /**
+   * A printer reference obtained from `getPrinters()`. When provided,
+   * the print job is sent directly to this printer without showing
+   * a system print dialog.
+   *
+   * When omitted, the system print dialog is shown, allowing the
+   * user to select a printer and configure print settings.
+   */
+  printer?: Printer;
+}
+
+/**
+ * A hardware printer available to the device, as returned by `shopify.printing.getPrinters()`.
+ * @publicDocs
+ */
+export interface Printer {
+  /** Unique identifier for this printer. */
+  id: string;
+
+  /** Human-readable display name (e.g., "Star TSP143" or "Front Counter Printer"). */
+  name: string;
+
+  /** Whether the printer is currently able to accept print jobs. */
+  connected: boolean;
+}
+
+/**
+ * The `PrintingApi` object provides methods for triggering document printing
+ * and discovering available hardware printers. Access these methods through
+ * `shopify.printing`.
+ * @publicDocs
+ */
+export interface PrintingApi {
+  printing: PrintingApiContent;
+}

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

@@ -6,7 +6,9 @@ import {LocaleApi} from '../locale-api/locale-api';
 import {SessionApi} from '../session-api/session-api';
 import {ToastApi} from '../toast-api/toast-api';
 import {ProductSearchApi} from '../product-search-api/product-search-api';
+// eslint-disable-next-line import/no-deprecated
 import {PrintApi} from '../print-api/print-api';
+import {PrintingApi} from '../printing-api/printing-api';
 import {StorageApi} from '../storage-api/storage-api';
 import {PinPadApi} from '../pin-pad-api';
 import type {I18n} from '../../../../api';
@@ -24,7 +26,9 @@ export type StandardApi<T> = {[key: string]: any} & {
   LocaleApi &
   ToastApi &
   SessionApi &
+  // eslint-disable-next-line import/no-deprecated
   PrintApi &
+  PrintingApi &
   ProductSearchApi &
   DeviceApi &
   ConnectivityApi &

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

@@ -65,6 +65,13 @@ export type {
 
 export type {PrintApi, PrintApiContent} from './api/print-api/print-api';
 
+export type {
+  PrintingApi,
+  PrintingApiContent,
+  PrintOptions,
+  Printer,
+} from './api/printing-api/printing-api';
+
 export type {
   PaginationParams,
   ProductSortType,
@@ -91,6 +98,7 @@ export type {ToastApiContent, ToastApi} from './api/toast-api/toast-api';
 
 // Type exports
 export type {
+  AddLineItemOptions,
   Cart,
   CartUpdateInput,
   Customer,
@@ -118,6 +126,8 @@ export type {
 
 export type {TaxLine} from './types/tax-line';
 
+export type {DiscountAllocation} from './types/discount-allocation';
+
 export type {PaymentMethod, Payment} from './types/payment';
 
 export type {MultipleResourceResult} from './types/multiple-resource-result';

package/src/surfaces/point-of-sale/components/QrCode.d.ts

@@ -45,7 +45,7 @@ export interface BaseElementPropsWithChildren<TClass = HTMLElement>
 export type IntrinsicElementProps<T> = T & BaseElementPropsWithChildren<T & HTMLElement>;
 
 declare const tagName = 's-qr-code';
-/** @publicDocs */
+/** @private */
 export interface QrCodeJSXProps extends Pick<QRCodeProps, 'id' | 'content'> {}
 declare global {
   interface HTMLElementTagNameMap {

package/src/surfaces/point-of-sale/components/components-shared.d.ts

@@ -2814,7 +2814,7 @@ export interface POSBlockProps
    */
   secondaryActions?: ComponentChildren;
 }
-/** @publicDocs */
+/** @private */
 export interface QRCodeProps extends GlobalProps {
   /**
    * Set the border of the QR code.

package/src/surfaces/point-of-sale/components/targets/ReceiptComponents.ts

@@ -1,4 +1,4 @@
 /**
- * @publicDocs
+ * @private
  */
 export type ReceiptComponents = 'PosBlock' | 'Text' | 'QrCode';

package/src/surfaces/point-of-sale/components/targets/StandardComponents.ts

@@ -25,8 +25,6 @@ export type StandardComponents =
   | 'Page'
   | 'POSBlock'
   | 'PosBlock' // Case is important in 2025-10
-  | 'QRCode'
-  | 'QrCode' // Case is important in 2025-10
   | 'Route'
   | 'Router'
   | 'ScrollBox'

package/src/surfaces/point-of-sale/components.d.ts

@@ -5274,6 +5274,7 @@ declare module 'preact' {
 }
 
 declare const tagName$4 = 's-tab-list';
+/** @publicDocs */
 interface TabListJSXProps extends Pick<TabListProps, 'children'> {
   children?: ComponentChildren;
 }

package/src/surfaces/point-of-sale/event/data/ExchangeTransactionData.ts

@@ -3,7 +3,8 @@ import {LineItem} from '../../types/cart';
 
 /**
  * Defines the data structure for completed exchange transactions.
- * @publicDocs
+ *
+ * @private
  */
 export interface ExchangeTransactionData extends BaseTransactionComplete {
   /**

package/src/surfaces/point-of-sale/event/data/ReprintReceiptData.ts

@@ -4,7 +4,8 @@ import {OrderLineItem} from '../../types/order';
 
 /**
  * Defines the data structure for receipt reprint requests.
- * @publicDocs
+ *
+ * @private
  */
 export interface ReprintReceiptData extends BaseTransactionComplete {
   /**

package/src/surfaces/point-of-sale/event/data/ReturnTransactionData.ts

@@ -3,7 +3,8 @@ import {LineItem} from '../../types/cart';
 
 /**
  * Defines the data structure for completed return transactions.
- * @publicDocs
+ *
+ * @private
  */
 export interface ReturnTransactionData extends BaseTransactionComplete {
   /**

package/src/surfaces/point-of-sale/event/data/SaleTransactionData.ts

@@ -3,7 +3,8 @@ import {LineItem} from '../../types/cart';
 
 /**
  * Defines the data structure for completed sale transactions.
- * @publicDocs
+ *
+ * @private
  */
 export interface SaleTransactionData extends BaseTransactionComplete {
   /**