@sixthshift/design-system 0.5.0 → 0.6.0

package/dist/lib/contexts/OverlayContext/ToastStack.js

@@ -0,0 +1,45 @@
+"use client";
+import { jsx as _jsx } from "react/jsx-runtime";
+import { FloatingPortal } from "@floating-ui/react";
+import { Toast } from "@sixthshift/design-system/toast";
+import { cn } from "@sixthshift/design-system/utils";
+import { useCallback, useEffect, useSyncExternalStore } from "react";
+import { toastStore as defaultStore } from "./toastStore.js";
+const EMPTY = [];
+/** The store's stack, re-rendering the caller as it changes. Empty during server rendering. */
+export function useToasts(store = defaultStore) {
+    return useSyncExternalStore(store.subscribe, store.snapshot, () => EMPTY);
+}
+/**
+ * One toast in the stack: the dismissal timer lives here, not in the store,
+ * so the store stays free of the DOM. Expiry and the X button take the same
+ * path — `open` flips false, `Toast` plays its exit, and `onClose` drops the
+ * record once the animation ends.
+ */
+function ToastItem({ record, store }) {
+    const { id, duration, closing } = record;
+    // `duration` is the stack's to act on, not the toast's to render.
+    const { component: Component = Toast, duration: _duration, ...props } = record.options;
+    useEffect(() => {
+        if (duration <= 0 || closing)
+            return;
+        const timer = setTimeout(() => store.close(id), duration);
+        return () => clearTimeout(timer);
+    }, [id, duration, closing, store]);
+    const onClose = useCallback(() => store.remove(id), [store, id]);
+    return (_jsx("div", { className: "pointer-events-auto", "data-toast-id": id, "data-toast-intent": props.intent ?? "neutral", children: _jsx(Component, { ...props, standalone: false, open: !closing, onClose: onClose }) }));
+}
+/** The container's own classes: bottom centre, newest at the bottom, click-through between toasts. */
+export const TOAST_STACK_CLASS = "pointer-events-none fixed bottom-6 left-1/2 z-toast flex -translate-x-1/2 flex-col-reverse items-center gap-3";
+/**
+ * The open toasts, portalled and positioned. `OverlayProvider` renders one;
+ * render it yourself only when there is no provider to host it.
+ */
+export function ToastStack({ store = defaultStore, root, className }) {
+    const toasts = useToasts(store);
+    if (toasts.length === 0)
+        return null;
+    // `root` omitted rather than passed as `undefined`: see OverlayContext's `rootProp`.
+    return (_jsx(FloatingPortal, { ...(root === undefined ? {} : { root }), children: _jsx("div", { className: cn(TOAST_STACK_CLASS, className), "data-toast-stack": "", "data-count": toasts.length, children: toasts.map((record) => (_jsx(ToastItem, { record: record, store: store }, record.id))) }) }));
+}
+//# sourceMappingURL=ToastStack.js.map

package/dist/lib/contexts/OverlayContext/ToastStack.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ToastStack.js","sourceRoot":"","sources":["../../../../src/lib/contexts/OverlayContext/ToastStack.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAC;;AAEb,OAAO,EAAE,cAAc,EAA4B,MAAM,oBAAoB,CAAC;AAC9E,OAAO,EAAE,KAAK,EAAE,MAAM,iCAAiC,CAAC;AACxD,OAAO,EAAE,EAAE,EAAE,MAAM,iCAAiC,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,oBAAoB,EAAE,MAAM,OAAO,CAAC;AACrE,OAAO,EAAE,UAAU,IAAI,YAAY,EAAqC,MAAM,cAAc,CAAC;AAE7F,MAAM,KAAK,GAA2B,EAAE,CAAC;AAEzC,+FAA+F;AAC/F,MAAM,UAAU,SAAS,CAAC,QAAoB,YAAY;IACxD,OAAO,oBAAoB,CAAC,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC,QAAQ,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC;AAC5E,CAAC;AAED;;;;;GAKG;AACH,SAAS,SAAS,CAAC,EAAE,MAAM,EAAE,KAAK,EAA8C;IAC9E,MAAM,EAAE,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,MAAM,CAAC;IACzC,kEAAkE;IAClE,MAAM,EAAE,SAAS,EAAE,SAAS,GAAG,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,GAAG,MAAM,CAAC,OAAO,CAAC;IAEvF,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,QAAQ,IAAI,CAAC,IAAI,OAAO;YAAE,OAAO;QACrC,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,QAAQ,CAAC,CAAC;QAC1D,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;IACnC,CAAC,EAAE,CAAC,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC;IAEnC,MAAM,OAAO,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC;IAEjE,OAAO,CACL,cAAK,SAAS,EAAC,qBAAqB,mBAAgB,EAAE,uBAAqB,KAAK,CAAC,MAAM,IAAI,SAAS,YAClG,KAAC,SAAS,OAAK,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,GAAI,GACzE,CACP,CAAC;AACJ,CAAC;AAWD,sGAAsG;AACtG,MAAM,CAAC,MAAM,iBAAiB,GAAG,+GAA+G,CAAC;AAEjJ;;;GAGG;AACH,MAAM,UAAU,UAAU,CAAC,EAAE,KAAK,GAAG,YAAY,EAAE,IAAI,EAAE,SAAS,EAAmB;IACnF,MAAM,MAAM,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC;IAChC,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACrC,qFAAqF;IACrF,OAAO,CACL,KAAC,cAAc,OAAK,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,YACtD,cAAK,SAAS,EAAE,EAAE,CAAC,iBAAiB,EAAE,SAAS,CAAC,sBAAmB,EAAE,gBAAa,MAAM,CAAC,MAAM,YAC5F,MAAM,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CACtB,KAAC,SAAS,IAAiB,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,IAAvC,MAAM,CAAC,EAAE,CAAkC,CAC5D,CAAC,GACE,GACS,CAClB,CAAC;AACJ,CAAC"}

package/dist/lib/contexts/OverlayContext/hooks/useModal.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useModal.d.ts","sourceRoot":"","sources":["../../../../../src/lib/contexts/OverlayContext/hooks/useModal.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAwB,KAAK,UAAU,EAAE,KAAK,OAAO,EAAE,MAAM,iCAAiC,CAAC;AACtG,OAAO,EAAE,KAAK,aAAa,EAAE,KAAK,SAAS,EAAwC,MAAM,OAAO,CAAC;AAOjG,uCAAuC;AACvC,MAAM,MAAM,mBAAmB,CAAC,KAAK,GAAG,SAAS,IAAI;IACnD,uBAAuB;IACvB,OAAO,EAAE,OAAO,CAAC;IACjB,4BAA4B;IAC5B,QAAQ,EAAE,MAAM,IAAI,CAAC;IACrB,oCAAoC;IACpC,IAAI,EAAE,KAAK,CAAC;CACb,GAAG,IAAI,CAAC,UAAU,EAAE,cAAc,GAAG,UAAU,CAAC,CAAC;AAElD,wCAAwC;AACxC,MAAM,MAAM,gBAAgB,CAAC,KAAK,GAAG,SAAS,IAAI,IAAI,CAAC,UAAU,EAAE,cAAc,GAAG,UAAU,CAAC,GAAG;IAChG,qDAAqD;IACrD,gBAAgB,CAAC,EAAE,SAAS,CAAC;IAC7B,iDAAiD;IACjD,IAAI,CAAC,EAAE,KAAK,CAAC;CACd,CAAC;AAMF,eAAO,MAAM,QAAQ;gBAuDhB,KAAK,yBAAyB,aAAa,CAAC,mBAAmB,CAAC,KAAK,CAAC,CAAC,YAAW,gBAAgB,CAAC,KAAK,CAAC;;;0BA0B/E,KAAK;;;CAanC,CAAC"}
+{"version":3,"file":"useModal.d.ts","sourceRoot":"","sources":["../../../../../src/lib/contexts/OverlayContext/hooks/useModal.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAwB,KAAK,UAAU,EAAE,KAAK,OAAO,EAAE,MAAM,iCAAiC,CAAC;AACtG,OAAO,EAAE,KAAK,aAAa,EAAE,KAAK,SAAS,EAAwC,MAAM,OAAO,CAAC;AAOjG,uCAAuC;AACvC,MAAM,MAAM,mBAAmB,CAAC,KAAK,GAAG,SAAS,IAAI;IACnD,uBAAuB;IACvB,OAAO,EAAE,OAAO,CAAC;IACjB,4BAA4B;IAC5B,QAAQ,EAAE,MAAM,IAAI,CAAC;IACrB,oCAAoC;IACpC,IAAI,EAAE,KAAK,CAAC;CACb,GAAG,IAAI,CAAC,UAAU,EAAE,cAAc,GAAG,UAAU,CAAC,CAAC;AAElD,wCAAwC;AACxC,MAAM,MAAM,gBAAgB,CAAC,KAAK,GAAG,SAAS,IAAI,IAAI,CAAC,UAAU,EAAE,cAAc,GAAG,UAAU,CAAC,GAAG;IAChG,qDAAqD;IACrD,gBAAgB,CAAC,EAAE,SAAS,CAAC;IAC7B,iDAAiD;IACjD,IAAI,CAAC,EAAE,KAAK,CAAC;CACd,CAAC;AAMF,eAAO,MAAM,QAAQ;gBAuDhB,KAAK,yBAAyB,aAAa,CAAC,mBAAmB,CAAC,KAAK,CAAC,CAAC,YAAW,gBAAgB,CAAC,KAAK,CAAC;;;0BA0B/E,KAAK;;;CAanC,CAAC"}

package/dist/lib/contexts/OverlayContext/hooks/useModal.js

@@ -1,3 +1,4 @@
+"use client";
 import { jsx as _jsx } from "react/jsx-runtime";
 import { ModalContextProvider } from "@sixthshift/design-system/modal";
 import { Suspense, useCallback, useId, useRef } from "react";

package/dist/lib/contexts/OverlayContext/hooks/useModal.js.map

@@ -1 +1 @@
-{"version":3,"file":"useModal.js","sourceRoot":"","sources":["../../../../../src/lib/contexts/OverlayContext/hooks/useModal.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,oBAAoB,EAAiC,MAAM,iCAAiC,CAAC;AACtG,OAAO,EAAsC,QAAQ,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC;AACjG,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAwBtD,gFAAgF;AAChF,OAAO;AACP,gFAAgF;AAEhF,MAAM,CAAC,MAAM,QAAQ,GAAG,GAAG,EAAE;IAC3B,MAAM,EACJ,UAAU,EAAE,CAAC,EAAE,QAAQ,CAAC,GACzB,GAAG,iBAAiB,EAAE,CAAC;IAExB,MAAM,MAAM,GAAG,KAAK,EAAE,CAAC;IACvB,MAAM,UAAU,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;IAE7B;;OAEG;IACH,MAAM,cAAc,GAAG,WAAW,CAAC,GAAG,EAAE;QACtC,QAAQ,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,UAAU,EAAE,EAAE,QAAQ,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC;IAC7D,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC;IAEf;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAsCG;IACH,MAAM,SAAS,GAAG,WAAW,CAC3B,CAAoB,SAAoD,EAAE,UAAmC,EAA6B,EAAE,EAAE;QAC5I,MAAM,EAAE,GAAG,GAAG,MAAM,IAAI,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC;QAC/C,MAAM,EAAE,gBAAgB,GAAG,IAAI,EAAE,IAAI,EAAE,WAAW,EAAE,GAAG,cAAc,EAAE,GAAG,OAAO,CAAC;QAElF,MAAM,UAAU,GAAY,GAAG,EAAE;YAC/B,QAAQ,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,UAAU,EAAE,EAAE,QAAQ,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC;QAClE,CAAC,CAAC;QAEF,MAAM,YAAY,GAAG,CAAC,EAAE,IAAI,EAAsB,EAAE,EAAE,CAAC,CACrD,KAAC,oBAAoB,IAAC,OAAO,EAAE,UAAU,YACvC,KAAC,QAAQ,IAAC,QAAQ,EAAE,gBAAgB,YAClC,KAAC,SAAS,IAAC,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,cAAc,EAAE,IAAI,EAAE,CAAC,IAAI,IAAI,WAAW,CAAU,KAAM,cAAc,GAAI,GAC7G,GACU,CACxB,CAAC;QAEF,QAAQ,CAAC;YACP,IAAI,EAAE,MAAM;YACZ,IAAI,EAAE;gBACJ,EAAE;gBACF,SAAS,EAAE,YAAY;gBACvB,OAAO,EAAE,UAAU;gBACnB,IAAI,EAAE,WAAW;aAClB;SACF,CAAC,CAAC;QAEH,MAAM,MAAM,GAAG,CAAC,OAAc,EAAE,EAAE;YAChC,QAAQ,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,CAAC,CAAC;QAC5D,CAAC,CAAC;QAEF,OAAO,EAAE,EAAE,EAAE,UAAU,EAAE,MAAM,EAAE,CAAC;IACpC,CAAC,EACD,CAAC,QAAQ,EAAE,MAAM,EAAE,cAAc,CAAC,CACnC,CAAC;IAEF,OAAO;QACL,SAAS;QACT,cAAc;KACf,CAAC;AACJ,CAAC,CAAC"}
+{"version":3,"file":"useModal.js","sourceRoot":"","sources":["../../../../../src/lib/contexts/OverlayContext/hooks/useModal.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAC;;AAEb,OAAO,EAAE,oBAAoB,EAAiC,MAAM,iCAAiC,CAAC;AACtG,OAAO,EAAsC,QAAQ,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC;AACjG,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAwBtD,gFAAgF;AAChF,OAAO;AACP,gFAAgF;AAEhF,MAAM,CAAC,MAAM,QAAQ,GAAG,GAAG,EAAE;IAC3B,MAAM,EACJ,UAAU,EAAE,CAAC,EAAE,QAAQ,CAAC,GACzB,GAAG,iBAAiB,EAAE,CAAC;IAExB,MAAM,MAAM,GAAG,KAAK,EAAE,CAAC;IACvB,MAAM,UAAU,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;IAE7B;;OAEG;IACH,MAAM,cAAc,GAAG,WAAW,CAAC,GAAG,EAAE;QACtC,QAAQ,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,UAAU,EAAE,EAAE,QAAQ,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC;IAC7D,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC;IAEf;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAsCG;IACH,MAAM,SAAS,GAAG,WAAW,CAC3B,CAAoB,SAAoD,EAAE,UAAmC,EAA6B,EAAE,EAAE;QAC5I,MAAM,EAAE,GAAG,GAAG,MAAM,IAAI,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC;QAC/C,MAAM,EAAE,gBAAgB,GAAG,IAAI,EAAE,IAAI,EAAE,WAAW,EAAE,GAAG,cAAc,EAAE,GAAG,OAAO,CAAC;QAElF,MAAM,UAAU,GAAY,GAAG,EAAE;YAC/B,QAAQ,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,UAAU,EAAE,EAAE,QAAQ,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC;QAClE,CAAC,CAAC;QAEF,MAAM,YAAY,GAAG,CAAC,EAAE,IAAI,EAAsB,EAAE,EAAE,CAAC,CACrD,KAAC,oBAAoB,IAAC,OAAO,EAAE,UAAU,YACvC,KAAC,QAAQ,IAAC,QAAQ,EAAE,gBAAgB,YAClC,KAAC,SAAS,IAAC,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,cAAc,EAAE,IAAI,EAAE,CAAC,IAAI,IAAI,WAAW,CAAU,KAAM,cAAc,GAAI,GAC7G,GACU,CACxB,CAAC;QAEF,QAAQ,CAAC;YACP,IAAI,EAAE,MAAM;YACZ,IAAI,EAAE;gBACJ,EAAE;gBACF,SAAS,EAAE,YAAY;gBACvB,OAAO,EAAE,UAAU;gBACnB,IAAI,EAAE,WAAW;aAClB;SACF,CAAC,CAAC;QAEH,MAAM,MAAM,GAAG,CAAC,OAAc,EAAE,EAAE;YAChC,QAAQ,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,CAAC,CAAC;QAC5D,CAAC,CAAC;QAEF,OAAO,EAAE,EAAE,EAAE,UAAU,EAAE,MAAM,EAAE,CAAC;IACpC,CAAC,EACD,CAAC,QAAQ,EAAE,MAAM,EAAE,cAAc,CAAC,CACnC,CAAC;IAEF,OAAO;QACL,SAAS;QACT,cAAc;KACf,CAAC;AACJ,CAAC,CAAC"}

package/dist/lib/contexts/OverlayContext/hooks/useToast.d.ts

@@ -1,12 +1,29 @@
-import { type ToastProps } from "@sixthshift/design-system/toast";
-import { type FunctionComponent } from "react";
-type ToastPropsWithDuration = Omit<ToastProps, "onClose"> & {
-    /** Auto-dismiss duration in ms. Set to 0 to disable. Default: 5000 */
-    duration?: number;
+import { type ToastOptions } from "../toastStore.js";
+/**
+ * Open toasts on the provider's stack, with the content decided at the moment
+ * of opening: an error's message, a count, whatever the action produced.
+ *
+ * @example
+ * ```tsx
+ * const { openToast } = useToast();
+ *
+ * async function save() {
+ *   try {
+ *     await api.save();
+ *     openToast({ intent: "success", title: "Saved" });
+ *   } catch (error) {
+ *     openToast({ intent: "danger", title: "Could not save", children: String(error) });
+ *   }
+ * }
+ * ```
+ *
+ * Outside any provider this opens on the app's default stack, which is also
+ * what the plain `toast()` export uses, so code that is not a component — a
+ * store, a callback from a service worker — has the same door.
+ */
+export declare const useToast: () => {
+    openToast: (options: ToastOptions) => import("../index.js").ToastHandle;
+    closeToast: (id: string) => void;
+    closeAllToasts: () => void;
 };
-export declare const useToast: (args: ToastPropsWithDuration | FunctionComponent<ToastProps>) => {
-    openToast: () => void;
-    closeToast: () => void;
-};
-export {};
 //# sourceMappingURL=useToast.d.ts.map

package/dist/lib/contexts/OverlayContext/hooks/useToast.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useToast.d.ts","sourceRoot":"","sources":["../../../../../src/lib/contexts/OverlayContext/hooks/useToast.ts"],"names":[],"mappings":"AACA,OAAO,EAAS,KAAK,UAAU,EAAE,MAAM,iCAAiC,CAAC;AACzE,OAAO,EAAE,KAAK,iBAAiB,EAAyC,MAAM,OAAO,CAAC;AAWtF,KAAK,sBAAsB,GAAG,IAAI,CAAC,UAAU,EAAE,SAAS,CAAC,GAAG;IAC1D,sEAAsE;IACtE,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAWF,eAAO,MAAM,QAAQ,SAAU,sBAAsB,GAAG,iBAAiB,CAAC,UAAU,CAAC;;;CAoDpF,CAAC"}
+{"version":3,"file":"useToast.d.ts","sourceRoot":"","sources":["../../../../../src/lib/contexts/OverlayContext/hooks/useToast.ts"],"names":[],"mappings":"AAIA,OAAO,EAA8B,KAAK,YAAY,EAAE,MAAM,eAAe,CAAC;AAE9E;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,eAAO,MAAM,QAAQ;yBAGqB,YAAY;qBAChB,MAAM;;CAI3C,CAAC"}

package/dist/lib/contexts/OverlayContext/hooks/useToast.js

@@ -1,52 +1,34 @@
-import { Toast } from "@sixthshift/design-system/toast";
-import { useCallback, useEffect, useId, useRef } from "react";
+"use client";
+import { useCallback } from "react";
 import { useOverlayContext } from "../OverlayContext.js";
-// Default auto-dismiss duration in milliseconds
-const DEFAULT_DURATION = 5000;
-// Native replacements for lodash functions
-const isFunction = (value) => typeof value === "function";
-const isPlainObject = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
-export const useToast = (args) => {
-    const { toastStack: [, dispatch], } = useOverlayContext();
-    const id = useId();
-    const customComponent = isFunction(args) ? args : null;
-    const props = isPlainObject(args) ? args : {};
-    const { duration = DEFAULT_DURATION, ...toastPropsRaw } = props;
-    const closeToast = useCallback(() => {
-        dispatch({ type: "remove", id, transition: { duration: 300 } });
-    }, [dispatch, id]);
-    // `openToast` has to be both referentially stable — callers put it in effect
-    // dependency arrays — and able to see the current props. A ref refreshed after
-    // every render gives both.
-    //
-    // It previously memoised the props object against JSON.stringify(props) as a
-    // cache key. JSON.stringify silently drops function-valued properties, so a
-    // changed `onAction` whose serialisable fields were identical did not
-    // invalidate the key, and `openToast` kept firing the stale closure.
-    const latest = useRef({ customComponent, toastProps: toastPropsRaw, duration });
-    useEffect(() => {
-        latest.current = { customComponent, toastProps: toastPropsRaw, duration };
-    });
-    const openToast = useCallback(() => {
-        const { customComponent: component, toastProps, duration: autoDismiss } = latest.current;
-        dispatch({
-            type: "push",
-            item: {
-                id,
-                component: component ?? Toast,
-                onClose: closeToast,
-                standalone: false, // OverlayContext handles positioning
-                ...toastProps,
-            },
-        });
-        // Auto-dismiss if duration is set
-        if (autoDismiss > 0) {
-            setTimeout(closeToast, autoDismiss);
-        }
-    }, [dispatch, id, closeToast]);
-    return {
-        openToast,
-        closeToast,
-    };
+import { toastStore as defaultStore } from "../toastStore.js";
+/**
+ * Open toasts on the provider's stack, with the content decided at the moment
+ * of opening: an error's message, a count, whatever the action produced.
+ *
+ * @example
+ * ```tsx
+ * const { openToast } = useToast();
+ *
+ * async function save() {
+ *   try {
+ *     await api.save();
+ *     openToast({ intent: "success", title: "Saved" });
+ *   } catch (error) {
+ *     openToast({ intent: "danger", title: "Could not save", children: String(error) });
+ *   }
+ * }
+ * ```
+ *
+ * Outside any provider this opens on the app's default stack, which is also
+ * what the plain `toast()` export uses, so code that is not a component — a
+ * store, a callback from a service worker — has the same door.
+ */
+export const useToast = () => {
+    const store = useOverlayContext()?.toastStore ?? defaultStore;
+    const openToast = useCallback((options) => store.open(options), [store]);
+    const closeToast = useCallback((id) => store.close(id), [store]);
+    const closeAllToasts = useCallback(() => store.clear(), [store]);
+    return { openToast, closeToast, closeAllToasts };
 };
 //# sourceMappingURL=useToast.js.map

package/dist/lib/contexts/OverlayContext/hooks/useToast.js.map

@@ -1 +1 @@
-{"version":3,"file":"useToast.js","sourceRoot":"","sources":["../../../../../src/lib/contexts/OverlayContext/hooks/useToast.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAAmB,MAAM,iCAAiC,CAAC;AACzE,OAAO,EAA0B,WAAW,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC;AACtF,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAEtD,gDAAgD;AAChD,MAAM,gBAAgB,GAAG,IAAI,CAAC;AAE9B,2CAA2C;AAC3C,MAAM,UAAU,GAAG,CAAC,KAAc,EAA0C,EAAE,CAAC,OAAO,KAAK,KAAK,UAAU,CAAC;AAE3G,MAAM,aAAa,GAAG,CAAC,KAAc,EAAmC,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAgBhJ,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,IAA4D,EAAE,EAAE;IACvF,MAAM,EACJ,UAAU,EAAE,CAAC,EAAE,QAAQ,CAAC,GACzB,GAAG,iBAAiB,EAAE,CAAC;IAExB,MAAM,EAAE,GAAG,KAAK,EAAE,CAAC;IAEnB,MAAM,eAAe,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;IACvD,MAAM,KAAK,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAE,EAA6B,CAAC;IAC1E,MAAM,EAAE,QAAQ,GAAG,gBAAgB,EAAE,GAAG,aAAa,EAAE,GAAG,KAAK,CAAC;IAEhE,MAAM,UAAU,GAAG,WAAW,CAAC,GAAG,EAAE;QAClC,QAAQ,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,UAAU,EAAE,EAAE,QAAQ,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC;IAClE,CAAC,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,CAAC;IAEnB,6EAA6E;IAC7E,+EAA+E;IAC/E,2BAA2B;IAC3B,EAAE;IACF,6EAA6E;IAC7E,4EAA4E;IAC5E,sEAAsE;IACtE,qEAAqE;IACrE,MAAM,MAAM,GAAG,MAAM,CAAC,EAAE,eAAe,EAAE,UAAU,EAAE,aAAa,EAAE,QAAQ,EAAE,CAAC,CAAC;IAChF,SAAS,CAAC,GAAG,EAAE;QACb,MAAM,CAAC,OAAO,GAAG,EAAE,eAAe,EAAE,UAAU,EAAE,aAAa,EAAE,QAAQ,EAAE,CAAC;IAC5E,CAAC,CAAC,CAAC;IAEH,MAAM,SAAS,GAAG,WAAW,CAAC,GAAG,EAAE;QACjC,MAAM,EAAE,eAAe,EAAE,SAAS,EAAE,UAAU,EAAE,QAAQ,EAAE,WAAW,EAAE,GAAG,MAAM,CAAC,OAAO,CAAC;QAEzF,QAAQ,CAAC;YACP,IAAI,EAAE,MAAM;YACZ,IAAI,EAAE;gBACJ,EAAE;gBACF,SAAS,EAAE,SAAS,IAAI,KAAK;gBAC7B,OAAO,EAAE,UAAU;gBACnB,UAAU,EAAE,KAAK,EAAE,qCAAqC;gBACxD,GAAG,UAAU;aACI;SACpB,CAAC,CAAC;QAEH,kCAAkC;QAClC,IAAI,WAAW,GAAG,CAAC,EAAE,CAAC;YACpB,UAAU,CAAC,UAAU,EAAE,WAAW,CAAC,CAAC;QACtC,CAAC;IACH,CAAC,EAAE,CAAC,QAAQ,EAAE,EAAE,EAAE,UAAU,CAAC,CAAC,CAAC;IAE/B,OAAO;QACL,SAAS;QACT,UAAU;KACX,CAAC;AACJ,CAAC,CAAC"}
+{"version":3,"file":"useToast.js","sourceRoot":"","sources":["../../../../../src/lib/contexts/OverlayContext/hooks/useToast.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,WAAW,EAAE,MAAM,OAAO,CAAC;AACpC,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,UAAU,IAAI,YAAY,EAAqB,MAAM,eAAe,CAAC;AAE9E;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,GAAG,EAAE;IAC3B,MAAM,KAAK,GAAG,iBAAiB,EAAE,EAAE,UAAU,IAAI,YAAY,CAAC;IAE9D,MAAM,SAAS,GAAG,WAAW,CAAC,CAAC,OAAqB,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC;IACvF,MAAM,UAAU,GAAG,WAAW,CAAC,CAAC,EAAU,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC;IACzE,MAAM,cAAc,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC;IAEjE,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,cAAc,EAAE,CAAC;AACnD,CAAC,CAAC"}

package/dist/lib/contexts/OverlayContext/index.d.ts

@@ -3,4 +3,6 @@ export { Modal } from "@sixthshift/design-system/modal";
 export * from "./hooks/useModal.js";
 export * from "./hooks/useToast.js";
 export * from "./OverlayContext.js";
+export { TOAST_STACK_CLASS, ToastStack, type ToastStackProps, useToasts } from "./ToastStack.js";
+export * from "./toastStore.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/lib/contexts/OverlayContext/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/lib/contexts/OverlayContext/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAElE,OAAO,EAAE,KAAK,EAAE,MAAM,iCAAiC,CAAC;AACxD,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/lib/contexts/OverlayContext/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAElE,OAAO,EAAE,KAAK,EAAE,MAAM,iCAAiC,CAAC;AACxD,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,OAAO,EAAE,iBAAiB,EAAE,UAAU,EAAE,KAAK,eAAe,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAC9F,cAAc,cAAc,CAAC"}

package/dist/lib/contexts/OverlayContext/index.js

@@ -3,4 +3,6 @@ export { Modal } from "@sixthshift/design-system/modal";
 export * from "./hooks/useModal.js";
 export * from "./hooks/useToast.js";
 export * from "./OverlayContext.js";
+export { TOAST_STACK_CLASS, ToastStack, useToasts } from "./ToastStack.js";
+export * from "./toastStore.js";
 //# sourceMappingURL=index.js.map

package/dist/lib/contexts/OverlayContext/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/lib/contexts/OverlayContext/index.ts"],"names":[],"mappings":"AACA,kDAAkD;AAClD,OAAO,EAAE,KAAK,EAAE,MAAM,iCAAiC,CAAC;AACxD,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/lib/contexts/OverlayContext/index.ts"],"names":[],"mappings":"AACA,kDAAkD;AAClD,OAAO,EAAE,KAAK,EAAE,MAAM,iCAAiC,CAAC;AACxD,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,OAAO,EAAE,iBAAiB,EAAE,UAAU,EAAwB,SAAS,EAAE,MAAM,cAAc,CAAC;AAC9F,cAAc,cAAc,CAAC"}

package/dist/lib/contexts/OverlayContext/toastStore.d.ts

@@ -0,0 +1,68 @@
+import type { ToastProps } from "@sixthshift/design-system/toast";
+import type { FunctionComponent } from "react";
+/** What a caller passes to open a toast: the `Toast`'s own props, plus how long it stays. */
+export type ToastOptions = Omit<ToastProps, "onClose" | "open" | "standalone" | "root"> & {
+    /**
+     * Milliseconds until the toast dismisses itself. `0` keeps it until it is
+     * dismissed by hand. Default: `0` for `intent="danger"` (a failure usually
+     * carries a message worth reading, and often a retry), `5000` otherwise.
+     */
+    duration?: number;
+    /** Render this instead of `Toast`. It receives `ToastProps` and must honour `open` and `onClose` as `Toast` does. */
+    component?: FunctionComponent<ToastProps>;
+};
+/** One toast as the stack holds it. */
+export type ToastRecord = {
+    id: string;
+    options: ToastOptions;
+    /** The resolved lifetime, in ms; `0` sticks. */
+    duration: number;
+    /** Playing its exit; removed once the animation ends. */
+    closing: boolean;
+};
+/** What `open` hands back: the toast's id, and a way to close it early. */
+export type ToastHandle = {
+    id: string;
+    close: () => void;
+};
+/**
+ * The stack of open toasts, with subscribers. No DOM and no timers: the
+ * `ToastStack` that renders it owns dismissal timing, and `Toast` owns the
+ * exit animation. Plain functions, so a toast can be opened from anywhere —
+ * an event handler, a store, a service-worker callback — not only from a
+ * component.
+ */
+export type ToastStore = {
+    /** Register a listener; returns the unsubscribe. */
+    subscribe: (listener: () => void) => () => void;
+    /** The current stack, oldest first. Reference-stable until it changes, as `useSyncExternalStore` needs. */
+    snapshot: () => readonly ToastRecord[];
+    /** Add a toast. Past `max`, the oldest is dropped at once. */
+    open: (options: ToastOptions) => ToastHandle;
+    /** Begin a toast's exit. It leaves the stack when `remove` is called, which `Toast` does after its animation. */
+    close: (id: string) => void;
+    /** Drop a toast at once. */
+    remove: (id: string) => void;
+    /** Begin every toast's exit. */
+    clear: () => void;
+};
+export type ToastStoreOptions = {
+    /** How many toasts show at once; the oldest falls off. Default: 3 — a short stack reads on a phone. */
+    max?: number;
+    /** Ids in open order. Injectable so a test can name them. */
+    newId?: () => string;
+};
+export declare const DEFAULT_TOAST_DURATION = 5000;
+export declare const DEFAULT_MAX_TOASTS = 3;
+/** The lifetime an intent gets when none is given: failures stay, everything else expires. */
+export declare function defaultToastDuration(intent: ToastOptions["intent"]): number;
+export declare function createToastStore({ max, newId }?: ToastStoreOptions): ToastStore;
+/** The app's one stack: what `OverlayProvider` renders unless handed another. */
+export declare const toastStore: ToastStore;
+/** Open a toast on the app's stack, from anywhere. Returns its id and a way to close it early. */
+export declare function toast(options: ToastOptions): ToastHandle;
+/** Begin a toast's exit on the app's stack. */
+export declare function closeToast(id: string): void;
+/** Begin every toast's exit on the app's stack. */
+export declare function closeAllToasts(): void;
+//# sourceMappingURL=toastStore.d.ts.map

package/dist/lib/contexts/OverlayContext/toastStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toastStore.d.ts","sourceRoot":"","sources":["../../../../src/lib/contexts/OverlayContext/toastStore.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAClE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,OAAO,CAAC;AAM/C,6FAA6F;AAC7F,MAAM,MAAM,YAAY,GAAG,IAAI,CAAC,UAAU,EAAE,SAAS,GAAG,MAAM,GAAG,YAAY,GAAG,MAAM,CAAC,GAAG;IACxF;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,qHAAqH;IACrH,SAAS,CAAC,EAAE,iBAAiB,CAAC,UAAU,CAAC,CAAC;CAC3C,CAAC;AAEF,uCAAuC;AACvC,MAAM,MAAM,WAAW,GAAG;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,YAAY,CAAC;IACtB,gDAAgD;IAChD,QAAQ,EAAE,MAAM,CAAC;IACjB,yDAAyD;IACzD,OAAO,EAAE,OAAO,CAAC;CAClB,CAAC;AAEF,2EAA2E;AAC3E,MAAM,MAAM,WAAW,GAAG;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,IAAI,CAAA;CAAE,CAAC;AAE5D;;;;;;GAMG;AACH,MAAM,MAAM,UAAU,GAAG;IACvB,oDAAoD;IACpD,SAAS,EAAE,CAAC,QAAQ,EAAE,MAAM,IAAI,KAAK,MAAM,IAAI,CAAC;IAChD,2GAA2G;IAC3G,QAAQ,EAAE,MAAM,SAAS,WAAW,EAAE,CAAC;IACvC,8DAA8D;IAC9D,IAAI,EAAE,CAAC,OAAO,EAAE,YAAY,KAAK,WAAW,CAAC;IAC7C,iHAAiH;IACjH,KAAK,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5B,4BAA4B;IAC5B,MAAM,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7B,gCAAgC;IAChC,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,uGAAuG;IACvG,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,6DAA6D;IAC7D,KAAK,CAAC,EAAE,MAAM,MAAM,CAAC;CACtB,CAAC;AAMF,eAAO,MAAM,sBAAsB,OAAO,CAAC;AAC3C,eAAO,MAAM,kBAAkB,IAAI,CAAC;AAEpC,8FAA8F;AAC9F,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,YAAY,CAAC,QAAQ,CAAC,GAAG,MAAM,CAE3E;AAWD,wBAAgB,gBAAgB,CAAC,EAAE,GAAwB,EAAE,KAAc,EAAE,GAAE,iBAAsB,GAAG,UAAU,CAqCjH;AAED,iFAAiF;AACjF,eAAO,MAAM,UAAU,YAAqB,CAAC;AAE7C,kGAAkG;AAClG,wBAAgB,KAAK,CAAC,OAAO,EAAE,YAAY,GAAG,WAAW,CAExD;AAED,+CAA+C;AAC/C,wBAAgB,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAE3C;AAED,mDAAmD;AACnD,wBAAgB,cAAc,IAAI,IAAI,CAErC"}

package/dist/lib/contexts/OverlayContext/toastStore.js

@@ -0,0 +1,69 @@
+// =============================================================================
+// Defaults
+// =============================================================================
+export const DEFAULT_TOAST_DURATION = 5000;
+export const DEFAULT_MAX_TOASTS = 3;
+/** The lifetime an intent gets when none is given: failures stay, everything else expires. */
+export function defaultToastDuration(intent) {
+    return intent === "danger" ? 0 : DEFAULT_TOAST_DURATION;
+}
+let opened = 0;
+const nextId = () => `toast-${++opened}`;
+// =============================================================================
+// Store
+// =============================================================================
+const EMPTY = [];
+export function createToastStore({ max = DEFAULT_MAX_TOASTS, newId = nextId } = {}) {
+    let toasts = EMPTY;
+    const listeners = new Set();
+    const set = (next) => {
+        toasts = next.length === 0 ? EMPTY : next;
+        for (const listener of [...listeners])
+            listener();
+    };
+    const close = (id) => {
+        const record = toasts.find((toast) => toast.id === id);
+        if (record === undefined || record.closing)
+            return;
+        set(toasts.map((toast) => (toast === record ? { ...toast, closing: true } : toast)));
+    };
+    return {
+        subscribe(listener) {
+            listeners.add(listener);
+            return () => void listeners.delete(listener);
+        },
+        snapshot: () => toasts,
+        open(options) {
+            const id = newId();
+            const record = { id, options, duration: options.duration ?? defaultToastDuration(options.intent), closing: false };
+            set([...toasts, record].slice(-max));
+            return { id, close: () => close(id) };
+        },
+        close,
+        remove(id) {
+            const next = toasts.filter((toast) => toast.id !== id);
+            if (next.length !== toasts.length)
+                set(next);
+        },
+        clear() {
+            if (toasts.every((toast) => toast.closing))
+                return;
+            set(toasts.map((toast) => ({ ...toast, closing: true })));
+        },
+    };
+}
+/** The app's one stack: what `OverlayProvider` renders unless handed another. */
+export const toastStore = createToastStore();
+/** Open a toast on the app's stack, from anywhere. Returns its id and a way to close it early. */
+export function toast(options) {
+    return toastStore.open(options);
+}
+/** Begin a toast's exit on the app's stack. */
+export function closeToast(id) {
+    toastStore.close(id);
+}
+/** Begin every toast's exit on the app's stack. */
+export function closeAllToasts() {
+    toastStore.clear();
+}
+//# sourceMappingURL=toastStore.js.map

package/dist/lib/contexts/OverlayContext/toastStore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"toastStore.js","sourceRoot":"","sources":["../../../../src/lib/contexts/OverlayContext/toastStore.ts"],"names":[],"mappings":"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"}

package/dist/lib/withErrorBoundary.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"withErrorBoundary.d.ts","sourceRoot":"","sources":["../../src/lib/withErrorBoundary.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACtD,OAAO,EAAiB,KAAK,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAEzE,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,MAAM,EAAE,SAAS,EAAE,aAAa,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,SAAS,GAAG,CAAC,CAAC,KAAK,EAAE,kBAAkB,KAAK,SAAS,CAAC;YAC7G,CAAC;;EAWpC"}
+{"version":3,"file":"withErrorBoundary.d.ts","sourceRoot":"","sources":["../../src/lib/withErrorBoundary.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACtD,OAAO,EAAiB,KAAK,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAEzE,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,MAAM,EAAE,SAAS,EAAE,aAAa,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,SAAS,GAAG,CAAC,CAAC,KAAK,EAAE,kBAAkB,KAAK,SAAS,CAAC;YAC7G,CAAC;;EAWpC"}

package/dist/lib/withErrorBoundary.js

@@ -1,3 +1,4 @@
+"use client";
 import { jsx as _jsx } from "react/jsx-runtime";
 import { ErrorBoundary } from "./ErrorBoundary.js";
 export function withErrorBoundary(Component, fallback) {

package/dist/lib/withErrorBoundary.js.map

@@ -1 +1 @@
-{"version":3,"file":"withErrorBoundary.js","sourceRoot":"","sources":["../../src/lib/withErrorBoundary.tsx"],"names":[],"mappings":";AACA,OAAO,EAAE,aAAa,EAA2B,MAAM,iBAAiB,CAAC;AAEzE,MAAM,UAAU,iBAAiB,CAAmB,SAA2B,EAAE,QAAgE;IAC/I,SAAS,iBAAiB,CAAC,KAAQ;QACjC,OAAO,CACL,KAAC,aAAa,IAAC,QAAQ,EAAE,QAAQ,YAC/B,KAAC,SAAS,OAAK,KAAK,GAAI,GACV,CACjB,CAAC;IACJ,CAAC;IAED,iBAAiB,CAAC,WAAW,GAAG,qBAAqB,SAAS,CAAC,WAAW,IAAI,SAAS,CAAC,IAAI,IAAI,WAAW,GAAG,CAAC;IAE/G,OAAO,iBAAiB,CAAC;AAC3B,CAAC"}
+{"version":3,"file":"withErrorBoundary.js","sourceRoot":"","sources":["../../src/lib/withErrorBoundary.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAC;;AAGb,OAAO,EAAE,aAAa,EAA2B,MAAM,iBAAiB,CAAC;AAEzE,MAAM,UAAU,iBAAiB,CAAmB,SAA2B,EAAE,QAAgE;IAC/I,SAAS,iBAAiB,CAAC,KAAQ;QACjC,OAAO,CACL,KAAC,aAAa,IAAC,QAAQ,EAAE,QAAQ,YAC/B,KAAC,SAAS,OAAK,KAAK,GAAI,GACV,CACjB,CAAC;IACJ,CAAC;IAED,iBAAiB,CAAC,WAAW,GAAG,qBAAqB,SAAS,CAAC,WAAW,IAAI,SAAS,CAAC,IAAI,IAAI,WAAW,GAAG,CAAC;IAE/G,OAAO,iBAAiB,CAAC;AAC3B,CAAC"}

package/dist/lib/withSuspenseAndErrorBoundary.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"withSuspenseAndErrorBoundary.d.ts","sourceRoot":"","sources":["../../src/lib/withSuspenseAndErrorBoundary.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEtD,OAAO,EAAiB,KAAK,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAEzE,KAAK,OAAO,GAAG;IACb,QAAQ,EAAE,SAAS,CAAC;IACpB,aAAa,EAAE,SAAS,GAAG,CAAC,CAAC,KAAK,EAAE,kBAAkB,KAAK,SAAS,CAAC,CAAC;CACvE,CAAC;AAEF,wBAAgB,4BAA4B,CAAC,CAAC,SAAS,MAAM,EAAE,SAAS,EAAE,aAAa,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO;YAG7D,CAAC;;EAa/C"}
+{"version":3,"file":"withSuspenseAndErrorBoundary.d.ts","sourceRoot":"","sources":["../../src/lib/withSuspenseAndErrorBoundary.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEtD,OAAO,EAAiB,KAAK,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAEzE,KAAK,OAAO,GAAG;IACb,QAAQ,EAAE,SAAS,CAAC;IACpB,aAAa,EAAE,SAAS,GAAG,CAAC,CAAC,KAAK,EAAE,kBAAkB,KAAK,SAAS,CAAC,CAAC;CACvE,CAAC;AAEF,wBAAgB,4BAA4B,CAAC,CAAC,SAAS,MAAM,EAAE,SAAS,EAAE,aAAa,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO;YAG7D,CAAC;;EAa/C"}

package/dist/lib/withSuspenseAndErrorBoundary.js

@@ -1,3 +1,4 @@
+"use client";
 import { jsx as _jsx } from "react/jsx-runtime";
 import { Suspense } from "react";
 import { ErrorBoundary } from "./ErrorBoundary.js";

package/dist/lib/withSuspenseAndErrorBoundary.js.map

@@ -1 +1 @@
-{"version":3,"file":"withSuspenseAndErrorBoundary.js","sourceRoot":"","sources":["../../src/lib/withSuspenseAndErrorBoundary.tsx"],"names":[],"mappings":";AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AACjC,OAAO,EAAE,aAAa,EAA2B,MAAM,iBAAiB,CAAC;AAOzE,MAAM,UAAU,4BAA4B,CAAmB,SAA2B,EAAE,OAAgB;IAC1G,MAAM,EAAE,QAAQ,EAAE,aAAa,EAAE,GAAG,OAAO,CAAC;IAE5C,SAAS,4BAA4B,CAAC,KAAQ;QAC5C,OAAO,CACL,KAAC,aAAa,IAAC,QAAQ,EAAE,aAAa,YACpC,KAAC,QAAQ,IAAC,QAAQ,EAAE,QAAQ,YAC1B,KAAC,SAAS,OAAK,KAAK,GAAI,GACf,GACG,CACjB,CAAC;IACJ,CAAC;IAED,4BAA4B,CAAC,WAAW,GAAG,gCAAgC,SAAS,CAAC,WAAW,IAAI,SAAS,CAAC,IAAI,IAAI,WAAW,GAAG,CAAC;IAErI,OAAO,4BAA4B,CAAC;AACtC,CAAC"}
+{"version":3,"file":"withSuspenseAndErrorBoundary.js","sourceRoot":"","sources":["../../src/lib/withSuspenseAndErrorBoundary.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAC;;AAGb,OAAO,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AACjC,OAAO,EAAE,aAAa,EAA2B,MAAM,iBAAiB,CAAC;AAOzE,MAAM,UAAU,4BAA4B,CAAmB,SAA2B,EAAE,OAAgB;IAC1G,MAAM,EAAE,QAAQ,EAAE,aAAa,EAAE,GAAG,OAAO,CAAC;IAE5C,SAAS,4BAA4B,CAAC,KAAQ;QAC5C,OAAO,CACL,KAAC,aAAa,IAAC,QAAQ,EAAE,aAAa,YACpC,KAAC,QAAQ,IAAC,QAAQ,EAAE,QAAQ,YAC1B,KAAC,SAAS,OAAK,KAAK,GAAI,GACf,GACG,CACjB,CAAC;IACJ,CAAC;IAED,4BAA4B,CAAC,WAAW,GAAG,gCAAgC,SAAS,CAAC,WAAW,IAAI,SAAS,CAAC,IAAI,IAAI,WAAW,GAAG,CAAC;IAErI,OAAO,4BAA4B,CAAC;AACtC,CAAC"}

package/dist/{theme/schema.d.ts → theming/vocabulary.d.ts}

@@ -1,12 +1,12 @@
 /**
- * Theme Schema
+ * Token naming vocabulary
  *
  * The naming convention for design tokens, as types and as data:
  *
  *   {context}-[on-]{intent}[-{weight}][-{state}]
  *
- * src/theme/tokens.css is the only place tokens are defined, and nothing derives
- * TypeScript from it. These types describe the *shape* a token name can take
+ * The theme sources (src/theme/<name>/ plus src/theming/tailwind.css) are the only place
+ * tokens are defined, and nothing derives TypeScript from them. These types describe the *shape* a token name can take
  * rather than enumerating the names that happen to exist today, which is why the
  * vocabulary below is the thing to edit when the system grows a new axis.
  *
@@ -78,4 +78,4 @@ export type ThemeSchema = {
 /** Type-safe CSS var reference */
 export declare function cssVar(token: ColorToken): string;
 export {};
-//# sourceMappingURL=schema.d.ts.map
+//# sourceMappingURL=vocabulary.d.ts.map

package/dist/theming/vocabulary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vocabulary.d.ts","sourceRoot":"","sources":["../../src/theming/vocabulary.ts"],"names":[],"mappings":"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"}

package/dist/{theme/schema.js → theming/vocabulary.js}

@@ -1,12 +1,12 @@
 /**
- * Theme Schema
+ * Token naming vocabulary
  *
  * The naming convention for design tokens, as types and as data:
  *
  *   {context}-[on-]{intent}[-{weight}][-{state}]
  *
- * src/theme/tokens.css is the only place tokens are defined, and nothing derives
- * TypeScript from it. These types describe the *shape* a token name can take
+ * The theme sources (src/theme/<name>/ plus src/theming/tailwind.css) are the only place
+ * tokens are defined, and nothing derives TypeScript from them. These types describe the *shape* a token name can take
  * rather than enumerating the names that happen to exist today, which is why the
  * vocabulary below is the thing to edit when the system grows a new axis.
  *
@@ -46,4 +46,4 @@ export const standaloneTokens = ["focus-ring"];
 export function cssVar(token) {
     return `var(--${token})`;
 }
-//# sourceMappingURL=schema.js.map
+//# sourceMappingURL=vocabulary.js.map

package/dist/theming/vocabulary.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vocabulary.js","sourceRoot":"","sources":["../../src/theming/vocabulary.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAYH,gFAAgF;AAChF,aAAa;AACb,gFAAgF;AAEhF,gDAAgD;AAChD,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,CAAU,CAAC;AAGxD,0CAA0C;AAC1C,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,CAAU,CAAC;AAGjE,mCAAmC;AACnC,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,SAAS,EAAE,SAAS,EAAE,QAAQ,CAAU,CAAC;AAGlE,oBAAoB;AACpB,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,GAAG,SAAS,EAAE,GAAG,QAAQ,CAAU,CAAC;AAG9D,gFAAgF;AAChF,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,GAAG,SAAS,EAAE,OAAO,EAAE,SAAS,CAAU,CAAC;AAGnE,8DAA8D;AAC9D,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,QAAQ,EAAE,QAAQ,CAAU,CAAC;AAGrD,yBAAyB;AACzB,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,SAAS,EAAE,SAAS,EAAE,UAAU,CAAU,CAAC;AAGlE,0DAA0D;AAC1D,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,YAAY,CAAU,CAAC;AAiDxD,gFAAgF;AAChF,YAAY;AACZ,gFAAgF;AAEhF,kCAAkC;AAClC,MAAM,UAAU,MAAM,CAAC,KAAiB;IACtC,OAAO,SAAS,KAAK,GAAG,CAAC;AAC3B,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sixthshift/design-system",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "description": "Personal design system - tokens, theme, and component library",
   "license": "MIT",
   "publishConfig": {
@@ -38,10 +38,10 @@
     "!src/testing"
   ],
   "exports": {
-    "./theme.css": "./src/theme/tokens.css",
-    "./theme": {
-      "types": "./dist/theme/index.d.ts",
-      "import": "./dist/theme/index.js"
+    "./themes/linen.css": "./src/theme/linen/index.css",
+    "./theming": {
+      "types": "./dist/theming/vocabulary.d.ts",
+      "import": "./dist/theming/vocabulary.js"
     },
     "./utils": {
       "types": "./dist/lib/utils.d.ts",
@@ -318,11 +318,12 @@
   },
   "scripts": {
     "prepare": "bun run build",
-    "build": "bun run clean:dist && bun run build:js && bun run scripts/check-exports.ts",
+    "build": "bun run clean:dist && bun run scripts/check-use-client.ts && bun run build:js && bun run scripts/check-exports.ts",
     "build:js": "tsc -p tsconfig.build.json && bun run scripts/fix-extensions.ts",
     "dev": "storybook dev -p 6006 --no-open",
     "build:storybook": "storybook build",
     "test": "vitest run --project unit --project date-time --project ssr --reporter=dot",
+    "test:coverage": "vitest run --project unit --project date-time --project ssr --coverage --reporter=dot",
     "test:verbose": "vitest run --project unit --project date-time --project ssr",
     "test:watch": "vitest --project unit --project date-time --project ssr",
     "test:ssr": "vitest run --project ssr",
@@ -340,6 +341,13 @@
     "check:fix": "biome check --write .",
     "check:recipes": "bun run scripts/check-recipes.ts",
     "check:contrast": "bun run scripts/check-contrast.ts",
+    "check:api": "bun run scripts/api-snapshot.ts --check",
+    "check:size": "bun run scripts/check-size.ts",
+    "api:update": "bun run scripts/api-snapshot.ts",
+    "check:published": "bun run scripts/check-published.ts",
+    "check:consumer-resolution": "bun run scripts/check-consumer-resolution.ts",
+    "check:use-client": "bun run scripts/check-use-client.ts",
+    "clean:artifacts": "rm -rf coverage .vitest-attachments",
     "clean": "rm -rf dist node_modules *.tsbuildinfo",
     "clean:dist": "rm -rf dist"
   },
@@ -352,6 +360,7 @@
     "tailwind-merge": "^3.4.0"
   },
   "devDependencies": {
+    "@arethetypeswrong/cli": "^0.18.5",
     "@biomejs/biome": "2.4.15",
     "@fontsource-variable/inter": "^5.2.8",
     "@fontsource-variable/jetbrains-mono": "^5.2.8",
@@ -374,12 +383,15 @@
     "@vitest/coverage-v8": "4.1.7",
     "@vitest/ui": "4.1.7",
     "commander": "^14.0.2",
+    "esbuild": "^0.28.2",
     "happy-dom": "^20.9.0",
     "monaco-editor": "^0.55.1",
     "playwright": "^1.57.0",
+    "publint": "^0.3.24",
     "react": "^18.2.0",
     "react-dom": "^18.2.0",
     "react-markdown": "^10.1.0",
+    "remark-gfm": "^4.0.1",
     "storybook": "^10.1.8",
     "tailwindcss": "^4",
     "typescript": "~5.7.2",

package/src/components/Badge/Badge.tsx

@@ -6,7 +6,7 @@ import * as React from "react";
  * Geometry and behaviour only.
  *
  * Every colour reads a `--badge-*` component token whose value is decided by
- * src/theme/recipes/badge.css. That file is the mapping from
+ * src/components/Badge/badge.recipe.css. That file is the mapping from
  * `(variant, intent)` to a semantic token — the layer that used to be
  * `compoundVariants` here, where it was compiled into class-name literals and
  * unreachable from outside. Nothing in this file names a colour, which is the
@@ -85,7 +85,7 @@ export type BadgeProps = React.HTMLAttributes<HTMLSpanElement> & {
  * does not manage an accessible name of its own.
  *
  * Colour is not decided here: each `(variant, intent)` pairing resolves
- * through a `--badge-*` component token (src/theme/recipes/badge.css), the
+ * through a `--badge-*` component token (src/components/Badge/badge.recipe.css), the
  * same seam Button uses, so a consumer can re-point a cell without a
  * release.
  */

package/src/components/Button/Button.tsx

@@ -7,7 +7,7 @@ import { Slot } from "../../internal/Slot";
  * Geometry and behaviour only.
  *
  * Every colour reads a `--button-*` component token whose value is decided by
- * src/theme/recipes/button.css. That file is the mapping from
+ * src/components/Button/button.recipe.css. That file is the mapping from
  * `(variant, intent, state)` to a semantic token — the layer that used to be
  * `compoundVariants` here, where it was compiled into class-name literals and
  * unreachable from outside. Nothing in this file names a colour, which is the