✨ feat(stories): add HostedCart stories in document package#774
Merged
Conversation
Add DocsPage with ArgTypes, Source and 4 Canvas stories: - Default (inline cart iframe) - MiniCart (slide-in panel with open control) - MiniCartOpenAdd (auto-opens on AddToCartButton) - CustomDomain Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
acasazza
added
documentation
…ng, remove stale ts-expect-error - Add HostedCart to packages/react-components/src/index.ts exports - Capture accessToken as const token: string after null guard so closures see the narrowed type - Remove unused @ts-expect-error on iframeResizer onMessage (type now resolves correctly) Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
commit: |
- Remove MiniCart and MiniCartOpenAdd stories from HostedCart.stories.tsx - Create MiniCart.stories.tsx under Components/Cart/MiniCart with its own DocsPage - Default story (open toggle via Controls) - OpenOnAdd story (auto-open with AddSampleItems trigger) Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
…+ AddToCartButton - Default story: use local useState + CartLink type='mini' as trigger, wire handleOpen to toggle state so overlay/close button work correctly - OpenOnAdd story: replace AddSampleItems (SDK only) with AddToCartButton which publishes the 'open-cart' event that HostedCart openAdd listens for - Fix DocsPage: add Canvas for both stories, mark open argType as control:false Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
The mini cart panel is position:fixed so it doesn't affect document flow. A 500px min-height decorator ensures the canvas always has visible space regardless of whether the panel is open or closed. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
DocsPage with ArgTypes, Source and 3 Canvas stories: - Default (link to hosted cart) - MiniCartTrigger (type='mini' + HostedCart integration with open state) - ChildrenProps (render prop with custom trigger) Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
…DOMAIN, fix JSDoc
- Destructure `target` from props (no longer swallowed by `...p`)
- Replace `location.href =` with `window.open(url, target ?? '_self')`
- Extract `resolveCartUrl` helper to deduplicate getOrganizationConfig calls
- Add `const token: string = accessToken` narrowing (same pattern as CheckoutLink/HostedCart)
- Extract `DEFAULT_DOMAIN` constant
- Make `handleClick` non-optional in ChildrenProps (always provided)
- Add `event.stopPropagation()` to handleClick
- Fix JSDoc: `<OrderContainer>` → `<Order>`
- Add `target` to parentProps and `<a target={target}>`
- Update CartLink story: add `target` argType
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Apply biome format --write to align all source files with the configured formatter settings (double quotes, no semicolons, ES5 trailing commas). Also: - Exclude large mock file from biome (3.5 MiB exceeds 1 MiB limit) - Fix invalid syntax in _vitest.config.mts (orphaned lines at top of file) Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
acasazza
requested review from
gciotola and
pfferrari
and removed request for
pfferrari
gciotola
approved these changes
May 25, 2026
pfferrari
approved these changes
May 25, 2026
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
3 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.
Summary
Adds a full DocsPage story for
HostedCartunderComponents/Cart/HostedCartin thedocumentpackage.Stories
<iframe>that fills the container, height auto-adjusted byiframe-resizeropentoggle via Controls<AddToCartButton>(openAdd=true)customDomainprop for self-hosted cart appsNotes
OrderStorageinternal helper which auto-creates an order with itemsCheckoutLink.stories.tsxandAddToCartButton.stories.tsx