@ekumlin/typescript-toolkit 1.0.0

package/dist/routing.mjs

@@ -0,0 +1,16 @@
+// src/routing/getSlug.ts
+var getSlug = (url) => {
+  const parts = url.split("/");
+  for (let i = parts.length - 1; i >= 0; i--) {
+    const part = parts[i];
+    if (!part) {
+      continue;
+    }
+    return part;
+  }
+  return void 0;
+};
+export {
+  getSlug
+};
+//# sourceMappingURL=routing.mjs.map

package/dist/routing.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/routing/getSlug.ts"],"sourcesContent":["export const getSlug = (url: string): string | undefined => {\n\tconst parts = url.split(\"/\");\n\n\tfor (let i = parts.length - 1; i >= 0; i--) {\n\t\tconst part = parts[i];\n\n\t\tif (!part) {\n\t\t\tcontinue;\n\t\t}\n\n\t\treturn part;\n\t}\n\n\treturn undefined;\n};\n"],"mappings":";AAAO,IAAM,UAAU,CAAC,QAAoC;AAC3D,QAAM,QAAQ,IAAI,MAAM,GAAG;AAE3B,WAAS,IAAI,MAAM,SAAS,GAAG,KAAK,GAAG,KAAK;AAC3C,UAAM,OAAO,MAAM,CAAC;AAEpB,QAAI,CAAC,MAAM;AACV;AAAA,IACD;AAEA,WAAO;AAAA,EACR;AAEA,SAAO;AACR;","names":[]}

package/dist/string.d.mts

@@ -0,0 +1,9 @@
+declare const isUrl: (obj: unknown) => boolean;
+
+declare const nbsp: () => string;
+
+declare const toReadableFileSize: (bytes: number, useSi?: boolean, decimalPlaces?: number) => string;
+
+declare const upperFirst: (value: string) => string;
+
+export { isUrl, nbsp, toReadableFileSize, upperFirst };

package/dist/string.d.ts

@@ -0,0 +1,9 @@
+declare const isUrl: (obj: unknown) => boolean;
+
+declare const nbsp: () => string;
+
+declare const toReadableFileSize: (bytes: number, useSi?: boolean, decimalPlaces?: number) => string;
+
+declare const upperFirst: (value: string) => string;
+
+export { isUrl, nbsp, toReadableFileSize, upperFirst };

package/dist/string.js

@@ -0,0 +1,75 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/string/index.ts
+var string_exports = {};
+__export(string_exports, {
+  isUrl: () => isUrl,
+  nbsp: () => nbsp,
+  toReadableFileSize: () => toReadableFileSize,
+  upperFirst: () => upperFirst
+});
+module.exports = __toCommonJS(string_exports);
+
+// src/types/guards.ts
+var import_zod = require("zod");
+var isString = (obj) => typeof obj === "string";
+
+// src/string/isUrl.ts
+var isUrl = (obj) => {
+  if (!isString(obj)) {
+    return false;
+  }
+  try {
+    new URL(obj);
+  } catch {
+    return false;
+  }
+  return true;
+};
+
+// src/string/nbsp.ts
+var nbsp = () => "\xA0";
+
+// src/string/toReadableFileSize.ts
+var toReadableFileSize = (bytes, useSi = false, decimalPlaces = 1) => {
+  const threshold = useSi ? 1e3 : 1024;
+  if (Math.abs(bytes) < threshold) {
+    return `${bytes} B`;
+  }
+  const units = useSi ? ["kB", "MB", "GB", "TB", "PB", "EB", "ZB", "YB"] : ["KiB", "MiB", "GiB", "TiB", "PiB", "EiB", "ZiB", "YiB"];
+  let u = -1;
+  const r = 10 ** decimalPlaces;
+  do {
+    bytes /= threshold;
+    ++u;
+  } while (Math.round(Math.abs(bytes) * r) / r >= threshold && u < units.length - 1);
+  return `${bytes.toFixed(decimalPlaces)} ${units[u]}`;
+};
+
+// src/string/upperFirst.ts
+var upperFirst = (value) => value.length > 1 ? `${value.charAt(0).toLocaleUpperCase()}${value.slice(1)}` : value.toLocaleUpperCase();
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  isUrl,
+  nbsp,
+  toReadableFileSize,
+  upperFirst
+});
+//# sourceMappingURL=string.js.map

package/dist/string.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/string/index.ts","../src/types/guards.ts","../src/string/isUrl.ts","../src/string/nbsp.ts","../src/string/toReadableFileSize.ts","../src/string/upperFirst.ts"],"sourcesContent":["export * from \"./isUrl\";\nexport * from \"./nbsp\";\nexport * from \"./toReadableFileSize\";\nexport * from \"./upperFirst\";\n","import { z } from \"zod\";\n\nexport const isArray = (obj: unknown): obj is unknown[] => Array.isArray(obj);\n\nexport const isBoolean = (obj: unknown): obj is boolean =>\n\tobj === true || obj === false;\n\n// biome-ignore lint/complexity/noBannedTypes: Generic function-checking type guard.\nexport const isFunction = (obj: unknown): obj is Function =>\n\ttypeof obj === \"function\";\n\nexport const isNull = (obj: unknown): obj is null => obj === null;\n\nexport const isNullOrUndefined = (obj: unknown): obj is null | undefined =>\n\tisNull(obj) || isUndefined(obj);\n\nexport const isNumber = (obj: unknown): obj is number =>\n\ttypeof obj === \"number\";\n\nexport const isString = (obj: unknown): obj is string =>\n\ttypeof obj === \"string\";\n\nexport const isUndefined = (obj: unknown): obj is undefined =>\n\ttypeof obj === \"undefined\";\n\nexport const isUnknown = (obj: unknown): obj is unknown =>\n\tz.unknown().safeParse(obj).success;\n","import { isString } from \"../types\";\n\nexport const isUrl = (obj: unknown): boolean => {\n\tif (!isString(obj)) {\n\t\treturn false;\n\t}\n\n\ttry {\n\t\tnew URL(obj);\n\t} catch {\n\t\treturn false;\n\t}\n\n\treturn true;\n};\n","export const nbsp = (): string => \"\\u00A0\";\n","export const toReadableFileSize = (\n\tbytes: number,\n\tuseSi: boolean = false,\n\tdecimalPlaces: number = 1,\n): string => {\n\tconst threshold = useSi ? 1000 : 1024;\n\n\tif (Math.abs(bytes) < threshold) {\n\t\treturn `${bytes} B`;\n\t}\n\n\tconst units = useSi\n\t\t? [\"kB\", \"MB\", \"GB\", \"TB\", \"PB\", \"EB\", \"ZB\", \"YB\"]\n\t\t: [\"KiB\", \"MiB\", \"GiB\", \"TiB\", \"PiB\", \"EiB\", \"ZiB\", \"YiB\"];\n\n\tlet u = -1;\n\tconst r = 10 ** decimalPlaces;\n\n\tdo {\n\t\tbytes /= threshold;\n\t\t++u;\n\t} while (\n\t\tMath.round(Math.abs(bytes) * r) / r >= threshold &&\n\t\tu < units.length - 1\n\t);\n\n\treturn `${bytes.toFixed(decimalPlaces)} ${units[u]}`;\n};\n","export const upperFirst = (value: string): string =>\n\tvalue.length > 1\n\t\t? `${value.charAt(0).toLocaleUpperCase()}${value.slice(1)}`\n\t\t: value.toLocaleUpperCase();\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACAA,iBAAkB;AAmBX,IAAM,WAAW,CAAC,QACxB,OAAO,QAAQ;;;AClBT,IAAM,QAAQ,CAAC,QAA0B;AAC/C,MAAI,CAAC,SAAS,GAAG,GAAG;AACnB,WAAO;AAAA,EACR;AAEA,MAAI;AACH,QAAI,IAAI,GAAG;AAAA,EACZ,QAAQ;AACP,WAAO;AAAA,EACR;AAEA,SAAO;AACR;;;ACdO,IAAM,OAAO,MAAc;;;ACA3B,IAAM,qBAAqB,CACjC,OACA,QAAiB,OACjB,gBAAwB,MACZ;AACZ,QAAM,YAAY,QAAQ,MAAO;AAEjC,MAAI,KAAK,IAAI,KAAK,IAAI,WAAW;AAChC,WAAO,GAAG,KAAK;AAAA,EAChB;AAEA,QAAM,QAAQ,QACX,CAAC,MAAM,MAAM,MAAM,MAAM,MAAM,MAAM,MAAM,IAAI,IAC/C,CAAC,OAAO,OAAO,OAAO,OAAO,OAAO,OAAO,OAAO,KAAK;AAE1D,MAAI,IAAI;AACR,QAAM,IAAI,MAAM;AAEhB,KAAG;AACF,aAAS;AACT,MAAE;AAAA,EACH,SACC,KAAK,MAAM,KAAK,IAAI,KAAK,IAAI,CAAC,IAAI,KAAK,aACvC,IAAI,MAAM,SAAS;AAGpB,SAAO,GAAG,MAAM,QAAQ,aAAa,CAAC,IAAI,MAAM,CAAC,CAAC;AACnD;;;AC3BO,IAAM,aAAa,CAAC,UAC1B,MAAM,SAAS,IACZ,GAAG,MAAM,OAAO,CAAC,EAAE,kBAAkB,CAAC,GAAG,MAAM,MAAM,CAAC,CAAC,KACvD,MAAM,kBAAkB;","names":[]}

package/dist/string.mjs

@@ -0,0 +1,45 @@
+// src/types/guards.ts
+import { z } from "zod";
+var isString = (obj) => typeof obj === "string";
+
+// src/string/isUrl.ts
+var isUrl = (obj) => {
+  if (!isString(obj)) {
+    return false;
+  }
+  try {
+    new URL(obj);
+  } catch {
+    return false;
+  }
+  return true;
+};
+
+// src/string/nbsp.ts
+var nbsp = () => "\xA0";
+
+// src/string/toReadableFileSize.ts
+var toReadableFileSize = (bytes, useSi = false, decimalPlaces = 1) => {
+  const threshold = useSi ? 1e3 : 1024;
+  if (Math.abs(bytes) < threshold) {
+    return `${bytes} B`;
+  }
+  const units = useSi ? ["kB", "MB", "GB", "TB", "PB", "EB", "ZB", "YB"] : ["KiB", "MiB", "GiB", "TiB", "PiB", "EiB", "ZiB", "YiB"];
+  let u = -1;
+  const r = 10 ** decimalPlaces;
+  do {
+    bytes /= threshold;
+    ++u;
+  } while (Math.round(Math.abs(bytes) * r) / r >= threshold && u < units.length - 1);
+  return `${bytes.toFixed(decimalPlaces)} ${units[u]}`;
+};
+
+// src/string/upperFirst.ts
+var upperFirst = (value) => value.length > 1 ? `${value.charAt(0).toLocaleUpperCase()}${value.slice(1)}` : value.toLocaleUpperCase();
+export {
+  isUrl,
+  nbsp,
+  toReadableFileSize,
+  upperFirst
+};
+//# sourceMappingURL=string.mjs.map

package/dist/string.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/types/guards.ts","../src/string/isUrl.ts","../src/string/nbsp.ts","../src/string/toReadableFileSize.ts","../src/string/upperFirst.ts"],"sourcesContent":["import { z } from \"zod\";\n\nexport const isArray = (obj: unknown): obj is unknown[] => Array.isArray(obj);\n\nexport const isBoolean = (obj: unknown): obj is boolean =>\n\tobj === true || obj === false;\n\n// biome-ignore lint/complexity/noBannedTypes: Generic function-checking type guard.\nexport const isFunction = (obj: unknown): obj is Function =>\n\ttypeof obj === \"function\";\n\nexport const isNull = (obj: unknown): obj is null => obj === null;\n\nexport const isNullOrUndefined = (obj: unknown): obj is null | undefined =>\n\tisNull(obj) || isUndefined(obj);\n\nexport const isNumber = (obj: unknown): obj is number =>\n\ttypeof obj === \"number\";\n\nexport const isString = (obj: unknown): obj is string =>\n\ttypeof obj === \"string\";\n\nexport const isUndefined = (obj: unknown): obj is undefined =>\n\ttypeof obj === \"undefined\";\n\nexport const isUnknown = (obj: unknown): obj is unknown =>\n\tz.unknown().safeParse(obj).success;\n","import { isString } from \"../types\";\n\nexport const isUrl = (obj: unknown): boolean => {\n\tif (!isString(obj)) {\n\t\treturn false;\n\t}\n\n\ttry {\n\t\tnew URL(obj);\n\t} catch {\n\t\treturn false;\n\t}\n\n\treturn true;\n};\n","export const nbsp = (): string => \"\\u00A0\";\n","export const toReadableFileSize = (\n\tbytes: number,\n\tuseSi: boolean = false,\n\tdecimalPlaces: number = 1,\n): string => {\n\tconst threshold = useSi ? 1000 : 1024;\n\n\tif (Math.abs(bytes) < threshold) {\n\t\treturn `${bytes} B`;\n\t}\n\n\tconst units = useSi\n\t\t? [\"kB\", \"MB\", \"GB\", \"TB\", \"PB\", \"EB\", \"ZB\", \"YB\"]\n\t\t: [\"KiB\", \"MiB\", \"GiB\", \"TiB\", \"PiB\", \"EiB\", \"ZiB\", \"YiB\"];\n\n\tlet u = -1;\n\tconst r = 10 ** decimalPlaces;\n\n\tdo {\n\t\tbytes /= threshold;\n\t\t++u;\n\t} while (\n\t\tMath.round(Math.abs(bytes) * r) / r >= threshold &&\n\t\tu < units.length - 1\n\t);\n\n\treturn `${bytes.toFixed(decimalPlaces)} ${units[u]}`;\n};\n","export const upperFirst = (value: string): string =>\n\tvalue.length > 1\n\t\t? `${value.charAt(0).toLocaleUpperCase()}${value.slice(1)}`\n\t\t: value.toLocaleUpperCase();\n"],"mappings":";AAAA,SAAS,SAAS;AAmBX,IAAM,WAAW,CAAC,QACxB,OAAO,QAAQ;;;AClBT,IAAM,QAAQ,CAAC,QAA0B;AAC/C,MAAI,CAAC,SAAS,GAAG,GAAG;AACnB,WAAO;AAAA,EACR;AAEA,MAAI;AACH,QAAI,IAAI,GAAG;AAAA,EACZ,QAAQ;AACP,WAAO;AAAA,EACR;AAEA,SAAO;AACR;;;ACdO,IAAM,OAAO,MAAc;;;ACA3B,IAAM,qBAAqB,CACjC,OACA,QAAiB,OACjB,gBAAwB,MACZ;AACZ,QAAM,YAAY,QAAQ,MAAO;AAEjC,MAAI,KAAK,IAAI,KAAK,IAAI,WAAW;AAChC,WAAO,GAAG,KAAK;AAAA,EAChB;AAEA,QAAM,QAAQ,QACX,CAAC,MAAM,MAAM,MAAM,MAAM,MAAM,MAAM,MAAM,IAAI,IAC/C,CAAC,OAAO,OAAO,OAAO,OAAO,OAAO,OAAO,OAAO,KAAK;AAE1D,MAAI,IAAI;AACR,QAAM,IAAI,MAAM;AAEhB,KAAG;AACF,aAAS;AACT,MAAE;AAAA,EACH,SACC,KAAK,MAAM,KAAK,IAAI,KAAK,IAAI,CAAC,IAAI,KAAK,aACvC,IAAI,MAAM,SAAS;AAGpB,SAAO,GAAG,MAAM,QAAQ,aAAa,CAAC,IAAI,MAAM,CAAC,CAAC;AACnD;;;AC3BO,IAAM,aAAa,CAAC,UAC1B,MAAM,SAAS,IACZ,GAAG,MAAM,OAAO,CAAC,EAAE,kBAAkB,CAAC,GAAG,MAAM,MAAM,CAAC,CAAC,KACvD,MAAM,kBAAkB;","names":[]}

package/dist/time.d.mts

@@ -0,0 +1,9 @@
+declare const getDaysInMonth: (month: number, options: {
+    isLeapYear: boolean;
+}) => number;
+
+declare const is12HourTime: (fmtOrLocale: string | Intl.DateTimeFormat) => boolean;
+
+declare const isLeapYear: (year: number) => boolean;
+
+export { getDaysInMonth, is12HourTime, isLeapYear };

package/dist/time.d.ts

@@ -0,0 +1,9 @@
+declare const getDaysInMonth: (month: number, options: {
+    isLeapYear: boolean;
+}) => number;
+
+declare const is12HourTime: (fmtOrLocale: string | Intl.DateTimeFormat) => boolean;
+
+declare const isLeapYear: (year: number) => boolean;
+
+export { getDaysInMonth, is12HourTime, isLeapYear };

package/dist/time.js

@@ -0,0 +1,50 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/time/index.ts
+var time_exports = {};
+__export(time_exports, {
+  getDaysInMonth: () => getDaysInMonth,
+  is12HourTime: () => is12HourTime,
+  isLeapYear: () => isLeapYear
+});
+module.exports = __toCommonJS(time_exports);
+
+// src/time/getDaysInMonth.ts
+var getDaysInMonth = (month, options) => new Date(options.isLeapYear ? 2e3 : 2001, month, 0).getDate();
+
+// src/types/guards.ts
+var import_zod = require("zod");
+var isString = (obj) => typeof obj === "string";
+
+// src/time/is12HourTime.ts
+var is12HourTime = (fmtOrLocale) => {
+  const fmt = isString(fmtOrLocale) ? new Intl.DateTimeFormat(fmtOrLocale) : fmtOrLocale;
+  return fmt.resolvedOptions().hour12 ?? false;
+};
+
+// src/time/isLeapYear.ts
+var isLeapYear = (year) => year % 400 === 0 || year % 100 !== 0 && year % 4 === 0;
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  getDaysInMonth,
+  is12HourTime,
+  isLeapYear
+});
+//# sourceMappingURL=time.js.map

package/dist/time.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/time/index.ts","../src/time/getDaysInMonth.ts","../src/types/guards.ts","../src/time/is12HourTime.ts","../src/time/isLeapYear.ts"],"sourcesContent":["export * from \"./getDaysInMonth\";\nexport * from \"./is12HourTime\";\nexport * from \"./isLeapYear\";\n","export const getDaysInMonth = (\n\tmonth: number,\n\toptions: { isLeapYear: boolean },\n): number => new Date(options.isLeapYear ? 2000 : 2001, month, 0).getDate();\n","import { z } from \"zod\";\n\nexport const isArray = (obj: unknown): obj is unknown[] => Array.isArray(obj);\n\nexport const isBoolean = (obj: unknown): obj is boolean =>\n\tobj === true || obj === false;\n\n// biome-ignore lint/complexity/noBannedTypes: Generic function-checking type guard.\nexport const isFunction = (obj: unknown): obj is Function =>\n\ttypeof obj === \"function\";\n\nexport const isNull = (obj: unknown): obj is null => obj === null;\n\nexport const isNullOrUndefined = (obj: unknown): obj is null | undefined =>\n\tisNull(obj) || isUndefined(obj);\n\nexport const isNumber = (obj: unknown): obj is number =>\n\ttypeof obj === \"number\";\n\nexport const isString = (obj: unknown): obj is string =>\n\ttypeof obj === \"string\";\n\nexport const isUndefined = (obj: unknown): obj is undefined =>\n\ttypeof obj === \"undefined\";\n\nexport const isUnknown = (obj: unknown): obj is unknown =>\n\tz.unknown().safeParse(obj).success;\n","import { isString } from \"../types\";\n\nexport const is12HourTime = (\n\tfmtOrLocale: string | Intl.DateTimeFormat,\n): boolean => {\n\tconst fmt = isString(fmtOrLocale)\n\t\t? new Intl.DateTimeFormat(fmtOrLocale)\n\t\t: fmtOrLocale;\n\treturn fmt.resolvedOptions().hour12 ?? false;\n};\n","export const isLeapYear = (year: number): boolean =>\n\tyear % 400 === 0 || (year % 100 !== 0 && year % 4 === 0);\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACAO,IAAM,iBAAiB,CAC7B,OACA,YACY,IAAI,KAAK,QAAQ,aAAa,MAAO,MAAM,OAAO,CAAC,EAAE,QAAQ;;;ACH1E,iBAAkB;AAmBX,IAAM,WAAW,CAAC,QACxB,OAAO,QAAQ;;;AClBT,IAAM,eAAe,CAC3B,gBACa;AACb,QAAM,MAAM,SAAS,WAAW,IAC7B,IAAI,KAAK,eAAe,WAAW,IACnC;AACH,SAAO,IAAI,gBAAgB,EAAE,UAAU;AACxC;;;ACTO,IAAM,aAAa,CAAC,SAC1B,OAAO,QAAQ,KAAM,OAAO,QAAQ,KAAK,OAAO,MAAM;","names":[]}

package/dist/time.mjs

@@ -0,0 +1,21 @@
+// src/time/getDaysInMonth.ts
+var getDaysInMonth = (month, options) => new Date(options.isLeapYear ? 2e3 : 2001, month, 0).getDate();
+
+// src/types/guards.ts
+import { z } from "zod";
+var isString = (obj) => typeof obj === "string";
+
+// src/time/is12HourTime.ts
+var is12HourTime = (fmtOrLocale) => {
+  const fmt = isString(fmtOrLocale) ? new Intl.DateTimeFormat(fmtOrLocale) : fmtOrLocale;
+  return fmt.resolvedOptions().hour12 ?? false;
+};
+
+// src/time/isLeapYear.ts
+var isLeapYear = (year) => year % 400 === 0 || year % 100 !== 0 && year % 4 === 0;
+export {
+  getDaysInMonth,
+  is12HourTime,
+  isLeapYear
+};
+//# sourceMappingURL=time.mjs.map

package/dist/time.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/time/getDaysInMonth.ts","../src/types/guards.ts","../src/time/is12HourTime.ts","../src/time/isLeapYear.ts"],"sourcesContent":["export const getDaysInMonth = (\n\tmonth: number,\n\toptions: { isLeapYear: boolean },\n): number => new Date(options.isLeapYear ? 2000 : 2001, month, 0).getDate();\n","import { z } from \"zod\";\n\nexport const isArray = (obj: unknown): obj is unknown[] => Array.isArray(obj);\n\nexport const isBoolean = (obj: unknown): obj is boolean =>\n\tobj === true || obj === false;\n\n// biome-ignore lint/complexity/noBannedTypes: Generic function-checking type guard.\nexport const isFunction = (obj: unknown): obj is Function =>\n\ttypeof obj === \"function\";\n\nexport const isNull = (obj: unknown): obj is null => obj === null;\n\nexport const isNullOrUndefined = (obj: unknown): obj is null | undefined =>\n\tisNull(obj) || isUndefined(obj);\n\nexport const isNumber = (obj: unknown): obj is number =>\n\ttypeof obj === \"number\";\n\nexport const isString = (obj: unknown): obj is string =>\n\ttypeof obj === \"string\";\n\nexport const isUndefined = (obj: unknown): obj is undefined =>\n\ttypeof obj === \"undefined\";\n\nexport const isUnknown = (obj: unknown): obj is unknown =>\n\tz.unknown().safeParse(obj).success;\n","import { isString } from \"../types\";\n\nexport const is12HourTime = (\n\tfmtOrLocale: string | Intl.DateTimeFormat,\n): boolean => {\n\tconst fmt = isString(fmtOrLocale)\n\t\t? new Intl.DateTimeFormat(fmtOrLocale)\n\t\t: fmtOrLocale;\n\treturn fmt.resolvedOptions().hour12 ?? false;\n};\n","export const isLeapYear = (year: number): boolean =>\n\tyear % 400 === 0 || (year % 100 !== 0 && year % 4 === 0);\n"],"mappings":";AAAO,IAAM,iBAAiB,CAC7B,OACA,YACY,IAAI,KAAK,QAAQ,aAAa,MAAO,MAAM,OAAO,CAAC,EAAE,QAAQ;;;ACH1E,SAAS,SAAS;AAmBX,IAAM,WAAW,CAAC,QACxB,OAAO,QAAQ;;;AClBT,IAAM,eAAe,CAC3B,gBACa;AACb,QAAM,MAAM,SAAS,WAAW,IAC7B,IAAI,KAAK,eAAe,WAAW,IACnC;AACH,SAAO,IAAI,gBAAgB,EAAE,UAAU;AACxC;;;ACTO,IAAM,aAAa,CAAC,SAC1B,OAAO,QAAQ,KAAM,OAAO,QAAQ,KAAK,OAAO,MAAM;","names":[]}

package/dist/types.d.mts

@@ -0,0 +1,11 @@
+declare const isArray: (obj: unknown) => obj is unknown[];
+declare const isBoolean: (obj: unknown) => obj is boolean;
+declare const isFunction: (obj: unknown) => obj is Function;
+declare const isNull: (obj: unknown) => obj is null;
+declare const isNullOrUndefined: (obj: unknown) => obj is null | undefined;
+declare const isNumber: (obj: unknown) => obj is number;
+declare const isString: (obj: unknown) => obj is string;
+declare const isUndefined: (obj: unknown) => obj is undefined;
+declare const isUnknown: (obj: unknown) => obj is unknown;
+
+export { isArray, isBoolean, isFunction, isNull, isNullOrUndefined, isNumber, isString, isUndefined, isUnknown };

package/dist/types.d.ts

@@ -0,0 +1,11 @@
+declare const isArray: (obj: unknown) => obj is unknown[];
+declare const isBoolean: (obj: unknown) => obj is boolean;
+declare const isFunction: (obj: unknown) => obj is Function;
+declare const isNull: (obj: unknown) => obj is null;
+declare const isNullOrUndefined: (obj: unknown) => obj is null | undefined;
+declare const isNumber: (obj: unknown) => obj is number;
+declare const isString: (obj: unknown) => obj is string;
+declare const isUndefined: (obj: unknown) => obj is undefined;
+declare const isUnknown: (obj: unknown) => obj is unknown;
+
+export { isArray, isBoolean, isFunction, isNull, isNullOrUndefined, isNumber, isString, isUndefined, isUnknown };

package/dist/types.js

@@ -0,0 +1,58 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/types/index.ts
+var types_exports = {};
+__export(types_exports, {
+  isArray: () => isArray,
+  isBoolean: () => isBoolean,
+  isFunction: () => isFunction,
+  isNull: () => isNull,
+  isNullOrUndefined: () => isNullOrUndefined,
+  isNumber: () => isNumber,
+  isString: () => isString,
+  isUndefined: () => isUndefined,
+  isUnknown: () => isUnknown
+});
+module.exports = __toCommonJS(types_exports);
+
+// src/types/guards.ts
+var import_zod = require("zod");
+var isArray = (obj) => Array.isArray(obj);
+var isBoolean = (obj) => obj === true || obj === false;
+var isFunction = (obj) => typeof obj === "function";
+var isNull = (obj) => obj === null;
+var isNullOrUndefined = (obj) => isNull(obj) || isUndefined(obj);
+var isNumber = (obj) => typeof obj === "number";
+var isString = (obj) => typeof obj === "string";
+var isUndefined = (obj) => typeof obj === "undefined";
+var isUnknown = (obj) => import_zod.z.unknown().safeParse(obj).success;
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  isArray,
+  isBoolean,
+  isFunction,
+  isNull,
+  isNullOrUndefined,
+  isNumber,
+  isString,
+  isUndefined,
+  isUnknown
+});
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/types/index.ts","../src/types/guards.ts"],"sourcesContent":["export * from \"./guards\";\n","import { z } from \"zod\";\n\nexport const isArray = (obj: unknown): obj is unknown[] => Array.isArray(obj);\n\nexport const isBoolean = (obj: unknown): obj is boolean =>\n\tobj === true || obj === false;\n\n// biome-ignore lint/complexity/noBannedTypes: Generic function-checking type guard.\nexport const isFunction = (obj: unknown): obj is Function =>\n\ttypeof obj === \"function\";\n\nexport const isNull = (obj: unknown): obj is null => obj === null;\n\nexport const isNullOrUndefined = (obj: unknown): obj is null | undefined =>\n\tisNull(obj) || isUndefined(obj);\n\nexport const isNumber = (obj: unknown): obj is number =>\n\ttypeof obj === \"number\";\n\nexport const isString = (obj: unknown): obj is string =>\n\ttypeof obj === \"string\";\n\nexport const isUndefined = (obj: unknown): obj is undefined =>\n\ttypeof obj === \"undefined\";\n\nexport const isUnknown = (obj: unknown): obj is unknown =>\n\tz.unknown().safeParse(obj).success;\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACAA,iBAAkB;AAEX,IAAM,UAAU,CAAC,QAAmC,MAAM,QAAQ,GAAG;AAErE,IAAM,YAAY,CAAC,QACzB,QAAQ,QAAQ,QAAQ;AAGlB,IAAM,aAAa,CAAC,QAC1B,OAAO,QAAQ;AAET,IAAM,SAAS,CAAC,QAA8B,QAAQ;AAEtD,IAAM,oBAAoB,CAAC,QACjC,OAAO,GAAG,KAAK,YAAY,GAAG;AAExB,IAAM,WAAW,CAAC,QACxB,OAAO,QAAQ;AAET,IAAM,WAAW,CAAC,QACxB,OAAO,QAAQ;AAET,IAAM,cAAc,CAAC,QAC3B,OAAO,QAAQ;AAET,IAAM,YAAY,CAAC,QACzB,aAAE,QAAQ,EAAE,UAAU,GAAG,EAAE;","names":[]}

package/dist/types.mjs

@@ -0,0 +1,23 @@
+// src/types/guards.ts
+import { z } from "zod";
+var isArray = (obj) => Array.isArray(obj);
+var isBoolean = (obj) => obj === true || obj === false;
+var isFunction = (obj) => typeof obj === "function";
+var isNull = (obj) => obj === null;
+var isNullOrUndefined = (obj) => isNull(obj) || isUndefined(obj);
+var isNumber = (obj) => typeof obj === "number";
+var isString = (obj) => typeof obj === "string";
+var isUndefined = (obj) => typeof obj === "undefined";
+var isUnknown = (obj) => z.unknown().safeParse(obj).success;
+export {
+  isArray,
+  isBoolean,
+  isFunction,
+  isNull,
+  isNullOrUndefined,
+  isNumber,
+  isString,
+  isUndefined,
+  isUnknown
+};
+//# sourceMappingURL=types.mjs.map

package/dist/types.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/types/guards.ts"],"sourcesContent":["import { z } from \"zod\";\n\nexport const isArray = (obj: unknown): obj is unknown[] => Array.isArray(obj);\n\nexport const isBoolean = (obj: unknown): obj is boolean =>\n\tobj === true || obj === false;\n\n// biome-ignore lint/complexity/noBannedTypes: Generic function-checking type guard.\nexport const isFunction = (obj: unknown): obj is Function =>\n\ttypeof obj === \"function\";\n\nexport const isNull = (obj: unknown): obj is null => obj === null;\n\nexport const isNullOrUndefined = (obj: unknown): obj is null | undefined =>\n\tisNull(obj) || isUndefined(obj);\n\nexport const isNumber = (obj: unknown): obj is number =>\n\ttypeof obj === \"number\";\n\nexport const isString = (obj: unknown): obj is string =>\n\ttypeof obj === \"string\";\n\nexport const isUndefined = (obj: unknown): obj is undefined =>\n\ttypeof obj === \"undefined\";\n\nexport const isUnknown = (obj: unknown): obj is unknown =>\n\tz.unknown().safeParse(obj).success;\n"],"mappings":";AAAA,SAAS,SAAS;AAEX,IAAM,UAAU,CAAC,QAAmC,MAAM,QAAQ,GAAG;AAErE,IAAM,YAAY,CAAC,QACzB,QAAQ,QAAQ,QAAQ;AAGlB,IAAM,aAAa,CAAC,QAC1B,OAAO,QAAQ;AAET,IAAM,SAAS,CAAC,QAA8B,QAAQ;AAEtD,IAAM,oBAAoB,CAAC,QACjC,OAAO,GAAG,KAAK,YAAY,GAAG;AAExB,IAAM,WAAW,CAAC,QACxB,OAAO,QAAQ;AAET,IAAM,WAAW,CAAC,QACxB,OAAO,QAAQ;AAET,IAAM,cAAc,CAAC,QAC3B,OAAO,QAAQ;AAET,IAAM,YAAY,CAAC,QACzB,EAAE,QAAQ,EAAE,UAAU,GAAG,EAAE;","names":[]}

package/dist/values.d.mts

@@ -0,0 +1,8 @@
+type Failure = string | Error;
+type InvariantAssertion = (value: unknown) => asserts value;
+type InvariantAssertionWithMessage = (value: unknown, failure?: Failure | (() => Failure)) => asserts value;
+declare const invariant: InvariantAssertionWithMessage;
+
+declare const unreachable: (_: never) => never;
+
+export { type InvariantAssertion, type InvariantAssertionWithMessage, invariant, unreachable };

package/dist/values.d.ts

@@ -0,0 +1,8 @@
+type Failure = string | Error;
+type InvariantAssertion = (value: unknown) => asserts value;
+type InvariantAssertionWithMessage = (value: unknown, failure?: Failure | (() => Failure)) => asserts value;
+declare const invariant: InvariantAssertionWithMessage;
+
+declare const unreachable: (_: never) => never;
+
+export { type InvariantAssertion, type InvariantAssertionWithMessage, invariant, unreachable };

package/dist/values.js

@@ -0,0 +1,58 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/values/index.ts
+var values_exports = {};
+__export(values_exports, {
+  invariant: () => invariant,
+  unreachable: () => unreachable
+});
+module.exports = __toCommonJS(values_exports);
+
+// src/types/guards.ts
+var import_zod = require("zod");
+var isFunction = (obj) => typeof obj === "function";
+var isNull = (obj) => obj === null;
+var isNullOrUndefined = (obj) => isNull(obj) || isUndefined(obj);
+var isString = (obj) => typeof obj === "string";
+var isUndefined = (obj) => typeof obj === "undefined";
+
+// src/values/invariant.ts
+var invariant = (value, failure) => {
+  if (value === false || isNullOrUndefined(value)) {
+    const failureOutput = isFunction(failure) ? failure() : failure;
+    if (isString(failureOutput)) {
+      throw new Error(
+        failureOutput || `Assertion failed on value '${value}'.`
+      );
+    }
+    throw failureOutput;
+  }
+};
+
+// src/values/unreachable.ts
+var unreachable = (_) => {
+  throw new Error("Unreachable code was reached at runtime.");
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  invariant,
+  unreachable
+});
+//# sourceMappingURL=values.js.map

package/dist/values.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/values/index.ts","../src/types/guards.ts","../src/values/invariant.ts","../src/values/unreachable.ts"],"sourcesContent":["export * from \"./invariant\";\nexport * from \"./unreachable\";\n","import { z } from \"zod\";\n\nexport const isArray = (obj: unknown): obj is unknown[] => Array.isArray(obj);\n\nexport const isBoolean = (obj: unknown): obj is boolean =>\n\tobj === true || obj === false;\n\n// biome-ignore lint/complexity/noBannedTypes: Generic function-checking type guard.\nexport const isFunction = (obj: unknown): obj is Function =>\n\ttypeof obj === \"function\";\n\nexport const isNull = (obj: unknown): obj is null => obj === null;\n\nexport const isNullOrUndefined = (obj: unknown): obj is null | undefined =>\n\tisNull(obj) || isUndefined(obj);\n\nexport const isNumber = (obj: unknown): obj is number =>\n\ttypeof obj === \"number\";\n\nexport const isString = (obj: unknown): obj is string =>\n\ttypeof obj === \"string\";\n\nexport const isUndefined = (obj: unknown): obj is undefined =>\n\ttypeof obj === \"undefined\";\n\nexport const isUnknown = (obj: unknown): obj is unknown =>\n\tz.unknown().safeParse(obj).success;\n","import { isFunction, isNullOrUndefined, isString } from \"../types/guards\";\n\ntype Failure = string | Error;\n\nexport type InvariantAssertion = (value: unknown) => asserts value;\n\nexport type InvariantAssertionWithMessage = (\n\tvalue: unknown,\n\tfailure?: Failure | (() => Failure),\n) => asserts value;\n\nexport const invariant: InvariantAssertionWithMessage = (\n\tvalue,\n\tfailure,\n): asserts value => {\n\tif (value === false || isNullOrUndefined(value)) {\n\t\tconst failureOutput = isFunction(failure) ? failure() : failure;\n\n\t\tif (isString(failureOutput)) {\n\t\t\tthrow new Error(\n\t\t\t\tfailureOutput || `Assertion failed on value '${value}'.`,\n\t\t\t);\n\t\t}\n\n\t\tthrow failureOutput;\n\t}\n};\n","export const unreachable = (_: never): never => {\n\tthrow new Error(\"Unreachable code was reached at runtime.\");\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACAA,iBAAkB;AAQX,IAAM,aAAa,CAAC,QAC1B,OAAO,QAAQ;AAET,IAAM,SAAS,CAAC,QAA8B,QAAQ;AAEtD,IAAM,oBAAoB,CAAC,QACjC,OAAO,GAAG,KAAK,YAAY,GAAG;AAKxB,IAAM,WAAW,CAAC,QACxB,OAAO,QAAQ;AAET,IAAM,cAAc,CAAC,QAC3B,OAAO,QAAQ;;;ACZT,IAAM,YAA2C,CACvD,OACA,YACmB;AACnB,MAAI,UAAU,SAAS,kBAAkB,KAAK,GAAG;AAChD,UAAM,gBAAgB,WAAW,OAAO,IAAI,QAAQ,IAAI;AAExD,QAAI,SAAS,aAAa,GAAG;AAC5B,YAAM,IAAI;AAAA,QACT,iBAAiB,8BAA8B,KAAK;AAAA,MACrD;AAAA,IACD;AAEA,UAAM;AAAA,EACP;AACD;;;AC1BO,IAAM,cAAc,CAAC,MAAoB;AAC/C,QAAM,IAAI,MAAM,0CAA0C;AAC3D;","names":[]}

package/dist/values.mjs

@@ -0,0 +1,30 @@
+// src/types/guards.ts
+import { z } from "zod";
+var isFunction = (obj) => typeof obj === "function";
+var isNull = (obj) => obj === null;
+var isNullOrUndefined = (obj) => isNull(obj) || isUndefined(obj);
+var isString = (obj) => typeof obj === "string";
+var isUndefined = (obj) => typeof obj === "undefined";
+
+// src/values/invariant.ts
+var invariant = (value, failure) => {
+  if (value === false || isNullOrUndefined(value)) {
+    const failureOutput = isFunction(failure) ? failure() : failure;
+    if (isString(failureOutput)) {
+      throw new Error(
+        failureOutput || `Assertion failed on value '${value}'.`
+      );
+    }
+    throw failureOutput;
+  }
+};
+
+// src/values/unreachable.ts
+var unreachable = (_) => {
+  throw new Error("Unreachable code was reached at runtime.");
+};
+export {
+  invariant,
+  unreachable
+};
+//# sourceMappingURL=values.mjs.map

package/dist/values.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/types/guards.ts","../src/values/invariant.ts","../src/values/unreachable.ts"],"sourcesContent":["import { z } from \"zod\";\n\nexport const isArray = (obj: unknown): obj is unknown[] => Array.isArray(obj);\n\nexport const isBoolean = (obj: unknown): obj is boolean =>\n\tobj === true || obj === false;\n\n// biome-ignore lint/complexity/noBannedTypes: Generic function-checking type guard.\nexport const isFunction = (obj: unknown): obj is Function =>\n\ttypeof obj === \"function\";\n\nexport const isNull = (obj: unknown): obj is null => obj === null;\n\nexport const isNullOrUndefined = (obj: unknown): obj is null | undefined =>\n\tisNull(obj) || isUndefined(obj);\n\nexport const isNumber = (obj: unknown): obj is number =>\n\ttypeof obj === \"number\";\n\nexport const isString = (obj: unknown): obj is string =>\n\ttypeof obj === \"string\";\n\nexport const isUndefined = (obj: unknown): obj is undefined =>\n\ttypeof obj === \"undefined\";\n\nexport const isUnknown = (obj: unknown): obj is unknown =>\n\tz.unknown().safeParse(obj).success;\n","import { isFunction, isNullOrUndefined, isString } from \"../types/guards\";\n\ntype Failure = string | Error;\n\nexport type InvariantAssertion = (value: unknown) => asserts value;\n\nexport type InvariantAssertionWithMessage = (\n\tvalue: unknown,\n\tfailure?: Failure | (() => Failure),\n) => asserts value;\n\nexport const invariant: InvariantAssertionWithMessage = (\n\tvalue,\n\tfailure,\n): asserts value => {\n\tif (value === false || isNullOrUndefined(value)) {\n\t\tconst failureOutput = isFunction(failure) ? failure() : failure;\n\n\t\tif (isString(failureOutput)) {\n\t\t\tthrow new Error(\n\t\t\t\tfailureOutput || `Assertion failed on value '${value}'.`,\n\t\t\t);\n\t\t}\n\n\t\tthrow failureOutput;\n\t}\n};\n","export const unreachable = (_: never): never => {\n\tthrow new Error(\"Unreachable code was reached at runtime.\");\n};\n"],"mappings":";AAAA,SAAS,SAAS;AAQX,IAAM,aAAa,CAAC,QAC1B,OAAO,QAAQ;AAET,IAAM,SAAS,CAAC,QAA8B,QAAQ;AAEtD,IAAM,oBAAoB,CAAC,QACjC,OAAO,GAAG,KAAK,YAAY,GAAG;AAKxB,IAAM,WAAW,CAAC,QACxB,OAAO,QAAQ;AAET,IAAM,cAAc,CAAC,QAC3B,OAAO,QAAQ;;;ACZT,IAAM,YAA2C,CACvD,OACA,YACmB;AACnB,MAAI,UAAU,SAAS,kBAAkB,KAAK,GAAG;AAChD,UAAM,gBAAgB,WAAW,OAAO,IAAI,QAAQ,IAAI;AAExD,QAAI,SAAS,aAAa,GAAG;AAC5B,YAAM,IAAI;AAAA,QACT,iBAAiB,8BAA8B,KAAK;AAAA,MACrD;AAAA,IACD;AAEA,UAAM;AAAA,EACP;AACD;;;AC1BO,IAAM,cAAc,CAAC,MAAoB;AAC/C,QAAM,IAAI,MAAM,0CAA0C;AAC3D;","names":[]}

package/package.json

@@ -0,0 +1,40 @@
+{
+	"name": "@ekumlin/typescript-toolkit",
+	"version": "1.0.0",
+	"repository": "github:ek68794998/typescript-toolkit.git",
+	"exports": {
+		"./collections": "./dist/collections.js",
+		"./dom": "./dist/dom.js",
+		"./environment": "./dist/environment.js",
+		"./error": "./dist/error.js",
+		"./http": "./dist/http.js",
+		"./io": "./dist/io.js",
+		"./number": "./dist/number.js",
+		"./promise": "./dist/promise.js",
+		"./routing": "./dist/routing.js",
+		"./string": "./dist/string.js",
+		"./time": "./dist/time.js",
+		"./types": "./dist/types.js",
+		"./values": "./dist/values.js"
+	},
+	"publishConfig": {
+		"access": "public"
+	},
+	"files": [
+		"dist"
+	],
+	"scripts": {
+		"build": "tsup",
+		"dev": "tsup --watch",
+		"lint": "tsc --noEmit",
+		"release": "pnpm build && npm publish",
+		"test": "vitest"
+	},
+	"dependencies": {
+		"zod": "^4.0.0"
+	},
+	"devDependencies": {
+		"@types/node": "^22.13.10",
+		"typescript": "5.9.2"
+	}
+}