@exyconn/common 2.1.0 → 2.3.3

package/dist/shared/utils/index.mjs

@@ -0,0 +1,324 @@
+import { parseISO, isValid, format, formatDistance, formatDistanceToNow, isToday, isYesterday, isTomorrow, isThisWeek, isThisYear, intervalToDuration, formatDuration, differenceInMinutes, addYears, addMonths, addWeeks, addDays, addHours, addMinutes, subYears, subMonths, subWeeks, subDays, subHours, subMinutes, differenceInYears, differenceInMonths, differenceInWeeks, differenceInDays, differenceInHours, differenceInSeconds, eachDayOfInterval, eachWeekOfInterval, eachMonthOfInterval, endOfDay, startOfDay, endOfWeek, startOfWeek, endOfMonth, startOfMonth, endOfYear, startOfYear, isAfter, isEqual, isBefore, getDay, setHours, setMinutes, setSeconds, getSeconds, getMinutes, getHours } from 'date-fns';
+export { addDays, addHours, addMinutes, addMonths, addWeeks, addYears, differenceInDays, differenceInHours, differenceInMinutes, differenceInMonths, differenceInSeconds, differenceInWeeks, differenceInYears, eachDayOfInterval, eachMonthOfInterval, eachWeekOfInterval, endOfDay, endOfMonth, endOfWeek, endOfYear, format, formatDistance, formatDistanceToNow, formatDuration, formatRelative, getDate, getDay, getHours, getMinutes, getMonth, getSeconds, getYear, intervalToDuration, isAfter, isBefore, isEqual, isFuture, isPast, isSameDay, isSameMonth, isSameWeek, isSameYear, isThisMonth, isThisWeek, isThisYear, isToday, isTomorrow, isValid, isYesterday, parseISO, setHours, setMinutes, setSeconds, startOfDay, startOfMonth, startOfWeek, startOfYear, subDays, subHours, subMinutes, subMonths, subWeeks, subYears } from 'date-fns';
+import { formatInTimeZone, toZonedTime, fromZonedTime } from 'date-fns-tz';
+export { formatInTimeZone, fromZonedTime, toZonedTime } from 'date-fns-tz';
+
+// src/shared/utils/date-time.ts
+var parseDate = (date) => {
+  if (date instanceof Date) return date;
+  if (typeof date === "string") return parseISO(date);
+  return new Date(date);
+};
+var isValidDate = (date) => {
+  const parsed = parseDate(date);
+  return isValid(parsed);
+};
+var DATE_FORMATS = {
+  // Date only
+  DATE_SHORT: "MM/dd/yyyy",
+  // 01/15/2026
+  DATE_MEDIUM: "MMM d, yyyy",
+  // Jan 15, 2026
+  DATE_LONG: "MMMM d, yyyy",
+  // January 15, 2026
+  DATE_FULL: "EEEE, MMMM d, yyyy",
+  // Friday, January 15, 2026
+  DATE_ISO: "yyyy-MM-dd",
+  // 2026-01-15
+  // Time only
+  TIME_SHORT: "h:mm a",
+  // 3:30 PM
+  TIME_MEDIUM: "h:mm:ss a",
+  // 3:30:45 PM
+  TIME_24H: "HH:mm",
+  // 15:30
+  TIME_24H_FULL: "HH:mm:ss",
+  // 15:30:45
+  // Date and time
+  DATETIME_SHORT: "MM/dd/yyyy h:mm a",
+  // 01/15/2026 3:30 PM
+  DATETIME_MEDIUM: "MMM d, yyyy h:mm a",
+  // Jan 15, 2026 3:30 PM
+  DATETIME_LONG: "MMMM d, yyyy h:mm a",
+  // January 15, 2026 3:30 PM
+  DATETIME_FULL: "EEEE, MMMM d, yyyy h:mm a",
+  // Friday, January 15, 2026 3:30 PM
+  DATETIME_ISO: "yyyy-MM-dd'T'HH:mm:ss",
+  // 2026-01-15T15:30:45
+  // Special formats
+  MONTH_YEAR: "MMMM yyyy",
+  // January 2026
+  MONTH_DAY: "MMM d",
+  // Jan 15
+  DAY_MONTH: "d MMM",
+  // 15 Jan
+  WEEKDAY: "EEEE",
+  // Friday
+  WEEKDAY_SHORT: "EEE"
+  // Fri
+};
+var formatDate = (date, formatStr = DATE_FORMATS.DATE_MEDIUM) => {
+  return format(parseDate(date), formatStr);
+};
+var formatDateTime = (date, formatStr = DATE_FORMATS.DATETIME_MEDIUM) => {
+  return format(parseDate(date), formatStr);
+};
+var formatDateInTimezone = (date, timezone, formatStr = DATE_FORMATS.DATETIME_MEDIUM) => {
+  return formatInTimeZone(parseDate(date), timezone, formatStr);
+};
+var formatRelativeTime = (date, baseDate) => {
+  const parsed = parseDate(date);
+  if (baseDate) {
+    return formatDistance(parsed, parseDate(baseDate), { addSuffix: true });
+  }
+  return formatDistanceToNow(parsed, { addSuffix: true });
+};
+var formatSmartDate = (date) => {
+  const parsed = parseDate(date);
+  if (isToday(parsed)) {
+    return `Today at ${format(parsed, DATE_FORMATS.TIME_SHORT)}`;
+  }
+  if (isYesterday(parsed)) {
+    return `Yesterday at ${format(parsed, DATE_FORMATS.TIME_SHORT)}`;
+  }
+  if (isTomorrow(parsed)) {
+    return `Tomorrow at ${format(parsed, DATE_FORMATS.TIME_SHORT)}`;
+  }
+  if (isThisWeek(parsed)) {
+    return format(parsed, "EEEE 'at' h:mm a");
+  }
+  if (isThisYear(parsed)) {
+    return format(parsed, "MMM d 'at' h:mm a");
+  }
+  return format(parsed, DATE_FORMATS.DATETIME_MEDIUM);
+};
+var formatDateRange = (start, end) => {
+  const duration = intervalToDuration({
+    start: parseDate(start),
+    end: parseDate(end)
+  });
+  return formatDuration(duration, {
+    format: ["years", "months", "days", "hours", "minutes"]
+  });
+};
+var toTimezone = (date, timezone) => {
+  return toZonedTime(parseDate(date), timezone);
+};
+var fromTimezone = (date, timezone) => {
+  return fromZonedTime(parseDate(date), timezone);
+};
+var nowInTimezone = (timezone) => {
+  return toZonedTime(/* @__PURE__ */ new Date(), timezone);
+};
+var getTimezoneDifference = (timezone1, timezone2) => {
+  const now = /* @__PURE__ */ new Date();
+  const time1 = toZonedTime(now, timezone1);
+  const time2 = toZonedTime(now, timezone2);
+  const diffMinutes = differenceInMinutes(time1, time2);
+  const hours = Math.floor(Math.abs(diffMinutes) / 60);
+  const minutes = Math.abs(diffMinutes) % 60;
+  const sign = diffMinutes >= 0 ? "+" : "-";
+  if (minutes === 0) {
+    return `${sign}${hours}h`;
+  }
+  return `${sign}${hours}h ${minutes}m`;
+};
+var addTime = (date, amount, unit) => {
+  const parsed = parseDate(date);
+  switch (unit) {
+    case "minutes":
+      return addMinutes(parsed, amount);
+    case "hours":
+      return addHours(parsed, amount);
+    case "days":
+      return addDays(parsed, amount);
+    case "weeks":
+      return addWeeks(parsed, amount);
+    case "months":
+      return addMonths(parsed, amount);
+    case "years":
+      return addYears(parsed, amount);
+  }
+};
+var subtractTime = (date, amount, unit) => {
+  const parsed = parseDate(date);
+  switch (unit) {
+    case "minutes":
+      return subMinutes(parsed, amount);
+    case "hours":
+      return subHours(parsed, amount);
+    case "days":
+      return subDays(parsed, amount);
+    case "weeks":
+      return subWeeks(parsed, amount);
+    case "months":
+      return subMonths(parsed, amount);
+    case "years":
+      return subYears(parsed, amount);
+  }
+};
+var getDateDifference = (date1, date2, unit) => {
+  const d1 = parseDate(date1);
+  const d2 = parseDate(date2);
+  switch (unit) {
+    case "seconds":
+      return differenceInSeconds(d1, d2);
+    case "minutes":
+      return differenceInMinutes(d1, d2);
+    case "hours":
+      return differenceInHours(d1, d2);
+    case "days":
+      return differenceInDays(d1, d2);
+    case "weeks":
+      return differenceInWeeks(d1, d2);
+    case "months":
+      return differenceInMonths(d1, d2);
+    case "years":
+      return differenceInYears(d1, d2);
+  }
+};
+var getDaysInRange = (start, end) => {
+  return eachDayOfInterval({
+    start: parseDate(start),
+    end: parseDate(end)
+  });
+};
+var getWeeksInRange = (start, end) => {
+  return eachWeekOfInterval({
+    start: parseDate(start),
+    end: parseDate(end)
+  });
+};
+var getMonthsInRange = (start, end) => {
+  return eachMonthOfInterval({
+    start: parseDate(start),
+    end: parseDate(end)
+  });
+};
+var getDayBoundaries = (date) => {
+  const parsed = parseDate(date);
+  return {
+    start: startOfDay(parsed),
+    end: endOfDay(parsed)
+  };
+};
+var getWeekBoundaries = (date, weekStartsOn = 0) => {
+  const parsed = parseDate(date);
+  return {
+    start: startOfWeek(parsed, { weekStartsOn }),
+    end: endOfWeek(parsed, { weekStartsOn })
+  };
+};
+var getMonthBoundaries = (date) => {
+  const parsed = parseDate(date);
+  return {
+    start: startOfMonth(parsed),
+    end: endOfMonth(parsed)
+  };
+};
+var getYearBoundaries = (date) => {
+  const parsed = parseDate(date);
+  return {
+    start: startOfYear(parsed),
+    end: endOfYear(parsed)
+  };
+};
+var isDateBetween = (date, start, end) => {
+  const d = parseDate(date);
+  const s = parseDate(start);
+  const e = parseDate(end);
+  return (isAfter(d, s) || isEqual(d, s)) && (isBefore(d, e) || isEqual(d, e));
+};
+var doDateRangesOverlap = (range1Start, range1End, range2Start, range2End) => {
+  const r1s = parseDate(range1Start);
+  const r1e = parseDate(range1End);
+  const r2s = parseDate(range2Start);
+  const r2e = parseDate(range2End);
+  return isBefore(r1s, r2e) && isAfter(r1e, r2s);
+};
+var getAge = (birthDate) => {
+  return differenceInYears(/* @__PURE__ */ new Date(), parseDate(birthDate));
+};
+var isWeekend = (date) => {
+  const day = getDay(parseDate(date));
+  return day === 0 || day === 6;
+};
+var isWeekday = (date) => {
+  return !isWeekend(date);
+};
+var daysUntil = (date) => {
+  return differenceInDays(parseDate(date), /* @__PURE__ */ new Date());
+};
+var daysSince = (date) => {
+  return differenceInDays(/* @__PURE__ */ new Date(), parseDate(date));
+};
+var toDateInputValue = (date) => {
+  return format(parseDate(date), DATE_FORMATS.DATE_ISO);
+};
+var toDateTimeInputValue = (date) => {
+  return format(parseDate(date), "yyyy-MM-dd'T'HH:mm");
+};
+var toTimeInputValue = (date) => {
+  return format(parseDate(date), DATE_FORMATS.TIME_24H);
+};
+var setTime = (date, hours, minutes, seconds = 0) => {
+  let result = parseDate(date);
+  result = setHours(result, hours);
+  result = setMinutes(result, minutes);
+  result = setSeconds(result, seconds);
+  return result;
+};
+var combineDateAndTime = (dateInput, timeInput) => {
+  const date = parseDate(dateInput);
+  const time = parseDate(timeInput);
+  return setTime(date, getHours(time), getMinutes(time), getSeconds(time));
+};
+var date_time_default = {
+  // Core
+  parseDate,
+  isValidDate,
+  DATE_FORMATS,
+  // Format
+  formatDate,
+  formatDateTime,
+  formatDateInTimezone,
+  formatRelativeTime,
+  formatSmartDate,
+  formatDateRange,
+  // Timezone
+  toTimezone,
+  fromTimezone,
+  nowInTimezone,
+  getTimezoneDifference,
+  // Arithmetic
+  addTime,
+  subtractTime,
+  getDateDifference,
+  // Ranges
+  getDaysInRange,
+  getWeeksInRange,
+  getMonthsInRange,
+  // Boundaries
+  getDayBoundaries,
+  getWeekBoundaries,
+  getMonthBoundaries,
+  getYearBoundaries,
+  // Comparison
+  isDateBetween,
+  doDateRangesOverlap,
+  // Utilities
+  getAge,
+  isWeekend,
+  isWeekday,
+  daysUntil,
+  daysSince,
+  toDateInputValue,
+  toDateTimeInputValue,
+  toTimeInputValue,
+  setTime,
+  combineDateAndTime
+};
+
+export { DATE_FORMATS, addTime, combineDateAndTime, date_time_default as dateTime, daysSince, daysUntil, doDateRangesOverlap, formatDate, formatDateInTimezone, formatDateRange, formatDateTime, formatRelativeTime, formatSmartDate, fromTimezone, getAge, getDateDifference, getDayBoundaries, getDaysInRange, getMonthBoundaries, getMonthsInRange, getTimezoneDifference, getWeekBoundaries, getWeeksInRange, getYearBoundaries, isDateBetween, isValidDate, isWeekday, isWeekend, nowInTimezone, parseDate, setTime, subtractTime, toDateInputValue, toDateTimeInputValue, toTimeInputValue, toTimezone };
+//# sourceMappingURL=index.mjs.map
+//# sourceMappingURL=index.mjs.map

package/dist/shared/utils/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/shared/utils/date-time.ts"],"names":[],"mappings":"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","file":"index.mjs","sourcesContent":["/**\r\n * Enhanced Date/Time utilities using date-fns with timezone support\r\n * Deep level date handling for all common operations\r\n */\r\nimport {\r\n  format,\r\n  formatDistance,\r\n  formatDistanceToNow,\r\n  formatRelative,\r\n  isToday,\r\n  isYesterday,\r\n  isTomorrow,\r\n  isThisWeek,\r\n  isThisMonth,\r\n  isThisYear,\r\n  isPast,\r\n  isFuture,\r\n  isValid,\r\n  parseISO,\r\n  addDays,\r\n  addWeeks,\r\n  addMonths,\r\n  addYears,\r\n  addHours,\r\n  addMinutes,\r\n  subDays,\r\n  subWeeks,\r\n  subMonths,\r\n  subYears,\r\n  subHours,\r\n  subMinutes,\r\n  startOfDay,\r\n  endOfDay,\r\n  startOfWeek,\r\n  endOfWeek,\r\n  startOfMonth,\r\n  endOfMonth,\r\n  startOfYear,\r\n  endOfYear,\r\n  differenceInDays,\r\n  differenceInWeeks,\r\n  differenceInMonths,\r\n  differenceInYears,\r\n  differenceInHours,\r\n  differenceInMinutes,\r\n  differenceInSeconds,\r\n  isBefore,\r\n  isAfter,\r\n  isEqual,\r\n  isSameDay,\r\n  isSameWeek,\r\n  isSameMonth,\r\n  isSameYear,\r\n  getDay,\r\n  getDate,\r\n  getMonth,\r\n  getYear,\r\n  getHours,\r\n  getMinutes,\r\n  getSeconds,\r\n  setHours,\r\n  setMinutes,\r\n  setSeconds,\r\n  eachDayOfInterval,\r\n  eachWeekOfInterval,\r\n  eachMonthOfInterval,\r\n  intervalToDuration,\r\n  formatDuration,\r\n} from 'date-fns';\r\n\r\nimport { formatInTimeZone, toZonedTime, fromZonedTime } from 'date-fns-tz';\r\n\r\n// Re-export all date-fns functions for convenience\r\nexport {\r\n  format,\r\n  formatDistance,\r\n  formatDistanceToNow,\r\n  formatRelative,\r\n  isToday,\r\n  isYesterday,\r\n  isTomorrow,\r\n  isThisWeek,\r\n  isThisMonth,\r\n  isThisYear,\r\n  isPast,\r\n  isFuture,\r\n  isValid,\r\n  parseISO,\r\n  addDays,\r\n  addWeeks,\r\n  addMonths,\r\n  addYears,\r\n  addHours,\r\n  addMinutes,\r\n  subDays,\r\n  subWeeks,\r\n  subMonths,\r\n  subYears,\r\n  subHours,\r\n  subMinutes,\r\n  startOfDay,\r\n  endOfDay,\r\n  startOfWeek,\r\n  endOfWeek,\r\n  startOfMonth,\r\n  endOfMonth,\r\n  startOfYear,\r\n  endOfYear,\r\n  differenceInDays,\r\n  differenceInWeeks,\r\n  differenceInMonths,\r\n  differenceInYears,\r\n  differenceInHours,\r\n  differenceInMinutes,\r\n  differenceInSeconds,\r\n  isBefore,\r\n  isAfter,\r\n  isEqual,\r\n  isSameDay,\r\n  isSameWeek,\r\n  isSameMonth,\r\n  isSameYear,\r\n  getDay,\r\n  getDate,\r\n  getMonth,\r\n  getYear,\r\n  getHours,\r\n  getMinutes,\r\n  getSeconds,\r\n  setHours,\r\n  setMinutes,\r\n  setSeconds,\r\n  eachDayOfInterval,\r\n  eachWeekOfInterval,\r\n  eachMonthOfInterval,\r\n  intervalToDuration,\r\n  formatDuration,\r\n  formatInTimeZone,\r\n  toZonedTime,\r\n  fromZonedTime,\r\n};\r\n\r\n/**\r\n * Date input type - accepts Date, string (ISO), or timestamp\r\n */\r\nexport type DateInput = Date | string | number;\r\n\r\n/**\r\n * Parse any date input to Date object\r\n */\r\nexport const parseDate = (date: DateInput): Date => {\r\n  if (date instanceof Date) return date;\r\n  if (typeof date === 'string') return parseISO(date);\r\n  return new Date(date);\r\n};\r\n\r\n/**\r\n * Check if date input is valid\r\n */\r\nexport const isValidDate = (date: DateInput): boolean => {\r\n  const parsed = parseDate(date);\r\n  return isValid(parsed);\r\n};\r\n\r\n// ==========================================\r\n// FORMAT FUNCTIONS\r\n// ==========================================\r\n\r\n/**\r\n * Format presets for common date formats\r\n */\r\nexport const DATE_FORMATS = {\r\n  // Date only\r\n  DATE_SHORT: 'MM/dd/yyyy', // 01/15/2026\r\n  DATE_MEDIUM: 'MMM d, yyyy', // Jan 15, 2026\r\n  DATE_LONG: 'MMMM d, yyyy', // January 15, 2026\r\n  DATE_FULL: 'EEEE, MMMM d, yyyy', // Friday, January 15, 2026\r\n  DATE_ISO: 'yyyy-MM-dd', // 2026-01-15\r\n\r\n  // Time only\r\n  TIME_SHORT: 'h:mm a', // 3:30 PM\r\n  TIME_MEDIUM: 'h:mm:ss a', // 3:30:45 PM\r\n  TIME_24H: 'HH:mm', // 15:30\r\n  TIME_24H_FULL: 'HH:mm:ss', // 15:30:45\r\n\r\n  // Date and time\r\n  DATETIME_SHORT: 'MM/dd/yyyy h:mm a', // 01/15/2026 3:30 PM\r\n  DATETIME_MEDIUM: 'MMM d, yyyy h:mm a', // Jan 15, 2026 3:30 PM\r\n  DATETIME_LONG: 'MMMM d, yyyy h:mm a', // January 15, 2026 3:30 PM\r\n  DATETIME_FULL: 'EEEE, MMMM d, yyyy h:mm a', // Friday, January 15, 2026 3:30 PM\r\n  DATETIME_ISO: \"yyyy-MM-dd'T'HH:mm:ss\", // 2026-01-15T15:30:45\r\n\r\n  // Special formats\r\n  MONTH_YEAR: 'MMMM yyyy', // January 2026\r\n  MONTH_DAY: 'MMM d', // Jan 15\r\n  DAY_MONTH: 'd MMM', // 15 Jan\r\n  WEEKDAY: 'EEEE', // Friday\r\n  WEEKDAY_SHORT: 'EEE', // Fri\r\n} as const;\r\n\r\n/**\r\n * Format date with preset or custom format\r\n */\r\nexport const formatDate = (date: DateInput, formatStr: string = DATE_FORMATS.DATE_MEDIUM): string => {\r\n  return format(parseDate(date), formatStr);\r\n};\r\n\r\n/**\r\n * Format date with time\r\n */\r\nexport const formatDateTime = (date: DateInput, formatStr: string = DATE_FORMATS.DATETIME_MEDIUM): string => {\r\n  return format(parseDate(date), formatStr);\r\n};\r\n\r\n/**\r\n * Format date in a specific timezone\r\n */\r\nexport const formatDateInTimezone = (\r\n  date: DateInput,\r\n  timezone: string,\r\n  formatStr: string = DATE_FORMATS.DATETIME_MEDIUM\r\n): string => {\r\n  return formatInTimeZone(parseDate(date), timezone, formatStr);\r\n};\r\n\r\n/**\r\n * Format date as relative time (e.g., \"2 hours ago\", \"in 3 days\")\r\n */\r\nexport const formatRelativeTime = (date: DateInput, baseDate?: DateInput): string => {\r\n  const parsed = parseDate(date);\r\n  if (baseDate) {\r\n    return formatDistance(parsed, parseDate(baseDate), { addSuffix: true });\r\n  }\r\n  return formatDistanceToNow(parsed, { addSuffix: true });\r\n};\r\n\r\n/**\r\n * Format date as smart relative (Today at 3:30 PM, Yesterday, etc.)\r\n */\r\nexport const formatSmartDate = (date: DateInput): string => {\r\n  const parsed = parseDate(date);\r\n\r\n  if (isToday(parsed)) {\r\n    return `Today at ${format(parsed, DATE_FORMATS.TIME_SHORT)}`;\r\n  }\r\n  if (isYesterday(parsed)) {\r\n    return `Yesterday at ${format(parsed, DATE_FORMATS.TIME_SHORT)}`;\r\n  }\r\n  if (isTomorrow(parsed)) {\r\n    return `Tomorrow at ${format(parsed, DATE_FORMATS.TIME_SHORT)}`;\r\n  }\r\n  if (isThisWeek(parsed)) {\r\n    return format(parsed, 'EEEE \\'at\\' h:mm a'); // Friday at 3:30 PM\r\n  }\r\n  if (isThisYear(parsed)) {\r\n    return format(parsed, 'MMM d \\'at\\' h:mm a'); // Jan 15 at 3:30 PM\r\n  }\r\n  return format(parsed, DATE_FORMATS.DATETIME_MEDIUM);\r\n};\r\n\r\n/**\r\n * Format duration between two dates in human readable form\r\n */\r\nexport const formatDateRange = (start: DateInput, end: DateInput): string => {\r\n  const duration = intervalToDuration({\r\n    start: parseDate(start),\r\n    end: parseDate(end),\r\n  });\r\n\r\n  return formatDuration(duration, {\r\n    format: ['years', 'months', 'days', 'hours', 'minutes'],\r\n  });\r\n};\r\n\r\n// ==========================================\r\n// TIMEZONE FUNCTIONS\r\n// ==========================================\r\n\r\n/**\r\n * Convert date to a specific timezone\r\n */\r\nexport const toTimezone = (date: DateInput, timezone: string): Date => {\r\n  return toZonedTime(parseDate(date), timezone);\r\n};\r\n\r\n/**\r\n * Convert date from a specific timezone to UTC\r\n */\r\nexport const fromTimezone = (date: DateInput, timezone: string): Date => {\r\n  return fromZonedTime(parseDate(date), timezone);\r\n};\r\n\r\n/**\r\n * Get current time in a specific timezone\r\n */\r\nexport const nowInTimezone = (timezone: string): Date => {\r\n  return toZonedTime(new Date(), timezone);\r\n};\r\n\r\n/**\r\n * Format time difference between timezones\r\n */\r\nexport const getTimezoneDifference = (timezone1: string, timezone2: string): string => {\r\n  const now = new Date();\r\n  const time1 = toZonedTime(now, timezone1);\r\n  const time2 = toZonedTime(now, timezone2);\r\n  const diffMinutes = differenceInMinutes(time1, time2);\r\n  const hours = Math.floor(Math.abs(diffMinutes) / 60);\r\n  const minutes = Math.abs(diffMinutes) % 60;\r\n  const sign = diffMinutes >= 0 ? '+' : '-';\r\n\r\n  if (minutes === 0) {\r\n    return `${sign}${hours}h`;\r\n  }\r\n  return `${sign}${hours}h ${minutes}m`;\r\n};\r\n\r\n// ==========================================\r\n// DATE ARITHMETIC\r\n// ==========================================\r\n\r\n/**\r\n * Add time to a date\r\n */\r\nexport const addTime = (\r\n  date: DateInput,\r\n  amount: number,\r\n  unit: 'minutes' | 'hours' | 'days' | 'weeks' | 'months' | 'years'\r\n): Date => {\r\n  const parsed = parseDate(date);\r\n  switch (unit) {\r\n    case 'minutes':\r\n      return addMinutes(parsed, amount);\r\n    case 'hours':\r\n      return addHours(parsed, amount);\r\n    case 'days':\r\n      return addDays(parsed, amount);\r\n    case 'weeks':\r\n      return addWeeks(parsed, amount);\r\n    case 'months':\r\n      return addMonths(parsed, amount);\r\n    case 'years':\r\n      return addYears(parsed, amount);\r\n  }\r\n};\r\n\r\n/**\r\n * Subtract time from a date\r\n */\r\nexport const subtractTime = (\r\n  date: DateInput,\r\n  amount: number,\r\n  unit: 'minutes' | 'hours' | 'days' | 'weeks' | 'months' | 'years'\r\n): Date => {\r\n  const parsed = parseDate(date);\r\n  switch (unit) {\r\n    case 'minutes':\r\n      return subMinutes(parsed, amount);\r\n    case 'hours':\r\n      return subHours(parsed, amount);\r\n    case 'days':\r\n      return subDays(parsed, amount);\r\n    case 'weeks':\r\n      return subWeeks(parsed, amount);\r\n    case 'months':\r\n      return subMonths(parsed, amount);\r\n    case 'years':\r\n      return subYears(parsed, amount);\r\n  }\r\n};\r\n\r\n/**\r\n * Get difference between two dates\r\n */\r\nexport const getDateDifference = (\r\n  date1: DateInput,\r\n  date2: DateInput,\r\n  unit: 'seconds' | 'minutes' | 'hours' | 'days' | 'weeks' | 'months' | 'years'\r\n): number => {\r\n  const d1 = parseDate(date1);\r\n  const d2 = parseDate(date2);\r\n  switch (unit) {\r\n    case 'seconds':\r\n      return differenceInSeconds(d1, d2);\r\n    case 'minutes':\r\n      return differenceInMinutes(d1, d2);\r\n    case 'hours':\r\n      return differenceInHours(d1, d2);\r\n    case 'days':\r\n      return differenceInDays(d1, d2);\r\n    case 'weeks':\r\n      return differenceInWeeks(d1, d2);\r\n    case 'months':\r\n      return differenceInMonths(d1, d2);\r\n    case 'years':\r\n      return differenceInYears(d1, d2);\r\n  }\r\n};\r\n\r\n// ==========================================\r\n// DATE RANGE FUNCTIONS\r\n// ==========================================\r\n\r\n/**\r\n * Get all days in a range\r\n */\r\nexport const getDaysInRange = (start: DateInput, end: DateInput): Date[] => {\r\n  return eachDayOfInterval({\r\n    start: parseDate(start),\r\n    end: parseDate(end),\r\n  });\r\n};\r\n\r\n/**\r\n * Get all weeks in a range\r\n */\r\nexport const getWeeksInRange = (start: DateInput, end: DateInput): Date[] => {\r\n  return eachWeekOfInterval({\r\n    start: parseDate(start),\r\n    end: parseDate(end),\r\n  });\r\n};\r\n\r\n/**\r\n * Get all months in a range\r\n */\r\nexport const getMonthsInRange = (start: DateInput, end: DateInput): Date[] => {\r\n  return eachMonthOfInterval({\r\n    start: parseDate(start),\r\n    end: parseDate(end),\r\n  });\r\n};\r\n\r\n// ==========================================\r\n// DATE BOUNDARIES\r\n// ==========================================\r\n\r\n/**\r\n * Get start and end of day\r\n */\r\nexport const getDayBoundaries = (date: DateInput): { start: Date; end: Date } => {\r\n  const parsed = parseDate(date);\r\n  return {\r\n    start: startOfDay(parsed),\r\n    end: endOfDay(parsed),\r\n  };\r\n};\r\n\r\n/**\r\n * Get start and end of week\r\n */\r\nexport const getWeekBoundaries = (date: DateInput, weekStartsOn: 0 | 1 = 0): { start: Date; end: Date } => {\r\n  const parsed = parseDate(date);\r\n  return {\r\n    start: startOfWeek(parsed, { weekStartsOn }),\r\n    end: endOfWeek(parsed, { weekStartsOn }),\r\n  };\r\n};\r\n\r\n/**\r\n * Get start and end of month\r\n */\r\nexport const getMonthBoundaries = (date: DateInput): { start: Date; end: Date } => {\r\n  const parsed = parseDate(date);\r\n  return {\r\n    start: startOfMonth(parsed),\r\n    end: endOfMonth(parsed),\r\n  };\r\n};\r\n\r\n/**\r\n * Get start and end of year\r\n */\r\nexport const getYearBoundaries = (date: DateInput): { start: Date; end: Date } => {\r\n  const parsed = parseDate(date);\r\n  return {\r\n    start: startOfYear(parsed),\r\n    end: endOfYear(parsed),\r\n  };\r\n};\r\n\r\n// ==========================================\r\n// DATE COMPARISON\r\n// ==========================================\r\n\r\n/**\r\n * Check if date is between two dates (inclusive)\r\n */\r\nexport const isDateBetween = (date: DateInput, start: DateInput, end: DateInput): boolean => {\r\n  const d = parseDate(date);\r\n  const s = parseDate(start);\r\n  const e = parseDate(end);\r\n  return (isAfter(d, s) || isEqual(d, s)) && (isBefore(d, e) || isEqual(d, e));\r\n};\r\n\r\n/**\r\n * Check if two date ranges overlap\r\n */\r\nexport const doDateRangesOverlap = (\r\n  range1Start: DateInput,\r\n  range1End: DateInput,\r\n  range2Start: DateInput,\r\n  range2End: DateInput\r\n): boolean => {\r\n  const r1s = parseDate(range1Start);\r\n  const r1e = parseDate(range1End);\r\n  const r2s = parseDate(range2Start);\r\n  const r2e = parseDate(range2End);\r\n\r\n  return isBefore(r1s, r2e) && isAfter(r1e, r2s);\r\n};\r\n\r\n// ==========================================\r\n// UTILITY FUNCTIONS\r\n// ==========================================\r\n\r\n/**\r\n * Get age from birthdate\r\n */\r\nexport const getAge = (birthDate: DateInput): number => {\r\n  return differenceInYears(new Date(), parseDate(birthDate));\r\n};\r\n\r\n/**\r\n * Check if date is a weekend\r\n */\r\nexport const isWeekend = (date: DateInput): boolean => {\r\n  const day = getDay(parseDate(date));\r\n  return day === 0 || day === 6;\r\n};\r\n\r\n/**\r\n * Check if date is a weekday\r\n */\r\nexport const isWeekday = (date: DateInput): boolean => {\r\n  return !isWeekend(date);\r\n};\r\n\r\n/**\r\n * Get days until a date\r\n */\r\nexport const daysUntil = (date: DateInput): number => {\r\n  return differenceInDays(parseDate(date), new Date());\r\n};\r\n\r\n/**\r\n * Get days since a date\r\n */\r\nexport const daysSince = (date: DateInput): number => {\r\n  return differenceInDays(new Date(), parseDate(date));\r\n};\r\n\r\n/**\r\n * Format for HTML date input (yyyy-MM-dd)\r\n */\r\nexport const toDateInputValue = (date: DateInput): string => {\r\n  return format(parseDate(date), DATE_FORMATS.DATE_ISO);\r\n};\r\n\r\n/**\r\n * Format for HTML datetime-local input\r\n */\r\nexport const toDateTimeInputValue = (date: DateInput): string => {\r\n  return format(parseDate(date), \"yyyy-MM-dd'T'HH:mm\");\r\n};\r\n\r\n/**\r\n * Format for HTML time input (HH:mm)\r\n */\r\nexport const toTimeInputValue = (date: DateInput): string => {\r\n  return format(parseDate(date), DATE_FORMATS.TIME_24H);\r\n};\r\n\r\n/**\r\n * Set time on a date\r\n */\r\nexport const setTime = (date: DateInput, hours: number, minutes: number, seconds: number = 0): Date => {\r\n  let result = parseDate(date);\r\n  result = setHours(result, hours);\r\n  result = setMinutes(result, minutes);\r\n  result = setSeconds(result, seconds);\r\n  return result;\r\n};\r\n\r\n/**\r\n * Combine date from one input and time from another\r\n */\r\nexport const combineDateAndTime = (dateInput: DateInput, timeInput: DateInput): Date => {\r\n  const date = parseDate(dateInput);\r\n  const time = parseDate(timeInput);\r\n  return setTime(date, getHours(time), getMinutes(time), getSeconds(time));\r\n};\r\n\r\nexport default {\r\n  // Core\r\n  parseDate,\r\n  isValidDate,\r\n  DATE_FORMATS,\r\n\r\n  // Format\r\n  formatDate,\r\n  formatDateTime,\r\n  formatDateInTimezone,\r\n  formatRelativeTime,\r\n  formatSmartDate,\r\n  formatDateRange,\r\n\r\n  // Timezone\r\n  toTimezone,\r\n  fromTimezone,\r\n  nowInTimezone,\r\n  getTimezoneDifference,\r\n\r\n  // Arithmetic\r\n  addTime,\r\n  subtractTime,\r\n  getDateDifference,\r\n\r\n  // Ranges\r\n  getDaysInRange,\r\n  getWeeksInRange,\r\n  getMonthsInRange,\r\n\r\n  // Boundaries\r\n  getDayBoundaries,\r\n  getWeekBoundaries,\r\n  getMonthBoundaries,\r\n  getYearBoundaries,\r\n\r\n  // Comparison\r\n  isDateBetween,\r\n  doDateRangesOverlap,\r\n\r\n  // Utilities\r\n  getAge,\r\n  isWeekend,\r\n  isWeekday,\r\n  daysUntil,\r\n  daysSince,\r\n  toDateInputValue,\r\n  toDateTimeInputValue,\r\n  toTimeInputValue,\r\n  setTime,\r\n  combineDateAndTime,\r\n};\r\n"]}

package/dist/shared/validation/index.d.mts

@@ -0,0 +1,258 @@
+/**
+ * Common Validation Rules & Patterns
+ * Use with Yup, Zod, or custom validators
+ */
+declare const VALIDATION_PATTERNS: {
+    /** Email pattern (RFC 5322 simplified) */
+    readonly EMAIL: RegExp;
+    /** Strong password: min 8 chars, uppercase, lowercase, number, special char */
+    readonly PASSWORD_STRONG: RegExp;
+    /** Medium password: min 8 chars, uppercase, lowercase, number */
+    readonly PASSWORD_MEDIUM: RegExp;
+    /** Basic password: min 8 chars */
+    readonly PASSWORD_BASIC: RegExp;
+    /** Phone number (international) */
+    readonly PHONE_INTERNATIONAL: RegExp;
+    /** Phone number (US) */
+    readonly PHONE_US: RegExp;
+    /** Phone number (India) */
+    readonly PHONE_INDIA: RegExp;
+    /** URL pattern */
+    readonly URL: RegExp;
+    /** URL with required protocol */
+    readonly URL_STRICT: RegExp;
+    /** Alphanumeric only */
+    readonly ALPHANUMERIC: RegExp;
+    /** Letters only */
+    readonly LETTERS_ONLY: RegExp;
+    /** Numbers only */
+    readonly NUMBERS_ONLY: RegExp;
+    /** Slug pattern (kebab-case) */
+    readonly SLUG: RegExp;
+    /** Username pattern (alphanumeric, underscore, hyphen) */
+    readonly USERNAME: RegExp;
+    /** Credit card (basic validation) */
+    readonly CREDIT_CARD: RegExp;
+    /** CVV (3 or 4 digits) */
+    readonly CVV: RegExp;
+    /** ZIP code (US) */
+    readonly ZIP_US: RegExp;
+    /** Postal code (India) */
+    readonly POSTAL_INDIA: RegExp;
+    /** IP Address (IPv4) */
+    readonly IPV4: RegExp;
+    /** Hex color */
+    readonly HEX_COLOR: RegExp;
+    /** Date (YYYY-MM-DD) */
+    readonly DATE_ISO: RegExp;
+    /** Time (HH:MM or HH:MM:SS) */
+    readonly TIME: RegExp;
+};
+/**
+ * Validate email format
+ */
+declare const isValidEmail: (email: string) => boolean;
+/**
+ * Validate password strength
+ */
+declare const isValidPassword: (password: string, strength?: "basic" | "medium" | "strong") => boolean;
+/**
+ * Validate phone number
+ */
+declare const isValidPhone: (phone: string, format?: "international" | "us" | "india") => boolean;
+/**
+ * Validate URL format
+ */
+declare const isValidUrl: (url: string, requireProtocol?: boolean) => boolean;
+/**
+ * Validate username format
+ */
+declare const isValidUsername: (username: string) => boolean;
+/**
+ * Validate slug format
+ */
+declare const isValidSlug: (slug: string) => boolean;
+declare const VALIDATION_MESSAGES: {
+    readonly REQUIRED: "This field is required";
+    readonly REQUIRED_FIELD: (field: string) => string;
+    readonly EMAIL_INVALID: "Please enter a valid email address";
+    readonly EMAIL_REQUIRED: "Email is required";
+    readonly PASSWORD_REQUIRED: "Password is required";
+    readonly PASSWORD_MIN_LENGTH: (length: number) => string;
+    readonly PASSWORD_WEAK: "Password is too weak";
+    readonly PASSWORD_MEDIUM: "Password must contain uppercase, lowercase, and number";
+    readonly PASSWORD_STRONG: "Password must contain uppercase, lowercase, number, and special character";
+    readonly PASSWORD_MISMATCH: "Passwords do not match";
+    readonly NAME_REQUIRED: "Name is required";
+    readonly FIRST_NAME_REQUIRED: "First name is required";
+    readonly LAST_NAME_REQUIRED: "Last name is required";
+    readonly NAME_MIN_LENGTH: (length: number) => string;
+    readonly NAME_MAX_LENGTH: (length: number) => string;
+    readonly PHONE_INVALID: "Please enter a valid phone number";
+    readonly PHONE_REQUIRED: "Phone number is required";
+    readonly URL_INVALID: "Please enter a valid URL";
+    readonly USERNAME_INVALID: "Username can only contain letters, numbers, underscores, and hyphens";
+    readonly USERNAME_MIN_LENGTH: "Username must be at least 3 characters";
+    readonly USERNAME_MAX_LENGTH: "Username must be at most 30 characters";
+    readonly USERNAME_TAKEN: "This username is already taken";
+    readonly MIN_LENGTH: (field: string, length: number) => string;
+    readonly MAX_LENGTH: (field: string, length: number) => string;
+    readonly MIN_VALUE: (field: string, value: number) => string;
+    readonly MAX_VALUE: (field: string, value: number) => string;
+    readonly INVALID_FORMAT: "Invalid format";
+    readonly TERMS_REQUIRED: "You must accept the terms and conditions";
+};
+declare const VALIDATION_RULES: {
+    readonly email: {
+        readonly pattern: RegExp;
+        readonly message: "Please enter a valid email address";
+    };
+    readonly password: {
+        readonly minLength: 8;
+        readonly pattern: RegExp;
+        readonly message: "Password must contain uppercase, lowercase, and number";
+    };
+    readonly passwordStrong: {
+        readonly minLength: 8;
+        readonly pattern: RegExp;
+        readonly message: "Password must contain uppercase, lowercase, number, and special character";
+    };
+    readonly name: {
+        readonly minLength: 2;
+        readonly maxLength: 50;
+    };
+    readonly username: {
+        readonly minLength: 3;
+        readonly maxLength: 30;
+        readonly pattern: RegExp;
+        readonly message: "Username can only contain letters, numbers, underscores, and hyphens";
+    };
+    readonly phone: {
+        readonly pattern: RegExp;
+        readonly message: "Please enter a valid phone number";
+    };
+    readonly url: {
+        readonly pattern: RegExp;
+        readonly message: "Please enter a valid URL";
+    };
+};
+declare const _default: {
+    VALIDATION_PATTERNS: {
+        /** Email pattern (RFC 5322 simplified) */
+        readonly EMAIL: RegExp;
+        /** Strong password: min 8 chars, uppercase, lowercase, number, special char */
+        readonly PASSWORD_STRONG: RegExp;
+        /** Medium password: min 8 chars, uppercase, lowercase, number */
+        readonly PASSWORD_MEDIUM: RegExp;
+        /** Basic password: min 8 chars */
+        readonly PASSWORD_BASIC: RegExp;
+        /** Phone number (international) */
+        readonly PHONE_INTERNATIONAL: RegExp;
+        /** Phone number (US) */
+        readonly PHONE_US: RegExp;
+        /** Phone number (India) */
+        readonly PHONE_INDIA: RegExp;
+        /** URL pattern */
+        readonly URL: RegExp;
+        /** URL with required protocol */
+        readonly URL_STRICT: RegExp;
+        /** Alphanumeric only */
+        readonly ALPHANUMERIC: RegExp;
+        /** Letters only */
+        readonly LETTERS_ONLY: RegExp;
+        /** Numbers only */
+        readonly NUMBERS_ONLY: RegExp;
+        /** Slug pattern (kebab-case) */
+        readonly SLUG: RegExp;
+        /** Username pattern (alphanumeric, underscore, hyphen) */
+        readonly USERNAME: RegExp;
+        /** Credit card (basic validation) */
+        readonly CREDIT_CARD: RegExp;
+        /** CVV (3 or 4 digits) */
+        readonly CVV: RegExp;
+        /** ZIP code (US) */
+        readonly ZIP_US: RegExp;
+        /** Postal code (India) */
+        readonly POSTAL_INDIA: RegExp;
+        /** IP Address (IPv4) */
+        readonly IPV4: RegExp;
+        /** Hex color */
+        readonly HEX_COLOR: RegExp;
+        /** Date (YYYY-MM-DD) */
+        readonly DATE_ISO: RegExp;
+        /** Time (HH:MM or HH:MM:SS) */
+        readonly TIME: RegExp;
+    };
+    VALIDATION_MESSAGES: {
+        readonly REQUIRED: "This field is required";
+        readonly REQUIRED_FIELD: (field: string) => string;
+        readonly EMAIL_INVALID: "Please enter a valid email address";
+        readonly EMAIL_REQUIRED: "Email is required";
+        readonly PASSWORD_REQUIRED: "Password is required";
+        readonly PASSWORD_MIN_LENGTH: (length: number) => string;
+        readonly PASSWORD_WEAK: "Password is too weak";
+        readonly PASSWORD_MEDIUM: "Password must contain uppercase, lowercase, and number";
+        readonly PASSWORD_STRONG: "Password must contain uppercase, lowercase, number, and special character";
+        readonly PASSWORD_MISMATCH: "Passwords do not match";
+        readonly NAME_REQUIRED: "Name is required";
+        readonly FIRST_NAME_REQUIRED: "First name is required";
+        readonly LAST_NAME_REQUIRED: "Last name is required";
+        readonly NAME_MIN_LENGTH: (length: number) => string;
+        readonly NAME_MAX_LENGTH: (length: number) => string;
+        readonly PHONE_INVALID: "Please enter a valid phone number";
+        readonly PHONE_REQUIRED: "Phone number is required";
+        readonly URL_INVALID: "Please enter a valid URL";
+        readonly USERNAME_INVALID: "Username can only contain letters, numbers, underscores, and hyphens";
+        readonly USERNAME_MIN_LENGTH: "Username must be at least 3 characters";
+        readonly USERNAME_MAX_LENGTH: "Username must be at most 30 characters";
+        readonly USERNAME_TAKEN: "This username is already taken";
+        readonly MIN_LENGTH: (field: string, length: number) => string;
+        readonly MAX_LENGTH: (field: string, length: number) => string;
+        readonly MIN_VALUE: (field: string, value: number) => string;
+        readonly MAX_VALUE: (field: string, value: number) => string;
+        readonly INVALID_FORMAT: "Invalid format";
+        readonly TERMS_REQUIRED: "You must accept the terms and conditions";
+    };
+    VALIDATION_RULES: {
+        readonly email: {
+            readonly pattern: RegExp;
+            readonly message: "Please enter a valid email address";
+        };
+        readonly password: {
+            readonly minLength: 8;
+            readonly pattern: RegExp;
+            readonly message: "Password must contain uppercase, lowercase, and number";
+        };
+        readonly passwordStrong: {
+            readonly minLength: 8;
+            readonly pattern: RegExp;
+            readonly message: "Password must contain uppercase, lowercase, number, and special character";
+        };
+        readonly name: {
+            readonly minLength: 2;
+            readonly maxLength: 50;
+        };
+        readonly username: {
+            readonly minLength: 3;
+            readonly maxLength: 30;
+            readonly pattern: RegExp;
+            readonly message: "Username can only contain letters, numbers, underscores, and hyphens";
+        };
+        readonly phone: {
+            readonly pattern: RegExp;
+            readonly message: "Please enter a valid phone number";
+        };
+        readonly url: {
+            readonly pattern: RegExp;
+            readonly message: "Please enter a valid URL";
+        };
+    };
+    isValidEmail: (email: string) => boolean;
+    isValidPassword: (password: string, strength?: "basic" | "medium" | "strong") => boolean;
+    isValidPhone: (phone: string, format?: "international" | "us" | "india") => boolean;
+    isValidUrl: (url: string, requireProtocol?: boolean) => boolean;
+    isValidUsername: (username: string) => boolean;
+    isValidSlug: (slug: string) => boolean;
+};
+
+export { VALIDATION_MESSAGES, VALIDATION_PATTERNS, VALIDATION_RULES, _default as default, isValidEmail, isValidPassword, isValidPhone, isValidSlug, isValidUrl, isValidUsername };