@mohasinac/appkit 2.1.3 → 2.3.0

package/src/utils/array.helper.ts

@@ -1,73 +0,0 @@
-/**
- * Array Data Helpers
- *
- * Generic helpers for array data operations — no external dependencies.
- */
-
-export function groupBy<T>(array: T[], key: keyof T): Record<string, T[]> {
-  return array.reduce(
-    (result, item) => {
-      const groupKey = String(item[key]);
-      if (!result[groupKey]) {
-        result[groupKey] = [];
-      }
-      result[groupKey].push(item);
-      return result;
-    },
-    {} as Record<string, T[]>,
-  );
-}
-
-export function unique<T>(array: T[]): T[] {
-  return Array.from(new Set(array));
-}
-
-export function uniqueBy<T>(array: T[], key: keyof T): T[] {
-  const seen = new Set();
-  return array.filter((item) => {
-    const value = item[key];
-    if (seen.has(value)) return false;
-    seen.add(value);
-    return true;
-  });
-}
-
-export function sortBy<T>(
-  array: T[],
-  key: keyof T,
-  order: "asc" | "desc" = "asc",
-): T[] {
-  return [...array].sort((a, b) => {
-    const aVal = a[key];
-    const bVal = b[key];
-    if (aVal < bVal) return order === "asc" ? -1 : 1;
-    if (aVal > bVal) return order === "asc" ? 1 : -1;
-    return 0;
-  });
-}
-
-export function chunk<T>(array: T[], size: number): T[][] {
-  const chunks: T[][] = [];
-  for (let i = 0; i < array.length; i += size) {
-    chunks.push(array.slice(i, i + size));
-  }
-  return chunks;
-}
-
-export function paginate<T>(
-  array: T[],
-  page: number,
-  perPage: number,
-): {
-  data: T[];
-  total: number;
-  page: number;
-  perPage: number;
-  totalPages: number;
-} {
-  const total = array.length;
-  const totalPages = Math.ceil(total / perPage);
-  const start = (page - 1) * perPage;
-  const end = start + perPage;
-  return { data: array.slice(start, end), total, page, perPage, totalPages };
-}

package/src/utils/color.helper.ts

@@ -1,57 +0,0 @@
-/**
- * Color Helpers
- *
- * Pure utility functions for color manipulation and conversion.
- */
-
-/**
- * Converts a hexadecimal color to RGB values.
- *
- * @param hex - The hex color string (with or without '#')
- * @returns An object with r, g, b values, or null if invalid
- */
-export function hexToRgb(
-  hex: string,
-): { r: number; g: number; b: number } | null {
-  const result = /^#?([a-f\d]{2})([a-f\d]{2})([a-f\d]{2})$/i.exec(hex);
-  return result
-    ? {
-        r: parseInt(result[1], 16),
-        g: parseInt(result[2], 16),
-        b: parseInt(result[3], 16),
-      }
-    : null;
-}
-
-/**
- * Converts RGB values to a hexadecimal color string.
- *
- * @param r - Red value (0-255)
- * @param g - Green value (0-255)
- * @param b - Blue value (0-255)
- * @returns The hex color string with '#' prefix
- */
-export function rgbToHex(r: number, g: number, b: number): string {
-  return (
-    "#" +
-    [r, g, b]
-      .map((x) => {
-        const hex = x.toString(16);
-        return hex.length === 1 ? "0" + hex : hex;
-      })
-      .join("")
-  );
-}
-
-/**
- * Determines the best contrasting text color (black or white) for a given background.
- *
- * @param hex - The background hex color
- * @returns '#000000' for light backgrounds, '#ffffff' for dark backgrounds
- */
-export function getContrastColor(hex: string): "#000000" | "#ffffff" {
-  const rgb = hexToRgb(hex);
-  if (!rgb) return "#000000";
-  const luminance = (0.299 * rgb.r + 0.587 * rgb.g + 0.114 * rgb.b) / 255;
-  return luminance > 0.5 ? "#000000" : "#ffffff";
-}

package/src/utils/cookie.converter.ts

@@ -1,32 +0,0 @@
-/**
- * Cookie Utilities — client-side only (browser environment)
- */
-
-export function parseCookies(): Record<string, string> {
-  if (typeof document === "undefined") return {};
-  const result: Record<string, string> = {};
-  for (const cookie of document.cookie.split(";")) {
-    const [name, ...valueParts] = cookie.trim().split("=");
-    if (name) result[name.trim()] = decodeURIComponent(valueParts.join("="));
-  }
-  return result;
-}
-
-export function getCookie(name: string): string | null {
-  if (typeof document === "undefined") return null;
-  for (const cookie of document.cookie.split(";")) {
-    const [cookieName, ...valueParts] = cookie.trim().split("=");
-    if (cookieName?.trim() === name)
-      return decodeURIComponent(valueParts.join("="));
-  }
-  return null;
-}
-
-export function hasCookie(name: string): boolean {
-  return getCookie(name) !== null;
-}
-
-export function deleteCookie(name: string, path: string = "/"): void {
-  if (typeof document === "undefined") return;
-  document.cookie = `${name}=; expires=Thu, 01 Jan 1970 00:00:00 UTC; path=${path};`;
-}

package/src/utils/date.formatter.ts

@@ -1,228 +0,0 @@
-/**
- * Date Formatting Utilities
- */
-
-/**
- * Resolve any date-like value (Date, ISO string, number, or Firestore Timestamp JSON)
- * into a native Date object. Returns null for falsy or unparseable input.
- */
-export function resolveDate(value: unknown): Date | null {
-  if (!value) return null;
-  if (value instanceof Date) return value;
-  if (
-    typeof value === "object" &&
-    value !== null &&
-    "_seconds" in value &&
-    typeof (value as Record<string, unknown>)._seconds === "number"
-  ) {
-    return new Date((value as { _seconds: number })._seconds * 1000);
-  }
-  const d = new Date(value as string | number);
-  return Number.isNaN(d.getTime()) ? null : d;
-}
-
-export function formatDate(
-  date: Date | string | number | unknown,
-  format: "short" | "medium" | "long" | "full" = "medium",
-  locale: string = "en-IN",
-): string {
-  const dateObj = resolveDate(date);
-  if (!dateObj) return "";
-
-  const options: Intl.DateTimeFormatOptions = {};
-
-  switch (format) {
-    case "short":
-      options.year = "2-digit";
-      options.month = "numeric";
-      options.day = "numeric";
-      break;
-    case "medium":
-      options.year = "numeric";
-      options.month = "short";
-      options.day = "numeric";
-      break;
-    case "long":
-      options.year = "numeric";
-      options.month = "long";
-      options.day = "numeric";
-      break;
-    case "full":
-      options.year = "numeric";
-      options.month = "long";
-      options.day = "numeric";
-      options.weekday = "long";
-      break;
-  }
-
-  return dateObj.toLocaleDateString(locale, options);
-}
-
-export function formatDateTime(
-  date: Date | string | number | unknown,
-  format: "short" | "medium" | "long" | "full" = "medium",
-  locale: string = "en-IN",
-): string {
-  const dateObj = resolveDate(date);
-  if (!dateObj) return "";
-
-  const dateOptions: Intl.DateTimeFormatOptions = {};
-  const timeOptions: Intl.DateTimeFormatOptions = {};
-
-  switch (format) {
-    case "short":
-      dateOptions.year = "2-digit";
-      dateOptions.month = "2-digit";
-      dateOptions.day = "2-digit";
-      timeOptions.hour = "2-digit";
-      timeOptions.minute = "2-digit";
-      break;
-    case "medium":
-      dateOptions.year = "numeric";
-      dateOptions.month = "short";
-      dateOptions.day = "numeric";
-      timeOptions.hour = "2-digit";
-      timeOptions.minute = "2-digit";
-      break;
-    case "long":
-      dateOptions.year = "numeric";
-      dateOptions.month = "long";
-      dateOptions.day = "numeric";
-      timeOptions.hour = "2-digit";
-      timeOptions.minute = "2-digit";
-      timeOptions.second = "2-digit";
-      break;
-    case "full":
-      dateOptions.year = "numeric";
-      dateOptions.month = "long";
-      dateOptions.day = "numeric";
-      dateOptions.weekday = "long";
-      timeOptions.hour = "2-digit";
-      timeOptions.minute = "2-digit";
-      timeOptions.second = "2-digit";
-      break;
-  }
-
-  const datePart = dateObj.toLocaleDateString(locale, dateOptions);
-  const timePart = dateObj.toLocaleTimeString(locale, timeOptions);
-  return `${datePart}, ${timePart}`;
-}
-
-export function formatTime(
-  date: Date | string,
-  format: "short" | "long" = "long",
-  locale: string = "en-IN",
-): string {
-  const dateObj = typeof date === "string" ? new Date(date) : date;
-  const options: Intl.DateTimeFormatOptions =
-    format === "short"
-      ? { hour: "2-digit", minute: "2-digit" }
-      : { hour: "2-digit", minute: "2-digit", second: "2-digit" };
-  return dateObj.toLocaleTimeString(locale, options);
-}
-
-export function formatRelativeTime(date: Date | string): string {
-  const dateObj = typeof date === "string" ? new Date(date) : date;
-  const now = new Date();
-  const diffMs = now.getTime() - dateObj.getTime();
-  const diffSec = Math.floor(diffMs / 1000);
-  const diffMin = Math.floor(diffSec / 60);
-  const diffHour = Math.floor(diffMin / 60);
-  const diffDay = Math.floor(diffHour / 24);
-  const diffWeek = Math.floor(diffDay / 7);
-  const diffMonth = Math.floor(diffDay / 30);
-  const diffYear = Math.floor(diffDay / 365);
-
-  if (diffSec < 60) return "just now";
-  if (diffMin < 60) return `${diffMin} minute${diffMin > 1 ? "s" : ""} ago`;
-  if (diffHour < 24) return `${diffHour} hour${diffHour > 1 ? "s" : ""} ago`;
-  if (diffDay < 7) return `${diffDay} day${diffDay > 1 ? "s" : ""} ago`;
-  if (diffWeek < 4) return `${diffWeek} week${diffWeek > 1 ? "s" : ""} ago`;
-  if (diffMonth < 12)
-    return `${diffMonth} month${diffMonth > 1 ? "s" : ""} ago`;
-  return `${diffYear} year${diffYear > 1 ? "s" : ""} ago`;
-}
-
-export function formatMonthYear(
-  date: Date | string,
-  locale: string = "en-IN",
-): string {
-  const dateObj = typeof date === "string" ? new Date(date) : date;
-  return dateObj.toLocaleDateString(locale, { month: "long", year: "numeric" });
-}
-
-export function formatDateRange(
-  startDate: Date | string,
-  endDate: Date | string,
-  locale: string = "en-IN",
-): string {
-  const start = typeof startDate === "string" ? new Date(startDate) : startDate;
-  const end = typeof endDate === "string" ? new Date(endDate) : endDate;
-
-  const startFormatted = start.toLocaleDateString(locale, {
-    month: "short",
-    day: "numeric",
-    year: start.getFullYear() !== end.getFullYear() ? "numeric" : undefined,
-  });
-  const endFormatted = end.toLocaleDateString(locale, {
-    month: "short",
-    day: "numeric",
-    year: "numeric",
-  });
-  return `${startFormatted} - ${endFormatted}`;
-}
-
-export function isToday(date: Date | string): boolean {
-  const dateObj = typeof date === "string" ? new Date(date) : date;
-  const today = new Date();
-  return (
-    dateObj.getDate() === today.getDate() &&
-    dateObj.getMonth() === today.getMonth() &&
-    dateObj.getFullYear() === today.getFullYear()
-  );
-}
-
-export function isPast(date: Date | string): boolean {
-  const dateObj = typeof date === "string" ? new Date(date) : date;
-  return dateObj.getTime() < Date.now();
-}
-
-export function isFuture(date: Date | string): boolean {
-  const dateObj = typeof date === "string" ? new Date(date) : date;
-  return dateObj.getTime() > Date.now();
-}
-
-export function nowMs(): number {
-  return Date.now();
-}
-
-export function isSameMonth(a: Date | number, b: Date | number): boolean {
-  const da = new Date(a);
-  const db = new Date(b);
-  return (
-    da.getFullYear() === db.getFullYear() && da.getMonth() === db.getMonth()
-  );
-}
-
-export function currentYear(): string {
-  return new Date(nowMs()).getFullYear().toString();
-}
-
-export function nowISO(): string {
-  return new Date(nowMs()).toISOString();
-}
-
-export function formatCustomDate(
-  date: Date | string,
-  format: "short" | "medium" | "long" | "full" = "medium",
-): string {
-  const dateObj = typeof date === "string" ? new Date(date) : date;
-  const formatOptions: Record<string, Intl.DateTimeFormatOptions> = {
-    short: { month: "numeric", day: "numeric", year: "2-digit" },
-    medium: { month: "short", day: "numeric", year: "numeric" },
-    long: { month: "long", day: "numeric", year: "numeric" },
-    full: { weekday: "long", month: "long", day: "numeric", year: "numeric" },
-  };
-  const options = formatOptions[format] || formatOptions.medium;
-  return dateObj.toLocaleDateString("en-US", options);
-}

package/src/utils/event-manager.ts

@@ -1,168 +0,0 @@
-/**
- * Event Manager Utilities
- *
- * Centralized DOM event handler management, throttle/debounce,
- * and viewport / scroll / body-scroll utilities.
- */
-
-interface EventHandlerRecord {
-  type: string;
-  target: EventTarget;
-  callback: EventListener;
-  options?: AddEventListenerOptions;
-}
-
-export class GlobalEventManager {
-  private handlers: Map<string, EventHandlerRecord[]> = new Map();
-  private handlerIds: Map<string, number> = new Map();
-
-  private generateId(type: string, target: EventTarget): string {
-    const targetId = this.getTargetId(target);
-    const key = `${type}-${targetId}`;
-    const count = (this.handlerIds.get(key) ?? 0) + 1;
-    this.handlerIds.set(key, count);
-    return `${key}-${count}`;
-  }
-
-  private getTargetId(target: EventTarget): string {
-    if (target === window) return "window";
-    if (target === document) return "document";
-    if (target instanceof HTMLElement && target.id) return target.id;
-    return `element-${crypto.randomUUID()}`;
-  }
-
-  add(target: EventTarget, type: string, callback: EventListener, options?: AddEventListenerOptions): string {
-    const id = this.generateId(type, target);
-    if (!this.handlers.has(id)) this.handlers.set(id, []);
-    this.handlers.get(id)!.push({ type, target, callback, options });
-    target.addEventListener(type, callback, options);
-    return id;
-  }
-
-  remove(id: string): void {
-    const handlers = this.handlers.get(id);
-    if (!handlers) return;
-    handlers.forEach(({ type, target, callback, options }) => target.removeEventListener(type, callback, options));
-    this.handlers.delete(id);
-  }
-
-  removeAllForTarget(target: EventTarget, type?: string): void {
-    const toRemove: string[] = [];
-    this.handlers.forEach((handlers, id) => {
-      const matchesTarget = handlers.some((h) => h.target === target);
-      const matchesType = !type || handlers.some((h) => h.type === type);
-      if (matchesTarget && matchesType) toRemove.push(id);
-    });
-    toRemove.forEach((id) => this.remove(id));
-  }
-
-  clear(): void {
-    this.handlers.forEach((handlers) =>
-      handlers.forEach(({ type, target, callback, options }) => target.removeEventListener(type, callback, options))
-    );
-    this.handlers.clear();
-    this.handlerIds.clear();
-  }
-
-  getHandlerCount(): number { return this.handlers.size; }
-  has(id: string): boolean { return this.handlers.has(id); }
-}
-
-export const globalEventManager = new GlobalEventManager();
-
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
-export function throttle<T extends (...args: any[]) => any>(func: T, delay: number): (...args: Parameters<T>) => void {
-  let timeoutId: ReturnType<typeof setTimeout> | null = null;
-  let lastRun = 0;
-  return (...args: Parameters<T>): void => {
-    const now = Date.now();
-    if (now - lastRun >= delay) {
-      func(...args);
-      lastRun = now;
-    } else {
-      if (timeoutId) clearTimeout(timeoutId);
-      timeoutId = setTimeout(() => { func(...args); lastRun = Date.now(); }, delay - (now - lastRun));
-    }
-  };
-}
-
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
-export function debounce<T extends (...args: any[]) => any>(func: T, delay: number): (...args: Parameters<T>) => void {
-  let timeoutId: ReturnType<typeof setTimeout> | null = null;
-  return (...args: Parameters<T>): void => {
-    if (timeoutId) clearTimeout(timeoutId);
-    timeoutId = setTimeout(() => func(...args), delay);
-  };
-}
-
-export function addGlobalScrollHandler(callback: (event: Event) => void, options?: { throttle?: number; target?: EventTarget }): string {
-  const { throttle: throttleDelay = 100, target = window } = options ?? {};
-  const handler = throttleDelay > 0 ? throttle(callback, throttleDelay) : callback;
-  return globalEventManager.add(target, "scroll", handler as EventListener, { passive: true });
-}
-
-export function addGlobalResizeHandler(callback: (event: Event) => void, options?: { throttle?: number }): string {
-  const { throttle: throttleDelay = 200 } = options ?? {};
-  const handler = throttleDelay > 0 ? throttle(callback, throttleDelay) : callback;
-  return globalEventManager.add(window, "resize", handler as EventListener);
-}
-
-export function addGlobalClickHandler(selector: string, callback: (event: MouseEvent, element: Element) => void, options?: { preventDefault?: boolean }): string {
-  const handler = (event: Event) => {
-    const element = (event.target as Element).closest(selector);
-    if (element) {
-      if (options?.preventDefault) event.preventDefault();
-      callback(event as MouseEvent, element);
-    }
-  };
-  return globalEventManager.add(document, "click", handler as EventListener);
-}
-
-export function addGlobalKeyHandler(key: string | string[], callback: (event: KeyboardEvent) => void, options?: { preventDefault?: boolean; ctrl?: boolean; shift?: boolean; alt?: boolean; meta?: boolean }): string {
-  const keys = Array.isArray(key) ? key : [key];
-  const { preventDefault = false, ctrl = false, shift = false, alt = false, meta = false } = options ?? {};
-  const handler = (event: Event) => {
-    const e = event as KeyboardEvent;
-    if (!keys.some((k) => e.key === k || e.code === k)) return;
-    if (e.ctrlKey !== ctrl || e.shiftKey !== shift || e.altKey !== alt || e.metaKey !== meta) return;
-    if (preventDefault) event.preventDefault();
-    callback(e);
-  };
-  return globalEventManager.add(document, "keydown", handler as EventListener);
-}
-
-export function removeGlobalHandler(id: string): void { globalEventManager.remove(id); }
-export function isMobileDevice(): boolean {
-  if (typeof window === "undefined") return false;
-  return /Android|webOS|iPhone|iPad|iPod|BlackBerry|IEMobile|Opera Mini/i.test(navigator.userAgent);
-}
-export function hasTouchSupport(): boolean {
-  if (typeof window === "undefined") return false;
-  return "ontouchstart" in window || navigator.maxTouchPoints > 0;
-}
-export function getViewportDimensions(): { width: number; height: number } {
-  if (typeof window === "undefined") return { width: 0, height: 0 };
-  return { width: window.innerWidth || document.documentElement.clientWidth, height: window.innerHeight || document.documentElement.clientHeight };
-}
-export function isInViewport(element: HTMLElement, offset = 0): boolean {
-  if (typeof window === "undefined") return false;
-  const rect = element.getBoundingClientRect();
-  const { width, height } = getViewportDimensions();
-  return rect.top >= -offset && rect.left >= -offset && rect.bottom <= height + offset && rect.right <= width + offset;
-}
-export function smoothScrollTo(element: HTMLElement | string, options?: { offset?: number }): void {
-  const target = typeof element === "string" ? document.querySelector(element) : element;
-  if (!target) return;
-  const { offset = 0 } = options ?? {};
-  window.scrollTo({ top: (target as HTMLElement).getBoundingClientRect().top + window.pageYOffset - offset, behavior: "smooth" });
-}
-export function preventBodyScroll(prevent: boolean): void {
-  if (typeof document === "undefined") return;
-  if (prevent) {
-    document.body.style.overflow = "hidden";
-    document.body.style.paddingRight = `${window.innerWidth - document.documentElement.clientWidth}px`;
-  } else {
-    document.body.style.overflow = "";
-    document.body.style.paddingRight = "";
-  }
-}

package/src/utils/filter.helper.ts

@@ -1,24 +0,0 @@
-/**
- * Filter Helper
- *
- * Builds Sieve-compatible filter strings from conditional entries.
- *
- * @example
- * ```ts
- * buildSieveFilters(
- *   ["status==", statusFilter],
- *   ["totalPrice>=", minAmount],
- *   ["title@=*", searchTerm],
- * );
- * // → "status==pending,totalPrice>=100,title@=*shoes"
- * ```
- */
-
-type FilterEntry = [expression: string, value: string | undefined | null];
-
-export function buildSieveFilters(...entries: FilterEntry[]): string {
-  return entries
-    .filter((entry): entry is [string, string] => !!entry[1])
-    .map(([expr, value]) => `${expr}${value}`)
-    .join(",");
-}