@vielzeug/toolkit 1.1.3 → 2.1.0

package/dist/date/interval.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"interval.cjs","sources":["../../src/date/interval.ts"],"sourcesContent":["import { assert } from '../function/assert';\nimport { isDate } from '../typed/isDate';\n\n// #region IntervalTypes\ntype IntervalType = 'D' | 'W' | 'M' | 'MS' | 'ME' | 'Y' | 'YS' | 'YE';\ntype IntervalOptions = {\n  interval?: IntervalType;\n  steps?: number;\n  latest?: boolean;\n};\n// #endregion IntervalTypes\n\n/**\n * Generates an array of dates between a start and end date, with a specified interval and step size.\n *\n * @example\n * ```ts\n * const options = { interval: 'D', steps: 1, latest: false };\n *\n * interval('2022-01-01', '2022-01-31', options); // Returns an array of dates for every day in January 2022\n * ```\n *\n * @param start - The start date (Date object or ISO string).\n * @param end - The end date (Date object or ISO string).\n * @param options - Options for an interval and steps.\n *\n * @returns An array of generated dates.\n */\nexport function interval(\n  start: Date | string,\n  end: Date | string,\n  { interval = 'D', steps = 1, latest = false }: IntervalOptions = {},\n): Date[] {\n  const startDate = new Date(start);\n  const endDate = new Date(end);\n\n  assert([isDate(startDate), isDate(endDate)], 'Invalid date format. Use a valid Date object or ISO string.', {\n    args: { end, start },\n    type: TypeError,\n  });\n\n  const dateArray: Date[] = [];\n  let currentDate = new Date(incrementDate(startDate, interval, 0));\n\n  while (currentDate <= endDate) {\n    dateArray.push(currentDate);\n    currentDate = new Date(incrementDate(currentDate, interval, steps));\n  }\n\n  if (latest && dateArray.length > 0 && dateArray[dateArray.length - 1] < endDate) {\n    dateArray.push(endDate);\n  }\n\n  return dateArray;\n}\n\nfunction incrementDate(date: Date, interval: IntervalType, steps: number): Date {\n  const year = date.getFullYear();\n  const month = date.getMonth();\n  const day = date.getDate();\n\n  switch (interval) {\n    case 'D':\n      return new Date(Date.UTC(year, month, day + steps));\n    case 'W':\n      return new Date(Date.UTC(year, month, day + 7 * steps));\n    case 'M':\n      return new Date(Date.UTC(year, month + steps, day));\n    case 'MS':\n      return new Date(Date.UTC(year, month + steps, 1));\n    case 'ME':\n      return new Date(Date.UTC(year, month + steps + 1, 0));\n    case 'Y':\n      return new Date(Date.UTC(year + steps, month, day));\n    case 'YS':\n      return new Date(Date.UTC(year + steps, 0, 1));\n    case 'YE':\n      return new Date(Date.UTC(year + steps, 11, 31));\n  }\n}\n"],"names":["interval","start","end","steps","latest","startDate","endDate","assert","isDate","dateArray","currentDate","incrementDate","date","year","month","day"],"mappings":"2JA4BO,SAASA,EACdC,EACAC,EACA,CAAE,SAAAF,EAAW,IAAK,MAAAG,EAAQ,EAAG,OAAAC,EAAS,EAAA,EAA2B,CAAA,EACzD,CACR,MAAMC,EAAY,IAAI,KAAKJ,CAAK,EAC1BK,EAAU,IAAI,KAAKJ,CAAG,EAE5BK,EAAAA,OAAO,CAACC,EAAAA,OAAOH,CAAS,EAAGG,EAAAA,OAAOF,CAAO,CAAC,EAAG,8DAA+D,CAC1G,KAAM,CAAE,IAAAJ,EAAK,MAAAD,CAAA,EACb,KAAM,SAAA,CACP,EAED,MAAMQ,EAAoB,CAAA,EAC1B,IAAIC,EAAc,IAAI,KAAKC,EAAcN,EAAWL,EAAU,CAAC,CAAC,EAEhE,KAAOU,GAAeJ,GACpBG,EAAU,KAAKC,CAAW,EAC1BA,EAAc,IAAI,KAAKC,EAAcD,EAAaV,EAAUG,CAAK,CAAC,EAGpE,OAAIC,GAAUK,EAAU,OAAS,GAAKA,EAAUA,EAAU,OAAS,CAAC,EAAIH,GACtEG,EAAU,KAAKH,CAAO,EAGjBG,CACT,CAEA,SAASE,EAAcC,EAAYZ,EAAwBG,EAAqB,CAC9E,MAAMU,EAAOD,EAAK,YAAA,EACZE,EAAQF,EAAK,SAAA,EACbG,EAAMH,EAAK,QAAA,EAEjB,OAAQZ,EAAAA,CACN,IAAK,IACH,OAAO,IAAI,KAAK,KAAK,IAAIa,EAAMC,EAAOC,EAAMZ,CAAK,CAAC,EACpD,IAAK,IACH,OAAO,IAAI,KAAK,KAAK,IAAIU,EAAMC,EAAOC,EAAM,EAAIZ,CAAK,CAAC,EACxD,IAAK,IACH,OAAO,IAAI,KAAK,KAAK,IAAIU,EAAMC,EAAQX,EAAOY,CAAG,CAAC,EACpD,IAAK,KACH,OAAO,IAAI,KAAK,KAAK,IAAIF,EAAMC,EAAQX,EAAO,CAAC,CAAC,EAClD,IAAK,KACH,OAAO,IAAI,KAAK,KAAK,IAAIU,EAAMC,EAAQX,EAAQ,EAAG,CAAC,CAAC,EACtD,IAAK,IACH,OAAO,IAAI,KAAK,KAAK,IAAIU,EAAOV,EAAOW,EAAOC,CAAG,CAAC,EACpD,IAAK,KACH,OAAO,IAAI,KAAK,KAAK,IAAIF,EAAOV,EAAO,EAAG,CAAC,CAAC,EAC9C,IAAK,KACH,OAAO,IAAI,KAAK,KAAK,IAAIU,EAAOV,EAAO,GAAI,EAAE,CAAC,CAAA,CAEpD"}
+{"version":3,"file":"interval.cjs","names":[],"sources":["../../src/date/interval.ts"],"sourcesContent":["import { assertAll } from '../function/assert';\nimport { isDate } from '../typed/isDate';\n\n// #region IntervalTypes\ntype IntervalType = 'day' | 'week' | 'month' | 'monthStart' | 'monthEnd' | 'year' | 'yearStart' | 'yearEnd';\ntype IntervalOptions = {\n  interval?: IntervalType;\n  latest?: boolean;\n  steps?: number;\n};\n// #endregion IntervalTypes\n\n/**\n * Generates an array of dates between a start and end date, with a specified interval and step size.\n *\n * @example\n * ```ts\n * const options = { interval: 'day', steps: 1, latest: false };\n *\n * interval('2022-01-01', '2022-01-31', options); // Returns an array of dates for every day in January 2022\n * ```\n *\n * @param start - The start date (Date object or ISO string).\n * @param end - The end date (Date object or ISO string).\n * @param options - Options for an interval and steps.\n *\n * @returns An array of generated dates.\n */\nexport function interval(\n  start: Date | string,\n  end: Date | string,\n  { interval = 'day', latest = false, steps = 1 }: IntervalOptions = {},\n): Date[] {\n  const startDate = new Date(start);\n  const endDate = new Date(end);\n\n  assertAll([isDate(startDate), isDate(endDate)], 'Invalid date format. Use a valid Date object or ISO string.', {\n    args: { end, start },\n    type: TypeError,\n  });\n\n  const dateArray: Date[] = [];\n  let currentDate = new Date(incrementDate(startDate, interval, 0));\n\n  while (currentDate <= endDate) {\n    dateArray.push(currentDate);\n    currentDate = new Date(incrementDate(currentDate, interval, steps));\n  }\n\n  if (latest && dateArray.length > 0 && dateArray[dateArray.length - 1] < endDate) {\n    dateArray.push(endDate);\n  }\n\n  return dateArray;\n}\n\nfunction incrementDate(date: Date, interval: IntervalType, steps: number): Date {\n  const year = date.getFullYear();\n  const month = date.getMonth();\n  const day = date.getDate();\n\n  switch (interval) {\n    case 'day':\n      return new Date(Date.UTC(year, month, day + steps));\n    case 'month':\n      return new Date(Date.UTC(year, month + steps, day));\n    case 'monthEnd':\n      return new Date(Date.UTC(year, month + steps + 1, 0));\n    case 'monthStart':\n      return new Date(Date.UTC(year, month + steps, 1));\n    case 'week':\n      return new Date(Date.UTC(year, month, day + 7 * steps));\n    case 'year':\n      return new Date(Date.UTC(year + steps, month, day));\n    case 'yearEnd':\n      return new Date(Date.UTC(year + steps, 11, 31));\n    case 'yearStart':\n      return new Date(Date.UTC(year + steps, 0, 1));\n  }\n}\n"],"mappings":"2EA4BA,SAAgB,EACd,EACA,EACA,CAAE,WAAW,MAAO,SAAS,GAAO,QAAQ,GAAuB,EAAE,CAC7D,CACR,IAAM,EAAY,IAAI,KAAK,EAAM,CAC3B,EAAU,IAAI,KAAK,EAAI,CAE7B,EAAA,UAAU,CAAC,EAAA,OAAO,EAAU,CAAE,EAAA,OAAO,EAAQ,CAAC,CAAE,8DAA+D,CAC7G,KAAM,CAAE,MAAK,QAAO,CACpB,KAAM,UACP,CAAC,CAEF,IAAM,EAAoB,EAAE,CACxB,EAAc,IAAI,KAAK,EAAc,EAAW,EAAU,EAAE,CAAC,CAEjE,KAAO,GAAe,GACpB,EAAU,KAAK,EAAY,CAC3B,EAAc,IAAI,KAAK,EAAc,EAAa,EAAU,EAAM,CAAC,CAOrE,OAJI,GAAU,EAAU,OAAS,GAAK,EAAU,EAAU,OAAS,GAAK,GACtE,EAAU,KAAK,EAAQ,CAGlB,EAGT,SAAS,EAAc,EAAY,EAAwB,EAAqB,CAC9E,IAAM,EAAO,EAAK,aAAa,CACzB,EAAQ,EAAK,UAAU,CACvB,EAAM,EAAK,SAAS,CAE1B,OAAQ,EAAR,CACE,IAAK,MACH,OAAO,IAAI,KAAK,KAAK,IAAI,EAAM,EAAO,EAAM,EAAM,CAAC,CACrD,IAAK,QACH,OAAO,IAAI,KAAK,KAAK,IAAI,EAAM,EAAQ,EAAO,EAAI,CAAC,CACrD,IAAK,WACH,OAAO,IAAI,KAAK,KAAK,IAAI,EAAM,EAAQ,EAAQ,EAAG,EAAE,CAAC,CACvD,IAAK,aACH,OAAO,IAAI,KAAK,KAAK,IAAI,EAAM,EAAQ,EAAO,EAAE,CAAC,CACnD,IAAK,OACH,OAAO,IAAI,KAAK,KAAK,IAAI,EAAM,EAAO,EAAM,EAAI,EAAM,CAAC,CACzD,IAAK,OACH,OAAO,IAAI,KAAK,KAAK,IAAI,EAAO,EAAO,EAAO,EAAI,CAAC,CACrD,IAAK,UACH,OAAO,IAAI,KAAK,KAAK,IAAI,EAAO,EAAO,GAAI,GAAG,CAAC,CACjD,IAAK,YACH,OAAO,IAAI,KAAK,KAAK,IAAI,EAAO,EAAO,EAAG,EAAE,CAAC"}

package/dist/date/interval.d.ts

@@ -0,0 +1,25 @@
+type IntervalType = 'day' | 'week' | 'month' | 'monthStart' | 'monthEnd' | 'year' | 'yearStart' | 'yearEnd';
+type IntervalOptions = {
+    interval?: IntervalType;
+    latest?: boolean;
+    steps?: number;
+};
+/**
+ * Generates an array of dates between a start and end date, with a specified interval and step size.
+ *
+ * @example
+ * ```ts
+ * const options = { interval: 'day', steps: 1, latest: false };
+ *
+ * interval('2022-01-01', '2022-01-31', options); // Returns an array of dates for every day in January 2022
+ * ```
+ *
+ * @param start - The start date (Date object or ISO string).
+ * @param end - The end date (Date object or ISO string).
+ * @param options - Options for an interval and steps.
+ *
+ * @returns An array of generated dates.
+ */
+export declare function interval(start: Date | string, end: Date | string, { interval, latest, steps }?: IntervalOptions): Date[];
+export {};
+//# sourceMappingURL=interval.d.ts.map

package/dist/date/interval.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interval.d.ts","sourceRoot":"","sources":["../../src/date/interval.ts"],"names":[],"mappings":"AAIA,KAAK,YAAY,GAAG,KAAK,GAAG,MAAM,GAAG,OAAO,GAAG,YAAY,GAAG,UAAU,GAAG,MAAM,GAAG,WAAW,GAAG,SAAS,CAAC;AAC5G,KAAK,eAAe,GAAG;IACrB,QAAQ,CAAC,EAAE,YAAY,CAAC;IACxB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAGF;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,QAAQ,CACtB,KAAK,EAAE,IAAI,GAAG,MAAM,EACpB,GAAG,EAAE,IAAI,GAAG,MAAM,EAClB,EAAE,QAAgB,EAAE,MAAc,EAAE,KAAS,EAAE,GAAE,eAAoB,GACpE,IAAI,EAAE,CAsBR"}

package/dist/date/interval.js

@@ -1,39 +1,33 @@
-import { assert as l } from "../function/assert.js";
-import { isDate as w } from "../typed/isDate.js";
-function U(r, c, { interval: e = "D", steps: t = 1, latest: a = !1 } = {}) {
-  const n = new Date(r), o = new Date(c);
-  l([w(n), w(o)], "Invalid date format. Use a valid Date object or ISO string.", {
-    args: { end: c, start: r },
-    type: TypeError
-  });
-  const D = [];
-  let u = new Date(i(n, e, 0));
-  for (; u <= o; )
-    D.push(u), u = new Date(i(u, e, t));
-  return a && D.length > 0 && D[D.length - 1] < o && D.push(o), D;
+import { assertAll as e } from "../function/assert.js";
+import { isDate as t } from "../typed/isDate.js";
+//#region src/date/interval.ts
+function n(n, i, { interval: a = "day", latest: o = !1, steps: s = 1 } = {}) {
+	let c = new Date(n), l = new Date(i);
+	e([t(c), t(l)], "Invalid date format. Use a valid Date object or ISO string.", {
+		args: {
+			end: i,
+			start: n
+		},
+		type: TypeError
+	});
+	let u = [], d = new Date(r(c, a, 0));
+	for (; d <= l;) u.push(d), d = new Date(r(d, a, s));
+	return o && u.length > 0 && u[u.length - 1] < l && u.push(l), u;
 }
-function i(r, c, e) {
-  const t = r.getFullYear(), a = r.getMonth(), n = r.getDate();
-  switch (c) {
-    case "D":
-      return new Date(Date.UTC(t, a, n + e));
-    case "W":
-      return new Date(Date.UTC(t, a, n + 7 * e));
-    case "M":
-      return new Date(Date.UTC(t, a + e, n));
-    case "MS":
-      return new Date(Date.UTC(t, a + e, 1));
-    case "ME":
-      return new Date(Date.UTC(t, a + e + 1, 0));
-    case "Y":
-      return new Date(Date.UTC(t + e, a, n));
-    case "YS":
-      return new Date(Date.UTC(t + e, 0, 1));
-    case "YE":
-      return new Date(Date.UTC(t + e, 11, 31));
-  }
+function r(e, t, n) {
+	let r = e.getFullYear(), i = e.getMonth(), a = e.getDate();
+	switch (t) {
+		case "day": return new Date(Date.UTC(r, i, a + n));
+		case "month": return new Date(Date.UTC(r, i + n, a));
+		case "monthEnd": return new Date(Date.UTC(r, i + n + 1, 0));
+		case "monthStart": return new Date(Date.UTC(r, i + n, 1));
+		case "week": return new Date(Date.UTC(r, i, a + 7 * n));
+		case "year": return new Date(Date.UTC(r + n, i, a));
+		case "yearEnd": return new Date(Date.UTC(r + n, 11, 31));
+		case "yearStart": return new Date(Date.UTC(r + n, 0, 1));
+	}
 }
-export {
-  U as interval
-};
-//# sourceMappingURL=interval.js.map
+//#endregion
+export { n as interval };
+
+//# sourceMappingURL=interval.js.map

package/dist/date/interval.js.map

@@ -1 +1 @@
-{"version":3,"file":"interval.js","sources":["../../src/date/interval.ts"],"sourcesContent":["import { assert } from '../function/assert';\nimport { isDate } from '../typed/isDate';\n\n// #region IntervalTypes\ntype IntervalType = 'D' | 'W' | 'M' | 'MS' | 'ME' | 'Y' | 'YS' | 'YE';\ntype IntervalOptions = {\n  interval?: IntervalType;\n  steps?: number;\n  latest?: boolean;\n};\n// #endregion IntervalTypes\n\n/**\n * Generates an array of dates between a start and end date, with a specified interval and step size.\n *\n * @example\n * ```ts\n * const options = { interval: 'D', steps: 1, latest: false };\n *\n * interval('2022-01-01', '2022-01-31', options); // Returns an array of dates for every day in January 2022\n * ```\n *\n * @param start - The start date (Date object or ISO string).\n * @param end - The end date (Date object or ISO string).\n * @param options - Options for an interval and steps.\n *\n * @returns An array of generated dates.\n */\nexport function interval(\n  start: Date | string,\n  end: Date | string,\n  { interval = 'D', steps = 1, latest = false }: IntervalOptions = {},\n): Date[] {\n  const startDate = new Date(start);\n  const endDate = new Date(end);\n\n  assert([isDate(startDate), isDate(endDate)], 'Invalid date format. Use a valid Date object or ISO string.', {\n    args: { end, start },\n    type: TypeError,\n  });\n\n  const dateArray: Date[] = [];\n  let currentDate = new Date(incrementDate(startDate, interval, 0));\n\n  while (currentDate <= endDate) {\n    dateArray.push(currentDate);\n    currentDate = new Date(incrementDate(currentDate, interval, steps));\n  }\n\n  if (latest && dateArray.length > 0 && dateArray[dateArray.length - 1] < endDate) {\n    dateArray.push(endDate);\n  }\n\n  return dateArray;\n}\n\nfunction incrementDate(date: Date, interval: IntervalType, steps: number): Date {\n  const year = date.getFullYear();\n  const month = date.getMonth();\n  const day = date.getDate();\n\n  switch (interval) {\n    case 'D':\n      return new Date(Date.UTC(year, month, day + steps));\n    case 'W':\n      return new Date(Date.UTC(year, month, day + 7 * steps));\n    case 'M':\n      return new Date(Date.UTC(year, month + steps, day));\n    case 'MS':\n      return new Date(Date.UTC(year, month + steps, 1));\n    case 'ME':\n      return new Date(Date.UTC(year, month + steps + 1, 0));\n    case 'Y':\n      return new Date(Date.UTC(year + steps, month, day));\n    case 'YS':\n      return new Date(Date.UTC(year + steps, 0, 1));\n    case 'YE':\n      return new Date(Date.UTC(year + steps, 11, 31));\n  }\n}\n"],"names":["interval","start","end","steps","latest","startDate","endDate","assert","isDate","dateArray","currentDate","incrementDate","date","year","month","day"],"mappings":";;AA4BO,SAASA,EACdC,GACAC,GACA,EAAE,UAAAF,IAAW,KAAK,OAAAG,IAAQ,GAAG,QAAAC,IAAS,GAAA,IAA2B,CAAA,GACzD;AACR,QAAMC,IAAY,IAAI,KAAKJ,CAAK,GAC1BK,IAAU,IAAI,KAAKJ,CAAG;AAE5B,EAAAK,EAAO,CAACC,EAAOH,CAAS,GAAGG,EAAOF,CAAO,CAAC,GAAG,+DAA+D;AAAA,IAC1G,MAAM,EAAE,KAAAJ,GAAK,OAAAD,EAAA;AAAA,IACb,MAAM;AAAA,EAAA,CACP;AAED,QAAMQ,IAAoB,CAAA;AAC1B,MAAIC,IAAc,IAAI,KAAKC,EAAcN,GAAWL,GAAU,CAAC,CAAC;AAEhE,SAAOU,KAAeJ;AACpB,IAAAG,EAAU,KAAKC,CAAW,GAC1BA,IAAc,IAAI,KAAKC,EAAcD,GAAaV,GAAUG,CAAK,CAAC;AAGpE,SAAIC,KAAUK,EAAU,SAAS,KAAKA,EAAUA,EAAU,SAAS,CAAC,IAAIH,KACtEG,EAAU,KAAKH,CAAO,GAGjBG;AACT;AAEA,SAASE,EAAcC,GAAYZ,GAAwBG,GAAqB;AAC9E,QAAMU,IAAOD,EAAK,YAAA,GACZE,IAAQF,EAAK,SAAA,GACbG,IAAMH,EAAK,QAAA;AAEjB,UAAQZ,GAAAA;AAAAA,IACN,KAAK;AACH,aAAO,IAAI,KAAK,KAAK,IAAIa,GAAMC,GAAOC,IAAMZ,CAAK,CAAC;AAAA,IACpD,KAAK;AACH,aAAO,IAAI,KAAK,KAAK,IAAIU,GAAMC,GAAOC,IAAM,IAAIZ,CAAK,CAAC;AAAA,IACxD,KAAK;AACH,aAAO,IAAI,KAAK,KAAK,IAAIU,GAAMC,IAAQX,GAAOY,CAAG,CAAC;AAAA,IACpD,KAAK;AACH,aAAO,IAAI,KAAK,KAAK,IAAIF,GAAMC,IAAQX,GAAO,CAAC,CAAC;AAAA,IAClD,KAAK;AACH,aAAO,IAAI,KAAK,KAAK,IAAIU,GAAMC,IAAQX,IAAQ,GAAG,CAAC,CAAC;AAAA,IACtD,KAAK;AACH,aAAO,IAAI,KAAK,KAAK,IAAIU,IAAOV,GAAOW,GAAOC,CAAG,CAAC;AAAA,IACpD,KAAK;AACH,aAAO,IAAI,KAAK,KAAK,IAAIF,IAAOV,GAAO,GAAG,CAAC,CAAC;AAAA,IAC9C,KAAK;AACH,aAAO,IAAI,KAAK,KAAK,IAAIU,IAAOV,GAAO,IAAI,EAAE,CAAC;AAAA,EAAA;AAEpD;"}
+{"version":3,"file":"interval.js","names":[],"sources":["../../src/date/interval.ts"],"sourcesContent":["import { assertAll } from '../function/assert';\nimport { isDate } from '../typed/isDate';\n\n// #region IntervalTypes\ntype IntervalType = 'day' | 'week' | 'month' | 'monthStart' | 'monthEnd' | 'year' | 'yearStart' | 'yearEnd';\ntype IntervalOptions = {\n  interval?: IntervalType;\n  latest?: boolean;\n  steps?: number;\n};\n// #endregion IntervalTypes\n\n/**\n * Generates an array of dates between a start and end date, with a specified interval and step size.\n *\n * @example\n * ```ts\n * const options = { interval: 'day', steps: 1, latest: false };\n *\n * interval('2022-01-01', '2022-01-31', options); // Returns an array of dates for every day in January 2022\n * ```\n *\n * @param start - The start date (Date object or ISO string).\n * @param end - The end date (Date object or ISO string).\n * @param options - Options for an interval and steps.\n *\n * @returns An array of generated dates.\n */\nexport function interval(\n  start: Date | string,\n  end: Date | string,\n  { interval = 'day', latest = false, steps = 1 }: IntervalOptions = {},\n): Date[] {\n  const startDate = new Date(start);\n  const endDate = new Date(end);\n\n  assertAll([isDate(startDate), isDate(endDate)], 'Invalid date format. Use a valid Date object or ISO string.', {\n    args: { end, start },\n    type: TypeError,\n  });\n\n  const dateArray: Date[] = [];\n  let currentDate = new Date(incrementDate(startDate, interval, 0));\n\n  while (currentDate <= endDate) {\n    dateArray.push(currentDate);\n    currentDate = new Date(incrementDate(currentDate, interval, steps));\n  }\n\n  if (latest && dateArray.length > 0 && dateArray[dateArray.length - 1] < endDate) {\n    dateArray.push(endDate);\n  }\n\n  return dateArray;\n}\n\nfunction incrementDate(date: Date, interval: IntervalType, steps: number): Date {\n  const year = date.getFullYear();\n  const month = date.getMonth();\n  const day = date.getDate();\n\n  switch (interval) {\n    case 'day':\n      return new Date(Date.UTC(year, month, day + steps));\n    case 'month':\n      return new Date(Date.UTC(year, month + steps, day));\n    case 'monthEnd':\n      return new Date(Date.UTC(year, month + steps + 1, 0));\n    case 'monthStart':\n      return new Date(Date.UTC(year, month + steps, 1));\n    case 'week':\n      return new Date(Date.UTC(year, month, day + 7 * steps));\n    case 'year':\n      return new Date(Date.UTC(year + steps, month, day));\n    case 'yearEnd':\n      return new Date(Date.UTC(year + steps, 11, 31));\n    case 'yearStart':\n      return new Date(Date.UTC(year + steps, 0, 1));\n  }\n}\n"],"mappings":";;;AA4BA,SAAgB,EACd,GACA,GACA,EAAE,cAAW,OAAO,YAAS,IAAO,WAAQ,MAAuB,EAAE,EAC7D;CACR,IAAM,IAAY,IAAI,KAAK,EAAM,EAC3B,IAAU,IAAI,KAAK,EAAI;AAE7B,GAAU,CAAC,EAAO,EAAU,EAAE,EAAO,EAAQ,CAAC,EAAE,+DAA+D;EAC7G,MAAM;GAAE;GAAK;GAAO;EACpB,MAAM;EACP,CAAC;CAEF,IAAM,IAAoB,EAAE,EACxB,IAAc,IAAI,KAAK,EAAc,GAAW,GAAU,EAAE,CAAC;AAEjE,QAAO,KAAe,GAEpB,CADA,EAAU,KAAK,EAAY,EAC3B,IAAc,IAAI,KAAK,EAAc,GAAa,GAAU,EAAM,CAAC;AAOrE,QAJI,KAAU,EAAU,SAAS,KAAK,EAAU,EAAU,SAAS,KAAK,KACtE,EAAU,KAAK,EAAQ,EAGlB;;AAGT,SAAS,EAAc,GAAY,GAAwB,GAAqB;CAC9E,IAAM,IAAO,EAAK,aAAa,EACzB,IAAQ,EAAK,UAAU,EACvB,IAAM,EAAK,SAAS;AAE1B,SAAQ,GAAR;EACE,KAAK,MACH,QAAO,IAAI,KAAK,KAAK,IAAI,GAAM,GAAO,IAAM,EAAM,CAAC;EACrD,KAAK,QACH,QAAO,IAAI,KAAK,KAAK,IAAI,GAAM,IAAQ,GAAO,EAAI,CAAC;EACrD,KAAK,WACH,QAAO,IAAI,KAAK,KAAK,IAAI,GAAM,IAAQ,IAAQ,GAAG,EAAE,CAAC;EACvD,KAAK,aACH,QAAO,IAAI,KAAK,KAAK,IAAI,GAAM,IAAQ,GAAO,EAAE,CAAC;EACnD,KAAK,OACH,QAAO,IAAI,KAAK,KAAK,IAAI,GAAM,GAAO,IAAM,IAAI,EAAM,CAAC;EACzD,KAAK,OACH,QAAO,IAAI,KAAK,KAAK,IAAI,IAAO,GAAO,GAAO,EAAI,CAAC;EACrD,KAAK,UACH,QAAO,IAAI,KAAK,KAAK,IAAI,IAAO,GAAO,IAAI,GAAG,CAAC;EACjD,KAAK,YACH,QAAO,IAAI,KAAK,KAAK,IAAI,IAAO,GAAO,GAAG,EAAE,CAAC"}

package/dist/date/timeDiff.cjs

@@ -1,2 +1,2 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});let c=["YEAR","MONTH","WEEK","DAY","HOUR","MINUTE","SECOND"];const f=1e3,N=60*f,m=60*N,n=24*m,D=7*n,_=30*n,S=365*n,R=[{ms:S,unit:"YEAR"},{ms:_,unit:"MONTH"},{ms:D,unit:"WEEK"},{ms:n,unit:"DAY"},{ms:m,unit:"HOUR"},{ms:N,unit:"MINUTE"},{ms:f,unit:"SECOND"}];function M(t,e=new Date,l=c){const o=typeof t=="string"?Date.parse(t):t.getTime(),a=typeof e=="string"?Date.parse(e):e.getTime();if(Number.isNaN(o)||Number.isNaN(a))return{unit:"INVALID_DATE",value:0};const i=R.filter(E=>l.includes(E.unit)),s=Math.abs(o-a),r=i[i.length-1]?.unit??"SECOND";if(s<=0)return{unit:r,value:0};const u=i.find(E=>s>=E.ms);return u?{unit:u.unit,value:Math.floor(s/u.ms)}:{unit:r,value:0}}M.defaultUnits=t=>{c=t};exports.timeDiff=M;
-//# sourceMappingURL=timeDiff.cjs.map
+var e=[`year`,`month`,`week`,`day`,`hour`,`minute`,`second`],t=1e3,n=60*t,r=60*n,i=24*r,a=7*i,o=30*i,s=[{ms:365*i,unit:`year`},{ms:o,unit:`month`},{ms:a,unit:`week`},{ms:i,unit:`day`},{ms:r,unit:`hour`},{ms:n,unit:`minute`},{ms:t,unit:`second`}];function c(t,n=new Date,r=e){let i=typeof t==`string`?Date.parse(t):t.getTime(),a=typeof n==`string`?Date.parse(n):n.getTime();if(Number.isNaN(i)||Number.isNaN(a))return;let o=s.filter(e=>r.includes(e.unit)),c=Math.abs(i-a),l=o[o.length-1]?.unit??`second`;if(c<=0)return{unit:l,value:0};let u=o.find(e=>c>=e.ms);return u?{unit:u.unit,value:Math.floor(c/u.ms)}:{unit:l,value:0}}exports.timeDiff=c;
+//# sourceMappingURL=timeDiff.cjs.map

package/dist/date/timeDiff.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"timeDiff.cjs","sources":["../../src/date/timeDiff.ts"],"sourcesContent":["// #region TimeDiffTypes\nexport type TimeUnit = 'YEAR' | 'MONTH' | 'WEEK' | 'DAY' | 'HOUR' | 'MINUTE' | 'SECOND' | 'INVALID_DATE';\nexport type TimeDirection = 'FUTURE' | 'PAST';\nexport type TimeResult = { unit: TimeUnit; value: number };\n// #endregion TimeDiffTypes\n\nlet defaultUnits: TimeUnit[] = ['YEAR', 'MONTH', 'WEEK', 'DAY', 'HOUR', 'MINUTE', 'SECOND'];\n\nconst MS_PER_SECOND = 1000;\nconst MS_PER_MINUTE = 60 * MS_PER_SECOND;\nconst MS_PER_HOUR = 60 * MS_PER_MINUTE;\nconst MS_PER_DAY = 24 * MS_PER_HOUR;\nconst MS_PER_WEEK = 7 * MS_PER_DAY;\nconst MS_PER_MONTH = 30 * MS_PER_DAY;\nconst MS_PER_YEAR = 365 * MS_PER_DAY;\n\nconst TIME_UNITS = [\n  { ms: MS_PER_YEAR, unit: 'YEAR' as const },\n  { ms: MS_PER_MONTH, unit: 'MONTH' as const },\n  { ms: MS_PER_WEEK, unit: 'WEEK' as const },\n  { ms: MS_PER_DAY, unit: 'DAY' as const },\n  { ms: MS_PER_HOUR, unit: 'HOUR' as const },\n  { ms: MS_PER_MINUTE, unit: 'MINUTE' as const },\n  { ms: MS_PER_SECOND, unit: 'SECOND' as const },\n];\n\n/**\n * Calculates the remaining time until a target date.\n *\n * @example\n * ```ts\n * timeDiff(new Date(Date.now() + 1000 * 60 * 60 * 24 * 5)); // { value: 5, unit: 'DAY' }\n * timeDiff(new Date(Date.now() - 1000 * 60 * 60 * 24 * 3), 'past'); // { value: 3, unit: 'DAY' }\n * timeDiff(new Date(Date.now() + 1000 * 60 * 60 * 24 * 31)); // { value: 1, unit: 'MONTH' }\n * timeDiff(new Date(Date.now() + 1000 * 60 * 60 * 24 * 365)); // { value: 1, unit: 'YEAR' }\n * ```\n *\n * @param a - The target date (Date object or ISO string).\n * @param b - The target date (Date object or ISO string).\n * @param allowedUnits - (optional) array of units to filter the result. If provided, only these units will be considered.\n *\n * @returns An object containing the remaining time and its unit ('DAY', 'HOUR', or 'MINUTE').\n */\nexport function timeDiff(\n  a: Date | string,\n  b: Date | string = new Date(),\n  allowedUnits: TimeUnit[] = defaultUnits,\n): TimeResult {\n  const aDate = typeof a === 'string' ? Date.parse(a) : a.getTime();\n  const bDate = typeof b === 'string' ? Date.parse(b) : b.getTime();\n\n  if (Number.isNaN(aDate) || Number.isNaN(bDate)) {\n    return { unit: 'INVALID_DATE', value: 0 };\n  }\n\n  const units = TIME_UNITS.filter((u) => allowedUnits.includes(u.unit));\n  const diff = Math.abs(aDate - bDate);\n  const smallestUnit = units[units.length - 1]?.unit ?? 'SECOND';\n\n  if (diff <= 0) {\n    return { unit: smallestUnit, value: 0 };\n  }\n\n  // Find the largest unit that fits\n  const bestUnit = units.find((u) => diff >= u.ms);\n\n  if (bestUnit) {\n    return { unit: bestUnit.unit, value: Math.floor(diff / bestUnit.ms) };\n  }\n\n  return { unit: smallestUnit, value: 0 };\n}\n\ntimeDiff.defaultUnits = (units: TimeUnit[]) => {\n  defaultUnits = units;\n};\n"],"names":["defaultUnits","MS_PER_SECOND","MS_PER_MINUTE","MS_PER_HOUR","MS_PER_DAY","MS_PER_WEEK","MS_PER_MONTH","MS_PER_YEAR","TIME_UNITS","timeDiff","a","b","allowedUnits","aDate","bDate","units","u","diff","smallestUnit","bestUnit"],"mappings":"gFAMA,IAAIA,EAA2B,CAAC,OAAQ,QAAS,OAAQ,MAAO,OAAQ,SAAU,QAAQ,EAE1F,MAAMC,EAAgB,IAChBC,EAAgB,GAAKD,EACrBE,EAAc,GAAKD,EACnBE,EAAa,GAAKD,EAClBE,EAAc,EAAID,EAClBE,EAAe,GAAKF,EACpBG,EAAc,IAAMH,EAEpBI,EAAa,CACjB,CAAE,GAAID,EAAa,KAAM,MAAA,EACzB,CAAE,GAAID,EAAc,KAAM,OAAA,EAC1B,CAAE,GAAID,EAAa,KAAM,MAAA,EACzB,CAAE,GAAID,EAAY,KAAM,KAAA,EACxB,CAAE,GAAID,EAAa,KAAM,MAAA,EACzB,CAAE,GAAID,EAAe,KAAM,QAAA,EAC3B,CAAE,GAAID,EAAe,KAAM,QAAA,CAC7B,EAmBO,SAASQ,EACdC,EACAC,MAAuB,KACvBC,EAA2BZ,EACf,CACZ,MAAMa,EAAQ,OAAOH,GAAM,SAAW,KAAK,MAAMA,CAAC,EAAIA,EAAE,QAAA,EAClDI,EAAQ,OAAOH,GAAM,SAAW,KAAK,MAAMA,CAAC,EAAIA,EAAE,QAAA,EAExD,GAAI,OAAO,MAAME,CAAK,GAAK,OAAO,MAAMC,CAAK,EAC3C,MAAO,CAAE,KAAM,eAAgB,MAAO,CAAA,EAGxC,MAAMC,EAAQP,EAAW,OAAQQ,GAAMJ,EAAa,SAASI,EAAE,IAAI,CAAC,EAC9DC,EAAO,KAAK,IAAIJ,EAAQC,CAAK,EAC7BI,EAAeH,EAAMA,EAAM,OAAS,CAAC,GAAG,MAAQ,SAEtD,GAAIE,GAAQ,EACV,MAAO,CAAE,KAAMC,EAAc,MAAO,CAAA,EAItC,MAAMC,EAAWJ,EAAM,KAAMC,GAAMC,GAAQD,EAAE,EAAE,EAE/C,OAAIG,EACK,CAAE,KAAMA,EAAS,KAAM,MAAO,KAAK,MAAMF,EAAOE,EAAS,EAAE,CAAA,EAG7D,CAAE,KAAMD,EAAc,MAAO,CAAA,CACtC,CAEAT,EAAS,aAAgBM,GAAsB,CAC7Cf,EAAee,CACjB"}
+{"version":3,"file":"timeDiff.cjs","names":[],"sources":["../../src/date/timeDiff.ts"],"sourcesContent":["// #region TimeDiffTypes\nexport type TimeUnit = 'year' | 'month' | 'week' | 'day' | 'hour' | 'minute' | 'second';\nexport type TimeResult = { unit: TimeUnit; value: number };\n// #endregion TimeDiffTypes\n\nconst ALL_UNITS: TimeUnit[] = ['year', 'month', 'week', 'day', 'hour', 'minute', 'second'];\n\nconst MS_PER_SECOND = 1000;\nconst MS_PER_MINUTE = 60 * MS_PER_SECOND;\nconst MS_PER_HOUR = 60 * MS_PER_MINUTE;\nconst MS_PER_DAY = 24 * MS_PER_HOUR;\nconst MS_PER_WEEK = 7 * MS_PER_DAY;\nconst MS_PER_MONTH = 30 * MS_PER_DAY;\nconst MS_PER_YEAR = 365 * MS_PER_DAY;\n\nconst TIME_UNITS = [\n  { ms: MS_PER_YEAR, unit: 'year' as const },\n  { ms: MS_PER_MONTH, unit: 'month' as const },\n  { ms: MS_PER_WEEK, unit: 'week' as const },\n  { ms: MS_PER_DAY, unit: 'day' as const },\n  { ms: MS_PER_HOUR, unit: 'hour' as const },\n  { ms: MS_PER_MINUTE, unit: 'minute' as const },\n  { ms: MS_PER_SECOND, unit: 'second' as const },\n];\n\n/**\n * Calculates the remaining time until a target date.\n *\n * @example\n * ```ts\n * timeDiff(new Date(Date.now() + 1000 * 60 * 60 * 24 * 5)); // { value: 5, unit: 'day' }\n * timeDiff(new Date(Date.now() - 1000 * 60 * 60 * 24 * 3), 'past'); // { value: 3, unit: 'day' }\n * timeDiff(new Date(Date.now() + 1000 * 60 * 60 * 24 * 31)); // { value: 1, unit: 'month' }\n * timeDiff(new Date(Date.now() + 1000 * 60 * 60 * 24 * 365)); // { value: 1, unit: 'year' }\n * ```\n *\n * @param a - The target date (Date object or ISO string).\n * @param b - The target date (Date object or ISO string).\n * @param allowedUnits - (optional) array of units to filter the result. If provided, only these units will be considered.\n *\n * @returns An object containing the remaining time and its unit ('DAY', 'HOUR', or 'MINUTE').\n */\nexport function timeDiff(\n  a: Date | string,\n  b: Date | string = new Date(),\n  allowedUnits: TimeUnit[] = ALL_UNITS,\n): TimeResult | undefined {\n  const aDate = typeof a === 'string' ? Date.parse(a) : a.getTime();\n  const bDate = typeof b === 'string' ? Date.parse(b) : b.getTime();\n\n  if (Number.isNaN(aDate) || Number.isNaN(bDate)) {\n    return undefined;\n  }\n\n  const units = TIME_UNITS.filter((u) => allowedUnits.includes(u.unit));\n  const diff = Math.abs(aDate - bDate);\n  const smallestUnit = units[units.length - 1]?.unit ?? 'second';\n\n  if (diff <= 0) {\n    return { unit: smallestUnit, value: 0 };\n  }\n\n  // Find the largest unit that fits\n  const bestUnit = units.find((u) => diff >= u.ms);\n\n  if (bestUnit) {\n    return { unit: bestUnit.unit, value: Math.floor(diff / bestUnit.ms) };\n  }\n\n  return { unit: smallestUnit, value: 0 };\n}\n"],"mappings":"AAKA,IAAM,EAAwB,CAAC,OAAQ,QAAS,OAAQ,MAAO,OAAQ,SAAU,SAAS,CAEpF,EAAgB,IAChB,EAAgB,GAAK,EACrB,EAAc,GAAK,EACnB,EAAa,GAAK,EAClB,EAAc,EAAI,EAClB,EAAe,GAAK,EAGpB,EAAa,CACjB,CAAE,GAHgB,IAAM,EAGL,KAAM,OAAiB,CAC1C,CAAE,GAAI,EAAc,KAAM,QAAkB,CAC5C,CAAE,GAAI,EAAa,KAAM,OAAiB,CAC1C,CAAE,GAAI,EAAY,KAAM,MAAgB,CACxC,CAAE,GAAI,EAAa,KAAM,OAAiB,CAC1C,CAAE,GAAI,EAAe,KAAM,SAAmB,CAC9C,CAAE,GAAI,EAAe,KAAM,SAAmB,CAC/C,CAmBD,SAAgB,EACd,EACA,EAAmB,IAAI,KACvB,EAA2B,EACH,CACxB,IAAM,EAAQ,OAAO,GAAM,SAAW,KAAK,MAAM,EAAE,CAAG,EAAE,SAAS,CAC3D,EAAQ,OAAO,GAAM,SAAW,KAAK,MAAM,EAAE,CAAG,EAAE,SAAS,CAEjE,GAAI,OAAO,MAAM,EAAM,EAAI,OAAO,MAAM,EAAM,CAC5C,OAGF,IAAM,EAAQ,EAAW,OAAQ,GAAM,EAAa,SAAS,EAAE,KAAK,CAAC,CAC/D,EAAO,KAAK,IAAI,EAAQ,EAAM,CAC9B,EAAe,EAAM,EAAM,OAAS,IAAI,MAAQ,SAEtD,GAAI,GAAQ,EACV,MAAO,CAAE,KAAM,EAAc,MAAO,EAAG,CAIzC,IAAM,EAAW,EAAM,KAAM,GAAM,GAAQ,EAAE,GAAG,CAMhD,OAJI,EACK,CAAE,KAAM,EAAS,KAAM,MAAO,KAAK,MAAM,EAAO,EAAS,GAAG,CAAE,CAGhE,CAAE,KAAM,EAAc,MAAO,EAAG"}

package/dist/date/timeDiff.d.ts

@@ -0,0 +1,24 @@
+export type TimeUnit = 'year' | 'month' | 'week' | 'day' | 'hour' | 'minute' | 'second';
+export type TimeResult = {
+    unit: TimeUnit;
+    value: number;
+};
+/**
+ * Calculates the remaining time until a target date.
+ *
+ * @example
+ * ```ts
+ * timeDiff(new Date(Date.now() + 1000 * 60 * 60 * 24 * 5)); // { value: 5, unit: 'day' }
+ * timeDiff(new Date(Date.now() - 1000 * 60 * 60 * 24 * 3), 'past'); // { value: 3, unit: 'day' }
+ * timeDiff(new Date(Date.now() + 1000 * 60 * 60 * 24 * 31)); // { value: 1, unit: 'month' }
+ * timeDiff(new Date(Date.now() + 1000 * 60 * 60 * 24 * 365)); // { value: 1, unit: 'year' }
+ * ```
+ *
+ * @param a - The target date (Date object or ISO string).
+ * @param b - The target date (Date object or ISO string).
+ * @param allowedUnits - (optional) array of units to filter the result. If provided, only these units will be considered.
+ *
+ * @returns An object containing the remaining time and its unit ('DAY', 'HOUR', or 'MINUTE').
+ */
+export declare function timeDiff(a: Date | string, b?: Date | string, allowedUnits?: TimeUnit[]): TimeResult | undefined;
+//# sourceMappingURL=timeDiff.d.ts.map

package/dist/date/timeDiff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeDiff.d.ts","sourceRoot":"","sources":["../../src/date/timeDiff.ts"],"names":[],"mappings":"AACA,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,KAAK,GAAG,MAAM,GAAG,QAAQ,GAAG,QAAQ,CAAC;AACxF,MAAM,MAAM,UAAU,GAAG;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAuB3D;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,QAAQ,CACtB,CAAC,EAAE,IAAI,GAAG,MAAM,EAChB,CAAC,GAAE,IAAI,GAAG,MAAmB,EAC7B,YAAY,GAAE,QAAQ,EAAc,GACnC,UAAU,GAAG,SAAS,CAwBxB"}

package/dist/date/timeDiff.js

@@ -1,27 +1,60 @@
-let R = ["YEAR", "MONTH", "WEEK", "DAY", "HOUR", "MINUTE", "SECOND"];
-const N = [
-  { ms: 31536e6, unit: "YEAR" },
-  { ms: 2592e6, unit: "MONTH" },
-  { ms: 6048e5, unit: "WEEK" },
-  { ms: 864e5, unit: "DAY" },
-  { ms: 36e5, unit: "HOUR" },
-  { ms: 6e4, unit: "MINUTE" },
-  { ms: 1e3, unit: "SECOND" }
+//#region src/date/timeDiff.ts
+var e = [
+	"year",
+	"month",
+	"week",
+	"day",
+	"hour",
+	"minute",
+	"second"
+], t = 1e3, n = 60 * t, r = 60 * n, i = 24 * r, a = 7 * i, o = 30 * i, s = [
+	{
+		ms: 365 * i,
+		unit: "year"
+	},
+	{
+		ms: o,
+		unit: "month"
+	},
+	{
+		ms: a,
+		unit: "week"
+	},
+	{
+		ms: i,
+		unit: "day"
+	},
+	{
+		ms: r,
+		unit: "hour"
+	},
+	{
+		ms: n,
+		unit: "minute"
+	},
+	{
+		ms: t,
+		unit: "second"
+	}
 ];
-function D(t, n = /* @__PURE__ */ new Date(), S = R) {
-  const i = typeof t == "string" ? Date.parse(t) : t.getTime(), M = typeof n == "string" ? Date.parse(n) : n.getTime();
-  if (Number.isNaN(i) || Number.isNaN(M))
-    return { unit: "INVALID_DATE", value: 0 };
-  const E = N.filter((e) => S.includes(e.unit)), _ = Math.abs(i - M), u = E[E.length - 1]?.unit ?? "SECOND";
-  if (_ <= 0)
-    return { unit: u, value: 0 };
-  const s = E.find((e) => _ >= e.ms);
-  return s ? { unit: s.unit, value: Math.floor(_ / s.ms) } : { unit: u, value: 0 };
+function c(t, n = /* @__PURE__ */ new Date(), r = e) {
+	let i = typeof t == "string" ? Date.parse(t) : t.getTime(), a = typeof n == "string" ? Date.parse(n) : n.getTime();
+	if (Number.isNaN(i) || Number.isNaN(a)) return;
+	let o = s.filter((e) => r.includes(e.unit)), c = Math.abs(i - a), l = o[o.length - 1]?.unit ?? "second";
+	if (c <= 0) return {
+		unit: l,
+		value: 0
+	};
+	let u = o.find((e) => c >= e.ms);
+	return u ? {
+		unit: u.unit,
+		value: Math.floor(c / u.ms)
+	} : {
+		unit: l,
+		value: 0
+	};
 }
-D.defaultUnits = (t) => {
-  R = t;
-};
-export {
-  D as timeDiff
-};
-//# sourceMappingURL=timeDiff.js.map
+//#endregion
+export { c as timeDiff };
+
+//# sourceMappingURL=timeDiff.js.map

package/dist/date/timeDiff.js.map

@@ -1 +1 @@
-{"version":3,"file":"timeDiff.js","sources":["../../src/date/timeDiff.ts"],"sourcesContent":["// #region TimeDiffTypes\nexport type TimeUnit = 'YEAR' | 'MONTH' | 'WEEK' | 'DAY' | 'HOUR' | 'MINUTE' | 'SECOND' | 'INVALID_DATE';\nexport type TimeDirection = 'FUTURE' | 'PAST';\nexport type TimeResult = { unit: TimeUnit; value: number };\n// #endregion TimeDiffTypes\n\nlet defaultUnits: TimeUnit[] = ['YEAR', 'MONTH', 'WEEK', 'DAY', 'HOUR', 'MINUTE', 'SECOND'];\n\nconst MS_PER_SECOND = 1000;\nconst MS_PER_MINUTE = 60 * MS_PER_SECOND;\nconst MS_PER_HOUR = 60 * MS_PER_MINUTE;\nconst MS_PER_DAY = 24 * MS_PER_HOUR;\nconst MS_PER_WEEK = 7 * MS_PER_DAY;\nconst MS_PER_MONTH = 30 * MS_PER_DAY;\nconst MS_PER_YEAR = 365 * MS_PER_DAY;\n\nconst TIME_UNITS = [\n  { ms: MS_PER_YEAR, unit: 'YEAR' as const },\n  { ms: MS_PER_MONTH, unit: 'MONTH' as const },\n  { ms: MS_PER_WEEK, unit: 'WEEK' as const },\n  { ms: MS_PER_DAY, unit: 'DAY' as const },\n  { ms: MS_PER_HOUR, unit: 'HOUR' as const },\n  { ms: MS_PER_MINUTE, unit: 'MINUTE' as const },\n  { ms: MS_PER_SECOND, unit: 'SECOND' as const },\n];\n\n/**\n * Calculates the remaining time until a target date.\n *\n * @example\n * ```ts\n * timeDiff(new Date(Date.now() + 1000 * 60 * 60 * 24 * 5)); // { value: 5, unit: 'DAY' }\n * timeDiff(new Date(Date.now() - 1000 * 60 * 60 * 24 * 3), 'past'); // { value: 3, unit: 'DAY' }\n * timeDiff(new Date(Date.now() + 1000 * 60 * 60 * 24 * 31)); // { value: 1, unit: 'MONTH' }\n * timeDiff(new Date(Date.now() + 1000 * 60 * 60 * 24 * 365)); // { value: 1, unit: 'YEAR' }\n * ```\n *\n * @param a - The target date (Date object or ISO string).\n * @param b - The target date (Date object or ISO string).\n * @param allowedUnits - (optional) array of units to filter the result. If provided, only these units will be considered.\n *\n * @returns An object containing the remaining time and its unit ('DAY', 'HOUR', or 'MINUTE').\n */\nexport function timeDiff(\n  a: Date | string,\n  b: Date | string = new Date(),\n  allowedUnits: TimeUnit[] = defaultUnits,\n): TimeResult {\n  const aDate = typeof a === 'string' ? Date.parse(a) : a.getTime();\n  const bDate = typeof b === 'string' ? Date.parse(b) : b.getTime();\n\n  if (Number.isNaN(aDate) || Number.isNaN(bDate)) {\n    return { unit: 'INVALID_DATE', value: 0 };\n  }\n\n  const units = TIME_UNITS.filter((u) => allowedUnits.includes(u.unit));\n  const diff = Math.abs(aDate - bDate);\n  const smallestUnit = units[units.length - 1]?.unit ?? 'SECOND';\n\n  if (diff <= 0) {\n    return { unit: smallestUnit, value: 0 };\n  }\n\n  // Find the largest unit that fits\n  const bestUnit = units.find((u) => diff >= u.ms);\n\n  if (bestUnit) {\n    return { unit: bestUnit.unit, value: Math.floor(diff / bestUnit.ms) };\n  }\n\n  return { unit: smallestUnit, value: 0 };\n}\n\ntimeDiff.defaultUnits = (units: TimeUnit[]) => {\n  defaultUnits = units;\n};\n"],"names":["defaultUnits","TIME_UNITS","timeDiff","a","b","allowedUnits","aDate","bDate","units","u","diff","smallestUnit","bestUnit"],"mappings":"AAMA,IAAIA,IAA2B,CAAC,QAAQ,SAAS,QAAQ,OAAO,QAAQ,UAAU,QAAQ;AAU1F,MAAMC,IAAa;AAAA,EACjB,EAAE,IAAI,SAAa,MAAM,OAAA;AAAA,EACzB,EAAE,IAAI,QAAc,MAAM,QAAA;AAAA,EAC1B,EAAE,IAAI,QAAa,MAAM,OAAA;AAAA,EACzB,EAAE,IAAI,OAAY,MAAM,MAAA;AAAA,EACxB,EAAE,IAAI,MAAa,MAAM,OAAA;AAAA,EACzB,EAAE,IAAI,KAAe,MAAM,SAAA;AAAA,EAC3B,EAAE,IAAI,KAAe,MAAM,SAAA;AAC7B;AAmBO,SAASC,EACdC,GACAC,wBAAuB,KAAA,GACvBC,IAA2BL,GACf;AACZ,QAAMM,IAAQ,OAAOH,KAAM,WAAW,KAAK,MAAMA,CAAC,IAAIA,EAAE,QAAA,GAClDI,IAAQ,OAAOH,KAAM,WAAW,KAAK,MAAMA,CAAC,IAAIA,EAAE,QAAA;AAExD,MAAI,OAAO,MAAME,CAAK,KAAK,OAAO,MAAMC,CAAK;AAC3C,WAAO,EAAE,MAAM,gBAAgB,OAAO,EAAA;AAGxC,QAAMC,IAAQP,EAAW,OAAO,CAACQ,MAAMJ,EAAa,SAASI,EAAE,IAAI,CAAC,GAC9DC,IAAO,KAAK,IAAIJ,IAAQC,CAAK,GAC7BI,IAAeH,EAAMA,EAAM,SAAS,CAAC,GAAG,QAAQ;AAEtD,MAAIE,KAAQ;AACV,WAAO,EAAE,MAAMC,GAAc,OAAO,EAAA;AAItC,QAAMC,IAAWJ,EAAM,KAAK,CAACC,MAAMC,KAAQD,EAAE,EAAE;AAE/C,SAAIG,IACK,EAAE,MAAMA,EAAS,MAAM,OAAO,KAAK,MAAMF,IAAOE,EAAS,EAAE,EAAA,IAG7D,EAAE,MAAMD,GAAc,OAAO,EAAA;AACtC;AAEAT,EAAS,eAAe,CAACM,MAAsB;AAC7C,EAAAR,IAAeQ;AACjB;"}
+{"version":3,"file":"timeDiff.js","names":[],"sources":["../../src/date/timeDiff.ts"],"sourcesContent":["// #region TimeDiffTypes\nexport type TimeUnit = 'year' | 'month' | 'week' | 'day' | 'hour' | 'minute' | 'second';\nexport type TimeResult = { unit: TimeUnit; value: number };\n// #endregion TimeDiffTypes\n\nconst ALL_UNITS: TimeUnit[] = ['year', 'month', 'week', 'day', 'hour', 'minute', 'second'];\n\nconst MS_PER_SECOND = 1000;\nconst MS_PER_MINUTE = 60 * MS_PER_SECOND;\nconst MS_PER_HOUR = 60 * MS_PER_MINUTE;\nconst MS_PER_DAY = 24 * MS_PER_HOUR;\nconst MS_PER_WEEK = 7 * MS_PER_DAY;\nconst MS_PER_MONTH = 30 * MS_PER_DAY;\nconst MS_PER_YEAR = 365 * MS_PER_DAY;\n\nconst TIME_UNITS = [\n  { ms: MS_PER_YEAR, unit: 'year' as const },\n  { ms: MS_PER_MONTH, unit: 'month' as const },\n  { ms: MS_PER_WEEK, unit: 'week' as const },\n  { ms: MS_PER_DAY, unit: 'day' as const },\n  { ms: MS_PER_HOUR, unit: 'hour' as const },\n  { ms: MS_PER_MINUTE, unit: 'minute' as const },\n  { ms: MS_PER_SECOND, unit: 'second' as const },\n];\n\n/**\n * Calculates the remaining time until a target date.\n *\n * @example\n * ```ts\n * timeDiff(new Date(Date.now() + 1000 * 60 * 60 * 24 * 5)); // { value: 5, unit: 'day' }\n * timeDiff(new Date(Date.now() - 1000 * 60 * 60 * 24 * 3), 'past'); // { value: 3, unit: 'day' }\n * timeDiff(new Date(Date.now() + 1000 * 60 * 60 * 24 * 31)); // { value: 1, unit: 'month' }\n * timeDiff(new Date(Date.now() + 1000 * 60 * 60 * 24 * 365)); // { value: 1, unit: 'year' }\n * ```\n *\n * @param a - The target date (Date object or ISO string).\n * @param b - The target date (Date object or ISO string).\n * @param allowedUnits - (optional) array of units to filter the result. If provided, only these units will be considered.\n *\n * @returns An object containing the remaining time and its unit ('DAY', 'HOUR', or 'MINUTE').\n */\nexport function timeDiff(\n  a: Date | string,\n  b: Date | string = new Date(),\n  allowedUnits: TimeUnit[] = ALL_UNITS,\n): TimeResult | undefined {\n  const aDate = typeof a === 'string' ? Date.parse(a) : a.getTime();\n  const bDate = typeof b === 'string' ? Date.parse(b) : b.getTime();\n\n  if (Number.isNaN(aDate) || Number.isNaN(bDate)) {\n    return undefined;\n  }\n\n  const units = TIME_UNITS.filter((u) => allowedUnits.includes(u.unit));\n  const diff = Math.abs(aDate - bDate);\n  const smallestUnit = units[units.length - 1]?.unit ?? 'second';\n\n  if (diff <= 0) {\n    return { unit: smallestUnit, value: 0 };\n  }\n\n  // Find the largest unit that fits\n  const bestUnit = units.find((u) => diff >= u.ms);\n\n  if (bestUnit) {\n    return { unit: bestUnit.unit, value: Math.floor(diff / bestUnit.ms) };\n  }\n\n  return { unit: smallestUnit, value: 0 };\n}\n"],"mappings":";AAKA,IAAM,IAAwB;CAAC;CAAQ;CAAS;CAAQ;CAAO;CAAQ;CAAU;CAAS,EAEpF,IAAgB,KAChB,IAAgB,KAAK,GACrB,IAAc,KAAK,GACnB,IAAa,KAAK,GAClB,IAAc,IAAI,GAClB,IAAe,KAAK,GAGpB,IAAa;CACjB;EAAE,IAHgB,MAAM;EAGL,MAAM;EAAiB;CAC1C;EAAE,IAAI;EAAc,MAAM;EAAkB;CAC5C;EAAE,IAAI;EAAa,MAAM;EAAiB;CAC1C;EAAE,IAAI;EAAY,MAAM;EAAgB;CACxC;EAAE,IAAI;EAAa,MAAM;EAAiB;CAC1C;EAAE,IAAI;EAAe,MAAM;EAAmB;CAC9C;EAAE,IAAI;EAAe,MAAM;EAAmB;CAC/C;AAmBD,SAAgB,EACd,GACA,oBAAmB,IAAI,MAAM,EAC7B,IAA2B,GACH;CACxB,IAAM,IAAQ,OAAO,KAAM,WAAW,KAAK,MAAM,EAAE,GAAG,EAAE,SAAS,EAC3D,IAAQ,OAAO,KAAM,WAAW,KAAK,MAAM,EAAE,GAAG,EAAE,SAAS;AAEjE,KAAI,OAAO,MAAM,EAAM,IAAI,OAAO,MAAM,EAAM,CAC5C;CAGF,IAAM,IAAQ,EAAW,QAAQ,MAAM,EAAa,SAAS,EAAE,KAAK,CAAC,EAC/D,IAAO,KAAK,IAAI,IAAQ,EAAM,EAC9B,IAAe,EAAM,EAAM,SAAS,IAAI,QAAQ;AAEtD,KAAI,KAAQ,EACV,QAAO;EAAE,MAAM;EAAc,OAAO;EAAG;CAIzC,IAAM,IAAW,EAAM,MAAM,MAAM,KAAQ,EAAE,GAAG;AAMhD,QAJI,IACK;EAAE,MAAM,EAAS;EAAM,OAAO,KAAK,MAAM,IAAO,EAAS,GAAG;EAAE,GAGhE;EAAE,MAAM;EAAc,OAAO;EAAG"}

package/dist/function/assert.cjs

@@ -1,3 +1,2 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const n=require("../logit/dist/logit.cjs");function f(e,t="Assertion failed",{type:l=Error,args:r,bypass:i=!1}={}){if(!(Array.isArray(e)?e.some(o=>!o):!e))return;const a=r?`
-Arguments: ${JSON.stringify(r,null,2)}`:"",s=`${t}${a}`;if(i)n.Logit.warn(s);else throw new l(s)}exports.assert=f;
-//# sourceMappingURL=assert.cjs.map
+function e(e,t=`Assertion failed`,{args:n,bypass:r=!1,type:i=Error}={}){if(e)return;let a=`${t}${n?`\nArguments: ${JSON.stringify(n,null,2)}`:``}`;if(r)console.warn(a);else throw new i(a)}function t(t,n=`Assertion failed`,r={}){e(t.every(Boolean),n,r)}exports.assert=e,exports.assertAll=t;
+//# sourceMappingURL=assert.cjs.map

package/dist/function/assert.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"assert.cjs","sources":["../../src/function/assert.ts"],"sourcesContent":["import { Logit } from '@vielzeug/logit';\nimport type { Obj } from '../types';\n\n/**\n * Asserts that the condition is true. If the condition is false, it throws an error\n * with the provided message or logs a warning in soft mode.\n *\n * @example\n * ```ts\n * assert(Array.isArray([])); // Does nothing\n * assert(typeof foo === 'string', 'This is an error message'); // Throws an error\n * assert(x > 0, 'x must be positive', { args: { x } }); // Throws with argument details\n * ```\n *\n * @param condition - The condition to assert, or an array of conditions.\n * @param [message] - The error message to throw. Default is 'Assertion failed'.\n * @param options - Assertion options.\n * @param [options.type] - The error class to throw (default: `Error`).\n * @param [options.args] - Additional debugging information (e.g., variable values).\n * @param [options.bypass] - If `true`, logs a warning instead of throwing an error.\n *\n * @throws {Error} If the condition is false and `bypass` is not set to `true`.\n */\nexport function assert(\n  condition: boolean | boolean[],\n  message = 'Assertion failed',\n  { type = Error, args, bypass = false }: { type?: ErrorConstructor; args?: Obj; bypass?: boolean } = {},\n): void {\n  const failed = Array.isArray(condition) ? condition.some((cond) => !cond) : !condition;\n  if (!failed) return;\n\n  const errorDetails = args ? `\\nArguments: ${JSON.stringify(args, null, 2)}` : '';\n  const fullMessage = `${message}${errorDetails}`;\n\n  if (bypass) Logit.warn(fullMessage);\n  else throw new type(fullMessage);\n}\n"],"names":["assert","condition","message","type","args","bypass","cond","errorDetails","fullMessage","Logit"],"mappings":"2HAuBO,SAASA,EACdC,EACAC,EAAU,mBACV,CAAE,KAAAC,EAAO,MAAO,KAAAC,EAAM,OAAAC,EAAS,EAAA,EAAqE,CAAA,EAC9F,CAEN,GAAI,EADW,MAAM,QAAQJ,CAAS,EAAIA,EAAU,KAAMK,GAAS,CAACA,CAAI,EAAI,CAACL,GAChE,OAEb,MAAMM,EAAeH,EAAO;AAAA,aAAgB,KAAK,UAAUA,EAAM,KAAM,CAAC,CAAC,GAAK,GACxEI,EAAc,GAAGN,CAAO,GAAGK,CAAY,GAE7C,GAAIF,EAAQI,EAAAA,MAAM,KAAKD,CAAW,MAC7B,OAAM,IAAIL,EAAKK,CAAW,CACjC"}
+{"version":3,"file":"assert.cjs","names":[],"sources":["../../src/function/assert.ts"],"sourcesContent":["import type { Obj } from '../types';\n\ntype AssertOptions = { args?: Obj; bypass?: boolean; type?: ErrorConstructor };\n\n/**\n * Asserts that a condition is true. Throws (or warns, with `bypass`) otherwise.\n *\n * @example\n * ```ts\n * assert(Array.isArray([]));                      // ok\n * assert(x > 0, 'x must be positive');            // throws if false\n * assert(x > 0, 'x must be positive', { args: { x } });\n * assert(ok, 'not ok', { bypass: true });         // logs warning instead of throwing\n * assertAll([cond1, cond2], 'One failed');         // throws if any is false\n * ```\n *\n * @param condition - The boolean condition to assert.\n * @param [message] - Error message (default: `'Assertion failed'`).\n * @param [options.type] - Error class to throw (default: `Error`).\n * @param [options.args] - Debugging info appended to the message.\n * @param [options.bypass] - Log a warning instead of throwing.\n *\n * @throws {Error} If `condition` is false and `bypass` is not set.\n */\nexport function assert(\n  condition: boolean,\n  message = 'Assertion failed',\n  { args, bypass = false, type = Error }: AssertOptions = {},\n): void {\n  if (condition) return;\n\n  const errorDetails = args ? `\\nArguments: ${JSON.stringify(args, null, 2)}` : '';\n  const fullMessage = `${message}${errorDetails}`;\n\n  if (bypass) console.warn(fullMessage);\n  else throw new type(fullMessage);\n}\n\n/**\n * Asserts that every condition in the array is true.\n *\n * @example\n * ```ts\n * assertAll([cond1, cond2, cond3], 'One or more conditions failed');\n * ```\n */\nexport function assertAll(conditions: boolean[], message = 'Assertion failed', options: AssertOptions = {}): void {\n  assert(conditions.every(Boolean), message, options);\n}\n"],"mappings":"AAwBA,SAAgB,EACd,EACA,EAAU,mBACV,CAAE,OAAM,SAAS,GAAO,OAAO,OAAyB,EAAE,CACpD,CACN,GAAI,EAAW,OAGf,IAAM,EAAc,GAAG,IADF,EAAO,gBAAgB,KAAK,UAAU,EAAM,KAAM,EAAE,GAAK,KAG9E,GAAI,EAAQ,QAAQ,KAAK,EAAY,MAChC,MAAM,IAAI,EAAK,EAAY,CAWlC,SAAgB,EAAU,EAAuB,EAAU,mBAAoB,EAAyB,EAAE,CAAQ,CAChH,EAAO,EAAW,MAAM,QAAQ,CAAE,EAAS,EAAQ"}

package/dist/function/assert.d.ts

@@ -0,0 +1,38 @@
+import type { Obj } from '../types';
+type AssertOptions = {
+    args?: Obj;
+    bypass?: boolean;
+    type?: ErrorConstructor;
+};
+/**
+ * Asserts that a condition is true. Throws (or warns, with `bypass`) otherwise.
+ *
+ * @example
+ * ```ts
+ * assert(Array.isArray([]));                      // ok
+ * assert(x > 0, 'x must be positive');            // throws if false
+ * assert(x > 0, 'x must be positive', { args: { x } });
+ * assert(ok, 'not ok', { bypass: true });         // logs warning instead of throwing
+ * assertAll([cond1, cond2], 'One failed');         // throws if any is false
+ * ```
+ *
+ * @param condition - The boolean condition to assert.
+ * @param [message] - Error message (default: `'Assertion failed'`).
+ * @param [options.type] - Error class to throw (default: `Error`).
+ * @param [options.args] - Debugging info appended to the message.
+ * @param [options.bypass] - Log a warning instead of throwing.
+ *
+ * @throws {Error} If `condition` is false and `bypass` is not set.
+ */
+export declare function assert(condition: boolean, message?: string, { args, bypass, type }?: AssertOptions): void;
+/**
+ * Asserts that every condition in the array is true.
+ *
+ * @example
+ * ```ts
+ * assertAll([cond1, cond2, cond3], 'One or more conditions failed');
+ * ```
+ */
+export declare function assertAll(conditions: boolean[], message?: string, options?: AssertOptions): void;
+export {};
+//# sourceMappingURL=assert.d.ts.map

package/dist/function/assert.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assert.d.ts","sourceRoot":"","sources":["../../src/function/assert.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAEpC,KAAK,aAAa,GAAG;IAAE,IAAI,CAAC,EAAE,GAAG,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAAC,IAAI,CAAC,EAAE,gBAAgB,CAAA;CAAE,CAAC;AAE/E;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,MAAM,CACpB,SAAS,EAAE,OAAO,EAClB,OAAO,SAAqB,EAC5B,EAAE,IAAI,EAAE,MAAc,EAAE,IAAY,EAAE,GAAE,aAAkB,GACzD,IAAI,CAQN;AAED;;;;;;;GAOG;AACH,wBAAgB,SAAS,CAAC,UAAU,EAAE,OAAO,EAAE,EAAE,OAAO,SAAqB,EAAE,OAAO,GAAE,aAAkB,GAAG,IAAI,CAEhH"}

package/dist/function/assert.js

@@ -1,12 +1,14 @@
-import { Logit as o } from "../logit/dist/logit.js";
-function m(r, t = "Assertion failed", { type: a = Error, args: e, bypass: f = !1 } = {}) {
-  if (!(Array.isArray(r) ? r.some((i) => !i) : !r)) return;
-  const l = e ? `
-Arguments: ${JSON.stringify(e, null, 2)}` : "", s = `${t}${l}`;
-  if (f) o.warn(s);
-  else throw new a(s);
+//#region src/function/assert.ts
+function e(e, t = "Assertion failed", { args: n, bypass: r = !1, type: i = Error } = {}) {
+	if (e) return;
+	let a = `${t}${n ? `\nArguments: ${JSON.stringify(n, null, 2)}` : ""}`;
+	if (r) console.warn(a);
+	else throw new i(a);
 }
-export {
-  m as assert
-};
-//# sourceMappingURL=assert.js.map
+function t(t, n = "Assertion failed", r = {}) {
+	e(t.every(Boolean), n, r);
+}
+//#endregion
+export { e as assert, t as assertAll };
+
+//# sourceMappingURL=assert.js.map

package/dist/function/assert.js.map

@@ -1 +1 @@
-{"version":3,"file":"assert.js","sources":["../../src/function/assert.ts"],"sourcesContent":["import { Logit } from '@vielzeug/logit';\nimport type { Obj } from '../types';\n\n/**\n * Asserts that the condition is true. If the condition is false, it throws an error\n * with the provided message or logs a warning in soft mode.\n *\n * @example\n * ```ts\n * assert(Array.isArray([])); // Does nothing\n * assert(typeof foo === 'string', 'This is an error message'); // Throws an error\n * assert(x > 0, 'x must be positive', { args: { x } }); // Throws with argument details\n * ```\n *\n * @param condition - The condition to assert, or an array of conditions.\n * @param [message] - The error message to throw. Default is 'Assertion failed'.\n * @param options - Assertion options.\n * @param [options.type] - The error class to throw (default: `Error`).\n * @param [options.args] - Additional debugging information (e.g., variable values).\n * @param [options.bypass] - If `true`, logs a warning instead of throwing an error.\n *\n * @throws {Error} If the condition is false and `bypass` is not set to `true`.\n */\nexport function assert(\n  condition: boolean | boolean[],\n  message = 'Assertion failed',\n  { type = Error, args, bypass = false }: { type?: ErrorConstructor; args?: Obj; bypass?: boolean } = {},\n): void {\n  const failed = Array.isArray(condition) ? condition.some((cond) => !cond) : !condition;\n  if (!failed) return;\n\n  const errorDetails = args ? `\\nArguments: ${JSON.stringify(args, null, 2)}` : '';\n  const fullMessage = `${message}${errorDetails}`;\n\n  if (bypass) Logit.warn(fullMessage);\n  else throw new type(fullMessage);\n}\n"],"names":["assert","condition","message","type","args","bypass","cond","errorDetails","fullMessage","Logit"],"mappings":";AAuBO,SAASA,EACdC,GACAC,IAAU,oBACV,EAAE,MAAAC,IAAO,OAAO,MAAAC,GAAM,QAAAC,IAAS,GAAA,IAAqE,CAAA,GAC9F;AAEN,MAAI,EADW,MAAM,QAAQJ,CAAS,IAAIA,EAAU,KAAK,CAACK,MAAS,CAACA,CAAI,IAAI,CAACL,GAChE;AAEb,QAAMM,IAAeH,IAAO;AAAA,aAAgB,KAAK,UAAUA,GAAM,MAAM,CAAC,CAAC,KAAK,IACxEI,IAAc,GAAGN,CAAO,GAAGK,CAAY;AAE7C,MAAIF,EAAQI,CAAAA,EAAM,KAAKD,CAAW;AAAA,MAC7B,OAAM,IAAIL,EAAKK,CAAW;AACjC;"}
+{"version":3,"file":"assert.js","names":[],"sources":["../../src/function/assert.ts"],"sourcesContent":["import type { Obj } from '../types';\n\ntype AssertOptions = { args?: Obj; bypass?: boolean; type?: ErrorConstructor };\n\n/**\n * Asserts that a condition is true. Throws (or warns, with `bypass`) otherwise.\n *\n * @example\n * ```ts\n * assert(Array.isArray([]));                      // ok\n * assert(x > 0, 'x must be positive');            // throws if false\n * assert(x > 0, 'x must be positive', { args: { x } });\n * assert(ok, 'not ok', { bypass: true });         // logs warning instead of throwing\n * assertAll([cond1, cond2], 'One failed');         // throws if any is false\n * ```\n *\n * @param condition - The boolean condition to assert.\n * @param [message] - Error message (default: `'Assertion failed'`).\n * @param [options.type] - Error class to throw (default: `Error`).\n * @param [options.args] - Debugging info appended to the message.\n * @param [options.bypass] - Log a warning instead of throwing.\n *\n * @throws {Error} If `condition` is false and `bypass` is not set.\n */\nexport function assert(\n  condition: boolean,\n  message = 'Assertion failed',\n  { args, bypass = false, type = Error }: AssertOptions = {},\n): void {\n  if (condition) return;\n\n  const errorDetails = args ? `\\nArguments: ${JSON.stringify(args, null, 2)}` : '';\n  const fullMessage = `${message}${errorDetails}`;\n\n  if (bypass) console.warn(fullMessage);\n  else throw new type(fullMessage);\n}\n\n/**\n * Asserts that every condition in the array is true.\n *\n * @example\n * ```ts\n * assertAll([cond1, cond2, cond3], 'One or more conditions failed');\n * ```\n */\nexport function assertAll(conditions: boolean[], message = 'Assertion failed', options: AssertOptions = {}): void {\n  assert(conditions.every(Boolean), message, options);\n}\n"],"mappings":";AAwBA,SAAgB,EACd,GACA,IAAU,oBACV,EAAE,SAAM,YAAS,IAAO,UAAO,UAAyB,EAAE,EACpD;AACN,KAAI,EAAW;CAGf,IAAM,IAAc,GAAG,IADF,IAAO,gBAAgB,KAAK,UAAU,GAAM,MAAM,EAAE,KAAK;AAG9E,KAAI,EAAQ,SAAQ,KAAK,EAAY;KAChC,OAAM,IAAI,EAAK,EAAY;;AAWlC,SAAgB,EAAU,GAAuB,IAAU,oBAAoB,IAAyB,EAAE,EAAQ;AAChH,GAAO,EAAW,MAAM,QAAQ,EAAE,GAAS,EAAQ"}

package/dist/function/assertParams.cjs

@@ -1,2 +1,2 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const n=require("./assert.cjs");function l(e,o,r,i={}){n.assert(!!e,"Missing parameters object",i);const t=o.filter(s=>e[s]===void 0||e[s]===null||e[s]==="");if(t.length>0){const s=r?` in "${r}"`:"",a=t.map(g=>`"${String(g)}"`).join(", "),c=`Missing required parameter${t.length>1?"s":""}: ${a}${s}`;n.assert(!1,c,i)}}exports.assertParams=l;
-//# sourceMappingURL=assertParams.cjs.map
+const e=require(`./assert.cjs`);function t(t,n,r,i={}){e.assert(!!t,`Missing parameters object`,i);let a=n.filter(e=>t[e]===void 0||t[e]===null);if(a.length>0){let t=r?` in "${r}"`:``,n=a.map(e=>`"${String(e)}"`).join(`, `);e.assert(!1,`Missing required parameter${a.length>1?`s`:``}: ${n}${t}`,i)}}exports.assertParams=t;
+//# sourceMappingURL=assertParams.cjs.map

package/dist/function/assertParams.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"assertParams.cjs","sources":["../../src/function/assertParams.ts"],"sourcesContent":["import { assert } from './assert';\n\n/**\n * Asserts that the specified keys are present in the params object and are not empty strings.\n *\n * @example\n * ```ts\n * const params = { id: '123', name: '' };\n * assertParams(params, ['id']); // Does nothing\n * assertParams(params, ['id', 'name'], 'UserUpdate'); // Throws: Missing required parameter: \"name\" in \"UserUpdate\"\n * ```\n *\n * @param params - The object containing the parameters to check.\n * @param keys - An array of keys that must be present and non-empty in the params object.\n * @param [name] - An optional name for the context of the assertion (e.g., function name).\n * @param [options] - Assertion options.\n * @param [options.type] - The error class to throw (default: `Error`).\n * @param [options.bypass] - If `true`, logs a warning instead of throwing an error.\n *\n * @throws {Error} If any of the required keys are missing or are empty strings.\n */\nexport function assertParams<T extends object, K extends keyof T>(\n  params: T,\n  keys: K[],\n  name?: string,\n  options: { type?: ErrorConstructor; bypass?: boolean } = {},\n): asserts params is T & Required<Pick<T, K>> {\n  assert(!!params, 'Missing parameters object', options);\n\n  const missing = keys.filter((key) => params[key] === undefined || params[key] === null || params[key] === '');\n\n  if (missing.length > 0) {\n    const context = name ? ` in \"${name}\"` : '';\n    const keysStr = missing.map((key) => `\"${String(key)}\"`).join(', ');\n    const message = `Missing required parameter${missing.length > 1 ? 's' : ''}: ${keysStr}${context}`;\n\n    assert(false, message, options);\n  }\n}\n"],"names":["assertParams","params","keys","name","options","assert","missing","key","context","keysStr","message"],"mappings":"gHAqBO,SAASA,EACdC,EACAC,EACAC,EACAC,EAAyD,CAAA,EACb,CAC5CC,EAAAA,OAAO,CAAC,CAACJ,EAAQ,4BAA6BG,CAAO,EAErD,MAAME,EAAUJ,EAAK,OAAQK,GAAQN,EAAOM,CAAG,IAAM,QAAaN,EAAOM,CAAG,IAAM,MAAQN,EAAOM,CAAG,IAAM,EAAE,EAE5G,GAAID,EAAQ,OAAS,EAAG,CACtB,MAAME,EAAUL,EAAO,QAAQA,CAAI,IAAM,GACnCM,EAAUH,EAAQ,IAAKC,GAAQ,IAAI,OAAOA,CAAG,CAAC,GAAG,EAAE,KAAK,IAAI,EAC5DG,EAAU,6BAA6BJ,EAAQ,OAAS,EAAI,IAAM,EAAE,KAAKG,CAAO,GAAGD,CAAO,GAEhGH,SAAO,GAAOK,EAASN,CAAO,CAChC,CACF"}
+{"version":3,"file":"assertParams.cjs","names":[],"sources":["../../src/function/assertParams.ts"],"sourcesContent":["import { assert } from './assert';\n\n/**\n * Asserts that the specified keys are present and non-null in the params object.\n *\n * @example\n * ```ts\n * const params = { id: '123', name: undefined };\n * assertParams(params, ['id']); // Does nothing\n * assertParams(params, ['id', 'name'], 'UserUpdate'); // Throws: Missing required parameter: \"name\" in \"UserUpdate\"\n * ```\n *\n * @param params - The object containing the parameters to check.\n * @param keys - An array of keys that must be present (not null or undefined) in the params object.\n * @param [name] - An optional name for the context of the assertion (e.g., function name).\n * @param [options] - Assertion options.\n * @param [options.type] - The error class to throw (default: `Error`).\n * @param [options.bypass] - If `true`, logs a warning instead of throwing an error.\n *\n * @throws {Error} If any of the required keys are missing.\n */\nexport function assertParams<T extends object, K extends keyof T>(\n  params: T,\n  keys: K[],\n  name?: string,\n  options: { bypass?: boolean; type?: ErrorConstructor } = {},\n): asserts params is T & Required<Pick<T, K>> {\n  assert(!!params, 'Missing parameters object', options);\n\n  const missing = keys.filter((key) => params[key] === undefined || params[key] === null);\n\n  if (missing.length > 0) {\n    const context = name ? ` in \"${name}\"` : '';\n    const keysStr = missing.map((key) => `\"${String(key)}\"`).join(', ');\n    const message = `Missing required parameter${missing.length > 1 ? 's' : ''}: ${keysStr}${context}`;\n\n    assert(false, message, options);\n  }\n}\n"],"mappings":"gCAqBA,SAAgB,EACd,EACA,EACA,EACA,EAAyD,EAAE,CACf,CAC5C,EAAA,OAAO,CAAC,CAAC,EAAQ,4BAA6B,EAAQ,CAEtD,IAAM,EAAU,EAAK,OAAQ,GAAQ,EAAO,KAAS,IAAA,IAAa,EAAO,KAAS,KAAK,CAEvF,GAAI,EAAQ,OAAS,EAAG,CACtB,IAAM,EAAU,EAAO,QAAQ,EAAK,GAAK,GACnC,EAAU,EAAQ,IAAK,GAAQ,IAAI,OAAO,EAAI,CAAC,GAAG,CAAC,KAAK,KAAK,CAGnE,EAAA,OAAO,GAFS,6BAA6B,EAAQ,OAAS,EAAI,IAAM,GAAG,IAAI,IAAU,IAElE,EAAQ"}

package/dist/function/assertParams.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Asserts that the specified keys are present and non-null in the params object.
+ *
+ * @example
+ * ```ts
+ * const params = { id: '123', name: undefined };
+ * assertParams(params, ['id']); // Does nothing
+ * assertParams(params, ['id', 'name'], 'UserUpdate'); // Throws: Missing required parameter: "name" in "UserUpdate"
+ * ```
+ *
+ * @param params - The object containing the parameters to check.
+ * @param keys - An array of keys that must be present (not null or undefined) in the params object.
+ * @param [name] - An optional name for the context of the assertion (e.g., function name).
+ * @param [options] - Assertion options.
+ * @param [options.type] - The error class to throw (default: `Error`).
+ * @param [options.bypass] - If `true`, logs a warning instead of throwing an error.
+ *
+ * @throws {Error} If any of the required keys are missing.
+ */
+export declare function assertParams<T extends object, K extends keyof T>(params: T, keys: K[], name?: string, options?: {
+    bypass?: boolean;
+    type?: ErrorConstructor;
+}): asserts params is T & Required<Pick<T, K>>;
+//# sourceMappingURL=assertParams.d.ts.map

package/dist/function/assertParams.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assertParams.d.ts","sourceRoot":"","sources":["../../src/function/assertParams.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,YAAY,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,MAAM,CAAC,EAC9D,MAAM,EAAE,CAAC,EACT,IAAI,EAAE,CAAC,EAAE,EACT,IAAI,CAAC,EAAE,MAAM,EACb,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAC;IAAC,IAAI,CAAC,EAAE,gBAAgB,CAAA;CAAO,GAC1D,OAAO,CAAC,MAAM,IAAI,CAAC,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAY5C"}

package/dist/function/assertParams.js

@@ -1,13 +1,14 @@
-import { assert as r } from "./assert.js";
-function $(s, o, i, n = {}) {
-  r(!!s, "Missing parameters object", n);
-  const e = o.filter((t) => s[t] === void 0 || s[t] === null || s[t] === "");
-  if (e.length > 0) {
-    const t = i ? ` in "${i}"` : "", c = e.map((l) => `"${String(l)}"`).join(", "), g = `Missing required parameter${e.length > 1 ? "s" : ""}: ${c}${t}`;
-    r(!1, g, n);
-  }
+import { assert as e } from "./assert.js";
+//#region src/function/assertParams.ts
+function t(t, n, r, i = {}) {
+	e(!!t, "Missing parameters object", i);
+	let a = n.filter((e) => t[e] === void 0 || t[e] === null);
+	if (a.length > 0) {
+		let t = r ? ` in "${r}"` : "", n = a.map((e) => `"${String(e)}"`).join(", ");
+		e(!1, `Missing required parameter${a.length > 1 ? "s" : ""}: ${n}${t}`, i);
+	}
 }
-export {
-  $ as assertParams
-};
-//# sourceMappingURL=assertParams.js.map
+//#endregion
+export { t as assertParams };
+
+//# sourceMappingURL=assertParams.js.map

package/dist/function/assertParams.js.map

@@ -1 +1 @@
-{"version":3,"file":"assertParams.js","sources":["../../src/function/assertParams.ts"],"sourcesContent":["import { assert } from './assert';\n\n/**\n * Asserts that the specified keys are present in the params object and are not empty strings.\n *\n * @example\n * ```ts\n * const params = { id: '123', name: '' };\n * assertParams(params, ['id']); // Does nothing\n * assertParams(params, ['id', 'name'], 'UserUpdate'); // Throws: Missing required parameter: \"name\" in \"UserUpdate\"\n * ```\n *\n * @param params - The object containing the parameters to check.\n * @param keys - An array of keys that must be present and non-empty in the params object.\n * @param [name] - An optional name for the context of the assertion (e.g., function name).\n * @param [options] - Assertion options.\n * @param [options.type] - The error class to throw (default: `Error`).\n * @param [options.bypass] - If `true`, logs a warning instead of throwing an error.\n *\n * @throws {Error} If any of the required keys are missing or are empty strings.\n */\nexport function assertParams<T extends object, K extends keyof T>(\n  params: T,\n  keys: K[],\n  name?: string,\n  options: { type?: ErrorConstructor; bypass?: boolean } = {},\n): asserts params is T & Required<Pick<T, K>> {\n  assert(!!params, 'Missing parameters object', options);\n\n  const missing = keys.filter((key) => params[key] === undefined || params[key] === null || params[key] === '');\n\n  if (missing.length > 0) {\n    const context = name ? ` in \"${name}\"` : '';\n    const keysStr = missing.map((key) => `\"${String(key)}\"`).join(', ');\n    const message = `Missing required parameter${missing.length > 1 ? 's' : ''}: ${keysStr}${context}`;\n\n    assert(false, message, options);\n  }\n}\n"],"names":["assertParams","params","keys","name","options","assert","missing","key","context","keysStr","message"],"mappings":";AAqBO,SAASA,EACdC,GACAC,GACAC,GACAC,IAAyD,CAAA,GACb;AAC5C,EAAAC,EAAO,CAAC,CAACJ,GAAQ,6BAA6BG,CAAO;AAErD,QAAME,IAAUJ,EAAK,OAAO,CAACK,MAAQN,EAAOM,CAAG,MAAM,UAAaN,EAAOM,CAAG,MAAM,QAAQN,EAAOM,CAAG,MAAM,EAAE;AAE5G,MAAID,EAAQ,SAAS,GAAG;AACtB,UAAME,IAAUL,IAAO,QAAQA,CAAI,MAAM,IACnCM,IAAUH,EAAQ,IAAI,CAACC,MAAQ,IAAI,OAAOA,CAAG,CAAC,GAAG,EAAE,KAAK,IAAI,GAC5DG,IAAU,6BAA6BJ,EAAQ,SAAS,IAAI,MAAM,EAAE,KAAKG,CAAO,GAAGD,CAAO;AAEhG,IAAAH,EAAO,IAAOK,GAASN,CAAO;AAAA,EAChC;AACF;"}
+{"version":3,"file":"assertParams.js","names":[],"sources":["../../src/function/assertParams.ts"],"sourcesContent":["import { assert } from './assert';\n\n/**\n * Asserts that the specified keys are present and non-null in the params object.\n *\n * @example\n * ```ts\n * const params = { id: '123', name: undefined };\n * assertParams(params, ['id']); // Does nothing\n * assertParams(params, ['id', 'name'], 'UserUpdate'); // Throws: Missing required parameter: \"name\" in \"UserUpdate\"\n * ```\n *\n * @param params - The object containing the parameters to check.\n * @param keys - An array of keys that must be present (not null or undefined) in the params object.\n * @param [name] - An optional name for the context of the assertion (e.g., function name).\n * @param [options] - Assertion options.\n * @param [options.type] - The error class to throw (default: `Error`).\n * @param [options.bypass] - If `true`, logs a warning instead of throwing an error.\n *\n * @throws {Error} If any of the required keys are missing.\n */\nexport function assertParams<T extends object, K extends keyof T>(\n  params: T,\n  keys: K[],\n  name?: string,\n  options: { bypass?: boolean; type?: ErrorConstructor } = {},\n): asserts params is T & Required<Pick<T, K>> {\n  assert(!!params, 'Missing parameters object', options);\n\n  const missing = keys.filter((key) => params[key] === undefined || params[key] === null);\n\n  if (missing.length > 0) {\n    const context = name ? ` in \"${name}\"` : '';\n    const keysStr = missing.map((key) => `\"${String(key)}\"`).join(', ');\n    const message = `Missing required parameter${missing.length > 1 ? 's' : ''}: ${keysStr}${context}`;\n\n    assert(false, message, options);\n  }\n}\n"],"mappings":";;AAqBA,SAAgB,EACd,GACA,GACA,GACA,IAAyD,EAAE,EACf;AAC5C,GAAO,CAAC,CAAC,GAAQ,6BAA6B,EAAQ;CAEtD,IAAM,IAAU,EAAK,QAAQ,MAAQ,EAAO,OAAS,KAAA,KAAa,EAAO,OAAS,KAAK;AAEvF,KAAI,EAAQ,SAAS,GAAG;EACtB,IAAM,IAAU,IAAO,QAAQ,EAAK,KAAK,IACnC,IAAU,EAAQ,KAAK,MAAQ,IAAI,OAAO,EAAI,CAAC,GAAG,CAAC,KAAK,KAAK;AAGnE,IAAO,IAFS,6BAA6B,EAAQ,SAAS,IAAI,MAAM,GAAG,IAAI,IAAU,KAElE,EAAQ"}

package/dist/function/compare.cjs

@@ -1,2 +1,2 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const i=(t,e)=>{if(t===e)return 0;if(t===void 0)return 1;if(e===void 0)return-1;if(t===null)return e===null?0:-1;if(e===null)return 1;if(typeof t=="string"&&typeof e=="string")return t.localeCompare(e);if(typeof t=="number"&&typeof e=="number")return t-e;if(t instanceof Date&&e instanceof Date)return t.getTime()-e.getTime();if(typeof t=="object"&&typeof e=="object"){const r=JSON.stringify(t),n=JSON.stringify(e);return r.localeCompare(n)}return String(t).localeCompare(String(e))};exports.compare=i;
-//# sourceMappingURL=compare.cjs.map
+var e=(e,t)=>{if(e===t)return 0;if(e===void 0)return 1;if(t===void 0)return-1;if(e===null)return t===null?0:-1;if(t===null)return 1;if(typeof e==`string`&&typeof t==`string`)return e.localeCompare(t);if(typeof e==`number`&&typeof t==`number`)return e===t?0:e>t?1:-1;if(e instanceof Date&&t instanceof Date){let n=e.getTime(),r=t.getTime();return n===r?0:n>r?1:-1}if(typeof e==`object`&&typeof t==`object`){let n=JSON.stringify(e),r=JSON.stringify(t);return n.localeCompare(r)}return String(e).localeCompare(String(t))};exports.compare=e;
+//# sourceMappingURL=compare.cjs.map