Shopify
diff --git a/‎.github/workflows/deploy.yml‎
Lines changed: 31 additions & 0 deletions b/‎.github/workflows/deploy.yml‎
Lines changed: 31 additions & 0 deletions
diff --git a/‎.github/workflows/snapit.yml‎
Lines changed: 0 additions & 26 deletions b/‎.github/workflows/snapit.yml‎
Lines changed: 0 additions & 26 deletions
diff --git a/‎packages/ui-extensions/CHANGELOG.md‎
Lines changed: 42 additions & 0 deletions b/‎packages/ui-extensions/CHANGELOG.md‎
Lines changed: 42 additions & 0 deletions
diff --git a/‎packages/ui-extensions/docs/surfaces/admin/build-doc-extract-icons.mjs‎
Lines changed: 63 additions & 0 deletions b/‎packages/ui-extensions/docs/surfaces/admin/build-doc-extract-icons.mjs‎
Lines changed: 63 additions & 0 deletions
diff --git a/‎packages/ui-extensions/docs/surfaces/admin/build-docs.mjs‎
Lines changed: 66 additions & 0 deletions b/‎packages/ui-extensions/docs/surfaces/admin/build-docs.mjs‎
Lines changed: 66 additions & 0 deletions
diff --git a/‎packages/ui-extensions/docs/surfaces/admin/staticPages/admin-extensions.ext.doc.ts‎
Lines changed: 18 additions & 0 deletions b/‎packages/ui-extensions/docs/surfaces/admin/staticPages/admin-extensions.ext.doc.ts‎
Lines changed: 18 additions & 0 deletions
diff --git a/‎packages/ui-extensions/docs/surfaces/admin/templates/icon-renderer/dark-mode-listener.jsx‎
Lines changed: 38 additions & 0 deletions b/‎packages/ui-extensions/docs/surfaces/admin/templates/icon-renderer/dark-mode-listener.jsx‎
Lines changed: 38 additions & 0 deletions
@@ -18,6 +18,37 @@ on:
 concurrency: ${{ github.workflow }}-${{ github.ref }}
 
 jobs:
+  # Snapit job - runs when /snapit comment is made on a PR
+  snapit:
+    name: Snapit
+    if: ${{ github.event_name == 'issue_comment' && github.event.issue.pull_request && github.event.comment.body == '/snapit' }}
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      pull-requests: write
+      id-token: write
+    steps:
+      # WARNING: DO NOT RUN ANY CUSTOM LOCAL SCRIPT BEFORE RUNNING THE SNAPIT ACTION
+      # This action can be executed by 3rd party users and it should not be able to run arbitrary code from a PR.
+      - uses: actions/checkout@v4
+        with:
+          token: ${{ secrets.SHOPIFY_GH_ACCESS_TOKEN }}
+
+      - uses: ./.github/workflows/actions/prepare
+
+      - name: Update npm to 11.7
+        run: npm install -g [email protected]
+
+      - name: Create snapshot
+        uses: Shopify/[email protected]
+        env:
+          GITHUB_TOKEN: ${{ secrets.SHOPIFY_GH_ACCESS_TOKEN }}
+          NPM_TOKEN: ''
+          NPM_CONFIG_PROVENANCE: true
+        with:
+          build_script: yarn build
+          comment_command: /snapit
+
   changesets:
     name: Deploy
     runs-on: ubuntu-latest
 
@@ -44,6 +44,48 @@
 
 - [#3521](https://github.com/Shopify/ui-extensions/pull/3521) [`9f7afff`](https://github.com/Shopify/ui-extensions/commit/9f7afffcef86bcc8c6a9fef89ada580351082d9c) Thanks [@lrsterrett](https://github.com/lrsterrett)! - 2026.1.0-rc release
 
+## 2025.10.12
+
+### Patch Changes
+
+- [#3706](https://github.com/Shopify/ui-extensions/pull/3706) [`2112c03`](https://github.com/Shopify/ui-extensions/commit/2112c03726ae401d95cfaace496005cc839b7007) Thanks [@billfienberg](https://github.com/billfienberg)! - Add admin.app.tools.data extension target
+
+## 2025.10.11
+
+### Patch Changes
+
+- [#3669](https://github.com/Shopify/ui-extensions/pull/3669) [`115be91`](https://github.com/Shopify/ui-extensions/commit/115be91001aa754eb19fade5015f702a4f304a42) Thanks [@fatbattk](https://github.com/fatbattk)! - Sync latest tag
+
+## 2025.10.10
+
+### Patch Changes
+
+- [#3665](https://github.com/Shopify/ui-extensions/pull/3665) [`34010b8`](https://github.com/Shopify/ui-extensions/commit/34010b8cf3a2dff7cf5fd86e3e0828af67efa529) Thanks [@vctrchu](https://github.com/vctrchu)! - Fix npm latest tag for 2025-10
+
+## 2025.10.9
+
+### Patch Changes
+
+- [#3600](https://github.com/Shopify/ui-extensions/pull/3600) [`57ba7dc`](https://github.com/Shopify/ui-extensions/commit/57ba7dc2e3f97fb64bf1e04d228c62c8248c2671) Thanks [@BrittaEvansFenton](https://github.com/BrittaEvansFenton)! - Adds alt prop to POS Image
+
+- [#3632](https://github.com/Shopify/ui-extensions/pull/3632) [`3f04401`](https://github.com/Shopify/ui-extensions/commit/3f04401f7dfbd91c6e5d31a97922fb043eba5bc2) Thanks [@vctrchu](https://github.com/vctrchu)! - Remove CameraScanner dev doc examples from Standard API
+
+- [#3586](https://github.com/Shopify/ui-extensions/pull/3586) [`f9ab867`](https://github.com/Shopify/ui-extensions/commit/f9ab867be2e7f2865098824bfd8f64a3c22bfa6f) Thanks [@chadcromwell](https://github.com/chadcromwell)! - Add optional tipAmount field to POS transaction data types
+
+## 2025.10.8
+
+### Patch Changes
+
+- [#3575](https://github.com/Shopify/ui-extensions/pull/3575) [`f27f6da`](https://github.com/Shopify/ui-extensions/commit/f27f6da4b22fc5e9cb282ca62c586f5e3b96dde7) Thanks [@alexgraffeocohen](https://github.com/alexgraffeocohen)! - Exports LineItemComponent from point-of-sale API so POS can import the type
+
+- [#3555](https://github.com/Shopify/ui-extensions/pull/3555) [`3296915`](https://github.com/Shopify/ui-extensions/commit/32969157fe427b384c95e27e762c07f8dd4b0440) Thanks [@vctrchu](https://github.com/vctrchu)! - Expose Il8n type to POS UI extensions
+
+## 2025.10.7
+
+### Patch Changes
+
+- [#3537](https://github.com/Shopify/ui-extensions/pull/3537) [`9c741e3`](https://github.com/Shopify/ui-extensions/commit/9c741e351ae26ebba94e0c83e4625f6f55041575) Thanks [@alexgraffeocohen](https://github.com/alexgraffeocohen)! - Adds components to point of sale cart LineItem interface to represent product bundle items.
+
 ## 2025.10.6
 
 ### Patch Changes
 
@@ -0,0 +1,63 @@
+import fs from 'fs/promises';
+import path from 'path';
+import {fileURLToPath} from 'url';
+import ts from 'typescript';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+
+const componentsPath = path.join(
+  __dirname,
+  '../../../src/surfaces/admin/components.d.ts',
+);
+
+export async function extractIconList() {
+  const content = await fs.readFile(componentsPath, 'utf-8');
+
+  const sourceFile = ts.createSourceFile(
+    'components.d.ts',
+    content,
+    ts.ScriptTarget.Latest,
+    true,
+  );
+
+  let icons = [];
+
+  function visit(node) {
+    if (ts.isTypeAliasDeclaration(node) && node.name.text === 'IconType$1') {
+      if (ts.isUnionTypeNode(node.type)) {
+        icons = node.type.types
+          .filter((type) => ts.isLiteralTypeNode(type))
+          .map((type) => {
+            if (
+              ts.isStringLiteral(type.literal) ||
+              (type.literal && type.literal.text)
+            ) {
+              return type.literal.text;
+            }
+            return null;
+          })
+          .filter(Boolean);
+      }
+      return;
+    }
+
+    ts.forEachChild(node, visit);
+  }
+
+  visit(sourceFile);
+
+  if (icons.length > 0) {
+    return icons;
+  }
+
+  throw new Error(
+    'Could not find IconType$1 type definition in components.d.ts',
+  );
+}
+
+if (process.argv[1] === fileURLToPath(import.meta.url)) {
+  extractIconList().then((icons) => {
+    console.log(JSON.stringify(icons, null, 2));
+  });
+}
@@ -9,6 +9,7 @@ import {
   copyGeneratedToShopifyDev,
   replaceFileContent,
 } from '../build-doc-shared.mjs';
+import {extractIconList} from './build-doc-extract-icons.mjs';
 
 const EXTENSIONS_API_VERSION = process.argv[2] || 'unstable';
 
@@ -48,6 +49,10 @@ const decodeHTML = (str) => {
     .replace(/&#039;/g, "'");
 };
 
+const escapeForJSTemplate = (str) => {
+  return str.replace(/\\/g, '\\\\').replace(/`/g, '\\`').replace(/\$/g, '\\$');
+};
+
 const composeStyles = (...styles) => {
   return styles
     .filter(Boolean)
@@ -79,6 +84,33 @@ const stylesToString = (styles) => {
     .join('; ');
 };
 
+/**
+ * Renders the JSX template for the icon preview.
+ * @returns The processed HTML string.
+ */
+const renderIconPreviewJsxTemplate = async (iconPreviewData) => {
+  const templatePath = path.join(
+    docsPath,
+    'templates/icon-renderer/jsx-render.html',
+  );
+  const template = await fs.readFile(templatePath, 'utf-8');
+
+  const jsxFilePath = path.join(docsPath, iconPreviewData.jsxFile);
+  let jsxCode = await fs.readFile(jsxFilePath, 'utf-8');
+
+  const iconListString = `[${iconPreviewData.icons
+    .map((icon) => `'${icon}'`)
+    .join(',')}]`;
+  jsxCode = jsxCode.replace(/"__ICON_LIST__"/g, iconListString);
+
+  const escapedJsxCode = escapeForJSTemplate(jsxCode);
+
+  return template
+    .replace(/\{\{COMPOSED_STYLES\}\}/g, iconPreviewData.customStyles || '')
+    .replace(/\{\{BODY_CONTENT\}\}/g, iconPreviewData.bodyContent || '')
+    .replace(/\{\{JSX_CODE\}\}/g, escapedJsxCode);
+};
+
 const htmlWrapper = (htmlString, layoutStyles = '', customStyles = '') => {
   const baseStyles = 'box-sizing: border-box; margin: 0; padding: 0.5rem;';
   const composedStyles = composeStyles(baseStyles, layoutStyles, customStyles);
@@ -221,6 +253,40 @@ const templates = {
 const transformJson = async (filePath, isExtensions) => {
   let jsonData = JSON.parse((await fs.readFile(filePath, 'utf8')).toString());
 
+  const iconEntry = jsonData.find(
+    (entry) => entry.name === 'Icon' && entry.subSections,
+  );
+  if (iconEntry) {
+    const iconDataPath = path.join(srcPath, 'components/Icon/icon-data.json');
+    const iconData = JSON.parse(await fs.readFile(iconDataPath, 'utf-8'));
+    const iconPreviewData = iconData.iconPreviewData;
+
+    iconPreviewData.icons = await extractIconList();
+
+    const subSection = iconEntry.subSections.find((section) =>
+      section.sectionContent?.includes('{{ICON_PREVIEW_IFRAME}}'),
+    );
+    if (subSection) {
+      const html = await renderIconPreviewJsxTemplate(iconPreviewData);
+      // Converting to base64 to avoid having to escape the HTML in the JSX template.
+      const base64Html = Buffer.from(html, 'utf-8').toString('base64');
+      const darkModeListener = await fs.readFile(
+        path.join(docsPath, 'templates/icon-renderer/dark-mode-listener.jsx'),
+        'utf-8',
+      );
+      const base64DarkModeListener = Buffer.from(
+        darkModeListener,
+        'utf-8',
+      ).toString('base64');
+      subSection.sectionContent = subSection.sectionContent.replace(
+        /\{\{ICON_PREVIEW_IFRAME\}\}/g,
+        `<iframe id="icon-preview-iframe" width="100%" height="580px" sandbox="allow-scripts" src="data:text/html;base64,${base64Html}"></iframe>
+        <script src="data:text/javascript;base64,${base64DarkModeListener}"></script>
+        `,
+      );
+    }
+  }
+
   jsonData.forEach((entry) => {
     // Temporary to ensure that isOptional is added to all members
     if (entry.definitions && entry.isVisualComponent) {
 
@@ -200,6 +200,24 @@ If your app is using ESLint, update your configuration to include the new global
         },
       ],
     },
+    {
+      type: 'Generic',
+      anchorLink: 'limitations',
+      title: 'Limitations',
+      sectionContent: `
+As of \`2025-10\`, UI extensions have the following limitations:
+- **File size limit**: Extensions are limited to a maximum of 64 KB when deployed. This limit helps ensure fast loading times and optimal performance.
+`,
+      sectionNotice: [
+        {
+          title: 'Note',
+          sectionContent: `
+The 64 KB limit applies to the compiled extension bundle size upon deployment.
+`,
+          type: 'info',
+        },
+      ],
+    },
     {
       type: 'Generic',
       title: 'Deploying',
 
@@ -0,0 +1,38 @@
+/* eslint-disable no-undef */
+(function () {
+  const initializedIframes = new WeakSet();
+
+  function sendThemeToIframe() {
+    const iframe = document.querySelector('#icon-preview-iframe');
+    if (iframe && iframe.contentWindow) {
+      const isDark = document.documentElement.classList.contains('Mode-Dark');
+      iframe.contentWindow.postMessage(
+        {type: 'theme', mode: isDark ? 'dark' : 'light'},
+        '*',
+      );
+    }
+  }
+
+  const observer = new MutationObserver(() => {
+    const iframe = document.querySelector('#icon-preview-iframe');
+    if (iframe && !initializedIframes.has(iframe)) {
+      initializedIframes.add(iframe);
+      iframe.addEventListener('load', sendThemeToIframe);
+      sendThemeToIframe();
+    }
+  });
+  observer.observe(document.body, {childList: true, subtree: true});
+
+  window.addEventListener('theme-mode-changed', () => {
+    sendThemeToIframe();
+  });
+
+  // Re-send theme when page is restored from cache
+  window.addEventListener('pageshow', (event) => {
+    if (event.persisted) {
+      sendThemeToIframe();
+    }
+  });
+
+  sendThemeToIframe();
+})();