Merge branch 'unstable' into njo/2025-07/doc-prep

Author: NathanJolly

.changeset/neat-hairs-study.md

@@ -0,0 +1,13 @@
+---
+'@shopify/ui-extensions': minor
+---
+
+Add extension targets:
+
+pos.return.post.action.menu-item.render
+pos.return.post.action.render
+pos.return.post.block.render
+
+pos.exchange.post.action.menu-item.render
+pos.exchange.post.action.render
+pos.exchange.post.block.render

.changeset/silent-yaks-beam.md

@@ -0,0 +1,6 @@
+---
+'@shopify/ui-extensions': minor
+'@shopify/ui-extensions-react': minor
+---
+
+NumberField - deprecate min and max props

packages/ui-extensions/docs/surfaces/point-of-sale/reference/apis/action-api.doc.ts

@@ -14,6 +14,10 @@ The Action API allows an action extension to modally present its corresponding m
 - ${TargetLink.PosHomeTileRender}
 - ${TargetLink.PosPurchasePostActionMenuItemRender}
 - ${TargetLink.PosPurchasePostBlockRender}
+- ${TargetLink.PosReturnPostActionMenuItemRender}
+- ${TargetLink.PosReturnPostBlockRender}
+- ${TargetLink.PosExchangePostActionMenuItemRender}
+- ${TargetLink.PosExchangePostBlockRender}
 - ${TargetLink.PosOrderDetailsActionMenuItemRender}
 - ${TargetLink.PosOrderDetailsBlockRender}
 - ${TargetLink.PosProductDetailsActionMenuItemRender}

packages/ui-extensions/docs/surfaces/point-of-sale/reference/apis/order-api.doc.ts

@@ -14,6 +14,12 @@ The Order API provides an extension with data about the current order.
 - ${TargetLink.PosPurchasePostActionMenuItemRender}
 - ${TargetLink.PosPurchasePostActionRender}
 - ${TargetLink.PosPurchasePostBlockRender}
+- ${TargetLink.PosReturnPostActionMenuItemRender}
+- ${TargetLink.PosReturnPostActionRender}
+- ${TargetLink.PosReturnPostBlockRender}
+- ${TargetLink.PosExchangePostActionMenuItemRender}
+- ${TargetLink.PosExchangePostActionRender}
+- ${TargetLink.PosExchangePostBlockRender}
 - ${TargetLink.PosOrderDetailsActionMenuItemRender}
 - ${TargetLink.PosOrderDetailsActionRender}
 - ${TargetLink.PosOrderDetailsBlockRender}

packages/ui-extensions/docs/surfaces/point-of-sale/reference/apis/storage-api.doc.ts

@@ -8,6 +8,8 @@ const generateCodeBlockForStorageApi = (title: string, fileName: string) =>
 const data: ReferenceEntityTemplateSchema = {
   name: 'Storage API',
   description: `The Storage API allows fetching, setting, updating, and clearing an extension's data from the POS local storage.
+  - An extension can store up to 100 entries.
+  - The maximum size for a key is ~1 KB, and for a value is ~1 MB.
   - If a target (such as \`pos.home.tile.render\`) is disabled or removed, the extension data remains.
   - All stored extension data that has not been updated for a month is cleared automatically after that period.
 

packages/ui-extensions/docs/surfaces/point-of-sale/reference/examples/targets/pos-exchange-post-action-menu-item-render.ts

@@ -0,0 +1,14 @@
+import {Button, extension} from '@shopify/ui-extensions/point-of-sale';
+
+export default extension(
+  'pos.exchange.post.action.menu-item.render',
+  (root, api) => {
+    const button = root.createComponent(Button, {
+      onPress: () => {
+        api.action.presentModal();
+      },
+    });
+
+    root.append(button);
+  },
+);

packages/ui-extensions/docs/surfaces/point-of-sale/reference/examples/targets/pos-exchange-post-action-menu-item-render.tsx

@@ -0,0 +1,23 @@
+import React from 'react';
+
+import {
+  Button,
+  reactExtension,
+  useApi,
+} from '@shopify/ui-extensions-react/point-of-sale';
+
+const ExchangeActionMenuItem = () => {
+  const api = useApi<'pos.exchange.post.action.menu-item.render'>();
+  return (
+    <Button
+      onPress={() => {
+        api.action.presentModal();
+      }}
+    />
+  );
+};
+
+export default reactExtension(
+  'pos.exchange.post.action.menu-item.render',
+  () => <ExchangeActionMenuItem />,
+);

packages/ui-extensions/docs/surfaces/point-of-sale/reference/examples/targets/pos-exchange-post-action-render.ts

@@ -0,0 +1,23 @@
+import {
+  Navigator,
+  Screen,
+  ScrollView,
+  Text,
+  extension,
+} from '@shopify/ui-extensions/point-of-sale';
+
+export default extension('pos.exchange.post.action.render', (root, api) => {
+  const navigator = root.createComponent(Navigator);
+  const screen = root.createComponent(Screen, {
+    name: 'ExchangeDetails',
+    title: 'Exchange Details',
+  });
+  const scrollView = root.createComponent(ScrollView);
+  const text = root.createComponent(Text);
+
+  text.append(`Exchange ID: ${api.exchange.id}`);
+  scrollView.append(text);
+  screen.append(scrollView);
+  navigator.append(screen);
+  root.append(navigator);
+});

packages/ui-extensions/docs/surfaces/point-of-sale/reference/examples/targets/pos-exchange-post-action-render.tsx

@@ -0,0 +1,27 @@
+import React from 'react';
+
+import {
+  Navigator,
+  Screen,
+  ScrollView,
+  Text,
+  reactExtension,
+  useApi,
+} from '@shopify/ui-extensions-react/point-of-sale';
+
+const ExchangeAction = () => {
+  const api = useApi<'pos.exchange.post.action.render'>();
+  return (
+    <Navigator>
+      <Screen name="ExchangeDetails" title="Exchange Details">
+        <ScrollView>
+          <Text>{`Order ID: ${api.order.id}`}</Text>
+        </ScrollView>
+      </Screen>
+    </Navigator>
+  );
+};
+
+export default reactExtension('pos.exchange.post.action.render', () => (
+  <ExchangeAction />
+));

packages/ui-extensions/docs/surfaces/point-of-sale/reference/examples/targets/pos-exchange-post-block-render.ts

@@ -0,0 +1,28 @@
+import {
+  POSBlock,
+  POSBlockRow,
+  Text,
+  extension,
+} from '@shopify/ui-extensions/point-of-sale';
+
+export default extension('pos.exchange.post.block.render', (root, api) => {
+  const block = root.createComponent(POSBlock, {
+    action: {title: 'View exchange details', onPress: api.action.presentModal},
+  });
+
+  const mainText = root.createComponent(Text);
+  mainText.append('Exchange block extension');
+
+  const subtitleText = root.createComponent(Text);
+  subtitleText.append(`Order ID: ${api.order.id}`);
+
+  const blockMainRow = root.createComponent(POSBlockRow);
+  blockMainRow.append(mainText);
+
+  const blockSubtitleRow = root.createComponent(POSBlockRow);
+  blockSubtitleRow.append(subtitleText);
+  block.append(blockMainRow);
+  block.append(blockSubtitleRow);
+
+  root.append(block);
+});