@jfdevelops/multi-step-form-core 1.0.0-alpha.11 → 1.0.0-alpha.13

package/dist/steps/utils.mjs

@@ -0,0 +1,94 @@
+import { comparePartialArray, printErrors } from "../utils/helpers.mjs";
+import { invariant } from "../utils/invariant.mjs";
+
+//#region src/steps/utils.ts
+/**
+* Gets the step number from an input string.
+* @param input The input to extract the step number from.
+* @returns The extracted step number.
+*/
+function extractNumber(input) {
+	invariant(input.includes("step"), "Can't extract a valid step number since");
+	const extracted = input.replace("step", "");
+	invariant(/^\d+$/.test(extracted), `Invalid step format: "${input}"`);
+	return Number.parseInt(extracted, 10);
+}
+/**
+* A factory function to get the data of a specific step.
+* @param resolvedStepValues The resolved step values.
+* @returns A function to get specific step data from a target step.
+*/
+function getStep(resolvedStepValues) {
+	/**
+	* Gets the step data associated with the target step number.
+	*
+	* @example
+	* const result = getStep(resolvedStepValues)({ step: 1 });
+	* // result: { step: 1, data: ... }
+	*
+	* @returns An object containing the `step` number and the associated step data.
+	*/
+	return function(options) {
+		const { step } = options;
+		return {
+			step,
+			data: resolvedStepValues[`step${step}`]
+		};
+	};
+}
+function createCtxHelper(values, data) {
+	return data.reduce((acc, curr) => {
+		const stepNumber = extractNumber(curr);
+		const { data: data$1 } = getStep(values)({ step: stepNumber });
+		for (const [key, value] of Object.entries(data$1)) {
+			if (typeof value === "function" && key !== "update") continue;
+			data$1[key] = value;
+		}
+		acc[curr] = data$1;
+		return acc;
+	}, {});
+}
+function createCtx(values, stepData) {
+	const formatter = new Intl.ListFormat("en", {
+		style: "long",
+		type: "disjunction"
+	});
+	const validStepKeys = Object.keys(values);
+	const baseErrorMessage = () => {
+		return `"stepData" must be set to an array of available steps (${formatter.format(validStepKeys)})`;
+	};
+	if (stepData === "all") {
+		let ctx = {};
+		for (const key of validStepKeys) ctx = {
+			...ctx,
+			[key]: getStep(values)({ step: extractNumber(key) })
+		};
+		return createCtxHelper(values, validStepKeys);
+	}
+	if (Array.isArray(stepData)) {
+		invariant(stepData.every((step) => validStepKeys.includes(step)), () => {
+			const comparedResults = comparePartialArray(stepData, validStepKeys.map((key) => extractNumber(key)), formatter);
+			if (comparedResults.status === "error") return `${baseErrorMessage()}. See errors:\n ${printErrors(comparedResults.errors)}`;
+			return baseErrorMessage();
+		});
+		return createCtxHelper(values, stepData);
+	}
+	if (typeof stepData === "object") {
+		const keys = Object.keys(stepData);
+		invariant(keys.every((key) => validStepKeys.includes(key)), () => {
+			const comparedResults = comparePartialArray(keys, validStepKeys, formatter);
+			if (comparedResults.status === "error") return `${baseErrorMessage()}. See errors:\n ${printErrors(comparedResults.errors)}`;
+			return baseErrorMessage();
+		});
+		return createCtxHelper(values, keys);
+	}
+	throw new Error(`${baseErrorMessage()} OR to "all"`);
+}
+function functionalUpdate(updater, input) {
+	if (typeof updater === "function") return updater(input);
+	return updater;
+}
+
+//#endregion
+export { createCtx, functionalUpdate, getStep };
+//# sourceMappingURL=utils.mjs.map

package/dist/steps/utils.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.mjs","names":["data"],"sources":["../../src/steps/utils.ts"],"sourcesContent":["import { comparePartialArray, printErrors } from '@/utils/helpers';\nimport { invariant } from '@/utils/invariant';\nimport type {\n  AnyResolvedStep,\n  GetCurrentStep,\n  HelperFnChosenSteps,\n  HelperFnCtx,\n  StepNumbers,\n  Updater,\n} from './types';\n\nexport type GetStepOptions<\n  TResolvedStep extends AnyResolvedStep,\n  TStepNumbers extends StepNumbers<TResolvedStep>,\n  TStepNumber extends TStepNumbers\n> = { step: TStepNumber };\n\n/**\n * Gets the step number from an input string.\n * @param input The input to extract the step number from.\n * @returns The extracted step number.\n */\nexport function extractNumber(input: string) {\n  invariant(input.includes('step'), \"Can't extract a valid step number since\");\n\n  const extracted = input.replace('step', '');\n\n  invariant(/^\\d+$/.test(extracted), `Invalid step format: \"${input}\"`);\n\n  return Number.parseInt(extracted, 10);\n}\n\n/**\n * A factory function to get the data of a specific step.\n * @param resolvedStepValues The resolved step values.\n * @returns A function to get specific step data from a target step.\n */\nexport function getStep<\n  resolvedStep extends AnyResolvedStep,\n  stepNumbers extends StepNumbers<resolvedStep>\n>(resolvedStepValues: resolvedStep) {\n  /**\n   * Gets the step data associated with the target step number.\n   *\n   * @example\n   * const result = getStep(resolvedStepValues)({ step: 1 });\n   * // result: { step: 1, data: ... }\n   *\n   * @returns An object containing the `step` number and the associated step data.\n   */\n  return function <stepNumber extends stepNumbers>(\n    options: GetStepOptions<resolvedStep, stepNumbers, stepNumber>\n  ) {\n    const { step } = options;\n    const stepKey = `step${step}` as keyof typeof resolvedStepValues;\n\n    const data = resolvedStepValues[stepKey] as GetCurrentStep<\n      typeof resolvedStepValues,\n      stepNumber\n    >;\n\n    return { step, data };\n  };\n}\n\nfunction createCtxHelper<\n  TResolvedStep extends AnyResolvedStep,\n  TStepNumbers extends StepNumbers<TResolvedStep>,\n  TChosenSteps extends HelperFnChosenSteps<TResolvedStep, TStepNumbers>\n>(values: TResolvedStep, data: string[]) {\n  return data.reduce((acc, curr) => {\n    const stepNumber = extractNumber(curr);\n    const { data } = getStep(values)({\n      step: stepNumber as TStepNumbers,\n    });\n\n    for (const [key, value] of Object.entries(data)) {\n      // console.log({ [key]: value });\n      // Remove the functions from the data to comply with `StrippedResolvedStep`\n      if (typeof value === 'function' && key !== 'update') {\n        continue;\n      }\n\n      data[key as keyof typeof data] = value as never;\n    }\n\n    acc[curr as keyof typeof acc] = data as never;\n\n    return acc;\n  }, {} as HelperFnCtx<TResolvedStep, TStepNumbers, TChosenSteps>);\n}\n\nexport function createCtx<\n  TResolvedStep extends AnyResolvedStep,\n  TStepNumbers extends StepNumbers<TResolvedStep>,\n  TChosenSteps extends HelperFnChosenSteps<TResolvedStep, TStepNumbers>\n>(values: TResolvedStep, stepData: TChosenSteps) {\n  const formatter = new Intl.ListFormat('en', {\n    style: 'long',\n    type: 'disjunction',\n  });\n  const validStepKeys = Object.keys(values);\n\n  const baseErrorMessage = () => {\n    return `\"stepData\" must be set to an array of available steps (${formatter.format(\n      validStepKeys\n    )})`;\n  };\n\n  if (stepData === 'all') {\n    let ctx = {} as HelperFnCtx<TResolvedStep, TStepNumbers, TChosenSteps>;\n\n    for (const key of validStepKeys) {\n      ctx = {\n        ...ctx,\n        [key]: getStep(values)({\n          step: extractNumber(key) as never,\n        }),\n      };\n    }\n\n    return createCtxHelper<TResolvedStep, TStepNumbers, TChosenSteps>(\n      values,\n      validStepKeys\n    );\n  }\n\n  if (Array.isArray(stepData)) {\n    invariant(\n      stepData.every((step) => validStepKeys.includes(step)),\n      () => {\n        const comparedResults = comparePartialArray(\n          stepData,\n          validStepKeys.map((key) => extractNumber(key)),\n          formatter\n        );\n\n        if (comparedResults.status === 'error') {\n          return `${baseErrorMessage()}. See errors:\\n ${printErrors(\n            comparedResults.errors\n          )}`;\n        }\n\n        return baseErrorMessage();\n      }\n    );\n\n    return createCtxHelper<TResolvedStep, TStepNumbers, TChosenSteps>(\n      values,\n      stepData\n    );\n  }\n\n  if (typeof stepData === 'object') {\n    const keys = Object.keys(stepData);\n\n    invariant(\n      keys.every((key) => validStepKeys.includes(key)),\n      () => {\n        const comparedResults = comparePartialArray(\n          keys,\n          validStepKeys,\n          formatter\n        );\n\n        if (comparedResults.status === 'error') {\n          return `${baseErrorMessage()}. See errors:\\n ${printErrors(\n            comparedResults.errors\n          )}`;\n        }\n\n        return baseErrorMessage();\n      }\n    );\n\n    return createCtxHelper<TResolvedStep, TStepNumbers, TChosenSteps>(\n      values,\n      keys\n    );\n  }\n\n  throw new Error(`${baseErrorMessage()} OR to \"all\"`);\n}\n\nexport function functionalUpdate<TInput, TOutput>(\n  updater: Updater<TInput, TOutput>,\n  input: TInput\n) {\n  if (typeof updater === 'function') {\n    return (updater as (_: TInput) => TOutput)(input);\n  }\n\n  return updater;\n}\n"],"mappings":";;;;;;;;;AAsBA,SAAgB,cAAc,OAAe;AAC3C,WAAU,MAAM,SAAS,OAAO,EAAE,0CAA0C;CAE5E,MAAM,YAAY,MAAM,QAAQ,QAAQ,GAAG;AAE3C,WAAU,QAAQ,KAAK,UAAU,EAAE,yBAAyB,MAAM,GAAG;AAErE,QAAO,OAAO,SAAS,WAAW,GAAG;;;;;;;AAQvC,SAAgB,QAGd,oBAAkC;;;;;;;;;;AAUlC,QAAO,SACL,SACA;EACA,MAAM,EAAE,SAAS;AAQjB,SAAO;GAAE;GAAM,MALF,mBAFG,OAAO;GAOF;;;AAIzB,SAAS,gBAIP,QAAuB,MAAgB;AACvC,QAAO,KAAK,QAAQ,KAAK,SAAS;EAChC,MAAM,aAAa,cAAc,KAAK;EACtC,MAAM,EAAE,iBAAS,QAAQ,OAAO,CAAC,EAC/B,MAAM,YACP,CAAC;AAEF,OAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQA,OAAK,EAAE;AAG/C,OAAI,OAAO,UAAU,cAAc,QAAQ,SACzC;AAGF,UAAK,OAA4B;;AAGnC,MAAI,QAA4BA;AAEhC,SAAO;IACN,EAAE,CAA2D;;AAGlE,SAAgB,UAId,QAAuB,UAAwB;CAC/C,MAAM,YAAY,IAAI,KAAK,WAAW,MAAM;EAC1C,OAAO;EACP,MAAM;EACP,CAAC;CACF,MAAM,gBAAgB,OAAO,KAAK,OAAO;CAEzC,MAAM,yBAAyB;AAC7B,SAAO,0DAA0D,UAAU,OACzE,cACD,CAAC;;AAGJ,KAAI,aAAa,OAAO;EACtB,IAAI,MAAM,EAAE;AAEZ,OAAK,MAAM,OAAO,cAChB,OAAM;GACJ,GAAG;IACF,MAAM,QAAQ,OAAO,CAAC,EACrB,MAAM,cAAc,IAAI,EACzB,CAAC;GACH;AAGH,SAAO,gBACL,QACA,cACD;;AAGH,KAAI,MAAM,QAAQ,SAAS,EAAE;AAC3B,YACE,SAAS,OAAO,SAAS,cAAc,SAAS,KAAK,CAAC,QAChD;GACJ,MAAM,kBAAkB,oBACtB,UACA,cAAc,KAAK,QAAQ,cAAc,IAAI,CAAC,EAC9C,UACD;AAED,OAAI,gBAAgB,WAAW,QAC7B,QAAO,GAAG,kBAAkB,CAAC,kBAAkB,YAC7C,gBAAgB,OACjB;AAGH,UAAO,kBAAkB;IAE5B;AAED,SAAO,gBACL,QACA,SACD;;AAGH,KAAI,OAAO,aAAa,UAAU;EAChC,MAAM,OAAO,OAAO,KAAK,SAAS;AAElC,YACE,KAAK,OAAO,QAAQ,cAAc,SAAS,IAAI,CAAC,QAC1C;GACJ,MAAM,kBAAkB,oBACtB,MACA,eACA,UACD;AAED,OAAI,gBAAgB,WAAW,QAC7B,QAAO,GAAG,kBAAkB,CAAC,kBAAkB,YAC7C,gBAAgB,OACjB;AAGH,UAAO,kBAAkB;IAE5B;AAED,SAAO,gBACL,QACA,KACD;;AAGH,OAAM,IAAI,MAAM,GAAG,kBAAkB,CAAC,cAAc;;AAGtD,SAAgB,iBACd,SACA,OACA;AACA,KAAI,OAAO,YAAY,WACrB,QAAQ,QAAmC,MAAM;AAGnD,QAAO"}

package/dist/storage.cjs

@@ -0,0 +1,72 @@
+const require_invariant = require('./utils/invariant.cjs');
+const require_logger = require('./utils/logger.cjs');
+
+//#region src/storage.ts
+const WINDOW_UNDEFINED_MESSAGE = "\"window\" in undefined. No storage is available";
+const DEFAULT_STORAGE_KEY = "MultiStepForm";
+var MultiStepFormStorage = class {
+	key;
+	store;
+	data;
+	log;
+	shouldRunActions;
+	throwWhenUndefined;
+	constructor(config) {
+		const { key, data, store, throwWhenUndefined = false } = config;
+		this.log = new require_logger.MultiStepFormLogger({ prefix: DEFAULT_STORAGE_KEY });
+		this.key = key;
+		this.data = data;
+		this.throwWhenUndefined = throwWhenUndefined;
+		if (store) {
+			this.store = store;
+			this.shouldRunActions = true;
+			if (typeof window === "undefined") {
+				this.shouldRunActions = false;
+				this.log.warn(WINDOW_UNDEFINED_MESSAGE);
+			}
+		} else if (typeof window !== "undefined") {
+			this.store = window.localStorage;
+			this.shouldRunActions = true;
+		} else {
+			this.shouldRunActions = false;
+			this.log.warn(WINDOW_UNDEFINED_MESSAGE);
+		}
+	}
+	throwOnEmptyStore() {
+		if (!this.throwWhenUndefined) return;
+		require_invariant.invariant(this.store, () => {
+			if (this.shouldRunActions) return WINDOW_UNDEFINED_MESSAGE;
+			return "No storage available";
+		});
+	}
+	resolveValue(value) {
+		if (typeof value === "object") return value;
+		if (typeof value === "function") return value(this.data);
+		this.log.error(`The updater value must be a function or object. Was a ${typeof value}`, { throw: true });
+	}
+	hasKey() {
+		return this.store.getItem(this.key) !== null;
+	}
+	get() {
+		this.throwOnEmptyStore();
+		if (!this.shouldRunActions) return;
+		const item = this.store.getItem(this.key);
+		if (item) return JSON.parse(item);
+	}
+	remove() {
+		this.throwOnEmptyStore();
+		if (!this.shouldRunActions) return;
+		this.store.removeItem(this.key);
+	}
+	add(value) {
+		this.throwOnEmptyStore();
+		if (!this.shouldRunActions) return;
+		const resolvedValue = JSON.stringify(this.resolveValue(value));
+		this.store.setItem(this.key, resolvedValue);
+	}
+};
+
+//#endregion
+exports.DEFAULT_STORAGE_KEY = DEFAULT_STORAGE_KEY;
+exports.MultiStepFormStorage = MultiStepFormStorage;
+//# sourceMappingURL=storage.cjs.map

package/dist/storage.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.cjs","names":["MultiStepFormLogger"],"sources":["../src/storage.ts"],"sourcesContent":["import type { Updater } from '@/steps/types';\nimport { invariant } from '@/utils/invariant';\nimport { MultiStepFormLogger } from '@/utils/logger';\n\nexport type DefaultStorageKey = typeof DEFAULT_STORAGE_KEY;\nexport type StorageConfig<TData, TKey extends string> = {\n  key: TKey;\n  data: TData;\n  store?: Storage;\n  /**\n   * An extra option to throw an error when {@linkcode window} is `undefined`\n   * @default false\n   */\n  throwWhenUndefined?: boolean;\n};\n\nconst WINDOW_UNDEFINED_MESSAGE =\n  '\"window\" in undefined. No storage is available';\nexport const DEFAULT_STORAGE_KEY = 'MultiStepForm';\n\nexport class MultiStepFormStorage<\n  data,\n  key extends string = DefaultStorageKey\n> {\n  readonly key: key;\n  readonly store!: Storage;\n  readonly data: data;\n  private readonly log: MultiStepFormLogger;\n  private readonly shouldRunActions: boolean;\n  private readonly throwWhenUndefined: boolean;\n\n  constructor(config: StorageConfig<data, key>) {\n    const { key, data, store, throwWhenUndefined = false } = config;\n\n    this.log = new MultiStepFormLogger({\n      prefix: DEFAULT_STORAGE_KEY,\n    });\n    this.key = key;\n    this.data = data;\n    this.throwWhenUndefined = throwWhenUndefined;\n\n    if (store) {\n      this.store = store;\n      this.shouldRunActions = true;\n\n      if (typeof window === 'undefined') {\n        this.shouldRunActions = false;\n        this.log.warn(WINDOW_UNDEFINED_MESSAGE);\n      }\n    } else if (typeof window !== 'undefined') {\n      this.store = window.localStorage;\n      this.shouldRunActions = true;\n    } else {\n      this.shouldRunActions = false;\n      this.log.warn(WINDOW_UNDEFINED_MESSAGE);\n    }\n  }\n\n  private throwOnEmptyStore() {\n    if (!this.throwWhenUndefined) {\n      return;\n    }\n\n    invariant(this.store, () => {\n      if (this.shouldRunActions) {\n        return WINDOW_UNDEFINED_MESSAGE;\n      }\n\n      return 'No storage available';\n    });\n  }\n\n  private resolveValue(value: Updater<data>) {\n    if (typeof value === 'object') {\n      return value;\n    }\n\n    if (typeof value === 'function') {\n      return (value as (input: data) => data)(this.data);\n    }\n\n    this.log.error(\n      `The updater value must be a function or object. Was a ${typeof value}`,\n      { throw: true }\n    );\n  }\n\n  hasKey() {\n    return this.store.getItem(this.key) !== null;\n  }\n\n  get() {\n    this.throwOnEmptyStore();\n\n    if (!this.shouldRunActions) {\n      return;\n    }\n\n    const item = this.store.getItem(this.key);\n\n    if (item) {\n      const parsed = JSON.parse(item);\n\n      return parsed as data;\n    }\n  }\n\n  remove() {\n    this.throwOnEmptyStore();\n\n    if (!this.shouldRunActions) {\n      return;\n    }\n\n    this.store.removeItem(this.key);\n  }\n\n  add(value: Updater<data>) {\n    this.throwOnEmptyStore();\n\n    if (!this.shouldRunActions) {\n      return;\n    }\n\n    const resolvedValue = JSON.stringify(this.resolveValue(value));\n\n    this.store.setItem(this.key, resolvedValue);\n  }\n}\n"],"mappings":";;;;AAgBA,MAAM,2BACJ;AACF,MAAa,sBAAsB;AAEnC,IAAa,uBAAb,MAGE;CACA,AAAS;CACT,AAAS;CACT,AAAS;CACT,AAAiB;CACjB,AAAiB;CACjB,AAAiB;CAEjB,YAAY,QAAkC;EAC5C,MAAM,EAAE,KAAK,MAAM,OAAO,qBAAqB,UAAU;AAEzD,OAAK,MAAM,IAAIA,mCAAoB,EACjC,QAAQ,qBACT,CAAC;AACF,OAAK,MAAM;AACX,OAAK,OAAO;AACZ,OAAK,qBAAqB;AAE1B,MAAI,OAAO;AACT,QAAK,QAAQ;AACb,QAAK,mBAAmB;AAExB,OAAI,OAAO,WAAW,aAAa;AACjC,SAAK,mBAAmB;AACxB,SAAK,IAAI,KAAK,yBAAyB;;aAEhC,OAAO,WAAW,aAAa;AACxC,QAAK,QAAQ,OAAO;AACpB,QAAK,mBAAmB;SACnB;AACL,QAAK,mBAAmB;AACxB,QAAK,IAAI,KAAK,yBAAyB;;;CAI3C,AAAQ,oBAAoB;AAC1B,MAAI,CAAC,KAAK,mBACR;AAGF,8BAAU,KAAK,aAAa;AAC1B,OAAI,KAAK,iBACP,QAAO;AAGT,UAAO;IACP;;CAGJ,AAAQ,aAAa,OAAsB;AACzC,MAAI,OAAO,UAAU,SACnB,QAAO;AAGT,MAAI,OAAO,UAAU,WACnB,QAAQ,MAAgC,KAAK,KAAK;AAGpD,OAAK,IAAI,MACP,yDAAyD,OAAO,SAChE,EAAE,OAAO,MAAM,CAChB;;CAGH,SAAS;AACP,SAAO,KAAK,MAAM,QAAQ,KAAK,IAAI,KAAK;;CAG1C,MAAM;AACJ,OAAK,mBAAmB;AAExB,MAAI,CAAC,KAAK,iBACR;EAGF,MAAM,OAAO,KAAK,MAAM,QAAQ,KAAK,IAAI;AAEzC,MAAI,KAGF,QAFe,KAAK,MAAM,KAAK;;CAMnC,SAAS;AACP,OAAK,mBAAmB;AAExB,MAAI,CAAC,KAAK,iBACR;AAGF,OAAK,MAAM,WAAW,KAAK,IAAI;;CAGjC,IAAI,OAAsB;AACxB,OAAK,mBAAmB;AAExB,MAAI,CAAC,KAAK,iBACR;EAGF,MAAM,gBAAgB,KAAK,UAAU,KAAK,aAAa,MAAM,CAAC;AAE9D,OAAK,MAAM,QAAQ,KAAK,KAAK,cAAc"}

package/dist/storage.d.cts

@@ -0,0 +1,33 @@
+import { Updater } from "./steps/types.cjs";
+
+//#region src/storage.d.ts
+type DefaultStorageKey = typeof DEFAULT_STORAGE_KEY;
+type StorageConfig<TData, TKey extends string> = {
+  key: TKey;
+  data: TData;
+  store?: Storage;
+  /**
+   * An extra option to throw an error when {@linkcode window} is `undefined`
+   * @default false
+   */
+  throwWhenUndefined?: boolean;
+};
+declare const DEFAULT_STORAGE_KEY = "MultiStepForm";
+declare class MultiStepFormStorage<data, key extends string = DefaultStorageKey> {
+  readonly key: key;
+  readonly store: Storage;
+  readonly data: data;
+  private readonly log;
+  private readonly shouldRunActions;
+  private readonly throwWhenUndefined;
+  constructor(config: StorageConfig<data, key>);
+  private throwOnEmptyStore;
+  private resolveValue;
+  hasKey(): boolean;
+  get(): data | undefined;
+  remove(): void;
+  add(value: Updater<data>): void;
+}
+//#endregion
+export { DEFAULT_STORAGE_KEY, DefaultStorageKey, MultiStepFormStorage, StorageConfig };
+//# sourceMappingURL=storage.d.cts.map

package/dist/storage.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.d.cts","names":[],"sources":["../src/storage.ts"],"sourcesContent":[],"mappings":";;;KAIY,iBAAA,UAA2B;KAC3B;EADA,GAAA,EAEL,IAFK;EACA,IAAA,EAEJ,KAFI;EACL,KAAA,CAAA,EAEG,OAFH;EACC;;;AAWR;EAEa,kBAAA,CAAA,EAAA,OAAoB;CAEV;AAEP,cANH,mBAAA,GAMG,eAAA;AACG,cALN,oBAKM,CAAA,IAAA,EAAA,YAAA,MAAA,GAHI,iBAGJ,CAAA,CAAA;EACF,SAAA,GAAA,EAFD,GAEC;EAKmB,SAAA,KAAA,EANjB,OAMiB;EAAM,SAAA,IAAA,EALzB,IAKyB;EAApB,iBAAA,GAAA;EA4DjB,iBAAA,gBAAA;EA0BgB,iBAAA,kBAAA;EAAR,WAAA,CAAA,MAAA,EAtFS,aAsFT,CAtFuB,IAsFvB,EAtF6B,GAsF7B,CAAA;EAAO,QAAA,iBAAA;;;SA1Bf;;aA0BQ,QAAQ"}

package/dist/storage.d.mts

@@ -0,0 +1,33 @@
+import { Updater } from "./steps/types.mjs";
+
+//#region src/storage.d.ts
+type DefaultStorageKey = typeof DEFAULT_STORAGE_KEY;
+type StorageConfig<TData, TKey extends string> = {
+  key: TKey;
+  data: TData;
+  store?: Storage;
+  /**
+   * An extra option to throw an error when {@linkcode window} is `undefined`
+   * @default false
+   */
+  throwWhenUndefined?: boolean;
+};
+declare const DEFAULT_STORAGE_KEY = "MultiStepForm";
+declare class MultiStepFormStorage<data, key extends string = DefaultStorageKey> {
+  readonly key: key;
+  readonly store: Storage;
+  readonly data: data;
+  private readonly log;
+  private readonly shouldRunActions;
+  private readonly throwWhenUndefined;
+  constructor(config: StorageConfig<data, key>);
+  private throwOnEmptyStore;
+  private resolveValue;
+  hasKey(): boolean;
+  get(): data | undefined;
+  remove(): void;
+  add(value: Updater<data>): void;
+}
+//#endregion
+export { DEFAULT_STORAGE_KEY, DefaultStorageKey, MultiStepFormStorage, StorageConfig };
+//# sourceMappingURL=storage.d.mts.map

package/dist/storage.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.d.mts","names":[],"sources":["../src/storage.ts"],"sourcesContent":[],"mappings":";;;KAIY,iBAAA,UAA2B;KAC3B;EADA,GAAA,EAEL,IAFK;EACA,IAAA,EAEJ,KAFI;EACL,KAAA,CAAA,EAEG,OAFH;EACC;;;AAWR;EAEa,kBAAA,CAAA,EAAA,OAAoB;CAEV;AAEP,cANH,mBAAA,GAMG,eAAA;AACG,cALN,oBAKM,CAAA,IAAA,EAAA,YAAA,MAAA,GAHI,iBAGJ,CAAA,CAAA;EACF,SAAA,GAAA,EAFD,GAEC;EAKmB,SAAA,KAAA,EANjB,OAMiB;EAAM,SAAA,IAAA,EALzB,IAKyB;EAApB,iBAAA,GAAA;EA4DjB,iBAAA,gBAAA;EA0BgB,iBAAA,kBAAA;EAAR,WAAA,CAAA,MAAA,EAtFS,aAsFT,CAtFuB,IAsFvB,EAtF6B,GAsF7B,CAAA;EAAO,QAAA,iBAAA;;;SA1Bf;;aA0BQ,QAAQ"}

package/dist/storage.mjs

@@ -0,0 +1,71 @@
+import { invariant } from "./utils/invariant.mjs";
+import { MultiStepFormLogger } from "./utils/logger.mjs";
+
+//#region src/storage.ts
+const WINDOW_UNDEFINED_MESSAGE = "\"window\" in undefined. No storage is available";
+const DEFAULT_STORAGE_KEY = "MultiStepForm";
+var MultiStepFormStorage = class {
+	key;
+	store;
+	data;
+	log;
+	shouldRunActions;
+	throwWhenUndefined;
+	constructor(config) {
+		const { key, data, store, throwWhenUndefined = false } = config;
+		this.log = new MultiStepFormLogger({ prefix: DEFAULT_STORAGE_KEY });
+		this.key = key;
+		this.data = data;
+		this.throwWhenUndefined = throwWhenUndefined;
+		if (store) {
+			this.store = store;
+			this.shouldRunActions = true;
+			if (typeof window === "undefined") {
+				this.shouldRunActions = false;
+				this.log.warn(WINDOW_UNDEFINED_MESSAGE);
+			}
+		} else if (typeof window !== "undefined") {
+			this.store = window.localStorage;
+			this.shouldRunActions = true;
+		} else {
+			this.shouldRunActions = false;
+			this.log.warn(WINDOW_UNDEFINED_MESSAGE);
+		}
+	}
+	throwOnEmptyStore() {
+		if (!this.throwWhenUndefined) return;
+		invariant(this.store, () => {
+			if (this.shouldRunActions) return WINDOW_UNDEFINED_MESSAGE;
+			return "No storage available";
+		});
+	}
+	resolveValue(value) {
+		if (typeof value === "object") return value;
+		if (typeof value === "function") return value(this.data);
+		this.log.error(`The updater value must be a function or object. Was a ${typeof value}`, { throw: true });
+	}
+	hasKey() {
+		return this.store.getItem(this.key) !== null;
+	}
+	get() {
+		this.throwOnEmptyStore();
+		if (!this.shouldRunActions) return;
+		const item = this.store.getItem(this.key);
+		if (item) return JSON.parse(item);
+	}
+	remove() {
+		this.throwOnEmptyStore();
+		if (!this.shouldRunActions) return;
+		this.store.removeItem(this.key);
+	}
+	add(value) {
+		this.throwOnEmptyStore();
+		if (!this.shouldRunActions) return;
+		const resolvedValue = JSON.stringify(this.resolveValue(value));
+		this.store.setItem(this.key, resolvedValue);
+	}
+};
+
+//#endregion
+export { DEFAULT_STORAGE_KEY, MultiStepFormStorage };
+//# sourceMappingURL=storage.mjs.map

package/dist/storage.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.mjs","names":[],"sources":["../src/storage.ts"],"sourcesContent":["import type { Updater } from '@/steps/types';\nimport { invariant } from '@/utils/invariant';\nimport { MultiStepFormLogger } from '@/utils/logger';\n\nexport type DefaultStorageKey = typeof DEFAULT_STORAGE_KEY;\nexport type StorageConfig<TData, TKey extends string> = {\n  key: TKey;\n  data: TData;\n  store?: Storage;\n  /**\n   * An extra option to throw an error when {@linkcode window} is `undefined`\n   * @default false\n   */\n  throwWhenUndefined?: boolean;\n};\n\nconst WINDOW_UNDEFINED_MESSAGE =\n  '\"window\" in undefined. No storage is available';\nexport const DEFAULT_STORAGE_KEY = 'MultiStepForm';\n\nexport class MultiStepFormStorage<\n  data,\n  key extends string = DefaultStorageKey\n> {\n  readonly key: key;\n  readonly store!: Storage;\n  readonly data: data;\n  private readonly log: MultiStepFormLogger;\n  private readonly shouldRunActions: boolean;\n  private readonly throwWhenUndefined: boolean;\n\n  constructor(config: StorageConfig<data, key>) {\n    const { key, data, store, throwWhenUndefined = false } = config;\n\n    this.log = new MultiStepFormLogger({\n      prefix: DEFAULT_STORAGE_KEY,\n    });\n    this.key = key;\n    this.data = data;\n    this.throwWhenUndefined = throwWhenUndefined;\n\n    if (store) {\n      this.store = store;\n      this.shouldRunActions = true;\n\n      if (typeof window === 'undefined') {\n        this.shouldRunActions = false;\n        this.log.warn(WINDOW_UNDEFINED_MESSAGE);\n      }\n    } else if (typeof window !== 'undefined') {\n      this.store = window.localStorage;\n      this.shouldRunActions = true;\n    } else {\n      this.shouldRunActions = false;\n      this.log.warn(WINDOW_UNDEFINED_MESSAGE);\n    }\n  }\n\n  private throwOnEmptyStore() {\n    if (!this.throwWhenUndefined) {\n      return;\n    }\n\n    invariant(this.store, () => {\n      if (this.shouldRunActions) {\n        return WINDOW_UNDEFINED_MESSAGE;\n      }\n\n      return 'No storage available';\n    });\n  }\n\n  private resolveValue(value: Updater<data>) {\n    if (typeof value === 'object') {\n      return value;\n    }\n\n    if (typeof value === 'function') {\n      return (value as (input: data) => data)(this.data);\n    }\n\n    this.log.error(\n      `The updater value must be a function or object. Was a ${typeof value}`,\n      { throw: true }\n    );\n  }\n\n  hasKey() {\n    return this.store.getItem(this.key) !== null;\n  }\n\n  get() {\n    this.throwOnEmptyStore();\n\n    if (!this.shouldRunActions) {\n      return;\n    }\n\n    const item = this.store.getItem(this.key);\n\n    if (item) {\n      const parsed = JSON.parse(item);\n\n      return parsed as data;\n    }\n  }\n\n  remove() {\n    this.throwOnEmptyStore();\n\n    if (!this.shouldRunActions) {\n      return;\n    }\n\n    this.store.removeItem(this.key);\n  }\n\n  add(value: Updater<data>) {\n    this.throwOnEmptyStore();\n\n    if (!this.shouldRunActions) {\n      return;\n    }\n\n    const resolvedValue = JSON.stringify(this.resolveValue(value));\n\n    this.store.setItem(this.key, resolvedValue);\n  }\n}\n"],"mappings":";;;;AAgBA,MAAM,2BACJ;AACF,MAAa,sBAAsB;AAEnC,IAAa,uBAAb,MAGE;CACA,AAAS;CACT,AAAS;CACT,AAAS;CACT,AAAiB;CACjB,AAAiB;CACjB,AAAiB;CAEjB,YAAY,QAAkC;EAC5C,MAAM,EAAE,KAAK,MAAM,OAAO,qBAAqB,UAAU;AAEzD,OAAK,MAAM,IAAI,oBAAoB,EACjC,QAAQ,qBACT,CAAC;AACF,OAAK,MAAM;AACX,OAAK,OAAO;AACZ,OAAK,qBAAqB;AAE1B,MAAI,OAAO;AACT,QAAK,QAAQ;AACb,QAAK,mBAAmB;AAExB,OAAI,OAAO,WAAW,aAAa;AACjC,SAAK,mBAAmB;AACxB,SAAK,IAAI,KAAK,yBAAyB;;aAEhC,OAAO,WAAW,aAAa;AACxC,QAAK,QAAQ,OAAO;AACpB,QAAK,mBAAmB;SACnB;AACL,QAAK,mBAAmB;AACxB,QAAK,IAAI,KAAK,yBAAyB;;;CAI3C,AAAQ,oBAAoB;AAC1B,MAAI,CAAC,KAAK,mBACR;AAGF,YAAU,KAAK,aAAa;AAC1B,OAAI,KAAK,iBACP,QAAO;AAGT,UAAO;IACP;;CAGJ,AAAQ,aAAa,OAAsB;AACzC,MAAI,OAAO,UAAU,SACnB,QAAO;AAGT,MAAI,OAAO,UAAU,WACnB,QAAQ,MAAgC,KAAK,KAAK;AAGpD,OAAK,IAAI,MACP,yDAAyD,OAAO,SAChE,EAAE,OAAO,MAAM,CAChB;;CAGH,SAAS;AACP,SAAO,KAAK,MAAM,QAAQ,KAAK,IAAI,KAAK;;CAG1C,MAAM;AACJ,OAAK,mBAAmB;AAExB,MAAI,CAAC,KAAK,iBACR;EAGF,MAAM,OAAO,KAAK,MAAM,QAAQ,KAAK,IAAI;AAEzC,MAAI,KAGF,QAFe,KAAK,MAAM,KAAK;;CAMnC,SAAS;AACP,OAAK,mBAAmB;AAExB,MAAI,CAAC,KAAK,iBACR;AAGF,OAAK,MAAM,WAAW,KAAK,IAAI;;CAGjC,IAAI,OAAsB;AACxB,OAAK,mBAAmB;AAExB,MAAI,CAAC,KAAK,iBACR;EAGF,MAAM,gBAAgB,KAAK,UAAU,KAAK,aAAa,MAAM,CAAC;AAE9D,OAAK,MAAM,QAAQ,KAAK,KAAK,cAAc"}

package/dist/subscribable.cjs

@@ -0,0 +1,25 @@
+
+//#region src/subscribable.ts
+var Subscribable = class {
+	listeners = /* @__PURE__ */ new Set();
+	constructor() {
+		this.subscribe = this.subscribe.bind(this);
+	}
+	subscribe(listener) {
+		this.listeners.add(listener);
+		this.onSubscribe();
+		return () => {
+			this.listeners.delete(listener);
+			this.onUnsubscribe();
+		};
+	}
+	hasListeners() {
+		return this.listeners.size > 0;
+	}
+	onSubscribe() {}
+	onUnsubscribe() {}
+};
+
+//#endregion
+exports.Subscribable = Subscribable;
+//# sourceMappingURL=subscribable.cjs.map

package/dist/subscribable.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"subscribable.cjs","names":[],"sources":["../src/subscribable.ts"],"sourcesContent":["export abstract class Subscribable<TListener extends Function> {\n  protected listeners = new Set<TListener>();\n\n  constructor() {\n    this.subscribe = this.subscribe.bind(this);\n  }\n\n  subscribe(listener: TListener) {\n    this.listeners.add(listener);\n\n    this.onSubscribe();\n\n    return () => {\n      this.listeners.delete(listener);\n      this.onUnsubscribe();\n    };\n  }\n\n  hasListeners() {\n    return this.listeners.size > 0;\n  }\n\n  protected onSubscribe() {}\n  protected onUnsubscribe() {}\n  protected abstract notify(): void;\n  abstract getSnapshot(): this;\n}\n"],"mappings":";;AAAA,IAAsB,eAAtB,MAA+D;CAC7D,AAAU,4BAAY,IAAI,KAAgB;CAE1C,cAAc;AACZ,OAAK,YAAY,KAAK,UAAU,KAAK,KAAK;;CAG5C,UAAU,UAAqB;AAC7B,OAAK,UAAU,IAAI,SAAS;AAE5B,OAAK,aAAa;AAElB,eAAa;AACX,QAAK,UAAU,OAAO,SAAS;AAC/B,QAAK,eAAe;;;CAIxB,eAAe;AACb,SAAO,KAAK,UAAU,OAAO;;CAG/B,AAAU,cAAc;CACxB,AAAU,gBAAgB"}

package/dist/subscribable.d.cts

@@ -0,0 +1,14 @@
+//#region src/subscribable.d.ts
+declare abstract class Subscribable<TListener extends Function> {
+  protected listeners: Set<TListener>;
+  constructor();
+  subscribe(listener: TListener): () => void;
+  hasListeners(): boolean;
+  protected onSubscribe(): void;
+  protected onUnsubscribe(): void;
+  protected abstract notify(): void;
+  abstract getSnapshot(): this;
+}
+//#endregion
+export { Subscribable };
+//# sourceMappingURL=subscribable.d.cts.map

package/dist/subscribable.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subscribable.d.cts","names":[],"sources":["../src/subscribable.ts"],"sourcesContent":[],"mappings":";uBAAsB,+BAA+B;EAA/B,UAAA,SAAY,EACb,GADa,CACb,SADa,CAAA;EAAmB,WAAA,CAAA;EAChC,SAAA,CAAA,QAAA,EAMC,SAND,CAAA,EAAA,GAAA,GAAA,IAAA;EAAA,YAAA,CAAA,CAAA,EAAA,OAAA;EAMC,UAAA,WAAA,CAAA,CAAA,EAAA,IAAA;EAAS,UAAA,aAAA,CAAA,CAAA,EAAA,IAAA"}

package/dist/subscribable.d.mts

@@ -0,0 +1,14 @@
+//#region src/subscribable.d.ts
+declare abstract class Subscribable<TListener extends Function> {
+  protected listeners: Set<TListener>;
+  constructor();
+  subscribe(listener: TListener): () => void;
+  hasListeners(): boolean;
+  protected onSubscribe(): void;
+  protected onUnsubscribe(): void;
+  protected abstract notify(): void;
+  abstract getSnapshot(): this;
+}
+//#endregion
+export { Subscribable };
+//# sourceMappingURL=subscribable.d.mts.map

package/dist/subscribable.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subscribable.d.mts","names":[],"sources":["../src/subscribable.ts"],"sourcesContent":[],"mappings":";uBAAsB,+BAA+B;EAA/B,UAAA,SAAY,EACb,GADa,CACb,SADa,CAAA;EAAmB,WAAA,CAAA;EAChC,SAAA,CAAA,QAAA,EAMC,SAND,CAAA,EAAA,GAAA,GAAA,IAAA;EAAA,YAAA,CAAA,CAAA,EAAA,OAAA;EAMC,UAAA,WAAA,CAAA,CAAA,EAAA,IAAA;EAAS,UAAA,aAAA,CAAA,CAAA,EAAA,IAAA"}

package/dist/subscribable.mjs

@@ -0,0 +1,24 @@
+//#region src/subscribable.ts
+var Subscribable = class {
+	listeners = /* @__PURE__ */ new Set();
+	constructor() {
+		this.subscribe = this.subscribe.bind(this);
+	}
+	subscribe(listener) {
+		this.listeners.add(listener);
+		this.onSubscribe();
+		return () => {
+			this.listeners.delete(listener);
+			this.onUnsubscribe();
+		};
+	}
+	hasListeners() {
+		return this.listeners.size > 0;
+	}
+	onSubscribe() {}
+	onUnsubscribe() {}
+};
+
+//#endregion
+export { Subscribable };
+//# sourceMappingURL=subscribable.mjs.map

package/dist/subscribable.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"subscribable.mjs","names":[],"sources":["../src/subscribable.ts"],"sourcesContent":["export abstract class Subscribable<TListener extends Function> {\n  protected listeners = new Set<TListener>();\n\n  constructor() {\n    this.subscribe = this.subscribe.bind(this);\n  }\n\n  subscribe(listener: TListener) {\n    this.listeners.add(listener);\n\n    this.onSubscribe();\n\n    return () => {\n      this.listeners.delete(listener);\n      this.onUnsubscribe();\n    };\n  }\n\n  hasListeners() {\n    return this.listeners.size > 0;\n  }\n\n  protected onSubscribe() {}\n  protected onUnsubscribe() {}\n  protected abstract notify(): void;\n  abstract getSnapshot(): this;\n}\n"],"mappings":";AAAA,IAAsB,eAAtB,MAA+D;CAC7D,AAAU,4BAAY,IAAI,KAAgB;CAE1C,cAAc;AACZ,OAAK,YAAY,KAAK,UAAU,KAAK,KAAK;;CAG5C,UAAU,UAAqB;AAC7B,OAAK,UAAU,IAAI,SAAS;AAE5B,OAAK,aAAa;AAElB,eAAa;AACX,QAAK,UAAU,OAAO,SAAS;AAC/B,QAAK,eAAe;;;CAIxB,eAAe;AACb,SAAO,KAAK,UAAU,OAAO;;CAG/B,AAAU,cAAc;CACxB,AAAU,gBAAgB"}

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