@itshackers/utilix 0.0.0-stage → 0.3.0

package/dist/date/index.cjs

@@ -0,0 +1,154 @@
+'use strict';
+
+// src/date/index.ts
+var IST_OFFSET_MS = 330 * 60 * 1e3;
+var IST_DATETIME_RE = /^(\d{4})-(\d{2})-(\d{2})[ T](\d{2}):(\d{2})(?::(\d{2}))?/;
+function pad(value, length = 2) {
+  return String(value).padStart(length, "0");
+}
+function getIstDateParts(date = /* @__PURE__ */ new Date()) {
+  const parts = new Intl.DateTimeFormat("en-CA", {
+    timeZone: "Asia/Kolkata",
+    year: "numeric",
+    month: "2-digit",
+    day: "2-digit",
+    hour: "2-digit",
+    hourCycle: "h23"
+  }).formatToParts(date);
+  const read = (type) => {
+    const value = parts.find((part) => part.type === type)?.value;
+    return Number(value);
+  };
+  return {
+    year: read("year"),
+    month: read("month"),
+    day: read("day"),
+    hour: read("hour")
+  };
+}
+function addCalendarDays(year, month, day, days) {
+  const utc = new Date(Date.UTC(year, month - 1, day + days));
+  return {
+    year: utc.getUTCFullYear(),
+    month: utc.getUTCMonth() + 1,
+    day: utc.getUTCDate()
+  };
+}
+function istDateTime(year, month, day, hour = 0, minute = 0, second = 0, millisecond = 0) {
+  return /* @__PURE__ */ new Date(
+    `${year}-${pad(month)}-${pad(day)}T${pad(hour)}:${pad(minute)}:${pad(second)}.${pad(millisecond, 3)}+05:30`
+  );
+}
+function parseIstDateTimeToUtc(value) {
+  if (value == null || value === "") {
+    return null;
+  }
+  if (value instanceof Date) {
+    return Number.isNaN(value.getTime()) ? null : value;
+  }
+  if (typeof value === "number") {
+    const parsed = new Date(value);
+    return Number.isNaN(parsed.getTime()) ? null : parsed;
+  }
+  const raw = value.trim();
+  if (raw.length === 0) {
+    return null;
+  }
+  if (/[zZ]$/.test(raw) || /[+-]\d{2}:?\d{2}$/.test(raw)) {
+    const parsed = new Date(raw);
+    return Number.isNaN(parsed.getTime()) ? null : parsed;
+  }
+  const match = raw.match(IST_DATETIME_RE);
+  if (!match) {
+    const parsed = new Date(raw);
+    return Number.isNaN(parsed.getTime()) ? null : parsed;
+  }
+  const [, year = "0", month = "1", day = "1", hour = "0", minute = "0", second = "0"] = match;
+  const istAsUtcMs = Date.UTC(
+    Number(year),
+    Number(month) - 1,
+    Number(day),
+    Number(hour),
+    Number(minute),
+    Number(second)
+  );
+  return new Date(istAsUtcMs - IST_OFFSET_MS);
+}
+function formatUtcToIstDateTime(value) {
+  if (value == null || value === "") {
+    return "";
+  }
+  const date = value instanceof Date ? value : new Date(value);
+  if (Number.isNaN(date.getTime())) {
+    return "";
+  }
+  const ist = new Date(date.getTime() + IST_OFFSET_MS);
+  return `${ist.getUTCFullYear()}-${pad(ist.getUTCMonth() + 1)}-${pad(ist.getUTCDate())} ${pad(ist.getUTCHours())}:${pad(ist.getUTCMinutes())}:${pad(ist.getUTCSeconds())}`;
+}
+function getExpiryInfo(expiresAt, options = {}) {
+  if (!(expiresAt instanceof Date) || Number.isNaN(expiresAt.getTime())) {
+    return null;
+  }
+  const warningDays = options.warningDays ?? 7;
+  const compact = options.compact ?? false;
+  const now = options.now ?? /* @__PURE__ */ new Date();
+  let remainingSeconds = Math.floor((expiresAt.getTime() - now.getTime()) / 1e3);
+  if (remainingSeconds < 0) {
+    remainingSeconds = 0;
+  }
+  const units = [
+    { label: "day", short: "d", value: 86400 },
+    { label: "hour", short: "h", value: 3600 },
+    { label: "minute", short: "m", value: 60 },
+    { label: "second", short: "s", value: 1 }
+  ];
+  const parts = [];
+  let remaining = remainingSeconds;
+  for (const unit of units) {
+    const count = Math.floor(remaining / unit.value);
+    if (count > 0) {
+      parts.push(compact ? `${count}${unit.short}` : `${count} ${unit.label}${count > 1 ? "s" : ""}`);
+      remaining -= count * unit.value;
+    }
+  }
+  const daysLeft = Math.ceil(remainingSeconds / 86400);
+  return {
+    expiresAt,
+    remainingSeconds,
+    remainingHuman: parts.join(" ") || "Expired",
+    daysLeft,
+    isExpired: remainingSeconds === 0,
+    needsRefresh: daysLeft <= warningDays
+  };
+}
+function getCalendarWindow(options = {}) {
+  const now = options.now ?? /* @__PURE__ */ new Date();
+  const cutoffHour = options.cutoffHour ?? 14;
+  const windowDays = options.windowDays ?? 36;
+  const startOffsetBeforeCutoff = options.startOffsetBeforeCutoff ?? 1;
+  const startOffsetAfterCutoff = options.startOffsetAfterCutoff ?? 2;
+  if (!Number.isInteger(cutoffHour) || cutoffHour < 0 || cutoffHour > 23) {
+    throw new RangeError("cutoffHour must be an integer between 0 and 23");
+  }
+  if (!Number.isInteger(windowDays) || windowDays < 0) {
+    throw new RangeError("windowDays must be an integer greater than or equal to 0");
+  }
+  const { year, month, day, hour } = getIstDateParts(now);
+  const startOffsetDays = hour < cutoffHour ? startOffsetBeforeCutoff : startOffsetAfterCutoff;
+  const minYmd = addCalendarDays(year, month, day, startOffsetDays);
+  const maxYmd = addCalendarDays(minYmd.year, minYmd.month, minYmd.day, windowDays);
+  return {
+    min: istDateTime(minYmd.year, minYmd.month, minYmd.day, 0, 0, 0, 0),
+    max: istDateTime(maxYmd.year, maxYmd.month, maxYmd.day, 23, 59, 59, 999)
+  };
+}
+
+exports.addCalendarDays = addCalendarDays;
+exports.formatUtcToIstDateTime = formatUtcToIstDateTime;
+exports.getCalendarWindow = getCalendarWindow;
+exports.getExpiryInfo = getExpiryInfo;
+exports.getIstDateParts = getIstDateParts;
+exports.istDateTime = istDateTime;
+exports.parseIstDateTimeToUtc = parseIstDateTimeToUtc;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/date/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/date/index.ts"],"names":[],"mappings":"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","file":"index.cjs","sourcesContent":["const IST_OFFSET_MS = 330 * 60 * 1000;\r\nconst IST_DATETIME_RE =\r\n  /^(\\d{4})-(\\d{2})-(\\d{2})[ T](\\d{2}):(\\d{2})(?::(\\d{2}))?/;\r\n\r\nexport interface IstDateParts {\r\n  year: number;\r\n  month: number;\r\n  day: number;\r\n  hour: number;\r\n}\r\n\r\nexport interface ExpiryInfo {\r\n  expiresAt: Date;\r\n  remainingSeconds: number;\r\n  remainingHuman: string;\r\n  daysLeft: number;\r\n  isExpired: boolean;\r\n  needsRefresh: boolean;\r\n}\r\n\r\nexport interface ExpiryInfoOptions {\r\n  warningDays?: number;\r\n  compact?: boolean;\r\n  now?: Date;\r\n}\r\n\r\nexport interface CalendarWindowOptions {\r\n  now?: Date;\r\n  cutoffHour?: number;\r\n  windowDays?: number;\r\n  startOffsetBeforeCutoff?: number;\r\n  startOffsetAfterCutoff?: number;\r\n}\r\n\r\nfunction pad(value: number, length = 2): string {\r\n  return String(value).padStart(length, \"0\");\r\n}\r\n\r\n/**\r\n * Reads calendar parts of a date in Asia/Kolkata.\r\n */\r\nexport function getIstDateParts(date: Date = new Date()): IstDateParts {\r\n  const parts = new Intl.DateTimeFormat(\"en-CA\", {\r\n    timeZone: \"Asia/Kolkata\",\r\n    year: \"numeric\",\r\n    month: \"2-digit\",\r\n    day: \"2-digit\",\r\n    hour: \"2-digit\",\r\n    hourCycle: \"h23\",\r\n  }).formatToParts(date);\r\n\r\n  const read = (type: Intl.DateTimeFormatPartTypes): number => {\r\n    const value = parts.find((part) => part.type === type)?.value;\r\n    return Number(value);\r\n  };\r\n\r\n  return {\r\n    year: read(\"year\"),\r\n    month: read(\"month\"),\r\n    day: read(\"day\"),\r\n    hour: read(\"hour\"),\r\n  };\r\n}\r\n\r\n/**\r\n * Adds calendar days to a year/month/day triple without DST surprises.\r\n */\r\nexport function addCalendarDays(\r\n  year: number,\r\n  month: number,\r\n  day: number,\r\n  days: number,\r\n): { year: number; month: number; day: number } {\r\n  const utc = new Date(Date.UTC(year, month - 1, day + days));\r\n  return {\r\n    year: utc.getUTCFullYear(),\r\n    month: utc.getUTCMonth() + 1,\r\n    day: utc.getUTCDate(),\r\n  };\r\n}\r\n\r\n/**\r\n * Builds a Date for an Asia/Kolkata wall-clock time.\r\n */\r\nexport function istDateTime(\r\n  year: number,\r\n  month: number,\r\n  day: number,\r\n  hour = 0,\r\n  minute = 0,\r\n  second = 0,\r\n  millisecond = 0,\r\n): Date {\r\n  return new Date(\r\n    `${year}-${pad(month)}-${pad(day)}T${pad(hour)}:${pad(minute)}:${pad(second)}.${pad(millisecond, 3)}+05:30`,\r\n  );\r\n}\r\n\r\n/**\r\n * Parses a naive IST datetime as Asia/Kolkata and returns a UTC Date.\r\n * Values with an explicit timezone (`Z` or `±HH:mm`) are treated as absolute instants.\r\n */\r\nexport function parseIstDateTimeToUtc(value: Date | string | number | null | undefined): Date | null {\r\n  if (value == null || value === \"\") {\r\n    return null;\r\n  }\r\n\r\n  if (value instanceof Date) {\r\n    return Number.isNaN(value.getTime()) ? null : value;\r\n  }\r\n\r\n  if (typeof value === \"number\") {\r\n    const parsed = new Date(value);\r\n    return Number.isNaN(parsed.getTime()) ? null : parsed;\r\n  }\r\n\r\n  const raw = value.trim();\r\n  if (raw.length === 0) {\r\n    return null;\r\n  }\r\n\r\n  if (/[zZ]$/.test(raw) || /[+-]\\d{2}:?\\d{2}$/.test(raw)) {\r\n    const parsed = new Date(raw);\r\n    return Number.isNaN(parsed.getTime()) ? null : parsed;\r\n  }\r\n\r\n  const match = raw.match(IST_DATETIME_RE);\r\n  if (!match) {\r\n    const parsed = new Date(raw);\r\n    return Number.isNaN(parsed.getTime()) ? null : parsed;\r\n  }\r\n\r\n  const [, year = \"0\", month = \"1\", day = \"1\", hour = \"0\", minute = \"0\", second = \"0\"] = match;\r\n  const istAsUtcMs = Date.UTC(\r\n    Number(year),\r\n    Number(month) - 1,\r\n    Number(day),\r\n    Number(hour),\r\n    Number(minute),\r\n    Number(second),\r\n  );\r\n\r\n  return new Date(istAsUtcMs - IST_OFFSET_MS);\r\n}\r\n\r\n/**\r\n * Formats a UTC instant as `YYYY-MM-DD HH:mm:ss` in Asia/Kolkata.\r\n */\r\nexport function formatUtcToIstDateTime(value: Date | string | number | null | undefined): string {\r\n  if (value == null || value === \"\") {\r\n    return \"\";\r\n  }\r\n\r\n  const date = value instanceof Date ? value : new Date(value);\r\n  if (Number.isNaN(date.getTime())) {\r\n    return \"\";\r\n  }\r\n\r\n  const ist = new Date(date.getTime() + IST_OFFSET_MS);\r\n  return `${ist.getUTCFullYear()}-${pad(ist.getUTCMonth() + 1)}-${pad(ist.getUTCDate())} ${pad(ist.getUTCHours())}:${pad(ist.getUTCMinutes())}:${pad(ist.getUTCSeconds())}`;\r\n}\r\n\r\n/**\r\n * Returns remaining time until `expiresAt`.\r\n */\r\nexport function getExpiryInfo(expiresAt: Date, options: ExpiryInfoOptions = {}): ExpiryInfo | null {\r\n  if (!(expiresAt instanceof Date) || Number.isNaN(expiresAt.getTime())) {\r\n    return null;\r\n  }\r\n\r\n  const warningDays = options.warningDays ?? 7;\r\n  const compact = options.compact ?? false;\r\n  const now = options.now ?? new Date();\r\n\r\n  let remainingSeconds = Math.floor((expiresAt.getTime() - now.getTime()) / 1000);\r\n  if (remainingSeconds < 0) {\r\n    remainingSeconds = 0;\r\n  }\r\n\r\n  const units = [\r\n    { label: \"day\", short: \"d\", value: 86_400 },\r\n    { label: \"hour\", short: \"h\", value: 3_600 },\r\n    { label: \"minute\", short: \"m\", value: 60 },\r\n    { label: \"second\", short: \"s\", value: 1 },\r\n  ] as const;\r\n\r\n  const parts: string[] = [];\r\n  let remaining = remainingSeconds;\r\n  for (const unit of units) {\r\n    const count = Math.floor(remaining / unit.value);\r\n    if (count > 0) {\r\n      parts.push(compact ? `${count}${unit.short}` : `${count} ${unit.label}${count > 1 ? \"s\" : \"\"}`);\r\n      remaining -= count * unit.value;\r\n    }\r\n  }\r\n\r\n  const daysLeft = Math.ceil(remainingSeconds / 86_400);\r\n\r\n  return {\r\n    expiresAt,\r\n    remainingSeconds,\r\n    remainingHuman: parts.join(\" \") || \"Expired\",\r\n    daysLeft,\r\n    isExpired: remainingSeconds === 0,\r\n    needsRefresh: daysLeft <= warningDays,\r\n  };\r\n}\r\n\r\n/**\r\n * Builds a configurable IST calendar window, typically for booking start/end dates.\r\n */\r\nexport function getCalendarWindow(options: CalendarWindowOptions = {}): { min: Date; max: Date } {\r\n  const now = options.now ?? new Date();\r\n  const cutoffHour = options.cutoffHour ?? 14;\r\n  const windowDays = options.windowDays ?? 36;\r\n  const startOffsetBeforeCutoff = options.startOffsetBeforeCutoff ?? 1;\r\n  const startOffsetAfterCutoff = options.startOffsetAfterCutoff ?? 2;\r\n\r\n  if (!Number.isInteger(cutoffHour) || cutoffHour < 0 || cutoffHour > 23) {\r\n    throw new RangeError(\"cutoffHour must be an integer between 0 and 23\");\r\n  }\r\n  if (!Number.isInteger(windowDays) || windowDays < 0) {\r\n    throw new RangeError(\"windowDays must be an integer greater than or equal to 0\");\r\n  }\r\n\r\n  const { year, month, day, hour } = getIstDateParts(now);\r\n  const startOffsetDays = hour < cutoffHour ? startOffsetBeforeCutoff : startOffsetAfterCutoff;\r\n  const minYmd = addCalendarDays(year, month, day, startOffsetDays);\r\n  const maxYmd = addCalendarDays(minYmd.year, minYmd.month, minYmd.day, windowDays);\r\n\r\n  return {\r\n    min: istDateTime(minYmd.year, minYmd.month, minYmd.day, 0, 0, 0, 0),\r\n    max: istDateTime(maxYmd.year, maxYmd.month, maxYmd.day, 23, 59, 59, 999),\r\n  };\r\n}\r\n"]}

package/dist/date/index.d.cts

@@ -0,0 +1,65 @@
+interface IstDateParts {
+    year: number;
+    month: number;
+    day: number;
+    hour: number;
+}
+interface ExpiryInfo {
+    expiresAt: Date;
+    remainingSeconds: number;
+    remainingHuman: string;
+    daysLeft: number;
+    isExpired: boolean;
+    needsRefresh: boolean;
+}
+interface ExpiryInfoOptions {
+    warningDays?: number;
+    compact?: boolean;
+    now?: Date;
+}
+interface CalendarWindowOptions {
+    now?: Date;
+    cutoffHour?: number;
+    windowDays?: number;
+    startOffsetBeforeCutoff?: number;
+    startOffsetAfterCutoff?: number;
+}
+/**
+ * Reads calendar parts of a date in Asia/Kolkata.
+ */
+declare function getIstDateParts(date?: Date): IstDateParts;
+/**
+ * Adds calendar days to a year/month/day triple without DST surprises.
+ */
+declare function addCalendarDays(year: number, month: number, day: number, days: number): {
+    year: number;
+    month: number;
+    day: number;
+};
+/**
+ * Builds a Date for an Asia/Kolkata wall-clock time.
+ */
+declare function istDateTime(year: number, month: number, day: number, hour?: number, minute?: number, second?: number, millisecond?: number): Date;
+/**
+ * Parses a naive IST datetime as Asia/Kolkata and returns a UTC Date.
+ * Values with an explicit timezone (`Z` or `±HH:mm`) are treated as absolute instants.
+ */
+declare function parseIstDateTimeToUtc(value: Date | string | number | null | undefined): Date | null;
+/**
+ * Formats a UTC instant as `YYYY-MM-DD HH:mm:ss` in Asia/Kolkata.
+ */
+declare function formatUtcToIstDateTime(value: Date | string | number | null | undefined): string;
+/**
+ * Returns remaining time until `expiresAt`.
+ */
+declare function getExpiryInfo(expiresAt: Date, options?: ExpiryInfoOptions): ExpiryInfo | null;
+/**
+ * Builds a configurable IST calendar window, typically for booking start/end dates.
+ */
+declare function getCalendarWindow(options?: CalendarWindowOptions): {
+    min: Date;
+    max: Date;
+};
+
+export { addCalendarDays, formatUtcToIstDateTime, getCalendarWindow, getExpiryInfo, getIstDateParts, istDateTime, parseIstDateTimeToUtc };
+export type { CalendarWindowOptions, ExpiryInfo, ExpiryInfoOptions, IstDateParts };

package/dist/date/index.d.ts

@@ -0,0 +1,65 @@
+interface IstDateParts {
+    year: number;
+    month: number;
+    day: number;
+    hour: number;
+}
+interface ExpiryInfo {
+    expiresAt: Date;
+    remainingSeconds: number;
+    remainingHuman: string;
+    daysLeft: number;
+    isExpired: boolean;
+    needsRefresh: boolean;
+}
+interface ExpiryInfoOptions {
+    warningDays?: number;
+    compact?: boolean;
+    now?: Date;
+}
+interface CalendarWindowOptions {
+    now?: Date;
+    cutoffHour?: number;
+    windowDays?: number;
+    startOffsetBeforeCutoff?: number;
+    startOffsetAfterCutoff?: number;
+}
+/**
+ * Reads calendar parts of a date in Asia/Kolkata.
+ */
+declare function getIstDateParts(date?: Date): IstDateParts;
+/**
+ * Adds calendar days to a year/month/day triple without DST surprises.
+ */
+declare function addCalendarDays(year: number, month: number, day: number, days: number): {
+    year: number;
+    month: number;
+    day: number;
+};
+/**
+ * Builds a Date for an Asia/Kolkata wall-clock time.
+ */
+declare function istDateTime(year: number, month: number, day: number, hour?: number, minute?: number, second?: number, millisecond?: number): Date;
+/**
+ * Parses a naive IST datetime as Asia/Kolkata and returns a UTC Date.
+ * Values with an explicit timezone (`Z` or `±HH:mm`) are treated as absolute instants.
+ */
+declare function parseIstDateTimeToUtc(value: Date | string | number | null | undefined): Date | null;
+/**
+ * Formats a UTC instant as `YYYY-MM-DD HH:mm:ss` in Asia/Kolkata.
+ */
+declare function formatUtcToIstDateTime(value: Date | string | number | null | undefined): string;
+/**
+ * Returns remaining time until `expiresAt`.
+ */
+declare function getExpiryInfo(expiresAt: Date, options?: ExpiryInfoOptions): ExpiryInfo | null;
+/**
+ * Builds a configurable IST calendar window, typically for booking start/end dates.
+ */
+declare function getCalendarWindow(options?: CalendarWindowOptions): {
+    min: Date;
+    max: Date;
+};
+
+export { addCalendarDays, formatUtcToIstDateTime, getCalendarWindow, getExpiryInfo, getIstDateParts, istDateTime, parseIstDateTimeToUtc };
+export type { CalendarWindowOptions, ExpiryInfo, ExpiryInfoOptions, IstDateParts };

package/dist/date/index.js

@@ -0,0 +1,146 @@
+// src/date/index.ts
+var IST_OFFSET_MS = 330 * 60 * 1e3;
+var IST_DATETIME_RE = /^(\d{4})-(\d{2})-(\d{2})[ T](\d{2}):(\d{2})(?::(\d{2}))?/;
+function pad(value, length = 2) {
+  return String(value).padStart(length, "0");
+}
+function getIstDateParts(date = /* @__PURE__ */ new Date()) {
+  const parts = new Intl.DateTimeFormat("en-CA", {
+    timeZone: "Asia/Kolkata",
+    year: "numeric",
+    month: "2-digit",
+    day: "2-digit",
+    hour: "2-digit",
+    hourCycle: "h23"
+  }).formatToParts(date);
+  const read = (type) => {
+    const value = parts.find((part) => part.type === type)?.value;
+    return Number(value);
+  };
+  return {
+    year: read("year"),
+    month: read("month"),
+    day: read("day"),
+    hour: read("hour")
+  };
+}
+function addCalendarDays(year, month, day, days) {
+  const utc = new Date(Date.UTC(year, month - 1, day + days));
+  return {
+    year: utc.getUTCFullYear(),
+    month: utc.getUTCMonth() + 1,
+    day: utc.getUTCDate()
+  };
+}
+function istDateTime(year, month, day, hour = 0, minute = 0, second = 0, millisecond = 0) {
+  return /* @__PURE__ */ new Date(
+    `${year}-${pad(month)}-${pad(day)}T${pad(hour)}:${pad(minute)}:${pad(second)}.${pad(millisecond, 3)}+05:30`
+  );
+}
+function parseIstDateTimeToUtc(value) {
+  if (value == null || value === "") {
+    return null;
+  }
+  if (value instanceof Date) {
+    return Number.isNaN(value.getTime()) ? null : value;
+  }
+  if (typeof value === "number") {
+    const parsed = new Date(value);
+    return Number.isNaN(parsed.getTime()) ? null : parsed;
+  }
+  const raw = value.trim();
+  if (raw.length === 0) {
+    return null;
+  }
+  if (/[zZ]$/.test(raw) || /[+-]\d{2}:?\d{2}$/.test(raw)) {
+    const parsed = new Date(raw);
+    return Number.isNaN(parsed.getTime()) ? null : parsed;
+  }
+  const match = raw.match(IST_DATETIME_RE);
+  if (!match) {
+    const parsed = new Date(raw);
+    return Number.isNaN(parsed.getTime()) ? null : parsed;
+  }
+  const [, year = "0", month = "1", day = "1", hour = "0", minute = "0", second = "0"] = match;
+  const istAsUtcMs = Date.UTC(
+    Number(year),
+    Number(month) - 1,
+    Number(day),
+    Number(hour),
+    Number(minute),
+    Number(second)
+  );
+  return new Date(istAsUtcMs - IST_OFFSET_MS);
+}
+function formatUtcToIstDateTime(value) {
+  if (value == null || value === "") {
+    return "";
+  }
+  const date = value instanceof Date ? value : new Date(value);
+  if (Number.isNaN(date.getTime())) {
+    return "";
+  }
+  const ist = new Date(date.getTime() + IST_OFFSET_MS);
+  return `${ist.getUTCFullYear()}-${pad(ist.getUTCMonth() + 1)}-${pad(ist.getUTCDate())} ${pad(ist.getUTCHours())}:${pad(ist.getUTCMinutes())}:${pad(ist.getUTCSeconds())}`;
+}
+function getExpiryInfo(expiresAt, options = {}) {
+  if (!(expiresAt instanceof Date) || Number.isNaN(expiresAt.getTime())) {
+    return null;
+  }
+  const warningDays = options.warningDays ?? 7;
+  const compact = options.compact ?? false;
+  const now = options.now ?? /* @__PURE__ */ new Date();
+  let remainingSeconds = Math.floor((expiresAt.getTime() - now.getTime()) / 1e3);
+  if (remainingSeconds < 0) {
+    remainingSeconds = 0;
+  }
+  const units = [
+    { label: "day", short: "d", value: 86400 },
+    { label: "hour", short: "h", value: 3600 },
+    { label: "minute", short: "m", value: 60 },
+    { label: "second", short: "s", value: 1 }
+  ];
+  const parts = [];
+  let remaining = remainingSeconds;
+  for (const unit of units) {
+    const count = Math.floor(remaining / unit.value);
+    if (count > 0) {
+      parts.push(compact ? `${count}${unit.short}` : `${count} ${unit.label}${count > 1 ? "s" : ""}`);
+      remaining -= count * unit.value;
+    }
+  }
+  const daysLeft = Math.ceil(remainingSeconds / 86400);
+  return {
+    expiresAt,
+    remainingSeconds,
+    remainingHuman: parts.join(" ") || "Expired",
+    daysLeft,
+    isExpired: remainingSeconds === 0,
+    needsRefresh: daysLeft <= warningDays
+  };
+}
+function getCalendarWindow(options = {}) {
+  const now = options.now ?? /* @__PURE__ */ new Date();
+  const cutoffHour = options.cutoffHour ?? 14;
+  const windowDays = options.windowDays ?? 36;
+  const startOffsetBeforeCutoff = options.startOffsetBeforeCutoff ?? 1;
+  const startOffsetAfterCutoff = options.startOffsetAfterCutoff ?? 2;
+  if (!Number.isInteger(cutoffHour) || cutoffHour < 0 || cutoffHour > 23) {
+    throw new RangeError("cutoffHour must be an integer between 0 and 23");
+  }
+  if (!Number.isInteger(windowDays) || windowDays < 0) {
+    throw new RangeError("windowDays must be an integer greater than or equal to 0");
+  }
+  const { year, month, day, hour } = getIstDateParts(now);
+  const startOffsetDays = hour < cutoffHour ? startOffsetBeforeCutoff : startOffsetAfterCutoff;
+  const minYmd = addCalendarDays(year, month, day, startOffsetDays);
+  const maxYmd = addCalendarDays(minYmd.year, minYmd.month, minYmd.day, windowDays);
+  return {
+    min: istDateTime(minYmd.year, minYmd.month, minYmd.day, 0, 0, 0, 0),
+    max: istDateTime(maxYmd.year, maxYmd.month, maxYmd.day, 23, 59, 59, 999)
+  };
+}
+
+export { addCalendarDays, formatUtcToIstDateTime, getCalendarWindow, getExpiryInfo, getIstDateParts, istDateTime, parseIstDateTimeToUtc };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/date/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/date/index.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["const IST_OFFSET_MS = 330 * 60 * 1000;\r\nconst IST_DATETIME_RE =\r\n  /^(\\d{4})-(\\d{2})-(\\d{2})[ T](\\d{2}):(\\d{2})(?::(\\d{2}))?/;\r\n\r\nexport interface IstDateParts {\r\n  year: number;\r\n  month: number;\r\n  day: number;\r\n  hour: number;\r\n}\r\n\r\nexport interface ExpiryInfo {\r\n  expiresAt: Date;\r\n  remainingSeconds: number;\r\n  remainingHuman: string;\r\n  daysLeft: number;\r\n  isExpired: boolean;\r\n  needsRefresh: boolean;\r\n}\r\n\r\nexport interface ExpiryInfoOptions {\r\n  warningDays?: number;\r\n  compact?: boolean;\r\n  now?: Date;\r\n}\r\n\r\nexport interface CalendarWindowOptions {\r\n  now?: Date;\r\n  cutoffHour?: number;\r\n  windowDays?: number;\r\n  startOffsetBeforeCutoff?: number;\r\n  startOffsetAfterCutoff?: number;\r\n}\r\n\r\nfunction pad(value: number, length = 2): string {\r\n  return String(value).padStart(length, \"0\");\r\n}\r\n\r\n/**\r\n * Reads calendar parts of a date in Asia/Kolkata.\r\n */\r\nexport function getIstDateParts(date: Date = new Date()): IstDateParts {\r\n  const parts = new Intl.DateTimeFormat(\"en-CA\", {\r\n    timeZone: \"Asia/Kolkata\",\r\n    year: \"numeric\",\r\n    month: \"2-digit\",\r\n    day: \"2-digit\",\r\n    hour: \"2-digit\",\r\n    hourCycle: \"h23\",\r\n  }).formatToParts(date);\r\n\r\n  const read = (type: Intl.DateTimeFormatPartTypes): number => {\r\n    const value = parts.find((part) => part.type === type)?.value;\r\n    return Number(value);\r\n  };\r\n\r\n  return {\r\n    year: read(\"year\"),\r\n    month: read(\"month\"),\r\n    day: read(\"day\"),\r\n    hour: read(\"hour\"),\r\n  };\r\n}\r\n\r\n/**\r\n * Adds calendar days to a year/month/day triple without DST surprises.\r\n */\r\nexport function addCalendarDays(\r\n  year: number,\r\n  month: number,\r\n  day: number,\r\n  days: number,\r\n): { year: number; month: number; day: number } {\r\n  const utc = new Date(Date.UTC(year, month - 1, day + days));\r\n  return {\r\n    year: utc.getUTCFullYear(),\r\n    month: utc.getUTCMonth() + 1,\r\n    day: utc.getUTCDate(),\r\n  };\r\n}\r\n\r\n/**\r\n * Builds a Date for an Asia/Kolkata wall-clock time.\r\n */\r\nexport function istDateTime(\r\n  year: number,\r\n  month: number,\r\n  day: number,\r\n  hour = 0,\r\n  minute = 0,\r\n  second = 0,\r\n  millisecond = 0,\r\n): Date {\r\n  return new Date(\r\n    `${year}-${pad(month)}-${pad(day)}T${pad(hour)}:${pad(minute)}:${pad(second)}.${pad(millisecond, 3)}+05:30`,\r\n  );\r\n}\r\n\r\n/**\r\n * Parses a naive IST datetime as Asia/Kolkata and returns a UTC Date.\r\n * Values with an explicit timezone (`Z` or `±HH:mm`) are treated as absolute instants.\r\n */\r\nexport function parseIstDateTimeToUtc(value: Date | string | number | null | undefined): Date | null {\r\n  if (value == null || value === \"\") {\r\n    return null;\r\n  }\r\n\r\n  if (value instanceof Date) {\r\n    return Number.isNaN(value.getTime()) ? null : value;\r\n  }\r\n\r\n  if (typeof value === \"number\") {\r\n    const parsed = new Date(value);\r\n    return Number.isNaN(parsed.getTime()) ? null : parsed;\r\n  }\r\n\r\n  const raw = value.trim();\r\n  if (raw.length === 0) {\r\n    return null;\r\n  }\r\n\r\n  if (/[zZ]$/.test(raw) || /[+-]\\d{2}:?\\d{2}$/.test(raw)) {\r\n    const parsed = new Date(raw);\r\n    return Number.isNaN(parsed.getTime()) ? null : parsed;\r\n  }\r\n\r\n  const match = raw.match(IST_DATETIME_RE);\r\n  if (!match) {\r\n    const parsed = new Date(raw);\r\n    return Number.isNaN(parsed.getTime()) ? null : parsed;\r\n  }\r\n\r\n  const [, year = \"0\", month = \"1\", day = \"1\", hour = \"0\", minute = \"0\", second = \"0\"] = match;\r\n  const istAsUtcMs = Date.UTC(\r\n    Number(year),\r\n    Number(month) - 1,\r\n    Number(day),\r\n    Number(hour),\r\n    Number(minute),\r\n    Number(second),\r\n  );\r\n\r\n  return new Date(istAsUtcMs - IST_OFFSET_MS);\r\n}\r\n\r\n/**\r\n * Formats a UTC instant as `YYYY-MM-DD HH:mm:ss` in Asia/Kolkata.\r\n */\r\nexport function formatUtcToIstDateTime(value: Date | string | number | null | undefined): string {\r\n  if (value == null || value === \"\") {\r\n    return \"\";\r\n  }\r\n\r\n  const date = value instanceof Date ? value : new Date(value);\r\n  if (Number.isNaN(date.getTime())) {\r\n    return \"\";\r\n  }\r\n\r\n  const ist = new Date(date.getTime() + IST_OFFSET_MS);\r\n  return `${ist.getUTCFullYear()}-${pad(ist.getUTCMonth() + 1)}-${pad(ist.getUTCDate())} ${pad(ist.getUTCHours())}:${pad(ist.getUTCMinutes())}:${pad(ist.getUTCSeconds())}`;\r\n}\r\n\r\n/**\r\n * Returns remaining time until `expiresAt`.\r\n */\r\nexport function getExpiryInfo(expiresAt: Date, options: ExpiryInfoOptions = {}): ExpiryInfo | null {\r\n  if (!(expiresAt instanceof Date) || Number.isNaN(expiresAt.getTime())) {\r\n    return null;\r\n  }\r\n\r\n  const warningDays = options.warningDays ?? 7;\r\n  const compact = options.compact ?? false;\r\n  const now = options.now ?? new Date();\r\n\r\n  let remainingSeconds = Math.floor((expiresAt.getTime() - now.getTime()) / 1000);\r\n  if (remainingSeconds < 0) {\r\n    remainingSeconds = 0;\r\n  }\r\n\r\n  const units = [\r\n    { label: \"day\", short: \"d\", value: 86_400 },\r\n    { label: \"hour\", short: \"h\", value: 3_600 },\r\n    { label: \"minute\", short: \"m\", value: 60 },\r\n    { label: \"second\", short: \"s\", value: 1 },\r\n  ] as const;\r\n\r\n  const parts: string[] = [];\r\n  let remaining = remainingSeconds;\r\n  for (const unit of units) {\r\n    const count = Math.floor(remaining / unit.value);\r\n    if (count > 0) {\r\n      parts.push(compact ? `${count}${unit.short}` : `${count} ${unit.label}${count > 1 ? \"s\" : \"\"}`);\r\n      remaining -= count * unit.value;\r\n    }\r\n  }\r\n\r\n  const daysLeft = Math.ceil(remainingSeconds / 86_400);\r\n\r\n  return {\r\n    expiresAt,\r\n    remainingSeconds,\r\n    remainingHuman: parts.join(\" \") || \"Expired\",\r\n    daysLeft,\r\n    isExpired: remainingSeconds === 0,\r\n    needsRefresh: daysLeft <= warningDays,\r\n  };\r\n}\r\n\r\n/**\r\n * Builds a configurable IST calendar window, typically for booking start/end dates.\r\n */\r\nexport function getCalendarWindow(options: CalendarWindowOptions = {}): { min: Date; max: Date } {\r\n  const now = options.now ?? new Date();\r\n  const cutoffHour = options.cutoffHour ?? 14;\r\n  const windowDays = options.windowDays ?? 36;\r\n  const startOffsetBeforeCutoff = options.startOffsetBeforeCutoff ?? 1;\r\n  const startOffsetAfterCutoff = options.startOffsetAfterCutoff ?? 2;\r\n\r\n  if (!Number.isInteger(cutoffHour) || cutoffHour < 0 || cutoffHour > 23) {\r\n    throw new RangeError(\"cutoffHour must be an integer between 0 and 23\");\r\n  }\r\n  if (!Number.isInteger(windowDays) || windowDays < 0) {\r\n    throw new RangeError(\"windowDays must be an integer greater than or equal to 0\");\r\n  }\r\n\r\n  const { year, month, day, hour } = getIstDateParts(now);\r\n  const startOffsetDays = hour < cutoffHour ? startOffsetBeforeCutoff : startOffsetAfterCutoff;\r\n  const minYmd = addCalendarDays(year, month, day, startOffsetDays);\r\n  const maxYmd = addCalendarDays(minYmd.year, minYmd.month, minYmd.day, windowDays);\r\n\r\n  return {\r\n    min: istDateTime(minYmd.year, minYmd.month, minYmd.day, 0, 0, 0, 0),\r\n    max: istDateTime(maxYmd.year, maxYmd.month, maxYmd.day, 23, 59, 59, 999),\r\n  };\r\n}\r\n"]}

package/dist/format/index.cjs

@@ -0,0 +1,136 @@
+'use strict';
+
+// src/internal/validation.ts
+function assertFiniteNumber(value, name) {
+  if (typeof value !== "number" || !Number.isFinite(value)) {
+    throw new TypeError(`${name} must be a finite number`);
+  }
+}
+
+// src/format/index.ts
+var DEFAULT_LOCALE = "en-IN";
+var DEFAULT_TIME_ZONE = "Asia/Kolkata";
+var FILE_SIZE_UNITS = ["Bytes", "KB", "MB", "GB", "TB", "PB"];
+function formatDateTime(value, options = {}) {
+  if (value == null || value === "") {
+    return null;
+  }
+  const date = value instanceof Date ? value : new Date(value);
+  if (Number.isNaN(date.getTime())) {
+    return null;
+  }
+  const { locale = DEFAULT_LOCALE, ...intlOptions } = options;
+  if (typeof locale !== "string" || locale.trim().length === 0) {
+    throw new TypeError("locale must be a non-empty BCP 47 locale tag");
+  }
+  return new Intl.DateTimeFormat(locale, {
+    timeZone: DEFAULT_TIME_ZONE,
+    day: "2-digit",
+    month: "short",
+    year: "numeric",
+    hour: "2-digit",
+    minute: "2-digit",
+    second: "2-digit",
+    hour12: true,
+    ...intlOptions
+  }).format(date);
+}
+function formatFileSize(bytes, decimals = 2) {
+  assertFiniteNumber(bytes, "bytes");
+  if (bytes < 0) {
+    throw new RangeError("bytes must be greater than or equal to 0");
+  }
+  if (!Number.isInteger(decimals) || decimals < 0 || decimals > 8) {
+    throw new RangeError("decimals must be an integer between 0 and 8");
+  }
+  if (bytes === 0) {
+    return "0 Bytes";
+  }
+  const unitIndex = Math.min(
+    Math.floor(Math.log(bytes) / Math.log(1024)),
+    FILE_SIZE_UNITS.length - 1
+  );
+  const value = bytes / 1024 ** unitIndex;
+  const unit = FILE_SIZE_UNITS[unitIndex] ?? "Bytes";
+  return `${Number(value.toFixed(decimals))} ${unit}`;
+}
+function formatDuration(seconds) {
+  assertFiniteNumber(seconds, "seconds");
+  if (seconds <= 0) {
+    return "0 sec";
+  }
+  const total = Math.floor(seconds);
+  const hours = Math.floor(total / 3600);
+  const minutes = Math.floor(total % 3600 / 60);
+  const remainingSeconds = total % 60;
+  const parts = [];
+  if (hours > 0) {
+    parts.push(`${hours} hr`);
+  }
+  if (minutes > 0) {
+    parts.push(`${minutes} min`);
+  }
+  if (remainingSeconds > 0 || parts.length === 0) {
+    parts.push(`${remainingSeconds} sec`);
+  }
+  return parts.join(" ");
+}
+function formatDurationCompact(value, options = {}) {
+  assertFiniteNumber(value, "value");
+  const unit = options.unit ?? "seconds";
+  if (unit !== "seconds" && unit !== "milliseconds") {
+    throw new TypeError('unit must be "seconds" or "milliseconds"');
+  }
+  let remaining = Math.floor(unit === "milliseconds" ? value / 1e3 : value);
+  if (remaining <= 0) {
+    return "0s";
+  }
+  const years = Math.floor(remaining / 31536e3);
+  remaining %= 31536e3;
+  const months = Math.floor(remaining / 2592e3);
+  remaining %= 2592e3;
+  const days = Math.floor(remaining / 86400);
+  remaining %= 86400;
+  const hours = Math.floor(remaining / 3600);
+  remaining %= 3600;
+  const minutes = Math.floor(remaining / 60);
+  const seconds = remaining % 60;
+  const parts = [];
+  if (years > 0) {
+    parts.push(`${years}y`);
+  }
+  if (months > 0) {
+    parts.push(`${months}mo`);
+  }
+  if (days > 0) {
+    parts.push(`${days}d`);
+  }
+  if (hours > 0) {
+    parts.push(`${hours}h`);
+  }
+  if (minutes > 0) {
+    parts.push(`${minutes}m`);
+  }
+  if (seconds > 0 || parts.length === 0) {
+    parts.push(`${seconds}s`);
+  }
+  return parts.join(" ");
+}
+function formatPriceToLakh(price, decimals = 2) {
+  if (!Number.isInteger(decimals) || decimals < 0 || decimals > 8) {
+    throw new RangeError("decimals must be an integer between 0 and 8");
+  }
+  const numeric = typeof price === "number" ? price : typeof price === "string" ? Number(price.trim()) : Number.NaN;
+  if (!Number.isFinite(numeric)) {
+    return "";
+  }
+  return `${(numeric / 1e5).toFixed(decimals)} Lakh`;
+}
+
+exports.formatDateTime = formatDateTime;
+exports.formatDuration = formatDuration;
+exports.formatDurationCompact = formatDurationCompact;
+exports.formatFileSize = formatFileSize;
+exports.formatPriceToLakh = formatPriceToLakh;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/format/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/internal/validation.ts","../../src/format/index.ts"],"names":[],"mappings":"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","file":"index.cjs","sourcesContent":["export function assertFiniteNumber(\r\n  value: unknown,\r\n  name: string,\r\n): asserts value is number {\r\n  if (typeof value !== \"number\" || !Number.isFinite(value)) {\r\n    throw new TypeError(`${name} must be a finite number`);\r\n  }\r\n}\r\n\r\nexport function escapeRegExp(value: string): string {\r\n  return value.replace(/[.*+?^${}()|[\\]\\\\]/g, \"\\\\$&\");\r\n}\r\n","import { assertFiniteNumber } from \"../internal/validation.js\";\r\n\r\nconst DEFAULT_LOCALE = \"en-IN\";\r\nconst DEFAULT_TIME_ZONE = \"Asia/Kolkata\";\r\nconst FILE_SIZE_UNITS = [\"Bytes\", \"KB\", \"MB\", \"GB\", \"TB\", \"PB\"] as const;\r\n\r\nexport interface FormatDateTimeOptions extends Intl.DateTimeFormatOptions {\r\n  locale?: string;\r\n}\r\n\r\nexport interface FormatDurationOptions {\r\n  /**\r\n   * Interpret `value` as milliseconds instead of seconds.\r\n   * @default \"seconds\"\r\n   */\r\n  unit?: \"seconds\" | \"milliseconds\";\r\n}\r\n\r\n/**\r\n * Formats a date with `Intl.DateTimeFormat`.\r\n * Defaults to `en-IN` in the `Asia/Kolkata` time zone, including time.\r\n * Returns `null` for missing or invalid values.\r\n *\r\n * @example\r\n * formatDateTime(\"2024-01-15T00:00:00.000Z\")\r\n * formatDateTime(date, { hour: undefined, minute: undefined, second: undefined })\r\n */\r\nexport function formatDateTime(\r\n  value: Date | string | number | null | undefined,\r\n  options: FormatDateTimeOptions = {},\r\n): string | null {\r\n  if (value == null || value === \"\") {\r\n    return null;\r\n  }\r\n\r\n  const date = value instanceof Date ? value : new Date(value);\r\n  if (Number.isNaN(date.getTime())) {\r\n    return null;\r\n  }\r\n\r\n  const { locale = DEFAULT_LOCALE, ...intlOptions } = options;\r\n  if (typeof locale !== \"string\" || locale.trim().length === 0) {\r\n    throw new TypeError(\"locale must be a non-empty BCP 47 locale tag\");\r\n  }\r\n\r\n  return new Intl.DateTimeFormat(locale, {\r\n    timeZone: DEFAULT_TIME_ZONE,\r\n    day: \"2-digit\",\r\n    month: \"short\",\r\n    year: \"numeric\",\r\n    hour: \"2-digit\",\r\n    minute: \"2-digit\",\r\n    second: \"2-digit\",\r\n    hour12: true,\r\n    ...intlOptions,\r\n  }).format(date);\r\n}\r\n\r\n/**\r\n * Formats a byte count as a human-readable file size.\r\n *\r\n * @example\r\n * formatFileSize(0) // \"0 Bytes\"\r\n * formatFileSize(1536) // \"1.5 KB\"\r\n */\r\nexport function formatFileSize(bytes: number, decimals = 2): string {\r\n  assertFiniteNumber(bytes, \"bytes\");\r\n  if (bytes < 0) {\r\n    throw new RangeError(\"bytes must be greater than or equal to 0\");\r\n  }\r\n\r\n  if (!Number.isInteger(decimals) || decimals < 0 || decimals > 8) {\r\n    throw new RangeError(\"decimals must be an integer between 0 and 8\");\r\n  }\r\n\r\n  if (bytes === 0) {\r\n    return \"0 Bytes\";\r\n  }\r\n\r\n  const unitIndex = Math.min(\r\n    Math.floor(Math.log(bytes) / Math.log(1024)),\r\n    FILE_SIZE_UNITS.length - 1,\r\n  );\r\n  const value = bytes / 1024 ** unitIndex;\r\n  const unit = FILE_SIZE_UNITS[unitIndex] ?? \"Bytes\";\r\n\r\n  return `${Number(value.toFixed(decimals))} ${unit}`;\r\n}\r\n\r\n/**\r\n * Formats a duration in hours, minutes, and seconds.\r\n *\r\n * @example\r\n * formatDuration(3661) // \"1 hr 1 min 1 sec\"\r\n * formatDuration(0) // \"0 sec\"\r\n */\r\nexport function formatDuration(seconds: number): string {\r\n  assertFiniteNumber(seconds, \"seconds\");\r\n\r\n  if (seconds <= 0) {\r\n    return \"0 sec\";\r\n  }\r\n\r\n  const total = Math.floor(seconds);\r\n  const hours = Math.floor(total / 3600);\r\n  const minutes = Math.floor((total % 3600) / 60);\r\n  const remainingSeconds = total % 60;\r\n\r\n  const parts: string[] = [];\r\n  if (hours > 0) {\r\n    parts.push(`${hours} hr`);\r\n  }\r\n  if (minutes > 0) {\r\n    parts.push(`${minutes} min`);\r\n  }\r\n  if (remainingSeconds > 0 || parts.length === 0) {\r\n    parts.push(`${remainingSeconds} sec`);\r\n  }\r\n\r\n  return parts.join(\" \");\r\n}\r\n\r\n/**\r\n * Formats a duration as a compact `y d h m s` string.\r\n * Month and year units use fixed 30-day and 365-day approximations.\r\n *\r\n * @example\r\n * formatDurationCompact(3661) // \"1h 1m 1s\"\r\n * formatDurationCompact(1500, { unit: \"milliseconds\" }) // \"1s\"\r\n */\r\nexport function formatDurationCompact(\r\n  value: number,\r\n  options: FormatDurationOptions = {},\r\n): string {\r\n  assertFiniteNumber(value, \"value\");\r\n\r\n  const unit = options.unit ?? \"seconds\";\r\n  if (unit !== \"seconds\" && unit !== \"milliseconds\") {\r\n    throw new TypeError('unit must be \"seconds\" or \"milliseconds\"');\r\n  }\r\n\r\n  let remaining = Math.floor(unit === \"milliseconds\" ? value / 1000 : value);\r\n  if (remaining <= 0) {\r\n    return \"0s\";\r\n  }\r\n\r\n  const years = Math.floor(remaining / 31_536_000);\r\n  remaining %= 31_536_000;\r\n  const months = Math.floor(remaining / 2_592_000);\r\n  remaining %= 2_592_000;\r\n  const days = Math.floor(remaining / 86_400);\r\n  remaining %= 86_400;\r\n  const hours = Math.floor(remaining / 3600);\r\n  remaining %= 3600;\r\n  const minutes = Math.floor(remaining / 60);\r\n  const seconds = remaining % 60;\r\n\r\n  const parts: string[] = [];\r\n  if (years > 0) {\r\n    parts.push(`${years}y`);\r\n  }\r\n  if (months > 0) {\r\n    parts.push(`${months}mo`);\r\n  }\r\n  if (days > 0) {\r\n    parts.push(`${days}d`);\r\n  }\r\n  if (hours > 0) {\r\n    parts.push(`${hours}h`);\r\n  }\r\n  if (minutes > 0) {\r\n    parts.push(`${minutes}m`);\r\n  }\r\n  if (seconds > 0 || parts.length === 0) {\r\n    parts.push(`${seconds}s`);\r\n  }\r\n\r\n  return parts.join(\" \");\r\n}\r\n\r\n/**\r\n * Formats a price in Indian lakh units.\r\n * Returns an empty string for missing or invalid values.\r\n *\r\n * @example\r\n * formatPriceToLakh(2_000_000) // \"20.00 Lakh\"\r\n */\r\nexport function formatPriceToLakh(price: unknown, decimals = 2): string {\r\n  if (!Number.isInteger(decimals) || decimals < 0 || decimals > 8) {\r\n    throw new RangeError(\"decimals must be an integer between 0 and 8\");\r\n  }\r\n\r\n  const numeric =\r\n    typeof price === \"number\"\r\n      ? price\r\n      : typeof price === \"string\"\r\n        ? Number(price.trim())\r\n        : Number.NaN;\r\n\r\n  if (!Number.isFinite(numeric)) {\r\n    return \"\";\r\n  }\r\n\r\n  return `${(numeric / 100_000).toFixed(decimals)} Lakh`;\r\n}\r\n"]}