Regenerate checkout docs JSON for 2026-01

.changeset/add-purchase-type-and-recurring-cycle-limit.md

@@ -0,0 +1,5 @@
+---
+'@shopify/ui-extensions': patch
+---
+
+Add purchaseType and recurringCycleLimit subscribable fields to the DiscountsApi for discount function settings extensions.

.changeset/checkbox-rich-label.md

@@ -0,0 +1,5 @@
+---
+'@shopify/ui-extensions': patch
+---
+
+The `label` prop on the checkout and customer-account `s-checkbox` component now accepts a label as a slot in addition to a plain string, label slots can include only plain text and s-links.

.changeset/config.json

@@ -6,7 +6,7 @@
   ],
   "commit": false,
   "fixed": [],
-  "linked": [],
+  "linked": [["@shopify/ui-extensions", "@shopify/ui-extensions-tester"]],
   "access": "restricted",
   "baseBranch": "unstable",
   "updateInternalDependencies": "patch",

.github/workflows/ci.yml

@@ -42,6 +42,38 @@ jobs:
       - name: Lint
         run: yarn lint
 
+  test:
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v4
+      - uses: ./.github/workflows/actions/prepare
+
+      - name: Build packages
+        run: yarn build
+
+      - name: Typecheck ui-extensions-tester (including tests)
+        run: npx tsc --project packages/ui-extensions-tester/tsconfig.typecheck.json
+
+      - name: Test ui-extensions-tester
+        run: npx loom test --no-watch packages/ui-extensions-tester/
+
+      - name: Testing example (checkout)
+        run: npm install && npm run typecheck && npm test
+        working-directory: examples/testing/checkout-basic-testing-example
+
+      - name: Testing example (point-of-sale)
+        run: npm install && npm run typecheck && npm test
+        working-directory: examples/testing/point-of-sale-testing-example
+
+      - name: Testing example (customer-account)
+        run: npm install && npm run typecheck && npm test
+        working-directory: examples/testing/customer-account-testing-example
+
+      - name: Testing example (admin)
+        run: npm install && npm run typecheck && npm test
+        working-directory: examples/testing/admin-testing-example
+
   test-build:
     runs-on: ubuntu-latest
 

.github/workflows/deploy.yml

@@ -14,6 +14,10 @@ on:
       - 20[0-9][0-9]-[01][1470]
       # RC version branches
       - 20[0-9][0-9]-[01][1470]-rc
+  # Snapit trigger - runs when /snapit comment is made on a PR
+  issue_comment:
+    types:
+      - created
 
 concurrency: ${{ github.workflow }}-${{ github.ref }}
 
@@ -46,6 +50,7 @@ jobs:
           NPM_TOKEN: ''
           NPM_CONFIG_PROVENANCE: true
         with:
+          post_install_script: yarn changeset:exit-pre-mode
           build_script: yarn build
           comment_command: /snapit
 

.github/workflows/mdx-migration-notice.yml

@@ -0,0 +1,52 @@
+name: MDX migration notice
+
+on:
+  pull_request_target:
+    types: [opened]
+
+permissions:
+  pull-requests: write
+
+jobs:
+  notify:
+    name: MDX migration notice
+    runs-on: ubuntu-latest
+    timeout-minutes: 2
+    if: ${{ !startsWith(github.head_ref, 'changeset-release/') }}
+    steps:
+      - uses: actions/github-script@v7
+        with:
+          script: |
+            const body = [
+              '## 🚨🚨🚨 Docs migration in progress 🚨🚨🚨',
+              '',
+              'We are actively migrating UI extension reference docs to MDX in the `areas/platforms/shopify-dev` zone of the monorepo. This impacts docs for the following surfaces:',
+              '',
+              '- [Admin UI extensions](https://shopify.dev/docs/api/admin-extensions)',
+              '- [App Home](https://shopify.dev/docs/api/app-home)',
+              '- [Checkout UI extensions](https://shopify.dev/docs/api/checkout-ui-extensions)',
+              '- [Customer account UI extensions](https://shopify.dev/docs/api/customer-account-ui-extensions)',
+              '- [POS UI extensions](https://shopify.dev/docs/api/pos-ui-extensions)',
+              '',
+              'During this migration, please be aware of the following:',
+              '',
+              '**`.doc.ts` files are being deprecated.** Changes to `.doc.ts` files in this repo will **not** be reflected in the new MDX-based docs. If you need to update docs for a reference that has already been migrated, make your changes directly in the `areas/platforms/shopify-dev` zone of the monorepo instead.',
+              '',
+              '**Doc comments in `.ts` source files** (the comment blocks above types and functions) are also affected. Generating docs from these comments currently requires a newer version of the `@shopify/generate-docs` library that isn\'t yet available. Updates to doc comments may not produce the expected output until the migration is complete.',
+              '',
+              '**Examples** that previously lived in this repo are being moved to the `areas/platforms/shopify-dev` zone of the monorepo and should be authored there going forward.',
+              '',
+              '### What should I do?',
+              '',
+              '- If your PR includes changes to **`.doc.ts` files**, **doc comments**, or **examples**, please reach out to us in [#devtools-proj-templated-refs](https://shopify.enterprise.slack.com/archives/C099RJCHAKE) so we can help ensure your updates are captured correctly.',
+              '- If your PR is limited to **source code changes** (non-docs), you can ignore this notice.',
+              '',
+              'Thanks for your patience while we complete the migration! 🙏',
+            ].join('\n');
+
+            await github.rest.issues.createComment({
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              issue_number: context.payload.pull_request.number,
+              body,
+            });

.github/workflows/rc-port-tracker.yml

@@ -0,0 +1,168 @@
+name: RC port tracker
+
+on:
+  pull_request:
+    types: [opened, reopened, closed, edited]
+    branches:
+      - 20[0-9][0-9]-[01][1470]
+      - 20[0-9][0-9]-[01][1470]-rc
+
+permissions:
+  pull-requests: write
+  issues: write
+
+jobs:
+  label-stable-pr:
+    name: Label PRs against stable branches
+    if: |
+      (
+        github.event.action == 'opened' ||
+        github.event.action == 'reopened' ||
+        (github.event.action == 'edited' && github.event.changes.base != null)
+      ) &&
+      !endsWith(github.event.pull_request.base.ref, '-rc') &&
+      !startsWith(github.head_ref, 'changeset-release/') &&
+      !contains(github.event.pull_request.labels.*.name, 'needs-rc-port')
+    runs-on: ubuntu-latest
+    timeout-minutes: 2
+    steps:
+      - uses: actions/github-script@60a0d83039c74a4aee543508d2ffcb1c3799cdea # v7.0.1
+        with:
+          script: |
+            const LABEL = 'needs-rc-port';
+            const { owner, repo } = context.repo;
+            const pr = context.payload.pull_request;
+
+            const branches = await github.paginate(github.rest.repos.listBranches, {
+              owner, repo, per_page: 100,
+            });
+            const branchNames = branches.map(b => b.name);
+
+            const stableBranches = branchNames
+              .filter(n => /^\d{4}-(?:01|04|07|10)$/.test(n))
+              .sort();
+            const latestStable = stableBranches[stableBranches.length - 1];
+
+            if (pr.base.ref !== latestStable) return;
+
+            await github.rest.issues.addLabels({
+              owner, repo, issue_number: pr.number, labels: [LABEL],
+            });
+
+            const rcBranches = branchNames
+              .filter(n => /^\d{4}-(?:01|04|07|10)-rc$/.test(n))
+              .sort();
+            const latestRc = rcBranches[rcBranches.length - 1];
+            const rcLabel = latestRc ? `\`${latestRc}\`` : 'the current RC branch';
+
+            const body = [
+              `This PR targets a stable release branch (\`${pr.base.ref}\`). Once merged, the change typically also needs to be forward-ported to ${rcLabel} so it ships in the next release.`,
+              '',
+              `When you open the forward-port PR, include a line like this in its body so the \`${LABEL}\` label gets removed automatically when that PR merges:`,
+              '',
+              '```',
+              `Forward-port of #${pr.number}`,
+              '```',
+              '',
+              'Accepted formats (comma-separated for multiple):',
+              `- \`#${pr.number}\``,
+              `- \`GH-${pr.number}\``,
+              `- \`${pr.number}\``,
+              `- \`https://github.com/${owner}/${repo}/pull/${pr.number}\``,
+              '',
+              `If a forward-port isn't needed (e.g., the change is stable-only), you can remove the \`${LABEL}\` label manually.`,
+            ].join('\n');
+
+            await github.rest.issues.createComment({
+              owner, repo, issue_number: pr.number, body,
+            });
+
+  process-rc-merge:
+    name: Process forward-port references on RC merge
+    if: |
+      github.event.action == 'closed' &&
+      github.event.pull_request.merged == true &&
+      endsWith(github.event.pull_request.base.ref, '-rc')
+    runs-on: ubuntu-latest
+    timeout-minutes: 2
+    steps:
+      - uses: actions/github-script@60a0d83039c74a4aee543508d2ffcb1c3799cdea # v7.0.1
+        with:
+          script: |
+            const LABEL = 'needs-rc-port';
+            const { owner, repo } = context.repo;
+            const pr = context.payload.pull_request;
+            const body = pr.body || '';
+
+            const refs = new Set();
+            const crossRepo = [];
+
+            const blockRegex = /forward-port\s+of:?\s*(.*?)(?:\n\s*\n|$)/gis;
+            for (const match of body.matchAll(blockRegex)) {
+              const tokens = match[1].split(/[\s,;]+/).filter(Boolean);
+              for (const token of tokens) {
+                if (/^(?:-|\*|and|&)$/i.test(token)) continue;
+
+                const url = token.match(/^https?:\/\/github\.com\/([^/]+)\/([^/]+)\/pull\/(\d+)\/?$/i);
+                if (url) {
+                  const [, urlOwner, urlRepo, num] = url;
+                  if (urlOwner.toLowerCase() === owner.toLowerCase() &&
+                      urlRepo.toLowerCase() === repo.toLowerCase()) {
+                    refs.add(parseInt(num, 10));
+                  } else {
+                    crossRepo.push(token);
+                  }
+                  continue;
+                }
+
+                const num = token.match(/^(?:#|GH-)?(\d+)$/i);
+                if (num) refs.add(parseInt(num[1], 10));
+              }
+            }
+
+            if (crossRepo.length) {
+              await github.rest.issues.createComment({
+                owner, repo, issue_number: pr.number,
+                body: `⚠️ The following forward-port references point to a different repository and were ignored:\n${crossRepo.map(r => `- ${r}`).join('\n')}`,
+              });
+            }
+
+            if (refs.size === 0) return;
+
+            for (const num of refs) {
+              try {
+                const { data: ref } = await github.rest.pulls.get({
+                  owner, repo, pull_number: num,
+                });
+
+                if (/-rc$/.test(ref.base.ref)) {
+                  await github.rest.issues.createComment({
+                    owner, repo, issue_number: pr.number,
+                    body: `⚠️ Skipping #${num}: it targets \`${ref.base.ref}\`, not a stable branch.`,
+                  });
+                  continue;
+                }
+
+                try {
+                  await github.rest.issues.removeLabel({
+                    owner, repo, issue_number: num, name: LABEL,
+                  });
+                } catch (e) {
+                  if (e.status !== 404) throw e;
+                }
+
+                await github.rest.issues.createComment({
+                  owner, repo, issue_number: num,
+                  body: `✓ Forward-ported in #${pr.number}.`,
+                });
+              } catch (e) {
+                if (e.status === 404) {
+                  await github.rest.issues.createComment({
+                    owner, repo, issue_number: pr.number,
+                    body: `⚠️ Forward-port reference #${num} could not be found.`,
+                  });
+                  continue;
+                }
+                throw e;
+              }
+            }