@jfdevelops/multi-step-form-core 1.0.0-alpha.22 → 1.0.0-alpha.24

package/dist/steps/steps.mjs

@@ -0,0 +1,76 @@
+import { CASING_TYPES, DEFAULT_CASING, isCasingValid } from "../utils/casing.mjs";
+import { createInvariant } from "../utils/invariant.mjs";
+import "../utils/index.mjs";
+import { fields } from "./fields.mjs";
+
+//#region src/steps/steps.ts
+const VALIDATED_STEP_REGEX = /^step\d+$/i;
+let steps;
+(function(_steps) {
+	function instantiate(def) {
+		const { steps: steps$1 } = def;
+		const invariant = createInvariant("[instantiateSteps]");
+		invariant(steps$1, "No steps were provided to the \"steps\" option.", TypeError);
+		invariant(typeof steps$1 === "object", "\"steps\" must be an object.", TypeError);
+		invariant(Object.keys(steps$1).length > 0, "\"steps\" must contain at least one step.", TypeError);
+		let resolvedSteps = {};
+		for (const [stepKey, stepValue] of Object.entries(steps$1)) {
+			const invariant$1 = createInvariant(`[instantiateSteps - ${stepKey}]`);
+			invariant$1(typeof stepKey === "string", `Each key for the step config must be a string. Key "${stepKey}" was ${typeof stepKey} `, TypeError);
+			invariant$1(VALIDATED_STEP_REGEX.test(stepKey), `The key "${stepKey}" isn't formatted properly. Each key in the step config must be the following format: "step{number}"`);
+			const { fields: fieldsDef, title, description, validateFields, nameTransformCasing = DEFAULT_CASING } = stepValue;
+			invariant$1(title, "A title must be provided for each step.", TypeError);
+			invariant$1(typeof title === "string", "The title must be a string.", TypeError);
+			if (description) invariant$1(typeof description === "string", "The description must be a string.", TypeError);
+			if (nameTransformCasing) {
+				invariant$1(typeof nameTransformCasing === "string", `The nameTransformCasing must be a string. Was ${typeof nameTransformCasing}`, TypeError);
+				invariant$1(isCasingValid(nameTransformCasing), (formatter) => `The nameTransformCasing is not a valid casing. Was ${nameTransformCasing}, must be one of ${formatter.format(CASING_TYPES)}`, TypeError);
+			}
+			const instantiatedFields = fields.instantiate({
+				fields: fieldsDef,
+				defaultCasing: nameTransformCasing,
+				validateFields
+			});
+			resolvedSteps[stepKey] = {
+				...resolvedSteps[stepKey],
+				title,
+				...typeof description === "string" ? { description } : {},
+				nameTransformCasing,
+				fields: instantiatedFields
+			};
+		}
+		return resolvedSteps;
+	}
+	_steps.instantiate = instantiate;
+	function isValidStepValue(stepValue) {
+		if (stepValue === null || typeof stepValue !== "object") return false;
+		const step = stepValue;
+		if (!("title" in step) || typeof step.title !== "string") return false;
+		if ("description" in step) {
+			if (typeof step.description !== "string") return false;
+		}
+		if ("nameTransformCasing" in step) {
+			const casing = step.nameTransformCasing;
+			if (typeof casing !== "string" || !isCasingValid(casing)) return false;
+		}
+		if (!("fields" in step)) return false;
+		return fields.isValidFieldConfig(step.fields);
+	}
+	function isValidSteps(value) {
+		if (value === null || typeof value !== "object") return false;
+		const steps$1 = value;
+		if (Object.keys(steps$1).length === 0) return false;
+		for (const [stepKey, stepValue] of Object.entries(steps$1)) {
+			if (typeof stepKey !== "string") return false;
+			if (!VALIDATED_STEP_REGEX.test(stepKey)) return false;
+			if (!isValidStepValue(stepValue)) return false;
+		}
+		return true;
+	}
+	_steps.isValidSteps = isValidSteps;
+})(steps || (steps = {}));
+const instantiateSteps = steps.instantiate;
+
+//#endregion
+export { VALIDATED_STEP_REGEX, instantiateSteps, steps };
+//# sourceMappingURL=steps.mjs.map

package/dist/steps/steps.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"steps.mjs","names":["invariant: Invariant","steps","resolvedSteps: Record<string, unknown>"],"sources":["../../src/steps/steps.ts"],"sourcesContent":["import {\n  CASING_TYPES,\n  CasingType,\n  Constrain,\n  DEFAULT_CASING,\n  DefaultCasing,\n  isCasingValid,\n  type Expand,\n  type Show,\n} from '@/utils';\nimport { createInvariant, type Invariant } from '@/utils/invariant';\nimport type { AnyValidator, DefaultValidator } from '@/utils/validator';\nimport { fields } from './fields';\nimport type { StepSpecificHelperFn } from './fn-utils/helper-fn/utils';\nimport type { ResetFn } from './fn-utils/reset-fn';\nimport type { UpdateFn } from './fn-utils/update-fn';\n\nexport const VALIDATED_STEP_REGEX = /^step\\d+$/i;\n\nexport namespace steps {\n  type ValidStepKey<N extends number = number> = `step${N}`;\n\n  export interface Config<\n    TCasing extends CasingType,\n    TFields extends fields.FieldConfig<TCasing>,\n    TValidator = unknown,\n  > extends fields.NameTransformCasingOptions<TCasing> {\n    title: string;\n    description?: string;\n    fields: TFields;\n    validateFields?: Constrain<TValidator, AnyValidator, DefaultValidator>;\n  }\n  export type AnyConfig = Config<\n    CasingType,\n    fields.FieldConfig<CasingType>,\n    AnyValidator\n  >;\n  export type config<\n    TCasing extends CasingType = DefaultCasing,\n    TFields extends fields.FieldConfig<TCasing> = fields.FieldConfig<TCasing>,\n    TValidator = unknown,\n  > = Record<ValidStepKey, Config<TCasing, TFields, TValidator>>;\n\n  export type instantiateConfig<TMap extends config = config> = {\n    /**\n     * The steps that this multi step form will include.\n     * @example\n     * ```ts\n     * {\n     *   step1: {\n     *     title: 'Step 1',\n     *     fields: {\n     *       name: {\n     *         defaultValue: '',\n     *       },\n     *     },\n     *  },\n     *   step2: {\n     *     title: 'Step 2',\n     *     fields: {\n     *       dateOfBirth: {\n     *         defaultValue: new Date(),\n     *         // `type` is automatically set to `date` if the defaultValue is a Date\n     *       },\n     *     },\n     *   },\n     * }\n     * ```\n     */\n    steps: TMap;\n  };\n  /**\n   * Extended step specific properties for the step.\n   */\n  // @ts-expect-error - This is a placeholder for the extended step specific properties.\n  export interface ExtendedStepSpecificProperties<t, key> {}\n  export type _instantiateSteps<T = unknown> = [T] extends [object]\n    ? T extends instantiateConfig\n      ? {\n          -readonly [key in keyof T['steps']]: Expand<\n            {\n              title: string;\n              nameTransformCasing: fields.inferNameTransformCasing<\n                T['steps'][key],\n                DefaultCasing\n              >;\n              fields: fields.instantiateFields<\n                T['steps'][key],\n                fields.inferNameTransformCasing<T['steps'][key], DefaultCasing>\n              >;\n            } & (T['steps'][key] extends {\n              description: infer description extends string;\n            }\n              ? { description: description }\n              : {}) &\n              ExtendedStepSpecificProperties<T, key>\n          >;\n        }\n      : {}\n    : {};\n  /**\n   * Extended step specific functions for the step.\n   */\n  export interface ExtendedStepSpecificFunctions<\n    def,\n    value,\n    key extends StepNumbers<value>,\n  > {}\n  export type instantiateSteps<\n    t = unknown,\n    value = _instantiateSteps<t>,\n  > = Expand<{\n    [key in keyof value]: Show<\n      value[key] &\n        (value extends {}\n          ? key extends StepNumbers<value>\n            ? {\n                update: UpdateFn.stepSpecific<value, key>;\n                reset: ResetFn.stepSpecific<value, key>;\n                createHelperFn: StepSpecificHelperFn<value, key>;\n              } & ExtendedStepSpecificFunctions<t, value, key>\n            : {}\n          : {})\n    >;\n  }>;\n  export type Any = instantiateSteps<instantiateConfig>;\n  export type StepNumbers<T> = keyof T extends string ? keyof T : never;\n  export type getCurrent<\n    value extends instantiateSteps,\n    stepNumbers extends StepNumbers<value>,\n  > = value[stepNumbers];\n\n  export function instantiate<\n    const def extends instantiateConfig,\n    inst = instantiateSteps<def>,\n  >(def: def) {\n    const { steps } = def;\n    const invariant: Invariant = createInvariant('[instantiateSteps]');\n\n    invariant(\n      steps,\n      'No steps were provided to the \"steps\" option.',\n      TypeError\n    );\n    invariant(\n      typeof steps === 'object',\n      '\"steps\" must be an object.',\n      TypeError\n    );\n    invariant(\n      Object.keys(steps).length > 0,\n      '\"steps\" must contain at least one step.',\n      TypeError\n    );\n\n    let resolvedSteps: Record<string, unknown> = {};\n\n    for (const [stepKey, stepValue] of Object.entries(steps)) {\n      const invariant: Invariant = createInvariant(\n        `[instantiateSteps - ${stepKey}]`\n      );\n\n      invariant(\n        typeof stepKey === 'string',\n        `Each key for the step config must be a string. Key \"${stepKey}\" was ${typeof stepKey} `,\n        TypeError\n      );\n      invariant(\n        VALIDATED_STEP_REGEX.test(stepKey),\n        `The key \"${stepKey}\" isn't formatted properly. Each key in the step config must be the following format: \"step{number}\"`\n      );\n\n      const {\n        fields: fieldsDef,\n        title,\n        description,\n        validateFields,\n        nameTransformCasing = DEFAULT_CASING,\n      } = stepValue;\n\n      // title validation\n      invariant(title, 'A title must be provided for each step.', TypeError);\n      invariant(\n        typeof title === 'string',\n        'The title must be a string.',\n        TypeError\n      );\n\n      if (description) {\n        invariant(\n          typeof description === 'string',\n          'The description must be a string.',\n          TypeError\n        );\n      }\n\n      if (nameTransformCasing) {\n        invariant(\n          typeof nameTransformCasing === 'string',\n          `The nameTransformCasing must be a string. Was ${typeof nameTransformCasing}`,\n          TypeError\n        );\n        invariant(\n          isCasingValid(nameTransformCasing),\n          (formatter) =>\n            `The nameTransformCasing is not a valid casing. Was ${nameTransformCasing}, must be one of ${formatter.format(\n              CASING_TYPES\n            )}`,\n          TypeError\n        );\n      }\n\n      const instantiatedFields = fields.instantiate({\n        fields: fieldsDef,\n        defaultCasing: nameTransformCasing,\n        validateFields,\n      });\n\n      resolvedSteps[stepKey] = {\n        ...(resolvedSteps[stepKey] as Record<string, unknown>),\n        title,\n        // Only add the description if it's defined\n        ...(typeof description === 'string' ? { description } : {}),\n        nameTransformCasing,\n        fields: instantiatedFields,\n      };\n    }\n\n    return resolvedSteps as inst;\n  }\n\n  function isValidStepValue(stepValue: unknown): stepValue is AnyConfig {\n    if (stepValue === null || typeof stepValue !== 'object') {\n      return false;\n    }\n\n    const step = stepValue as Record<string, unknown>;\n\n    // Must have title\n    if (!('title' in step) || typeof step.title !== 'string') {\n      return false;\n    }\n\n    // If description is provided, it must be a string\n    if ('description' in step) {\n      if (typeof step.description !== 'string') {\n        return false;\n      }\n    }\n\n    // If nameTransformCasing is provided, it must be a valid casing\n    if ('nameTransformCasing' in step) {\n      const casing = step.nameTransformCasing;\n      if (typeof casing !== 'string' || !isCasingValid(casing)) {\n        return false;\n      }\n    }\n\n    // Must have fields and it must be a valid field config\n    if (!('fields' in step)) {\n      return false;\n    }\n\n    return fields.isValidFieldConfig(step.fields);\n  }\n\n  export function isValidSteps(value: unknown): value is config {\n    if (value === null || typeof value !== 'object') {\n      return false;\n    }\n\n    const steps = value as Record<string, unknown>;\n\n    // Check if steps has at least one key\n    if (Object.keys(steps).length === 0) {\n      return false;\n    }\n\n    // Validate each step\n    for (const [stepKey, stepValue] of Object.entries(steps)) {\n      // Each key must be a string\n      if (typeof stepKey !== 'string') {\n        return false;\n      }\n\n      // Each key must match the step regex pattern\n      if (!VALIDATED_STEP_REGEX.test(stepKey)) {\n        return false;\n      }\n\n      // Each value must be a valid step config\n      if (!isValidStepValue(stepValue)) {\n        return false;\n      }\n    }\n\n    return true;\n  }\n}\n\nexport const instantiateSteps = steps.instantiate;\n"],"mappings":";;;;;;AAiBA,MAAa,uBAAuB;;;CAmH3B,SAAS,YAGd,KAAU;EACV,MAAM,EAAE,mBAAU;EAClB,MAAMA,YAAuB,gBAAgB,qBAAqB;AAElE,YACEC,SACA,mDACA,UACD;AACD,YACE,OAAOA,YAAU,UACjB,gCACA,UACD;AACD,YACE,OAAO,KAAKA,QAAM,CAAC,SAAS,GAC5B,6CACA,UACD;EAED,IAAIC,gBAAyC,EAAE;AAE/C,OAAK,MAAM,CAAC,SAAS,cAAc,OAAO,QAAQD,QAAM,EAAE;GACxD,MAAMD,cAAuB,gBAC3B,uBAAuB,QAAQ,GAChC;AAED,eACE,OAAO,YAAY,UACnB,uDAAuD,QAAQ,QAAQ,OAAO,QAAQ,IACtF,UACD;AACD,eACE,qBAAqB,KAAK,QAAQ,EAClC,YAAY,QAAQ,sGACrB;GAED,MAAM,EACJ,QAAQ,WACR,OACA,aACA,gBACA,sBAAsB,mBACpB;AAGJ,eAAU,OAAO,2CAA2C,UAAU;AACtE,eACE,OAAO,UAAU,UACjB,+BACA,UACD;AAED,OAAI,YACF,aACE,OAAO,gBAAgB,UACvB,qCACA,UACD;AAGH,OAAI,qBAAqB;AACvB,gBACE,OAAO,wBAAwB,UAC/B,iDAAiD,OAAO,uBACxD,UACD;AACD,gBACE,cAAc,oBAAoB,GACjC,cACC,sDAAsD,oBAAoB,mBAAmB,UAAU,OACrG,aACD,IACH,UACD;;GAGH,MAAM,qBAAqB,OAAO,YAAY;IAC5C,QAAQ;IACR,eAAe;IACf;IACD,CAAC;AAEF,iBAAc,WAAW;IACvB,GAAI,cAAc;IAClB;IAEA,GAAI,OAAO,gBAAgB,WAAW,EAAE,aAAa,GAAG,EAAE;IAC1D;IACA,QAAQ;IACT;;AAGH,SAAO;;;CAGT,SAAS,iBAAiB,WAA4C;AACpE,MAAI,cAAc,QAAQ,OAAO,cAAc,SAC7C,QAAO;EAGT,MAAM,OAAO;AAGb,MAAI,EAAE,WAAW,SAAS,OAAO,KAAK,UAAU,SAC9C,QAAO;AAIT,MAAI,iBAAiB,MACnB;OAAI,OAAO,KAAK,gBAAgB,SAC9B,QAAO;;AAKX,MAAI,yBAAyB,MAAM;GACjC,MAAM,SAAS,KAAK;AACpB,OAAI,OAAO,WAAW,YAAY,CAAC,cAAc,OAAO,CACtD,QAAO;;AAKX,MAAI,EAAE,YAAY,MAChB,QAAO;AAGT,SAAO,OAAO,mBAAmB,KAAK,OAAO;;CAGxC,SAAS,aAAa,OAAiC;AAC5D,MAAI,UAAU,QAAQ,OAAO,UAAU,SACrC,QAAO;EAGT,MAAMC,UAAQ;AAGd,MAAI,OAAO,KAAKA,QAAM,CAAC,WAAW,EAChC,QAAO;AAIT,OAAK,MAAM,CAAC,SAAS,cAAc,OAAO,QAAQA,QAAM,EAAE;AAExD,OAAI,OAAO,YAAY,SACrB,QAAO;AAIT,OAAI,CAAC,qBAAqB,KAAK,QAAQ,CACrC,QAAO;AAIT,OAAI,CAAC,iBAAiB,UAAU,CAC9B,QAAO;;AAIX,SAAO;;;;AAIX,MAAa,mBAAmB,MAAM"}

package/dist/steps/utils.cjs

@@ -1,5 +1,6 @@
-const require_helpers = require('../utils/helpers.cjs');
+const require_index = require('./fn-utils/helper-fn/index.cjs');
 const require_invariant = require('../utils/invariant.cjs');
+const require_helpers = require('../utils/helpers.cjs');
 
 //#region src/steps/utils.ts
 /**
@@ -32,14 +33,16 @@ function getStep(resolvedStepValues) {
 		const { step } = options;
 		return {
 			step,
-			data: resolvedStepValues[`step${step}`]
+			data: resolvedStepValues[step]
 		};
 	};
 }
 function createCtxHelper(values, data) {
+	const invariant$1 = require_invariant.createInvariant("[createCtxHelper]");
+	const getTargetStep = getStep(values);
 	return data.reduce((acc, curr) => {
-		const stepNumber = extractNumber(curr);
-		const { data: data$1 } = getStep(values)({ step: stepNumber });
+		const { data: data$1 } = getTargetStep({ step: curr });
+		invariant$1(data$1, `No data was found for ${curr}`, TypeError);
 		for (const [key, value] of Object.entries(data$1)) {
 			if (typeof value === "function" && key !== "update") continue;
 			data$1[key] = value;
@@ -57,40 +60,47 @@ function createCtx(values, stepData) {
 	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)) {
-		require_invariant.invariant(stepData.every((step) => validStepKeys.includes(step)), () => {
-			const comparedResults = require_helpers.comparePartialArray(stepData, validStepKeys.map((key) => extractNumber(key)), formatter);
-			if (comparedResults.status === "error") return `${baseErrorMessage()}. See errors:\n ${require_helpers.printErrors(comparedResults.errors)}`;
-			return baseErrorMessage();
-		});
-		return createCtxHelper(values, stepData);
-	}
-	if (typeof stepData === "object") {
-		const keys = Object.keys(stepData);
-		require_invariant.invariant(keys.every((key) => validStepKeys.includes(key)), () => {
-			const comparedResults = require_helpers.comparePartialArray(keys, validStepKeys, formatter);
-			if (comparedResults.status === "error") return `${baseErrorMessage()}. See errors:\n ${require_helpers.printErrors(comparedResults.errors)}`;
-			return baseErrorMessage();
-		});
-		return createCtxHelper(values, keys);
-	}
-	throw new Error(`${baseErrorMessage()} OR to "all"`);
+	return require_index.HelperFnChosenSteps.match({
+		validValues: () => validStepKeys,
+		all: () => {
+			return createCtxHelper(values, validStepKeys);
+		},
+		tuple: ({ chosenSteps }) => {
+			require_invariant.invariant(chosenSteps.every((step) => validStepKeys.includes(step)), () => {
+				const comparedResults = require_helpers.comparePartialArray(chosenSteps, validStepKeys.map((key) => extractNumber(key)), formatter);
+				if (comparedResults.status === "error") return `${baseErrorMessage()}. See errors:\n ${require_helpers.printErrors(comparedResults.errors)}`;
+				return baseErrorMessage();
+			});
+			return createCtxHelper(values, chosenSteps);
+		},
+		object: ({ chosenSteps }) => {
+			const keys = Object.keys(chosenSteps);
+			require_invariant.invariant(keys.every((key) => validStepKeys.includes(key)), () => {
+				const comparedResults = require_helpers.comparePartialArray(keys, validStepKeys, formatter);
+				if (comparedResults.status === "error") return `${baseErrorMessage()}. See errors:\n ${require_helpers.printErrors(comparedResults.errors)}`;
+				return baseErrorMessage();
+			});
+			return createCtxHelper(values, keys);
+		},
+		default: ({ errorMessage }) => {
+			throw new Error(`[createCtx]: ${errorMessage}`);
+		}
+	})(stepData);
 }
 function functionalUpdate(updater, input) {
 	if (typeof updater === "function") return updater(input);
 	return updater;
 }
+function omit(obj, keys) {
+	const keySet = new Set(keys);
+	const result = {};
+	for (const key in obj) if (!keySet.has(key)) result[key] = obj[key];
+	return result;
+}
 
 //#endregion
 exports.createCtx = createCtx;
 exports.functionalUpdate = functionalUpdate;
 exports.getStep = getStep;
+exports.omit = omit;
 //# sourceMappingURL=utils.cjs.map

package/dist/steps/utils.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"utils.cjs","names":["data","comparePartialArray","printErrors"],"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,6BAAU,MAAM,SAAS,OAAO,EAAE,0CAA0C;CAE5E,MAAM,YAAY,MAAM,QAAQ,QAAQ,GAAG;AAE3C,6BAAU,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,8BACE,SAAS,OAAO,SAAS,cAAc,SAAS,KAAK,CAAC,QAChD;GACJ,MAAM,kBAAkBC,oCACtB,UACA,cAAc,KAAK,QAAQ,cAAc,IAAI,CAAC,EAC9C,UACD;AAED,OAAI,gBAAgB,WAAW,QAC7B,QAAO,GAAG,kBAAkB,CAAC,kBAAkBC,4BAC7C,gBAAgB,OACjB;AAGH,UAAO,kBAAkB;IAE5B;AAED,SAAO,gBACL,QACA,SACD;;AAGH,KAAI,OAAO,aAAa,UAAU;EAChC,MAAM,OAAO,OAAO,KAAK,SAAS;AAElC,8BACE,KAAK,OAAO,QAAQ,cAAc,SAAS,IAAI,CAAC,QAC1C;GACJ,MAAM,kBAAkBD,oCACtB,MACA,eACA,UACD;AAED,OAAI,gBAAgB,WAAW,QAC7B,QAAO,GAAG,kBAAkB,CAAC,kBAAkBC,4BAC7C,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"}
+{"version":3,"file":"utils.cjs","names":["invariant: Invariant","createInvariant","data","HelperFnChosenSteps","comparePartialArray","printErrors"],"sources":["../../src/steps/utils.ts"],"sourcesContent":["import { comparePartialArray, printErrors } from '@/utils/helpers';\nimport { createInvariant, invariant, type Invariant } from '@/utils/invariant';\nimport { HelperFn, HelperFnChosenSteps } from './fn-utils/helper-fn';\nimport type { steps } from './steps';\nimport type { Updater } from '@/utils/types';\n\nexport type GetStepOptions<\n  value extends steps.instantiateSteps,\n  stepNumbers extends steps.StepNumbers<value>,\n  targetStep extends stepNumbers\n> = { step: targetStep };\nexport type ValidStepKey<N extends number = number> = `step${N}`;\nexport type ExtractStepFromKey<T> = T extends string\n  ? T extends ValidStepKey<infer N>\n    ? N\n    : never\n  : never;\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  value extends steps.instantiateSteps,\n  stepNumbers extends steps.StepNumbers<value>\n>(resolvedStepValues: value) {\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 <targetStep extends stepNumbers>(\n    options: GetStepOptions<value, stepNumbers, targetStep>\n  ) {\n    const { step } = options;\n\n    const data = resolvedStepValues[step] as steps.getCurrent<\n      value,\n      targetStep\n    >;\n\n    return { step, data };\n  };\n}\n\nfunction createCtxHelper<\n  value extends steps.instantiateSteps,\n  stepNumbers extends steps.StepNumbers<value>,\n  chosenSteps extends HelperFnChosenSteps.main<value, stepNumbers>\n>(values: value, data: string[]) {\n  const invariant: Invariant = createInvariant('[createCtxHelper]');\n  const getTargetStep = getStep(values);\n\n  return data.reduce((acc, curr) => {\n    const { data } = getTargetStep({\n      step: curr as stepNumbers,\n    });\n\n    invariant(data, `No data was found for ${curr}`, TypeError);\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 HelperFn.buildCtx<value, chosenSteps>);\n}\n\nexport function createCtx<\n  value extends steps.instantiateSteps,\n  stepNumbers extends steps.StepNumbers<value>,\n  chosenSteps extends HelperFnChosenSteps.main<value, stepNumbers>\n>(values: value, stepData: chosenSteps) {\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  const match = HelperFnChosenSteps.match({\n    validValues: () => validStepKeys,\n    all: () => {\n      return createCtxHelper(values, validStepKeys);\n    },\n    tuple: ({ chosenSteps }) => {\n      invariant(\n        chosenSteps.every((step) => validStepKeys.includes(step)),\n        () => {\n          const comparedResults = comparePartialArray(\n            chosenSteps,\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(values, chosenSteps);\n    },\n    object: ({ chosenSteps }) => {\n      const keys = Object.keys(chosenSteps);\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(values, keys);\n    },\n    default: ({ errorMessage }) => {\n      throw new Error(`[createCtx]: ${errorMessage}`);\n    },\n  });\n\n  return match<value, chosenSteps>(stepData);\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\nexport function omit<T extends object, K extends (keyof T)[]>(\n  obj: T,\n  keys: K\n): Omit<T, K[number]> {\n  const keySet = new Set<keyof T>(keys);\n\n  const result = {} as Omit<T, K[number]>;\n\n  for (const key in obj) {\n    if (!keySet.has(key)) {\n      result[key as unknown as Exclude<keyof T, K[number]>] = obj[key] as never;\n    }\n  }\n\n  return result;\n}\n"],"mappings":";;;;;;;;;;AAuBA,SAAgB,cAAc,OAAe;AAC3C,6BAAU,MAAM,SAAS,OAAO,EAAE,0CAA0C;CAE5E,MAAM,YAAY,MAAM,QAAQ,QAAQ,GAAG;AAE3C,6BAAU,QAAQ,KAAK,UAAU,EAAE,yBAAyB,MAAM,GAAG;AAErE,QAAO,OAAO,SAAS,WAAW,GAAG;;;;;;;AAQvC,SAAgB,QAGd,oBAA2B;;;;;;;;;;AAU3B,QAAO,SACL,SACA;EACA,MAAM,EAAE,SAAS;AAOjB,SAAO;GAAE;GAAM,MALF,mBAAmB;GAKX;;;AAIzB,SAAS,gBAIP,QAAe,MAAgB;CAC/B,MAAMA,cAAuBC,kCAAgB,oBAAoB;CACjE,MAAM,gBAAgB,QAAQ,OAAO;AAErC,QAAO,KAAK,QAAQ,KAAK,SAAS;EAChC,MAAM,EAAE,iBAAS,cAAc,EAC7B,MAAM,MACP,CAAC;AAEF,cAAUC,QAAM,yBAAyB,QAAQ,UAAU;AAE3D,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,CAA0C;;AAGjD,SAAgB,UAId,QAAe,UAAuB;CACtC,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;;AA0DJ,QAxDcC,kCAAoB,MAAM;EACtC,mBAAmB;EACnB,WAAW;AACT,UAAO,gBAAgB,QAAQ,cAAc;;EAE/C,QAAQ,EAAE,kBAAkB;AAC1B,+BACE,YAAY,OAAO,SAAS,cAAc,SAAS,KAAK,CAAC,QACnD;IACJ,MAAM,kBAAkBC,oCACtB,aACA,cAAc,KAAK,QAAQ,cAAc,IAAI,CAAC,EAC9C,UACD;AAED,QAAI,gBAAgB,WAAW,QAC7B,QAAO,GAAG,kBAAkB,CAAC,kBAAkBC,4BAC7C,gBAAgB,OACjB;AAGH,WAAO,kBAAkB;KAE5B;AAED,UAAO,gBAAgB,QAAQ,YAAY;;EAE7C,SAAS,EAAE,kBAAkB;GAC3B,MAAM,OAAO,OAAO,KAAK,YAAY;AAErC,+BACE,KAAK,OAAO,QAAQ,cAAc,SAAS,IAAI,CAAC,QAC1C;IACJ,MAAM,kBAAkBD,oCACtB,MACA,eACA,UACD;AAED,QAAI,gBAAgB,WAAW,QAC7B,QAAO,GAAG,kBAAkB,CAAC,kBAAkBC,4BAC7C,gBAAgB,OACjB;AAGH,WAAO,kBAAkB;KAE5B;AAED,UAAO,gBAAgB,QAAQ,KAAK;;EAEtC,UAAU,EAAE,mBAAmB;AAC7B,SAAM,IAAI,MAAM,gBAAgB,eAAe;;EAElD,CAAC,CAE+B,SAAS;;AAG5C,SAAgB,iBACd,SACA,OACA;AACA,KAAI,OAAO,YAAY,WACrB,QAAQ,QAAmC,MAAM;AAGnD,QAAO;;AAGT,SAAgB,KACd,KACA,MACoB;CACpB,MAAM,SAAS,IAAI,IAAa,KAAK;CAErC,MAAM,SAAS,EAAE;AAEjB,MAAK,MAAM,OAAO,IAChB,KAAI,CAAC,OAAO,IAAI,IAAI,CAClB,QAAO,OAAiD,IAAI;AAIhE,QAAO"}

package/dist/steps/utils.d.cts

@@ -1,10 +1,13 @@
-import { AnyResolvedStep, HelperFnChosenSteps, HelperFnCtx, StepNumbers } from "./types.cjs";
+import { steps } from "./steps.cjs";
+import { HelperFn, HelperFnChosenSteps } from "./fn-utils/helper-fn/index.cjs";
 
 //#region src/steps/utils.d.ts
-type GetStepOptions<TResolvedStep extends AnyResolvedStep, TStepNumbers extends StepNumbers<TResolvedStep>, TStepNumber extends TStepNumbers> = {
-  step: TStepNumber;
+type GetStepOptions<value extends steps.instantiateSteps, stepNumbers extends steps.StepNumbers<value>, targetStep extends stepNumbers> = {
+  step: targetStep;
 };
-declare function createCtx<TResolvedStep extends AnyResolvedStep, TStepNumbers extends StepNumbers<TResolvedStep>, TChosenSteps extends HelperFnChosenSteps<TResolvedStep, TStepNumbers>>(values: TResolvedStep, stepData: TChosenSteps): HelperFnCtx<TResolvedStep, TStepNumbers, TChosenSteps, never>;
+type ValidStepKey<N extends number = number> = `step${N}`;
+type ExtractStepFromKey<T> = T extends string ? T extends ValidStepKey<infer N> ? N : never : never;
+declare function createCtx<value extends steps.instantiateSteps, stepNumbers extends steps.StepNumbers<value>, chosenSteps extends HelperFnChosenSteps.main<value, stepNumbers>>(values: value, stepData: chosenSteps): HelperFn.buildCtx<value, HelperFnChosenSteps.main<value, steps.StepNumbers<value>>, never>;
 //#endregion
-export { GetStepOptions, createCtx };
+export { ExtractStepFromKey, GetStepOptions, createCtx };
 //# sourceMappingURL=utils.d.cts.map

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

@@ -1 +1 @@
-{"version":3,"file":"utils.d.cts","names":[],"sources":["../../src/steps/utils.ts"],"sourcesContent":[],"mappings":";;;KAWY,qCACY,sCACD,YAAY,oCACb;QACV;AAJZ,CAAA;AAqF+C,iBAJ/B,SAI+B,CAAA,sBAHvB,eAGuB,EAAA,qBAFxB,WAEwB,CAFZ,aAEY,CAAA,EAAA,qBADxB,mBACwB,CADJ,aACI,EADW,YACX,CAAA,CAAA,CAAA,MAAA,EAArC,aAAqC,EAAA,QAAA,EAAZ,YAAY,CAAA,EAAA,WAAA,CAAA,aAAA,EAAA,YAAA,EAAA,YAAA,EAAA,KAAA,CAAA"}
+{"version":3,"file":"utils.d.cts","names":[],"sources":["../../src/steps/utils.ts"],"sourcesContent":[],"mappings":";;;;KAMY,6BACI,KAAA,CAAM,sCACA,KAAA,CAAM,YAAY,2BACnB;EAHT,IAAA,EAIA,UAJA;CACI;AACwB,KAG5B,YAH4B,CAAA,UAAA,MAAA,GAAA,MAAA,CAAA,GAAA,OAGqB,CAHrB,EAAA;AAAZ,KAIhB,kBAJgB,CAAA,CAAA,CAAA,GAIQ,CAJR,SAAA,MAAA,GAKxB,CALwB,SAKd,YALc,CAAA,KAAA,EAAA,CAAA,GAAA,CAAA,GAAA,KAAA,GAAA,KAAA;AA2FN,iBAHN,SAG0B,CAAA,cAF1B,KAAA,CAAM,gBAEoB,EAAA,oBADpB,KAAA,CAAM,WACc,CADF,KACE,CAAA,EAAA,oBAApB,mBAAA,CAAoB,IAAA,CAAK,KAAL,EAAY,WAAZ,CAAA,CAAA,CAAA,MAAA,EAChC,KADgC,EAAA,QAAA,EACf,WADe,CAAA,EACJ,QAAA,CAAA,QADI,CACJ,KADI,EACJ,mBAAA,CAAA,IADI,CACJ,KADI,EACJ,KAAA,CAAA,WADI,CACJ,KADI,CAAA,CAAA,EAAA,KAAA,CAAA"}

package/dist/steps/utils.d.mts

@@ -1,10 +1,13 @@
-import { AnyResolvedStep, HelperFnChosenSteps, HelperFnCtx, StepNumbers } from "./types.mjs";
+import { steps } from "./steps.mjs";
+import { HelperFn, HelperFnChosenSteps } from "./fn-utils/helper-fn/index.mjs";
 
 //#region src/steps/utils.d.ts
-type GetStepOptions<TResolvedStep extends AnyResolvedStep, TStepNumbers extends StepNumbers<TResolvedStep>, TStepNumber extends TStepNumbers> = {
-  step: TStepNumber;
+type GetStepOptions<value extends steps.instantiateSteps, stepNumbers extends steps.StepNumbers<value>, targetStep extends stepNumbers> = {
+  step: targetStep;
 };
-declare function createCtx<TResolvedStep extends AnyResolvedStep, TStepNumbers extends StepNumbers<TResolvedStep>, TChosenSteps extends HelperFnChosenSteps<TResolvedStep, TStepNumbers>>(values: TResolvedStep, stepData: TChosenSteps): HelperFnCtx<TResolvedStep, TStepNumbers, TChosenSteps, never>;
+type ValidStepKey<N extends number = number> = `step${N}`;
+type ExtractStepFromKey<T> = T extends string ? T extends ValidStepKey<infer N> ? N : never : never;
+declare function createCtx<value extends steps.instantiateSteps, stepNumbers extends steps.StepNumbers<value>, chosenSteps extends HelperFnChosenSteps.main<value, stepNumbers>>(values: value, stepData: chosenSteps): HelperFn.buildCtx<value, HelperFnChosenSteps.main<value, steps.StepNumbers<value>>, never>;
 //#endregion
-export { GetStepOptions, createCtx };
+export { ExtractStepFromKey, GetStepOptions, createCtx };
 //# sourceMappingURL=utils.d.mts.map

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

@@ -1 +1 @@
-{"version":3,"file":"utils.d.mts","names":[],"sources":["../../src/steps/utils.ts"],"sourcesContent":[],"mappings":";;;KAWY,qCACY,sCACD,YAAY,oCACb;QACV;AAJZ,CAAA;AAqF+C,iBAJ/B,SAI+B,CAAA,sBAHvB,eAGuB,EAAA,qBAFxB,WAEwB,CAFZ,aAEY,CAAA,EAAA,qBADxB,mBACwB,CADJ,aACI,EADW,YACX,CAAA,CAAA,CAAA,MAAA,EAArC,aAAqC,EAAA,QAAA,EAAZ,YAAY,CAAA,EAAA,WAAA,CAAA,aAAA,EAAA,YAAA,EAAA,YAAA,EAAA,KAAA,CAAA"}
+{"version":3,"file":"utils.d.mts","names":[],"sources":["../../src/steps/utils.ts"],"sourcesContent":[],"mappings":";;;;KAMY,6BACI,KAAA,CAAM,sCACA,KAAA,CAAM,YAAY,2BACnB;EAHT,IAAA,EAIA,UAJA;CACI;AACwB,KAG5B,YAH4B,CAAA,UAAA,MAAA,GAAA,MAAA,CAAA,GAAA,OAGqB,CAHrB,EAAA;AAAZ,KAIhB,kBAJgB,CAAA,CAAA,CAAA,GAIQ,CAJR,SAAA,MAAA,GAKxB,CALwB,SAKd,YALc,CAAA,KAAA,EAAA,CAAA,GAAA,CAAA,GAAA,KAAA,GAAA,KAAA;AA2FN,iBAHN,SAG0B,CAAA,cAF1B,KAAA,CAAM,gBAEoB,EAAA,oBADpB,KAAA,CAAM,WACc,CADF,KACE,CAAA,EAAA,oBAApB,mBAAA,CAAoB,IAAA,CAAK,KAAL,EAAY,WAAZ,CAAA,CAAA,CAAA,MAAA,EAChC,KADgC,EAAA,QAAA,EACf,WADe,CAAA,EACJ,QAAA,CAAA,QADI,CACJ,KADI,EACJ,mBAAA,CAAA,IADI,CACJ,KADI,EACJ,KAAA,CAAA,WADI,CACJ,KADI,CAAA,CAAA,EAAA,KAAA,CAAA"}

package/dist/steps/utils.mjs

@@ -1,5 +1,6 @@
+import { HelperFnChosenSteps } from "./fn-utils/helper-fn/index.mjs";
+import { createInvariant, invariant } from "../utils/invariant.mjs";
 import { comparePartialArray, printErrors } from "../utils/helpers.mjs";
-import { invariant } from "../utils/invariant.mjs";
 
 //#region src/steps/utils.ts
 /**
@@ -32,14 +33,16 @@ function getStep(resolvedStepValues) {
 		const { step } = options;
 		return {
 			step,
-			data: resolvedStepValues[`step${step}`]
+			data: resolvedStepValues[step]
 		};
 	};
 }
 function createCtxHelper(values, data) {
+	const invariant$1 = createInvariant("[createCtxHelper]");
+	const getTargetStep = getStep(values);
 	return data.reduce((acc, curr) => {
-		const stepNumber = extractNumber(curr);
-		const { data: data$1 } = getStep(values)({ step: stepNumber });
+		const { data: data$1 } = getTargetStep({ step: curr });
+		invariant$1(data$1, `No data was found for ${curr}`, TypeError);
 		for (const [key, value] of Object.entries(data$1)) {
 			if (typeof value === "function" && key !== "update") continue;
 			data$1[key] = value;
@@ -57,38 +60,44 @@ function createCtx(values, stepData) {
 	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"`);
+	return HelperFnChosenSteps.match({
+		validValues: () => validStepKeys,
+		all: () => {
+			return createCtxHelper(values, validStepKeys);
+		},
+		tuple: ({ chosenSteps }) => {
+			invariant(chosenSteps.every((step) => validStepKeys.includes(step)), () => {
+				const comparedResults = comparePartialArray(chosenSteps, validStepKeys.map((key) => extractNumber(key)), formatter);
+				if (comparedResults.status === "error") return `${baseErrorMessage()}. See errors:\n ${printErrors(comparedResults.errors)}`;
+				return baseErrorMessage();
+			});
+			return createCtxHelper(values, chosenSteps);
+		},
+		object: ({ chosenSteps }) => {
+			const keys = Object.keys(chosenSteps);
+			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);
+		},
+		default: ({ errorMessage }) => {
+			throw new Error(`[createCtx]: ${errorMessage}`);
+		}
+	})(stepData);
 }
 function functionalUpdate(updater, input) {
 	if (typeof updater === "function") return updater(input);
 	return updater;
 }
+function omit(obj, keys) {
+	const keySet = new Set(keys);
+	const result = {};
+	for (const key in obj) if (!keySet.has(key)) result[key] = obj[key];
+	return result;
+}
 
 //#endregion
-export { createCtx, functionalUpdate, getStep };
+export { createCtx, functionalUpdate, getStep, omit };
 //# sourceMappingURL=utils.mjs.map

package/dist/steps/utils.mjs.map

@@ -1 +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"}
+{"version":3,"file":"utils.mjs","names":["invariant: Invariant","data"],"sources":["../../src/steps/utils.ts"],"sourcesContent":["import { comparePartialArray, printErrors } from '@/utils/helpers';\nimport { createInvariant, invariant, type Invariant } from '@/utils/invariant';\nimport { HelperFn, HelperFnChosenSteps } from './fn-utils/helper-fn';\nimport type { steps } from './steps';\nimport type { Updater } from '@/utils/types';\n\nexport type GetStepOptions<\n  value extends steps.instantiateSteps,\n  stepNumbers extends steps.StepNumbers<value>,\n  targetStep extends stepNumbers\n> = { step: targetStep };\nexport type ValidStepKey<N extends number = number> = `step${N}`;\nexport type ExtractStepFromKey<T> = T extends string\n  ? T extends ValidStepKey<infer N>\n    ? N\n    : never\n  : never;\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  value extends steps.instantiateSteps,\n  stepNumbers extends steps.StepNumbers<value>\n>(resolvedStepValues: value) {\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 <targetStep extends stepNumbers>(\n    options: GetStepOptions<value, stepNumbers, targetStep>\n  ) {\n    const { step } = options;\n\n    const data = resolvedStepValues[step] as steps.getCurrent<\n      value,\n      targetStep\n    >;\n\n    return { step, data };\n  };\n}\n\nfunction createCtxHelper<\n  value extends steps.instantiateSteps,\n  stepNumbers extends steps.StepNumbers<value>,\n  chosenSteps extends HelperFnChosenSteps.main<value, stepNumbers>\n>(values: value, data: string[]) {\n  const invariant: Invariant = createInvariant('[createCtxHelper]');\n  const getTargetStep = getStep(values);\n\n  return data.reduce((acc, curr) => {\n    const { data } = getTargetStep({\n      step: curr as stepNumbers,\n    });\n\n    invariant(data, `No data was found for ${curr}`, TypeError);\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 HelperFn.buildCtx<value, chosenSteps>);\n}\n\nexport function createCtx<\n  value extends steps.instantiateSteps,\n  stepNumbers extends steps.StepNumbers<value>,\n  chosenSteps extends HelperFnChosenSteps.main<value, stepNumbers>\n>(values: value, stepData: chosenSteps) {\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  const match = HelperFnChosenSteps.match({\n    validValues: () => validStepKeys,\n    all: () => {\n      return createCtxHelper(values, validStepKeys);\n    },\n    tuple: ({ chosenSteps }) => {\n      invariant(\n        chosenSteps.every((step) => validStepKeys.includes(step)),\n        () => {\n          const comparedResults = comparePartialArray(\n            chosenSteps,\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(values, chosenSteps);\n    },\n    object: ({ chosenSteps }) => {\n      const keys = Object.keys(chosenSteps);\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(values, keys);\n    },\n    default: ({ errorMessage }) => {\n      throw new Error(`[createCtx]: ${errorMessage}`);\n    },\n  });\n\n  return match<value, chosenSteps>(stepData);\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\nexport function omit<T extends object, K extends (keyof T)[]>(\n  obj: T,\n  keys: K\n): Omit<T, K[number]> {\n  const keySet = new Set<keyof T>(keys);\n\n  const result = {} as Omit<T, K[number]>;\n\n  for (const key in obj) {\n    if (!keySet.has(key)) {\n      result[key as unknown as Exclude<keyof T, K[number]>] = obj[key] as never;\n    }\n  }\n\n  return result;\n}\n"],"mappings":";;;;;;;;;;AAuBA,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,oBAA2B;;;;;;;;;;AAU3B,QAAO,SACL,SACA;EACA,MAAM,EAAE,SAAS;AAOjB,SAAO;GAAE;GAAM,MALF,mBAAmB;GAKX;;;AAIzB,SAAS,gBAIP,QAAe,MAAgB;CAC/B,MAAMA,cAAuB,gBAAgB,oBAAoB;CACjE,MAAM,gBAAgB,QAAQ,OAAO;AAErC,QAAO,KAAK,QAAQ,KAAK,SAAS;EAChC,MAAM,EAAE,iBAAS,cAAc,EAC7B,MAAM,MACP,CAAC;AAEF,cAAUC,QAAM,yBAAyB,QAAQ,UAAU;AAE3D,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,CAA0C;;AAGjD,SAAgB,UAId,QAAe,UAAuB;CACtC,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;;AA0DJ,QAxDc,oBAAoB,MAAM;EACtC,mBAAmB;EACnB,WAAW;AACT,UAAO,gBAAgB,QAAQ,cAAc;;EAE/C,QAAQ,EAAE,kBAAkB;AAC1B,aACE,YAAY,OAAO,SAAS,cAAc,SAAS,KAAK,CAAC,QACnD;IACJ,MAAM,kBAAkB,oBACtB,aACA,cAAc,KAAK,QAAQ,cAAc,IAAI,CAAC,EAC9C,UACD;AAED,QAAI,gBAAgB,WAAW,QAC7B,QAAO,GAAG,kBAAkB,CAAC,kBAAkB,YAC7C,gBAAgB,OACjB;AAGH,WAAO,kBAAkB;KAE5B;AAED,UAAO,gBAAgB,QAAQ,YAAY;;EAE7C,SAAS,EAAE,kBAAkB;GAC3B,MAAM,OAAO,OAAO,KAAK,YAAY;AAErC,aACE,KAAK,OAAO,QAAQ,cAAc,SAAS,IAAI,CAAC,QAC1C;IACJ,MAAM,kBAAkB,oBACtB,MACA,eACA,UACD;AAED,QAAI,gBAAgB,WAAW,QAC7B,QAAO,GAAG,kBAAkB,CAAC,kBAAkB,YAC7C,gBAAgB,OACjB;AAGH,WAAO,kBAAkB;KAE5B;AAED,UAAO,gBAAgB,QAAQ,KAAK;;EAEtC,UAAU,EAAE,mBAAmB;AAC7B,SAAM,IAAI,MAAM,gBAAgB,eAAe;;EAElD,CAAC,CAE+B,SAAS;;AAG5C,SAAgB,iBACd,SACA,OACA;AACA,KAAI,OAAO,YAAY,WACrB,QAAQ,QAAmC,MAAM;AAGnD,QAAO;;AAGT,SAAgB,KACd,KACA,MACoB;CACpB,MAAM,SAAS,IAAI,IAAa,KAAK;CAErC,MAAM,SAAS,EAAE;AAEjB,MAAK,MAAM,OAAO,IAChB,KAAI,CAAC,OAAO,IAAI,IAAI,CAClB,QAAO,OAAiD,IAAI;AAIhE,QAAO"}

package/dist/storage.cjs

@@ -1,5 +1,5 @@
-const require_invariant = require('./utils/invariant.cjs');
 const require_logger = require('./utils/logger.cjs');
+const require_invariant = require('./utils/invariant.cjs');
 
 //#region src/storage.ts
 const WINDOW_UNDEFINED_MESSAGE = "\"window\" in undefined. No storage is available";

package/dist/storage.cjs.map

@@ -1 +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\n/**\n * Converts Date strings back to Date objects for fields with type: 'date'.\n */\nfunction convertDateStringsToDates(parsed: unknown): unknown {\n  if (!parsed || typeof parsed !== 'object') {\n    return parsed;\n  }\n\n  const converted = Array.isArray(parsed) ? [...parsed] : { ...parsed };\n\n  // Iterate through each step\n  for (const [stepKey, stepValue] of Object.entries(converted)) {\n    if (\n      !stepValue ||\n      typeof stepValue !== 'object' ||\n      !('fields' in stepValue) ||\n      typeof stepValue.fields !== 'object'\n    ) {\n      continue;\n    }\n\n    const fields = { ...(stepValue.fields as Record<string, unknown>) };\n    let hasChanges = false;\n\n    // Iterate through each field\n    for (const [fieldName, fieldValue] of Object.entries(fields)) {\n      if (\n        !fieldValue ||\n        typeof fieldValue !== 'object' ||\n        !('type' in fieldValue) ||\n        !('defaultValue' in fieldValue)\n      ) {\n        continue;\n      }\n\n      // Check if field has type: 'date' and defaultValue is a string\n      if (\n        fieldValue.type === 'date' &&\n        typeof fieldValue.defaultValue === 'string'\n      ) {\n        // Convert string to Date\n        const dateValue = new Date(fieldValue.defaultValue);\n\n        // Only convert if it's a valid date\n        if (!Number.isNaN(dateValue.getTime())) {\n          fields[fieldName] = {\n            ...fieldValue,\n            defaultValue: dateValue,\n          };\n          hasChanges = true;\n        }\n      }\n    }\n\n    // Update the step with converted fields if there were changes\n    if (hasChanges) {\n      (converted as Record<string, unknown>)[stepKey] = {\n        ...stepValue,\n        fields,\n      };\n    }\n  }\n\n  return converted;\n}\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 === 'function') {\n      return (value as (input: data) => data)(this.data);\n    }\n\n    return value;\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      const converted = convertDateStringsToDates(parsed);\n\n      return converted 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;;;;AAKnC,SAAS,0BAA0B,QAA0B;AAC3D,KAAI,CAAC,UAAU,OAAO,WAAW,SAC/B,QAAO;CAGT,MAAM,YAAY,MAAM,QAAQ,OAAO,GAAG,CAAC,GAAG,OAAO,GAAG,EAAE,GAAG,QAAQ;AAGrE,MAAK,MAAM,CAAC,SAAS,cAAc,OAAO,QAAQ,UAAU,EAAE;AAC5D,MACE,CAAC,aACD,OAAO,cAAc,YACrB,EAAE,YAAY,cACd,OAAO,UAAU,WAAW,SAE5B;EAGF,MAAM,SAAS,EAAE,GAAI,UAAU,QAAoC;EACnE,IAAI,aAAa;AAGjB,OAAK,MAAM,CAAC,WAAW,eAAe,OAAO,QAAQ,OAAO,EAAE;AAC5D,OACE,CAAC,cACD,OAAO,eAAe,YACtB,EAAE,UAAU,eACZ,EAAE,kBAAkB,YAEpB;AAIF,OACE,WAAW,SAAS,UACpB,OAAO,WAAW,iBAAiB,UACnC;IAEA,MAAM,YAAY,IAAI,KAAK,WAAW,aAAa;AAGnD,QAAI,CAAC,OAAO,MAAM,UAAU,SAAS,CAAC,EAAE;AACtC,YAAO,aAAa;MAClB,GAAG;MACH,cAAc;MACf;AACD,kBAAa;;;;AAMnB,MAAI,WACF,CAAC,UAAsC,WAAW;GAChD,GAAG;GACH;GACD;;AAIL,QAAO;;AAGT,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,YAEpB,MAAK,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,WACnB,QAAQ,MAAgC,KAAK,KAAK;AAGpD,SAAO;;CAGT,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,KAIF,QAFkB,0BADH,KAAK,MAAM,KAAK,CACoB;;CAMvD,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"}
+{"version":3,"file":"storage.cjs","names":["MultiStepFormLogger"],"sources":["../src/storage.ts"],"sourcesContent":["import type { Updater } from '@/utils/types';\nimport { invariant } from '@/utils/invariant';\nimport { MultiStepFormLogger } from '@/utils/logger';\n\nexport type DefaultStorageKey = typeof DEFAULT_STORAGE_KEY;\nexport interface BaseStorageConfig<TKey extends string> {\n  key: TKey;\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}\nexport type StorageConfig<\nTData,\nTKey extends string\n> = BaseStorageConfig<TKey> & {\n  data: TData;\n};\n\nconst WINDOW_UNDEFINED_MESSAGE =\n'\"window\" in undefined. No storage is available';\nexport const DEFAULT_STORAGE_KEY = 'MultiStepForm';\n\n/**\n* Converts Date strings back to Date objects for fields with type: 'date'.\n*/\nfunction convertDateStringsToDates(parsed: unknown): unknown {\n  if (!parsed || typeof parsed !== 'object') {\n    return parsed;\n  }\n\n  const converted = Array.isArray(parsed) ? [...parsed] : { ...parsed };\n\n  // Iterate through each step\n  for (const [stepKey, stepValue] of Object.entries(converted)) {\n    if (\n      !stepValue ||\n      typeof stepValue !== 'object' ||\n      !('fields' in stepValue) ||\n      typeof stepValue.fields !== 'object'\n    ) {\n      continue;\n    }\n\n    const fields = { ...(stepValue.fields as Record<string, unknown>) };\n    let hasChanges = false;\n\n    // Iterate through each field\n    for (const [fieldName, fieldValue] of Object.entries(fields)) {\n      if (\n        !fieldValue ||\n        typeof fieldValue !== 'object' ||\n        !('type' in fieldValue) ||\n        !('defaultValue' in fieldValue)\n      ) {\n        continue;\n      }\n\n      // Check if field has type: 'date' and defaultValue is a string\n      if (\n        fieldValue.type === 'date' &&\n        typeof fieldValue.defaultValue === 'string'\n      ) {\n        // Convert string to Date\n        const dateValue = new Date(fieldValue.defaultValue);\n\n        // Only convert if it's a valid date\n        if (!Number.isNaN(dateValue.getTime())) {\n          fields[fieldName] = {\n            ...fieldValue,\n            defaultValue: dateValue,\n          };\n          hasChanges = true;\n        }\n      }\n    }\n\n    // Update the step with converted fields if there were changes\n    if (hasChanges) {\n      (converted as Record<string, unknown>)[stepKey] = {\n        ...stepValue,\n        fields,\n      };\n    }\n  }\n\n  return converted;\n}\n\nexport class MultiStepFormStorage<\ndata,\nkey 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 === 'function') {\n      return (value as (input: data) => data)(this.data);\n    }\n\n    return value;\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      const converted = convertDateStringsToDates(parsed);\n\n      return converted 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":";;;;AAqBA,MAAM,2BACN;AACA,MAAa,sBAAsB;;;;AAKnC,SAAS,0BAA0B,QAA0B;AAC3D,KAAI,CAAC,UAAU,OAAO,WAAW,SAC/B,QAAO;CAGT,MAAM,YAAY,MAAM,QAAQ,OAAO,GAAG,CAAC,GAAG,OAAO,GAAG,EAAE,GAAG,QAAQ;AAGrE,MAAK,MAAM,CAAC,SAAS,cAAc,OAAO,QAAQ,UAAU,EAAE;AAC5D,MACE,CAAC,aACD,OAAO,cAAc,YACrB,EAAE,YAAY,cACd,OAAO,UAAU,WAAW,SAE5B;EAGF,MAAM,SAAS,EAAE,GAAI,UAAU,QAAoC;EACnE,IAAI,aAAa;AAGjB,OAAK,MAAM,CAAC,WAAW,eAAe,OAAO,QAAQ,OAAO,EAAE;AAC5D,OACE,CAAC,cACD,OAAO,eAAe,YACtB,EAAE,UAAU,eACZ,EAAE,kBAAkB,YAEpB;AAIF,OACE,WAAW,SAAS,UACpB,OAAO,WAAW,iBAAiB,UACnC;IAEA,MAAM,YAAY,IAAI,KAAK,WAAW,aAAa;AAGnD,QAAI,CAAC,OAAO,MAAM,UAAU,SAAS,CAAC,EAAE;AACtC,YAAO,aAAa;MAClB,GAAG;MACH,cAAc;MACf;AACD,kBAAa;;;;AAMnB,MAAI,WACF,CAAC,UAAsC,WAAW;GAChD,GAAG;GACH;GACD;;AAIL,QAAO;;AAGT,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,YAEpB,MAAK,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,WACnB,QAAQ,MAAgC,KAAK,KAAK;AAGpD,SAAO;;CAGT,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,KAIF,QAFkB,0BADH,KAAK,MAAM,KAAK,CACoB;;CAMvD,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

@@ -1,16 +1,18 @@
-import { Updater } from "./steps/types.cjs";
+import { Updater } from "./utils/types.cjs";
 
 //#region src/storage.d.ts
 type DefaultStorageKey = typeof DEFAULT_STORAGE_KEY;
-type StorageConfig<TData, TKey extends string> = {
+interface BaseStorageConfig<TKey extends string> {
   key: TKey;
-  data: TData;
   store?: Storage;
   /**
-   * An extra option to throw an error when {@linkcode window} is `undefined`
-   * @default false
-   */
+  * An extra option to throw an error when {@linkcode window} is `undefined`
+  * @default false
+  */
   throwWhenUndefined?: boolean;
+}
+type StorageConfig<TData, TKey extends string> = BaseStorageConfig<TKey> & {
+  data: TData;
 };
 declare const DEFAULT_STORAGE_KEY = "MultiStepForm";
 declare class MultiStepFormStorage<data, key extends string = DefaultStorageKey> {
@@ -29,5 +31,5 @@ declare class MultiStepFormStorage<data, key extends string = DefaultStorageKey>
   add(value: Updater<data>): void;
 }
 //#endregion
-export { DEFAULT_STORAGE_KEY, DefaultStorageKey, MultiStepFormStorage, StorageConfig };
+export { BaseStorageConfig, DEFAULT_STORAGE_KEY, DefaultStorageKey, MultiStepFormStorage, StorageConfig };
 //# sourceMappingURL=storage.d.cts.map

package/dist/storage.d.cts.map

@@ -1 +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;EAoEa,kBAAA,CAAA,EAAA,OAAoB;CAEV;AAEP,cAxEH,mBAAA,GAwEG,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;EAqDjB,iBAAA,gBAAA;EA2BgB,iBAAA,kBAAA;EAAR,WAAA,CAAA,MAAA,EAhFS,aAgFT,CAhFuB,IAgFvB,EAhF6B,GAgF7B,CAAA;EAAO,QAAA,iBAAA;;;SA3Bf;;aA2BQ,QAAQ"}
+{"version":3,"file":"storage.d.cts","names":[],"sources":["../src/storage.ts"],"sourcesContent":[],"mappings":";;;KAIY,iBAAA,UAA2B;UACtB;EADL,GAAA,EAEL,IAFK;EACK,KAAA,CAAA,EAEP,OAFO;EASL;;;;EAIC,kBAAA,CAAA,EAAA,OAAA;AAKb;AAoEa,KA7ED,aA6EC,CAAA,KAAoB,EAAA,aAAA,MAAA,CAAA,GA1E7B,iBA0E6B,CA1EX,IA0EW,CAAA,GAAA;EAEZ,IAAA,EA3Eb,KA2Ea;CAEL;AACG,cAzEN,mBAAA,GAyEM,eAAA;AACF,cANJ,oBAMI,CAAA,IAAA,EAAA,YAAA,MAAA,GAJI,iBAIJ,CAAA,CAAA;EAKmB,SAAA,GAAA,EAPpB,GAOoB;EAAM,SAAA,KAAA,EANvB,OAMuB;EAApB,SAAA,IAAA,EALL,IAKK;EAqDjB,iBAAA,GAAA;EA2BgB,iBAAA,gBAAA;EAAR,iBAAA,kBAAA;EAAO,WAAA,CAAA,MAAA,EAhFE,aAgFF,CAhFgB,IAgFhB,EAhFsB,GAgFtB,CAAA;;;;SA3Bf;;aA2BQ,QAAQ"}

package/dist/storage.d.mts

@@ -1,16 +1,18 @@
-import { Updater } from "./steps/types.mjs";
+import { Updater } from "./utils/types.mjs";
 
 //#region src/storage.d.ts
 type DefaultStorageKey = typeof DEFAULT_STORAGE_KEY;
-type StorageConfig<TData, TKey extends string> = {
+interface BaseStorageConfig<TKey extends string> {
   key: TKey;
-  data: TData;
   store?: Storage;
   /**
-   * An extra option to throw an error when {@linkcode window} is `undefined`
-   * @default false
-   */
+  * An extra option to throw an error when {@linkcode window} is `undefined`
+  * @default false
+  */
   throwWhenUndefined?: boolean;
+}
+type StorageConfig<TData, TKey extends string> = BaseStorageConfig<TKey> & {
+  data: TData;
 };
 declare const DEFAULT_STORAGE_KEY = "MultiStepForm";
 declare class MultiStepFormStorage<data, key extends string = DefaultStorageKey> {
@@ -29,5 +31,5 @@ declare class MultiStepFormStorage<data, key extends string = DefaultStorageKey>
   add(value: Updater<data>): void;
 }
 //#endregion
-export { DEFAULT_STORAGE_KEY, DefaultStorageKey, MultiStepFormStorage, StorageConfig };
+export { BaseStorageConfig, DEFAULT_STORAGE_KEY, DefaultStorageKey, MultiStepFormStorage, StorageConfig };
 //# sourceMappingURL=storage.d.mts.map

package/dist/storage.d.mts.map

@@ -1 +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;EAoEa,kBAAA,CAAA,EAAA,OAAoB;CAEV;AAEP,cAxEH,mBAAA,GAwEG,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;EAqDjB,iBAAA,gBAAA;EA2BgB,iBAAA,kBAAA;EAAR,WAAA,CAAA,MAAA,EAhFS,aAgFT,CAhFuB,IAgFvB,EAhF6B,GAgF7B,CAAA;EAAO,QAAA,iBAAA;;;SA3Bf;;aA2BQ,QAAQ"}
+{"version":3,"file":"storage.d.mts","names":[],"sources":["../src/storage.ts"],"sourcesContent":[],"mappings":";;;KAIY,iBAAA,UAA2B;UACtB;EADL,GAAA,EAEL,IAFK;EACK,KAAA,CAAA,EAEP,OAFO;EASL;;;;EAIC,kBAAA,CAAA,EAAA,OAAA;AAKb;AAoEa,KA7ED,aA6EC,CAAA,KAAoB,EAAA,aAAA,MAAA,CAAA,GA1E7B,iBA0E6B,CA1EX,IA0EW,CAAA,GAAA;EAEZ,IAAA,EA3Eb,KA2Ea;CAEL;AACG,cAzEN,mBAAA,GAyEM,eAAA;AACF,cANJ,oBAMI,CAAA,IAAA,EAAA,YAAA,MAAA,GAJI,iBAIJ,CAAA,CAAA;EAKmB,SAAA,GAAA,EAPpB,GAOoB;EAAM,SAAA,KAAA,EANvB,OAMuB;EAApB,SAAA,IAAA,EALL,IAKK;EAqDjB,iBAAA,GAAA;EA2BgB,iBAAA,gBAAA;EAAR,iBAAA,kBAAA;EAAO,WAAA,CAAA,MAAA,EAhFE,aAgFF,CAhFgB,IAgFhB,EAhFsB,GAgFtB,CAAA;;;;SA3Bf;;aA2BQ,QAAQ"}

package/dist/storage.mjs

@@ -1,5 +1,5 @@
-import { invariant } from "./utils/invariant.mjs";
 import { MultiStepFormLogger } from "./utils/logger.mjs";
+import { invariant } from "./utils/invariant.mjs";
 
 //#region src/storage.ts
 const WINDOW_UNDEFINED_MESSAGE = "\"window\" in undefined. No storage is available";