@jay-framework/wix-cart 0.15.5 → 0.15.6

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

@@ -0,0 +1,19 @@
+name: mini-cart
+description: Drawer that auto-opens when a product is added to cart. Place cart content inside.
+
+tags:
+  - tag: isOpen
+    type: variant
+    dataType: boolean
+    phase: fast+interactive
+    description: Whether the mini-cart drawer is currently open
+
+  - tag: openButton
+    type: interactive
+    elementType: HTMLButtonElement
+    description: Button to manually open the mini-cart drawer
+
+  - tag: closeButton
+    type: interactive
+    elementType: HTMLButtonElement
+    description: Button to close the mini-cart drawer

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

@@ -0,0 +1,26 @@
+import {HTMLElementCollectionProxy, HTMLElementProxy, JayContract} from "@jay-framework/runtime";
+
+
+export interface MiniCartViewState {
+  isOpen: boolean
+}
+
+export type MiniCartSlowViewState = {};
+
+export type MiniCartFastViewState = Pick<MiniCartViewState, 'isOpen'>;
+
+export type MiniCartInteractiveViewState = Pick<MiniCartViewState, 'isOpen'>;
+
+
+export interface MiniCartRefs {
+  openButton: HTMLElementProxy<MiniCartViewState, HTMLButtonElement>,
+  closeButton: HTMLElementProxy<MiniCartViewState, HTMLButtonElement>
+}
+
+
+export interface MiniCartRepeatedRefs {
+  openButton: HTMLElementCollectionProxy<MiniCartViewState, HTMLButtonElement>,
+  closeButton: HTMLElementCollectionProxy<MiniCartViewState, HTMLButtonElement>
+}
+
+export type MiniCartContract = JayContract<MiniCartViewState, MiniCartRefs, MiniCartSlowViewState, MiniCartFastViewState, MiniCartInteractiveViewState>

package/dist/{index.client-VoD54p4E.d.ts → index.client-BgJIzp09.d.ts}

@@ -431,6 +431,32 @@ interface CartPageFastCarryForward {
  */
 declare const cartPage: _jay_framework_fullstack_component.JayStackComponentDefinition<CartPageRefs, CartPageSlowViewState, CartPageFastViewState, CartPageInteractiveViewState, [CartPageSlowCarryForward, WixCartService], [Signals<CartPageFastViewState>, CartPageFastCarryForward, WixCartContext], PageProps, {}, _jay_framework_component.JayComponentCore<PageProps, CartPageInteractiveViewState>>;
 
+interface MiniCartViewState {
+  isOpen: boolean
+}
+
+type MiniCartSlowViewState = {};
+
+type MiniCartFastViewState = Pick<MiniCartViewState, 'isOpen'>;
+
+type MiniCartInteractiveViewState = Pick<MiniCartViewState, 'isOpen'>;
+
+
+interface MiniCartRefs {
+  openButton: HTMLElementProxy<MiniCartViewState, HTMLButtonElement>,
+  closeButton: HTMLElementProxy<MiniCartViewState, HTMLButtonElement>
+}
+
+interface MiniCartFastCarryForward {
+}
+/**
+ * Mini Cart Drawer Component
+ *
+ * Auto-opens when a product is added to cart.
+ * Place cart content (e.g., cart-page component) inside in your template.
+ */
+declare const miniCart: _jay_framework_fullstack_component.JayStackComponentDefinition<MiniCartRefs, MiniCartSlowViewState, MiniCartFastViewState, MiniCartInteractiveViewState, [WixCartService], [Signals<MiniCartFastViewState>, MiniCartFastCarryForward, WixCartContext], PageProps, {}, _jay_framework_component.JayComponentCore<PageProps, MiniCartInteractiveViewState>>;
+
 declare const init: _jay_framework_fullstack_component.JayInit<WixCartInitData>;
 
-export { type AddToCartOptions as A, type CartOperationResult as C, type ReactiveCartIndicator as R, type WixCartService as W, WIX_CART_SERVICE as a, WIX_CART_CONTEXT as b, type WixCartContext as c, type WixCartInitData as d, mapCartSummary as e, mapCartToState as f, mapCartToIndicator as g, getEmptyCartState as h, getCurrentCartOrNull as i, estimateCurrentCartTotalsOrNull as j, mapEstimateTotalsToState as k, type CartState as l, mapLineItem as m, type CartLineItem as n, type CartSummary as o, provideWixCartContext as p, type CartIndicatorState as q, cartIndicator as r, cartPage as s, init as t };
+export { type AddToCartOptions as A, type CartOperationResult as C, type ReactiveCartIndicator as R, type WixCartService as W, WIX_CART_SERVICE as a, WIX_CART_CONTEXT as b, type WixCartContext as c, type WixCartInitData as d, mapCartSummary as e, mapCartToState as f, mapCartToIndicator as g, getEmptyCartState as h, getCurrentCartOrNull as i, estimateCurrentCartTotalsOrNull as j, mapEstimateTotalsToState as k, type CartState as l, mapLineItem as m, type CartLineItem as n, type CartSummary as o, provideWixCartContext as p, type CartIndicatorState as q, cartIndicator as r, cartPage as s, miniCart as t, init as u };

package/dist/index.client.d.ts

@@ -1,4 +1,4 @@
-export { A as AddToCartOptions, q as CartIndicatorState, n as CartLineItem, C as CartOperationResult, l as CartState, o as CartSummary, R as ReactiveCartIndicator, b as WIX_CART_CONTEXT, c as WixCartContext, r as cartIndicator, s as cartPage, t as init } from './index.client-VoD54p4E.js';
+export { A as AddToCartOptions, q as CartIndicatorState, n as CartLineItem, C as CartOperationResult, l as CartState, o as CartSummary, R as ReactiveCartIndicator, b as WIX_CART_CONTEXT, c as WixCartContext, r as cartIndicator, s as cartPage, u as init, t as miniCart } from './index.client-BgJIzp09.js';
 import '@jay-framework/runtime';
 import '@jay-framework/reactive';
 import '@wix/ecom';

package/dist/index.client.js

@@ -1,5 +1,5 @@
 import { createJayContext, useGlobalContext } from "@jay-framework/runtime";
-import { registerReactiveGlobalContext, createSignal, useReactive, createEffect } from "@jay-framework/component";
+import { registerReactiveGlobalContext, createSignal, useReactive, createEffect, createMemo } from "@jay-framework/component";
 import { WIX_CLIENT_CONTEXT } from "@jay-framework/wix-server-client/client";
 import { currentCart } from "@wix/ecom";
 import { makeJayStackComponent, makeJayInit } from "@jay-framework/fullstack-component";
@@ -548,6 +548,29 @@ function CartPageInteractive(_props, refs, viewStateSignals, _carryForward, cart
   };
 }
 const cartPage = makeJayStackComponent().withProps().withContexts(WIX_CART_CONTEXT).withInteractive(CartPageInteractive);
+function MiniCartInteractive(_props, refs, viewStateSignals, _carryForward, cartContext) {
+  const { isOpen: [isOpen, setIsOpen] } = viewStateSignals;
+  let prevItemCount = cartContext.cartIndicator.itemCount();
+  createMemo(() => {
+    const currentCount = cartContext.cartIndicator.itemCount();
+    if (currentCount > prevItemCount) {
+      setIsOpen(true);
+    }
+    prevItemCount = currentCount;
+  });
+  refs.openButton.onclick(() => {
+    setIsOpen(true);
+  });
+  refs.closeButton.onclick(() => {
+    setIsOpen(false);
+  });
+  return {
+    render: () => ({
+      isOpen: isOpen()
+    })
+  };
+}
+const miniCart = makeJayStackComponent().withProps().withContexts(WIX_CART_CONTEXT).withInteractive(MiniCartInteractive);
 const init = makeJayInit().withClient(async (data) => {
   console.log("[wix-cart] Initializing client-side cart context...");
   const { enableClientCart } = data;
@@ -562,5 +585,6 @@ export {
   WIX_CART_CONTEXT,
   cartIndicator,
   cartPage,
-  init
+  init,
+  miniCart
 };

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import { WixClient } from '@wix/sdk';
-import { W as WixCartService } from './index.client-VoD54p4E.js';
-export { A as AddToCartOptions, q as CartIndicatorState, n as CartLineItem, C as CartOperationResult, l as CartState, o as CartSummary, R as ReactiveCartIndicator, b as WIX_CART_CONTEXT, a as WIX_CART_SERVICE, c as WixCartContext, d as WixCartInitData, r as cartIndicator, s as cartPage, j as estimateCurrentCartTotalsOrNull, i as getCurrentCartOrNull, h as getEmptyCartState, t as init, e as mapCartSummary, g as mapCartToIndicator, f as mapCartToState, k as mapEstimateTotalsToState, m as mapLineItem, p as provideWixCartContext } from './index.client-VoD54p4E.js';
+import { W as WixCartService } from './index.client-BgJIzp09.js';
+export { A as AddToCartOptions, q as CartIndicatorState, n as CartLineItem, C as CartOperationResult, l as CartState, o as CartSummary, R as ReactiveCartIndicator, b as WIX_CART_CONTEXT, a as WIX_CART_SERVICE, c as WixCartContext, d as WixCartInitData, r as cartIndicator, s as cartPage, j as estimateCurrentCartTotalsOrNull, i as getCurrentCartOrNull, h as getEmptyCartState, u as init, e as mapCartSummary, g as mapCartToIndicator, f as mapCartToState, k as mapEstimateTotalsToState, m as mapLineItem, t as miniCart, p as provideWixCartContext } from './index.client-BgJIzp09.js';
 import { currentCart } from '@wix/ecom';
 import { BuildDescriptors } from '@wix/sdk-types';
 import '@jay-framework/runtime';

package/dist/index.js

@@ -359,7 +359,7 @@ function provideWixCartContext() {
   console.log("[wix-cart] Client cart context initialized (reactive)");
   return cartContext;
 }
-async function renderFastChanging$1(_props, _wixCart) {
+async function renderFastChanging$2(_props, _wixCart) {
   const Pipeline = RenderPipeline.for();
   return Pipeline.ok(null).toPhaseOutput(() => ({
     viewState: {
@@ -371,7 +371,7 @@ async function renderFastChanging$1(_props, _wixCart) {
     carryForward: {}
   }));
 }
-const cartIndicator = makeJayStackComponent().withProps().withServices(WIX_CART_SERVICE).withFastRender(renderFastChanging$1);
+const cartIndicator = makeJayStackComponent().withProps().withServices(WIX_CART_SERVICE).withFastRender(renderFastChanging$2);
 function createEmptyCartViewState() {
   return {
     isEmpty: true,
@@ -408,14 +408,24 @@ async function renderSlowlyChanging(_props, _wixCart) {
     carryForward: {}
   }));
 }
-async function renderFastChanging(_props, _slowCarryForward, _wixCart) {
+async function renderFastChanging$1(_props, _slowCarryForward, _wixCart) {
   const Pipeline = RenderPipeline.for();
   return Pipeline.ok(null).toPhaseOutput(() => ({
     viewState: createEmptyCartViewState(),
     carryForward: {}
   }));
 }
-const cartPage = makeJayStackComponent().withProps().withServices(WIX_CART_SERVICE).withSlowlyRender(renderSlowlyChanging).withFastRender(renderFastChanging);
+const cartPage = makeJayStackComponent().withProps().withServices(WIX_CART_SERVICE).withSlowlyRender(renderSlowlyChanging).withFastRender(renderFastChanging$1);
+async function renderFastChanging(_props, _wixCart) {
+  const Pipeline = RenderPipeline.for();
+  return Pipeline.ok(null).toPhaseOutput(() => ({
+    viewState: {
+      isOpen: false
+    },
+    carryForward: {}
+  }));
+}
+const miniCart = makeJayStackComponent().withProps().withServices(WIX_CART_SERVICE).withFastRender(renderFastChanging);
 const init = makeJayInit().withServer(async () => {
   console.log("[wix-cart] Initializing Wix Cart service...");
   const wixClient = getService(WIX_CLIENT_SERVICE);
@@ -440,6 +450,7 @@ export {
   mapCartToState,
   mapEstimateTotalsToState,
   mapLineItem,
+  miniCart,
   provideWixCartContext,
   provideWixCartService
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jay-framework/wix-cart",
-  "version": "0.15.5",
+  "version": "0.15.6",
   "type": "module",
   "description": "Wix Cart/Ecom shared package for Jay Framework",
   "license": "Apache-2.0",
@@ -20,11 +20,13 @@
     },
     "./plugin.yaml": "./plugin.yaml",
     "./cart-indicator.jay-contract": "./dist/contracts/cart-indicator.jay-contract",
-    "./cart-page.jay-contract": "./dist/contracts/cart-page.jay-contract"
+    "./cart-page.jay-contract": "./dist/contracts/cart-page.jay-contract",
+    "./mini-cart.jay-contract": "./dist/contracts/mini-cart.jay-contract"
   },
   "scripts": {
-    "build": "npm run clean && npm run definitions && npm run build:client && npm run build:server && npm run build:copy-contract && npm run build:types",
+    "build": "npm run clean && npm run definitions && npm run build:client && npm run build:server && npm run build:copy-contract && npm run build:types && npm run validate",
     "definitions": "jay-cli definitions lib",
+    "validate": "jay-stack-cli validate-plugin",
     "build:client": "vite build",
     "build:server": "vite build --ssr",
     "build:copy-contract": "mkdir -p dist/contracts && cp lib/contracts/*.jay-contract* dist/contracts/",
@@ -35,15 +37,15 @@
     "test": ":"
   },
   "dependencies": {
-    "@jay-framework/component": "^0.15.5",
-    "@jay-framework/fullstack-component": "^0.15.5",
-    "@jay-framework/reactive": "^0.15.5",
-    "@jay-framework/runtime": "^0.15.5",
-    "@jay-framework/secure": "^0.15.5",
-    "@jay-framework/stack-client-runtime": "^0.15.5",
-    "@jay-framework/stack-server-runtime": "^0.15.5",
-    "@jay-framework/wix-server-client": "^0.15.5",
-    "@jay-framework/wix-utils": "^0.15.5",
+    "@jay-framework/component": "^0.15.6",
+    "@jay-framework/fullstack-component": "^0.15.6",
+    "@jay-framework/reactive": "^0.15.6",
+    "@jay-framework/runtime": "^0.15.6",
+    "@jay-framework/secure": "^0.15.6",
+    "@jay-framework/stack-client-runtime": "^0.15.6",
+    "@jay-framework/stack-server-runtime": "^0.15.6",
+    "@jay-framework/wix-server-client": "^0.15.6",
+    "@jay-framework/wix-utils": "^0.15.6",
     "@wix/ecom": "^1.0.1996",
     "@wix/sdk": "^1.21.5",
     "@wix/sdk-runtime": "^1.0.11"
@@ -52,9 +54,9 @@
     "@babel/core": "^7.23.7",
     "@babel/preset-env": "^7.23.8",
     "@babel/preset-typescript": "^7.23.3",
-    "@jay-framework/compiler-jay-stack": "^0.15.5",
-    "@jay-framework/jay-cli": "^0.15.5",
-    "@jay-framework/vite-plugin": "^0.15.5",
+    "@jay-framework/compiler-jay-stack": "^0.15.6",
+    "@jay-framework/jay-cli": "^0.15.6",
+    "@jay-framework/vite-plugin": "^0.15.6",
     "@jay-framework/wix-dev-environment": "^0.6.11",
     "nodemon": "^3.0.3",
     "rimraf": "^5.0.5",

package/plugin.yaml

@@ -10,5 +10,19 @@ contracts:
     contract: cart-page.jay-contract
     component: cartPage
     description: Full cart page with line item management and checkout
+  - name: mini-cart
+    contract: mini-cart.jay-contract
+    component: miniCart
+    description: Drawer that auto-opens when a product is added to cart
+
+services:
+  - name: wix-cart
+    marker: WIX_CART_SERVICE
+    description: Wix eCommerce cart API for server-side cart operations
+
+contexts:
+  - name: wix-cart
+    marker: WIX_CART_CONTEXT
+    description: Client-side reactive cart state with add-to-cart, remove, quantity, coupon, and checkout operations
 
 # Plugin initialization uses makeJayInit pattern in lib/init.ts