Skip to content

docs: add Cart & Multistep Sources concept guide - #358

Merged
vamgan merged 1 commit into
mainfrom
claude/cart-multistep-guide
Jun 29, 2026
Merged

vamgan merged 1 commit into
mainfrom
claude/cart-multistep-guide

Conversation

@vamgan

@vamgan vamgan commented Jun 29, 2026

Copy link
Copy Markdown
Collaborator

Summary

Adds a concept guide for the two stateful sources that compute their own snapshots — completing the Concepts coverage of the source family started by the Custom Sources guide.

What's included

  • New site/docs/guide/cart-multistep.md:
    • useAskableCartSource — items + totals in, a computed AskableCartSourceSnapshot out (itemCount / totalQuantity / subtotal / total / currency / couponCode / isEmpty / lastModifiedAt); mutators addItem / removeItem / updateQuantity / setItems / setTotals / clearCart.
    • useAskableMultistepSource — steps in, a computed AskableMultistepSourceSnapshot out (currentIndex / progressPercent / isFirstStep / isLastStep / isComplete / timestamps); navigation next / prev / goTo / complete / setError / reset.
    • The createAskableCartSource / createAskableMultistepSource core-factory path for non-hook usage.
  • Wired into the Concepts sidebar after "Custom Sources".

Notes

  • Every snapshot field, option, and mutator name was verified against packages/core/src/cart-source.ts, multistep-source.ts, and the React hook result types. Docs-only; no code changes.

Test plan

  • vitepress build clean (no dead links)
  • CI preview/build green

🤖 Generated with Claude Code


Generated by Claude Code

Documents the two stateful sources that compute their own snapshots:
useAskableCartSource (items + totals -> itemCount/subtotal/total/etc. with
add/remove/updateQuantity/setTotals/clearCart) and useAskableMultistepSource
(steps -> currentIndex/progressPercent/isComplete with next/prev/goTo/complete/
setError/reset), plus the core factory equivalents. Wires it into the Concepts
sidebar after Custom Sources.
@vercel

vercel Bot commented Jun 29, 2026 •

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
askable Ready Ready Preview, Comment Jun 29, 2026 6:34am

@vamgan
vamgan merged commit bbe4bff into main Jun 29, 2026
3 checks passed
@vamgan
vamgan deleted the claude/cart-multistep-guide branch June 29, 2026 06:34

This branch was successfully deployed

1 active deployment
Preview — 90a8a63f Deployed Jun 29, 2026 by vercel[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants