@jay-framework/wix-cart 0.15.0

package/dist/contracts/cart-indicator.jay-contract

@@ -0,0 +1,43 @@
+name: cart-indicator
+description: Cart indicator component showing item count, typically used in site header/navigation
+
+tags:
+  # Cart count
+  - tag: itemCount
+    type: data
+    dataType: number
+    phase: fast+interactive
+    description: Total number of items in cart
+    
+  - tag: hasItems
+    type: variant
+    dataType: boolean
+    phase: fast+interactive
+    description: Whether cart has any items
+
+  # Interactive elements
+  - tag: cartButton
+    type: interactive
+    elementType: HTMLButtonElement
+    description: Button to open cart (mini-cart or navigate to cart page)
+    
+  - tag: cartLink
+    type: interactive
+    elementType: HTMLAnchorElement
+    description: Link to cart page
+    
+  # Loading state
+  - tag: isLoading
+    type: variant
+    dataType: boolean
+    phase: fast+interactive
+    description: Whether cart data is loading
+    
+  # Animation trigger for when item is added
+  - tag: justAdded
+    type: variant
+    dataType: boolean
+    phase: fast+interactive
+    description: Briefly true after an item is added (for animation)
+
+

package/dist/contracts/cart-indicator.jay-contract.d.ts

@@ -0,0 +1,29 @@
+import {HTMLElementCollectionProxy, HTMLElementProxy, JayContract} from "@jay-framework/runtime";
+
+
+export interface CartIndicatorViewState {
+  itemCount: number,
+  hasItems: boolean,
+  isLoading: boolean,
+  justAdded: boolean
+}
+
+export type CartIndicatorSlowViewState = {};
+
+export type CartIndicatorFastViewState = Pick<CartIndicatorViewState, 'itemCount' | 'hasItems' | 'isLoading' | 'justAdded'>;
+
+export type CartIndicatorInteractiveViewState = Pick<CartIndicatorViewState, 'itemCount' | 'hasItems' | 'isLoading' | 'justAdded'>;
+
+
+export interface CartIndicatorRefs {
+  cartButton: HTMLElementProxy<CartIndicatorViewState, HTMLButtonElement>,
+  cartLink: HTMLElementProxy<CartIndicatorViewState, HTMLAnchorElement>
+}
+
+
+export interface CartIndicatorRepeatedRefs {
+  cartButton: HTMLElementCollectionProxy<CartIndicatorViewState, HTMLButtonElement>,
+  cartLink: HTMLElementCollectionProxy<CartIndicatorViewState, HTMLAnchorElement>
+}
+
+export type CartIndicatorContract = JayContract<CartIndicatorViewState, CartIndicatorRefs, CartIndicatorSlowViewState, CartIndicatorFastViewState, CartIndicatorInteractiveViewState>

package/dist/contracts/cart-page.jay-contract

@@ -0,0 +1,328 @@
+name: cart-page
+description: Full cart page showing all items, quantities, totals, and checkout actions
+
+tags:
+  # Cart identity
+  - tag: cartId
+    type: data
+    dataType: string
+    description: Cart GUID
+    
+  # Cart state
+  - tag: isEmpty
+    type: variant
+    dataType: boolean
+    phase: fast+interactive
+    description: Whether cart is empty
+    
+  - tag: isLoading
+    type: variant
+    dataType: boolean
+    phase: fast+interactive
+    description: Whether cart is loading/updating
+    
+  # Line items
+  - tag: lineItems
+    type: sub-contract
+    repeated: true
+    trackBy: lineItemId
+    phase: fast+interactive
+    description: Items in the cart
+    tags:
+      - tag: lineItemId
+        type: data
+        dataType: string
+        description: Line item GUID
+        
+      - tag: productId
+        type: data
+        dataType: string
+        description: Product GUID
+        
+      - tag: productName
+        type: data
+        dataType: string
+        description: Product name
+        
+      - tag: productUrl
+        type: data
+        dataType: string
+        description: URL to product page
+        
+      - tag: productLink
+        type: interactive
+        elementType: HTMLAnchorElement
+        description: Link to product page
+        
+      # Variant/options info
+      - tag: variantName
+        type: data
+        dataType: string
+        description: Selected variant description (e.g., "Blue / Large")
+        
+      - tag: sku
+        type: data
+        dataType: string
+        description: Product/variant SKU
+        
+      # Media
+      - tag: image
+        type: sub-contract
+        description: Product thumbnail
+        tags:
+          - tag: url
+            type: data
+            dataType: string
+            description: Image URL
+            
+          - tag: altText
+            type: data
+            dataType: string
+            description: Image alt text
+            
+      # Quantity
+      - tag: quantity
+        type: [data, interactive]
+        dataType: number
+        elementType: HTMLInputElement
+        description: Item quantity
+        
+      - tag: decrementButton
+        type: interactive
+        elementType: HTMLButtonElement
+        description: Decrease quantity button
+        
+      - tag: incrementButton
+        type: interactive
+        elementType: HTMLButtonElement
+        description: Increase quantity button
+        
+      - tag: isUpdatingQuantity
+        type: variant
+        dataType: boolean
+        description: Whether quantity is being updated
+        
+      # Price per item
+      - tag: unitPrice
+        type: sub-contract
+        description: Price per unit
+        tags:
+          - tag: amount
+            type: data
+            dataType: string
+            description: Unit price amount
+            
+          - tag: formattedAmount
+            type: data
+            dataType: string
+            description: Formatted unit price
+            
+      # Line total (quantity * unit price)
+      - tag: lineTotal
+        type: sub-contract
+        description: Total for this line item
+        tags:
+          - tag: amount
+            type: data
+            dataType: string
+            description: Line total amount
+            
+          - tag: formattedAmount
+            type: data
+            dataType: string
+            description: Formatted line total
+            
+      # Discount on line item
+      - tag: lineDiscount
+        type: sub-contract
+        description: Discount applied to this line
+        tags:
+          - tag: amount
+            type: data
+            dataType: string
+            description: Discount amount
+            
+          - tag: formattedAmount
+            type: data
+            dataType: string
+            description: Formatted discount
+            
+      - tag: hasDiscount
+        type: variant
+        dataType: boolean
+        description: Whether line has a discount
+        
+      # Remove item
+      - tag: removeButton
+        type: interactive
+        elementType: HTMLButtonElement
+        description: Remove item from cart button
+        
+      - tag: isRemoving
+        type: variant
+        dataType: boolean
+        description: Whether item is being removed
+        
+  # Cart summary
+  - tag: summary
+    type: sub-contract
+    phase: fast+interactive
+    description: Cart totals and summary
+    tags:
+      - tag: itemCount
+        type: data
+        dataType: number
+        description: Total number of items
+        
+      - tag: subtotal
+        type: sub-contract
+        description: Cart subtotal before discounts/shipping
+        tags:
+          - tag: amount
+            type: data
+            dataType: string
+            description: Subtotal amount
+            
+          - tag: formattedAmount
+            type: data
+            dataType: string
+            description: Formatted subtotal
+            
+      - tag: discount
+        type: sub-contract
+        description: Total discounts applied
+        tags:
+          - tag: amount
+            type: data
+            dataType: string
+            description: Discount amount
+            
+          - tag: formattedAmount
+            type: data
+            dataType: string
+            description: Formatted discount
+            
+      - tag: hasDiscount
+        type: variant
+        dataType: boolean
+        description: Whether cart has any discounts
+        
+      - tag: estimatedTax
+        type: sub-contract
+        description: Estimated tax (if calculable)
+        tags:
+          - tag: amount
+            type: data
+            dataType: string
+            description: Tax amount
+            
+          - tag: formattedAmount
+            type: data
+            dataType: string
+            description: Formatted tax
+            
+      - tag: showTax
+        type: variant
+        dataType: boolean
+        description: Whether to show tax estimate
+        
+      - tag: estimatedTotal
+        type: sub-contract
+        description: Estimated order total
+        tags:
+          - tag: amount
+            type: data
+            dataType: string
+            description: Total amount
+            
+          - tag: formattedAmount
+            type: data
+            dataType: string
+            description: Formatted total
+            
+      - tag: currency
+        type: data
+        dataType: string
+        description: Currency code (e.g., "USD")
+        
+  # Coupon/promo code
+  - tag: coupon
+    type: sub-contract
+    phase: fast+interactive
+    description: Coupon code input and application
+    tags:
+      - tag: code
+        type: [data, interactive]
+        dataType: string
+        elementType: HTMLInputElement
+        description: Coupon code input
+        
+      - tag: applyButton
+        type: interactive
+        elementType: HTMLButtonElement
+        description: Apply coupon button
+        
+      - tag: isApplying
+        type: variant
+        dataType: boolean
+        description: Whether coupon is being applied
+        
+      - tag: appliedCode
+        type: data
+        dataType: string
+        description: Currently applied coupon code (empty if none)
+        
+      - tag: hasAppliedCoupon
+        type: variant
+        dataType: boolean
+        description: Whether a coupon is applied
+        
+      - tag: removeButton
+        type: interactive
+        elementType: HTMLButtonElement
+        description: Remove applied coupon button
+        
+      - tag: errorMessage
+        type: data
+        dataType: string
+        description: Error message if coupon invalid
+        
+      - tag: hasError
+        type: variant
+        dataType: boolean
+        description: Whether there's a coupon error
+        
+  # Cart actions
+  - tag: checkoutButton
+    type: interactive
+    elementType: HTMLButtonElement
+    description: Proceed to checkout button
+    
+  - tag: continueShoppingLink
+    type: interactive
+    elementType: HTMLAnchorElement
+    description: Continue shopping link
+    
+  - tag: clearCartButton
+    type: interactive
+    elementType: HTMLButtonElement
+    description: Clear all items from cart
+    
+  - tag: isCheckingOut
+    type: variant
+    dataType: boolean
+    phase: fast+interactive
+    description: Whether checkout is in progress
+    
+  # Empty cart state
+  - tag: emptyCartMessage
+    type: data
+    dataType: string
+    description: Message to show when cart is empty
+    
+  - tag: emptyCartLink
+    type: interactive
+    elementType: HTMLAnchorElement
+    description: Link to start shopping (when cart empty)
+
+

package/dist/contracts/cart-page.jay-contract.d.ts

@@ -0,0 +1,146 @@
+import {HTMLElementCollectionProxy, HTMLElementProxy, JayContract} from "@jay-framework/runtime";
+
+
+export interface ImageOfLineItemOfCartPageViewState {
+  url: string,
+  altText: string
+}
+
+export interface UnitPriceOfLineItemOfCartPageViewState {
+  amount: string,
+  formattedAmount: string
+}
+
+export interface LineTotalOfLineItemOfCartPageViewState {
+  amount: string,
+  formattedAmount: string
+}
+
+export interface LineDiscountOfLineItemOfCartPageViewState {
+  amount: string,
+  formattedAmount: string
+}
+
+export interface LineItemOfCartPageViewState {
+  lineItemId: string,
+  productId: string,
+  productName: string,
+  productUrl: string,
+  variantName: string,
+  sku: string,
+  image: ImageOfLineItemOfCartPageViewState,
+  quantity: number,
+  isUpdatingQuantity: boolean,
+  unitPrice: UnitPriceOfLineItemOfCartPageViewState,
+  lineTotal: LineTotalOfLineItemOfCartPageViewState,
+  lineDiscount: LineDiscountOfLineItemOfCartPageViewState,
+  hasDiscount: boolean,
+  isRemoving: boolean
+}
+
+export interface SubtotalOfSummaryOfCartPageViewState {
+  amount: string,
+  formattedAmount: string
+}
+
+export interface DiscountOfSummaryOfCartPageViewState {
+  amount: string,
+  formattedAmount: string
+}
+
+export interface EstimatedTaxOfSummaryOfCartPageViewState {
+  amount: string,
+  formattedAmount: string
+}
+
+export interface EstimatedTotalOfSummaryOfCartPageViewState {
+  amount: string,
+  formattedAmount: string
+}
+
+export interface SummaryOfCartPageViewState {
+  itemCount: number,
+  subtotal: SubtotalOfSummaryOfCartPageViewState,
+  discount: DiscountOfSummaryOfCartPageViewState,
+  hasDiscount: boolean,
+  estimatedTax: EstimatedTaxOfSummaryOfCartPageViewState,
+  showTax: boolean,
+  estimatedTotal: EstimatedTotalOfSummaryOfCartPageViewState,
+  currency: string
+}
+
+export interface CouponOfCartPageViewState {
+  code: string,
+  isApplying: boolean,
+  appliedCode: string,
+  hasAppliedCoupon: boolean,
+  errorMessage: string,
+  hasError: boolean
+}
+
+export interface CartPageViewState {
+  cartId: string,
+  isEmpty: boolean,
+  isLoading: boolean,
+  lineItems: Array<LineItemOfCartPageViewState>,
+  summary: SummaryOfCartPageViewState,
+  coupon: CouponOfCartPageViewState,
+  isCheckingOut: boolean,
+  emptyCartMessage: string
+}
+
+export type CartPageSlowViewState = Pick<CartPageViewState, 'cartId' | 'emptyCartMessage'>;
+
+export type CartPageFastViewState = Pick<CartPageViewState, 'isEmpty' | 'isLoading' | 'isCheckingOut'> & {
+    lineItems: Array<CartPageViewState['lineItems'][number]>;
+    summary: CartPageViewState['summary'];
+    coupon: CartPageViewState['coupon'];
+};
+
+export type CartPageInteractiveViewState = Pick<CartPageViewState, 'isEmpty' | 'isLoading' | 'isCheckingOut'> & {
+    lineItems: Array<CartPageViewState['lineItems'][number]>;
+    summary: CartPageViewState['summary'];
+    coupon: CartPageViewState['coupon'];
+};
+
+
+export interface CartPageRefs {
+  checkoutButton: HTMLElementProxy<CartPageViewState, HTMLButtonElement>,
+  continueShoppingLink: HTMLElementProxy<CartPageViewState, HTMLAnchorElement>,
+  clearCartButton: HTMLElementProxy<CartPageViewState, HTMLButtonElement>,
+  emptyCartLink: HTMLElementProxy<CartPageViewState, HTMLAnchorElement>,
+  lineItems: {
+    productLink: HTMLElementCollectionProxy<LineItemOfCartPageViewState, HTMLAnchorElement>,
+    quantity: HTMLElementCollectionProxy<LineItemOfCartPageViewState, HTMLInputElement>,
+    decrementButton: HTMLElementCollectionProxy<LineItemOfCartPageViewState, HTMLButtonElement>,
+    incrementButton: HTMLElementCollectionProxy<LineItemOfCartPageViewState, HTMLButtonElement>,
+    removeButton: HTMLElementCollectionProxy<LineItemOfCartPageViewState, HTMLButtonElement>
+  },
+  coupon: {
+    code: HTMLElementProxy<CouponOfCartPageViewState, HTMLInputElement>,
+    applyButton: HTMLElementProxy<CouponOfCartPageViewState, HTMLButtonElement>,
+    removeButton: HTMLElementProxy<CouponOfCartPageViewState, HTMLButtonElement>
+  }
+}
+
+
+export interface CartPageRepeatedRefs {
+  checkoutButton: HTMLElementCollectionProxy<CartPageViewState, HTMLButtonElement>,
+  continueShoppingLink: HTMLElementCollectionProxy<CartPageViewState, HTMLAnchorElement>,
+  clearCartButton: HTMLElementCollectionProxy<CartPageViewState, HTMLButtonElement>,
+  emptyCartLink: HTMLElementCollectionProxy<CartPageViewState, HTMLAnchorElement>,
+  lineItems: {
+    productLink: HTMLElementCollectionProxy<LineItemOfCartPageViewState, HTMLAnchorElement>,
+    quantity: HTMLElementCollectionProxy<LineItemOfCartPageViewState, HTMLInputElement>,
+    decrementButton: HTMLElementCollectionProxy<LineItemOfCartPageViewState, HTMLButtonElement>,
+    incrementButton: HTMLElementCollectionProxy<LineItemOfCartPageViewState, HTMLButtonElement>,
+    removeButton: HTMLElementCollectionProxy<LineItemOfCartPageViewState, HTMLButtonElement>
+  },
+  coupon: {
+    code: HTMLElementCollectionProxy<CouponOfCartPageViewState, HTMLInputElement>,
+    applyButton: HTMLElementCollectionProxy<CouponOfCartPageViewState, HTMLButtonElement>,
+    removeButton: HTMLElementCollectionProxy<CouponOfCartPageViewState, HTMLButtonElement>
+  }
+}
+
+export type CartPageContract = JayContract<CartPageViewState, CartPageRefs, CartPageSlowViewState, CartPageFastViewState, CartPageInteractiveViewState>