kitzo 2.1.16 → 2.1.18

package/README.md

@@ -26,7 +26,7 @@ npm i kitzo
 or
 
 ```javascript
-<script src="https://cdn.jsdelivr.net/npm/kitzo@2.1.16/dist/kitzo.umd.min.js"></script>
+<script src="https://cdn.jsdelivr.net/npm/kitzo@2.1.18/dist/kitzo.umd.min.js"></script>
 ```
 
 > Vanilla: Attach this script tag in the html head tag and you are good to go.

package/dist/react/index.d.ts

@@ -0,0 +1,2 @@
+export * from './types/toast';
+export * from './types/tooltip';

package/dist/{react.esm.js → react/react.esm.js}

@@ -554,12 +554,23 @@ function ToastContainer(props) {
 
 const tooltipStyles = `
 .kitzo-react-tooltip-content-default-style {
-  font-family: sans-serif;
+  font-family:
+    system-ui,
+    -apple-system,
+    BlinkMacSystemFont,
+    'Segoe UI',
+    Roboto,
+    Oxygen,
+    Ubuntu,
+    Cantarell,
+    'Open Sans',
+    'Helvetica Neue',
+    sans-serif;
   font-size: 0.875rem;
   background-color: hsl(0, 0%, 15%);
   color: hsl(0, 0%, 95%);
-  padding-block: 6px;
-  padding-inline: 10px;
+  padding-block: 0.25rem;
+  padding-inline: 0.5rem;
   border-radius: 0.325rem;
 
   @media (prefers-color-scheme: dark) {
@@ -569,8 +580,11 @@ const tooltipStyles = `
 }
 
 .kitzo-react-tooltip-wrapper {
-  transition-duration: 120ms, 50ms;
-  transition-property: scale opacity;
+  --tooltip-transition-delay: calc(var(--delay) * 1ms);
+  will-change: transform, opacity;
+  transition:
+    transform 110ms var(--tooltip-transition-delay),
+    opacity 110ms var(--tooltip-transition-delay);
 }
 
 .kitzo-react-tooltip-wrapper.top {
@@ -578,8 +592,7 @@ const tooltipStyles = `
 
   bottom: calc(var(--tooltip-offset) + 100%);
   left: 50%;
-  translate: -50% 0;
-  scale: 0.7;
+  transform: translateX(-50%) translateY(0) scale(0.8);
   opacity: 0;
   transform-origin: bottom;
 }
@@ -589,8 +602,7 @@ const tooltipStyles = `
 
   left: calc(var(--tooltip-offset) + 100%);
   top: 50%;
-  translate: 0 -50%;
-  scale: 0.7;
+  transform: translateX(0) translateY(-50%) scale(0.8);
   opacity: 0;
   transform-origin: left;
 }
@@ -600,8 +612,7 @@ const tooltipStyles = `
 
   top: calc(var(--tooltip-offset) + 100%);
   left: 50%;
-  translate: -50% 0;
-  scale: 0.7;
+  transform: translateX(-50%) translateY(0) scale(0.8);
   opacity: 0;
   transform-origin: top;
 }
@@ -611,27 +622,26 @@ const tooltipStyles = `
 
   right: calc(var(--tooltip-offset) + 100%);
   top: 50%;
-  translate: 0 -50%;
-  scale: 0.7;
+  transform: translateX(0) translateY(-50%) scale(0.8);
   opacity: 0;
   transform-origin: right;
 }
 
 .kitzo-react-tooltip-root:hover {
   .kitzo-react-tooltip-wrapper.top {
-    scale: 1;
+    transform: translateX(-50%) translateY(0) scale(1);
     opacity: 1;
   }
   .kitzo-react-tooltip-wrapper.right {
-    scale: 1;
+    transform: translateX(0) translateY(-50%) scale(1);
     opacity: 1;
   }
   .kitzo-react-tooltip-wrapper.bottom {
-    scale: 1;
+    transform: translateX(-50%) translateY(0) scale(1);
     opacity: 1;
   }
   .kitzo-react-tooltip-wrapper.left {
-    scale: 1;
+    transform: translateX(0) translateY(-50%) scale(1);
     opacity: 1;
   }
 }
@@ -644,9 +654,9 @@ const tooltipStyles = `
     document.head.appendChild(styleTag);
   }
 })();
+const allowedPositions = ['top', 'right', 'bottom', 'left'];
 function getPositionBasedClassName(position) {
   let defaultClass = 'kitzo-react-tooltip-wrapper';
-  const allowedPositions = ['top', 'right', 'bottom', 'left'];
   if (allowedPositions.includes(position)) {
     return defaultClass + ' ' + position;
   } else {
@@ -655,26 +665,29 @@ function getPositionBasedClassName(position) {
 }
 function Tooltip({
   content = 'Tooltip',
-  position = '',
-  offset = 8,
-  hideOnTouch = true,
+  tooltipOptions = {},
   children
 }) {
-  if (typeof hideOnTouch !== 'boolean') hideOnTouch = true;
+  const {
+    position = 'top',
+    offset = 8,
+    hideOnTouch = true,
+    delay = 0
+  } = tooltipOptions ?? {};
+  const finalOptions = {
+    position: typeof position === 'string' ? position.trim().toLowerCase() : 'top',
+    offset: !isNaN(Number(offset)) ? Number(offset) : 8,
+    delay: !isNaN(Number(delay)) ? Number(delay) : 0,
+    hideOnTouch: typeof hideOnTouch === 'boolean' ? hideOnTouch : true
+  };
   const isTouch = window.matchMedia('(pointer: coarse)').matches;
-  if (isTouch && hideOnTouch) return children;
-
-  // sanitize props
-  if (typeof position !== 'string') {
-    console.warn(`[kitzo/react]: Tooltip position ignored due to invalid data type.`);
-    position = 'top';
-  }
-  if (isNaN(Number(offset))) offset = 8;
+  if (isTouch && finalOptions.hideOnTouch) return children;
   return /*#__PURE__*/React.createElement("div", {
     style: {
       position: 'relative',
       width: 'fit-content',
-      '--offset': Math.max(0, offset)
+      '--offset': Math.max(0, finalOptions.offset),
+      '--delay': Math.max(0, finalOptions.delay)
     },
     className: "kitzo-react-tooltip-root"
   }, children, /*#__PURE__*/React.createElement("div", {
@@ -684,93 +697,10 @@ function Tooltip({
       pointerEvents: 'none'
     },
     tabIndex: -1,
-    className: getPositionBasedClassName(position.trim().toLowerCase())
+    className: getPositionBasedClassName(finalOptions.position)
   }, typeof content === 'string' || typeof content === 'number' ? /*#__PURE__*/React.createElement("div", {
     className: "kitzo-react-tooltip-content-default-style"
   }, content) : /*#__PURE__*/React.createElement(React.Fragment, null, content)));
 }
 
-function useScrollRestoration(path, key, options = {}) {
-  if (!path || typeof path !== 'object' && typeof path !== 'string') {
-    throw new Error('kitzo/react: useScrollRestoration(path, ...) expect location object from the react useLocation hook or unique path string(location.pathname)');
-  }
-  if (!key || typeof key !== 'string' && typeof key !== 'number') {
-    throw new Error('kitzo/react: useScrollRestoration(..., key) expect unique string or number');
-  }
-  const pathname = typeof path === 'object' ? path.pathname : path;
-  const behavior = options?.behavior ? options.behavior : 'instant';
-  const delay = options?.delay ? isNaN(Number(options.delay)) ? 0 : Number(options.delay) : 0;
-
-  // hook management
-  const ref = useRef(null);
-  const history = useRef(new Map());
-
-  // hook logic
-  useEffect(() => {
-    const element = ref.current;
-    const target = element || window;
-    const isWindow = target === window;
-    const mapKey = `${pathname}::${key}`;
-    const saved = history.current.get(mapKey);
-    const restore = () => {
-      if (!saved) return;
-      if (isWindow) {
-        window.scrollTo({
-          top: saved.top,
-          left: saved.left,
-          behavior
-        });
-      } else if (element) {
-        element.scrollTo({
-          top: saved.top,
-          left: saved.left,
-          behavior
-        });
-      }
-    };
-    if (saved) {
-      if (delay > 0) {
-        const timeoutId = setTimeout(restore, delay);
-        return () => clearTimeout(timeoutId);
-      } else {
-        restore();
-      }
-    } else {
-      if (isWindow) {
-        window.scrollTo({
-          top: 0,
-          left: 0,
-          behavior: 'auto'
-        });
-      } else if (element) {
-        element.scrollTo({
-          top: 0,
-          left: 0,
-          behavior: 'auto'
-        });
-      }
-    }
-    let timeoutId = null;
-    const save = () => {
-      clearTimeout(timeoutId);
-      timeoutId = setTimeout(() => {
-        const top = isWindow ? window.scrollY : element?.scrollTop ?? 0;
-        const left = isWindow ? window.scrollX : element?.scrollLeft ?? 0;
-        history.current.set(mapKey, {
-          top,
-          left
-        });
-      }, 50);
-    };
-    target.addEventListener('scroll', save, {
-      passive: true
-    });
-    return () => {
-      target.removeEventListener('scroll', save);
-      clearTimeout(timeoutId);
-    };
-  }, [pathname, key, behavior, delay]);
-  return ref;
-}
-
-export { ToastContainer, Tooltip, toast, useScrollRestoration };
+export { ToastContainer, Tooltip, toast };

package/dist/react/types/toast.d.ts

@@ -0,0 +1,46 @@
+import type { ReactNode, CSSProperties, JSX } from 'react';
+
+//! Toast API types declaration
+type Positions =
+  | 'top-left'
+  | 'top-center'
+  | 'top-right'
+  | 'bottom-left'
+  | 'bottom-center'
+  | 'bottom-right';
+
+type ToastOptions = {
+  position?: Positions;
+  duration?: number;
+  style?: CSSProperties;
+  showIcon?: boolean;
+};
+
+type CustomContent = string | ReactNode | ((dismiss: () => void) => ReactNode);
+
+type ToastAPI = {
+  (text: string, options?: ToastOptions): void;
+
+  success(text: string, options?: ToastOptions): void;
+
+  error(text: string, options?: ToastOptions): void;
+
+  promise<T>(
+    callback: Promise<T>,
+    msgs: {
+      loading: string;
+      success: string | ((res: T) => string | Promise<string>);
+      error: string | ((err: any) => string | Promise<string>);
+    },
+    options?: ToastOptions,
+  ): void;
+
+  custom(
+    content: CustomContent,
+    options?: { duration?: number; exitDelay?: number; position?: Positions },
+  ): void;
+};
+
+export declare const toast: ToastAPI;
+
+export declare function ToastContainer(props: { position?: Positions; gap?: number }): JSX.Element;

package/dist/react/types/tooltip.d.ts

@@ -0,0 +1,32 @@
+import type { JSX, PropsWithChildren, ReactNode } from 'react';
+
+type TooltipOptions = {
+  /**
+   * Default position: 'top'
+   */
+  position?: 'top' | 'right' | 'bottom' | 'left';
+  /**
+   * Default offset: 8
+   */
+  offset?: number;
+  /**
+   * Default delay: 0
+   */
+  delay?: number;
+  /**
+   * Default hideOnTouch: true
+   */
+  hideOnTouch?: boolean;
+};
+
+type TooltipCoreProps = {
+  /**
+   * content is necessary
+   */
+  content: ReactNode;
+  tooltipOptions?: TooltipOptions;
+};
+
+type TooltipProps = PropsWithChildren<TooltipCoreProps>;
+
+export declare function Tooltip(props: TooltipProps): JSX.Element;

package/package.json

@@ -1,62 +1,73 @@
-{
-  "name": "kitzo",
-  "version": "2.1.16",
-  "description": "A lightweight JavaScript UI micro-library.",
-  "type": "module",
-  "main": "./dist/kitzo.umd.js",
-  "exports": {
-    ".": {
-      "import": "./dist/kitzo.esm.js",
-      "require": "./dist/kitzo.umd.js",
-      "types": "./dist/kitzo.d.ts"
-    },
-    "./react": {
-      "import": "./dist/react.esm.js",
-      "types": "./dist/react.d.ts"
-    }
-  },
-  "files": [
-    "dist"
-  ],
-  "scripts": {
-    "dev": "vite",
-    "build": "rollup -c",
-    "preview": "vite preview"
-  },
-  "keywords": [
-    "tooltip",
-    "ripple",
-    "copy-button",
-    "micro-library",
-    "modular",
-    "ui",
-    "javascript",
-    "react",
-    "kitzo"
-  ],
-  "author": "Riyad",
-  "license": "MIT",
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/riyad-96/kitzo"
-  },
-  "homepage": "https://github.com/riyad-96/kitzo#readme",
-  "devDependencies": {
-    "@babel/core": "^7.28.4",
-    "@babel/preset-react": "^7.27.1",
-    "@rollup/plugin-babel": "^6.0.4",
-    "@rollup/plugin-commonjs": "^28.0.6",
-    "@rollup/plugin-node-resolve": "^16.0.1",
-    "@types/react": "^19.2.6",
-    "@vitejs/plugin-react": "^5.0.4",
-    "prettier": "^3.6.2",
-    "react": "^19.1.1",
-    "react-dom": "^19.1.1",
-    "rollup": "^4.46.2",
-    "vite": "^7.0.4"
-  },
-  "peerDependencies": {
-    "react": ">=17",
-    "react-dom": ">=17"
-  }
-}
+{
+  "name": "kitzo",
+  "version": "2.1.18",
+  "description": "A lightweight JavaScript & React UI micro-library.",
+  "type": "module",
+  "main": "./dist/vanilla/vanilla.umd.js",
+  "exports": {
+    ".": {
+      "types": "./dist/vanilla/vanilla.d.ts",
+      "import": "./dist/vanilla/vanilla.esm.js",
+      "require": "./dist/vanilla/vanilla.umd.js"
+    },
+    "./react": {
+      "types": "./dist/react/index.d.ts",
+      "import": "./dist/react/react.esm.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "dev": "vite",
+    "build": "rollup -c",
+    "build-test": "vite buil",
+    "lint": "eslint .",
+    "preview": "vite preview"
+  },
+  "keywords": [
+    "tooltip",
+    "ripple",
+    "copy-button",
+    "micro-library",
+    "modular",
+    "ui",
+    "javascript",
+    "react",
+    "kitzo"
+  ],
+  "author": "Riyad",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/riyad-96/kitzo"
+  },
+  "homepage": "https://github.com/riyad-96/kitzo#readme",
+  "devDependencies": {
+    "@babel/core": "^7.28.5",
+    "@babel/preset-react": "^7.28.5",
+    "@eslint/js": "^9.39.1",
+    "@rollup/plugin-babel": "^6.1.0",
+    "@rollup/plugin-commonjs": "^29.0.0",
+    "@rollup/plugin-node-resolve": "^16.0.3",
+    "@tailwindcss/vite": "^4.1.17",
+    "@types/react": "^19.2.5",
+    "@types/react-dom": "^19.2.3",
+    "@vitejs/plugin-react": "^5.1.1",
+    "eslint": "^9.39.1",
+    "eslint-plugin-react-hooks": "^7.0.1",
+    "eslint-plugin-react-refresh": "^0.4.24",
+    "globals": "^16.5.0",
+    "prettier": "^3.6.2",
+    "prettier-plugin-tailwindcss": "^0.7.1",
+    "react": "^19.2.0",
+    "react-dom": "^19.2.0",
+    "react-router-dom": "^7.9.6",
+    "tailwindcss": "^4.1.17",
+    "vite": "^7.2.4"
+  },
+  "peerDependencies": {
+    "react": ">=19",
+    "react-dom": ">=19"
+  }
+}

package/dist/react.d.ts

@@ -1,75 +0,0 @@
-import type { ReactNode, CSSProperties, JSX, PropsWithChildren, RefObject } from 'react';
-
-//! Toast API types declaration
-export type Positions =
-  | 'top-left'
-  | 'top-center'
-  | 'top-right'
-  | 'bottom-left'
-  | 'bottom-center'
-  | 'bottom-right';
-
-export interface ToastOptions {
-  position?: Positions;
-  duration?: number;
-  style?: CSSProperties;
-  showIcon?: boolean;
-}
-
-export type CustomContent = string | ReactNode | ((dismiss: () => void) => ReactNode);
-
-export interface ToastAPI {
-  (text?: string, options?: ToastOptions): void;
-
-  success(text?: string, options?: ToastOptions): void;
-
-  error(text?: string, options?: ToastOptions): void;
-
-  promise<T>(
-    callback: Promise<T>,
-    msgs?: {
-      loading?: string;
-      success?: string | ((res: T) => string | Promise<string>);
-      error?: string | ((err: any) => string | Promise<string>);
-    },
-    options?: ToastOptions,
-  ): void;
-
-  custom(
-    content: CustomContent,
-    options?: { duration?: number; exitDelay?: number; position?: Positions },
-  ): void;
-}
-
-export declare const toast: ToastAPI;
-
-export declare function ToastContainer(props: { position?: Positions; gap?: number }): JSX.Element;
-
-//! Tooltip API types declaration
-export interface TooltipCoreProps {
-  content: string | ReactNode;
-  position?: 'top' | 'right' | 'bottom' | 'left';
-  offset?: number;
-  hideOnTouch?: boolean;
-}
-
-export type TooltipProps = PropsWithChildren<TooltipCoreProps>;
-
-export declare function Tooltip(props: TooltipProps): JSX.Element;
-
-//! useScrollRestoration hook types declaration
-type ScrollHookOptions = {
-  behavior?: 'auto' | 'smooth' | 'instant';
-  delay?: number;
-};
-
-type LocationLike = {
-  pathname: string;
-  [key: string]: any;
-};
-
-export declare function useScrollRestoration<T extends HTMLElement = HTMLDivElement>(
-  path: LocationLike | string,
-  key: string | number,
-  options?: ScrollHookOptions,
-): RefObject<T | null>;