@keenthemes/ktui 1.0.10 → 1.0.12

package/src/components/toast/toast.css

@@ -0,0 +1,60 @@
+/**
+ * KTUI - Free & Open-Source Tailwind UI Components by Keenthemes
+ * Copyright 2025 by Keenthemes Inc
+ */
+
+ /* Base Styles */
+ @layer components {
+  /* Container */
+  .kt-toast-container {
+    @apply fixed;
+  }
+
+  /* Toast */
+  .kt-toast {
+    @apply fixed z-9999 max-w-[95%] w-76 shadow-sm pointer-events-auto overflow-hidden;
+
+    opacity: 0;
+    animation: kt-toast-in 0.28s cubic-bezier(.4,0,.2,1) forwards;
+    transition: top 0.28s cubic-bezier(.4,0,.2,1), opacity 0.28s cubic-bezier(.4,0,.2,1);
+
+    &.kt-toast-top-end { @apply bottom-auto top-0 end-0; }
+    &.kt-toast-top-center { @apply bottom-auto top-0 start-1/2 -translate-x-1/2; }
+    &.kt-toast-top-start { @apply bottom-auto top-0 start-0; }
+    &.kt-toast-bottom-end { @apply top-auto bottom-0 end-0; }
+    &.kt-toast-bottom-center { @apply top-auto bottom-0 start-1/2 -translate-x-1/2; } 
+    &.kt-toast-bottom-start { @apply top-auto bottom-0 start-0; }
+  }
+
+  /* Progress */
+  .kt-toast-progress {
+    @apply fixed start-0 bottom-0 w-full h-[3px] bg-primary;
+    transform-origin: left;
+    animation: kt-toast-progress-line linear forwards;
+  }
+ }
+
+/* RTL Styles */
+@layer components {
+	[dir='rtl'] .kt-toast-progress {
+    transform-origin: right;
+  }
+}
+
+/* Animations */
+@layer components {
+  @keyframes kt-toast-in {
+    from { opacity: 0; transform: translateY(-24px); }
+    to { opacity: 1; transform: translateY(0); }
+  }
+
+  @keyframes kt-toast-out {
+    from { opacity: 1;  }
+    to { opacity: 0;  }
+  }
+
+  @keyframes kt-toast-progress-line {
+    from { transform: scaleX(1); }
+    to { transform: scaleX(0); }
+  }
+}

package/src/components/toast/toast.ts

@@ -0,0 +1,605 @@
+/**
+ * KTUI - Free & Open-Source Tailwind UI Components by Keenthemes
+ * Copyright 2025 by Keenthemes Inc
+ */
+
+import KTComponent from '../component';
+import KTData from '../../helpers/data';
+import {
+	KTToastOptions,
+	KTToastConfig,
+	KTToastInstance,
+	KTToastPosition,
+} from './types';
+
+const DEFAULT_CONFIG: KTToastConfig = {
+	position: 'top-end',
+	duration: 4000,
+	className: '',
+	maxToasts: 5,
+	offset: 15,
+	gap: 10,
+};
+
+const DEFAULT_TOAST_OPTIONS: KTToastOptions = {
+	appearance: 'solid',
+	progress: false,
+	size: 'md',
+	action: false,
+	cancel: false,
+	dismiss: true,
+};
+
+import type { KTToastConfigInterface, KTToastInterface } from './types';
+
+export class KTToast extends KTComponent implements KTToastInterface {
+	protected override _name: string = 'toast';
+	protected override _defaultConfig: KTToastConfigInterface = DEFAULT_CONFIG;
+	protected override _config: KTToastConfigInterface = DEFAULT_CONFIG;
+	protected _defaultToastOptions: KTToastOptions = DEFAULT_TOAST_OPTIONS;
+	private static containerMap: Map<KTToastPosition, HTMLElement> = new Map();
+	private static toasts: Map<string, KTToastInstance> = new Map();
+	private static globalConfig: KTToastConfig = { ...DEFAULT_CONFIG };
+
+	/**
+	 * Creates a new KTToast instance for a specific element (not commonly used; most use static API).
+	 * @param element The target HTML element.
+	 * @param config Optional toast config for this instance.
+	 */
+	constructor(element: HTMLElement, config?: Partial<KTToastConfigInterface>) {
+		super();
+		if (KTData.has(element, this._name)) return;
+		this._init(element);
+		this._buildConfig(config);
+		KTData.set(element, this._name, this);
+	}
+
+	/**
+	 * Generates the HTML content for a toast based on the provided options.
+	 * @param options Toast options (message, icon, actions, etc).
+	 * @returns The toast's HTML markup as a string.
+	 */
+	static getContent(options?: KTToastOptions) {
+		const classNames = {
+			...((this.globalConfig.classNames as any) || {}),
+			...((options?.classNames as any) || {}),
+		};
+
+		if (options?.content) {
+			if (typeof options.content === 'string') {
+				return options.content;
+			} else if (typeof options.content === 'function') {
+				const node = options.content();
+				if (node instanceof HTMLElement) {
+					return node.outerHTML;
+				}
+			} else if (options.content instanceof HTMLElement) {
+				return options.content.outerHTML;
+			}
+		}
+
+		let template = '';
+
+		if (options?.icon) {
+			template +=
+				'<div class="kt-alert-icon ' +
+				(classNames.icon || '') +
+				'">' +
+				options.icon +
+				'</div>';
+		}
+
+		if (options?.message) {
+			template +=
+				'<div class="kt-alert-title ' +
+				(classNames.message || '') +
+				'">' +
+				options.message +
+				'</div>';
+		}
+
+		if (
+			options?.action !== false ||
+			options?.dismiss !== false ||
+			options?.cancel !== false
+		) {
+			template +=
+				'<div class="kt-alert-toolbar ' + (classNames.toolbar || '') + '">';
+			template +=
+				'<div class="kt-alert-actions ' + (classNames.actions || '') + '">';
+
+			if (options?.action && typeof options.action === 'object') {
+				template +=
+					'<button data-kt-toast-action="true" class="' +
+					(options.action.className || '') +
+					'">' +
+					options.action.label +
+					'</button>';
+			}
+
+			if (options?.cancel && typeof options.cancel === 'object') {
+				template +=
+					'<button data-kt-toast-cancel="true" class="' +
+					(options.cancel.className || '') +
+					'">' +
+					options.cancel.label +
+					'</button>';
+			}
+
+			if (options?.dismiss !== false) {
+				template +=
+					'<button data-kt-toast-dismiss="true" class="kt-alert-close"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M18 6 6 18"/><path d="m6 6 12 12"/></svg></button>';
+			}
+
+			template += '</div>';
+			template += '</div>';
+		}
+
+		template += '</div>';
+
+		return template;
+	}
+
+	/**
+	 * Update all toasts in the container with smooth animation.
+	 *
+	 * @param container The toast container element.
+	 * @param offset Optional offset from the edge.
+	 */
+	static update(container: HTMLElement | null, offset?: number) {
+		if (!container) return;
+		offset =
+			typeof offset === 'number' ? offset : (this.globalConfig.offset ?? 15);
+		requestAnimationFrame(() => {
+			const gap = this.globalConfig.gap ?? 8;
+			// Group toasts by alignment (top/bottom)
+			const positionGroups: Record<string, HTMLElement[]> = {
+				top: [],
+				bottom: [],
+			};
+			const toasts = Array.from(container.children) as HTMLElement[];
+			toasts.forEach((toast) => {
+				if (
+					toast.classList.contains('kt-toast-top-end') ||
+					toast.classList.contains('kt-toast-top-center') ||
+					toast.classList.contains('kt-toast-top-start')
+				) {
+					positionGroups.top.push(toast);
+				} else {
+					positionGroups.bottom.push(toast);
+				}
+			});
+
+			// Stack top toasts from the top down
+			let currentOffset = offset;
+			positionGroups.top.forEach((toast) => {
+				toast.style.top = `${currentOffset}px`;
+				toast.style.bottom = '';
+				toast.style.transition =
+					'top 0.28s cubic-bezier(.4,0,.2,1), opacity 0.28s cubic-bezier(.4,0,.2,1)';
+				currentOffset += toast.offsetHeight + gap;
+
+				if (toast.classList.contains('kt-toast-top-start')) {
+					toast.style.insetInlineStart = `${offset}px`;
+				}
+
+				if (toast.classList.contains('kt-toast-top-end')) {
+					toast.style.insetInlineEnd = `${offset}px`;
+				}
+			});
+
+			// Stack bottom toasts from the bottom up
+			currentOffset = offset;
+			for (let i = positionGroups.bottom.length - 1; i >= 0; i--) {
+				const toast = positionGroups.bottom[i];
+				toast.style.bottom = `${currentOffset}px`;
+				toast.style.top = '';
+				toast.style.transition =
+					'bottom 0.28s cubic-bezier(.4,0,.2,1), opacity 0.28s cubic-bezier(.4,0,.2,1)';
+				currentOffset += toast.offsetHeight + gap;
+
+				if (toast.classList.contains('kt-toast-bottom-start')) {
+					toast.style.insetInlineStart = `${offset}px`;
+				}
+
+				if (toast.classList.contains('kt-toast-bottom-end')) {
+					toast.style.insetInlineEnd = `${offset}px`;
+				}
+			}
+		});
+	}
+
+	/**
+	 * Set global toast configuration options.
+	 * @param options Partial toast config to merge with global config.
+	 */
+	static config(options: Partial<KTToastConfig>) {
+		this.globalConfig = { ...this.globalConfig, ...options };
+	}
+
+	/**
+	 * Show a toast notification.
+	 * @param inputOptions Toast options (message, duration, variant, etc).
+	 * @returns Toast instance with dismiss method, or undefined if invalid input.
+	 */
+	static show(
+		inputOptions?: KTToastOptions,
+	): (KTToastInstance & { dismiss: () => void }) | undefined {
+		const options = { ...DEFAULT_TOAST_OPTIONS, ...inputOptions };
+
+		if (!options || (!options.message && !options.content)) {
+			return undefined;
+		}
+
+		// Always resolve the id once and use it everywhere
+		const id = `kt-toast-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`;
+
+		const position =
+			options.position || this.globalConfig.position || 'top-end';
+
+		const classNames = {
+			...((this.globalConfig.classNames as any) || {}),
+			...((options.classNames as any) || {}),
+		};
+
+		let container = this.containerMap.get(position);
+
+		if (!container) {
+			container = document.createElement('div');
+			const classNames = {
+				...((this.globalConfig.classNames as any) || {}),
+				...((options.classNames as any) || {}),
+			};
+			// Fallback to default hardcoded classes if not provided in options or globalConfig
+			container.className =
+				classNames.container || `kt-toast-container ${position}`;
+			document.body.appendChild(container);
+			this.containerMap.set(position, container);
+		}
+
+		// Enforce maxToasts
+		if (
+			container.children.length >=
+			(this.globalConfig.maxToasts || DEFAULT_CONFIG.maxToasts)
+		) {
+			const firstToast = container.firstElementChild;
+			if (firstToast) {
+				firstToast.classList.add('kt-toast-closing');
+				firstToast.addEventListener('animationend', () => {
+					firstToast.remove();
+				});
+			}
+		}
+
+		// Create toast element
+		const variantMap = {
+			info: 'kt-alert-info',
+			success: 'kt-alert-success',
+			error: 'kt-alert-error',
+			warning: 'kt-alert-warning',
+			primary: 'kt-alert-primary',
+			secondary: 'kt-alert-secondary',
+			destructive: 'kt-alert-destructive',
+			mono: 'kt-alert-mono',
+		};
+
+		const appearanceMap = {
+			solid: 'kt-alert-solid',
+			outline: 'kt-alert-outline',
+			light: 'kt-alert-light',
+		};
+
+		const sizeMap = {
+			sm: 'kt-alert-sm',
+			md: 'kt-alert-md',
+			lg: 'kt-alert-lg',
+		};
+
+		const toast = document.createElement('div');
+		toast.className = `kt-toast kt-alert ${variantMap[options.variant] || ''} ${appearanceMap[options.appearance] || ''} ${sizeMap[options.size] || ''} ${options.className || ''} ${classNames.toast || ''}`;
+		// ARIA support
+		toast.setAttribute('role', options.role || 'status');
+		toast.setAttribute('aria-live', 'polite');
+		toast.setAttribute('aria-atomic', 'true');
+		toast.setAttribute('tabindex', '0');
+
+		// Always resolve the id once and use it everywhere
+		// Always resolve id ONCE at the top, use everywhere
+		// (Move this up to replace the previous const id = ... assignment)
+
+		// Populate content via getContent
+		const contentHtml = KTToast.getContent(options);
+		toast.innerHTML = contentHtml;
+
+		// Assign event handlers to buttons by data attribute
+		const actionBtn = toast.querySelector(
+			'[data-kt-toast-action]',
+		) as HTMLButtonElement | null;
+
+		if (
+			actionBtn &&
+			options.action &&
+			typeof options.action === 'object' &&
+			options.action.onClick
+		) {
+			actionBtn.addEventListener('click', (e) => {
+				e.stopPropagation();
+				if (typeof options.action === 'object' && options.action.onClick) {
+					options.action.onClick(id);
+					KTToast.close(id);
+				}
+			});
+		}
+
+		const cancelBtn = toast.querySelector(
+			'[data-kt-toast-cancel]',
+		) as HTMLButtonElement | null;
+
+		if (cancelBtn && options.cancel && typeof options.cancel === 'object') {
+			cancelBtn.addEventListener('click', (e) => {
+				e.stopPropagation();
+				if (typeof options.cancel === 'object' && options.cancel.onClick) {
+					options.cancel.onClick(id);
+					KTToast.close(id);
+				}
+			});
+		}
+
+		// Dismiss button handler
+		const dismissBtn = toast.querySelector(
+			'[data-kt-toast-dismiss]',
+		) as HTMLButtonElement | null;
+
+		if (dismissBtn && options.dismiss !== false) {
+			dismissBtn.addEventListener('click', (e) => {
+				e.stopPropagation();
+				KTToast.close(id);
+			});
+		}
+
+		// If modal-like, set aria-modal
+		if (options.important) toast.setAttribute('aria-modal', 'true');
+		toast.style.pointerEvents = 'auto';
+
+		// Progress line
+		const duration = options.important
+			? null
+			: (options.duration ??
+				this.globalConfig.duration ??
+				DEFAULT_CONFIG.duration);
+
+		if (duration && options.progress) {
+			const progress = document.createElement('div');
+			progress.className = 'kt-toast-progress ' + (classNames.progress || '');
+			progress.style.animationDuration = duration + 'ms';
+			progress.setAttribute('data-kt-toast-progress', 'true');
+			toast.appendChild(progress);
+		}
+
+		// Assign direction class to the toast itself, not the container
+		const directionClassMap: Record<string, string> = {
+			'top-end': 'kt-toast-top-end',
+			'top-center': 'kt-toast-top-center',
+			'top-start': 'kt-toast-top-start',
+			'bottom-end': 'kt-toast-bottom-end',
+			'bottom-center': 'kt-toast-bottom-center',
+			'bottom-start': 'kt-toast-bottom-start',
+		};
+		Object.values(directionClassMap).forEach((cls) =>
+			toast.classList.remove(cls),
+		);
+		const dirClass = directionClassMap[position] || 'kt-toast-top-end';
+		toast.classList.add(dirClass);
+
+		// Enforce maxToasts: remove oldest if needed
+		const maxToasts =
+			options.maxToasts ??
+			this.globalConfig.maxToasts ??
+			DEFAULT_CONFIG.maxToasts;
+		const currentToasts = Array.from(container.children) as HTMLElement[];
+		if (currentToasts.length >= maxToasts && currentToasts.length > 0) {
+			const oldestToast = currentToasts[currentToasts.length - 1];
+			const oldestId = oldestToast.getAttribute('data-kt-toast-id');
+			if (oldestId) {
+				KTToast.close(oldestId);
+			} else {
+				oldestToast.remove();
+			}
+		}
+
+		// Insert toast at the top
+		container.insertBefore(toast, container.firstChild);
+		KTToast.update(container);
+
+		// Play beep if requested
+		if (options.beep) {
+			try {
+				// Use Web Audio API for a short beep
+				const ctx = new (window.AudioContext ||
+					(window as any).webkitAudioContext)();
+				const o = ctx.createOscillator();
+				const g = ctx.createGain();
+				o.type = 'sine';
+				o.frequency.value = 880;
+				g.gain.value = 0.09;
+				o.connect(g);
+				g.connect(ctx.destination);
+				o.start();
+				setTimeout(() => {
+					o.stop();
+					ctx.close();
+				}, 120);
+			} catch (e) {
+				/* ignore */
+			}
+		}
+
+		KTToast._fireEventOnElement(toast, 'show', { id });
+		KTToast._dispatchEventOnElement(toast, 'show', { id });
+		const instance: KTToastInstance = { id, element: toast, timeoutId: 0 };
+		KTToast.toasts.set(id, instance);
+
+		// Auto-dismiss
+		let timeoutId: number | undefined = undefined;
+		let remaining = duration;
+		let startTime: number | undefined;
+		let paused = false;
+		let progressEl: HTMLElement | null = null;
+		if (duration) {
+			const startTimer = (ms: number) => {
+				startTime = Date.now();
+				timeoutId = window.setTimeout(() => {
+					options.onAutoClose?.(id);
+					KTToast.close(id);
+				}, ms);
+				instance.timeoutId = timeoutId;
+			};
+			startTimer(duration);
+
+			if (options.pauseOnHover) {
+				progressEl = toast.querySelector('[data-kt-toast-progress]');
+				let progressPausedAt = 0;
+				const pause = () => {
+					if (!paused && timeoutId) {
+						paused = true;
+						window.clearTimeout(timeoutId);
+						if (startTime) {
+							remaining -= Date.now() - startTime;
+						}
+						// Pause progress bar
+						if (progressEl) {
+							const computedStyle = window.getComputedStyle(progressEl);
+							const matrix = computedStyle.transform;
+							let scaleX = 1;
+							if (matrix && matrix !== 'none') {
+								const values = matrix.match(/matrix\(([^)]+)\)/);
+								if (values && values[1]) {
+									scaleX = parseFloat(values[1].split(',')[0]);
+								}
+							}
+							progressPausedAt = scaleX;
+							progressEl.style.animation = 'none';
+							progressEl.style.transition = 'none';
+							progressEl.style.transform = `scaleX(${scaleX})`;
+						}
+					}
+				};
+				const resume = () => {
+					if (paused && remaining > 0) {
+						paused = false;
+						startTimer(remaining);
+						// Resume progress bar
+						if (progressEl) {
+							progressEl.style.transition = 'transform 0ms';
+							progressEl.style.transform = `scaleX(${progressPausedAt})`;
+							progressEl.offsetHeight; // force reflow
+							progressEl.style.transition = `transform ${remaining}ms linear`;
+							progressEl.style.transform = 'scaleX(0)';
+						}
+					}
+				};
+				toast.addEventListener('mouseenter', pause);
+				toast.addEventListener('mouseleave', resume);
+			}
+		}
+
+		KTToast._fireEventOnElement(toast, 'shown', { id });
+		KTToast._dispatchEventOnElement(toast, 'shown', { id });
+
+		return {
+			...instance,
+			dismiss: () => KTToast.close(id),
+		};
+	}
+
+	/**
+	 * Close and remove all active toasts.
+	 */
+	static clearAll() {
+		for (const id of Array.from(this.toasts.keys())) {
+			console.log('clearAll:', id);
+			this.close(id);
+		}
+	}
+
+	/**
+	 * Close a toast by ID or instance.
+	 * @param idOrInstance Toast ID string or KTToastInstance.
+	 */
+	static close(idOrInstance?: string | KTToastInstance) {
+		let inst: (KTToastInstance & { _closing?: boolean }) | undefined;
+		let id: string | undefined;
+		if (!idOrInstance) return;
+		if (typeof idOrInstance === 'string') {
+			id = idOrInstance;
+			inst = this.toasts.get(id);
+		} else if (typeof idOrInstance === 'object' && idOrInstance.id) {
+			id = idOrInstance.id;
+			inst = idOrInstance as KTToastInstance & { _closing?: boolean };
+		}
+
+		if (!inst || !id) return;
+		if (inst._closing) return; // Prevent double-close
+		inst._closing = true;
+
+		clearTimeout(inst.timeoutId);
+
+		KTToast._fireEventOnElement(inst.element, 'hide', { id });
+		KTToast._dispatchEventOnElement(inst.element, 'hide', { id });
+		// Remove progress bar instantly if present
+		const progressEl = inst.element.querySelector('[data-kt-toast-progress]');
+		if (progressEl) progressEl.remove();
+		inst.element.style.animation = 'kt-toast-out 0.25s forwards';
+
+		setTimeout(() => {
+			const parent = inst?.element.parentElement as HTMLElement | null;
+			inst?.element.remove();
+			KTToast.toasts.delete(id!);
+			// Try to call onDismiss if available in the toast instance (if stored)
+			if (typeof (inst as any).options?.onDismiss === 'function') {
+				(inst as any).options.onDismiss(id);
+			}
+			KTToast._fireEventOnElement(inst.element, 'hidden', { id });
+			KTToast._dispatchEventOnElement(inst.element, 'hidden', { id });
+			// update toasts asynchronously after DOM update
+			setTimeout(() => {
+				KTToast.update(parent);
+			}, 0);
+		}, 250);
+	}
+
+	/**
+	 * Dispatches a custom 'kt.toast.{eventType}' event on the given element.
+	 * @param element The toast element.
+	 * @param eventType The event type (e.g. 'show', 'hide').
+	 * @param payload Optional event detail payload.
+	 */
+	private static _fireEventOnElement(
+		element: HTMLElement,
+		eventType: string,
+		payload?: object,
+	) {
+		const event = new CustomEvent(`kt.toast.${eventType}`, { detail: payload });
+		element.dispatchEvent(event);
+	}
+
+	/**
+	 * Dispatches a custom event (not namespaced) on the given element.
+	 * @param element The toast element.
+	 * @param eventType The event type.
+	 * @param payload Optional event detail payload.
+	 */
+	private static _dispatchEventOnElement(
+		element: HTMLElement,
+		eventType: string,
+		payload?: object,
+	) {
+		const event = new CustomEvent(eventType, { detail: payload });
+		element.dispatchEvent(event);
+	}
+
+	/**
+	 * Initialize toast system (placeholder for future use).
+	 */
+	public static init(): void {}
+}