@a4ui/core 0.16.0 → 0.18.0

package/dist/{Checkbox-B5Gb3h5J.js → Checkbox-BZjX1GMG.js}

@@ -1,66 +1,73 @@
-import { spread as p, mergeProps as y, insert as f, template as g, effect as h, className as v, use as w, delegateEvents as k, createComponent as $, setAttribute as C } from "solid-js/web";
-import { splitProps as b, createSignal as _, createEffect as H, untrack as P, onCleanup as E, onMount as S, Show as K, For as T } from "solid-js";
+import { spread as y, mergeProps as b, insert as f, createComponent as p, template as g, effect as h, className as v, use as $, delegateEvents as k, setAttribute as C } from "solid-js/web";
+import { splitProps as x, Show as P, createSignal as _, createEffect as K, untrack as F, onCleanup as E, onMount as S, For as T } from "solid-js";
 import { c as m } from "./cn-B6yFEsav.js";
 import { animate as L, inView as Q } from "motion";
 import { Star as B } from "lucide-solid";
-var q = /* @__PURE__ */ g("<span>");
-const J = {
+var q = /* @__PURE__ */ g('<span class="relative flex h-1.5 w-1.5"aria-hidden=true><span class="absolute inline-flex h-full w-full animate-ping rounded-full bg-current opacity-75"></span><span class="relative inline-flex h-1.5 w-1.5 rounded-full bg-current">'), J = /* @__PURE__ */ g("<span>");
+const W = {
   neutral: "bg-muted text-muted-foreground ring-border",
   success: "bg-emerald-500/15 text-emerald-600 ring-emerald-500/30",
   warning: "bg-amber-500/15 text-amber-600 ring-amber-500/30",
   danger: "bg-rose-500/15 text-rose-600 ring-rose-500/30",
   info: "bg-sky-500/15 text-sky-600 ring-sky-500/30"
-}, W = "badge inline-flex items-center gap-1 rounded-full px-2 py-0.5 text-xs font-semibold ring-1 ring-inset whitespace-nowrap";
+}, Z = "badge inline-flex items-center gap-1 rounded-full px-2 py-0.5 text-xs font-semibold ring-1 ring-inset whitespace-nowrap";
 function $e(t) {
-  const [e, r] = b(t, ["tone", "class", "children"]);
+  const [e, r] = x(t, ["tone", "class", "children", "pulse"]);
   return (() => {
-    var n = q();
-    return p(n, y({
+    var n = J();
+    return y(n, b({
       get class() {
-        return m(W, J[e.tone ?? "neutral"], e.class);
+        return m(Z, W[e.tone ?? "neutral"], e.class);
       }
-    }, r), !1, !0), f(n, () => e.children), n;
+    }, r), !1, !0), f(n, p(P, {
+      get when() {
+        return e.pulse;
+      },
+      get children() {
+        return q();
+      }
+    }), null), f(n, () => e.children, null), n;
   })();
 }
-const F = "a4ui-effects";
-function I() {
+const I = "a4ui-effects";
+function Y() {
   try {
     return window.localStorage;
   } catch {
     return null;
   }
 }
-function Z() {
+function ee() {
   var e;
   try {
     if (new URLSearchParams(window.location.search).get("calm") === "1") return !1;
   } catch {
   }
-  const t = (e = I()) == null ? void 0 : e.getItem(F);
+  const t = (e = Y()) == null ? void 0 : e.getItem(I);
   return t === null ? !0 : t === "1";
 }
-function Y(t) {
+function N(t) {
   typeof document > "u" || document.documentElement.classList.toggle("calm", !t);
 }
-const N = Z();
-Y(N);
-const [U, ee] = _(N);
-function we() {
-  return U;
+const U = ee();
+N(U);
+const [z, te] = _(U);
+function _e() {
+  return z;
 }
-function te() {
-  return !U();
+function ne() {
+  return !z();
 }
-function _e(t) {
+function Ee(t) {
   var e;
-  (e = I()) == null || e.setItem(F, t ? "1" : "0"), Y(t), ee(t);
+  (e = Y()) == null || e.setItem(I, t ? "1" : "0"), N(t), te(t);
 }
-const ne = "(prefers-reduced-motion: reduce)";
-function re() {
-  return typeof window > "u" || typeof window.matchMedia != "function" ? !1 : window.matchMedia(ne).matches;
+const re = "(prefers-reduced-motion: reduce)";
+function oe() {
+  return typeof window > "u" || typeof window.matchMedia != "function" ? !1 : window.matchMedia(re).matches;
 }
-const z = "a4ui-motion-forced";
-function X() {
+const X = "a4ui-motion-forced";
+function j() {
   try {
     return window.localStorage;
   } catch {
@@ -68,44 +75,44 @@ function X() {
   }
 }
 var D;
-const [R, oe] = _(((D = X()) == null ? void 0 : D.getItem(z)) === "1");
-typeof document < "u" && document.documentElement.classList.toggle("force-motion", P(R));
-function Ee() {
+const [R, ae] = _(((D = j()) == null ? void 0 : D.getItem(X)) === "1");
+typeof document < "u" && document.documentElement.classList.toggle("force-motion", F(R));
+function Ce() {
   return R;
 }
-function Ce(t) {
+function ke(t) {
   var e;
-  (e = X()) == null || e.setItem(z, t ? "1" : "0"), typeof document < "u" && document.documentElement.classList.toggle("force-motion", t), oe(t);
+  (e = j()) == null || e.setItem(X, t ? "1" : "0"), typeof document < "u" && document.documentElement.classList.toggle("force-motion", t), ae(t);
 }
-function x() {
-  return te() || re() && !R();
+function w() {
+  return ne() || oe() && !R();
 }
-function ke(t, e = 600) {
+function Se(t, e = 600) {
   const [r, n] = _(0);
   let o;
-  return H(() => {
+  return K(() => {
     const a = t();
-    if (o == null || o.stop(), x()) {
+    if (o == null || o.stop(), w()) {
       n(a);
       return;
     }
-    const s = P(r);
-    s !== a && (o = L(s, a, {
+    const l = F(r);
+    l !== a && (o = L(l, a, {
       duration: e / 1e3,
       ease: "easeOut",
       onUpdate: (u) => n(u)
     }));
   }), E(() => o == null ? void 0 : o.stop()), r;
 }
-function Se(t, e = {}) {
-  x() || L(
+function Le(t, e = {}) {
+  w() || L(
     t,
     { opacity: [0, 1], y: [e.y ?? 8, 0] },
     { duration: e.duration ?? 0.32, delay: e.delay ?? 0, ease: "easeOut" }
   );
 }
-function Le(t, e = {}) {
-  if (x()) return () => {
+function Re(t, e = {}) {
+  if (w()) return () => {
   };
   t.style.opacity = "0";
   let r = !1;
@@ -121,22 +128,22 @@ function Le(t, e = {}) {
     { amount: e.amount ?? 0.2 }
   );
 }
-var ae = /* @__PURE__ */ g("<span>");
-function j(t, e, r = {}) {
-  if (x()) return;
-  const n = t.getBoundingClientRect(), o = e.clientX - n.left, a = e.clientY - n.top, s = 2 * Math.max(Math.hypot(o, a), Math.hypot(n.width - o, a), Math.hypot(o, n.height - a), Math.hypot(n.width - o, n.height - a)), u = document.createElement("span");
+var ie = /* @__PURE__ */ g("<span>");
+function G(t, e, r = {}) {
+  if (w()) return;
+  const n = t.getBoundingClientRect(), o = e.clientX - n.left, a = e.clientY - n.top, l = 2 * Math.max(Math.hypot(o, a), Math.hypot(n.width - o, a), Math.hypot(o, n.height - a), Math.hypot(n.width - o, n.height - a)), u = document.createElement("span");
   u.setAttribute("aria-hidden", "true"), Object.assign(u.style, {
     position: "absolute",
     left: `${o}px`,
     top: `${a}px`,
-    width: `${s}px`,
-    height: `${s}px`,
+    width: `${l}px`,
+    height: `${l}px`,
     borderRadius: "9999px",
     background: r.color ?? "currentColor",
     pointerEvents: "none",
     transform: "translate(-50%,-50%) scale(0)"
   }), t.appendChild(u);
-  const l = u.animate([{
+  const s = u.animate([{
     transform: "translate(-50%,-50%) scale(0)",
     opacity: String(r.opacity ?? 0.3)
   }, {
@@ -146,93 +153,93 @@ function j(t, e, r = {}) {
     duration: 600,
     easing: "ease-out"
   }), i = () => u.remove();
-  l.finished.then(i).catch(i);
+  s.finished.then(i).catch(i);
 }
-function Re(t) {
+function Me(t) {
   let e;
   const r = (n) => {
-    e && j(e, n, {
+    e && G(e, n, {
       color: t.color,
       opacity: t.opacity
     });
   };
   return (() => {
-    var n = ae();
+    var n = ie();
     n.$$pointerdown = r;
     var o = e;
-    return typeof o == "function" ? w(o, n) : e = n, f(n, () => t.children), h(() => v(n, m("relative inline-block overflow-hidden", t.class))), n;
+    return typeof o == "function" ? $(o, n) : e = n, f(n, () => t.children), h(() => v(n, m("relative inline-block overflow-hidden", t.class))), n;
   })();
 }
 k(["pointerdown"]);
-var ie = /* @__PURE__ */ g("<button>");
+var le = /* @__PURE__ */ g("<button>");
 const se = {
   primary: "bg-primary text-primary-foreground hover:bg-primary/90",
   secondary: "bg-muted text-foreground hover:bg-muted/70",
   outline: "border border-border bg-transparent text-foreground hover:bg-muted",
   ghost: "bg-transparent text-foreground hover:bg-muted"
-}, le = "inline-flex items-center justify-center rounded-md px-3 py-2 text-sm font-medium transition-[color,background-color,transform] duration-150 active:scale-[0.97] focus:outline-none focus:ring-2 focus:ring-ring disabled:pointer-events-none disabled:opacity-50";
-function Me(t) {
-  const [e, r] = b(t, ["variant", "class", "type", "children", "ripple", "onPointerDown"]), n = (o) => {
-    e.ripple && j(o.currentTarget, o, {
+}, ce = "inline-flex items-center justify-center rounded-md px-3 py-2 text-sm font-medium transition-[color,background-color,transform] duration-150 active:scale-[0.97] focus:outline-none focus:ring-2 focus:ring-ring disabled:pointer-events-none disabled:opacity-50";
+function Ae(t) {
+  const [e, r] = x(t, ["variant", "class", "type", "children", "ripple", "onPointerDown"]), n = (o) => {
+    e.ripple && G(o.currentTarget, o, {
       opacity: 0.35
     });
     const a = e.onPointerDown;
     typeof a == "function" ? a(o) : a && a[0](a[1], o);
   };
   return (() => {
-    var o = ie();
-    return o.$$pointerdown = n, p(o, y({
+    var o = le();
+    return o.$$pointerdown = n, y(o, b({
       get type() {
         return e.type ?? "button";
       },
       get class() {
-        return m(le, se[e.variant ?? "primary"], e.ripple && "relative overflow-hidden", e.class);
+        return m(ce, se[e.variant ?? "primary"], e.ripple && "relative overflow-hidden", e.class);
       }
     }, r), !1, !0), f(o, () => e.children), o;
   })();
 }
 k(["pointerdown"]);
-var ce = /* @__PURE__ */ g("<div>");
-function G(t, e = {}) {
-  if (x()) return () => {
+var ue = /* @__PURE__ */ g("<div>");
+function V(t, e = {}) {
+  if (w()) return () => {
   };
   const r = document.createElement("span");
   r.setAttribute("aria-hidden", "true"), r.className = "pointer-events-none absolute inset-0 opacity-0 transition-opacity duration-300", t.appendChild(r);
   const n = e.size ?? 180, o = e.color ?? "hsl(var(--primary))", a = (i, c) => {
     r.style.background = `radial-gradient(${n}px circle at ${i}px ${c}px, color-mix(in srgb, ${o} 30%, transparent), transparent 70%)`;
-  }, s = (i) => {
+  }, l = (i) => {
     const c = t.getBoundingClientRect();
     a(i.clientX - c.left, i.clientY - c.top);
   }, u = () => {
     r.style.opacity = "1";
-  }, l = () => {
+  }, s = () => {
     r.style.opacity = "0";
   };
-  return t.addEventListener("pointermove", s), t.addEventListener("pointerenter", u), t.addEventListener("pointerleave", l), () => {
-    t.removeEventListener("pointermove", s), t.removeEventListener("pointerenter", u), t.removeEventListener("pointerleave", l), r.remove();
+  return t.addEventListener("pointermove", l), t.addEventListener("pointerenter", u), t.addEventListener("pointerleave", s), () => {
+    t.removeEventListener("pointermove", l), t.removeEventListener("pointerenter", u), t.removeEventListener("pointerleave", s), r.remove();
   };
 }
-function Ae(t) {
+function Oe(t) {
   let e;
   return S(() => {
-    const r = G(e, {
+    const r = V(e, {
       color: t.color,
       size: t.size
     });
     E(r);
   }), (() => {
-    var r = ce(), n = e;
-    return typeof n == "function" ? w(n, r) : e = r, f(r, () => t.children), h(() => v(r, m("relative overflow-hidden", t.class))), r;
+    var r = ue(), n = e;
+    return typeof n == "function" ? $(n, r) : e = r, f(r, () => t.children), h(() => v(r, m("relative overflow-hidden", t.class))), r;
   })();
 }
-var ue = /* @__PURE__ */ g("<div style=perspective:800px><div style=transform-style:preserve-3d>");
-function V(t, e, r = {}) {
-  if (x()) return () => {
+var de = /* @__PURE__ */ g("<div style=perspective:800px><div style=transform-style:preserve-3d>");
+function H(t, e, r = {}) {
+  if (w()) return () => {
   };
   e.style.willChange = "transform";
   const n = (a) => {
-    const s = t.getBoundingClientRect(), u = (a.clientX - s.left) / s.width - 0.5, l = (a.clientY - s.top) / s.height - 0.5, i = r.max ?? 10;
-    e.style.transition = "transform 0.15s ease-out", e.style.transform = `perspective(800px) rotateX(${(l * -2 * i).toFixed(2)}deg) rotateY(${(u * 2 * i).toFixed(2)}deg) scale(1.02)`;
+    const l = t.getBoundingClientRect(), u = (a.clientX - l.left) / l.width - 0.5, s = (a.clientY - l.top) / l.height - 0.5, i = r.max ?? 10;
+    e.style.transition = "transform 0.15s ease-out", e.style.transform = `perspective(800px) rotateX(${(s * -2 * i).toFixed(2)}deg) rotateY(${(u * 2 * i).toFixed(2)}deg) scale(1.02)`;
   }, o = () => {
     e.style.transition = "transform 0.4s ease", e.style.transform = "perspective(800px) rotateX(0deg) rotateY(0deg) scale(1)";
   };
@@ -240,89 +247,89 @@ function V(t, e, r = {}) {
     t.removeEventListener("pointermove", n), t.removeEventListener("pointerleave", o), e.style.transform = "", e.style.transition = "", e.style.willChange = "";
   };
 }
-function Oe(t) {
+function Te(t) {
   let e, r;
   return S(() => {
-    const n = V(e, r, {
+    const n = H(e, r, {
       max: t.max
     });
     E(n);
   }), (() => {
-    var n = ue(), o = n.firstChild, a = e;
-    typeof a == "function" ? w(a, n) : e = n;
-    var s = r;
-    return typeof s == "function" ? w(s, o) : r = o, f(o, () => t.children), h(() => v(n, m("inline-block", t.class))), n;
+    var n = de(), o = n.firstChild, a = e;
+    typeof a == "function" ? $(a, n) : e = n;
+    var l = r;
+    return typeof l == "function" ? $(l, o) : r = o, f(o, () => t.children), h(() => v(n, m("inline-block", t.class))), n;
   })();
 }
-var M = /* @__PURE__ */ g("<div>"), de = /* @__PURE__ */ g("<h2>");
-function Te(t) {
-  const [e, r] = b(t, ["class", "children", "glass", "glow", "tilt", "spotlight"]), n = () => (e.glow ?? e.glass) === !0;
+var M = /* @__PURE__ */ g("<div>"), fe = /* @__PURE__ */ g("<h2>");
+function Be(t) {
+  const [e, r] = x(t, ["class", "children", "glass", "glow", "tilt", "spotlight"]), n = () => (e.glow ?? e.glass) === !0;
   let o;
   return S(() => {
-    const a = [e.tilt && o ? V(o, o) : null, e.spotlight && o ? G(o) : null].filter((s) => s !== null);
-    E(() => a.forEach((s) => s()));
+    const a = [e.tilt && o ? H(o, o) : null, e.spotlight && o ? V(o) : null].filter((l) => l !== null);
+    E(() => a.forEach((l) => l()));
   }), (() => {
-    var a = M(), s = o;
-    return typeof s == "function" ? w(s, a) : o = a, p(a, y({
+    var a = M(), l = o;
+    return typeof l == "function" ? $(l, a) : o = a, y(a, b({
       get class() {
         return m(e.glass ? "card rounded-xl text-card-foreground" : "rounded-xl border border-border bg-card text-card-foreground shadow-sm", n() && "glow-edge", e.spotlight && "relative overflow-hidden", e.tilt && "will-change-transform", e.class);
       }
     }, r), !1, !0), f(a, () => e.children), a;
   })();
 }
-function Be(t) {
-  const [e, r] = b(t, ["class", "children"]);
+function De(t) {
+  const [e, r] = x(t, ["class", "children"]);
   return (() => {
     var n = M();
-    return p(n, y({
+    return y(n, b({
       get class() {
         return m("flex flex-col space-y-1.5 p-6", e.class);
       }
     }, r), !1, !0), f(n, () => e.children), n;
   })();
 }
-function De(t) {
-  const [e, r] = b(t, ["class", "children"]);
+function Pe(t) {
+  const [e, r] = x(t, ["class", "children"]);
   return (() => {
-    var n = de();
-    return p(n, y({
+    var n = fe();
+    return y(n, b({
       get class() {
         return m("text-lg font-semibold leading-none tracking-tight", e.class);
       }
     }, r), !1, !0), f(n, () => e.children), n;
   })();
 }
-function Pe(t) {
-  const [e, r] = b(t, ["class", "children"]);
+function Fe(t) {
+  const [e, r] = x(t, ["class", "children"]);
   return (() => {
     var n = M();
-    return p(n, y({
+    return y(n, b({
       get class() {
         return m("p-6 pt-0", e.class);
       }
     }, r), !1, !0), f(n, () => e.children), n;
   })();
 }
-var fe = /* @__PURE__ */ g("<div role=radiogroup>"), me = /* @__PURE__ */ g("<div role=img>"), ge = /* @__PURE__ */ g('<button type=button role=radio class="rounded outline-none focus-visible:ring-2 focus-visible:ring-ring/40">');
-function Fe(t) {
+var me = /* @__PURE__ */ g("<div role=radiogroup>"), ge = /* @__PURE__ */ g("<div role=img>"), he = /* @__PURE__ */ g('<button type=button role=radio class="rounded outline-none focus-visible:ring-2 focus-visible:ring-ring/40">');
+function Ie(t) {
   const [e, r] = _(0), n = () => t.max ?? 5, o = () => Array.from({
     length: n()
-  }, (l, i) => i + 1), a = () => e() > 0 ? e() : t.value, s = (l) => {
+  }, (s, i) => i + 1), a = () => e() > 0 ? e() : t.value, l = (s) => {
     var i;
-    t.readonly || (i = t.onChange) == null || i.call(t, l);
-  }, u = (l) => m("h-5 w-5 transition-colors", l <= a() ? "fill-primary text-primary" : "fill-transparent text-muted-foreground");
-  return $(K, {
+    t.readonly || (i = t.onChange) == null || i.call(t, s);
+  }, u = (s) => m("h-5 w-5 transition-colors", s <= a() ? "fill-primary text-primary" : "fill-transparent text-muted-foreground");
+  return p(P, {
     get when() {
       return !t.readonly;
     },
     get fallback() {
       return (() => {
-        var l = me();
-        return f(l, $(T, {
+        var s = ge();
+        return f(s, p(T, {
           get each() {
             return o();
           },
-          children: (i) => $(B, {
+          children: (i) => p(B, {
             get class() {
               return u(i);
             },
@@ -330,24 +337,24 @@ function Fe(t) {
           })
         })), h((i) => {
           var c = m("inline-flex items-center gap-1", t.class), d = `Rating ${t.value} of ${n()}`;
-          return c !== i.e && v(l, i.e = c), d !== i.t && C(l, "aria-label", i.t = d), i;
+          return c !== i.e && v(s, i.e = c), d !== i.t && C(s, "aria-label", i.t = d), i;
         }, {
           e: void 0,
           t: void 0
-        }), l;
+        }), s;
       })();
     },
     get children() {
-      var l = fe();
-      return l.addEventListener("mouseleave", () => r(0)), f(l, $(T, {
+      var s = me();
+      return s.addEventListener("mouseleave", () => r(0)), f(s, p(T, {
         get each() {
           return o();
         },
         children: (i) => (() => {
-          var c = ge();
+          var c = he();
           return c.$$keydown = (d) => {
-            d.key === "ArrowRight" || d.key === "ArrowUp" ? (d.preventDefault(), s(Math.min(t.value + 1, n()))) : (d.key === "ArrowLeft" || d.key === "ArrowDown") && (d.preventDefault(), s(Math.max(t.value - 1, 0)));
-          }, c.$$click = () => s(i), c.addEventListener("blur", () => r(0)), c.addEventListener("focus", () => r(i)), c.addEventListener("mouseenter", () => r(i)), f(c, $(B, {
+            d.key === "ArrowRight" || d.key === "ArrowUp" ? (d.preventDefault(), l(Math.min(t.value + 1, n()))) : (d.key === "ArrowLeft" || d.key === "ArrowDown") && (d.preventDefault(), l(Math.max(t.value - 1, 0)));
+          }, c.$$click = () => l(i), c.addEventListener("blur", () => r(0)), c.addEventListener("focus", () => r(i)), c.addEventListener("mouseenter", () => r(i)), f(c, p(B, {
             get class() {
               return u(i);
             },
@@ -360,41 +367,41 @@ function Fe(t) {
             t: void 0
           }), c;
         })()
-      })), h(() => v(l, m("inline-flex items-center gap-1", t.class))), l;
+      })), h(() => v(s, m("inline-flex items-center gap-1", t.class))), s;
     }
   });
 }
 k(["click", "keydown"]);
-var he = /* @__PURE__ */ g('<label><input type=checkbox class="h-4 w-4 rounded border-input accent-primary">');
-function Ie(t) {
+var pe = /* @__PURE__ */ g('<label><input type=checkbox class="h-4 w-4 rounded border-input accent-primary">');
+function Ye(t) {
   return (() => {
-    var e = he(), r = e.firstChild;
+    var e = pe(), r = e.firstChild;
     return r.addEventListener("change", (n) => t.onChange(n.currentTarget.checked)), f(e, () => t.label, null), h(() => v(e, m("inline-flex items-center gap-2 text-sm text-foreground", t.class))), h(() => r.checked = t.checked), e;
   })();
 }
 export {
   $e as B,
-  Te as C,
-  Fe as R,
-  Ae as S,
-  Oe as T,
-  Me as a,
-  Ie as b,
-  ke as c,
-  Pe as d,
-  Se as e,
-  Be as f,
-  De as g,
-  Re as h,
-  G as i,
+  Be as C,
+  Ie as R,
+  Oe as S,
+  Te as T,
+  Ae as a,
+  Ye as b,
+  Se as c,
+  Fe as d,
+  Le as e,
+  De as f,
+  Pe as g,
+  Ee as h,
+  Me as i,
   V as j,
-  te as k,
-  Ce as l,
-  x as m,
-  j as n,
-  Ee as o,
-  re as p,
-  Le as r,
-  _e as s,
-  we as u
+  H as k,
+  ne as l,
+  w as m,
+  ke as n,
+  Ce as o,
+  oe as p,
+  Re as r,
+  G as s,
+  _e as u
 };

package/dist/commerce/ProductCard.d.ts

@@ -19,6 +19,16 @@ export interface ProductCardProps {
     currency?: string;
     locale?: string;
     onAddToCart?: () => void;
+    /**
+     * 3D hover tilt toward the cursor — forwarded to the underlying {@link Card}
+     * ({@link attachTilt}). Engine-free and reduced-motion aware.
+     */
+    tilt?: boolean;
+    /**
+     * Cursor-following radial glow inside the card — forwarded to the underlying
+     * {@link Card} ({@link attachSpotlight}). Engine-free and reduced-motion aware.
+     */
+    spotlight?: boolean;
     class?: string;
 }
 /**

package/dist/commerce/createCart.d.ts

@@ -0,0 +1,53 @@
+import { Accessor } from 'solid-js';
+export interface CartProduct {
+    id: string | number;
+    price: number;
+}
+export interface CartEntry<T extends CartProduct> {
+    product: T;
+    qty: number;
+}
+export interface Cart<T extends CartProduct> {
+    /** Reactive list of cart entries. */
+    items: Accessor<CartEntry<T>[]>;
+    /** Add a product, or increment its `qty` if it's already in the cart. */
+    add: (product: T, qty?: number) => void;
+    /** Remove a product from the cart by id. */
+    remove: (id: T['id']) => void;
+    /** Set a product's quantity. `qty <= 0` removes the entry. */
+    setQty: (id: T['id'], qty: number) => void;
+    /** Empty the cart. */
+    clear: () => void;
+    /** Total number of units across all entries. */
+    count: () => number;
+    /** Sum of `price * qty` across all entries. */
+    subtotal: () => number;
+    /** Whether a product with this id is currently in the cart. */
+    has: (id: T['id']) => boolean;
+}
+/**
+ * Create a signal-backed shopping cart store, generic over the product type.
+ * `count()` and `subtotal()` are memoized and stay in sync with `items()`.
+ *
+ * @example
+ * ```ts
+ * interface Product extends CartProduct {
+ *   id: string
+ *   price: number
+ *   title: string
+ * }
+ *
+ * const cart = createCart<Product>()
+ *
+ * cart.add({ id: 'sku-1', price: 29.99, title: 'Wireless Mouse' })
+ * cart.add({ id: 'sku-1', price: 29.99, title: 'Wireless Mouse' }) // qty -> 2
+ * cart.setQty('sku-1', 3)
+ *
+ * cart.count()    // 3
+ * cart.subtotal() // 89.97
+ *
+ * cart.remove('sku-1')
+ * cart.has('sku-1') // false
+ * ```
+ */
+export declare function createCart<T extends CartProduct>(initial?: CartEntry<T>[]): Cart<T>;

package/dist/commerce/index.d.ts

@@ -5,3 +5,4 @@ export { ProductGrid, type ProductGridProps } from './ProductGrid';
 export { CartLine, type CartLineProps } from './CartLine';
 export { CartSummary, type CartSummaryProps, type CartSummaryItem } from './CartSummary';
 export { FilterGroup, type FilterGroupProps, type FacetOption } from './FilterGroup';
+export { createCart, type Cart, type CartProduct, type CartEntry } from './createCart';