@shopify/ui-extensions 2025.7.2 → 2025.7.4

package/build/cjs/surfaces/point-of-sale/render/components/Badge/Badge.js

@@ -4,13 +4,6 @@ Object.defineProperty(exports, '__esModule', { value: true });
 
 var core = require('@remote-ui/core');
 
-/**
- * @property text - The text displayed inside the badge.
- * @property variant - The appearance and function of the badge.
- * @property status - A circle icon displaying the status of the badge.
- * @deprecated status - No longer supported as of POS 10.0.0.
- */
-
 const Badge = core.createRemoteComponent('Badge');
 
 exports.Badge = Badge;

package/build/cjs/surfaces/point-of-sale/render/components/Banner/Banner.js

@@ -4,15 +4,6 @@ Object.defineProperty(exports, '__esModule', { value: true });
 
 var core = require('@remote-ui/core');
 
-/**
- * @property title - The title text displayed on the banner.
- * @property variant - The variant type of the banner.
- * @property action - The text for the action button.
- * @property onPress - The callback function executed when the banner is pressed.
- * @property hideAction - Whether to hide the action button.
- * @property visible - The visibility state of the banner.
- */
-
 const Banner = core.createRemoteComponent('Banner');
 
 exports.Banner = Banner;

package/build/cjs/surfaces/point-of-sale/render/components/Button/Button.js

@@ -4,14 +4,6 @@ Object.defineProperty(exports, '__esModule', { value: true });
 
 var core = require('@remote-ui/core');
 
-/**
- * @property `title` the text set on the `Button`.
- * @property `type` the type of `Button` to render. Determines the appearance of the button.
- * @property `onPress` the callback that is executed when the user taps the button.
- * @property `isDisabled` sets whether the `Button` can be tapped.
- * @property `isLoading` sets whether the `Button` is displaying an animated loading state.
- */
-
 const Button = core.createRemoteComponent('Button');
 
 exports.Button = Button;

package/build/cjs/surfaces/point-of-sale/render/components/CameraScanner/CameraScanner.js

@@ -4,12 +4,6 @@ Object.defineProperty(exports, '__esModule', { value: true });
 
 var core = require('@remote-ui/core');
 
-/**
- * @property title - The title of the banner.
- * @property variant - The appearance of the banner.
- * @property visible - The visibility state of the banner.
- */
-
 const CameraScanner = core.createRemoteComponent('CameraScanner');
 
 exports.CameraScanner = CameraScanner;

package/build/cjs/surfaces/point-of-sale/render/components/DatePicker/DatePicker.js

@@ -4,14 +4,6 @@ Object.defineProperty(exports, '__esModule', { value: true });
 
 var core = require('@remote-ui/core');
 
-/**
- * Represents the properties for the DatePicker component.
- * @property selected - The selected time.
- * @property onChange - A callback for changes.
- * @property visibleState - Control the visible state, and a callback to set the visible state as false when the dialog closes.
- * @property inputMode - Whether to display the picker in inline (clock) mode or spinner mode.
- */
-
 const DatePicker = core.createRemoteComponent('DatePicker');
 
 exports.DatePicker = DatePicker;

package/build/cjs/surfaces/point-of-sale/render/components/Dialog/Dialog.js

@@ -4,18 +4,6 @@ Object.defineProperty(exports, '__esModule', { value: true });
 
 var core = require('@remote-ui/core');
 
-/**
- * @property title - The text displayed in the title of the dialog.
- * @property content - The text displayed in the body of the dialog.
- * @property actionText - The text displayed in the primary action button of the dialog.
- * @property secondaryActionText - The text displayed in the secondary action section of the dialog.
- * @property showSecondaryAction - Whether a secondary action displays.
- * @property type - Determines the dialog’s appearance and function.
- * @property onAction - A callback that performs when the action is triggered.
- * @property onSecondaryAction - A callback that is executed when the secondary action is triggered.
- * @property isVisible - Whether the dialog should be presented.
- */
-
 const Dialog = core.createRemoteComponent('Dialog');
 
 exports.Dialog = Dialog;

package/build/cjs/surfaces/point-of-sale/render/components/Image/Image.js

@@ -5,9 +5,14 @@ Object.defineProperty(exports, '__esModule', { value: true });
 var core = require('@remote-ui/core');
 
 /**
- * FillResizeMode will apply formatting to the image to fill the container.
+ * Defines how images are resized and positioned within their containers. Controls image scaling, cropping, and aspect ratio handling.
  *
- * https://reactnative.dev/docs/image#resizemode
+ * Available resize modes:
+ * - `center`: Centers the image within its container without scaling. The image maintains its original size and is positioned in the center, potentially leaving empty space or being cropped if the container is smaller.
+ * - `contain`: Scales the image to fit entirely within the container while maintaining aspect ratio. The entire image will be visible, but there may be empty space if the aspect ratios don't match.
+ * - `cover`: Scales the image to fill the entire container while maintaining aspect ratio. Parts of the image may be cropped if the aspect ratios don't match, but the container will be completely filled.
+ * - `repeat`: Repeats the image to fill the container. The image maintains its original size and is tiled both horizontally and vertically to cover the entire container area.
+ * - `stretch`: Stretches the image to fill the container completely, potentially distorting the aspect ratio. The image will fill the entire container but may appear stretched or compressed.
  */
 
 const Image = core.createRemoteComponent('Image');

package/build/cjs/surfaces/point-of-sale/render/components/Navigator/Navigator.js

@@ -4,10 +4,6 @@ Object.defineProperty(exports, '__esModule', { value: true });
 
 var core = require('@remote-ui/core');
 
-/**
- * @property `initialScreenName` sets the initial `Screen` whose `name` matches.
- */
-
 const Navigator = core.createRemoteComponent('Navigator');
 
 exports.Navigator = Navigator;

package/build/cjs/surfaces/point-of-sale/render/components/NumberField/NumberField.js

@@ -4,12 +4,6 @@ Object.defineProperty(exports, '__esModule', { value: true });
 
 var core = require('@remote-ui/core');
 
-/**
- * Represents the properties for the NumberField component.
- * @typedef {Object} NumberFieldProps
- * @property {'decimal' | 'numeric'} [inputMode] - The mode of input, can be either 'decimal' or 'numeric'.
- */
-
 const NumberField = core.createRemoteComponent('NumberField');
 
 exports.NumberField = NumberField;

package/build/cjs/surfaces/point-of-sale/render/components/POSBlock/POSBlock.js

@@ -4,12 +4,6 @@ Object.defineProperty(exports, '__esModule', { value: true });
 
 var core = require('@remote-ui/core');
 
-/**
- * Renders a `POSBlock`. Note that the text displayed on this `POSBlock`
- * is dependent on the description of the extension. A `POSBlock` only
- * accepts `POSBlockRow` as children.
- */
-
 const POSBlock = core.createRemoteComponent('POSBlock');
 
 exports.POSBlock = POSBlock;

package/build/cjs/surfaces/point-of-sale/render/components/POSBlock/POSBlockRow.js

@@ -4,10 +4,6 @@ Object.defineProperty(exports, '__esModule', { value: true });
 
 var core = require('@remote-ui/core');
 
-/**
- * Renders a `POSBlockRow` in a `POSBlock`.
- */
-
 const POSBlockRow = core.createRemoteComponent('POSBlockRow');
 
 exports.POSBlockRow = POSBlockRow;

package/build/cjs/surfaces/point-of-sale/render/components/POSReceiptBlock/POSReceiptBlock.js

@@ -4,11 +4,6 @@ Object.defineProperty(exports, '__esModule', { value: true });
 
 var core = require('@remote-ui/core');
 
-/**
- * Renders a `POSReceiptBlock`. A `POSReceiptBlock` only accepts
- * `Text` and `QRCode` as children (more to be added in the future).
- */
-
 const POSReceiptBlock = core.createRemoteComponent('POSReceiptBlock');
 
 exports.POSReceiptBlock = POSReceiptBlock;

package/build/cjs/surfaces/point-of-sale/render/components/PinPad/PinPad.js

@@ -5,32 +5,28 @@ Object.defineProperty(exports, '__esModule', { value: true });
 var core = require('@remote-ui/core');
 
 /**
- * Represents the result of the pin pad onSubmit function.
- * @typedef {('accept'|'reject')} PinValidationResult
+ * Defines the validation result values that the `onSubmit` callback must return to indicate PIN verification status.
+ *
+ * Available values:
+ * - `accept`: A validation result indicating the PIN is correct and authentication was successful.
+ * - `reject`: A validation result indicating the PIN is incorrect and authentication failed.
  */
 
 /**
- * Represents the allowed lengths of a PIN.
- * @typedef {(4|5|6|7|8|9|10)} PinLength
+ * Defines the allowed PIN length values that constrain how many digits users can enter.
+ *
+ * Available lengths:
+ * - `4`: A four-digit PIN length, commonly used for basic security codes and quick authentication.
+ * - `5`: A five-digit PIN length for moderate security requirements.
+ * - `6`: A six-digit PIN length, commonly used for enhanced security codes and verification.
+ * - `7`: A seven-digit PIN length for higher security requirements.
+ * - `8`: An eight-digit PIN length for strong security and complex authentication scenarios.
+ * - `9`: A nine-digit PIN length for very high security requirements.
+ * - `10`: A ten-digit PIN length, the maximum supported for highly secure authentication workflows.
  */
 
 /**
- * Represents an action type for the PinPad component.
- * @typedef {Object} PinPadActionType
- * @property {string} label - The label for the action button.
- * @property {function(): number[]} onPress - The function to be called when the action button is pressed.
- */
-
-/**
- * Represents the properties for the PinPad component.
- * @typedef {Object} PinPadProps
- * @property {boolean} [masked] - Whether the entered PIN should be masked.
- * @property {PinLength} [minPinLength] - The minimum length of the PIN.
- * @property {PinLength} [maxPinLength] - The maximum length of the PIN.
- * @property {string} [label] - The content for the prompt on the pin pad.
- * @property {PinPadActionType} [pinPadAction] - The call to action between the entry view and the keypad, consisting of a label and function that returns the pin.
- * @property {function(pin: number[]): Promise<PinValidationResult>} onSubmit - The function to be called when the PIN is submitted.
- * @property {function(pin: number[]): void} [onPinEntry] - The function to be called when a PIN is entered.
+ * Defines the configuration object for action buttons displayed between the PIN entry view and keypad.
  */
 
 const PinPad = core.createRemoteComponent('PinPad');

package/build/cjs/surfaces/point-of-sale/render/components/QRCode/QRCode.js

@@ -4,11 +4,6 @@ Object.defineProperty(exports, '__esModule', { value: true });
 
 var core = require('@remote-ui/core');
 
-/**
- * The `QRCode` component renders a QR code in Shopify POS.
- * @property `value` the content to be encoded in the QR code.
- */
-
 const QRCode = core.createRemoteComponent('QRCode');
 
 exports.QRCode = QRCode;

package/build/cjs/surfaces/point-of-sale/render/components/Screen/Screen.js

@@ -4,28 +4,6 @@ Object.defineProperty(exports, '__esModule', { value: true });
 
 var core = require('@remote-ui/core');
 
-/** Represents the presentation of a screen in the navigation stack.
- * @property `sheet` displays the screen from the bottom on `navigate` when `true`.
- */
-
-/** Represents the secondary action button of a screen in the navigation stack.
- * @property `text` displays the name of the secondary action in the action bar.
- * @property `onPress` triggered when the secondary action button is pressed.
- * @property `isEnabled` sets whether the action can be tapped.
- */
-
-/** Represents a screen in the navigation stack.
- * @property `name` used to identify this screen as a destination in the navigation stack.
- * @property `title` the title of the screen which will be displayed on the UI.
- * @property `isLoading` displays a loading indicator when `true`. Set this to `true` when performing an asynchronous task, and then to false when the data becomes available to the UI.
- * @property `presentation` dictates how the `Screen` will be presented when navigated to.
- * @property `secondaryAction` displays a secondary action button on the screen.
- * @property `onNavigate` triggered when the screen is navigated to.
- * @property `onNavigateBack` triggered when the user navigates back from this screen. Runs after screen is unmounted.
- * @property `overrideNavigateBack` a callback that allows you to override the secondary navigation action. Runs when screen is mounted.
- * @property `onReceiveParams` a callback that gets triggered when the navigation event completes and the screen receives the parameters.
- */
-
 const Screen = core.createRemoteComponent('Screen');
 
 exports.Screen = Screen;

package/build/cjs/surfaces/point-of-sale/render/components/Section/Section.js

@@ -4,14 +4,8 @@ Object.defineProperty(exports, '__esModule', { value: true });
 
 var core = require('@remote-ui/core');
 
-/** Allows the implementation of an action at the top right of a `Section`.
- * @property `title` the title describing the action.
- * @property `onPress` the callback when the action is tapped by the user.
- */
-
-/** Renders content that is bound by a border, with a title and a call to action at the top.
- * @property `title` the title of the section.
- * @property `action` the action in the top right of the section that can be triggered by a tap.
+/**
+ * Defines the configuration object for the action button displayed within the section header.
  */
 
 const Section = core.createRemoteComponent('Section');

package/build/cjs/surfaces/point-of-sale/render/components/SegmentedControl/SegmentedControl.js

@@ -4,6 +4,10 @@ Object.defineProperty(exports, '__esModule', { value: true });
 
 var core = require('@remote-ui/core');
 
+/**
+ * Defines the structure and configuration options for individual segments within the `SegmentedControl` component.
+ */
+
 const SegmentedControl = core.createRemoteComponent('SegmentedControl');
 
 exports.SegmentedControl = SegmentedControl;

package/build/cjs/surfaces/point-of-sale/render/components/Stack/Stack.js

@@ -4,6 +4,10 @@ Object.defineProperty(exports, '__esModule', { value: true });
 
 var core = require('@remote-ui/core');
 
+/* eslint-disable import/no-deprecated */
+
+/* eslint-enable import/no-deprecated */
+
 /**
  *
  * @deprecated Use the `block` or `inline` as a value instead.

package/build/cjs/surfaces/point-of-sale/render/components/Text/Text.js

@@ -4,6 +4,34 @@ Object.defineProperty(exports, '__esModule', { value: true });
 
 var core = require('@remote-ui/core');
 
+/**
+ * Defines the typography hierarchy options for text elements. Each variant provides specific sizing, weight, and styling appropriate for different content types.
+ *
+ * Available variants:
+ * - `sectionHeader`: A section header variant for titles that organize and introduce content sections.
+ * - `captionRegular`: A regular caption variant for supplementary text, labels, or secondary information.
+ * - `captionRegularTall`: A taller caption variant with increased line height for improved readability in dense layouts.
+ * - `captionMedium`: A medium-weight caption variant for slightly emphasized secondary text or important labels.
+ * - `body`: The standard body text variant for primary content, descriptions, and general text.
+ * - `headingSmall`: A small heading variant for subsection titles and secondary headings.
+ * - `headingLarge`: A large heading variant for main section titles and primary headings.
+ * - `display`: The largest display variant for prominent titles, hero text, or major interface elements.
+ */
+
+/**
+ * Defines the semantic color options for text elements. Each color conveys specific meaning and intent through visual styling.
+ *
+ * Available colors:
+ * - `TextNeutral`: A neutral text color for general content that doesn't convey specific semantic meaning.
+ * - `TextSubdued`: A subdued text color for secondary information, captions, or content that should be less prominent.
+ * - `TextDisabled`: A disabled text color for inactive or unavailable content that users can't interact with.
+ * - `TextWarning`: A warning text color for cautionary messages or content that requires user attention.
+ * - `TextCritical`: A critical text color for errors, failures, or destructive actions that require immediate attention.
+ * - `TextSuccess`: A success text color for positive outcomes, confirmations, or completed actions.
+ * - `TextInteractive`: An interactive text color for clickable elements, links, or content that users can interact with.
+ * - `TextHighlight`: A highlight text color for emphasized content that needs to stand out or draw special attention.
+ */
+
 const Text = core.createRemoteComponent('Text');
 
 exports.Text = Text;

package/build/cjs/surfaces/point-of-sale/render/components/TextArea/TextArea.js

@@ -4,12 +4,6 @@ Object.defineProperty(exports, '__esModule', { value: true });
 
 var core = require('@remote-ui/core');
 
-/**
- * Represents the properties for the TextField component.
- * @typedef {Object} TextAreaProps
- * @property {number} [rows] - The initial number of lines to be displayed. Maximum of 8 lines.
- */
-
 const TextArea = core.createRemoteComponent('TextArea');
 
 exports.TextArea = TextArea;

package/build/cjs/surfaces/point-of-sale/render/components/Tile/Tile.js

@@ -4,16 +4,6 @@ Object.defineProperty(exports, '__esModule', { value: true });
 
 var core = require('@remote-ui/core');
 
-/**
- * @property `title` the text set on the main label of the tile.
- * @property `subtitle` the text set on the secondary label of the tile.
- * @property `enabled` sets whether or not the tile can be tapped.
- * @property `destructive` sets whether or not the tile has a destructive appearance and active state as of POS
- * 10.0.0.
- * @property `badgeValue` the number value displayed in the top right corner of the tile.
- * @property `onPress` the callback that is executed when the tile is tapped.
- */
-
 const Tile = core.createRemoteComponent('Tile');
 
 exports.Tile = Tile;

package/build/cjs/surfaces/point-of-sale/render/components/TimePicker/TimePicker.js

@@ -4,15 +4,6 @@ Object.defineProperty(exports, '__esModule', { value: true });
 
 var core = require('@remote-ui/core');
 
-/**
- * Represents the properties for the TimePicker component.
- * @property selected - The selected time.
- * @property onChange - A callback for changes.
- * @property visibleState - Controls the visible state, and a callback to set the visible state as false when the dialog closes.
- * @property is24Hour - (Android only) Whether the clock displays in 24 hour time instead of 12 hour time.
- * @property inputMode - Whether to display the picker in inline (clock) mode or spinner mode.
- */
-
 const TimePicker = core.createRemoteComponent('TimePicker');
 
 exports.TimePicker = TimePicker;

package/build/cjs/surfaces/point-of-sale/types/storage.js

@@ -9,5 +9,8 @@ class StorageError extends Error {
     this.name = 'StorageError';
   }
 }
+/**
+ * Defines the storage interface for persisting extension data across sessions.
+ */
 
 exports.StorageError = StorageError;

package/build/esm/surfaces/point-of-sale/render/components/Badge/Badge.mjs

@@ -1,12 +1,5 @@
 import { createRemoteComponent } from '@remote-ui/core';
 
-/**
- * @property text - The text displayed inside the badge.
- * @property variant - The appearance and function of the badge.
- * @property status - A circle icon displaying the status of the badge.
- * @deprecated status - No longer supported as of POS 10.0.0.
- */
-
 const Badge = createRemoteComponent('Badge');
 
 export { Badge };

package/build/esm/surfaces/point-of-sale/render/components/Banner/Banner.mjs

@@ -1,14 +1,5 @@
 import { createRemoteComponent } from '@remote-ui/core';
 
-/**
- * @property title - The title text displayed on the banner.
- * @property variant - The variant type of the banner.
- * @property action - The text for the action button.
- * @property onPress - The callback function executed when the banner is pressed.
- * @property hideAction - Whether to hide the action button.
- * @property visible - The visibility state of the banner.
- */
-
 const Banner = createRemoteComponent('Banner');
 
 export { Banner };

package/build/esm/surfaces/point-of-sale/render/components/Button/Button.mjs

@@ -1,13 +1,5 @@
 import { createRemoteComponent } from '@remote-ui/core';
 
-/**
- * @property `title` the text set on the `Button`.
- * @property `type` the type of `Button` to render. Determines the appearance of the button.
- * @property `onPress` the callback that is executed when the user taps the button.
- * @property `isDisabled` sets whether the `Button` can be tapped.
- * @property `isLoading` sets whether the `Button` is displaying an animated loading state.
- */
-
 const Button = createRemoteComponent('Button');
 
 export { Button };

package/build/esm/surfaces/point-of-sale/render/components/CameraScanner/CameraScanner.mjs

@@ -1,11 +1,5 @@
 import { createRemoteComponent } from '@remote-ui/core';
 
-/**
- * @property title - The title of the banner.
- * @property variant - The appearance of the banner.
- * @property visible - The visibility state of the banner.
- */
-
 const CameraScanner = createRemoteComponent('CameraScanner');
 
 export { CameraScanner };

package/build/esm/surfaces/point-of-sale/render/components/DatePicker/DatePicker.mjs

@@ -1,13 +1,5 @@
 import { createRemoteComponent } from '@remote-ui/core';
 
-/**
- * Represents the properties for the DatePicker component.
- * @property selected - The selected time.
- * @property onChange - A callback for changes.
- * @property visibleState - Control the visible state, and a callback to set the visible state as false when the dialog closes.
- * @property inputMode - Whether to display the picker in inline (clock) mode or spinner mode.
- */
-
 const DatePicker = createRemoteComponent('DatePicker');
 
 export { DatePicker };

package/build/esm/surfaces/point-of-sale/render/components/Dialog/Dialog.mjs

@@ -1,17 +1,5 @@
 import { createRemoteComponent } from '@remote-ui/core';
 
-/**
- * @property title - The text displayed in the title of the dialog.
- * @property content - The text displayed in the body of the dialog.
- * @property actionText - The text displayed in the primary action button of the dialog.
- * @property secondaryActionText - The text displayed in the secondary action section of the dialog.
- * @property showSecondaryAction - Whether a secondary action displays.
- * @property type - Determines the dialog’s appearance and function.
- * @property onAction - A callback that performs when the action is triggered.
- * @property onSecondaryAction - A callback that is executed when the secondary action is triggered.
- * @property isVisible - Whether the dialog should be presented.
- */
-
 const Dialog = createRemoteComponent('Dialog');
 
 export { Dialog };

package/build/esm/surfaces/point-of-sale/render/components/Image/Image.mjs

@@ -1,9 +1,14 @@
 import { createRemoteComponent } from '@remote-ui/core';
 
 /**
- * FillResizeMode will apply formatting to the image to fill the container.
+ * Defines how images are resized and positioned within their containers. Controls image scaling, cropping, and aspect ratio handling.
  *
- * https://reactnative.dev/docs/image#resizemode
+ * Available resize modes:
+ * - `center`: Centers the image within its container without scaling. The image maintains its original size and is positioned in the center, potentially leaving empty space or being cropped if the container is smaller.
+ * - `contain`: Scales the image to fit entirely within the container while maintaining aspect ratio. The entire image will be visible, but there may be empty space if the aspect ratios don't match.
+ * - `cover`: Scales the image to fill the entire container while maintaining aspect ratio. Parts of the image may be cropped if the aspect ratios don't match, but the container will be completely filled.
+ * - `repeat`: Repeats the image to fill the container. The image maintains its original size and is tiled both horizontally and vertically to cover the entire container area.
+ * - `stretch`: Stretches the image to fill the container completely, potentially distorting the aspect ratio. The image will fill the entire container but may appear stretched or compressed.
  */
 
 const Image = createRemoteComponent('Image');

package/build/esm/surfaces/point-of-sale/render/components/Navigator/Navigator.mjs

@@ -1,9 +1,5 @@
 import { createRemoteComponent } from '@remote-ui/core';
 
-/**
- * @property `initialScreenName` sets the initial `Screen` whose `name` matches.
- */
-
 const Navigator = createRemoteComponent('Navigator');
 
 export { Navigator };

package/build/esm/surfaces/point-of-sale/render/components/NumberField/NumberField.mjs

@@ -1,11 +1,5 @@
 import { createRemoteComponent } from '@remote-ui/core';
 
-/**
- * Represents the properties for the NumberField component.
- * @typedef {Object} NumberFieldProps
- * @property {'decimal' | 'numeric'} [inputMode] - The mode of input, can be either 'decimal' or 'numeric'.
- */
-
 const NumberField = createRemoteComponent('NumberField');
 
 export { NumberField };

package/build/esm/surfaces/point-of-sale/render/components/POSBlock/POSBlock.mjs

@@ -1,11 +1,5 @@
 import { createRemoteComponent } from '@remote-ui/core';
 
-/**
- * Renders a `POSBlock`. Note that the text displayed on this `POSBlock`
- * is dependent on the description of the extension. A `POSBlock` only
- * accepts `POSBlockRow` as children.
- */
-
 const POSBlock = createRemoteComponent('POSBlock');
 
 export { POSBlock };

package/build/esm/surfaces/point-of-sale/render/components/POSBlock/POSBlockRow.mjs

@@ -1,9 +1,5 @@
 import { createRemoteComponent } from '@remote-ui/core';
 
-/**
- * Renders a `POSBlockRow` in a `POSBlock`.
- */
-
 const POSBlockRow = createRemoteComponent('POSBlockRow');
 
 export { POSBlockRow };

package/build/esm/surfaces/point-of-sale/render/components/POSReceiptBlock/POSReceiptBlock.mjs

@@ -1,10 +1,5 @@
 import { createRemoteComponent } from '@remote-ui/core';
 
-/**
- * Renders a `POSReceiptBlock`. A `POSReceiptBlock` only accepts
- * `Text` and `QRCode` as children (more to be added in the future).
- */
-
 const POSReceiptBlock = createRemoteComponent('POSReceiptBlock');
 
 export { POSReceiptBlock };

package/build/esm/surfaces/point-of-sale/render/components/PinPad/PinPad.mjs

@@ -1,32 +1,28 @@
 import { createRemoteComponent } from '@remote-ui/core';
 
 /**
- * Represents the result of the pin pad onSubmit function.
- * @typedef {('accept'|'reject')} PinValidationResult
+ * Defines the validation result values that the `onSubmit` callback must return to indicate PIN verification status.
+ *
+ * Available values:
+ * - `accept`: A validation result indicating the PIN is correct and authentication was successful.
+ * - `reject`: A validation result indicating the PIN is incorrect and authentication failed.
  */
 
 /**
- * Represents the allowed lengths of a PIN.
- * @typedef {(4|5|6|7|8|9|10)} PinLength
+ * Defines the allowed PIN length values that constrain how many digits users can enter.
+ *
+ * Available lengths:
+ * - `4`: A four-digit PIN length, commonly used for basic security codes and quick authentication.
+ * - `5`: A five-digit PIN length for moderate security requirements.
+ * - `6`: A six-digit PIN length, commonly used for enhanced security codes and verification.
+ * - `7`: A seven-digit PIN length for higher security requirements.
+ * - `8`: An eight-digit PIN length for strong security and complex authentication scenarios.
+ * - `9`: A nine-digit PIN length for very high security requirements.
+ * - `10`: A ten-digit PIN length, the maximum supported for highly secure authentication workflows.
  */
 
 /**
- * Represents an action type for the PinPad component.
- * @typedef {Object} PinPadActionType
- * @property {string} label - The label for the action button.
- * @property {function(): number[]} onPress - The function to be called when the action button is pressed.
- */
-
-/**
- * Represents the properties for the PinPad component.
- * @typedef {Object} PinPadProps
- * @property {boolean} [masked] - Whether the entered PIN should be masked.
- * @property {PinLength} [minPinLength] - The minimum length of the PIN.
- * @property {PinLength} [maxPinLength] - The maximum length of the PIN.
- * @property {string} [label] - The content for the prompt on the pin pad.
- * @property {PinPadActionType} [pinPadAction] - The call to action between the entry view and the keypad, consisting of a label and function that returns the pin.
- * @property {function(pin: number[]): Promise<PinValidationResult>} onSubmit - The function to be called when the PIN is submitted.
- * @property {function(pin: number[]): void} [onPinEntry] - The function to be called when a PIN is entered.
+ * Defines the configuration object for action buttons displayed between the PIN entry view and keypad.
  */
 
 const PinPad = createRemoteComponent('PinPad');

package/build/esm/surfaces/point-of-sale/render/components/QRCode/QRCode.mjs

@@ -1,10 +1,5 @@
 import { createRemoteComponent } from '@remote-ui/core';
 
-/**
- * The `QRCode` component renders a QR code in Shopify POS.
- * @property `value` the content to be encoded in the QR code.
- */
-
 const QRCode = createRemoteComponent('QRCode');
 
 export { QRCode };