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

package/dist/steps/fn-utils/update-fn.d.mts

@@ -0,0 +1,121 @@
+import { DeepKeys, DeepPartial, Expand, Relaxed, Updater, objectHelpers, stripFunctions } from "../../utils/types.mjs";
+import { path } from "../../utils/path.mjs";
+import { steps } from "../steps.mjs";
+import { HelperFn, HelperFnChosenSteps } from "./helper-fn/index.mjs";
+
+//#region src/steps/fn-utils/update-fn.d.ts
+declare namespace UpdateFn {
+  export type chosenFields<TCurrentStep extends steps.Any> = HelperFnChosenSteps.defaultStringOption | HelperFnChosenSteps.tupleNotation<DeepKeys<TCurrentStep>> | path.generateObjectConfig<TCurrentStep>;
+  type resolveAllPropertyPath<TCurrentStep extends steps.Any, TField extends chosenFields<TCurrentStep>> = TField extends HelperFnChosenSteps.defaultStringOption ? Relaxed<TCurrentStep> : never;
+  type resolveTuplePropertyPath<TCurrentStep extends steps.Any, TField extends chosenFields<TCurrentStep>, TDeepKeys extends DeepKeys<TCurrentStep> = DeepKeys<TCurrentStep>> = TField extends HelperFnChosenSteps.tupleNotation<TDeepKeys> ? TField[number] extends DeepKeys<Relaxed<TCurrentStep>> ? path.pickBy<Relaxed<TCurrentStep>, TField[number]> : never : never;
+  type resolveObjectPropertyPath<TCurrentStep extends steps.Any, TField extends chosenFields<TCurrentStep>, TDeepKeys extends DeepKeys<TCurrentStep> = DeepKeys<TCurrentStep>> = TField extends path.generateObjectConfig<TField> ? path.objectToPath<TField> extends TDeepKeys ? path.objectToPath<TField> extends DeepKeys<Relaxed<TCurrentStep>> ? path.pickBy<Relaxed<TCurrentStep>, path.objectToPath<TField>> : never : never : never;
+  type resolvePathType<TCurrentStep extends steps.Any, TField extends chosenFields<TCurrentStep>> = TField extends HelperFnChosenSteps.defaultStringOption ? 'all' : TField extends Array<infer _> ? 'tuple' : objectHelpers.isObject<TField> extends true ? 'object' : never;
+  type resolvePathMap<TCurrentStep extends steps.Any, TField extends chosenFields<TCurrentStep>> = {
+    all: resolveAllPropertyPath<TCurrentStep, TField>;
+    tuple: resolveTuplePropertyPath<TCurrentStep, TField>;
+    object: resolveObjectPropertyPath<TCurrentStep, TField>;
+  };
+  export type resolvedStep<value extends steps.instantiateSteps, targetStep extends steps.StepNumbers<value>> = stripFunctions<value[targetStep]>;
+  export type resolvedFieldValue<value extends steps.instantiateSteps, targetStep extends steps.StepNumbers<value>, field extends chosenFields<currentStep>, currentStep extends resolvedStep<value, targetStep> = resolvedStep<value, targetStep>, pathType extends resolvePathType<currentStep, field> = resolvePathType<currentStep, field>> = resolvePathMap<currentStep, field>[pathType];
+  export type mode = {
+    /**
+     * Enables strict mode for the update operation.
+     *
+     * When enabled, you won't be able to add new keys to an object. If
+     * you need to add new keys, set to `false`.
+     * @default true
+     */
+    strict: boolean;
+    /**
+     * Enables partial mode for the update operation.
+     *
+     * When enabled, you will be required to return the whole object. If
+     * you need to return a partial object, set to `false`.
+     * @default false
+     */
+    partial: boolean;
+  };
+  export type additionalUpdaterData = Record<string, unknown> | (() => Record<string, unknown>);
+  export type inferAdditionalUpdaterData<T extends additionalUpdaterData> = T extends (() => infer _) ? _ : T;
+  export type resolvedUpdaterReturnType<T, TMode extends mode, TAdditionalCtx extends additionalUpdaterData> = TMode['strict'] extends true ? TMode['partial'] extends true ? DeepPartial<T> : T : TMode['partial'] extends true ? DeepPartial<T> & TAdditionalCtx : T & TAdditionalCtx;
+  export interface DebugOptions {
+    /**
+     * Enables verbose debug logging for this update operation.
+     * Set to `true` to output helpful information for troubleshooting.
+     */
+    debug?: boolean;
+    /**
+     * Controls whether console errors should be silenced.
+     *
+     * By default, errors will be silenced when `partial: true` OR `strict: false`.
+     *
+     */
+    silentErrors?: boolean;
+  }
+  export interface BaseOptions<value extends steps.instantiateSteps, targetStep extends steps.StepNumbers<value>, fields extends chosenFields<currentStep>, currentStep extends resolvedStep<value, targetStep> = resolvedStep<value, targetStep>> extends DebugOptions {
+    /**
+     * The step to update.
+     */
+    targetStep: targetStep;
+    /**
+     * The specific fields to update.
+     *
+     * Optionally provide a value to narrow the results of the `ctx` in the
+     * updater `fn`.
+     */
+    fields?: fields;
+  }
+  export interface ModeOptions<TMode extends mode> {
+    /**
+     * Enables verbose debug logging for this update operation.
+     * Set to `true` to output helpful information for troubleshooting.
+     */
+    debug?: boolean;
+    /**
+     * Controls whether console errors should be silenced.
+     *
+     * By default, errors will be silenced when `partial: true` OR `strict: false`.
+     *
+     */
+    silentErrors?: boolean;
+    /**
+     * Enables strict mode for the update operation.
+     *
+     * When enabled, you won't be able to add new keys to an object. If
+     * you need to add new keys, set to `false`.
+     * @default true
+     */
+    strict?: TMode['strict'];
+    /**
+     * Enables partial mode for the update operation.
+     *
+     * When enabled, you will be required to return the whole object. If
+     * you need to return a partial object, set to `false`.
+     * @default false
+     */
+    partial?: TMode['partial'];
+  }
+  export interface SharedOptions<value extends steps.instantiateSteps, targetStep extends steps.StepNumbers<value>, fields extends chosenFields<currentStep>, updateMode extends mode, currentStep extends resolvedStep<value, targetStep> = resolvedStep<value, targetStep>> extends BaseOptions<value, targetStep, fields, currentStep>, ModeOptions<updateMode> {}
+  export type options<value extends steps.instantiateSteps, targetStep extends steps.StepNumbers<value>, field extends chosenFields<TCurrentStep>, strict extends boolean, partial extends boolean, additionalCtx extends Record<string, unknown>, updaterData extends additionalUpdaterData, TCurrentStep extends resolvedStep<value, targetStep> = resolvedStep<value, targetStep>, TMode extends mode = {
+    strict: strict;
+    partial: partial;
+  }> = SharedOptions<value, targetStep, field, TMode, TCurrentStep> & HelperFn.CtxDataSelector<value, [targetStep], additionalCtx> & {
+    updater: Updater<Expand<HelperFn.BaseInput<value, [targetStep], never, additionalCtx>>, resolvedUpdaterReturnType<resolvedFieldValue<value, targetStep, field, TCurrentStep>, TMode, updaterData>>;
+  };
+  export type general<value extends steps.instantiateSteps> = <targetStep extends steps.StepNumbers<value>, field extends chosenFields<resolvedStep<value, targetStep>> = 'all', strict extends boolean = true, partial extends boolean = false, additionalCtx extends Record<string, unknown> = {}, additionalUpdaterData extends Record<string, unknown> = {}>(options: options<value, targetStep, field, strict, partial, additionalCtx, additionalUpdaterData>) => void;
+  export type stepSpecific<value extends steps.instantiateSteps, targetStep extends stepNumbers, stepNumbers extends steps.StepNumbers<value> = steps.StepNumbers<value>> = <field extends chosenFields<resolvedStep<value, targetStep>> = 'all', strict extends boolean = true, partial extends boolean = false, additionalCtx extends Record<string, unknown> = {}, additionalUpdaterData extends Record<string, unknown> = {}>(options: Omit<options<value, targetStep, field, strict, partial, additionalCtx, additionalUpdaterData>, 'targetStep'>) => void;
+  export type StepSpecificHelperFn<value extends steps.instantiateSteps, chosenSteps extends HelperFnChosenSteps.main<value, steps.StepNumbers<value>>> = { [key in HelperFnChosenSteps.resolve<value, chosenSteps>]: stepSpecific<value, key> };
+  export type createHelperFnForAllSteps<value extends steps.instantiateSteps, chosenSteps extends HelperFnChosenSteps.main<value, steps.StepNumbers<value>>> = chosenSteps extends HelperFnChosenSteps.defaultStringOption ? StepSpecificHelperFn<value, chosenSteps> : never;
+  export type createHelperFnForTupleSteps<value extends steps.instantiateSteps, chosenSteps extends HelperFnChosenSteps.main<value, steps.StepNumbers<value>>> = chosenSteps extends HelperFnChosenSteps.tupleNotation<steps.StepNumbers<value>> ? StepSpecificHelperFn<value, chosenSteps> : never;
+  export type createHelperFnForObjectSteps<value extends steps.instantiateSteps, chosenSteps extends HelperFnChosenSteps.main<value, steps.StepNumbers<value>>> = chosenSteps extends HelperFnChosenSteps.objectNotation<steps.StepNumbers<value>> ? { [key in keyof chosenSteps]: key extends HelperFnChosenSteps.resolve<value, chosenSteps> ? StepSpecificHelperFn<value, chosenSteps>[key] : never } : never;
+  type HelperFnMap<value extends steps.instantiateSteps, chosenSteps extends HelperFnChosenSteps.main<value, steps.StepNumbers<value>>> = {
+    all: createHelperFnForAllSteps<value, chosenSteps>;
+    tuple: createHelperFnForTupleSteps<value, chosenSteps>;
+    object: createHelperFnForObjectSteps<value, chosenSteps>;
+  };
+  export type HelperFn<value extends steps.instantiateSteps, chosenSteps extends HelperFnChosenSteps.main<value, steps.StepNumbers<value>>> = general<value> & HelperFnMap<value, chosenSteps>[HelperFnChosenSteps.resolveType<value, chosenSteps>];
+  export {};
+}
+//#endregion
+export { UpdateFn };
+//# sourceMappingURL=update-fn.d.mts.map

package/dist/steps/fn-utils/update-fn.d.mts.map

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

package/dist/steps/index.cjs

@@ -1,4 +1,6 @@
-const require_utils = require('./utils.cjs');
+const require_index = require('./fn-utils/helper-fn/index.cjs');
 const require_fields = require('./fields.cjs');
+const require_steps = require('./steps.cjs');
+const require_utils = require('./utils.cjs');
 const require_schema = require('./schema.cjs');
-const require_types = require('./types.cjs');
+require('./fn-utils/index.cjs');

package/dist/steps/index.mjs

@@ -1,6 +1,8 @@
-import { createCtx } from "./utils.mjs";
+import { HelperFnChosenSteps } from "./fn-utils/helper-fn/index.mjs";
 import { fields } from "./fields.mjs";
-import { MultiStepFormStepSchema } from "./schema.mjs";
-import { HelperFnChosenSteps } from "./types.mjs";
+import { VALIDATED_STEP_REGEX, steps } from "./steps.mjs";
+import { createCtx } from "./utils.mjs";
+import { MultiStepFormStepSchema, createIsValidStepFn } from "./schema.mjs";
+import "./fn-utils/index.mjs";
 
 export {  };

package/dist/steps/schema.cjs

@@ -1,32 +1,39 @@
+const require_casing = require('../utils/casing.cjs');
 const require_invariant = require('../utils/invariant.cjs');
+require('../utils/index.cjs');
+const require_fields = require('./fields.cjs');
+const require_steps = require('./steps.cjs');
+const require_helpers = require('../utils/helpers.cjs');
 const require_utils = require('./utils.cjs');
-const require_casing = require('../utils/casing.cjs');
-const require_field_types = require('../utils/field-types.cjs');
-const require_utils$1 = require('../internals/utils.cjs');
 const require_step_schema = require('../internals/step-schema.cjs');
 const require_storage = require('../storage.cjs');
 const require_subscribable = require('../subscribable.cjs');
-const require_fields = require('./fields.cjs');
 
 //#region src/steps/schema.ts
+const STRING_KEYS = ["string", "string.keys"];
+const NUMBER_KEYS = ["number"];
+const ARRAY_STRING_KEYS = require_helpers.addToTuple(require_helpers.mapToTuple(STRING_KEYS, (key) => `array.${key}`), "array.string.untyped");
+const ARRAY_NUMBER_KEYS = require_helpers.mapToTuple(NUMBER_KEYS, (key) => `array.${key}`);
 /**
 * Available transformation types for the step numbers.
 */
 const AS_TYPES = [
-	"string",
-	"number",
-	"array.string",
-	"array.string.untyped"
+	...STRING_KEYS,
+	...NUMBER_KEYS,
+	...ARRAY_STRING_KEYS,
+	...ARRAY_NUMBER_KEYS
 ];
-function assertObjectFields(obj, checks) {
-	if (typeof obj !== "object" || obj === null) return false;
-	for (const key of Object.keys(checks)) {
-		if (!(key in obj)) return false;
-		const checkFn = checks[key];
-		const value = obj[key];
-		if (!checkFn(value)) return false;
+function createIsValidStepFn(stepNumbers) {
+	function isValidStep(value) {
+		require_invariant.createInvariant("[isValidStep]")(typeof value === "string" || typeof value === "number", `The value must be a string or a number, was ${typeof value}`);
+		if (typeof value === "string") {
+			if (!value.includes("step")) return false;
+			return stepNumbers.includes(Number.parseInt(value.replace("step", "")));
+		}
+		if (typeof value === "number") return stepNumbers.includes(value);
+		return false;
 	}
-	return true;
+	return isValidStep;
 }
 var MultiStepFormStepSchema = class extends require_subscribable.Subscribable {
 	/**
@@ -39,45 +46,43 @@ var MultiStepFormStepSchema = class extends require_subscribable.Subscribable {
 	value;
 	steps;
 	defaultNameTransformationCasing;
-	firstStep;
-	lastStep;
-	stepNumbers;
-	storage;
+	#stepNumbers;
+	#storage;
 	#internal;
 	constructor(config) {
 		super();
-		const { steps, nameTransformCasing, storage } = config;
+		const { steps: steps$1, nameTransformCasing, storage } = config;
 		this.defaultNameTransformationCasing = require_casing.setCasingType(nameTransformCasing);
-		this.original = steps;
-		this.value = require_utils$1.createStep(this.original);
-		this.storage = new require_storage.MultiStepFormStorage({
-			data: this.value,
-			key: storage?.key ?? require_storage.DEFAULT_STORAGE_KEY,
-			store: storage?.store,
-			throwWhenUndefined: storage?.throwWhenUndefined ?? false
-		});
+		this.original = steps$1;
+		this.value = require_steps.instantiateSteps({ steps: steps$1 });
 		this.#internal = new require_step_schema.MultiStepFormStepSchemaInternal({
 			originalValue: this.original,
 			getValue: () => this.value,
 			setValue: (next) => this.handlePostUpdate(next)
 		});
 		this.value = this.#internal.enrichValues(this.value);
-		this.stepNumbers = Object.keys(this.value).map((key) => Number.parseInt(key.replace("step", "")));
-		this.firstStep = this.first();
-		this.lastStep = this.last();
+		this.#storage = new require_storage.MultiStepFormStorage({
+			data: this.value,
+			key: storage?.key ?? require_storage.DEFAULT_STORAGE_KEY,
+			store: storage?.store,
+			throwWhenUndefined: storage?.throwWhenUndefined
+		});
+		this.#stepNumbers = Object.keys(this.value).map((key) => Number.parseInt(key.replace("step", "")));
 		this.steps = {
-			first: this.firstStep.step,
-			last: this.lastStep.step,
-			value: this.stepNumbers,
+			value: this.#stepNumbers,
 			as: (asType) => {
 				require_invariant.invariant(typeof asType === "string", `The type of the target transformation type must be a string, was ${typeof asType}`);
-				if (asType === "string") return this.stepNumbers.map((value) => `'${value}'`).join(" | ");
-				if (asType === "number") return this.stepNumbers.join(" | ");
-				if (asType.includes("array.string")) return this.stepNumbers.map((value) => `${value}`);
+				if (asType === "string") return this.#stepNumbers.map((value) => `'${value}'`).join(" | ");
+				if (asType === "string.keys") return this.#stepNumbers.map((value) => `'step${value}'`).join(" | ");
+				if (asType === "number") return this.#stepNumbers.join(" | ");
+				if (asType.includes("array.string")) {
+					if (asType.includes("keys")) return this.#stepNumbers.map((value) => `step${value}`);
+					return this.#stepNumbers.map((value) => `${value}`);
+				}
+				if (asType.includes("array.number")) return this.#stepNumbers;
 				throw new Error(`Transformation type "${asType}" is not supported. Available transformations include: ${AS_TYPES.map((value) => `"${value}"`).join(", ")}`);
 			},
-			isValidStepNumber: (stepNumber) => this.stepNumbers.includes(stepNumber),
-			isValidStepKey: (value) => require_utils$1.isValidStepKey(this.value, value)
+			isValidStep: createIsValidStepFn(this.#stepNumbers)
 		};
 		this.sync();
 	}
@@ -85,7 +90,7 @@ var MultiStepFormStepSchema = class extends require_subscribable.Subscribable {
 	* @internal
 	*/
 	__getStorage() {
-		return this.storage;
+		return this.#storage;
 	}
 	getSnapshot() {
 		return this;
@@ -113,28 +118,17 @@ var MultiStepFormStepSchema = class extends require_subscribable.Subscribable {
 	get(options) {
 		return require_utils.getStep(this.value)(options);
 	}
-	/**
-	* Gets the data for the first step.
-	* @returns The data for the first step.
-	*/
-	first() {
-		const firstStep = Math.min(...this.stepNumbers);
-		return this.get({ step: firstStep });
-	}
-	/**
-	* Gets the data for the last step.
-	* @returns The data for the last step.
-	*/
-	last() {
-		const lastStep = Math.max(...this.stepNumbers);
-		return this.get({ step: lastStep });
-	}
 	handlePostUpdate(next) {
 		this.value = { ...next };
 		this.__getStorage().add(this.value);
 		this.sync();
 		this.notify();
 	}
+	/**
+	* Updates the step with the given options.
+	* @param options The options for updating the step.
+	* @returns The return value of the updater function.
+	*/
 	update(options) {
 		this.#internal.update(options);
 	}
@@ -149,29 +143,8 @@ var MultiStepFormStepSchema = class extends require_subscribable.Subscribable {
 	* Validates that a given object is the proper shape for step data.
 	* @param value
 	*/
-	static hasData(value, options) {
-		if (value === null || typeof value !== "object") return false;
-		return assertObjectFields(value, {
-			title: (v) => typeof v === "string",
-			fields: (v) => {
-				if (v === null || typeof v !== "object") return false;
-				for (const key of Object.keys(v)) {
-					if (typeof key !== "string" || !(key in v)) return false;
-					const current = v[key];
-					if (current === null || typeof current !== "object") return false;
-					if (!assertObjectFields(current, {
-						defaultValue: (v$1) => v$1 !== "undefined" && v$1 !== null,
-						label: (v$1) => typeof v$1 === "string" || typeof v$1 === "boolean" && !v$1,
-						nameTransformCasing: require_casing.isCasingValid,
-						type: require_field_types.isFieldType
-					})) return false;
-				}
-				return true;
-			},
-			createHelperFn: (v) => typeof v === "function",
-			nameTransformCasing: require_casing.isCasingValid,
-			...options?.optionalKeysToCheck
-		});
+	static hasData(value) {
+		return require_steps.steps.isValidSteps(value);
 	}
 	/**
 	* Gets the value of a given field for a given step.
@@ -181,14 +154,18 @@ var MultiStepFormStepSchema = class extends require_subscribable.Subscribable {
 	*/
 	getValue(step, field) {
 		const stepData = this.value[step];
+		const invariant$1 = require_invariant.createInvariant("[getValue]");
 		const baseErrorMessage = `Unable to get the value for "${String(step)}.fields.${String(field)}"`;
-		require_invariant.invariant("fields" in stepData, baseErrorMessage);
-		require_invariant.invariant(typeof stepData.fields === "object", `${baseErrorMessage} because "fields" is not an object. This shouldn't be the case, so please open an issue`);
-		const fields$1 = stepData.fields;
-		return require_fields.fields.resolvedDeepPath(field, fields$1);
+		const errorSuffix = "This shouldn't be the case, so please open an issue";
+		const createErrorMessage = (reason) => `${baseErrorMessage} because ${reason}. ${errorSuffix}`;
+		invariant$1(typeof stepData === "object" && stepData !== null, createErrorMessage("the step data is not an object"));
+		invariant$1("fields" in stepData, createErrorMessage("the step data does not have a \"fields\" property"));
+		invariant$1(typeof stepData.fields === "object", createErrorMessage("\"fields\" is not an object"));
+		return require_fields.fields.resolvedDeepPath(field, stepData.fields);
 	}
 };
 
 //#endregion
 exports.MultiStepFormStepSchema = MultiStepFormStepSchema;
+exports.createIsValidStepFn = createIsValidStepFn;
 //# sourceMappingURL=schema.cjs.map

package/dist/steps/schema.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"schema.cjs","names":["Subscribable","#internal","setCasingType","createStep","MultiStepFormStorage","DEFAULT_STORAGE_KEY","MultiStepFormStepSchemaInternal","isValidStepKey","getStep","v","isCasingValid","isFieldType","fields","fieldsUtils"],"sources":["../../src/steps/schema.ts"],"sourcesContent":["import { MultiStepFormStepSchemaInternal } from '@/internals/step-schema';\nimport {\n  DEFAULT_STORAGE_KEY,\n  DefaultStorageKey,\n  MultiStepFormStorage,\n} from '@/storage';\nimport {\n  isCasingValid,\n  isFieldType,\n  setCasingType,\n  type CasingType,\n  type Constrain,\n  type DefaultCasing,\n  type Expand,\n  type Join,\n} from '@/utils';\nimport { invariant } from '@/utils/invariant';\nimport { Subscribable } from '../subscribable';\nimport { fields as fieldsUtils } from './fields';\nimport {\n  AnyResolvedStep,\n  AnyStepField,\n  AnyStepFieldOption,\n  CreateHelperFunctionOptionsWithCustomCtxOptions,\n  CreateHelperFunctionOptionsWithValidator,\n  CreateHelperFunctionOptionsWithoutValidator,\n  CreateStepHelperFn,\n  CreatedHelperFnWithInput,\n  CreatedHelperFnWithoutInput,\n  ExtractStepFromKey,\n  FirstStep,\n  GetCurrentStep,\n  HelperFnChosenSteps,\n  HelperFnWithValidator,\n  HelperFnWithoutValidator,\n  InferStepOptions,\n  LastStep,\n  MultiStepFormSchemaStepConfig,\n  ResolvedFields,\n  ResolvedStep,\n  Step,\n  StepData,\n  StepNumbers,\n  StepOptions,\n  UnionToTuple,\n  UpdateFn,\n  ValidStepKey,\n  type ResetFn,\n} from './types';\nimport { getStep, type GetStepOptions } from './utils';\nimport { createStep, isValidStepKey } from '@/internals/utils';\n\nexport interface MultiStepFormStepSchemaFunctions<\n  TResolvedStep extends AnyResolvedStep,\n  TStepNumbers extends StepNumbers<TResolvedStep>\n> {\n  update: UpdateFn.general<TResolvedStep, TStepNumbers>;\n  createHelperFn: CreateStepHelperFn<TResolvedStep, TStepNumbers>;\n}\nexport type AsType = (typeof AS_TYPES)[number];\ntype Quote<T extends string[]> = {\n  [K in keyof T]: T[K] extends string ? `'${T[K]}'` : never;\n};\nexport type AsTypeMap<\n  resolvedStep extends AnyResolvedStep,\n  stepNumbers extends ExtractStepFromKey<Constrain<keyof resolvedStep, string>>\n> = {\n  // Exclude is needed due to all the Constrains\n  string: Exclude<\n    Join<\n      Constrain<\n        Quote<Constrain<UnionToTuple<`${stepNumbers}`>, string[]>>,\n        string[]\n      >,\n      ' | '\n    >,\n    ''\n  >;\n  number: Exclude<\n    Join<Constrain<UnionToTuple<`${stepNumbers}`>, string[]>, ' | '>,\n    ''\n  >;\n  'array.string': UnionToTuple<`${stepNumbers}`>;\n  'array.string.untyped': string[];\n};\nexport type AsFunctionReturn<\n  resolvedStep extends AnyResolvedStep,\n  stepNumbers extends ExtractStepFromKey<Constrain<keyof resolvedStep, string>>,\n  asType extends AsType\n> = AsTypeMap<resolvedStep, stepNumbers>[asType];\nexport type AsFunction<\n  resolvedStep extends AnyResolvedStep,\n  stepNumbers extends ExtractStepFromKey<Constrain<keyof resolvedStep, string>>\n> = <asType extends AsType>(\n  asType: asType\n) => AsFunctionReturn<resolvedStep, stepNumbers, asType>;\nexport type MultiStepFormStepStepsConfig<\n  TStep extends Step<TCasing>,\n  TCasing extends CasingType,\n  TResolvedStep extends ResolvedStep<TStep, TCasing> = ResolvedStep<\n    TStep,\n    TCasing\n  >,\n  TStepNumbers extends StepNumbers<TResolvedStep> = StepNumbers<TResolvedStep>\n> = {\n  first: FirstStep<TResolvedStep>;\n  last: LastStep<TResolvedStep>;\n  value: ReadonlyArray<TStepNumbers>;\n  as: AsFunction<TResolvedStep, TStepNumbers>;\n  isValidStepNumber: (stepNumber: number) => stepNumber is TStepNumbers;\n  isValidStepKey: (\n    value: string\n  ) => value is Constrain<keyof TResolvedStep, string>;\n};\nexport type MultiStepFormStepSchemaListener<\n  TStep extends Step<TCasing>,\n  TCasing extends CasingType\n> = (data: {\n  original: InferStepOptions<TStep>;\n  value: ResolvedStep<TStep, TCasing>;\n  steps: MultiStepFormStepStepsConfig<TStep, TCasing>;\n  defaultNameTransformationCasing: TCasing;\n}) => void;\n\n/**\n * Available transformation types for the step numbers.\n */\nconst AS_TYPES = [\n  'string',\n  'number',\n  'array.string',\n  'array.string.untyped',\n] as const;\n\ntype ValueCheck<T> = (v: unknown) => v is T;\n\ntype FieldChecks<T extends object> = {\n  [K in keyof T]: ValueCheck<T[K]>;\n};\n\nfunction assertObjectFields<T extends object>(\n  obj: unknown,\n  checks: FieldChecks<T>\n): obj is T {\n  if (typeof obj !== 'object' || obj === null) return false;\n\n  for (const key of Object.keys(checks) as (keyof T)[]) {\n    // Check that the property exists\n    if (!(key in obj)) return false;\n\n    // Now check the type\n    const checkFn = checks[key];\n    const value = (obj as any)[key];\n    if (!checkFn(value)) return false;\n  }\n\n  return true;\n}\n\nexport class MultiStepFormStepSchema<\n    step extends Step<casing>,\n    casing extends CasingType = DefaultCasing,\n    resolvedStep extends ResolvedStep<step, casing> = ResolvedStep<\n      step,\n      casing\n    >,\n    stepNumbers extends StepNumbers<resolvedStep> = StepNumbers<resolvedStep>,\n    storageKey extends string = DefaultStorageKey\n  >\n  extends Subscribable<MultiStepFormStepSchemaListener<step, casing>>\n  implements MultiStepFormStepSchemaFunctions<resolvedStep, stepNumbers>\n{\n  /**\n   * The original config before any validation or transformations have been applied.\n   */\n  readonly original: InferStepOptions<step>;\n  /**\n   * The resolved step values.\n   */\n  value: resolvedStep;\n  readonly steps: MultiStepFormStepStepsConfig<step, casing>;\n  readonly defaultNameTransformationCasing: casing;\n  //@ts-ignore\n  private readonly firstStep: StepData<resolvedStep, FirstStep<resolvedStep>>;\n  private readonly lastStep: StepData<resolvedStep, LastStep<resolvedStep>>;\n  private readonly stepNumbers: Array<number>;\n  private readonly storage: MultiStepFormStorage<resolvedStep, storageKey>;\n  readonly #internal: MultiStepFormStepSchemaInternal<\n    step,\n    casing,\n    resolvedStep,\n    stepNumbers\n  >;\n\n  constructor(\n    config: MultiStepFormSchemaStepConfig<\n      step,\n      Constrain<casing, CasingType>,\n      storageKey\n    >\n  ) {\n    super();\n\n    const { steps, nameTransformCasing, storage } = config;\n\n    this.defaultNameTransformationCasing = setCasingType(\n      nameTransformCasing\n    ) as casing;\n\n    this.original = steps;\n\n    this.value = createStep<step, casing>(this.original) as resolvedStep;\n    this.storage = new MultiStepFormStorage<resolvedStep, storageKey>({\n      data: this.value,\n      key: (storage?.key ?? DEFAULT_STORAGE_KEY) as storageKey,\n      store: storage?.store,\n      throwWhenUndefined: storage?.throwWhenUndefined ?? false,\n    });\n    this.#internal = new MultiStepFormStepSchemaInternal<\n      step,\n      casing,\n      resolvedStep,\n      stepNumbers\n    >({\n      originalValue: this.original,\n      getValue: () => this.value,\n      setValue: (next) => this.handlePostUpdate(next),\n    });\n\n    this.value = this.#internal.enrichValues(this.value);\n    this.stepNumbers = Object.keys(this.value).map((key) =>\n      Number.parseInt(key.replace('step', ''))\n    );\n\n    this.firstStep = this.first();\n    this.lastStep = this.last();\n    this.steps = {\n      first: this.firstStep.step,\n      last: this.lastStep.step,\n      value: this.stepNumbers as unknown as ReadonlyArray<stepNumbers>,\n      as: (asType): any => {\n        invariant(\n          typeof asType === 'string',\n          `The type of the target transformation type must be a string, was ${typeof asType}`\n        );\n\n        if (asType === 'string') {\n          return this.stepNumbers.map((value) => `'${value}'`).join(' | ');\n        }\n\n        if (asType === 'number') {\n          return this.stepNumbers.join(' | ');\n        }\n\n        if (asType.includes('array.string')) {\n          return this.stepNumbers.map((value) => `${value}`);\n        }\n\n        throw new Error(\n          `Transformation type \"${asType}\" is not supported. Available transformations include: ${AS_TYPES.map(\n            (value) => `\"${value}\"`\n          ).join(', ')}`\n        );\n      },\n      isValidStepNumber: (stepNumber): stepNumber is stepNumbers =>\n        this.stepNumbers.includes(stepNumber),\n      isValidStepKey: (value) =>\n        isValidStepKey<resolvedStep>(this.value, value),\n    };\n\n    this.sync();\n  }\n\n  /**\n   * @internal\n   */\n  __getStorage() {\n    return this.storage;\n  }\n\n  getSnapshot() {\n    return this;\n  }\n\n  /**\n   * Syncs the values from storage to {@linkcode value}.\n   */\n  sync() {\n    // TODO add \"syncOptions\" so caller can chose where to sync from ('storage' | 'instance')\n    const storageValues = this.__getStorage().get();\n\n    if (storageValues) {\n      const enrichedValues = this.#internal.enrichValues(storageValues);\n\n      this.value = { ...enrichedValues };\n    }\n  }\n\n  protected notify() {\n    for (const listener of this.listeners) {\n      listener({\n        defaultNameTransformationCasing: this.defaultNameTransformationCasing,\n        original: this.original,\n        steps: this.steps,\n        value: this.value,\n      });\n    }\n  }\n\n  /**\n   * Gets the data for a specific step.\n   * @param options The options for getting the step data.\n   * @returns The step data for the target step.\n   */\n  get<stepNumber extends stepNumbers>(\n    options: GetStepOptions<resolvedStep, stepNumbers, stepNumber>\n  ) {\n    return getStep(this.value)(options);\n  }\n\n  /**\n   * Gets the data for the first step.\n   * @returns The data for the first step.\n   */\n  first() {\n    const firstStep = Math.min(...this.stepNumbers) as FirstStep<resolvedStep>;\n\n    return this.get({ step: firstStep });\n  }\n\n  /**\n   * Gets the data for the last step.\n   * @returns The data for the last step.\n   */\n  last() {\n    const lastStep = Math.max(...this.stepNumbers);\n\n    return this.get<LastStep<resolvedStep>>({ step: lastStep as never });\n  }\n\n  protected handlePostUpdate(next: resolvedStep) {\n    this.value = { ...next };\n\n    this.__getStorage().add(this.value);\n    this.sync();\n    this.notify();\n  }\n\n  update<\n    targetStep extends ValidStepKey<stepNumbers>,\n    field extends UpdateFn.chosenFields<\n      UpdateFn.resolvedStep<resolvedStep, stepNumbers, targetStep>\n    > = 'all',\n    strict extends boolean = true,\n    partial extends boolean = false,\n    additionalCtx extends Record<string, unknown> = {},\n    additionalUpdaterData extends UpdateFn.additionalUpdaterData = never\n  >(\n    options: UpdateFn.options<\n      resolvedStep,\n      stepNumbers,\n      targetStep,\n      field,\n      strict,\n      partial,\n      additionalCtx,\n      additionalUpdaterData\n    >\n  ) {\n    this.#internal.update(options);\n  }\n\n  reset<\n    targetStep extends ValidStepKey<stepNumbers>,\n    fields extends UpdateFn.chosenFields<currentStep>,\n    currentStep extends UpdateFn.resolvedStep<\n      resolvedStep,\n      stepNumbers,\n      targetStep\n    >\n  >(\n    options: ResetFn.Options<\n      resolvedStep,\n      stepNumbers,\n      targetStep,\n      fields,\n      currentStep\n    >\n  ) {\n    this.#internal.reset(options);\n  }\n\n  /**\n   * Create a helper function with validated input.\n   */\n  createHelperFn<\n    const chosenSteps extends HelperFnChosenSteps<resolvedStep, stepNumbers>,\n    validator,\n    additionalCtx extends Record<string, unknown>,\n    response\n  >(\n    options: CreateHelperFunctionOptionsWithValidator<\n      resolvedStep,\n      stepNumbers,\n      chosenSteps,\n      validator,\n      additionalCtx\n    >,\n    fn: HelperFnWithValidator<\n      resolvedStep,\n      stepNumbers,\n      chosenSteps,\n      validator,\n      additionalCtx,\n      response\n    >\n  ): CreatedHelperFnWithInput<validator, response>;\n  /**\n   * Create a helper function without input.\n   */\n  createHelperFn<\n    const chosenSteps extends HelperFnChosenSteps<resolvedStep, stepNumbers>,\n    additionalCtx extends Record<string, unknown>,\n    response\n  >(\n    options: CreateHelperFunctionOptionsWithoutValidator<\n      resolvedStep,\n      stepNumbers,\n      chosenSteps\n    > &\n      CreateHelperFunctionOptionsWithCustomCtxOptions<\n        resolvedStep,\n        stepNumbers,\n        chosenSteps,\n        additionalCtx\n      >,\n    fn: HelperFnWithoutValidator<\n      resolvedStep,\n      stepNumbers,\n      chosenSteps,\n      additionalCtx,\n      response\n    >\n  ): CreatedHelperFnWithoutInput<response>;\n  // Implementation\n  createHelperFn<\n    const chosenSteps extends HelperFnChosenSteps<resolvedStep, stepNumbers>,\n    response,\n    additionalCtx extends Record<string, unknown>,\n    validator = never\n  >(\n    options:\n      | CreateHelperFunctionOptionsWithValidator<\n          resolvedStep,\n          stepNumbers,\n          chosenSteps,\n          validator,\n          additionalCtx\n        >\n      | CreateHelperFunctionOptionsWithoutValidator<\n          resolvedStep,\n          stepNumbers,\n          chosenSteps\n        >,\n    fn:\n      | HelperFnWithValidator<\n          resolvedStep,\n          stepNumbers,\n          chosenSteps,\n          validator,\n          additionalCtx,\n          response\n        >\n      | HelperFnWithoutValidator<\n          resolvedStep,\n          stepNumbers,\n          chosenSteps,\n          additionalCtx,\n          response\n        >\n  ) {\n    const { stepData, ...rest } = options;\n\n    return this.#internal.createStepHelperFn(stepData)(rest, fn);\n  }\n\n  /**\n   * Validates that a given object is the proper shape for step data.\n   * @param value\n   */\n  static hasData<\n    step extends Step<casing>,\n    resolvedStep extends ResolvedStep<step, casing>,\n    stepNumbers extends StepNumbers<resolvedStep>,\n    casing extends CasingType = DefaultCasing\n  >(\n    value: unknown,\n    options?: {\n      optionalKeysToCheck?: FieldChecks<\n        Pick<StepOptions, 'description' | 'validateFields'>\n      >;\n    }\n  ): value is GetCurrentStep<resolvedStep, stepNumbers> {\n    if (value === null || typeof value !== 'object') {\n      return false;\n    }\n\n    return assertObjectFields<\n      | GetCurrentStep<resolvedStep, stepNumbers>\n      | (Omit<StepOptions, 'fields'> & {\n          fields: Expand<\n            ResolvedFields<InferStepOptions<step>, keyof InferStepOptions<step>>\n          >;\n        })\n    >(value, {\n      title: (v) => typeof v === 'string',\n      fields: (\n        v\n      ): v is Expand<\n        ResolvedFields<InferStepOptions<step>, keyof InferStepOptions<step>>\n      > => {\n        if (v === null || typeof v !== 'object') {\n          return false;\n        }\n\n        for (const key of Object.keys(v)) {\n          if (typeof key !== 'string' || !(key in v)) {\n            return false;\n          }\n\n          const current = (v as Record<string, unknown>)[key];\n\n          if (current === null || typeof current !== 'object') {\n            return false;\n          }\n\n          const hasField = assertObjectFields<AnyStepFieldOption>(current, {\n            defaultValue: (v): v is {} => v !== 'undefined' && v !== null,\n            label: (v) =>\n              typeof v === 'string' || (typeof v === 'boolean' && !v),\n            nameTransformCasing: isCasingValid,\n            type: isFieldType,\n          });\n\n          if (!hasField) {\n            return false;\n          }\n        }\n\n        return true;\n      },\n      createHelperFn: (\n        v\n      ): v is GetCurrentStep<resolvedStep, stepNumbers>['createHelperFn'] =>\n        typeof v === 'function',\n      // update: (v): v is GetCurrentStep<resolvedStep, stepNumbers>['update'] =>\n      //   typeof v === 'function',\n      nameTransformCasing: isCasingValid,\n      ...options?.optionalKeysToCheck,\n    });\n  }\n\n  /**\n   * Gets the value of a given field for a given step.\n   * @param step The step to get the value from.\n   * @param field The field to get the value from.\n   * @returns The value of the {@linkcode field}.\n   */\n  getValue<\n    step extends keyof resolvedStep,\n    field extends fieldsUtils.getDeepFields<resolvedStep, step>\n  >(step: step, field: field) {\n    const stepData = this.value[step];\n    const baseErrorMessage = `Unable to get the value for \"${String(\n      step\n    )}.fields.${String(field)}\"`;\n\n    invariant('fields' in stepData, baseErrorMessage);\n    invariant(\n      typeof stepData.fields === 'object',\n      `${baseErrorMessage} because \"fields\" is not an object. This shouldn't be the case, so please open an issue`\n    );\n\n    const fields = stepData.fields as AnyStepField;\n\n    const defaultValue = fieldsUtils.resolvedDeepPath<\n      resolvedStep,\n      step,\n      fieldsUtils.get<resolvedStep, step>,\n      field\n    >(field, fields as fieldsUtils.get<resolvedStep, step>);\n\n    return defaultValue;\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"schema.cjs","names":["addToTuple","mapToTuple","createInvariant","Subscribable","#stepNumbers","#storage","#internal","setCasingType","steps","instantiateSteps","MultiStepFormStepSchemaInternal","MultiStepFormStorage","DEFAULT_STORAGE_KEY","getStep","invariant: Invariant","fields"],"sources":["../../src/steps/schema.ts"],"sourcesContent":["import {\n  MultiStepFormStepSchemaInternal,\n  type StepSchema,\n} from '@/internals/step-schema';\nimport { DEFAULT_STORAGE_KEY, MultiStepFormStorage } from '@/storage';\nimport {\n  setCasingType,\n  type Constrain,\n  type Join,\n  type UnionToTuple,\n} from '@/utils';\nimport { addToTuple, mapToTuple } from '@/utils/helpers';\nimport { createInvariant, invariant, type Invariant } from '@/utils/invariant';\nimport { Subscribable } from '../subscribable';\nimport { fields } from './fields';\nimport type { HelperFnChosenSteps } from './fn-utils/helper-fn';\nimport type {\n  GeneralHelperFn,\n  HelperFnInput,\n  HelperFnOptions,\n  HelperFnOutput,\n} from './fn-utils/helper-fn/utils';\nimport type { ResetFn } from './fn-utils/reset-fn';\nimport type { UpdateFn } from './fn-utils/update-fn';\nimport { instantiateSteps, steps } from './steps';\nimport { getStep, type ExtractStepFromKey, type GetStepOptions } from './utils';\n\nexport interface MultiStepFormStepSchemaFunctions<\n  value extends steps.instantiateSteps,\n> {\n  update: UpdateFn.general<value>;\n  reset: ResetFn.general<value>;\n  createHelperFn: GeneralHelperFn<value>;\n}\nexport type AsType = (typeof AS_TYPES)[number];\ntype Quote<T extends string[]> = {\n  [K in keyof T]: T[K] extends string ? `'${T[K]}'` : never;\n};\nexport type AsTypeMap<\n  def extends StepSchema.Config,\n  value extends steps.instantiateSteps<def>,\n  stepNumbers extends steps.StepNumbers<value> = steps.StepNumbers<value>,\n> = {\n  // Exclude is needed due to all the Constrains\n  string: Exclude<\n    Join<\n      Constrain<\n        Quote<\n          Constrain<\n            UnionToTuple<`${ExtractStepFromKey<stepNumbers>}`>,\n            string[]\n          >\n        >,\n        string[]\n      >,\n      ' | '\n    >,\n    ''\n  >;\n  'string.keys': Exclude<\n    Join<\n      Constrain<UnionToTuple<`${ExtractStepFromKey<stepNumbers>}`>, string[]>,\n      ' | '\n    >,\n    ''\n  >;\n  number: Exclude<\n    Join<Constrain<UnionToTuple<`${stepNumbers}`>, string[]>, ' | '>,\n    ''\n  >;\n  'array.number': UnionToTuple<ExtractStepFromKey<stepNumbers>>;\n  'array.string': UnionToTuple<`${ExtractStepFromKey<stepNumbers>}`>;\n  'array.string.keys': UnionToTuple<`${stepNumbers}`>;\n  'array.string.untyped': string[];\n};\nexport type AsFunctionReturn<\n  def extends StepSchema.Config,\n  value extends steps.instantiateSteps<def>,\n  asType extends AsType,\n> = AsTypeMap<def, value>[asType];\nexport type AsFunction<\n  def extends StepSchema.Config,\n  value extends steps.instantiateSteps<def>,\n> = <asType extends AsType>(\n  asType: asType\n) => AsFunctionReturn<def, value, asType>;\n\nexport type IsValidStepFn<\n  def extends StepSchema.Config,\n  value extends steps.instantiateSteps<def>,\n> = {\n  /**\n   * Checks if a given string is a valid step key.\n   */\n  (value: string): value is steps.StepNumbers<value>;\n  /**\n   * Checks if a given number is a valid step number.\n   */\n  (value: number): value is ExtractStepFromKey<steps.StepNumbers<value>>;\n};\nexport type MultiStepFormStepStepsConfig<\n  def extends StepSchema.Config,\n  value extends steps.instantiateSteps<def>,\n> = {\n  value: ReadonlyArray<steps.StepNumbers<value>>;\n  as: AsFunction<def, value>;\n  isValidStep: IsValidStepFn<def, value>;\n};\n\nconst STRING_KEYS = ['string', 'string.keys'] as const;\nconst NUMBER_KEYS = ['number'] as const;\nconst ARRAY_STRING_KEYS = addToTuple(\n  mapToTuple(STRING_KEYS, (key) => `array.${key}` as const),\n  'array.string.untyped'\n);\nconst ARRAY_NUMBER_KEYS = mapToTuple(\n  NUMBER_KEYS,\n  (key) => `array.${key}` as const\n);\n\n/**\n * Available transformation types for the step numbers.\n */\nconst AS_TYPES = [\n  ...STRING_KEYS,\n  ...NUMBER_KEYS,\n  ...ARRAY_STRING_KEYS,\n  ...ARRAY_NUMBER_KEYS,\n] as const;\n\nexport function createIsValidStepFn<\n  def extends StepSchema.Config,\n  value extends steps.instantiateSteps<def>,\n>(stepNumbers: Array<number>): IsValidStepFn<def, value> {\n  function isValidStep(value: string): value is steps.StepNumbers<value>;\n  function isValidStep(\n    value: number\n  ): value is ExtractStepFromKey<steps.StepNumbers<value>>;\n  function isValidStep(value: string | number) {\n    const invariant: Invariant = createInvariant('[isValidStep]');\n\n    invariant(\n      typeof value === 'string' || typeof value === 'number',\n      `The value must be a string or a number, was ${typeof value}`\n    );\n\n    if (typeof value === 'string') {\n      if (!value.includes('step')) {\n        return false;\n      }\n\n      return stepNumbers.includes(Number.parseInt(value.replace('step', '')));\n    }\n\n    if (typeof value === 'number') {\n      return stepNumbers.includes(value);\n    }\n\n    return false;\n  }\n\n  return isValidStep;\n}\n\nexport namespace MultiStepFormStepSchema {\n  export type ListenerOptions<\n    def extends StepSchema.Config,\n    value extends steps.instantiateSteps<def>,\n  > = {\n    original: def['steps'];\n    value: value;\n    steps: MultiStepFormStepStepsConfig<def, value>;\n    defaultNameTransformationCasing: def['nameTransformCasing'];\n  };\n  export type Listener<\n    def extends StepSchema.Config,\n    value extends steps.instantiateSteps<def>,\n  > = (data: ListenerOptions<def, value>) => void;\n}\n\nexport class MultiStepFormStepSchema<\n  const def extends StepSchema.Config,\n  value extends steps.instantiateSteps<def> = steps.instantiateSteps<def>,\n>\n  extends Subscribable<MultiStepFormStepSchema.Listener<def, value>>\n  implements MultiStepFormStepSchemaFunctions<value>\n{\n  /**\n   * The original config before any validation or transformations have been applied.\n   */\n  readonly original: def['steps'];\n  /**\n   * The resolved step values.\n   */\n  value: value;\n  readonly steps: MultiStepFormStepStepsConfig<def, value>;\n  readonly defaultNameTransformationCasing: def['nameTransformCasing'];\n  readonly #stepNumbers: Array<number>;\n  readonly #storage: MultiStepFormStorage<\n    value,\n    StepSchema.inferStorageKey<def>\n  >;\n  readonly #internal: MultiStepFormStepSchemaInternal<def, value>;\n\n  constructor(config: def) {\n    super();\n\n    const { steps, nameTransformCasing, storage } = config;\n\n    this.defaultNameTransformationCasing = setCasingType(\n      nameTransformCasing\n    ) as def['nameTransformCasing'];\n\n    this.original = steps;\n\n    this.value = instantiateSteps({ steps });\n    this.#internal = new MultiStepFormStepSchemaInternal({\n      originalValue: this.original,\n      getValue: () => this.value,\n      setValue: (next) => this.handlePostUpdate(next),\n    });\n\n    this.value = this.#internal.enrichValues(this.value);\n    this.#storage = new MultiStepFormStorage({\n      data: this.value,\n      key: (storage?.key ??\n        DEFAULT_STORAGE_KEY) as StepSchema.inferStorageKey<def>,\n      store: storage?.store,\n      throwWhenUndefined: storage?.throwWhenUndefined,\n    });\n    this.#stepNumbers = Object.keys(this.value).map((key) =>\n      Number.parseInt(key.replace('step', ''))\n    );\n\n    this.steps = {\n      value: this.#stepNumbers as unknown as ReadonlyArray<\n        steps.StepNumbers<value>\n      >,\n      as: (asType): any => {\n        invariant(\n          typeof asType === 'string',\n          `The type of the target transformation type must be a string, was ${typeof asType}`\n        );\n\n        if (asType === 'string') {\n          return this.#stepNumbers.map((value) => `'${value}'`).join(' | ');\n        }\n\n        if (asType === 'string.keys') {\n          return this.#stepNumbers.map((value) => `'step${value}'`).join(' | ');\n        }\n\n        if (asType === 'number') {\n          return this.#stepNumbers.join(' | ');\n        }\n\n        if (asType.includes('array.string')) {\n          if (asType.includes('keys')) {\n            return this.#stepNumbers.map((value) => `step${value}`);\n          }\n\n          return this.#stepNumbers.map((value) => `${value}`);\n        }\n\n        if (asType.includes('array.number')) {\n          return this.#stepNumbers;\n        }\n\n        throw new Error(\n          `Transformation type \"${asType}\" is not supported. Available transformations include: ${AS_TYPES.map(\n            (value) => `\"${value}\"`\n          ).join(', ')}`\n        );\n      },\n      isValidStep: createIsValidStepFn(this.#stepNumbers),\n    };\n\n    this.sync();\n  }\n\n  /**\n   * @internal\n   */\n  __getStorage() {\n    return this.#storage;\n  }\n\n  getSnapshot() {\n    return this;\n  }\n\n  /**\n   * Syncs the values from storage to {@linkcode value}.\n   */\n  sync() {\n    // TODO add \"syncOptions\" so caller can chose where to sync from ('storage' | 'instance')\n    const storageValues = this.__getStorage().get();\n\n    if (storageValues) {\n      const enrichedValues = this.#internal.enrichValues(storageValues);\n\n      this.value = { ...enrichedValues };\n    }\n  }\n\n  protected notify() {\n    for (const listener of this.listeners) {\n      listener({\n        defaultNameTransformationCasing: this.defaultNameTransformationCasing,\n        original: this.original,\n        steps: this.steps,\n        value: this.value,\n      });\n    }\n  }\n\n  /**\n   * Gets the data for a specific step.\n   * @param options The options for getting the step data.\n   * @returns The step data for the target step.\n   */\n  get<stepNumber extends steps.StepNumbers<value>>(\n    options: GetStepOptions<value, steps.StepNumbers<value>, stepNumber>\n  ) {\n    return getStep(this.value)(options);\n  }\n\n  protected handlePostUpdate(next: value) {\n    this.value = { ...next };\n\n    this.__getStorage().add(this.value);\n    this.sync();\n    this.notify();\n  }\n\n  /**\n   * Updates the step with the given options.\n   * @param options The options for updating the step.\n   * @returns The return value of the updater function.\n   */\n  update<\n    targetStep extends steps.StepNumbers<value>,\n    field extends UpdateFn.chosenFields<\n      UpdateFn.resolvedStep<value, targetStep>\n    > = 'all',\n    strict extends boolean = true,\n    partial extends boolean = false,\n    additionalCtx extends Record<string, unknown> = {},\n    additionalUpdaterData extends UpdateFn.additionalUpdaterData = never,\n  >(\n    options: UpdateFn.options<\n      value,\n      targetStep,\n      field,\n      strict,\n      partial,\n      additionalCtx,\n      additionalUpdaterData\n    >\n  ) {\n    this.#internal.update(options);\n  }\n\n  reset<\n    targetStep extends steps.StepNumbers<value>,\n    fields extends UpdateFn.chosenFields<currentStep>,\n    currentStep extends UpdateFn.resolvedStep<value, targetStep>,\n  >(options: ResetFn.Options<value, targetStep, fields, currentStep>) {\n    this.#internal.reset(options);\n  }\n\n  /**\n   * Create a helper function with validated input.\n   */\n  createHelperFn<\n    const chosenSteps extends HelperFnChosenSteps.main<\n      value,\n      steps.StepNumbers<value>\n    >,\n    validator,\n    additionalCtx extends Record<string, unknown>,\n    response,\n  >(\n    options: HelperFnOptions.WithValidator<\n      value,\n      chosenSteps,\n      validator,\n      additionalCtx\n    >,\n    fn: HelperFnInput.WithValidator<\n      value,\n      chosenSteps,\n      validator,\n      additionalCtx,\n      response\n    >\n  ): HelperFnOutput.WithValidator<validator, response>;\n  /**\n   * Create a helper function without input.\n   */\n  createHelperFn<\n    const chosenSteps extends HelperFnChosenSteps.main<\n      value,\n      steps.StepNumbers<value>\n    >,\n    additionalCtx extends Record<string, unknown>,\n    response,\n  >(\n    options: HelperFnOptions.WithoutValidator<\n      value,\n      chosenSteps,\n      additionalCtx\n    >,\n    fn: HelperFnInput.WithoutValidator<\n      value,\n      chosenSteps,\n      additionalCtx,\n      response\n    >\n  ): HelperFnOutput.WithoutInput<response>;\n  // Implementation\n  createHelperFn<\n    const chosenSteps extends HelperFnChosenSteps.main<\n      value,\n      steps.StepNumbers<value>\n    >,\n    response,\n    additionalCtx extends Record<string, unknown>,\n    validator = never,\n  >(\n    options:\n      | HelperFnOptions.WithValidator<\n          value,\n          chosenSteps,\n          validator,\n          additionalCtx\n        >\n      | HelperFnOptions.WithoutValidator<value, chosenSteps, additionalCtx>,\n    fn:\n      | HelperFnInput.WithValidator<\n          value,\n          chosenSteps,\n          validator,\n          additionalCtx,\n          response\n        >\n      | HelperFnInput.WithoutValidator<\n          value,\n          chosenSteps,\n          additionalCtx,\n          response\n        >\n  ) {\n    const { stepData, ...rest } = options;\n\n    return this.#internal.createStepHelperFn(stepData)(rest, fn);\n  }\n\n  /**\n   * Validates that a given object is the proper shape for step data.\n   * @param value\n   */\n  static hasData(value: unknown): value is steps.config {\n    return steps.isValidSteps(value);\n  }\n\n  /**\n   * Gets the value of a given field for a given step.\n   * @param step The step to get the value from.\n   * @param field The field to get the value from.\n   * @returns The value of the {@linkcode field}.\n   */\n  getValue<\n    step extends steps.StepNumbers<value>,\n    field extends fields.getDeepFields<value, step>,\n  >(step: step, field: field) {\n    const stepData = this.value[step];\n    const invariant: Invariant = createInvariant('[getValue]');\n    const baseErrorMessage = `Unable to get the value for \"${String(\n      step\n    )}.fields.${String(field)}\"`;\n    const errorSuffix = \"This shouldn't be the case, so please open an issue\";\n    const createErrorMessage = (reason: string) =>\n      `${baseErrorMessage} because ${reason}. ${errorSuffix}`;\n\n    invariant(\n      typeof stepData === 'object' && stepData !== null,\n      createErrorMessage('the step data is not an object')\n    );\n    invariant(\n      'fields' in stepData,\n      createErrorMessage('the step data does not have a \"fields\" property')\n    );\n    invariant(\n      typeof stepData.fields === 'object',\n      createErrorMessage('\"fields\" is not an object')\n    );\n\n    const defaultValue = fields.resolvedDeepPath<\n      value,\n      step,\n      fields.get<value, step>,\n      field\n    >(field, stepData.fields as fields.get<value, step>);\n\n    return defaultValue;\n  }\n}\n"],"mappings":";;;;;;;;;;;;AA6GA,MAAM,cAAc,CAAC,UAAU,cAAc;AAC7C,MAAM,cAAc,CAAC,SAAS;AAC9B,MAAM,oBAAoBA,2BACxBC,2BAAW,cAAc,QAAQ,SAAS,MAAe,EACzD,uBACD;AACD,MAAM,oBAAoBA,2BACxB,cACC,QAAQ,SAAS,MACnB;;;;AAKD,MAAM,WAAW;CACf,GAAG;CACH,GAAG;CACH,GAAG;CACH,GAAG;CACJ;AAED,SAAgB,oBAGd,aAAuD;CAKvD,SAAS,YAAY,OAAwB;AAG3C,EAF6BC,kCAAgB,gBAAgB,CAG3D,OAAO,UAAU,YAAY,OAAO,UAAU,UAC9C,+CAA+C,OAAO,QACvD;AAED,MAAI,OAAO,UAAU,UAAU;AAC7B,OAAI,CAAC,MAAM,SAAS,OAAO,CACzB,QAAO;AAGT,UAAO,YAAY,SAAS,OAAO,SAAS,MAAM,QAAQ,QAAQ,GAAG,CAAC,CAAC;;AAGzE,MAAI,OAAO,UAAU,SACnB,QAAO,YAAY,SAAS,MAAM;AAGpC,SAAO;;AAGT,QAAO;;AAmBT,IAAa,0BAAb,cAIUC,kCAEV;;;;CAIE,AAAS;;;;CAIT;CACA,AAAS;CACT,AAAS;CACT,CAASC;CACT,CAASC;CAIT,CAASC;CAET,YAAY,QAAa;AACvB,SAAO;EAEP,MAAM,EAAE,gBAAO,qBAAqB,YAAY;AAEhD,OAAK,kCAAkCC,6BACrC,oBACD;AAED,OAAK,WAAWC;AAEhB,OAAK,QAAQC,+BAAiB,EAAE,gBAAO,CAAC;AACxC,QAAKH,WAAY,IAAII,oDAAgC;GACnD,eAAe,KAAK;GACpB,gBAAgB,KAAK;GACrB,WAAW,SAAS,KAAK,iBAAiB,KAAK;GAChD,CAAC;AAEF,OAAK,QAAQ,MAAKJ,SAAU,aAAa,KAAK,MAAM;AACpD,QAAKD,UAAW,IAAIM,qCAAqB;GACvC,MAAM,KAAK;GACX,KAAM,SAAS,OACbC;GACF,OAAO,SAAS;GAChB,oBAAoB,SAAS;GAC9B,CAAC;AACF,QAAKR,cAAe,OAAO,KAAK,KAAK,MAAM,CAAC,KAAK,QAC/C,OAAO,SAAS,IAAI,QAAQ,QAAQ,GAAG,CAAC,CACzC;AAED,OAAK,QAAQ;GACX,OAAO,MAAKA;GAGZ,KAAK,WAAgB;AACnB,gCACE,OAAO,WAAW,UAClB,oEAAoE,OAAO,SAC5E;AAED,QAAI,WAAW,SACb,QAAO,MAAKA,YAAa,KAAK,UAAU,IAAI,MAAM,GAAG,CAAC,KAAK,MAAM;AAGnE,QAAI,WAAW,cACb,QAAO,MAAKA,YAAa,KAAK,UAAU,QAAQ,MAAM,GAAG,CAAC,KAAK,MAAM;AAGvE,QAAI,WAAW,SACb,QAAO,MAAKA,YAAa,KAAK,MAAM;AAGtC,QAAI,OAAO,SAAS,eAAe,EAAE;AACnC,SAAI,OAAO,SAAS,OAAO,CACzB,QAAO,MAAKA,YAAa,KAAK,UAAU,OAAO,QAAQ;AAGzD,YAAO,MAAKA,YAAa,KAAK,UAAU,GAAG,QAAQ;;AAGrD,QAAI,OAAO,SAAS,eAAe,CACjC,QAAO,MAAKA;AAGd,UAAM,IAAI,MACR,wBAAwB,OAAO,yDAAyD,SAAS,KAC9F,UAAU,IAAI,MAAM,GACtB,CAAC,KAAK,KAAK,GACb;;GAEH,aAAa,oBAAoB,MAAKA,YAAa;GACpD;AAED,OAAK,MAAM;;;;;CAMb,eAAe;AACb,SAAO,MAAKC;;CAGd,cAAc;AACZ,SAAO;;;;;CAMT,OAAO;EAEL,MAAM,gBAAgB,KAAK,cAAc,CAAC,KAAK;AAE/C,MAAI,cAGF,MAAK,QAAQ,EAAE,GAFQ,MAAKC,SAAU,aAAa,cAAc,EAE/B;;CAItC,AAAU,SAAS;AACjB,OAAK,MAAM,YAAY,KAAK,UAC1B,UAAS;GACP,iCAAiC,KAAK;GACtC,UAAU,KAAK;GACf,OAAO,KAAK;GACZ,OAAO,KAAK;GACb,CAAC;;;;;;;CASN,IACE,SACA;AACA,SAAOO,sBAAQ,KAAK,MAAM,CAAC,QAAQ;;CAGrC,AAAU,iBAAiB,MAAa;AACtC,OAAK,QAAQ,EAAE,GAAG,MAAM;AAExB,OAAK,cAAc,CAAC,IAAI,KAAK,MAAM;AACnC,OAAK,MAAM;AACX,OAAK,QAAQ;;;;;;;CAQf,OAUE,SASA;AACA,QAAKP,SAAU,OAAO,QAAQ;;CAGhC,MAIE,SAAkE;AAClE,QAAKA,SAAU,MAAM,QAAQ;;CAqD/B,eASE,SAQA,IAcA;EACA,MAAM,EAAE,UAAU,GAAG,SAAS;AAE9B,SAAO,MAAKA,SAAU,mBAAmB,SAAS,CAAC,MAAM,GAAG;;;;;;CAO9D,OAAO,QAAQ,OAAuC;AACpD,SAAOE,oBAAM,aAAa,MAAM;;;;;;;;CASlC,SAGE,MAAY,OAAc;EAC1B,MAAM,WAAW,KAAK,MAAM;EAC5B,MAAMM,cAAuBZ,kCAAgB,aAAa;EAC1D,MAAM,mBAAmB,gCAAgC,OACvD,KACD,CAAC,UAAU,OAAO,MAAM,CAAC;EAC1B,MAAM,cAAc;EACpB,MAAM,sBAAsB,WAC1B,GAAG,iBAAiB,WAAW,OAAO,IAAI;AAE5C,cACE,OAAO,aAAa,YAAY,aAAa,MAC7C,mBAAmB,iCAAiC,CACrD;AACD,cACE,YAAY,UACZ,mBAAmB,oDAAkD,CACtE;AACD,cACE,OAAO,SAAS,WAAW,UAC3B,mBAAmB,8BAA4B,CAChD;AASD,SAPqBa,sBAAO,iBAK1B,OAAO,SAAS,OAAkC"}