Match existing checkout extension APIs#4488
Draft
andy-chhuon wants to merge 427 commits into
Draft
Conversation
2026 04 rc v2
Port enriched JSDoc descriptions from checkout-web (shop/world#548830) to ui-extensions 2026-04-rc. Covers all 16 Checkout APIs across 10 files: shared types, StandardApi, CheckoutApi, OrderConfirmationApi, cart line, shipping option, pickup location, and pickup point APIs. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
The boolean represents consent granted, not opt-out. Align with the corrected checkout-web description. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Re-apply the full checkout-web diff after review feedback. Includes updated descriptions for localizedFields, applyTrackingConsentChange, and other refinements from PR review. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Re-apply full checkout-web diff with review feedback. Includes
{API_VERSION} placeholder URLs, updated descriptions, and Shopify
Function link fixes. All fully qualified URLs preserved.
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
…iptions-2026-04-rc Enrich JSDoc for Checkout APIs property descriptions, 2026-04-rc
… for media and visuals components (#4205) * Description improvements for media and visuals components Made-with: Cursor * Revise command and commandFor descriptions under map marker * Restore change
Update JSDoc comments on StandardApi properties, shared types, and
Capability descriptions. Regenerate generated_docs_data_v2.json.
Addresses review feedback:
- Remove .doc.ts, examples, and static generated files from PR
- Use {API_VERSION} in all version-specific links
- Embed @see links in description text
- Lowercase "web pixels" with updated URL
- Capitalize Capability descriptions
- Add BCP-47 link to Language JSDoc
Made-with: Cursor
…tip, Sheet) (#4236) Made-with: Cursor
…ptions-2026-04-rc
…-descriptions-2026-04-rc [Customer account UI extensions 2026-04-rc]: Platform APIs descriptions
Adding in types for purchaseType and recurringCycleLimit fields
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
…-2026-04-rc Add missing target overview screenshots to checkout (2026-04-rc)
…2026-07-rc Use shopify-docs runner for shopify-dev preview automation
james-a-c
force-pushed
the
graphite-base/4488
branch
from
a475b3b to
e06538a
Compare
fix: mark admin props as optional (remove required) -- fwd port
Co-authored-by: AI (Pi/GPT-5.5) <noreply@pi.dev>
…s-2026-07 Document POS discount allocation API version
Extends IntentAction to include 'pick', IntentType to include 'shopify/File', and updates JSDoc for IntentInvokeApi to document file-picking workflows with example usage.
Version Packages (2026-07-rc) (rc.6)
Add generated checkout and customer account UI extension Section declarations and docs data for the existing padding prop. Public API consumers can now pass padding="base" or padding="none" to s-section on both surfaces. Orchestrated-by: ae <noreply@shopify.com> Co-authored-by: GPT-5.5 <noreply@openai.com>
Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
[File Picker Intent] add File picker intent type and action to public Intents API types
Runs `docs:admin 2026-07-rc` to bring the admin-surface generated docs current with source, including the `pick` action and `shopify/File` resource type added in #4499. Same pattern as #4457 (checkout). Needed so the File-picker reference (`pick:shopify/File`) renders in the <TypeDefinition> on shopify.dev. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Regenerate admin docs JSON for 2026-07-rc
Add a README for the Admin UI extensions docs sync workflow, including the required final App Bridge docs sync step from Shopify/extensibility to preserve merged App Home component docs.
### Background Admin UI extensions docs are generated from `Shopify/ui-extensions` and copied into `shopify-dev`. There is a required follow-up sync from `Shopify/extensibility` that needs to run last so App Home docs keep merged App Bridge and Polaris component data. ### Solution - Add `packages/ui-extensions/docs/surfaces/admin/README.md` documenting the safe sync order. - Call out that `docs:sync` must be rerun whenever `docs:admin` is rerun afterward. - Include a copy-paste-safe `2026-04` command sequence. ### 🎩 Docs-only change. Self-reviewed the command order and verified shell commands are each on a single copy-paste-safe line. ### Checklist - [x] I have updated relevant documentation
These files under docs/surfaces/point-of-sale/staticPages/examples/ and docs/surfaces/point-of-sale/mdxExamples/ were missed in the cleanup after the new docs rollout. Their examples now live in the docs repo as code block source files, so they're no longer needed here. Also removes the now-stale 'mdxExamples/' eslint ignore pattern.
The buyerJourney property's JSDoc pointed at
/docs/api/checkout-ui-extensions/.../apis/buyer-journey#examples, which 404s
under /latest. The docs were reorganized from apis/<name> to
target-apis/checkout-apis/<name>-api, and the #examples anchor no longer
exists (examples now render via the example switcher). This removes the
self-referential statement, mirroring World commit 80249b ("Remove
self-referential link in buyerJourney prop JSDoc").
Source-only change: the committed
docs/surfaces/checkout/generated/generated_docs_data_v2.json artifact still
needs to be regenerated via `pnpm docs:checkout` for the rendered shopify.dev
page to update.
Reported-by: Kristin Hung <kristin.hung@shopify.com>
…llocations Add optional discountAllocations field to pos bundle lineItemComponent
…2026-07-rc Remove dangling buyer-journey #examples link from buyerJourney JSDoc (2026-07-rc)
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
20 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Background
(Provide a link to any relevant issues AND provide a TLDR of the issue in this pull request)
Solution
(Describe your solution, why this approach was chosen, and what the alternatives/impacts may be)
🎩
Checklist