npm - @shopify/ui-extensions - Versions diffs - 2025.10.0-rc.5 → 2025.10.0-rc.7 - Mend

@shopify/ui-extensions 2025.10.0-rc.5 → 2025.10.0-rc.7

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (304) hide show

package/package.json CHANGED Viewed

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

package/src/docs/shared/components/Map.ts ADDED Viewed

@@ -0,0 +1,12 @@
+import type {SharedReferenceEntityTemplateSchema} from '../docs-type';
+const data: SharedReferenceEntityTemplateSchema = {
+  name: 'Map',
+  description:
+    'Use Map to display a map on a page. This component is useful for displaying a map of a location, such as a store or a customer’s address.',
+  category: 'Polaris web components',
+  subCategory: 'Interactive',
+  related: [],
+};
+export default data;

package/src/docs/shared/components/MapMarker.ts ADDED Viewed

@@ -0,0 +1,12 @@
+import type {SharedReferenceEntityTemplateSchema} from '../docs-type';
+const data: SharedReferenceEntityTemplateSchema = {
+  name: 'MapMarker',
+  description:
+    'Use MapMarker to display a marker on a map. Use only as a child of `s-map` component.',
+  category: 'Polaris web components',
+  subCategory: 'Interactive',
+  related: [],
+};
+export default data;

package/src/docs/shared/components/Modal.ts ADDED Viewed

@@ -0,0 +1,12 @@
+import type {SharedReferenceEntityTemplateSchema} from '../docs-type';
+const data: SharedReferenceEntityTemplateSchema = {
+  name: 'Modal',
+  description:
+    'Use modal to display content in a overlay. This component is useful for creating a distraction-free experience, such as a confirmation dialog or a settings panel.',
+  category: 'Polaris web components',
+  subCategory: 'Overlay',
+  related: [],
+};
+export default data;

package/src/docs/shared/components/Option.ts ADDED Viewed

@@ -0,0 +1,12 @@
+import type {SharedReferenceEntityTemplateSchema} from '../docs-type';
+const data: SharedReferenceEntityTemplateSchema = {
+  name: 'Option',
+  description:
+    'Represents a single option within a select component. Use only as a child of `s-select` components.',
+  category: 'Polaris web components',
+  subCategory: 'Forms',
+  related: [],
+};
+export default data;

package/src/docs/shared/components/PhoneField.ts ADDED Viewed

@@ -0,0 +1,11 @@
+import type {SharedReferenceEntityTemplateSchema} from '../docs-type';
+const data: SharedReferenceEntityTemplateSchema = {
+  name: 'PhoneField',
+  description: 'Use PhoneField to allow users to enter phone numbers.',
+  category: 'Polaris web components',
+  subCategory: 'Forms',
+  related: [],
+};
+export default data;

package/src/docs/shared/components/ProductThumbnail.ts ADDED Viewed

@@ -0,0 +1,11 @@
+import type {SharedReferenceEntityTemplateSchema} from '../docs-type';
+const data: SharedReferenceEntityTemplateSchema = {
+  name: 'ProductThumbnail',
+  description: 'Use ProductThumbnail to display a product thumbnail',
+  category: 'Polaris web components',
+  subCategory: 'Media',
+  related: [],
+};
+export default data;

package/src/surfaces/admin/components/AdminPrintAction/examples/default.tsx CHANGED Viewed

@@ -1,7 +1,7 @@
 import '@shopify/ui-extensions/preact';
 import {render} from 'preact';
-export default function extension() {
+export default async () => {
   render(
     <s-admin-print-action src="https://example.com"></s-admin-print-action>,
     document.body,

package/src/surfaces/admin/components/StandardComponents.ts CHANGED Viewed

@@ -24,6 +24,7 @@ export type StandardComponents =
   | 'OrderedList'
   | 'Paragraph'
   | 'PasswordField'
+  | 'QueryContainer'
   | 'Section'
   | 'Select'
   | 'Spinner'

package/src/surfaces/admin/components/patterns/examples/details.html ADDED Viewed

@@ -0,0 +1,228 @@
+<!DOCTYPE html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <script src="https://cdn.shopify.com/shopifycloud/app-bridge-ui-experimental.js"></script>
+    <title>Pattern</title>
+  </head>
+  <body>
+    <!-- === -->
+    <!-- Details page pattern -->
+    <!-- === -->
+    <form data-save-bar onSubmit="" onReset="">
+      <s-page>
+        <!-- === -->
+        <!-- Title Bar -->
+        <!-- Note: ui-title-bar requires AppBridge to render correctly -->
+        <!-- === -->
+        <ui-title-bar title="Mountain view">
+          <button variant="breadcrumb" href="/app/puzzles">Puzzles</button>
+          <button>Duplicate</button>
+          <button tone="critical">Delete</button>
+        </ui-title-bar>
+        <!-- === -->
+        <!-- Puzzle information -->
+        <!-- === -->
+        <s-section heading="Puzzle information">
+          <s-grid gap="base">
+            <s-text-field
+              label="Puzzle name"
+              name="name"
+              labelAccessibilityVisibility="visible"
+              placeholder="Enter puzzle name"
+              value="Mountain view"
+              details="Players will see this name when browsing puzzles."
+            ></s-text-field>
+            <s-text-area
+              label="Description"
+              name="description"
+              labelAccessibilityVisibility="visible"
+              placeholder="Brief description of your puzzle"
+              value="A beautiful mountain landscape puzzle"
+              details="Help players understand what your puzzle features"
+            ></s-text-area>
+            <s-money-field
+              label="Price"
+              name="price"
+              labelAccessibilityVisibility="visible"
+              placeholder="0.00"
+              value="9.99"
+              details="Set the price for this puzzle"
+            ></s-money-field>
+            <s-url-field
+              label="Reference image URL"
+              name="reference-image-url"
+              labelAccessibilityVisibility="visible"
+              placeholder="https://example.com/image.jpg"
+              details="Optional link to original image"
+            ></s-url-field>
+          </s-grid>
+        </s-section>
+        <!-- === -->
+        <!-- Puzzle templates -->
+        <!-- === -->
+        <s-section heading="Puzzle templates">
+          <s-grid gap="base">
+            <s-grid gridTemplateColumns="1fr auto" gap="base" alignItems="center">
+              <s-grid-item>
+                <s-search-field
+                  label="Search templates"
+                  labelAccessibilityVisibility="exclusive"
+                  placeholder="Search templates"
+                ></s-search-field>
+              </s-grid-item>
+              <s-grid-item>
+                <s-button>Browse</s-button>
+              </s-grid-item>
+            </s-grid>
+            <s-box
+              background="strong"
+              border="base"
+              borderRadius="base"
+              borderStyle="solid"
+              overflow="hidden"
+            >
+              <s-table fullwidth border="base" borderRadius="base" borderStyle="solid">
+                <s-table-header-row>
+                  <s-table-header listSlot="primary">Template</s-table-header>
+                  <s-table-header>
+                    <s-stack alignItems="end">Actions</s-stack>
+                  </s-table-header>
+                  <s-table-header listSlot="secondary">
+                    <s-stack direction="inline" alignItems="end"></s-stack>
+                  </s-table-header>
+                </s-table-header-row>
+                <s-table-body>
+                  <s-table-row>
+                    <s-table-cell listSlot="primary">
+                      <s-stack direction="inline" gap="base" alignItems="center">
+                        <s-box
+                          border="base"
+                          borderRadius="base"
+                          overflow="hidden"
+                          maxInlineSize="40px"
+                          maxBlockSize="40px"
+                        >
+                          <s-image
+                            src="https://cdn.shopify.com/static/images/polaris/patterns/16-pieces.png"
+                          ></s-image>
+                        </s-box>
+                        16-pieces puzzle
+                      </s-stack>
+                    </s-table-cell>
+                    <s-table-cell>
+                      <s-stack alignItems="end">
+                        <s-link>Preview</s-link>
+                      </s-stack>
+                    </s-table-cell>
+                    <s-table-cell>
+                      <s-stack alignItems="end">
+                        <s-button
+                          icon="x"
+                          tone="neutral"
+                          variant="tertiary"
+                          accessibilityLabel="Remove 16-Pieces Puzzle template"
+                        ></s-button>
+                      </s-stack>
+                    </s-table-cell>
+                  </s-table-row>
+                  <s-table-row>
+                    <s-table-cell listSlot="primary">
+                      <s-stack direction="inline" gap="base" alignItems="center">
+                        <s-box
+                          border="base"
+                          borderRadius="base"
+                          overflow="hidden"
+                          maxInlineSize="40px"
+                          maxBlockSize="40px"
+                        >
+                          <s-image
+                            src="https://cdn.shopify.com/static/images/polaris/patterns/9-pieces.png"
+                          ></s-image>
+                        </s-box>
+                        9-pieces puzzle
+                      </s-stack>
+                    </s-table-cell>
+                    <s-table-cell>
+                      <s-stack direction="inline" gap="base" justifyContent="end">
+                        <s-link>Preview</s-link>
+                      </s-stack>
+                    </s-table-cell>
+                    <s-table-cell listSlot="secondary">
+                      <s-stack alignItems="end">
+                        <s-button
+                          icon="x"
+                          tone="neutral"
+                          variant="tertiary"
+                          accessibilityLabel="Remove 9-Pieces Puzzle template"
+                        ></s-button>
+                      </s-stack>
+                    </s-table-cell>
+                  </s-table-row>
+                  <!-- Add more rows as needed here -->
+                  <!-- If more than 10 rows are needed, details page tables should use the paginate, hasPreviousPage, hasNextPage, onPreviousPage, and onNextPage attributes to display and handle pagination) -->
+                </s-table-body>
+              </s-table>
+            </s-box>
+          </s-grid>
+        </s-section>
+        <!-- === -->
+        <!-- Settings -->
+        <!-- === -->
+        <s-section heading="Settings">
+          <s-grid gap="base">
+            <s-select label="Puzzle size" name="puzzle-size">
+              <s-option value="small">Small (9" x 9")</s-option>
+              <s-option value="medium" selected> Medium (18" x 24") </s-option>
+              <s-option value="large">Large (24" x 36")</s-option>
+            </s-select>
+            <s-select label="Piece count" name="piece-count">
+              <s-option value="250">250 pieces (Easy)</s-option>
+              <s-option value="500" selected> 500 pieces (Medium) </s-option>
+              <s-option value="1000">1000 pieces (Hard)</s-option>
+              <s-option value="2000">2000 pieces (Expert)</s-option>
+            </s-select>
+            <s-select label="Material" name="material">
+              <s-option value="standard" selected> Standard cardboard </s-option>
+              <s-option value="premium">Premium cardboard</s-option>
+              <s-option value="wooden">Wooden pieces</s-option>
+            </s-select>
+            <s-number-field
+              label="Quantity in stock"
+              name="quantity-in-stock"
+              labelAccessibilityVisibility="visible"
+              value="50"
+              min="0"
+              placeholder="0"
+              details="Current inventory quantity"
+            ></s-number-field>
+            <s-switch
+              label="Include reference image"
+              name="include-reference-image"
+              details="Ship a reference image with the puzzle"
+            ></s-switch>
+          </s-grid>
+        </s-section>
+        <!-- Use the aside slot for sidebar content -->
+        <s-box slot="aside">
+          <!-- === -->
+          <!-- Puzzle summary -->
+          <!-- === -->
+          <s-section heading="Puzzle summary">
+            <s-heading>Mountain view</s-heading>
+            <s-unordered-list>
+              <s-list-item>16-piece puzzle with medium difficulty</s-list-item>
+              <s-list-item>Pieces can be rotated</s-list-item>
+              <s-list-item>No time limit</s-list-item>
+              <s-list-item>
+                Current status:
+                <s-badge color="base" tone="success"> Active </s-badge>
+              </s-list-item>
+            </s-unordered-list>
+          </s-section>
+        </s-box>
+      </s-page>
+    </form>
+  </body>
+</html>

package/src/surfaces/admin/components/patterns/examples/details.jsx ADDED Viewed

@@ -0,0 +1,262 @@
+// ===
+// Details page pattern
+// ===
+export default function DetailsPage() {
+  const handleFormReset = (event) => {
+    console.log("Handle discarded changes if necessary");
+  };
+  const handleFormSubmit = (event) => {
+    event.preventDefault();
+    const formData = new FormData(event.target);
+    const formEntries = Object.fromEntries(formData);
+    console.log("Form data", formEntries);
+  };
+  return (
+    <form data-save-bar onSubmit={handleFormSubmit} onReset={handleFormReset}>
+      <s-page>
+        {/* === */}
+        {/* Title Bar */}
+        {/* Note: ui-title-bar requires AppBridge to render correctly */}
+        {/* === */}
+        <ui-title-bar title="Mountain view">
+          <button variant="breadcrumb" href="/app/puzzles">
+            Puzzles
+          </button>
+          <button>Duplicate</button>
+          <button tone="critical">Delete</button>
+        </ui-title-bar>
+        {/* === */}
+        {/* Puzzle information */}
+        {/* === */}
+        <s-section heading="Puzzle information">
+          <s-grid gap="base">
+            <s-text-field
+              label="Puzzle name"
+              name="name"
+              labelAccessibilityVisibility="visible"
+              placeholder="Enter puzzle name"
+              value="Mountain view"
+              details="Players will see this name when browsing puzzles."
+            ></s-text-field>
+            <s-text-area
+              label="Description"
+              name="description"
+              labelAccessibilityVisibility="visible"
+              placeholder="Brief description of your puzzle"
+              value="A beautiful mountain landscape puzzle"
+              details="Help players understand what your puzzle features"
+            ></s-text-area>
+            <s-money-field
+              label="Price"
+              name="price"
+              labelAccessibilityVisibility="visible"
+              placeholder="0.00"
+              value="9.99"
+              details="Set the price for this puzzle"
+            ></s-money-field>
+            <s-url-field
+              label="Reference image URL"
+              name="reference-image-url"
+              labelAccessibilityVisibility="visible"
+              placeholder="https://example.com/image.jpg"
+              details="Optional link to original image"
+            ></s-url-field>
+          </s-grid>
+        </s-section>
+        {/* === */}
+        {/* Puzzle templates */}
+        {/* === */}
+        <s-section heading="Puzzle templates">
+          <s-grid gap="base">
+            <s-grid
+              gridTemplateColumns="1fr auto"
+              gap="base"
+              alignItems="center"
+            >
+              <s-grid-item>
+                <s-search-field
+                  label="Search templates"
+                  labelAccessibilityVisibility="exclusive"
+                  placeholder="Search templates"
+                ></s-search-field>
+              </s-grid-item>
+              <s-grid-item>
+                <s-button>Browse</s-button>
+              </s-grid-item>
+            </s-grid>
+            <s-box
+              background="strong"
+              border="base"
+              borderRadius="base"
+              borderStyle="solid"
+              overflow="hidden"
+            >
+              <s-table
+                fullwidth
+                border="base"
+                borderRadius="base"
+                borderStyle="solid"
+              >
+                <s-table-header-row>
+                  <s-table-header listSlot="primary">Template</s-table-header>
+                  <s-table-header>
+                    <s-stack alignItems="end">Actions</s-stack>
+                  </s-table-header>
+                  <s-table-header listSlot="secondary">
+                    <s-stack direction="inline" alignItems="end"></s-stack>
+                  </s-table-header>
+                </s-table-header-row>
+                <s-table-body>
+                  <s-table-row>
+                    <s-table-cell listSlot="primary">
+                      <s-stack
+                        direction="inline"
+                        gap="base"
+                        alignItems="center"
+                      >
+                        <s-box
+                          border="base"
+                          borderRadius="base"
+                          overflow="hidden"
+                          maxInlineSize="40px"
+                          maxBlockSize="40px"
+                        >
+                          <s-image src="https://cdn.shopify.com/static/images/polaris/patterns/16-pieces.png"></s-image>
+                        </s-box>
+                        16-pieces puzzle
+                      </s-stack>
+                    </s-table-cell>
+                    <s-table-cell>
+                      <s-stack alignItems="end">
+                        <s-link>Preview</s-link>
+                      </s-stack>
+                    </s-table-cell>
+                    <s-table-cell>
+                      <s-stack alignItems="end">
+                        <s-button
+                          icon="x"
+                          tone="neutral"
+                          variant="tertiary"
+                          accessibilityLabel="Remove 16-Pieces Puzzle template"
+                        ></s-button>
+                      </s-stack>
+                    </s-table-cell>
+                  </s-table-row>
+                  <s-table-row>
+                    <s-table-cell listSlot="primary">
+                      <s-stack
+                        direction="inline"
+                        gap="base"
+                        alignItems="center"
+                      >
+                        <s-box
+                          border="base"
+                          borderRadius="base"
+                          overflow="hidden"
+                          maxInlineSize="40px"
+                          maxBlockSize="40px"
+                        >
+                          <s-image src="https://cdn.shopify.com/static/images/polaris/patterns/9-pieces.png"></s-image>
+                        </s-box>
+                        9-pieces puzzle
+                      </s-stack>
+                    </s-table-cell>
+                    <s-table-cell>
+                      <s-stack
+                        direction="inline"
+                        gap="base"
+                        justifyContent="end"
+                      >
+                        <s-link>Preview</s-link>
+                      </s-stack>
+                    </s-table-cell>
+                    <s-table-cell listSlot="secondary">
+                      <s-stack alignItems="end">
+                        <s-button
+                          icon="x"
+                          tone="neutral"
+                          variant="tertiary"
+                          accessibilityLabel="Remove 9-Pieces Puzzle template"
+                        ></s-button>
+                      </s-stack>
+                    </s-table-cell>
+                  </s-table-row>
+                  {/* Add more rows as needed here */}
+                  {/* If more than 10 rows are needed, details page tables should use the paginate, hasPreviousPage, hasNextPage, onPreviousPage, and onNextPage attributes to display and handle pagination) */}
+                </s-table-body>
+              </s-table>
+            </s-box>
+          </s-grid>
+        </s-section>
+        {/* === */}
+        {/* Settings */}
+        {/* === */}
+        <s-section heading="Settings">
+          <s-grid gap="base">
+            <s-select label="Puzzle size" name="puzzle-size">
+              <s-option value="small">Small (9" x 9")</s-option>
+              <s-option value="medium" selected>
+                Medium (18" x 24")
+              </s-option>
+              <s-option value="large">Large (24" x 36")</s-option>
+            </s-select>
+            <s-select label="Piece count" name="piece-count">
+              <s-option value="250">250 pieces (Easy)</s-option>
+              <s-option value="500" selected>
+                500 pieces (Medium)
+              </s-option>
+              <s-option value="1000">1000 pieces (Hard)</s-option>
+              <s-option value="2000">2000 pieces (Expert)</s-option>
+            </s-select>
+            <s-select label="Material" name="material">
+              <s-option value="standard" selected>
+                Standard cardboard
+              </s-option>
+              <s-option value="premium">Premium cardboard</s-option>
+              <s-option value="wooden">Wooden pieces</s-option>
+            </s-select>
+            <s-number-field
+              label="Quantity in stock"
+              name="quantity-in-stock"
+              labelAccessibilityVisibility="visible"
+              value="50"
+              min="0"
+              placeholder="0"
+              details="Current inventory quantity"
+            ></s-number-field>
+            <s-switch
+              label="Include reference image"
+              name="include-reference-image"
+              details="Ship a reference image with the puzzle"
+            ></s-switch>
+          </s-grid>
+        </s-section>
+        {/* Use the aside slot for sidebar content */}
+        <s-box slot="aside">
+          {/* === */}
+          {/* Puzzle summary */}
+          {/* === */}
+          <s-section heading="Puzzle summary">
+            <s-heading>Mountain view</s-heading>
+            <s-unordered-list>
+              <s-list-item>16-piece puzzle with medium difficulty</s-list-item>
+              <s-list-item>Pieces can be rotated</s-list-item>
+              <s-list-item>No time limit</s-list-item>
+              <s-list-item>
+                Current status:{" "}
+                <s-badge color="base" tone="success">
+                  Active
+                </s-badge>
+              </s-list-item>
+            </s-unordered-list>
+          </s-section>
+        </s-box>
+      </s-page>
+    </form>
+  );
+}