@vielzeug/toolkit 1.1.2 → 2.0.0

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

package/dist/function/compare.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"compare.cjs","sources":["../../src/function/compare.ts"],"sourcesContent":["/**\n * Compares two values and returns:\n * - 0 if they are equal\n * - 1 if the first value is greater\n * - -1 if the second value is greater\n *\n * @example\n * ```ts\n * compare('a', 'b'); // -1\n * compare(1, 2); // -1\n * compare(new Date('2023-01-01'), new Date('2023-01-02')); // -1\n * compare('a', 'a'); // 0\n * compare(1, 1); // 0\n * compare(new Date('2023-01-01'), new Date('2023-01-01')); // 0\n * ```\n *\n * @param a - The first value to compare.\n * @param b - The second value to compare.\n *\n * @returns 0 if equal, 1 if the first value is greater, -1 if the second value is greater.\n */\n// biome-ignore lint/suspicious/noExplicitAny: -\nexport const compare = (a: any, b: any): number => {\n  if (a === b) return 0;\n  if (a === undefined) return 1;\n  if (b === undefined) return -1;\n  if (a === null) return b === null ? 0 : -1;\n  if (b === null) return 1;\n\n  if (typeof a === 'string' && typeof b === 'string') {\n    return a.localeCompare(b);\n  }\n\n  if (typeof a === 'number' && typeof b === 'number') {\n    return a - b;\n  }\n\n  if (a instanceof Date && b instanceof Date) {\n    return a.getTime() - b.getTime();\n  }\n\n  if (typeof a === 'object' && typeof b === 'object') {\n    const aString = JSON.stringify(a);\n    const bString = JSON.stringify(b);\n    return aString.localeCompare(bString);\n  }\n\n  return String(a).localeCompare(String(b));\n};\n"],"names":["compare","a","b","aString","bString"],"mappings":"gFAsBO,MAAMA,EAAU,CAACC,EAAQC,IAAmB,CACjD,GAAID,IAAMC,EAAG,MAAO,GACpB,GAAID,IAAM,OAAW,MAAO,GAC5B,GAAIC,IAAM,OAAW,MAAO,GAC5B,GAAID,IAAM,KAAM,OAAOC,IAAM,KAAO,EAAI,GACxC,GAAIA,IAAM,KAAM,MAAO,GAEvB,GAAI,OAAOD,GAAM,UAAY,OAAOC,GAAM,SACxC,OAAOD,EAAE,cAAcC,CAAC,EAG1B,GAAI,OAAOD,GAAM,UAAY,OAAOC,GAAM,SACxC,OAAOD,EAAIC,EAGb,GAAID,aAAa,MAAQC,aAAa,KACpC,OAAOD,EAAE,UAAYC,EAAE,QAAA,EAGzB,GAAI,OAAOD,GAAM,UAAY,OAAOC,GAAM,SAAU,CAClD,MAAMC,EAAU,KAAK,UAAUF,CAAC,EAC1BG,EAAU,KAAK,UAAUF,CAAC,EAChC,OAAOC,EAAQ,cAAcC,CAAO,CACtC,CAEA,OAAO,OAAOH,CAAC,EAAE,cAAc,OAAOC,CAAC,CAAC,CAC1C"}
+{"version":3,"file":"compare.cjs","names":[],"sources":["../../src/function/compare.ts"],"sourcesContent":["/**\n * Compares two values and returns:\n * - 0 if they are equal\n * - 1 if the first value is greater\n * - -1 if the second value is greater\n *\n * @example\n * ```ts\n * compare('a', 'b'); // -1\n * compare(1, 2); // -1\n * compare(new Date('2023-01-01'), new Date('2023-01-02')); // -1\n * compare('a', 'a'); // 0\n * compare(1, 1); // 0\n * compare(new Date('2023-01-01'), new Date('2023-01-01')); // 0\n * ```\n *\n * @param a - The first value to compare.\n * @param b - The second value to compare.\n *\n * @returns 0 if equal, 1 if the first value is greater, -1 if the second value is greater.\n */\nexport const compare = (a: unknown, b: unknown): number => {\n  if (a === b) return 0;\n\n  if (a === undefined) return 1;\n\n  if (b === undefined) return -1;\n\n  if (a === null) return b === null ? 0 : -1;\n\n  if (b === null) return 1;\n\n  if (typeof a === 'string' && typeof b === 'string') {\n    return a.localeCompare(b);\n  }\n\n  if (typeof a === 'number' && typeof b === 'number') {\n    return a === b ? 0 : a > b ? 1 : -1;\n  }\n\n  if (a instanceof Date && b instanceof Date) {\n    const at = a.getTime();\n    const bt = b.getTime();\n\n    return at === bt ? 0 : at > bt ? 1 : -1;\n  }\n\n  if (typeof a === 'object' && typeof b === 'object') {\n    const aString = JSON.stringify(a);\n    const bString = JSON.stringify(b);\n\n    return aString.localeCompare(bString);\n  }\n\n  return String(a).localeCompare(String(b));\n};\n"],"mappings":"AAqBA,IAAa,GAAW,EAAY,IAAuB,CACzD,GAAI,IAAM,EAAG,MAAO,GAEpB,GAAI,IAAM,IAAA,GAAW,MAAO,GAE5B,GAAI,IAAM,IAAA,GAAW,MAAO,GAE5B,GAAI,IAAM,KAAM,OAAO,IAAM,KAAO,EAAI,GAExC,GAAI,IAAM,KAAM,MAAO,GAEvB,GAAI,OAAO,GAAM,UAAY,OAAO,GAAM,SACxC,OAAO,EAAE,cAAc,EAAE,CAG3B,GAAI,OAAO,GAAM,UAAY,OAAO,GAAM,SACxC,OAAO,IAAM,EAAI,EAAI,EAAI,EAAI,EAAI,GAGnC,GAAI,aAAa,MAAQ,aAAa,KAAM,CAC1C,IAAM,EAAK,EAAE,SAAS,CAChB,EAAK,EAAE,SAAS,CAEtB,OAAO,IAAO,EAAK,EAAI,EAAK,EAAK,EAAI,GAGvC,GAAI,OAAO,GAAM,UAAY,OAAO,GAAM,SAAU,CAClD,IAAM,EAAU,KAAK,UAAU,EAAE,CAC3B,EAAU,KAAK,UAAU,EAAE,CAEjC,OAAO,EAAQ,cAAc,EAAQ,CAGvC,OAAO,OAAO,EAAE,CAAC,cAAc,OAAO,EAAE,CAAC"}

package/dist/function/compare.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Compares two values and returns:
+ * - 0 if they are equal
+ * - 1 if the first value is greater
+ * - -1 if the second value is greater
+ *
+ * @example
+ * ```ts
+ * compare('a', 'b'); // -1
+ * compare(1, 2); // -1
+ * compare(new Date('2023-01-01'), new Date('2023-01-02')); // -1
+ * compare('a', 'a'); // 0
+ * compare(1, 1); // 0
+ * compare(new Date('2023-01-01'), new Date('2023-01-01')); // 0
+ * ```
+ *
+ * @param a - The first value to compare.
+ * @param b - The second value to compare.
+ *
+ * @returns 0 if equal, 1 if the first value is greater, -1 if the second value is greater.
+ */
+export declare const compare: (a: unknown, b: unknown) => number;
+//# sourceMappingURL=compare.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"compare.d.ts","sourceRoot":"","sources":["../../src/function/compare.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,OAAO,GAAI,GAAG,OAAO,EAAE,GAAG,OAAO,KAAG,MAkChD,CAAC"}

package/dist/function/compare.js

@@ -1,22 +1,23 @@
-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));
+//#region src/function/compare.ts
+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));
 };
-export {
-  i as compare
-};
-//# sourceMappingURL=compare.js.map
+//#endregion
+export { e as compare };
+
+//# sourceMappingURL=compare.js.map

package/dist/function/compare.js.map

@@ -1 +1 @@
-{"version":3,"file":"compare.js","sources":["../../src/function/compare.ts"],"sourcesContent":["/**\n * Compares two values and returns:\n * - 0 if they are equal\n * - 1 if the first value is greater\n * - -1 if the second value is greater\n *\n * @example\n * ```ts\n * compare('a', 'b'); // -1\n * compare(1, 2); // -1\n * compare(new Date('2023-01-01'), new Date('2023-01-02')); // -1\n * compare('a', 'a'); // 0\n * compare(1, 1); // 0\n * compare(new Date('2023-01-01'), new Date('2023-01-01')); // 0\n * ```\n *\n * @param a - The first value to compare.\n * @param b - The second value to compare.\n *\n * @returns 0 if equal, 1 if the first value is greater, -1 if the second value is greater.\n */\n// biome-ignore lint/suspicious/noExplicitAny: -\nexport const compare = (a: any, b: any): number => {\n  if (a === b) return 0;\n  if (a === undefined) return 1;\n  if (b === undefined) return -1;\n  if (a === null) return b === null ? 0 : -1;\n  if (b === null) return 1;\n\n  if (typeof a === 'string' && typeof b === 'string') {\n    return a.localeCompare(b);\n  }\n\n  if (typeof a === 'number' && typeof b === 'number') {\n    return a - b;\n  }\n\n  if (a instanceof Date && b instanceof Date) {\n    return a.getTime() - b.getTime();\n  }\n\n  if (typeof a === 'object' && typeof b === 'object') {\n    const aString = JSON.stringify(a);\n    const bString = JSON.stringify(b);\n    return aString.localeCompare(bString);\n  }\n\n  return String(a).localeCompare(String(b));\n};\n"],"names":["compare","a","b","aString","bString"],"mappings":"AAsBO,MAAMA,IAAU,CAACC,GAAQC,MAAmB;AACjD,MAAID,MAAMC,EAAG,QAAO;AACpB,MAAID,MAAM,OAAW,QAAO;AAC5B,MAAIC,MAAM,OAAW,QAAO;AAC5B,MAAID,MAAM,KAAM,QAAOC,MAAM,OAAO,IAAI;AACxC,MAAIA,MAAM,KAAM,QAAO;AAEvB,MAAI,OAAOD,KAAM,YAAY,OAAOC,KAAM;AACxC,WAAOD,EAAE,cAAcC,CAAC;AAG1B,MAAI,OAAOD,KAAM,YAAY,OAAOC,KAAM;AACxC,WAAOD,IAAIC;AAGb,MAAID,aAAa,QAAQC,aAAa;AACpC,WAAOD,EAAE,YAAYC,EAAE,QAAA;AAGzB,MAAI,OAAOD,KAAM,YAAY,OAAOC,KAAM,UAAU;AAClD,UAAMC,IAAU,KAAK,UAAUF,CAAC,GAC1BG,IAAU,KAAK,UAAUF,CAAC;AAChC,WAAOC,EAAQ,cAAcC,CAAO;AAAA,EACtC;AAEA,SAAO,OAAOH,CAAC,EAAE,cAAc,OAAOC,CAAC,CAAC;AAC1C;"}
+{"version":3,"file":"compare.js","names":[],"sources":["../../src/function/compare.ts"],"sourcesContent":["/**\n * Compares two values and returns:\n * - 0 if they are equal\n * - 1 if the first value is greater\n * - -1 if the second value is greater\n *\n * @example\n * ```ts\n * compare('a', 'b'); // -1\n * compare(1, 2); // -1\n * compare(new Date('2023-01-01'), new Date('2023-01-02')); // -1\n * compare('a', 'a'); // 0\n * compare(1, 1); // 0\n * compare(new Date('2023-01-01'), new Date('2023-01-01')); // 0\n * ```\n *\n * @param a - The first value to compare.\n * @param b - The second value to compare.\n *\n * @returns 0 if equal, 1 if the first value is greater, -1 if the second value is greater.\n */\nexport const compare = (a: unknown, b: unknown): number => {\n  if (a === b) return 0;\n\n  if (a === undefined) return 1;\n\n  if (b === undefined) return -1;\n\n  if (a === null) return b === null ? 0 : -1;\n\n  if (b === null) return 1;\n\n  if (typeof a === 'string' && typeof b === 'string') {\n    return a.localeCompare(b);\n  }\n\n  if (typeof a === 'number' && typeof b === 'number') {\n    return a === b ? 0 : a > b ? 1 : -1;\n  }\n\n  if (a instanceof Date && b instanceof Date) {\n    const at = a.getTime();\n    const bt = b.getTime();\n\n    return at === bt ? 0 : at > bt ? 1 : -1;\n  }\n\n  if (typeof a === 'object' && typeof b === 'object') {\n    const aString = JSON.stringify(a);\n    const bString = JSON.stringify(b);\n\n    return aString.localeCompare(bString);\n  }\n\n  return String(a).localeCompare(String(b));\n};\n"],"mappings":";AAqBA,IAAa,KAAW,GAAY,MAAuB;AACzD,KAAI,MAAM,EAAG,QAAO;AAEpB,KAAI,MAAM,KAAA,EAAW,QAAO;AAE5B,KAAI,MAAM,KAAA,EAAW,QAAO;AAE5B,KAAI,MAAM,KAAM,QAAO,MAAM,OAAO,IAAI;AAExC,KAAI,MAAM,KAAM,QAAO;AAEvB,KAAI,OAAO,KAAM,YAAY,OAAO,KAAM,SACxC,QAAO,EAAE,cAAc,EAAE;AAG3B,KAAI,OAAO,KAAM,YAAY,OAAO,KAAM,SACxC,QAAO,MAAM,IAAI,IAAI,IAAI,IAAI,IAAI;AAGnC,KAAI,aAAa,QAAQ,aAAa,MAAM;EAC1C,IAAM,IAAK,EAAE,SAAS,EAChB,IAAK,EAAE,SAAS;AAEtB,SAAO,MAAO,IAAK,IAAI,IAAK,IAAK,IAAI;;AAGvC,KAAI,OAAO,KAAM,YAAY,OAAO,KAAM,UAAU;EAClD,IAAM,IAAU,KAAK,UAAU,EAAE,EAC3B,IAAU,KAAK,UAAU,EAAE;AAEjC,SAAO,EAAQ,cAAc,EAAQ;;AAGvC,QAAO,OAAO,EAAE,CAAC,cAAc,OAAO,EAAE,CAAC"}

package/dist/function/compareBy.cjs

@@ -1,2 +1,2 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const m=require("./compare.cjs"),p=t=>{const o=Object.entries(t);return(c,n)=>{for(const[e,s]of o){const i=c[e],u=n[e],a=s==="desc"?-1:1,r=m.compare(i,u);if(r!==0)return r*a}return 0}};exports.compareBy=p;
-//# sourceMappingURL=compareBy.cjs.map
+const e=require(`./compare.cjs`);var t=t=>{let n=Object.entries(t);return(t,r)=>{for(let[i,a]of n){let n=t[i],o=r[i],s=a===`desc`?-1:1,c=e.compare(n,o);if(c!==0)return c*s}return 0}};exports.compareBy=t;
+//# sourceMappingURL=compareBy.cjs.map

package/dist/function/compareBy.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"compareBy.cjs","sources":["../../src/function/compareBy.ts"],"sourcesContent":["import { compare } from './compare';\n\n/**\n * Compares two objects based on multiple selectors.\n * The comparison is done in the order of the selectors provided.\n * Each selector can be 'asc' for ascending or 'desc' for descending order.\n *\n * @example\n * ```ts\n * const compareByNameAndAge = compareBy<{ name: string; age: number }>({\n *   name: 'asc',\n *   age: 'desc',\n * });\n *\n * const a = { name: 'Alice', age: 30 };\n * const b = { name: 'Bob', age: 25 };\n *\n * console.log(compareByNameAndAge(a, b)); // -1 (Alice < Bob)\n * ```\n *\n * @param selectors - An object where keys are properties to compare and values are 'asc' or 'desc'.\n *\n * @returns A comparison function that can be used with array sorting methods.\n */\nexport const compareBy = <T>(selectors: Partial<Record<keyof T, 'asc' | 'desc'>>) => {\n  const entries = Object.entries(selectors) as [keyof T, 'asc' | 'desc'][];\n\n  return (a: T, b: T) => {\n    for (const [key, direction] of entries) {\n      const v1 = a[key];\n      const v2 = b[key];\n      const dir = direction === 'desc' ? -1 : 1;\n\n      const cmp = compare(v1, v2);\n      if (cmp !== 0) return cmp * dir;\n    }\n\n    return 0;\n  };\n};\n"],"names":["compareBy","selectors","entries","a","b","key","direction","v1","v2","dir","cmp","compare"],"mappings":"iHAwBaA,EAAgBC,GAAwD,CACnF,MAAMC,EAAU,OAAO,QAAQD,CAAS,EAExC,MAAO,CAACE,EAAMC,IAAS,CACrB,SAAW,CAACC,EAAKC,CAAS,IAAKJ,EAAS,CACtC,MAAMK,EAAKJ,EAAEE,CAAG,EACVG,EAAKJ,EAAEC,CAAG,EACVI,EAAMH,IAAc,OAAS,GAAK,EAElCI,EAAMC,EAAAA,QAAQJ,EAAIC,CAAE,EAC1B,GAAIE,IAAQ,EAAG,OAAOA,EAAMD,CAC9B,CAEA,MAAO,EACT,CACF"}
+{"version":3,"file":"compareBy.cjs","names":[],"sources":["../../src/function/compareBy.ts"],"sourcesContent":["import { compare } from './compare';\n\n/**\n * Compares two objects based on multiple selectors.\n * The comparison is done in the order of the selectors provided.\n * Each selector can be 'asc' for ascending or 'desc' for descending order.\n *\n * @example\n * ```ts\n * const compareByNameAndAge = compareBy<{ name: string; age: number }>({\n *   name: 'asc',\n *   age: 'desc',\n * });\n *\n * const a = { name: 'Alice', age: 30 };\n * const b = { name: 'Bob', age: 25 };\n *\n * console.log(compareByNameAndAge(a, b)); // -1 (Alice < Bob)\n * ```\n *\n * @param selectors - An object where keys are properties to compare and values are 'asc' or 'desc'.\n *\n * @returns A comparison function that can be used with array sorting methods.\n */\nexport const compareBy = <T>(selectors: Partial<Record<keyof T, 'asc' | 'desc'>>) => {\n  const entries = Object.entries(selectors) as [keyof T, 'asc' | 'desc'][];\n\n  return (a: T, b: T) => {\n    for (const [key, direction] of entries) {\n      const v1 = a[key];\n      const v2 = b[key];\n      const dir = direction === 'desc' ? -1 : 1;\n\n      const cmp = compare(v1, v2);\n\n      if (cmp !== 0) return cmp * dir;\n    }\n\n    return 0;\n  };\n};\n"],"mappings":"iCAwBA,IAAa,EAAgB,GAAwD,CACnF,IAAM,EAAU,OAAO,QAAQ,EAAU,CAEzC,OAAQ,EAAM,IAAS,CACrB,IAAK,GAAM,CAAC,EAAK,KAAc,EAAS,CACtC,IAAM,EAAK,EAAE,GACP,EAAK,EAAE,GACP,EAAM,IAAc,OAAS,GAAK,EAElC,EAAM,EAAA,QAAQ,EAAI,EAAG,CAE3B,GAAI,IAAQ,EAAG,OAAO,EAAM,EAG9B,MAAO"}

package/dist/function/compareBy.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Compares two objects based on multiple selectors.
+ * The comparison is done in the order of the selectors provided.
+ * Each selector can be 'asc' for ascending or 'desc' for descending order.
+ *
+ * @example
+ * ```ts
+ * const compareByNameAndAge = compareBy<{ name: string; age: number }>({
+ *   name: 'asc',
+ *   age: 'desc',
+ * });
+ *
+ * const a = { name: 'Alice', age: 30 };
+ * const b = { name: 'Bob', age: 25 };
+ *
+ * console.log(compareByNameAndAge(a, b)); // -1 (Alice < Bob)
+ * ```
+ *
+ * @param selectors - An object where keys are properties to compare and values are 'asc' or 'desc'.
+ *
+ * @returns A comparison function that can be used with array sorting methods.
+ */
+export declare const compareBy: <T>(selectors: Partial<Record<keyof T, "asc" | "desc">>) => (a: T, b: T) => number;
+//# sourceMappingURL=compareBy.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"compareBy.d.ts","sourceRoot":"","sources":["../../src/function/compareBy.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,eAAO,MAAM,SAAS,GAAI,CAAC,EAAE,WAAW,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC,CAAC,MAGtE,GAAG,CAAC,EAAE,GAAG,CAAC,WAanB,CAAC"}

package/dist/function/compareBy.js

@@ -1,15 +1,16 @@
-import { compare as f } from "./compare.js";
-const u = (o) => {
-  const e = Object.entries(o);
-  return (c, n) => {
-    for (const [r, s] of e) {
-      const i = c[r], m = n[r], p = s === "desc" ? -1 : 1, t = f(i, m);
-      if (t !== 0) return t * p;
-    }
-    return 0;
-  };
+import { compare as e } from "./compare.js";
+//#region src/function/compareBy.ts
+var t = (t) => {
+	let n = Object.entries(t);
+	return (t, r) => {
+		for (let [i, a] of n) {
+			let n = t[i], o = r[i], s = a === "desc" ? -1 : 1, c = e(n, o);
+			if (c !== 0) return c * s;
+		}
+		return 0;
+	};
 };
-export {
-  u as compareBy
-};
-//# sourceMappingURL=compareBy.js.map
+//#endregion
+export { t as compareBy };
+
+//# sourceMappingURL=compareBy.js.map

package/dist/function/compareBy.js.map

@@ -1 +1 @@
-{"version":3,"file":"compareBy.js","sources":["../../src/function/compareBy.ts"],"sourcesContent":["import { compare } from './compare';\n\n/**\n * Compares two objects based on multiple selectors.\n * The comparison is done in the order of the selectors provided.\n * Each selector can be 'asc' for ascending or 'desc' for descending order.\n *\n * @example\n * ```ts\n * const compareByNameAndAge = compareBy<{ name: string; age: number }>({\n *   name: 'asc',\n *   age: 'desc',\n * });\n *\n * const a = { name: 'Alice', age: 30 };\n * const b = { name: 'Bob', age: 25 };\n *\n * console.log(compareByNameAndAge(a, b)); // -1 (Alice < Bob)\n * ```\n *\n * @param selectors - An object where keys are properties to compare and values are 'asc' or 'desc'.\n *\n * @returns A comparison function that can be used with array sorting methods.\n */\nexport const compareBy = <T>(selectors: Partial<Record<keyof T, 'asc' | 'desc'>>) => {\n  const entries = Object.entries(selectors) as [keyof T, 'asc' | 'desc'][];\n\n  return (a: T, b: T) => {\n    for (const [key, direction] of entries) {\n      const v1 = a[key];\n      const v2 = b[key];\n      const dir = direction === 'desc' ? -1 : 1;\n\n      const cmp = compare(v1, v2);\n      if (cmp !== 0) return cmp * dir;\n    }\n\n    return 0;\n  };\n};\n"],"names":["compareBy","selectors","entries","a","b","key","direction","v1","v2","dir","cmp","compare"],"mappings":";AAwBO,MAAMA,IAAY,CAAIC,MAAwD;AACnF,QAAMC,IAAU,OAAO,QAAQD,CAAS;AAExC,SAAO,CAACE,GAAMC,MAAS;AACrB,eAAW,CAACC,GAAKC,CAAS,KAAKJ,GAAS;AACtC,YAAMK,IAAKJ,EAAEE,CAAG,GACVG,IAAKJ,EAAEC,CAAG,GACVI,IAAMH,MAAc,SAAS,KAAK,GAElCI,IAAMC,EAAQJ,GAAIC,CAAE;AAC1B,UAAIE,MAAQ,EAAG,QAAOA,IAAMD;AAAA,IAC9B;AAEA,WAAO;AAAA,EACT;AACF;"}
+{"version":3,"file":"compareBy.js","names":[],"sources":["../../src/function/compareBy.ts"],"sourcesContent":["import { compare } from './compare';\n\n/**\n * Compares two objects based on multiple selectors.\n * The comparison is done in the order of the selectors provided.\n * Each selector can be 'asc' for ascending or 'desc' for descending order.\n *\n * @example\n * ```ts\n * const compareByNameAndAge = compareBy<{ name: string; age: number }>({\n *   name: 'asc',\n *   age: 'desc',\n * });\n *\n * const a = { name: 'Alice', age: 30 };\n * const b = { name: 'Bob', age: 25 };\n *\n * console.log(compareByNameAndAge(a, b)); // -1 (Alice < Bob)\n * ```\n *\n * @param selectors - An object where keys are properties to compare and values are 'asc' or 'desc'.\n *\n * @returns A comparison function that can be used with array sorting methods.\n */\nexport const compareBy = <T>(selectors: Partial<Record<keyof T, 'asc' | 'desc'>>) => {\n  const entries = Object.entries(selectors) as [keyof T, 'asc' | 'desc'][];\n\n  return (a: T, b: T) => {\n    for (const [key, direction] of entries) {\n      const v1 = a[key];\n      const v2 = b[key];\n      const dir = direction === 'desc' ? -1 : 1;\n\n      const cmp = compare(v1, v2);\n\n      if (cmp !== 0) return cmp * dir;\n    }\n\n    return 0;\n  };\n};\n"],"mappings":";;AAwBA,IAAa,KAAgB,MAAwD;CACnF,IAAM,IAAU,OAAO,QAAQ,EAAU;AAEzC,SAAQ,GAAM,MAAS;AACrB,OAAK,IAAM,CAAC,GAAK,MAAc,GAAS;GACtC,IAAM,IAAK,EAAE,IACP,IAAK,EAAE,IACP,IAAM,MAAc,SAAS,KAAK,GAElC,IAAM,EAAQ,GAAI,EAAG;AAE3B,OAAI,MAAQ,EAAG,QAAO,IAAM;;AAG9B,SAAO"}

package/dist/function/compose.cjs

@@ -1,2 +1,2 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const c=require("../typed/isPromise.cjs"),n=require("./assert.cjs");function u(...e){n.assert(e.length>0,"compose requires at least one function",{args:{fns:e}});const o=e[e.length-1],r=e.slice(0,-1);return((...i)=>r.reduceRight((t,s)=>c.isPromise(t)?t.then(s):s(t),o(...i)))}exports.compose=u;
-//# sourceMappingURL=compose.cjs.map
+const e=require(`./assert.cjs`);function t(...t){e.assert(t.length>0,`compose requires at least one function`,{args:{fns:t}});let n=t[t.length-1],r=t.slice(0,-1);return((...e)=>r.reduceRight((e,t)=>t(e),n(...e)))}exports.compose=t;
+//# sourceMappingURL=compose.cjs.map

package/dist/function/compose.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"compose.cjs","sources":["../../src/function/compose.ts"],"sourcesContent":["/** biome-ignore-all lint/suspicious/noExplicitAny: - */\n\nimport { isPromise } from '../typed/isPromise';\nimport type { FnDynamic } from '../types';\nimport { assert } from './assert';\n\ntype LastParameters<T> = T extends [...any, infer Last extends FnDynamic] ? Parameters<Last> : never;\ntype FirstReturnType<F> = F extends [infer First extends FnDynamic, ...any] ? ReturnType<First> : never;\ntype ComposeReturn<T extends FnDynamic[]> = (\n  ...args: LastParameters<T>\n) => FirstReturnType<T> extends Promise<any> ? Promise<Awaited<FirstReturnType<T>>> : FirstReturnType<T>;\n/**\n * Composes multiple functions into a single function. It starts from the rightmost function and proceeds to the left.\n *\n * @example\n * ```ts\n * const add = (x) => x + 2;\n * const multiply = (x) => x * 3;\n * const subtract = (x) => x - 4;\n * const composedFn = compose(subtract, multiply, add);\n * composedFn(5); // ((5 + 2) * 3) - 4 = 17\n * ```\n *\n * @example\n * ```ts\n * const square = async (x) => x * x;\n * const add = async (x) => x + 2;\n * const composedFn = compose(square, add);\n * await composedFn(4); // (4 * 4) + 2 = 18\n * ```\n *\n * @param fns - List of the functions to be composed.\n *\n * @returns A new function that is the composition of the input functions.\n */\nexport function compose<T extends FnDynamic[]>(...fns: T): ComposeReturn<T> {\n  assert(fns.length > 0, 'compose requires at least one function', { args: { fns } });\n\n  const lastFn = fns[fns.length - 1];\n  const restFns = fns.slice(0, -1);\n\n  return ((...args: LastParameters<T>) =>\n    restFns.reduceRight(\n      (prev, fn) => (isPromise(prev) ? prev.then(fn) : fn(prev)),\n      lastFn(...args),\n    )) as ComposeReturn<T>;\n}\n"],"names":["compose","fns","assert","lastFn","restFns","args","prev","fn","isPromise"],"mappings":"oJAmCO,SAASA,KAAkCC,EAA0B,CAC1EC,SAAOD,EAAI,OAAS,EAAG,yCAA0C,CAAE,KAAM,CAAE,IAAAA,CAAA,EAAO,EAElF,MAAME,EAASF,EAAIA,EAAI,OAAS,CAAC,EAC3BG,EAAUH,EAAI,MAAM,EAAG,EAAE,EAE/B,OAAQ,IAAII,IACVD,EAAQ,YACN,CAACE,EAAMC,IAAQC,EAAAA,UAAUF,CAAI,EAAIA,EAAK,KAAKC,CAAE,EAAIA,EAAGD,CAAI,EACxDH,EAAO,GAAGE,CAAI,CAAA,EAEpB"}
+{"version":3,"file":"compose.cjs","names":[],"sources":["../../src/function/compose.ts"],"sourcesContent":["import type { Fn } from '../types';\n\nimport { assert } from './assert';\n\ntype LastParameters<T> = T extends [...any, infer Last extends Fn] ? Parameters<Last> : never;\ntype FirstReturnType<F> = F extends [infer First extends Fn, ...any] ? ReturnType<First> : never;\n\n/**\n * Composes multiple functions into a single function. It starts from the rightmost function and proceeds to the left.\n *\n * @example\n * ```ts\n * const add = (x) => x + 2;\n * const multiply = (x) => x * 3;\n * const subtract = (x) => x - 4;\n * const composedFn = compose(subtract, multiply, add);\n * composedFn(5); // ((5 + 2) * 3) - 4 = 17\n * ```\n *\n * @param fns - List of the functions to be composed.\n *\n * @returns A new function that is the composition of the input functions.\n */\nexport function compose<T extends Fn[]>(...fns: T): (...args: LastParameters<T>) => FirstReturnType<T> {\n  assert(fns.length > 0, 'compose requires at least one function', { args: { fns } });\n\n  const lastFn = fns[fns.length - 1];\n  const restFns = fns.slice(0, -1);\n\n  return ((...args: LastParameters<T>) => restFns.reduceRight((prev, fn) => fn(prev), lastFn(...args))) as (\n    ...args: LastParameters<T>\n  ) => FirstReturnType<T>;\n}\n"],"mappings":"gCAuBA,SAAgB,EAAwB,GAAG,EAA4D,CACrG,EAAA,OAAO,EAAI,OAAS,EAAG,yCAA0C,CAAE,KAAM,CAAE,MAAK,CAAE,CAAC,CAEnF,IAAM,EAAS,EAAI,EAAI,OAAS,GAC1B,EAAU,EAAI,MAAM,EAAG,GAAG,CAEhC,QAAS,GAAG,IAA4B,EAAQ,aAAa,EAAM,IAAO,EAAG,EAAK,CAAE,EAAO,GAAG,EAAK,CAAC"}

package/dist/function/compose.d.ts

@@ -0,0 +1,22 @@
+import type { Fn } from '../types';
+type LastParameters<T> = T extends [...any, infer Last extends Fn] ? Parameters<Last> : never;
+type FirstReturnType<F> = F extends [infer First extends Fn, ...any] ? ReturnType<First> : never;
+/**
+ * Composes multiple functions into a single function. It starts from the rightmost function and proceeds to the left.
+ *
+ * @example
+ * ```ts
+ * const add = (x) => x + 2;
+ * const multiply = (x) => x * 3;
+ * const subtract = (x) => x - 4;
+ * const composedFn = compose(subtract, multiply, add);
+ * composedFn(5); // ((5 + 2) * 3) - 4 = 17
+ * ```
+ *
+ * @param fns - List of the functions to be composed.
+ *
+ * @returns A new function that is the composition of the input functions.
+ */
+export declare function compose<T extends Fn[]>(...fns: T): (...args: LastParameters<T>) => FirstReturnType<T>;
+export {};
+//# sourceMappingURL=compose.d.ts.map