kitzo 3.1.1 → 3.1.3

package/README.md

@@ -15,10 +15,12 @@ pnpm add kitzo
 ## Features
 
 ### Components
+
 - **Toast**: Smart notification system with flexible positioning.
 - **Tooltip**: Contextual information with auto-positioning logic.
 
 ### Hooks
+
 - **useCopy**: Easy clipboard management.
 - **useDebounce**: Debounc any value.
 - **useDebouncedCallback**: Debounce function calls.
@@ -28,13 +30,14 @@ pnpm add kitzo
 - **useWindowSize**: Real-time window dimensions.
 
 ### Utilities
+
 - **copy**: Standalone programmatic clipboard copy.
 
 ## See Also
+
 - [Root Repository](https://github.com/riyad-96/kitzo)
 - [Documentation](https://github.com/riyad-96/kitzo/tree/main/apps/docs)
 
 ## License
-MIT
-
 
+MIT

package/dist/index.d.ts

@@ -89,16 +89,16 @@ export declare type ToasterProps = {
 };
 
 declare type ToastFn = {
-    (content: ToastContent, options?: ToastOptions): void;
-    info: (content: ToastContent, options?: Options) => void;
-    success: (content: ToastContent, options?: Options) => void;
-    warning: (content: ToastContent, options?: Options) => void;
-    error: (content: ToastContent, options?: Options) => void;
+    (content: ToastContent, options?: ToastOptions): string | number;
+    info: (content: ToastContent, options?: Options) => string | number;
+    success: (content: ToastContent, options?: Options) => string | number;
+    warning: (content: ToastContent, options?: Options) => string | number;
+    error: (content: ToastContent, options?: Options) => string | number;
     promise: PromiseToastFn;
-    loading: (content: ToastContent, options?: Options) => void;
-    custom: (content: ToastContent, options?: Options) => void;
-    dismiss: (id?: string | number, toasterId?: string | number) => void;
-    update: (id: string | number, content: ToastContent, options?: UpdateToastOptions) => void;
+    loading: (content: ToastContent, options?: Options) => string | number;
+    custom: (content: ToastContent, options?: Options) => string | number;
+    dismiss: (id?: string | number, toasterId?: string | number) => string | number | undefined;
+    update: (id: string | number, content: ToastContent, options?: UpdateToastOptions) => string | number;
 };
 
 declare type ToastOptions = {
@@ -111,6 +111,7 @@ declare type ToastOptions = {
     type?: ToastType;
     swipeToClose?: boolean;
     toasterId?: string | number;
+    onClose?: (id: string | number) => void;
 };
 
 declare type ToastOptionsWithoutType = Omit<ToastOptions, 'type'>;
@@ -188,6 +189,8 @@ export declare function useDebouncedCallback<Args extends unknown[]>(callback: (
  */
 export declare function useLocalStorage<T>(key: string, initialValue: T, options?: Options_2<T>): [T, Dispatch<SetStateAction<T>>];
 
+export declare function useMounted(): boolean;
+
 /**
  * A React hook that manages UI overlays (modal, drawer, popover, etc.)
  * and synchronizes them with the browser navigation history.

package/dist/index.js

@@ -1,22 +1,24 @@
 import { Toaster as r } from "./react/components/toast/Toaster.js";
 import { Tooltip as p } from "./react/components/tooltip/Tooltip.js";
 import { toast as m } from "./react/components/toast/service/triggerToasts.js";
-import { useCopy as s } from "./react/hooks/useCopy.js";
+import { useCopy as x } from "./react/hooks/useCopy.js";
 import { useDebounce as a } from "./react/hooks/useDebounce.js";
 import { useDebouncedCallback as c } from "./react/hooks/useDebouncedCallback.js";
-import { useLocalStorage as i } from "./react/hooks/useLocalStorage.js";
-import { useOverlay as T } from "./react/hooks/useOverlay.js";
-import { useThrottle as y } from "./react/hooks/useThrottle.js";
-import { useWindowSize as D } from "./react/hooks/useWindowSize.js";
+import { useLocalStorage as b } from "./react/hooks/useLocalStorage.js";
+import { useMounted as i } from "./react/hooks/useMounted.js";
+import { useOverlay as y } from "./react/hooks/useOverlay.js";
+import { useThrottle as D } from "./react/hooks/useThrottle.js";
+import { useWindowSize as g } from "./react/hooks/useWindowSize.js";
 export {
   r as Toaster,
   p as Tooltip,
   m as toast,
-  s as useCopy,
+  x as useCopy,
   a as useDebounce,
   c as useDebouncedCallback,
-  i as useLocalStorage,
-  T as useOverlay,
-  y as useThrottle,
-  D as useWindowSize
+  b as useLocalStorage,
+  i as useMounted,
+  y as useOverlay,
+  D as useThrottle,
+  g as useWindowSize
 };

package/dist/react/components/toast/service/createToast.js

@@ -1,50 +1,51 @@
-import { DEFAULT_TOASTER_ID as r } from "./listenars.js";
+import { DEFAULT_TOASTER_ID as s } from "./listenars.js";
 const e = {
   duration: 2800,
   showIcon: !0,
   animateTransformOrigin: void 0,
   swipeToClose: void 0
 };
-let s = 0;
-const d = () => crypto.randomUUID?.() ?? ++s;
+let r = 0;
+const d = () => crypto.randomUUID?.() ?? ++r;
 let u = 1;
-function p({
+function l({
   type: a,
   action: i,
   content: n,
-  options: o
+  options: t
 }) {
-  const t = typeof o == "object" && o !== null ? o : {};
+  const o = typeof t == "object" && t !== null ? t : {};
   return {
-    id: `${t.id ?? d()}`,
-    toasterId: `${t.toasterId ?? r}`,
-    duration: t.duration ?? e.duration,
-    showIcon: t.showIcon ?? e.showIcon,
-    animateTransformOrigin: t.animateTransformOrigin ?? e.animateTransformOrigin,
-    position: t.position,
-    icon: t.icon,
-    type: a === "default" ? t.type ?? "default" : a,
+    id: `${o.id ?? d()}`,
+    toasterId: `${o.toasterId ?? s}`,
+    duration: o.duration ?? e.duration,
+    showIcon: o.showIcon ?? e.showIcon,
+    animateTransformOrigin: o.animateTransformOrigin ?? e.animateTransformOrigin,
+    position: o.position,
+    icon: o.icon,
+    type: a === "default" ? o.type ?? "default" : a,
     status: "entering",
     zIndex: ++u,
     content: n,
     action: i,
-    swipeToClose: t.swipeToClose ?? e.swipeToClose,
-    updateState: "initial"
+    swipeToClose: o.swipeToClose ?? e.swipeToClose,
+    updateState: "initial",
+    onClose: o.onClose
   };
 }
-function l({ id: a, content: i, options: n }) {
-  const o = typeof n == "object" && n !== null ? n : {};
+function p({ id: a, content: i, options: n }) {
+  const t = typeof n == "object" && n !== null ? n : {};
   return {
-    ...o,
+    ...t,
     id: a,
     content: i,
     action: "update",
-    duration: o.duration ?? e.duration,
-    toasterId: `${o.toasterId ?? r}`
+    duration: t.duration ?? e.duration,
+    toasterId: `${t.toasterId ?? s}`
   };
 }
 export {
-  p as createToast,
+  l as createToast,
   d as genId,
-  l as updateToast
+  p as updateToast
 };

package/dist/react/components/toast/service/manageToasts/dismissToasts.js

@@ -1,19 +1,24 @@
-import { LEAVE_DELAY as r, clearAllTimers as s, clearTimer as u } from "./timers.js";
-function a({ toast: l, setToasts: n }) {
-  if (l.action === "dismiss" && l.id == null) {
-    n((i) => i.map((e) => ({ ...e, status: "leaving" }))), setTimeout(() => {
-      n((i) => i.filter((e) => e.status !== "leaving"));
-    }, r), s();
+import { LEAVE_DELAY as l, clearAllTimers as u, clearTimer as r } from "./timers.js";
+function m({ toast: s, setToasts: d }) {
+  if (s.action === "dismiss" && s.id == null) {
+    d((n) => n.map((i) => ({ ...i, status: "leaving" }))), setTimeout(() => {
+      d((n) => (n.forEach((i) => {
+        i.status === "leaving" && setTimeout(() => i.onClose?.(i.id), 0);
+      }), n.filter((i) => i.status !== "leaving")));
+    }, l), u();
     return;
   }
-  n((i) => (i.find((d) => d.id === l.id) && u(l.id), i.map(
-    (d) => d.id === l.id ? { ...d, status: "leaving" } : d
+  d((n) => (n.find((e) => e.id === s.id) && r(s.id), n.map(
+    (e) => e.id === s.id ? { ...e, status: "leaving" } : e
   ))), setTimeout(() => {
-    n(
-      (i) => i.filter((e) => !(e.id === l.id && e.status === "leaving"))
-    );
-  }, r);
+    d((n) => {
+      const i = n.find(
+        (e) => e.id === s.id && e.status === "leaving"
+      );
+      return i && setTimeout(() => i.onClose?.(i.id), 0), n.filter((e) => !(e.id === s.id && e.status === "leaving"));
+    });
+  }, l);
 }
 export {
-  a as default
+  m as default
 };

package/dist/react/components/toast/service/triggerToasts.js

@@ -1,103 +1,92 @@
-import { createToast as n, updateToast as s, genId as c } from "./createToast.js";
-import { notify as e } from "./listenars.js";
-const i = (r, t) => {
-  r != null && e(
-    n({
-      type: "default",
-      action: "add",
-      content: r,
-      options: t
-    })
-  );
-};
-i.dismiss = (r, t) => {
-  e({
-    action: "dismiss",
-    id: r,
-    toasterId: t
+import { createToast as o, updateToast as d, genId as c } from "./createToast.js";
+import { notify as i } from "./listenars.js";
+const e = (r, n) => {
+  const t = o({
+    type: "default",
+    action: "add",
+    content: r,
+    options: n
   });
+  return r == null || i(t), t.id;
 };
-i.info = (r, t) => {
-  r != null && e(
-    n({
-      action: "add",
-      type: "info",
-      content: r,
-      options: t
-    })
-  );
-};
-i.success = (r, t) => {
-  r != null && e(
-    n({
-      action: "add",
-      type: "success",
-      content: r,
-      options: t
-    })
-  );
+e.dismiss = (r, n) => (i({
+  action: "dismiss",
+  id: r,
+  toasterId: n
+}), r);
+e.info = (r, n) => {
+  const t = o({
+    action: "add",
+    type: "info",
+    content: r,
+    options: n
+  });
+  return r == null || i(t), t.id;
 };
-i.warning = (r, t) => {
-  r != null && e(
-    n({
-      action: "add",
-      type: "warning",
-      content: r,
-      options: t
-    })
-  );
+e.success = (r, n) => {
+  const t = o({
+    action: "add",
+    type: "success",
+    content: r,
+    options: n
+  });
+  return r == null || i(t), t.id;
 };
-i.error = (r, t) => {
-  r != null && e(
-    n({
-      action: "add",
-      type: "error",
-      content: r,
-      options: t
-    })
-  );
+e.warning = (r, n) => {
+  const t = o({
+    action: "add",
+    type: "warning",
+    content: r,
+    options: n
+  });
+  return r == null || i(t), t.id;
 };
-i.loading = (r, t) => {
-  r != null && e(
-    n({
-      action: "add",
-      type: "loading",
-      content: r,
-      options: { duration: 1 / 0, ...t }
-    })
-  );
+e.error = (r, n) => {
+  const t = o({
+    action: "add",
+    type: "error",
+    content: r,
+    options: n
+  });
+  return r == null || i(t), t.id;
 };
-i.custom = (r, t) => {
-  r != null && e(
-    n({
-      action: "add",
-      type: "custom",
-      content: r,
-      options: t
-    })
-  );
+e.loading = (r, n) => {
+  const t = o({
+    action: "add",
+    type: "loading",
+    content: r,
+    options: { duration: 1 / 0, ...n }
+  });
+  return r == null || i(t), t.id;
 };
-i.update = (r, t, o) => {
-  r != null && t != null && e(s({ id: `${r}`, content: t, options: o }));
+e.custom = (r, n) => {
+  const t = o({
+    action: "add",
+    type: "custom",
+    content: r,
+    options: n
+  });
+  return r == null || i(t), t.id;
 };
-i.promise = (async (r, t, o) => {
+e.update = (r, n, t) => r == null ? "" : (n == null || i(d({ id: `${r}`, content: n, options: t })), r);
+e.promise = (async (r, n, t) => {
   const u = c();
-  e(
-    n({
+  i(
+    o({
       action: "add",
       type: "loading",
-      content: t.loading,
-      options: { ...o, id: u, duration: 1 / 0, swipeToClose: !1 }
+      content: n.loading,
+      options: { ...t, id: u, duration: 1 / 0, swipeToClose: !1 }
     })
   );
   try {
-    const a = await r, d = typeof t.success == "function" ? await t.success(a) : t.success;
-    return i.update(u, d, { ...o, type: "success" }), a;
+    const a = await r, s = typeof n.success == "function" ? await n.success(a) : n.success;
+    return e.update(u, s, { ...t, type: "success" }), a;
   } catch (a) {
-    const d = typeof t.error == "function" ? await t.error(a) : t.error;
-    throw i.update(u, d, { ...o, type: "error" }), a;
+    const s = typeof n.error == "function" ? await n.error(a) : n.error;
+    throw e.update(u, s, { ...t, type: "error" }), a;
   }
 });
 export {
-  i as toast
+  e as toast
 };

package/dist/react/hooks/useMounted.js

@@ -0,0 +1,10 @@
+import { useState as u, useEffect as o } from "react";
+function r() {
+  const [e, t] = u(!1);
+  return o(() => {
+    t(!0);
+  }, []), e;
+}
+export {
+  r as useMounted
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kitzo",
-  "version": "3.1.1",
+  "version": "3.1.3",
   "description": "A lightweight production-ready React micro-utility library providing essential components, hooks, and functions for modern web applications.",
   "type": "module",
   "files": [