@jfdevelops/multi-step-form-core 1.0.0-alpha.17 → 1.0.0-alpha.19

package/dist/utils/casing.cjs

@@ -0,0 +1,63 @@
+
+//#region src/utils/casing.ts
+const CASING_TYPES = [
+	"sentence",
+	"title",
+	"camel",
+	"lower",
+	"upper",
+	"pascal",
+	"snake",
+	"screaming-snake",
+	"flat",
+	"kebab"
+];
+const DEFAULT_CASING = "title";
+function changeCasing(input, type) {
+	const words = input.replace(/([a-z])([A-Z])/g, "$1 $2").replace(/[-_]+/g, " ").trim().split(/\s+/).map((w) => w.toLowerCase());
+	switch (type) {
+		case "sentence": return words[0].charAt(0).toUpperCase() + words[0].slice(1) + (words.length > 1 ? " " + words.slice(1).join(" ") : "");
+		case "title": return words.map((w) => w.charAt(0).toUpperCase() + w.slice(1)).join(" ");
+		case "camel": return words[0] + words.slice(1).map((w) => w.charAt(0).toUpperCase() + w.slice(1)).join("");
+		case "pascal": return words.map((w) => w.charAt(0).toUpperCase() + w.slice(1)).join("");
+		case "lower": return words.join(" ");
+		case "upper": return words.join(" ").toUpperCase();
+		case "snake": return words.join("_");
+		case "screaming-snake": return words.join("_").toUpperCase();
+		case "kebab": return words.join("-");
+		case "flat": return words.join("");
+		default: return input;
+	}
+}
+function quote(str, quoteChar = "\"") {
+	const startsWithQuote = str.startsWith(quoteChar);
+	const endsWithQuote = str.endsWith(quoteChar);
+	if (startsWithQuote && endsWithQuote) return str;
+	return `${quoteChar}${str.replace(/^['"]|['"]$/g, "")}${quoteChar}`;
+}
+function isCasingValid(value) {
+	if (typeof value !== "string") return false;
+	return CASING_TYPES.includes(value);
+}
+/**
+* Validates {@linkcode input} is a valid {@linkcode CasingType}.
+*
+* If there is no explicit {@linkcode fallback} value provided,
+* it will default to {@linkcode DEFAULT_CASING}.
+* @param input The input to check.
+* @param fallback An optional fallback value if {@linkcode input} is `undefined`.
+* @returns The {@linkcode input} or {@linkcode fallback} if {@linkcode input} is `undefined` or an {@linkcode isCasingValid invalid} {@linkcode CasingType}.
+*/
+function setCasingType(input, fallback = DEFAULT_CASING) {
+	if (isCasingValid(input)) return input;
+	return fallback;
+}
+
+//#endregion
+exports.CASING_TYPES = CASING_TYPES;
+exports.DEFAULT_CASING = DEFAULT_CASING;
+exports.changeCasing = changeCasing;
+exports.isCasingValid = isCasingValid;
+exports.quote = quote;
+exports.setCasingType = setCasingType;
+//# sourceMappingURL=casing.cjs.map

package/dist/utils/casing.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"casing.cjs","names":["DEFAULT_CASING: SetDefaultString<CasingType, 'title'>"],"sources":["../../src/utils/casing.ts"],"sourcesContent":["import type { Expand, SetDefaultString } from './types';\n\nexport type CasingType = (typeof CASING_TYPES)[number];\nexport type ToLower<S extends string> = S extends `${infer F}${infer R}`\n  ? `${Lowercase<F>}${ToLower<R>}`\n  : S;\n\nexport type CapitalizeWord<S extends string> = S extends `${infer F}${infer R}`\n  ? `${Uppercase<F>}${ToLower<R>}`\n  : S;\n// Pascal => Capitalize each \"word\" chunk\ntype Pascalize<S extends string> = Capitalize<S>; // naive\n\n// SnakeCase: turn spaces/hyphens into underscores, lowercase\ntype SnakeCase<S extends string> = Lowercase<\n  S extends `${infer A} ${infer B}`\n    ? `${A}_${SnakeCase<B>}`\n    : S extends `${infer A}-${infer B}`\n    ? `${A}_${SnakeCase<B>}`\n    : S\n>;\n\n// KebabCase: same as snake but with \"-\"\ntype KebabCase<S extends string> = Lowercase<\n  S extends `${infer A} ${infer B}`\n    ? `${A}-${KebabCase<B>}`\n    : S extends `${infer A}_${infer B}`\n    ? `${A}-${KebabCase<B>}`\n    : S\n>;\n\n// Flat: just strip spaces/underscores/hyphens\ntype RemoveDelimiters<S extends string> = S extends `${infer A} ${infer B}`\n  ? `${A}${RemoveDelimiters<B>}`\n  : S extends `${infer A}_${infer B}`\n  ? `${A}${RemoveDelimiters<B>}`\n  : S extends `${infer A}-${infer B}`\n  ? `${A}${RemoveDelimiters<B>}`\n  : S;\n\n// TitleCase: Capitalize the whole thing\ntype TitleCase<S extends string> = Capitalize<Lowercase<S>>;\n\n// SentenceCase: First word capped, rest lower\ntype SentenceCase<S extends string> = Capitalize<Lowercase<S>>;\nexport type ChangeCasing<\n  S extends string,\n  T extends CasingType\n> = T extends 'lower'\n  ? Lowercase<S>\n  : T extends 'upper'\n  ? Uppercase<S>\n  : T extends 'camel'\n  ? Uncapitalize<Pascalize<S>>\n  : T extends 'pascal'\n  ? Pascalize<S>\n  : T extends 'snake'\n  ? SnakeCase<S>\n  : T extends 'screaming-snake'\n  ? Uppercase<SnakeCase<S>>\n  : T extends 'kebab'\n  ? KebabCase<S>\n  : T extends 'flat'\n  ? RemoveDelimiters<Lowercase<S>>\n  : T extends 'title'\n  ? TitleCase<S>\n  : T extends 'sentence'\n  ? SentenceCase<S>\n  : S;\nexport type ChangeObjectCasing<\n  T extends object,\n  TCasing extends CasingType\n> = Expand<{\n  [K in keyof T as K extends string ? ChangeCasing<K, TCasing> : K]: T[K];\n}>;\n\nexport const CASING_TYPES = [\n  'sentence',\n  'title',\n  'camel',\n  'lower',\n  'upper',\n  'pascal',\n  'snake',\n  'screaming-snake',\n  'flat',\n  'kebab',\n] as const;\n\nexport type DefaultCasing = typeof DEFAULT_CASING;\nexport const DEFAULT_CASING: SetDefaultString<CasingType, 'title'> = 'title';\n\n/**\n * Changes the casing of a string according to the specified casing type.\n *\n * @param input - The string to transform.\n * @param type - The casing type to apply.\n * @returns The transformed string in the specified casing.\n */\n// TODO make return type safe\nexport function changeCasing<TValue extends string, TType extends CasingType>(\n  input: TValue,\n  type: TType\n): ChangeCasing<TValue, TType>;\nexport function changeCasing<TValue extends string, TType extends CasingType>(\n  input: TValue,\n  type: TType\n) {\n  // Step 1: Normalize to words\n  const words = input\n    // Replace camelCase boundaries with space\n    .replace(/([a-z])([A-Z])/g, '$1 $2')\n    // Replace separators with space\n    .replace(/[-_]+/g, ' ')\n    // Trim and split into words\n    .trim()\n    .split(/\\s+/)\n    .map((w) => w.toLowerCase());\n\n  // Step 2: Apply casing\n  switch (type) {\n    case 'sentence':\n      return (\n        words[0].charAt(0).toUpperCase() +\n        words[0].slice(1) +\n        (words.length > 1 ? ' ' + words.slice(1).join(' ') : '')\n      );\n\n    case 'title':\n      return words.map((w) => w.charAt(0).toUpperCase() + w.slice(1)).join(' ');\n\n    case 'camel':\n      return (\n        words[0] +\n        words\n          .slice(1)\n          .map((w) => w.charAt(0).toUpperCase() + w.slice(1))\n          .join('')\n      );\n\n    case 'pascal':\n      return words.map((w) => w.charAt(0).toUpperCase() + w.slice(1)).join('');\n\n    case 'lower':\n      return words.join(' ');\n\n    case 'upper':\n      return words.join(' ').toUpperCase();\n\n    case 'snake':\n      return words.join('_');\n\n    case 'screaming-snake':\n      return words.join('_').toUpperCase();\n\n    case 'kebab':\n      return words.join('-');\n\n    case 'flat':\n      return words.join('');\n\n    default:\n      return input;\n  }\n}\n\nexport function quote(str: string, quoteChar: '\"' | \"'\" = '\"') {\n  const startsWithQuote = str.startsWith(quoteChar);\n  const endsWithQuote = str.endsWith(quoteChar);\n\n  if (startsWithQuote && endsWithQuote) {\n    // Already wrapped correctly\n    return str;\n  }\n\n  // If it starts or ends with a quote but not both → strip those first\n  const trimmed = str.replace(/^['\"]|['\"]$/g, '');\n\n  // Then add new quotes consistently\n  return `${quoteChar}${trimmed}${quoteChar}`;\n}\n\nexport function isCasingValid(value: unknown): value is CasingType {\n  if (typeof value !== 'string') {\n    return false;\n  }\n\n  const isValid = CASING_TYPES.includes(value as CasingType);\n\n  // invariant(isValid, () => {\n  //   const formatter = new Intl.ListFormat('en', {\n  //     style: 'long',\n  //     type: 'conjunction',\n  //   });\n\n  //   return `${value} is not a valid casing type. Valid types include ${formatter.format(\n  //     CASING_TYPES.map((word) => quote(word))\n  //   )}`;\n  // });\n\n  return isValid;\n}\n\n/**\n * Validates {@linkcode input} is a valid {@linkcode CasingType}.\n *\n * If there is no explicit {@linkcode fallback} value provided,\n * it will default to {@linkcode DEFAULT_CASING}.\n * @param input The input to check.\n * @param fallback An optional fallback value if {@linkcode input} is `undefined`.\n * @returns The {@linkcode input} or {@linkcode fallback} if {@linkcode input} is `undefined` or an {@linkcode isCasingValid invalid} {@linkcode CasingType}.\n */\nexport function setCasingType<TCasing extends CasingType>(\n  input: TCasing | undefined,\n  fallback: CasingType = DEFAULT_CASING\n) {\n  if (isCasingValid(input)) {\n    return input;\n  }\n\n  return fallback;\n}\n"],"mappings":";;AA4EA,MAAa,eAAe;CAC1B;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACD;AAGD,MAAaA,iBAAwD;AAcrE,SAAgB,aACd,OACA,MACA;CAEA,MAAM,QAAQ,MAEX,QAAQ,mBAAmB,QAAQ,CAEnC,QAAQ,UAAU,IAAI,CAEtB,MAAM,CACN,MAAM,MAAM,CACZ,KAAK,MAAM,EAAE,aAAa,CAAC;AAG9B,SAAQ,MAAR;EACE,KAAK,WACH,QACE,MAAM,GAAG,OAAO,EAAE,CAAC,aAAa,GAChC,MAAM,GAAG,MAAM,EAAE,IAChB,MAAM,SAAS,IAAI,MAAM,MAAM,MAAM,EAAE,CAAC,KAAK,IAAI,GAAG;EAGzD,KAAK,QACH,QAAO,MAAM,KAAK,MAAM,EAAE,OAAO,EAAE,CAAC,aAAa,GAAG,EAAE,MAAM,EAAE,CAAC,CAAC,KAAK,IAAI;EAE3E,KAAK,QACH,QACE,MAAM,KACN,MACG,MAAM,EAAE,CACR,KAAK,MAAM,EAAE,OAAO,EAAE,CAAC,aAAa,GAAG,EAAE,MAAM,EAAE,CAAC,CAClD,KAAK,GAAG;EAGf,KAAK,SACH,QAAO,MAAM,KAAK,MAAM,EAAE,OAAO,EAAE,CAAC,aAAa,GAAG,EAAE,MAAM,EAAE,CAAC,CAAC,KAAK,GAAG;EAE1E,KAAK,QACH,QAAO,MAAM,KAAK,IAAI;EAExB,KAAK,QACH,QAAO,MAAM,KAAK,IAAI,CAAC,aAAa;EAEtC,KAAK,QACH,QAAO,MAAM,KAAK,IAAI;EAExB,KAAK,kBACH,QAAO,MAAM,KAAK,IAAI,CAAC,aAAa;EAEtC,KAAK,QACH,QAAO,MAAM,KAAK,IAAI;EAExB,KAAK,OACH,QAAO,MAAM,KAAK,GAAG;EAEvB,QACE,QAAO;;;AAIb,SAAgB,MAAM,KAAa,YAAuB,MAAK;CAC7D,MAAM,kBAAkB,IAAI,WAAW,UAAU;CACjD,MAAM,gBAAgB,IAAI,SAAS,UAAU;AAE7C,KAAI,mBAAmB,cAErB,QAAO;AAOT,QAAO,GAAG,YAHM,IAAI,QAAQ,gBAAgB,GAAG,GAGf;;AAGlC,SAAgB,cAAc,OAAqC;AACjE,KAAI,OAAO,UAAU,SACnB,QAAO;AAgBT,QAbgB,aAAa,SAAS,MAAoB;;;;;;;;;;;AAyB5D,SAAgB,cACd,OACA,WAAuB,gBACvB;AACA,KAAI,cAAc,MAAM,CACtB,QAAO;AAGT,QAAO"}

package/dist/utils/casing.d.cts

@@ -0,0 +1,40 @@
+import { Expand, SetDefaultString } from "./types.cjs";
+
+//#region src/utils/casing.d.ts
+type CasingType = (typeof CASING_TYPES)[number];
+type ToLower<S extends string> = S extends `${infer F}${infer R}` ? `${Lowercase<F>}${ToLower<R>}` : S;
+type CapitalizeWord<S extends string> = S extends `${infer F}${infer R}` ? `${Uppercase<F>}${ToLower<R>}` : S;
+type Pascalize<S extends string> = Capitalize<S>;
+type SnakeCase<S extends string> = Lowercase<S extends `${infer A} ${infer B}` ? `${A}_${SnakeCase<B>}` : S extends `${infer A}-${infer B}` ? `${A}_${SnakeCase<B>}` : S>;
+type KebabCase<S extends string> = Lowercase<S extends `${infer A} ${infer B}` ? `${A}-${KebabCase<B>}` : S extends `${infer A}_${infer B}` ? `${A}-${KebabCase<B>}` : S>;
+type RemoveDelimiters<S extends string> = S extends `${infer A} ${infer B}` ? `${A}${RemoveDelimiters<B>}` : S extends `${infer A}_${infer B}` ? `${A}${RemoveDelimiters<B>}` : S extends `${infer A}-${infer B}` ? `${A}${RemoveDelimiters<B>}` : S;
+type TitleCase<S extends string> = Capitalize<Lowercase<S>>;
+type SentenceCase<S extends string> = Capitalize<Lowercase<S>>;
+type ChangeCasing<S extends string, T extends CasingType> = T extends 'lower' ? Lowercase<S> : T extends 'upper' ? Uppercase<S> : T extends 'camel' ? Uncapitalize<Pascalize<S>> : T extends 'pascal' ? Pascalize<S> : T extends 'snake' ? SnakeCase<S> : T extends 'screaming-snake' ? Uppercase<SnakeCase<S>> : T extends 'kebab' ? KebabCase<S> : T extends 'flat' ? RemoveDelimiters<Lowercase<S>> : T extends 'title' ? TitleCase<S> : T extends 'sentence' ? SentenceCase<S> : S;
+type ChangeObjectCasing<T extends object, TCasing extends CasingType> = Expand<{ [K in keyof T as K extends string ? ChangeCasing<K, TCasing> : K]: T[K] }>;
+declare const CASING_TYPES: readonly ["sentence", "title", "camel", "lower", "upper", "pascal", "snake", "screaming-snake", "flat", "kebab"];
+type DefaultCasing = typeof DEFAULT_CASING;
+declare const DEFAULT_CASING: SetDefaultString<CasingType, 'title'>;
+/**
+ * Changes the casing of a string according to the specified casing type.
+ *
+ * @param input - The string to transform.
+ * @param type - The casing type to apply.
+ * @returns The transformed string in the specified casing.
+ */
+declare function changeCasing<TValue extends string, TType extends CasingType>(input: TValue, type: TType): ChangeCasing<TValue, TType>;
+declare function quote(str: string, quoteChar?: '"' | "'"): string;
+declare function isCasingValid(value: unknown): value is CasingType;
+/**
+ * Validates {@linkcode input} is a valid {@linkcode CasingType}.
+ *
+ * If there is no explicit {@linkcode fallback} value provided,
+ * it will default to {@linkcode DEFAULT_CASING}.
+ * @param input The input to check.
+ * @param fallback An optional fallback value if {@linkcode input} is `undefined`.
+ * @returns The {@linkcode input} or {@linkcode fallback} if {@linkcode input} is `undefined` or an {@linkcode isCasingValid invalid} {@linkcode CasingType}.
+ */
+declare function setCasingType<TCasing extends CasingType>(input: TCasing | undefined, fallback?: CasingType): "sentence" | "title" | "camel" | "lower" | "upper" | "pascal" | "snake" | "screaming-snake" | "flat" | "kebab";
+//#endregion
+export { CASING_TYPES, CapitalizeWord, CasingType, ChangeCasing, ChangeObjectCasing, DEFAULT_CASING, DefaultCasing, ToLower, changeCasing, isCasingValid, quote, setCasingType };
+//# sourceMappingURL=casing.d.cts.map

package/dist/utils/casing.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"casing.d.cts","names":[],"sources":["../../src/utils/casing.ts"],"sourcesContent":[],"mappings":"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"}

package/dist/utils/casing.d.mts

@@ -0,0 +1,40 @@
+import { Expand, SetDefaultString } from "./types.mjs";
+
+//#region src/utils/casing.d.ts
+type CasingType = (typeof CASING_TYPES)[number];
+type ToLower<S extends string> = S extends `${infer F}${infer R}` ? `${Lowercase<F>}${ToLower<R>}` : S;
+type CapitalizeWord<S extends string> = S extends `${infer F}${infer R}` ? `${Uppercase<F>}${ToLower<R>}` : S;
+type Pascalize<S extends string> = Capitalize<S>;
+type SnakeCase<S extends string> = Lowercase<S extends `${infer A} ${infer B}` ? `${A}_${SnakeCase<B>}` : S extends `${infer A}-${infer B}` ? `${A}_${SnakeCase<B>}` : S>;
+type KebabCase<S extends string> = Lowercase<S extends `${infer A} ${infer B}` ? `${A}-${KebabCase<B>}` : S extends `${infer A}_${infer B}` ? `${A}-${KebabCase<B>}` : S>;
+type RemoveDelimiters<S extends string> = S extends `${infer A} ${infer B}` ? `${A}${RemoveDelimiters<B>}` : S extends `${infer A}_${infer B}` ? `${A}${RemoveDelimiters<B>}` : S extends `${infer A}-${infer B}` ? `${A}${RemoveDelimiters<B>}` : S;
+type TitleCase<S extends string> = Capitalize<Lowercase<S>>;
+type SentenceCase<S extends string> = Capitalize<Lowercase<S>>;
+type ChangeCasing<S extends string, T extends CasingType> = T extends 'lower' ? Lowercase<S> : T extends 'upper' ? Uppercase<S> : T extends 'camel' ? Uncapitalize<Pascalize<S>> : T extends 'pascal' ? Pascalize<S> : T extends 'snake' ? SnakeCase<S> : T extends 'screaming-snake' ? Uppercase<SnakeCase<S>> : T extends 'kebab' ? KebabCase<S> : T extends 'flat' ? RemoveDelimiters<Lowercase<S>> : T extends 'title' ? TitleCase<S> : T extends 'sentence' ? SentenceCase<S> : S;
+type ChangeObjectCasing<T extends object, TCasing extends CasingType> = Expand<{ [K in keyof T as K extends string ? ChangeCasing<K, TCasing> : K]: T[K] }>;
+declare const CASING_TYPES: readonly ["sentence", "title", "camel", "lower", "upper", "pascal", "snake", "screaming-snake", "flat", "kebab"];
+type DefaultCasing = typeof DEFAULT_CASING;
+declare const DEFAULT_CASING: SetDefaultString<CasingType, 'title'>;
+/**
+ * Changes the casing of a string according to the specified casing type.
+ *
+ * @param input - The string to transform.
+ * @param type - The casing type to apply.
+ * @returns The transformed string in the specified casing.
+ */
+declare function changeCasing<TValue extends string, TType extends CasingType>(input: TValue, type: TType): ChangeCasing<TValue, TType>;
+declare function quote(str: string, quoteChar?: '"' | "'"): string;
+declare function isCasingValid(value: unknown): value is CasingType;
+/**
+ * Validates {@linkcode input} is a valid {@linkcode CasingType}.
+ *
+ * If there is no explicit {@linkcode fallback} value provided,
+ * it will default to {@linkcode DEFAULT_CASING}.
+ * @param input The input to check.
+ * @param fallback An optional fallback value if {@linkcode input} is `undefined`.
+ * @returns The {@linkcode input} or {@linkcode fallback} if {@linkcode input} is `undefined` or an {@linkcode isCasingValid invalid} {@linkcode CasingType}.
+ */
+declare function setCasingType<TCasing extends CasingType>(input: TCasing | undefined, fallback?: CasingType): "sentence" | "title" | "camel" | "lower" | "upper" | "pascal" | "snake" | "screaming-snake" | "flat" | "kebab";
+//#endregion
+export { CASING_TYPES, CapitalizeWord, CasingType, ChangeCasing, ChangeObjectCasing, DEFAULT_CASING, DefaultCasing, ToLower, changeCasing, isCasingValid, quote, setCasingType };
+//# sourceMappingURL=casing.d.mts.map

package/dist/utils/casing.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"casing.d.mts","names":[],"sources":["../../src/utils/casing.ts"],"sourcesContent":[],"mappings":"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"}

package/dist/utils/casing.mjs

@@ -0,0 +1,57 @@
+//#region src/utils/casing.ts
+const CASING_TYPES = [
+	"sentence",
+	"title",
+	"camel",
+	"lower",
+	"upper",
+	"pascal",
+	"snake",
+	"screaming-snake",
+	"flat",
+	"kebab"
+];
+const DEFAULT_CASING = "title";
+function changeCasing(input, type) {
+	const words = input.replace(/([a-z])([A-Z])/g, "$1 $2").replace(/[-_]+/g, " ").trim().split(/\s+/).map((w) => w.toLowerCase());
+	switch (type) {
+		case "sentence": return words[0].charAt(0).toUpperCase() + words[0].slice(1) + (words.length > 1 ? " " + words.slice(1).join(" ") : "");
+		case "title": return words.map((w) => w.charAt(0).toUpperCase() + w.slice(1)).join(" ");
+		case "camel": return words[0] + words.slice(1).map((w) => w.charAt(0).toUpperCase() + w.slice(1)).join("");
+		case "pascal": return words.map((w) => w.charAt(0).toUpperCase() + w.slice(1)).join("");
+		case "lower": return words.join(" ");
+		case "upper": return words.join(" ").toUpperCase();
+		case "snake": return words.join("_");
+		case "screaming-snake": return words.join("_").toUpperCase();
+		case "kebab": return words.join("-");
+		case "flat": return words.join("");
+		default: return input;
+	}
+}
+function quote(str, quoteChar = "\"") {
+	const startsWithQuote = str.startsWith(quoteChar);
+	const endsWithQuote = str.endsWith(quoteChar);
+	if (startsWithQuote && endsWithQuote) return str;
+	return `${quoteChar}${str.replace(/^['"]|['"]$/g, "")}${quoteChar}`;
+}
+function isCasingValid(value) {
+	if (typeof value !== "string") return false;
+	return CASING_TYPES.includes(value);
+}
+/**
+* Validates {@linkcode input} is a valid {@linkcode CasingType}.
+*
+* If there is no explicit {@linkcode fallback} value provided,
+* it will default to {@linkcode DEFAULT_CASING}.
+* @param input The input to check.
+* @param fallback An optional fallback value if {@linkcode input} is `undefined`.
+* @returns The {@linkcode input} or {@linkcode fallback} if {@linkcode input} is `undefined` or an {@linkcode isCasingValid invalid} {@linkcode CasingType}.
+*/
+function setCasingType(input, fallback = DEFAULT_CASING) {
+	if (isCasingValid(input)) return input;
+	return fallback;
+}
+
+//#endregion
+export { CASING_TYPES, DEFAULT_CASING, changeCasing, isCasingValid, quote, setCasingType };
+//# sourceMappingURL=casing.mjs.map

package/dist/utils/casing.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"casing.mjs","names":["DEFAULT_CASING: SetDefaultString<CasingType, 'title'>"],"sources":["../../src/utils/casing.ts"],"sourcesContent":["import type { Expand, SetDefaultString } from './types';\n\nexport type CasingType = (typeof CASING_TYPES)[number];\nexport type ToLower<S extends string> = S extends `${infer F}${infer R}`\n  ? `${Lowercase<F>}${ToLower<R>}`\n  : S;\n\nexport type CapitalizeWord<S extends string> = S extends `${infer F}${infer R}`\n  ? `${Uppercase<F>}${ToLower<R>}`\n  : S;\n// Pascal => Capitalize each \"word\" chunk\ntype Pascalize<S extends string> = Capitalize<S>; // naive\n\n// SnakeCase: turn spaces/hyphens into underscores, lowercase\ntype SnakeCase<S extends string> = Lowercase<\n  S extends `${infer A} ${infer B}`\n    ? `${A}_${SnakeCase<B>}`\n    : S extends `${infer A}-${infer B}`\n    ? `${A}_${SnakeCase<B>}`\n    : S\n>;\n\n// KebabCase: same as snake but with \"-\"\ntype KebabCase<S extends string> = Lowercase<\n  S extends `${infer A} ${infer B}`\n    ? `${A}-${KebabCase<B>}`\n    : S extends `${infer A}_${infer B}`\n    ? `${A}-${KebabCase<B>}`\n    : S\n>;\n\n// Flat: just strip spaces/underscores/hyphens\ntype RemoveDelimiters<S extends string> = S extends `${infer A} ${infer B}`\n  ? `${A}${RemoveDelimiters<B>}`\n  : S extends `${infer A}_${infer B}`\n  ? `${A}${RemoveDelimiters<B>}`\n  : S extends `${infer A}-${infer B}`\n  ? `${A}${RemoveDelimiters<B>}`\n  : S;\n\n// TitleCase: Capitalize the whole thing\ntype TitleCase<S extends string> = Capitalize<Lowercase<S>>;\n\n// SentenceCase: First word capped, rest lower\ntype SentenceCase<S extends string> = Capitalize<Lowercase<S>>;\nexport type ChangeCasing<\n  S extends string,\n  T extends CasingType\n> = T extends 'lower'\n  ? Lowercase<S>\n  : T extends 'upper'\n  ? Uppercase<S>\n  : T extends 'camel'\n  ? Uncapitalize<Pascalize<S>>\n  : T extends 'pascal'\n  ? Pascalize<S>\n  : T extends 'snake'\n  ? SnakeCase<S>\n  : T extends 'screaming-snake'\n  ? Uppercase<SnakeCase<S>>\n  : T extends 'kebab'\n  ? KebabCase<S>\n  : T extends 'flat'\n  ? RemoveDelimiters<Lowercase<S>>\n  : T extends 'title'\n  ? TitleCase<S>\n  : T extends 'sentence'\n  ? SentenceCase<S>\n  : S;\nexport type ChangeObjectCasing<\n  T extends object,\n  TCasing extends CasingType\n> = Expand<{\n  [K in keyof T as K extends string ? ChangeCasing<K, TCasing> : K]: T[K];\n}>;\n\nexport const CASING_TYPES = [\n  'sentence',\n  'title',\n  'camel',\n  'lower',\n  'upper',\n  'pascal',\n  'snake',\n  'screaming-snake',\n  'flat',\n  'kebab',\n] as const;\n\nexport type DefaultCasing = typeof DEFAULT_CASING;\nexport const DEFAULT_CASING: SetDefaultString<CasingType, 'title'> = 'title';\n\n/**\n * Changes the casing of a string according to the specified casing type.\n *\n * @param input - The string to transform.\n * @param type - The casing type to apply.\n * @returns The transformed string in the specified casing.\n */\n// TODO make return type safe\nexport function changeCasing<TValue extends string, TType extends CasingType>(\n  input: TValue,\n  type: TType\n): ChangeCasing<TValue, TType>;\nexport function changeCasing<TValue extends string, TType extends CasingType>(\n  input: TValue,\n  type: TType\n) {\n  // Step 1: Normalize to words\n  const words = input\n    // Replace camelCase boundaries with space\n    .replace(/([a-z])([A-Z])/g, '$1 $2')\n    // Replace separators with space\n    .replace(/[-_]+/g, ' ')\n    // Trim and split into words\n    .trim()\n    .split(/\\s+/)\n    .map((w) => w.toLowerCase());\n\n  // Step 2: Apply casing\n  switch (type) {\n    case 'sentence':\n      return (\n        words[0].charAt(0).toUpperCase() +\n        words[0].slice(1) +\n        (words.length > 1 ? ' ' + words.slice(1).join(' ') : '')\n      );\n\n    case 'title':\n      return words.map((w) => w.charAt(0).toUpperCase() + w.slice(1)).join(' ');\n\n    case 'camel':\n      return (\n        words[0] +\n        words\n          .slice(1)\n          .map((w) => w.charAt(0).toUpperCase() + w.slice(1))\n          .join('')\n      );\n\n    case 'pascal':\n      return words.map((w) => w.charAt(0).toUpperCase() + w.slice(1)).join('');\n\n    case 'lower':\n      return words.join(' ');\n\n    case 'upper':\n      return words.join(' ').toUpperCase();\n\n    case 'snake':\n      return words.join('_');\n\n    case 'screaming-snake':\n      return words.join('_').toUpperCase();\n\n    case 'kebab':\n      return words.join('-');\n\n    case 'flat':\n      return words.join('');\n\n    default:\n      return input;\n  }\n}\n\nexport function quote(str: string, quoteChar: '\"' | \"'\" = '\"') {\n  const startsWithQuote = str.startsWith(quoteChar);\n  const endsWithQuote = str.endsWith(quoteChar);\n\n  if (startsWithQuote && endsWithQuote) {\n    // Already wrapped correctly\n    return str;\n  }\n\n  // If it starts or ends with a quote but not both → strip those first\n  const trimmed = str.replace(/^['\"]|['\"]$/g, '');\n\n  // Then add new quotes consistently\n  return `${quoteChar}${trimmed}${quoteChar}`;\n}\n\nexport function isCasingValid(value: unknown): value is CasingType {\n  if (typeof value !== 'string') {\n    return false;\n  }\n\n  const isValid = CASING_TYPES.includes(value as CasingType);\n\n  // invariant(isValid, () => {\n  //   const formatter = new Intl.ListFormat('en', {\n  //     style: 'long',\n  //     type: 'conjunction',\n  //   });\n\n  //   return `${value} is not a valid casing type. Valid types include ${formatter.format(\n  //     CASING_TYPES.map((word) => quote(word))\n  //   )}`;\n  // });\n\n  return isValid;\n}\n\n/**\n * Validates {@linkcode input} is a valid {@linkcode CasingType}.\n *\n * If there is no explicit {@linkcode fallback} value provided,\n * it will default to {@linkcode DEFAULT_CASING}.\n * @param input The input to check.\n * @param fallback An optional fallback value if {@linkcode input} is `undefined`.\n * @returns The {@linkcode input} or {@linkcode fallback} if {@linkcode input} is `undefined` or an {@linkcode isCasingValid invalid} {@linkcode CasingType}.\n */\nexport function setCasingType<TCasing extends CasingType>(\n  input: TCasing | undefined,\n  fallback: CasingType = DEFAULT_CASING\n) {\n  if (isCasingValid(input)) {\n    return input;\n  }\n\n  return fallback;\n}\n"],"mappings":";AA4EA,MAAa,eAAe;CAC1B;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACD;AAGD,MAAaA,iBAAwD;AAcrE,SAAgB,aACd,OACA,MACA;CAEA,MAAM,QAAQ,MAEX,QAAQ,mBAAmB,QAAQ,CAEnC,QAAQ,UAAU,IAAI,CAEtB,MAAM,CACN,MAAM,MAAM,CACZ,KAAK,MAAM,EAAE,aAAa,CAAC;AAG9B,SAAQ,MAAR;EACE,KAAK,WACH,QACE,MAAM,GAAG,OAAO,EAAE,CAAC,aAAa,GAChC,MAAM,GAAG,MAAM,EAAE,IAChB,MAAM,SAAS,IAAI,MAAM,MAAM,MAAM,EAAE,CAAC,KAAK,IAAI,GAAG;EAGzD,KAAK,QACH,QAAO,MAAM,KAAK,MAAM,EAAE,OAAO,EAAE,CAAC,aAAa,GAAG,EAAE,MAAM,EAAE,CAAC,CAAC,KAAK,IAAI;EAE3E,KAAK,QACH,QACE,MAAM,KACN,MACG,MAAM,EAAE,CACR,KAAK,MAAM,EAAE,OAAO,EAAE,CAAC,aAAa,GAAG,EAAE,MAAM,EAAE,CAAC,CAClD,KAAK,GAAG;EAGf,KAAK,SACH,QAAO,MAAM,KAAK,MAAM,EAAE,OAAO,EAAE,CAAC,aAAa,GAAG,EAAE,MAAM,EAAE,CAAC,CAAC,KAAK,GAAG;EAE1E,KAAK,QACH,QAAO,MAAM,KAAK,IAAI;EAExB,KAAK,QACH,QAAO,MAAM,KAAK,IAAI,CAAC,aAAa;EAEtC,KAAK,QACH,QAAO,MAAM,KAAK,IAAI;EAExB,KAAK,kBACH,QAAO,MAAM,KAAK,IAAI,CAAC,aAAa;EAEtC,KAAK,QACH,QAAO,MAAM,KAAK,IAAI;EAExB,KAAK,OACH,QAAO,MAAM,KAAK,GAAG;EAEvB,QACE,QAAO;;;AAIb,SAAgB,MAAM,KAAa,YAAuB,MAAK;CAC7D,MAAM,kBAAkB,IAAI,WAAW,UAAU;CACjD,MAAM,gBAAgB,IAAI,SAAS,UAAU;AAE7C,KAAI,mBAAmB,cAErB,QAAO;AAOT,QAAO,GAAG,YAHM,IAAI,QAAQ,gBAAgB,GAAG,GAGf;;AAGlC,SAAgB,cAAc,OAAqC;AACjE,KAAI,OAAO,UAAU,SACnB,QAAO;AAgBT,QAbgB,aAAa,SAAS,MAAoB;;;;;;;;;;;AAyB5D,SAAgB,cACd,OACA,WAAuB,gBACvB;AACA,KAAI,cAAc,MAAM,CACtB,QAAO;AAGT,QAAO"}

package/dist/utils/field-types.cjs

@@ -0,0 +1,23 @@
+
+//#region src/utils/field-types.ts
+const FIELD_TYPES = [
+	"string",
+	"string.phone",
+	"string.email",
+	"string.time",
+	"number",
+	"number.counter",
+	"date",
+	"dateTime",
+	"boolean.switch"
+];
+const DEFAULT_FIELD_TYPE = "string";
+function isFieldType(value) {
+	return typeof value === "string" && FIELD_TYPES.includes(value);
+}
+
+//#endregion
+exports.DEFAULT_FIELD_TYPE = DEFAULT_FIELD_TYPE;
+exports.FIELD_TYPES = FIELD_TYPES;
+exports.isFieldType = isFieldType;
+//# sourceMappingURL=field-types.cjs.map

package/dist/utils/field-types.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"field-types.cjs","names":["DEFAULT_FIELD_TYPE: SetDefaultString<FieldType, 'string'>"],"sources":["../../src/utils/field-types.ts"],"sourcesContent":["import type { SetDefaultString } from './types';\n\nexport type FieldType = (typeof FIELD_TYPES)[number];\nexport type DefaultFieldType = typeof DEFAULT_FIELD_TYPE;\nexport const FIELD_TYPES = [\n  'string',\n  'string.phone',\n  'string.email',\n  'string.time',\n  'number',\n  'number.counter',\n  'date',\n  'dateTime',\n  'boolean.switch',\n] as const;\nexport const DEFAULT_FIELD_TYPE: SetDefaultString<FieldType, 'string'> =\n  'string';\n\nexport function isFieldType(value: unknown): value is FieldType {\n  return typeof value === 'string' && FIELD_TYPES.includes(value as FieldType);\n}\n"],"mappings":";;AAIA,MAAa,cAAc;CACzB;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACD;AACD,MAAaA,qBACX;AAEF,SAAgB,YAAY,OAAoC;AAC9D,QAAO,OAAO,UAAU,YAAY,YAAY,SAAS,MAAmB"}

package/dist/utils/field-types.d.cts

@@ -0,0 +1,11 @@
+import { SetDefaultString } from "./types.cjs";
+
+//#region src/utils/field-types.d.ts
+type FieldType = (typeof FIELD_TYPES)[number];
+type DefaultFieldType = typeof DEFAULT_FIELD_TYPE;
+declare const FIELD_TYPES: readonly ["string", "string.phone", "string.email", "string.time", "number", "number.counter", "date", "dateTime", "boolean.switch"];
+declare const DEFAULT_FIELD_TYPE: SetDefaultString<FieldType, 'string'>;
+declare function isFieldType(value: unknown): value is FieldType;
+//#endregion
+export { DEFAULT_FIELD_TYPE, DefaultFieldType, FIELD_TYPES, FieldType, isFieldType };
+//# sourceMappingURL=field-types.d.cts.map

package/dist/utils/field-types.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"field-types.d.cts","names":[],"sources":["../../src/utils/field-types.ts"],"sourcesContent":[],"mappings":";;;KAEY,SAAA,WAAoB;KACpB,gBAAA,UAA0B;AAD1B,cAEC,WAFmB,EAAA,SAAW,CAAA,QAAA,EAAA,cAAA,EAAA,cAAA,EAAA,aAAA,EAAA,QAAA,EAAA,gBAAA,EAAA,MAAA,EAAA,UAAA,EAAA,gBAAA,CAAA;AAC/B,cAYC,kBAZyB,EAYL,gBAZuB,CAYN,SAZM,EAAA,QAAA,CAAA;AAC3C,iBAcG,WAAA,CAJN,KAAA,EAAA,OAAA,CAAA,EAAA,KAAA,IAI4C,SAJ5C"}

package/dist/utils/field-types.d.mts

@@ -0,0 +1,11 @@
+import { SetDefaultString } from "./types.mjs";
+
+//#region src/utils/field-types.d.ts
+type FieldType = (typeof FIELD_TYPES)[number];
+type DefaultFieldType = typeof DEFAULT_FIELD_TYPE;
+declare const FIELD_TYPES: readonly ["string", "string.phone", "string.email", "string.time", "number", "number.counter", "date", "dateTime", "boolean.switch"];
+declare const DEFAULT_FIELD_TYPE: SetDefaultString<FieldType, 'string'>;
+declare function isFieldType(value: unknown): value is FieldType;
+//#endregion
+export { DEFAULT_FIELD_TYPE, DefaultFieldType, FIELD_TYPES, FieldType, isFieldType };
+//# sourceMappingURL=field-types.d.mts.map

package/dist/utils/field-types.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"field-types.d.mts","names":[],"sources":["../../src/utils/field-types.ts"],"sourcesContent":[],"mappings":";;;KAEY,SAAA,WAAoB;KACpB,gBAAA,UAA0B;AAD1B,cAEC,WAFmB,EAAA,SAAW,CAAA,QAAA,EAAA,cAAA,EAAA,cAAA,EAAA,aAAA,EAAA,QAAA,EAAA,gBAAA,EAAA,MAAA,EAAA,UAAA,EAAA,gBAAA,CAAA;AAC/B,cAYC,kBAZyB,EAYL,gBAZuB,CAYN,SAZM,EAAA,QAAA,CAAA;AAC3C,iBAcG,WAAA,CAJN,KAAA,EAAA,OAAA,CAAA,EAAA,KAAA,IAI4C,SAJ5C"}

package/dist/utils/field-types.mjs

@@ -0,0 +1,20 @@
+//#region src/utils/field-types.ts
+const FIELD_TYPES = [
+	"string",
+	"string.phone",
+	"string.email",
+	"string.time",
+	"number",
+	"number.counter",
+	"date",
+	"dateTime",
+	"boolean.switch"
+];
+const DEFAULT_FIELD_TYPE = "string";
+function isFieldType(value) {
+	return typeof value === "string" && FIELD_TYPES.includes(value);
+}
+
+//#endregion
+export { DEFAULT_FIELD_TYPE, FIELD_TYPES, isFieldType };
+//# sourceMappingURL=field-types.mjs.map

package/dist/utils/field-types.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"field-types.mjs","names":["DEFAULT_FIELD_TYPE: SetDefaultString<FieldType, 'string'>"],"sources":["../../src/utils/field-types.ts"],"sourcesContent":["import type { SetDefaultString } from './types';\n\nexport type FieldType = (typeof FIELD_TYPES)[number];\nexport type DefaultFieldType = typeof DEFAULT_FIELD_TYPE;\nexport const FIELD_TYPES = [\n  'string',\n  'string.phone',\n  'string.email',\n  'string.time',\n  'number',\n  'number.counter',\n  'date',\n  'dateTime',\n  'boolean.switch',\n] as const;\nexport const DEFAULT_FIELD_TYPE: SetDefaultString<FieldType, 'string'> =\n  'string';\n\nexport function isFieldType(value: unknown): value is FieldType {\n  return typeof value === 'string' && FIELD_TYPES.includes(value as FieldType);\n}\n"],"mappings":";AAIA,MAAa,cAAc;CACzB;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACD;AACD,MAAaA,qBACX;AAEF,SAAgB,YAAY,OAAoC;AAC9D,QAAO,OAAO,UAAU,YAAY,YAAY,SAAS,MAAmB"}

package/dist/utils/helpers.cjs

@@ -0,0 +1,30 @@
+
+//#region src/utils/helpers.ts
+function comparePartialArray(compareArray, actualArray, formatter) {
+	const errors = [];
+	const compareSet = new Set(compareArray);
+	const printedArray = formatter ? formatter.format(compareArray.map((value) => `${value}`)) : `[${compareArray.join(", ")}]`;
+	for (let i = 0; i < actualArray.length; i++) {
+		const value = actualArray[i];
+		if (!compareSet.has(value)) errors.push(`Extra element at index ${i}: "${value}" is not in ${printedArray}`);
+	}
+	if (!actualArray.some((v) => compareSet.has(v))) errors.push(`Array must contain at least one valid element from ${printedArray}`);
+	if (errors.length > 0) return {
+		status: "error",
+		errors
+	};
+	return { status: "success" };
+}
+function printErrors(errors, mapper) {
+	const defaultMapper = (e, i) => `❌ ${i + 1}. ${e}`;
+	return errors.map((e, i) => mapper?.(e, i) ?? defaultMapper(e, i)).join("\n");
+}
+function typedObjectKeys(value) {
+	return Object.keys(value);
+}
+
+//#endregion
+exports.comparePartialArray = comparePartialArray;
+exports.printErrors = printErrors;
+exports.typedObjectKeys = typedObjectKeys;
+//# sourceMappingURL=helpers.cjs.map

package/dist/utils/helpers.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.cjs","names":["errors: string[]"],"sources":["../../src/utils/helpers.ts"],"sourcesContent":["export function comparePartialArray<T>(\n  compareArray: T[],\n  actualArray: T[],\n  formatter?: Intl.ListFormat\n): { status: 'success' } | { status: 'error'; errors: string[] } {\n  const errors: string[] = [];\n  const compareSet = new Set(compareArray);\n  const printedArray = formatter\n    ? formatter.format(compareArray.map((value) => `${value}`))\n    : `[${compareArray.join(', ')}]`;\n\n  // Check extras: elements in b that aren't in a\n  for (let i = 0; i < actualArray.length; i++) {\n    const value = actualArray[i];\n    if (!compareSet.has(value)) {\n      errors.push(\n        `Extra element at index ${i}: \"${value}\" is not in ${printedArray}`\n      );\n    }\n  }\n\n  // Check that at least one element from a is present in b\n  const hasAtLeastOne = actualArray.some((v) => compareSet.has(v));\n  if (!hasAtLeastOne) {\n    errors.push(\n      `Array must contain at least one valid element from ${printedArray}`\n    );\n  }\n\n  if (errors.length > 0) {\n    return { status: 'error', errors };\n  }\n\n  return { status: 'success' };\n}\n\nexport function printErrors<T>(\n  errors: T[],\n  mapper?: (value: T, index: number) => string\n) {\n  const defaultMapper = (e: unknown, i: number) => `❌ ${i + 1}. ${e}`;\n  return errors.map((e, i) => mapper?.(e, i) ?? defaultMapper(e, i)).join('\\n');\n}\n\nexport function typedObjectKeys<T extends Record<string, unknown>, TOverrideKey = keyof T>(value: T) {\n  return Object.keys(value) as Array<TOverrideKey>;\n}\n"],"mappings":";;AAAA,SAAgB,oBACd,cACA,aACA,WAC+D;CAC/D,MAAMA,SAAmB,EAAE;CAC3B,MAAM,aAAa,IAAI,IAAI,aAAa;CACxC,MAAM,eAAe,YACjB,UAAU,OAAO,aAAa,KAAK,UAAU,GAAG,QAAQ,CAAC,GACzD,IAAI,aAAa,KAAK,KAAK,CAAC;AAGhC,MAAK,IAAI,IAAI,GAAG,IAAI,YAAY,QAAQ,KAAK;EAC3C,MAAM,QAAQ,YAAY;AAC1B,MAAI,CAAC,WAAW,IAAI,MAAM,CACxB,QAAO,KACL,0BAA0B,EAAE,KAAK,MAAM,cAAc,eACtD;;AAML,KAAI,CADkB,YAAY,MAAM,MAAM,WAAW,IAAI,EAAE,CAAC,CAE9D,QAAO,KACL,sDAAsD,eACvD;AAGH,KAAI,OAAO,SAAS,EAClB,QAAO;EAAE,QAAQ;EAAS;EAAQ;AAGpC,QAAO,EAAE,QAAQ,WAAW;;AAG9B,SAAgB,YACd,QACA,QACA;CACA,MAAM,iBAAiB,GAAY,MAAc,KAAK,IAAI,EAAE,IAAI;AAChE,QAAO,OAAO,KAAK,GAAG,MAAM,SAAS,GAAG,EAAE,IAAI,cAAc,GAAG,EAAE,CAAC,CAAC,KAAK,KAAK;;AAG/E,SAAgB,gBAA2E,OAAU;AACnG,QAAO,OAAO,KAAK,MAAM"}

package/dist/utils/helpers.mjs

@@ -0,0 +1,27 @@
+//#region src/utils/helpers.ts
+function comparePartialArray(compareArray, actualArray, formatter) {
+	const errors = [];
+	const compareSet = new Set(compareArray);
+	const printedArray = formatter ? formatter.format(compareArray.map((value) => `${value}`)) : `[${compareArray.join(", ")}]`;
+	for (let i = 0; i < actualArray.length; i++) {
+		const value = actualArray[i];
+		if (!compareSet.has(value)) errors.push(`Extra element at index ${i}: "${value}" is not in ${printedArray}`);
+	}
+	if (!actualArray.some((v) => compareSet.has(v))) errors.push(`Array must contain at least one valid element from ${printedArray}`);
+	if (errors.length > 0) return {
+		status: "error",
+		errors
+	};
+	return { status: "success" };
+}
+function printErrors(errors, mapper) {
+	const defaultMapper = (e, i) => `❌ ${i + 1}. ${e}`;
+	return errors.map((e, i) => mapper?.(e, i) ?? defaultMapper(e, i)).join("\n");
+}
+function typedObjectKeys(value) {
+	return Object.keys(value);
+}
+
+//#endregion
+export { comparePartialArray, printErrors, typedObjectKeys };
+//# sourceMappingURL=helpers.mjs.map

package/dist/utils/helpers.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.mjs","names":["errors: string[]"],"sources":["../../src/utils/helpers.ts"],"sourcesContent":["export function comparePartialArray<T>(\n  compareArray: T[],\n  actualArray: T[],\n  formatter?: Intl.ListFormat\n): { status: 'success' } | { status: 'error'; errors: string[] } {\n  const errors: string[] = [];\n  const compareSet = new Set(compareArray);\n  const printedArray = formatter\n    ? formatter.format(compareArray.map((value) => `${value}`))\n    : `[${compareArray.join(', ')}]`;\n\n  // Check extras: elements in b that aren't in a\n  for (let i = 0; i < actualArray.length; i++) {\n    const value = actualArray[i];\n    if (!compareSet.has(value)) {\n      errors.push(\n        `Extra element at index ${i}: \"${value}\" is not in ${printedArray}`\n      );\n    }\n  }\n\n  // Check that at least one element from a is present in b\n  const hasAtLeastOne = actualArray.some((v) => compareSet.has(v));\n  if (!hasAtLeastOne) {\n    errors.push(\n      `Array must contain at least one valid element from ${printedArray}`\n    );\n  }\n\n  if (errors.length > 0) {\n    return { status: 'error', errors };\n  }\n\n  return { status: 'success' };\n}\n\nexport function printErrors<T>(\n  errors: T[],\n  mapper?: (value: T, index: number) => string\n) {\n  const defaultMapper = (e: unknown, i: number) => `❌ ${i + 1}. ${e}`;\n  return errors.map((e, i) => mapper?.(e, i) ?? defaultMapper(e, i)).join('\\n');\n}\n\nexport function typedObjectKeys<T extends Record<string, unknown>, TOverrideKey = keyof T>(value: T) {\n  return Object.keys(value) as Array<TOverrideKey>;\n}\n"],"mappings":";AAAA,SAAgB,oBACd,cACA,aACA,WAC+D;CAC/D,MAAMA,SAAmB,EAAE;CAC3B,MAAM,aAAa,IAAI,IAAI,aAAa;CACxC,MAAM,eAAe,YACjB,UAAU,OAAO,aAAa,KAAK,UAAU,GAAG,QAAQ,CAAC,GACzD,IAAI,aAAa,KAAK,KAAK,CAAC;AAGhC,MAAK,IAAI,IAAI,GAAG,IAAI,YAAY,QAAQ,KAAK;EAC3C,MAAM,QAAQ,YAAY;AAC1B,MAAI,CAAC,WAAW,IAAI,MAAM,CACxB,QAAO,KACL,0BAA0B,EAAE,KAAK,MAAM,cAAc,eACtD;;AAML,KAAI,CADkB,YAAY,MAAM,MAAM,WAAW,IAAI,EAAE,CAAC,CAE9D,QAAO,KACL,sDAAsD,eACvD;AAGH,KAAI,OAAO,SAAS,EAClB,QAAO;EAAE,QAAQ;EAAS;EAAQ;AAGpC,QAAO,EAAE,QAAQ,WAAW;;AAG9B,SAAgB,YACd,QACA,QACA;CACA,MAAM,iBAAiB,GAAY,MAAc,KAAK,IAAI,EAAE,IAAI;AAChE,QAAO,OAAO,KAAK,GAAG,MAAM,SAAS,GAAG,EAAE,IAAI,cAAc,GAAG,EAAE,CAAC,CAAC,KAAK,KAAK;;AAG/E,SAAgB,gBAA2E,OAAU;AACnG,QAAO,OAAO,KAAK,MAAM"}

package/dist/utils/invariant.cjs

@@ -0,0 +1,18 @@
+
+//#region src/utils/invariant.ts
+function lazy(strings, ...values) {
+	return () => String.raw({ raw: strings }, ...values);
+}
+function invariant(condition, message, error = Error) {
+	if (!condition) {
+		const formatter = new Intl.ListFormat("en", {
+			style: "long",
+			type: "conjunction"
+		});
+		throw new error(typeof message === "function" ? message(formatter) : lazy`${message}`());
+	}
+}
+
+//#endregion
+exports.invariant = invariant;
+//# sourceMappingURL=invariant.cjs.map

package/dist/utils/invariant.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"invariant.cjs","names":[],"sources":["../../src/utils/invariant.ts"],"sourcesContent":["function lazy(strings: TemplateStringsArray, ...values: any[]) {\n  return () => String.raw({ raw: strings }, ...values);\n}\n\nexport function invariant<T>(\n  condition: T,\n  message: string | ((formatter: Intl.ListFormat) => string),\n  error: new (message: string) => Error = Error\n): asserts condition {\n  if (!condition) {\n    const formatter = new Intl.ListFormat('en', {\n      style: 'long',\n      type: 'conjunction',\n    });\n    const resolvedMessage =\n      typeof message === 'function' ? message(formatter) : lazy`${message}`();\n\n    throw new error(resolvedMessage);\n  }\n}\n"],"mappings":";;AAAA,SAAS,KAAK,SAA+B,GAAG,QAAe;AAC7D,cAAa,OAAO,IAAI,EAAE,KAAK,SAAS,EAAE,GAAG,OAAO;;AAGtD,SAAgB,UACd,WACA,SACA,QAAwC,OACrB;AACnB,KAAI,CAAC,WAAW;EACd,MAAM,YAAY,IAAI,KAAK,WAAW,MAAM;GAC1C,OAAO;GACP,MAAM;GACP,CAAC;AAIF,QAAM,IAAI,MAFR,OAAO,YAAY,aAAa,QAAQ,UAAU,GAAG,IAAI,GAAG,WAAW,CAEzC"}

package/dist/utils/invariant.d.cts

@@ -0,0 +1,5 @@
+//#region src/utils/invariant.d.ts
+declare function invariant<T>(condition: T, message: string | ((formatter: Intl.ListFormat) => string), error?: new (message: string) => Error): asserts condition;
+//#endregion
+export { invariant };
+//# sourceMappingURL=invariant.d.cts.map

package/dist/utils/invariant.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"invariant.d.cts","names":[],"sources":["../../src/utils/invariant.ts"],"sourcesContent":[],"mappings":";iBAIgB,wBACH,kCACoB,IAAA,CAAK,yDACJ"}

package/dist/utils/invariant.d.mts

@@ -0,0 +1,5 @@
+//#region src/utils/invariant.d.ts
+declare function invariant<T>(condition: T, message: string | ((formatter: Intl.ListFormat) => string), error?: new (message: string) => Error): asserts condition;
+//#endregion
+export { invariant };
+//# sourceMappingURL=invariant.d.mts.map

package/dist/utils/invariant.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"invariant.d.mts","names":[],"sources":["../../src/utils/invariant.ts"],"sourcesContent":[],"mappings":";iBAIgB,wBACH,kCACoB,IAAA,CAAK,yDACJ"}

package/dist/utils/invariant.mjs

@@ -0,0 +1,17 @@
+//#region src/utils/invariant.ts
+function lazy(strings, ...values) {
+	return () => String.raw({ raw: strings }, ...values);
+}
+function invariant(condition, message, error = Error) {
+	if (!condition) {
+		const formatter = new Intl.ListFormat("en", {
+			style: "long",
+			type: "conjunction"
+		});
+		throw new error(typeof message === "function" ? message(formatter) : lazy`${message}`());
+	}
+}
+
+//#endregion
+export { invariant };
+//# sourceMappingURL=invariant.mjs.map

package/dist/utils/invariant.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"invariant.mjs","names":[],"sources":["../../src/utils/invariant.ts"],"sourcesContent":["function lazy(strings: TemplateStringsArray, ...values: any[]) {\n  return () => String.raw({ raw: strings }, ...values);\n}\n\nexport function invariant<T>(\n  condition: T,\n  message: string | ((formatter: Intl.ListFormat) => string),\n  error: new (message: string) => Error = Error\n): asserts condition {\n  if (!condition) {\n    const formatter = new Intl.ListFormat('en', {\n      style: 'long',\n      type: 'conjunction',\n    });\n    const resolvedMessage =\n      typeof message === 'function' ? message(formatter) : lazy`${message}`();\n\n    throw new error(resolvedMessage);\n  }\n}\n"],"mappings":";AAAA,SAAS,KAAK,SAA+B,GAAG,QAAe;AAC7D,cAAa,OAAO,IAAI,EAAE,KAAK,SAAS,EAAE,GAAG,OAAO;;AAGtD,SAAgB,UACd,WACA,SACA,QAAwC,OACrB;AACnB,KAAI,CAAC,WAAW;EACd,MAAM,YAAY,IAAI,KAAK,WAAW,MAAM;GAC1C,OAAO;GACP,MAAM;GACP,CAAC;AAIF,QAAM,IAAI,MAFR,OAAO,YAAY,aAAa,QAAQ,UAAU,GAAG,IAAI,GAAG,WAAW,CAEzC"}

package/dist/utils/logger.cjs

@@ -0,0 +1,58 @@
+
+//#region src/utils/logger.ts
+const DEFAULT_LOGGER_PREFIX = "MultiStepFormSchema";
+var MultiStepFormLogger = class {
+	debug;
+	prefix = DEFAULT_LOGGER_PREFIX;
+	includeTimestamp = false;
+	throwOnError = false;
+	constructor(options) {
+		this.debug = options?.debug ?? false;
+		if (this.debug && options?.debug) {
+			const { includeTimestamp = false, prefix = DEFAULT_LOGGER_PREFIX, throwOnError = false } = options;
+			this.includeTimestamp = includeTimestamp;
+			this.prefix = typeof prefix === "string" ? prefix : prefix(DEFAULT_LOGGER_PREFIX);
+			this.throwOnError = throwOnError;
+		}
+	}
+	wrapValue(wrapWith, value) {
+		if (wrapWith === "[]") return `[${value}]`;
+		if (wrapWith === "{}") return `{${value}}`;
+		if (wrapWith === "none") return value;
+		throw new Error(`The first argument ${wrapWith} is not valid. Valid options include: "[]", "{}", and "none"`);
+	}
+	formatPrefix(options) {
+		if (!options) return this.prefix;
+		const { action, value, wrapWith } = options;
+		if (action === "replace") return this.wrapValue(wrapWith ?? "[]", value);
+		const { delimiter } = options;
+		if (action === "append") return `${this.wrapValue(wrapWith?.originalPrefix ?? "[]", this.prefix)}${delimiter}${this.wrapValue(wrapWith?.addedPrefix ?? "[]", value)}`.trim();
+		if (action === "prepend") return `${this.wrapValue(wrapWith?.addedPrefix ?? "[]", value)}${delimiter}${this.wrapValue(wrapWith?.originalPrefix ?? "[]", this.prefix)}`.trim();
+		return this.prefix;
+	}
+	formatMessage(level, message, options) {
+		const { includeTimestamp = this.includeTimestamp, prefix, logLevelOptions } = options ?? {};
+		const formattedMessage = `${this.formatPrefix(prefix)} ${this.wrapValue(logLevelOptions?.wrapWith ?? "[]", (logLevelOptions?.level ?? level).toUpperCase())} ${message}`;
+		if (includeTimestamp) return `[${(/* @__PURE__ */ new Date()).toISOString()}] ${formattedMessage}`;
+		return formattedMessage;
+	}
+	info(message, options) {
+		if (!this.debug) return;
+		console.info(this.formatMessage("info", message, options));
+	}
+	warn(message, options) {
+		if (!this.debug) return;
+		console.warn(this.formatMessage("warn", message, options));
+	}
+	error(message, options) {
+		if (!this.debug) return;
+		const formatted = this.formatMessage("error", message, options);
+		console.error(formatted);
+		if (options?.throw ?? this.throwOnError) throw new Error(formatted);
+	}
+};
+
+//#endregion
+exports.DEFAULT_LOGGER_PREFIX = DEFAULT_LOGGER_PREFIX;
+exports.MultiStepFormLogger = MultiStepFormLogger;
+//# sourceMappingURL=logger.cjs.map

package/dist/utils/logger.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.cjs","names":[],"sources":["../../src/utils/logger.ts"],"sourcesContent":["type LogLevel = 'info' | 'warn' | 'error';\ntype MultiStepFormLoggerOptions = {\n  debug?: boolean;\n  prefix?: string | ((prefix: typeof DEFAULT_LOGGER_PREFIX) => string);\n  includeTimestamp?: boolean;\n  throwOnError?: boolean;\n};\n\ntype WrapWithOptions = '[]' | '{}' | 'none';\ntype ReplacePrefixOptions = {\n  action: 'replace';\n  value: string;\n  wrapWith?: WrapWithOptions;\n};\ntype AppendOrPrependPrefixOptions = {\n  action: 'append' | 'prepend';\n  value: string;\n  delimiter?: string;\n  wrapWith?: {\n    originalPrefix?: WrapWithOptions;\n    addedPrefix?: WrapWithOptions;\n  };\n};\ntype PrefixOptions = ReplacePrefixOptions | AppendOrPrependPrefixOptions;\ntype BaseLogOptions = {\n  prefix?: PrefixOptions;\n  logLevelOptions?: {\n    level?: LogLevel;\n    wrapWith?: WrapWithOptions;\n  };\n  includeTimestamp?: boolean;\n};\ntype ErrorLogOptions = BaseLogOptions & {\n  throw?: boolean;\n};\n\nexport const DEFAULT_LOGGER_PREFIX = 'MultiStepFormSchema';\nexport class MultiStepFormLogger {\n  private readonly debug: boolean;\n  private readonly prefix: string = DEFAULT_LOGGER_PREFIX;\n  private readonly includeTimestamp: boolean = false;\n  private readonly throwOnError: boolean = false;\n\n  constructor(options?: MultiStepFormLoggerOptions) {\n    this.debug = options?.debug ?? false;\n    if (this.debug && options?.debug) {\n      const {\n        includeTimestamp = false,\n        prefix = DEFAULT_LOGGER_PREFIX,\n        throwOnError = false,\n      } = options;\n\n      this.includeTimestamp = includeTimestamp;\n      this.prefix =\n        typeof prefix === 'string' ? prefix : prefix(DEFAULT_LOGGER_PREFIX);\n      this.throwOnError = throwOnError;\n    }\n  }\n\n  private wrapValue(wrapWith: WrapWithOptions, value: string) {\n    if (wrapWith === '[]') {\n      return `[${value}]`;\n    }\n\n    if (wrapWith === '{}') {\n      return `{${value}}`;\n    }\n\n    if (wrapWith === 'none') {\n      return value;\n    }\n\n    throw new Error(\n      `The first argument ${wrapWith} is not valid. Valid options include: \"[]\", \"{}\", and \"none\"`\n    );\n  }\n\n  private formatPrefix(options: PrefixOptions | undefined) {\n    if (!options) {\n      return this.prefix;\n    }\n\n    const { action, value, wrapWith } = options;\n\n    if (action === 'replace') {\n      return this.wrapValue(wrapWith ?? '[]', value);\n    }\n\n    const { delimiter } = options;\n\n    if (action === 'append') {\n      return `${this.wrapValue(\n        wrapWith?.originalPrefix ?? '[]',\n        this.prefix\n      )}${delimiter}${this.wrapValue(\n        wrapWith?.addedPrefix ?? '[]',\n        value\n      )}`.trim();\n    }\n\n    if (action === 'prepend') {\n      return `${this.wrapValue(\n        wrapWith?.addedPrefix ?? '[]',\n        value\n      )}${delimiter}${this.wrapValue(\n        wrapWith?.originalPrefix ?? '[]',\n        this.prefix\n      )}`.trim();\n    }\n\n    return this.prefix;\n  }\n\n  private formatMessage(\n    level: LogLevel,\n    message: string,\n    options?: BaseLogOptions\n  ) {\n    const {\n      includeTimestamp = this.includeTimestamp,\n      prefix,\n      logLevelOptions,\n    } = options ?? {};\n    const formattedPrefix = this.formatPrefix(prefix);\n    const formattedLogLevel = this.wrapValue(\n      logLevelOptions?.wrapWith ?? '[]',\n      (logLevelOptions?.level ?? level).toUpperCase()\n    );\n    const formattedMessage = `${formattedPrefix} ${formattedLogLevel} ${message}`;\n\n    if (includeTimestamp) {\n      const timestamp = new Date().toISOString();\n\n      return `[${timestamp}] ${formattedMessage}`;\n    }\n\n    return formattedMessage;\n  }\n\n  info(message: string, options?: BaseLogOptions) {\n    if (!this.debug) {\n      return;\n    }\n\n    console.info(this.formatMessage('info', message, options));\n  }\n\n  warn(message: string, options?: BaseLogOptions) {\n    if (!this.debug) {\n      return;\n    }\n\n    console.warn(this.formatMessage('warn', message, options));\n  }\n\n  error(message: string, options?: BaseLogOptions): void;\n  error(message: string, options?: ErrorLogOptions): never;\n  error(message: string, options?: ErrorLogOptions) {\n    if (!this.debug) {\n      return;\n    }\n\n    const formatted = this.formatMessage('error', message, options);\n\n    console.error(formatted);\n\n    const throwOnError = options?.throw ?? this.throwOnError;\n\n    if (throwOnError) {\n      throw new Error(formatted);\n    }\n  }\n}\n"],"mappings":";;AAoCA,MAAa,wBAAwB;AACrC,IAAa,sBAAb,MAAiC;CAC/B,AAAiB;CACjB,AAAiB,SAAiB;CAClC,AAAiB,mBAA4B;CAC7C,AAAiB,eAAwB;CAEzC,YAAY,SAAsC;AAChD,OAAK,QAAQ,SAAS,SAAS;AAC/B,MAAI,KAAK,SAAS,SAAS,OAAO;GAChC,MAAM,EACJ,mBAAmB,OACnB,SAAS,uBACT,eAAe,UACb;AAEJ,QAAK,mBAAmB;AACxB,QAAK,SACH,OAAO,WAAW,WAAW,SAAS,OAAO,sBAAsB;AACrE,QAAK,eAAe;;;CAIxB,AAAQ,UAAU,UAA2B,OAAe;AAC1D,MAAI,aAAa,KACf,QAAO,IAAI,MAAM;AAGnB,MAAI,aAAa,KACf,QAAO,IAAI,MAAM;AAGnB,MAAI,aAAa,OACf,QAAO;AAGT,QAAM,IAAI,MACR,sBAAsB,SAAS,8DAChC;;CAGH,AAAQ,aAAa,SAAoC;AACvD,MAAI,CAAC,QACH,QAAO,KAAK;EAGd,MAAM,EAAE,QAAQ,OAAO,aAAa;AAEpC,MAAI,WAAW,UACb,QAAO,KAAK,UAAU,YAAY,MAAM,MAAM;EAGhD,MAAM,EAAE,cAAc;AAEtB,MAAI,WAAW,SACb,QAAO,GAAG,KAAK,UACb,UAAU,kBAAkB,MAC5B,KAAK,OACN,GAAG,YAAY,KAAK,UACnB,UAAU,eAAe,MACzB,MACD,GAAG,MAAM;AAGZ,MAAI,WAAW,UACb,QAAO,GAAG,KAAK,UACb,UAAU,eAAe,MACzB,MACD,GAAG,YAAY,KAAK,UACnB,UAAU,kBAAkB,MAC5B,KAAK,OACN,GAAG,MAAM;AAGZ,SAAO,KAAK;;CAGd,AAAQ,cACN,OACA,SACA,SACA;EACA,MAAM,EACJ,mBAAmB,KAAK,kBACxB,QACA,oBACE,WAAW,EAAE;EAMjB,MAAM,mBAAmB,GALD,KAAK,aAAa,OAAO,CAKL,GAJlB,KAAK,UAC7B,iBAAiB,YAAY,OAC5B,iBAAiB,SAAS,OAAO,aAAa,CAChD,CACgE,GAAG;AAEpE,MAAI,iBAGF,QAAO,qBAFW,IAAI,MAAM,EAAC,aAAa,CAErB,IAAI;AAG3B,SAAO;;CAGT,KAAK,SAAiB,SAA0B;AAC9C,MAAI,CAAC,KAAK,MACR;AAGF,UAAQ,KAAK,KAAK,cAAc,QAAQ,SAAS,QAAQ,CAAC;;CAG5D,KAAK,SAAiB,SAA0B;AAC9C,MAAI,CAAC,KAAK,MACR;AAGF,UAAQ,KAAK,KAAK,cAAc,QAAQ,SAAS,QAAQ,CAAC;;CAK5D,MAAM,SAAiB,SAA2B;AAChD,MAAI,CAAC,KAAK,MACR;EAGF,MAAM,YAAY,KAAK,cAAc,SAAS,SAAS,QAAQ;AAE/D,UAAQ,MAAM,UAAU;AAIxB,MAFqB,SAAS,SAAS,KAAK,aAG1C,OAAM,IAAI,MAAM,UAAU"}