kitzo 3.1.0 → 3.1.2

package/README.md

@@ -1,44 +1,43 @@
 # Kitzo
 
-A lightweight, production-ready React micro-utility library providing essential components, hooks, and functions for modern web applications.
+Lightweight, production-ready React micro-utilities for modern web applications. Focus on simplicity, performance, and minimal footprint.
+
+[Full Documentation & Demos](https://kitzo.vercel.app)
 
 ## Installation
 
 ```bash
 npm install kitzo
+# or
+pnpm add kitzo
 ```
 
-## Core Features
-
-### React Components
-
-Essential, accessible, and performance-optimized UI components:
-
-- **Toast**: A flexible notification system with support for custom positions, animations, and interaction patterns.
-- **Tooltip**: A contextual information component with smart positioning and customizable delay and animations.
+## Features
 
-### React Hooks
+### Components
 
-A collection of hooks to simplify common React application logic:
+- **Toast**: Smart notification system with flexible positioning.
+- **Tooltip**: Contextual information with auto-positioning logic.
 
-- **useDebounce**: Delays value updates until a specified time has passed.
-- **useDebouncedCallback**: Returns a debounced version of a callback function.
-- **useThrottle**: Limits the execution rate of a frequently changing value.
-- **useLocalStorage**: Synchronizes state with browser local storage.
-- **useWindowSize**: Provides real-time window dimensions.
-- **useCopy**: Simplifies clipboard operations within components.
+### Hooks
 
-### Utility Functions
+- **useCopy**: Easy clipboard management.
+- **useDebounce**: Debounc any value.
+- **useDebouncedCallback**: Debounce function calls.
+- **useLocalStorage**: State persistence via storage.
+- **useOverlay**: History-synchronized overlay management.
+- **useThrottle**: Limit execution rate.
+- **useWindowSize**: Real-time window dimensions.
 
-- **copy**: A standalone function for programmatically interacting with the system clipboard.
+### Utilities
 
-## Documentation
+- **copy**: Standalone programmatic clipboard copy.
 
-For full usage guides, API references, and live demonstrations, visit the documentation site:
-[https://kitzo.vercel.app](https://kitzo.vercel.app)
+## See Also
 
-Check out the [root project](https://github.com/riyad-96/kitzo) for project-wide information.
+- [Root Repository](https://github.com/riyad-96/kitzo)
+- [Documentation](https://github.com/riyad-96/kitzo/tree/main/apps/docs)
 
 ## License
 
-This project is licensed under the MIT License.
+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'>;

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/package.json

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