@jfdevelops/react-multi-step-form 1.0.0-alpha.21 → 1.0.0-alpha.23

package/dist/step-schema.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"step-schema.cjs","names":["MultiStepFormStepSchemaBase","#internal","MultiStepFormStepSchemaInternal","hookResults: Record<string, unknown>","field","MultiStepFormSchemaConfig","createDefaultValues","MultiStepFormLogger","resolvedCtxCreator"],"sources":["../src/step-schema.ts"],"sourcesContent":["import {\n  type AnyStepField,\n  type CasingType,\n  type Constrain,\n  createCtx,\n  type CreateHelperFunctionOptionsBase,\n  createStep,\n  type DefaultCasing,\n  type DefaultStorageKey,\n  type Expand,\n  type GetCurrentStep,\n  type GetFieldsForStep,\n  type HelperFnChosenSteps,\n  type HelperFnCtx,\n  type HelperFnInputBase,\n  invariant,\n  MultiStepFormLogger,\n  type MultiStepFormSchemaStepConfig as MultiStepFormSchemaStepBaseConfig,\n  MultiStepFormStepSchema as MultiStepFormStepSchemaBase,\n  type Relaxed,\n  type ResetFn,\n  type ResolvedStep as ResolvedCoreStep,\n  type Step,\n  type StepNumbers,\n  type StrippedResolvedStep,\n  type UpdateFn,\n  type Updater,\n  type ValidStepKey,\n} from '@jfdevelops/multi-step-form-core';\nimport { MultiStepFormStepSchemaInternal } from '@jfdevelops/multi-step-form-core/_internals';\nimport type { ComponentPropsWithRef, ReactNode } from 'react';\nimport { field } from './field';\nimport { MultiStepFormSchemaConfig } from './form-config';\nimport { resolvedCtxCreator } from './utils';\n\nexport interface MultiStepFormSchemaStepConfig<\n  TStep extends Step<TCasing>,\n  TCasing extends CasingType,\n  TStorageKey extends string,\n  TFormAlias extends string,\n  TFormEnabledFor extends MultiStepFormSchemaConfig.formEnabledFor<TResolvedStep>,\n  TFormProps extends object,\n  TResolvedStep extends ResolvedStep<TStep, TCasing> = ResolvedStep<\n    TStep,\n    TCasing\n  >\n> extends MultiStepFormSchemaStepBaseConfig<TStep, TCasing, TStorageKey>,\n    MultiStepFormSchemaConfig.Form<\n      TResolvedStep,\n      TFormAlias,\n      TFormEnabledFor,\n      TFormProps\n    > {}\n\nexport type CreateFunction<TArgs extends any[], TReturn = void> = (\n  ...args: TArgs\n) => TReturn;\nexport type CreateComponent<TInput, TProps> = CreateFunction<\n  [input: TInput, props: TProps],\n  ReactNode\n>;\n\nexport type CreateComponentCallback<\n  TResolvedStep extends StrippedResolvedStep<AnyResolvedStep>,\n  TSteps extends StepNumbers<TResolvedStep>,\n  TChosenSteps extends HelperFnChosenSteps<TResolvedStep, TSteps>,\n  TProps\n> = CreateComponent<\n  HelperFnInputBase<TResolvedStep, TSteps, TChosenSteps>,\n  TProps\n>;\nexport type CreatedMultiStepFormComponent<TProps> = TProps extends undefined\n  ? () => ReactNode\n  : (props: TProps) => ReactNode;\nexport type CreateComponentFn<\n  TResolvedStep extends AnyResolvedStep,\n  // This is needed to make TS happy with all types\n  TStepNumbers extends StepNumbers<TResolvedStep>\n> = <\n  chosenSteps extends HelperFnChosenSteps<TResolvedStep, TStepNumbers>,\n  props = undefined\n>(\n  options: CreateHelperFunctionOptionsBase<\n    TResolvedStep,\n    TStepNumbers,\n    chosenSteps\n  >,\n  fn: CreateComponentCallback<TResolvedStep, TStepNumbers, chosenSteps, props>\n) => CreatedMultiStepFormComponent<props>;\n\nexport namespace StepSpecificComponent {\n  // The logic for getting the formCtx only works for step specific `createComponent`\n  // (i.e: step1.createComponent(...)) as of now. Reason is because I can't think of a good API for integrating the form\n  // ctx into the main `createComponent` since multiple steps can be chosen. In that case\n  // how would the logic work for when the form component should be defined in the callback?\n  // Ideas:\n  //  - Make the main `createComponent` return a function that accepts the current step\n  export type formComponent<\n    TResolvedStep extends StrippedResolvedStep<AnyResolvedStep>,\n    TSteps extends StepNumbers<TResolvedStep>,\n    TChosenSteps extends HelperFnChosenSteps<TResolvedStep, TSteps>,\n    TFormAlias extends string,\n    TFormProps extends object,\n    TFormEnabledFor extends MultiStepFormSchemaConfig.formEnabledFor<TResolvedStep>\n  > = TFormEnabledFor extends MultiStepFormSchemaConfig.defaultEnabledFor\n    ? MultiStepFormSchemaConfig.formCtx<TFormAlias, TFormProps>\n    : TFormEnabledFor extends HelperFnChosenSteps.tupleNotation<\n        ValidStepKey<TSteps>\n      >\n    ? TFormEnabledFor[number] extends keyof TResolvedStep\n      ? TChosenSteps extends HelperFnChosenSteps.tupleNotation<\n          ValidStepKey<TSteps>\n        >\n        ? TChosenSteps[number] extends keyof TResolvedStep\n          ? TChosenSteps[number] extends TFormEnabledFor[number]\n            ? MultiStepFormSchemaConfig.formCtx<TFormAlias, TFormProps>\n            : {}\n          : {}\n        : {}\n      : {}\n    : keyof TFormEnabledFor extends keyof TResolvedStep\n    ? TChosenSteps extends HelperFnChosenSteps.tupleNotation<\n        ValidStepKey<TSteps>\n      >\n      ? TChosenSteps[number] extends keyof TResolvedStep\n        ? TChosenSteps[number] extends keyof TFormEnabledFor\n          ? MultiStepFormSchemaConfig.formCtx<TFormAlias, TFormProps>\n          : {}\n        : {}\n      : {}\n    : {};\n  export type onInputChange<\n    TResolvedStep extends AnyResolvedStep,\n    TStepNumbers extends StepNumbers<TResolvedStep>,\n    TTargetStep extends TStepNumbers\n  > = <\n    CurrentStepData extends GetCurrentStep<TResolvedStep, TTargetStep>,\n    Field extends keyof CurrentStepData\n  >(\n    field: Field,\n    updater: Updater<CurrentStepData[Field], Relaxed<CurrentStepData[Field]>>\n  ) => void;\n  export type updateWrappers<\n    TResolvedStep extends StrippedResolvedStep<AnyResolvedStep>,\n    TSteps extends StepNumbers<TResolvedStep>,\n    TChosenSteps extends HelperFnChosenSteps<TResolvedStep, TSteps>,\n    TStepNumber extends HelperFnChosenSteps.extractStepNumber<\n      TResolvedStep,\n      TSteps,\n      TChosenSteps\n    >\n  > = TStepNumber extends TSteps\n    ? {\n        /**\n         * A useful wrapper around `update` to update the specific field.\n         */\n        onInputChange: UpdateFn.stepSpecific<\n          TResolvedStep,\n          TSteps,\n          ValidStepKey<TStepNumber>\n        >;\n        /**\n         * A useful wrapper for `update` to reset a specific field's value to its\n         * original config value.\n         * @resetFn\n         */\n        reset: ResetFn.stepSpecific<\n          TResolvedStep,\n          TSteps,\n          ValidStepKey<TStepNumber>\n        >;\n      }\n    : {};\n  export type input<\n    TResolvedStep extends StrippedResolvedStep<AnyResolvedStep>,\n    TSteps extends StepNumbers<TResolvedStep>,\n    TChosenSteps extends HelperFnChosenSteps<TResolvedStep, TSteps>,\n    TAdditionalCtx extends Record<string, unknown>,\n    TStepNumber extends HelperFnChosenSteps.extractStepNumber<\n      TResolvedStep,\n      TSteps,\n      TChosenSteps\n    > = HelperFnChosenSteps.extractStepNumber<\n      TResolvedStep,\n      TSteps,\n      TChosenSteps\n    >\n  > = HelperFnInputBase<\n    TResolvedStep,\n    TSteps,\n    TChosenSteps,\n    never,\n    TAdditionalCtx\n  > &\n    updateWrappers<TResolvedStep, TSteps, TChosenSteps, TStepNumber> & {\n      Field: field.component<\n        TResolvedStep,\n        ValidStepKey<\n          HelperFnChosenSteps.extractStepNumber<\n            TResolvedStep,\n            TSteps,\n            TChosenSteps\n          >\n        >\n      >;\n    };\n\n  export type callback<\n    TResolvedStep extends StrippedResolvedStep<AnyResolvedStep>,\n    TSteps extends StepNumbers<TResolvedStep>,\n    TChosenSteps extends HelperFnChosenSteps<TResolvedStep, TSteps>,\n    TProps,\n    TFormAlias extends string,\n    TFormProps extends object,\n    TFormEnabledFor extends MultiStepFormSchemaConfig.formEnabledFor<TResolvedStep>,\n    TAdditionalInput extends object,\n    TAdditionalCtx extends Record<string, unknown>\n  > = CreateComponent<\n    Expand<\n      input<TResolvedStep, TSteps, TChosenSteps, TAdditionalCtx> &\n        formComponent<\n          TResolvedStep,\n          TSteps,\n          TChosenSteps,\n          TFormAlias,\n          TFormProps,\n          TFormEnabledFor\n        > &\n        TAdditionalInput\n    >,\n    TProps\n  >;\n  export const DEFAULT_FORM_INSTANCE_ALIAS = 'form';\n  export type defaultFormInstanceAlias = typeof DEFAULT_FORM_INSTANCE_ALIAS;\n  export type formInstanceOptions<\n    TAlias extends string,\n    TRenderInput,\n    TReturn\n  > = {\n    /**\n     * The name of the return value of the `render` method.\n     */\n    alias?: TAlias;\n    /**\n     * A function that renders/creates the form instance. This function will be called\n     * at the top level of the component, ensuring hooks are called in a valid React context.\n     *\n     * @param input - The input object containing context and default values\n     * @returns The form instance (typically from a hook like `useForm`)\n     *\n     * @example\n     * ```tsx\n     * useFormInstance: {\n     *   render({ defaultValues }) {\n     *     return useForm({\n     *       defaultValues,\n     *     });\n     *   },\n     * }\n     * ```\n     *\n     * **Verification**: The hook call is automatically verified:\n     * - Errors are caught and reported with helpful messages\n     * - In development, hook calls are logged to console.debug\n     * - The hook must be called at the component top level (enforced by the framework)\n     */\n    render: CreateFunction<[input: TRenderInput], TReturn>;\n  };\n\n  export interface CtxSelector<\n    TResolvedStep extends AnyResolvedStep,\n    TSteps extends StepNumbers<TResolvedStep>,\n    TTargetStep extends HelperFnChosenSteps<TResolvedStep, TSteps>,\n    TCtx\n  > {\n    /**\n     * A function to select the data that will be available in the `fn`'s ctx.\n     * @param input The available input to create the context with.\n     * @returns The created ctx.\n     */\n    ctxData?: (\n      input: HelperFnInputBase<\n        TResolvedStep,\n        TSteps,\n        'all',\n        HelperFnChosenSteps.resolve<TResolvedStep, TSteps, TTargetStep>\n      >\n    ) => TCtx;\n  }\n\n  export type options<\n    TResolvedStep extends AnyResolvedStep,\n    TSteps extends StepNumbers<TResolvedStep>,\n    TTargetStep extends HelperFnChosenSteps<TResolvedStep, TSteps>,\n    TFormInstanceAlias extends string,\n    TFormInstance,\n    TCtx\n  > = CtxSelector<TResolvedStep, TSteps, TTargetStep, TCtx> & {\n    /**\n     * If set to `true`, you'll be able to open the {@linkcode console} to view logs.\n     */\n    debug?: boolean;\n    useFormInstance?: formInstanceOptions<\n      TFormInstanceAlias,\n      HelperFnInputBase<TResolvedStep, TSteps, TTargetStep> & {\n        /**\n         * An object containing all the default values for the current step.\n         */\n        defaultValues: Expand<\n          ExtractedDefaultValues<TResolvedStep, TSteps, TTargetStep>\n        >;\n      },\n      TFormInstance\n    >;\n  };\n}\n\nexport type CreateStepSpecificComponentCallback<\n  TResolvedStep extends StrippedResolvedStep<AnyResolvedStep>,\n  TSteps extends StepNumbers<TResolvedStep>,\n  TChosenSteps extends HelperFnChosenSteps<TResolvedStep, TSteps>,\n  TProps,\n  TFormAlias extends string,\n  TFormProps extends object,\n  TFormEnabledFor extends MultiStepFormSchemaConfig.formEnabledFor<TResolvedStep>,\n  TAdditionalInput extends object = {},\n  TAdditionalCtx extends Record<string, unknown> = {}\n> = StepSpecificComponent.callback<\n  TResolvedStep,\n  TSteps,\n  TChosenSteps,\n  TProps,\n  TFormAlias,\n  TFormProps,\n  TFormEnabledFor,\n  TAdditionalInput,\n  TAdditionalCtx\n>;\n\nexport type ExtractedDefaultValues<\n  TResolvedStep extends AnyResolvedStep,\n  TSteps extends StepNumbers<TResolvedStep>,\n  TTargetStep extends HelperFnChosenSteps<TResolvedStep, TSteps>,\n  TExtractedStepNumber extends number = HelperFnChosenSteps.extractStepNumber<\n    TResolvedStep,\n    TSteps,\n    TTargetStep\n  >,\n  TFields extends GetFieldsForStep<\n    TResolvedStep,\n    ValidStepKey<TExtractedStepNumber>\n  > = GetFieldsForStep<TResolvedStep, ValidStepKey<TExtractedStepNumber>>\n> = { [field in keyof TFields]: TFields[field]['defaultValue'] };\nexport interface StepSpecificCreateComponentFn<\n  TResolvedStep extends AnyResolvedStep,\n  TSteps extends StepNumbers<TResolvedStep>,\n  TTargetStep extends HelperFnChosenSteps<TResolvedStep, TSteps>,\n  TFormAlias extends string,\n  TFormProps extends object,\n  TFormEnabledFor extends MultiStepFormSchemaConfig.formEnabledFor<TResolvedStep>\n> {\n  /**\n   * A utility function to easily create a component for the current step.\n   * @param fn The callback function where the component is defined.\n   */\n  <props = undefined>(\n    fn: CreateStepSpecificComponentCallback<\n      TResolvedStep,\n      TSteps,\n      TTargetStep,\n      props,\n      TFormAlias,\n      TFormProps,\n      TFormEnabledFor\n    >\n  ): CreatedMultiStepFormComponent<props>;\n  /**\n   * A utility function to easily create a component for the current step.\n   * @param options Specific config options for creating a component for the current step.\n   * @param fn The callback function where the component is defined.\n   * @returns The created component.\n   */\n  <\n    formInstance,\n    additionalCtx extends Record<string, unknown> = {},\n    formInstanceAlias extends string = StepSpecificComponent.defaultFormInstanceAlias,\n    props = undefined\n  >(\n    options: StepSpecificComponent.options<\n      TResolvedStep,\n      TSteps,\n      TTargetStep,\n      formInstanceAlias,\n      formInstance,\n      additionalCtx\n    >,\n    fn: CreateStepSpecificComponentCallback<\n      TResolvedStep,\n      TSteps,\n      TTargetStep,\n      props,\n      TFormAlias,\n      TFormProps,\n      TFormEnabledFor,\n      { [_ in formInstanceAlias]: formInstance },\n      additionalCtx\n    >\n  ): CreatedMultiStepFormComponent<props>;\n}\n\nexport type ResolvedStep<\n  TStep extends Step<TDefaultCasing>,\n  TDefaultCasing extends CasingType = DefaultCasing,\n  TResolvedStep extends ResolvedCoreStep<\n    TStep,\n    TDefaultCasing\n  > = ResolvedCoreStep<TStep, TDefaultCasing>,\n  TFormAlias extends string = MultiStepFormSchemaConfig.defaultFormAlias,\n  TFormEnabledFor extends MultiStepFormSchemaConfig.formEnabledFor<TResolvedStep> = MultiStepFormSchemaConfig.defaultEnabledFor,\n  TFormProps extends object = ComponentPropsWithRef<'form'>\n> = {\n  [stepKey in keyof TResolvedStep]: TResolvedStep[stepKey] &\n    (stepKey extends ValidStepKey<StepNumbers<TResolvedStep>>\n      ? {\n          createComponent: StepSpecificCreateComponentFn<\n            TResolvedStep,\n            StepNumbers<TResolvedStep>,\n            [stepKey],\n            TFormAlias,\n            TFormProps,\n            TFormEnabledFor\n          >;\n        }\n      : {});\n};\n\nexport type AnyResolvedStep = ResolvedStep<any, any, any>;\nexport interface HelperFunctions<\n  TResolvedStep extends AnyResolvedStep,\n  TStepNumbers extends StepNumbers<TResolvedStep>\n> {\n  createComponent: CreateComponentFn<TResolvedStep, TStepNumbers>;\n}\nnamespace CreateComponentImplConfig {\n  export type stepSpecificConfig<\n    TResolvedStep extends AnyResolvedStep,\n    TFormAlias extends string,\n    TFormEnabledFor extends MultiStepFormSchemaConfig.formEnabledFor<TResolvedStep>,\n    TFormProps extends object\n  > = {\n    isStepSpecific: true;\n    defaultId: string;\n    form?: MultiStepFormSchemaConfig.FormConfig<\n      TResolvedStep,\n      TFormAlias,\n      TFormEnabledFor,\n      TFormProps\n    >;\n  };\n\n  export type nonStepSpecific = {\n    isStepSpecific: false;\n  };\n\n  export type config<\n    TResolvedStep extends AnyResolvedStep,\n    TFormAlias extends string,\n    TFormEnabledFor extends MultiStepFormSchemaConfig.formEnabledFor<TResolvedStep>,\n    TFormProps extends object\n  > =\n    | nonStepSpecific\n    | stepSpecificConfig<\n        TResolvedStep,\n        TFormAlias,\n        TFormEnabledFor,\n        TFormProps\n      >;\n}\n\n/**\n * Creates a default values object for the target step.\n * @param steps The steps schema.\n * @param targetStep The step to create the default values for.\n * @returns An object containing the field names and their default values.\n */\nexport function createDefaultValues<\n  resolvedStep extends AnyResolvedStep,\n  stepNumbers extends StepNumbers<resolvedStep>,\n  targetStep extends ValidStepKey<stepNumbers>\n>(steps: resolvedStep, targetStep: targetStep) {\n  invariant(\n    targetStep in steps,\n    `The target step ${targetStep} is not a valid step key`\n  );\n\n  const current = steps[targetStep as unknown as keyof resolvedStep];\n\n  invariant('fields' in current, `No \"fields\" were found for ${targetStep}`);\n\n  let defaultValues = {};\n\n  for (const [fieldName, fieldValues] of Object.entries(\n    current.fields as Record<string, Record<string, unknown>>\n  )) {\n    defaultValues = {\n      ...defaultValues,\n      [fieldName]: fieldValues.defaultValue,\n    };\n  }\n\n  return defaultValues as Expand<\n    ExtractedDefaultValues<resolvedStep, stepNumbers, [targetStep]>\n  >;\n}\nexport class MultiStepFormStepSchema<\n    step extends Step<casing>,\n    casing extends CasingType = DefaultCasing,\n    storageKey extends string = DefaultStorageKey,\n    formAlias extends string = MultiStepFormSchemaConfig.defaultFormAlias,\n    formEnabledFor extends MultiStepFormSchemaConfig.formEnabledFor<resolvedStep> = MultiStepFormSchemaConfig.defaultEnabledFor,\n    formProps extends object = ComponentPropsWithRef<'form'>,\n    core extends ResolvedCoreStep<step, casing> = ResolvedCoreStep<\n      step,\n      casing\n    >,\n    resolvedStep extends ResolvedStep<\n      step,\n      casing,\n      core,\n      formAlias,\n      formEnabledFor,\n      formProps\n    > = ResolvedStep<step, casing, core, formAlias, formEnabledFor, formProps>,\n    stepNumbers extends StepNumbers<resolvedStep> = StepNumbers<resolvedStep>\n  >\n  extends MultiStepFormStepSchemaBase<step, casing>\n  implements HelperFunctions<resolvedStep, stepNumbers>\n{\n  // @ts-ignore type doesn't match `MultiStepFormSchemaBase.value`\n  value: resolvedStep;\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      formAlias,\n      formEnabledFor,\n      formProps\n    >\n  ) {\n    const { form, ...rest } = config;\n\n    super(rest as never);\n\n    this.value = createStep(this.original);\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 as never),\n    });\n\n    // this.value = this.#internal.enrichValues(resolvedValues);\n    this.sync();\n    this.value = this.#internal.enrichValues(this.value, (step) => {\n      const key = `step${step as stepNumbers}`;\n      const stepData = [key] as HelperFnChosenSteps.tupleNotation<\n        ValidStepKey<stepNumbers>\n      >;\n      const id = form?.id ?? key;\n      const ctx = createCtx<\n        resolvedStep,\n        stepNumbers,\n        HelperFnChosenSteps.tupleNotation<ValidStepKey<stepNumbers>>\n      >(this.value, stepData);\n\n      return {\n        createComponent: this.createStepSpecificComponentFactory(\n          stepData,\n          {\n            isStepSpecific: true,\n            defaultId: id,\n            form: form as never,\n          },\n          ctx\n        ),\n      };\n    });\n  }\n\n  private createFormComponent(\n    form: Omit<\n      MultiStepFormSchemaConfig.FormConfig<\n        resolvedStep,\n        formAlias,\n        formEnabledFor,\n        formProps\n      >,\n      'alias'\n    >,\n    defaultId: string\n  ) {\n    const { render, enabledForSteps = 'all', id = defaultId } = form;\n\n    const ctx = {\n      id,\n      steps: createCtx(this.value, enabledForSteps as never),\n    };\n\n    return (props: formProps) => render(ctx, props);\n  }\n\n  private createStepSpecificComponentImpl<\n    chosenStep extends HelperFnChosenSteps<resolvedStep, stepNumbers>\n  >(\n    stepData: chosenStep,\n    config: CreateComponentImplConfig.stepSpecificConfig<\n      resolvedStep,\n      formAlias,\n      formEnabledFor,\n      formProps\n    >,\n    input: HelperFnInputBase<resolvedStep, stepNumbers, chosenStep>,\n    extraInput = {}\n  ) {\n    return <props>(fn: Function) =>\n      ((props: props) => {\n        // Call hook functions from extraInput at the top level of the component\n        // This ensures hooks are called in a valid React context (before any conditionals)\n        const hookResults: Record<string, unknown> = {};\n        for (const [key, value] of Object.entries(extraInput)) {\n          if (typeof value === 'function') {\n            try {\n              const result = value();\n              // Verify the hook was actually called and returned a value\n              // (hooks should always return something, even if it's undefined)\n              hookResults[key] = result;\n\n              // In development, we can add additional verification here\n              // Log hook calls for debugging (can be disabled in production by removing console.debug)\n              // if (typeof console !== 'undefined' && console.debug) {\n              //   console.debug(\n              //     `[multi-step-form] Hook \"${key}\" called successfully`,\n              //     { result: result === undefined ? 'defined' : 'undefined' }\n              //   );\n              // }\n            } catch (error) {\n              // Provide helpful error message if hook throws\n              const errorMessage =\n                error instanceof Error ? error.message : String(error);\n\n              throw new Error(\n                `[multi-step-form] Error calling hook \"${key}\" in useFormInstance.render: ${errorMessage}\\n\\n` +\n                  `This usually means:\\n` +\n                  `1. The hook is being called outside of a React component\\n` +\n                  `2. The hook has invalid dependencies or configuration\\n` +\n                  `3. There's an error in your hook implementation\\n\\n` +\n                  `Original error: ${errorMessage}`,\n                { cause: error }\n              );\n            }\n          } else {\n            hookResults[key] = value;\n          }\n        }\n\n        const { defaultId, form } = config;\n        const { ctx } = input;\n\n        // Safe cast here since the step specific `createComponent` will always have\n        // `stepData` as a tuple\n        const [step] =\n          stepData as HelperFnChosenSteps.tupleNotation<`step${stepNumbers}`>;\n\n        invariant(\n          this.steps.isValidStepKey(step),\n          `[createComponent]: the target step ${step} is invalid. Note, this error shouldn't appear as the target step should always be valid. If you see this error, please open an issue.`\n        );\n\n        const stepNumber = Number.parseInt(step.replace('step', ''));\n\n        invariant(\n          !Number.isNaN(stepNumber),\n          `[${step}:\"createComponent\"]: an error occurred while extracting the number`\n        );\n        const current = this.value[step as keyof resolvedStep];\n\n        // These checks are mostly for type safety. `current` should _always_ be in the proper format.\n        // On the off chance that it's not, we have the checks here to help, but these checks are basically\n        // just for type safety.\n        invariant(\n          'fields' in current,\n          `[${step}:createComponent]: unable to find the \"fields\" for the current step`\n        );\n        invariant(\n          typeof current.fields === 'object',\n          `[${step}:createComponent]: the \"fields\" property must be an object, was ${typeof current.fields}`\n        );\n        const stepUpdater = this.#internal.createStepUpdaterFn(step);\n\n        const Field = field.create<\n          resolvedStep,\n          HelperFnChosenSteps.resolve<resolvedStep, stepNumbers, chosenStep>\n        >((name) => {\n          const currentFields = Object.keys(\n            current.fields as Record<string, unknown>\n          );\n\n          invariant(\n            typeof name === 'string',\n            (formatter) =>\n              `[${step}:Field]: the \"name\" prop must be a string and a valid field for ${step}. Available fields include: \"${formatter.format(\n                currentFields\n              )}\"`\n          );\n          // TODO add support for deep keys (`name`)\n\n          invariant(\n            name in (current.fields as object),\n            (formatter) =>\n              `[${step}:Field]: the field \"${name}\" doesn't exist for the current step. Available fields include: \"${formatter.format(\n                currentFields\n              )}\".`\n          );\n\n          invariant(\n            'update' in current,\n            `[${step}:Field]: No \"update\" function was found`\n          );\n\n          const defaultValue = this.getValue(step as never, name as never);\n\n          const { label, nameTransformCasing, type } = (\n            current.fields as AnyStepField\n          )[name];\n          const targetFields = `fields.${name}.defaultValue`;\n\n          return {\n            defaultValue,\n            label,\n            nameTransformCasing,\n            type,\n            name,\n            onInputChange: (value: unknown) => {\n              // Handle Updater pattern: if value is a function, call it with the current field value\n              let resolvedValue;\n\n              if (typeof value === 'function') {\n                const defaultValue = this.getValue(\n                  step as never,\n                  name as never\n                );\n\n                resolvedValue = value(defaultValue);\n              } else {\n                resolvedValue = value;\n              }\n\n              this.update({\n                targetStep: step,\n                updater: resolvedValue as never,\n                fields: [targetFields] as never,\n              });\n            },\n            reset: () =>\n              this.reset({\n                fields: [targetFields] as never,\n                targetStep: step,\n              }),\n          } as never;\n        });\n\n        let fnInput = {\n          ctx,\n          onInputChange: stepUpdater,\n          reset: this.#internal.createStepResetterFn(step),\n          Field,\n          ...hookResults,\n        };\n\n        if (form) {\n          const {\n            alias = MultiStepFormSchemaConfig.DEFAULT_FORM_ALIAS,\n            ...rest\n          } = form;\n          const enabledFor = rest.enabledForSteps ?? 'all';\n\n          if (\n            MultiStepFormSchemaConfig.isFormAvailable(\n              stepData as never,\n              enabledFor as never\n            )\n          ) {\n            fnInput = {\n              ...fnInput,\n              [alias]: this.createFormComponent(rest, defaultId),\n            };\n          }\n\n          return fn(fnInput, props);\n        }\n\n        return fn(\n          {\n            ...fnInput,\n            [MultiStepFormSchemaConfig.DEFAULT_FORM_ALIAS]:\n              MultiStepFormSchemaConfig.createDefaultForm(defaultId),\n          },\n          props\n        );\n      }) as CreatedMultiStepFormComponent<props>;\n  }\n\n  private createStepSpecificComponentFactory<\n    chosenStep extends HelperFnChosenSteps.tupleNotation<\n      ValidStepKey<stepNumbers>\n    >\n  >(\n    stepData: chosenStep,\n    config: CreateComponentImplConfig.stepSpecificConfig<\n      resolvedStep,\n      formAlias,\n      formEnabledFor,\n      formProps\n    >,\n    ctx: HelperFnCtx<resolvedStep, stepNumbers, chosenStep>\n  ): StepSpecificCreateComponentFn<\n    resolvedStep,\n    stepNumbers,\n    chosenStep,\n    formAlias,\n    formProps,\n    formEnabledFor\n  > {\n    const createStepSpecificComponentImpl =\n      this.createStepSpecificComponentImpl.bind(this);\n    const createDefaultValues = this.createDefaultValues.bind(this);\n\n    // Not exactly sure why `this.value` could be undefined, but it can be so\n    // we fallback to the internal value\n    const resolvedValues = this.value;\n    const [targetStep] = stepData;\n    const update = this.#internal\n      .createStepUpdaterFn(targetStep)\n      .bind(this.#internal) as never;\n    const reset = this.#internal\n      .createStepResetterFn(targetStep)\n      .bind(this.#internal) as never;\n\n    function impl<props = undefined>(\n      fn: CreateStepSpecificComponentCallback<\n        resolvedStep,\n        stepNumbers,\n        chosenStep,\n        props,\n        formAlias,\n        formProps,\n        formEnabledFor\n      >\n    ): CreatedMultiStepFormComponent<props>;\n    function impl<\n      formInstance,\n      formInstanceAlias extends string = StepSpecificComponent.defaultFormInstanceAlias,\n      props = undefined,\n      additionalCtx = {}\n    >(\n      options: StepSpecificComponent.options<\n        resolvedStep,\n        stepNumbers,\n        chosenStep,\n        formInstanceAlias,\n        formInstance,\n        additionalCtx\n      >,\n      fn: CreateStepSpecificComponentCallback<\n        resolvedStep,\n        stepNumbers,\n        chosenStep,\n        props,\n        formAlias,\n        formProps,\n        formEnabledFor,\n        { [_ in formInstanceAlias]: formInstance }\n      >\n    ): CreatedMultiStepFormComponent<props>;\n    function impl<\n      formInstance,\n      formInstanceAlias extends string = StepSpecificComponent.defaultFormInstanceAlias,\n      props = undefined,\n      additionalCtx = {}\n    >(\n      optionsOrFn:\n        | StepSpecificComponent.options<\n            resolvedStep,\n            stepNumbers,\n            chosenStep,\n            formInstanceAlias,\n            formInstance,\n            additionalCtx\n          >\n        | CreateStepSpecificComponentCallback<\n            resolvedStep,\n            stepNumbers,\n            chosenStep,\n            props,\n            formAlias,\n            formProps,\n            formEnabledFor\n          >,\n      fn?: CreateStepSpecificComponentCallback<\n        resolvedStep,\n        stepNumbers,\n        chosenStep,\n        props,\n        formAlias,\n        formProps,\n        formEnabledFor,\n        { [_ in formInstanceAlias]: formInstance }\n      >\n    ) {\n      function createResolvedCtx(additionalCtx: unknown) {\n        return (\n          additionalCtx ? { ctx: { ...ctx, ...additionalCtx } } : { ctx }\n        ) as HelperFnInputBase<resolvedStep, stepNumbers, chosenStep>;\n      }\n\n      function createStepSpecificComponent() {\n        invariant(\n          typeof optionsOrFn === 'function',\n          'The first argument must be a function'\n        );\n\n        return createStepSpecificComponentImpl(\n          stepData,\n          config,\n          createResolvedCtx(undefined)\n        )(optionsOrFn);\n      }\n\n      if (typeof optionsOrFn === 'object') {\n        const { useFormInstance, ctxData, debug } = optionsOrFn;\n        const logger = new MultiStepFormLogger({\n          debug,\n          prefix(prefix) {\n            return `${prefix}-${targetStep}-createComponent`;\n          },\n        });\n\n        logger.info('First argument is an object');\n\n        const { [targetStep]: _, ...values } = resolvedValues;\n\n        invariant(\n          typeof fn === 'function',\n          'The second argument must be a function'\n        );\n        const createdCtx = resolvedCtxCreator(logger, values);\n\n        if (useFormInstance) {\n          const {\n            render,\n            alias = StepSpecificComponent.DEFAULT_FORM_INSTANCE_ALIAS,\n          } = useFormInstance;\n\n          // Safe cast here since the step specific `createComponent` will always have\n          // `stepData` as a tuple\n          const [step] =\n            stepData as HelperFnChosenSteps.tupleNotation<`step${stepNumbers}`>;\n\n          // Store the render function and inputs to call it at component level\n          // This ensures hooks are called in a valid React context\n          const defaultValues = createDefaultValues(step) as never;\n          const resolvedCtx = ctxData ? createdCtx({ ctx, ctxData }) : ctx;\n          const renderInput = { ctx: resolvedCtx, defaultValues };\n\n          return createStepSpecificComponentImpl(\n            stepData,\n            config,\n            {\n              ctx: resolvedCtx as never,\n              update,\n              reset,\n            },\n            {\n              [alias]: () => render(renderInput as never),\n            }\n          )(fn);\n        }\n\n        if (ctxData) {\n          const resolvedCtx = createdCtx({ ctx, ctxData });\n\n          return createStepSpecificComponentImpl(stepData, config, {\n            ctx: resolvedCtx as never,\n            update,\n            reset,\n          })(fn);\n        }\n\n        // Empty options object. Can throw here 🤷‍♂️\n        // Maybe add \"global\" - top level config - option to tune fine grained errors.\n        return createStepSpecificComponent();\n      }\n\n      return createStepSpecificComponent();\n    }\n\n    return impl;\n  }\n\n  /**\n   * A helper function to create a component for a specific step.\n   * @param options The options for creating the step specific component.\n   * @param fn A callback that is used for accessing the target step's data and defining\n   * any props that the component should have. This function must return a valid `JSX` element.\n   * @returns The created component for the step.\n   */\n  createComponent<\n    chosenSteps extends HelperFnChosenSteps<resolvedStep, stepNumbers>,\n    props = undefined\n  >(\n    options: CreateHelperFunctionOptionsBase<\n      resolvedStep,\n      stepNumbers,\n      chosenSteps\n    >,\n    fn: CreateComponentCallback<resolvedStep, stepNumbers, chosenSteps, props>\n  ) {\n    const { stepData } = options;\n    const ctx = createCtx<resolvedStep, stepNumbers, chosenSteps>(\n      this.value,\n      stepData\n    ) as never;\n\n    return ((props?: props) =>\n      fn(ctx, props as any)) as CreatedMultiStepFormComponent<props>;\n  }\n\n  createDefaultValues<targetStep extends ValidStepKey<stepNumbers>>(\n    targetStep: targetStep\n  ) {\n    return createDefaultValues(this.value, targetStep);\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"step-schema.cjs","names":["MultiStepFormStepSchemaBase","#internal","MultiStepFormStepSchemaInternal","resolvedCtxCreator","MultiStepFormLogger","getValidatedCustomInputHooks","field","createUseSelector","selector","MultiStepFormSchemaConfig","createDefaultValues"],"sources":["../src/step-schema.ts"],"sourcesContent":["import {\n  type AnyStepField,\n  type CasingType,\n  type Constrain,\n  createCtx,\n  type CreateHelperFunctionOptionsBase,\n  createStep,\n  type DefaultCasing,\n  type DefaultStorageKey,\n  type Expand,\n  type GetCurrentStep,\n  type GetFieldsForStep,\n  type HelperFnChosenSteps,\n  type HelperFnCtx,\n  type HelperFnInputBase,\n  invariant,\n  MultiStepFormLogger,\n  type MultiStepFormSchemaStepConfig as MultiStepFormSchemaStepBaseConfig,\n  MultiStepFormStepSchema as MultiStepFormStepSchemaBase,\n  type Relaxed,\n  type ResetFn,\n  type ResolvedStep as ResolvedCoreStep,\n  type Step,\n  type StepNumbers,\n  type StrippedResolvedStep,\n  type UpdateFn,\n  type Updater,\n  type ValidStepKey,\n} from '@jfdevelops/multi-step-form-core';\nimport { MultiStepFormStepSchemaInternal } from '@jfdevelops/multi-step-form-core/_internals';\nimport { type ComponentPropsWithRef, type ReactNode } from 'react';\nimport { field } from './field';\nimport { MultiStepFormSchemaConfig } from './form-config';\nimport { createUseSelector, type UseSelector } from './hooks/use-selector';\nimport { selector } from './selector';\nimport { getValidatedCustomInputHooks, resolvedCtxCreator } from './utils';\n\nexport interface MultiStepFormSchemaStepConfig<\n  TStep extends Step<TCasing>,\n  TCasing extends CasingType,\n  TStorageKey extends string,\n  TFormAlias extends string,\n  TFormEnabledFor extends MultiStepFormSchemaConfig.formEnabledFor<TResolvedStep>,\n  TFormProps extends object,\n  TResolvedStep extends ResolvedStep<TStep, TCasing> = ResolvedStep<\n    TStep,\n    TCasing\n  >\n> extends MultiStepFormSchemaStepBaseConfig<TStep, TCasing, TStorageKey>,\n    MultiStepFormSchemaConfig.Form<\n      TResolvedStep,\n      TFormAlias,\n      TFormEnabledFor,\n      TFormProps\n    > {}\n\nexport type CreateFunction<TArgs extends any[], TReturn = void> = (\n  ...args: TArgs\n) => TReturn;\nexport type CreateComponent<TInput, TProps> = CreateFunction<\n  [input: TInput, props: TProps],\n  ReactNode\n>;\n\nexport type CreateComponentCallback<\n  TResolvedStep extends StrippedResolvedStep<AnyResolvedStep>,\n  TSteps extends StepNumbers<TResolvedStep>,\n  TChosenSteps extends HelperFnChosenSteps<TResolvedStep, TSteps>,\n  TProps\n> = CreateComponent<\n  HelperFnInputBase<TResolvedStep, TSteps, TChosenSteps>,\n  TProps\n>;\nexport type CreatedMultiStepFormComponent<TProps> = TProps extends undefined\n  ? () => ReactNode\n  : (props: TProps) => ReactNode;\nexport type CreateComponentFn<\n  TResolvedStep extends AnyResolvedStep,\n  // This is needed to make TS happy with all types\n  TStepNumbers extends StepNumbers<TResolvedStep>\n> = <\n  chosenSteps extends HelperFnChosenSteps<TResolvedStep, TStepNumbers>,\n  props = undefined\n>(\n  options: CreateHelperFunctionOptionsBase<\n    TResolvedStep,\n    TStepNumbers,\n    chosenSteps\n  >,\n  fn: CreateComponentCallback<TResolvedStep, TStepNumbers, chosenSteps, props>\n) => CreatedMultiStepFormComponent<props>;\n\nexport namespace StepSpecificComponent {\n  // The logic for getting the formCtx only works for step specific `createComponent`\n  // (i.e: step1.createComponent(...)) as of now. Reason is because I can't think of a good API for integrating the form\n  // ctx into the main `createComponent` since multiple steps can be chosen. In that case\n  // how would the logic work for when the form component should be defined in the callback?\n  // Ideas:\n  //  - Make the main `createComponent` return a function that accepts the current step\n  export type formComponent<\n    TResolvedStep extends StrippedResolvedStep<AnyResolvedStep>,\n    TSteps extends StepNumbers<TResolvedStep>,\n    TChosenSteps extends HelperFnChosenSteps<TResolvedStep, TSteps>,\n    TFormAlias extends string,\n    TFormProps extends object,\n    TFormEnabledFor extends MultiStepFormSchemaConfig.formEnabledFor<TResolvedStep>\n  > = TFormEnabledFor extends MultiStepFormSchemaConfig.defaultEnabledFor\n    ? MultiStepFormSchemaConfig.formCtx<TFormAlias, TFormProps>\n    : TFormEnabledFor extends HelperFnChosenSteps.tupleNotation<\n        ValidStepKey<TSteps>\n      >\n    ? TFormEnabledFor[number] extends keyof TResolvedStep\n      ? TChosenSteps extends HelperFnChosenSteps.tupleNotation<\n          ValidStepKey<TSteps>\n        >\n        ? TChosenSteps[number] extends keyof TResolvedStep\n          ? TChosenSteps[number] extends TFormEnabledFor[number]\n            ? MultiStepFormSchemaConfig.formCtx<TFormAlias, TFormProps>\n            : {}\n          : {}\n        : {}\n      : {}\n    : keyof TFormEnabledFor extends keyof TResolvedStep\n    ? TChosenSteps extends HelperFnChosenSteps.tupleNotation<\n        ValidStepKey<TSteps>\n      >\n      ? TChosenSteps[number] extends keyof TResolvedStep\n        ? TChosenSteps[number] extends keyof TFormEnabledFor\n          ? MultiStepFormSchemaConfig.formCtx<TFormAlias, TFormProps>\n          : {}\n        : {}\n      : {}\n    : {};\n  export type onInputChange<\n    TResolvedStep extends AnyResolvedStep,\n    TStepNumbers extends StepNumbers<TResolvedStep>,\n    TTargetStep extends TStepNumbers\n  > = <\n    CurrentStepData extends GetCurrentStep<TResolvedStep, TTargetStep>,\n    Field extends keyof CurrentStepData\n  >(\n    field: Field,\n    updater: Updater<CurrentStepData[Field], Relaxed<CurrentStepData[Field]>>\n  ) => void;\n  export type updateWrappers<\n    TResolvedStep extends StrippedResolvedStep<AnyResolvedStep>,\n    TSteps extends StepNumbers<TResolvedStep>,\n    TChosenSteps extends HelperFnChosenSteps<TResolvedStep, TSteps>,\n    TStepNumber extends HelperFnChosenSteps.extractStepNumber<\n      TResolvedStep,\n      TSteps,\n      TChosenSteps\n    >\n  > = TStepNumber extends TSteps\n    ? {\n        /**\n         * A useful wrapper around `update` to update the specific field.\n         */\n        onInputChange: UpdateFn.stepSpecific<\n          TResolvedStep,\n          TSteps,\n          ValidStepKey<TStepNumber>\n        >;\n        /**\n         * A useful wrapper for `update` to reset a specific field's value to its\n         * original config value.\n         * @resetFn\n         */\n        reset: ResetFn.stepSpecific<\n          TResolvedStep,\n          TSteps,\n          ValidStepKey<TStepNumber>\n        >;\n      }\n    : {};\n  export type input<\n    TResolvedStep extends StrippedResolvedStep<AnyResolvedStep>,\n    TSteps extends StepNumbers<TResolvedStep>,\n    TChosenSteps extends HelperFnChosenSteps<TResolvedStep, TSteps>,\n    TAdditionalCtx extends Record<string, unknown>,\n    TStepNumber extends HelperFnChosenSteps.extractStepNumber<\n      TResolvedStep,\n      TSteps,\n      TChosenSteps\n    > = HelperFnChosenSteps.extractStepNumber<\n      TResolvedStep,\n      TSteps,\n      TChosenSteps\n    >\n  > = HelperFnInputBase<\n    TResolvedStep,\n    TSteps,\n    TChosenSteps,\n    never,\n    TAdditionalCtx\n  > &\n    updateWrappers<TResolvedStep, TSteps, TChosenSteps, TStepNumber> & {\n      Field: field.component<\n        TResolvedStep,\n        ValidStepKey<\n          HelperFnChosenSteps.extractStepNumber<\n            TResolvedStep,\n            TSteps,\n            TChosenSteps\n          >\n        >\n      >;\n      /**\n       * A hook for reactively selecting a value from the form context.\n       * The selector function receives the contextual data for the currently rendered step, and returns any derived value.\n       * `useSelector` will automatically provide the latest context data on updates, and will subscribe the caller for automatic re-renders when the underlying data changes.\n       *\n       * @param selector - A function that receives the current step's context and returns the selected value\n       * @returns The derived value, which will re-render the component on change\n       *\n       * @example\n       * const someValue = useSelector(ctx => ctx.fields.username.value);\n       */\n      useSelector: UseSelector<TResolvedStep, TSteps, TChosenSteps>;\n      /**\n       * A component for reactively displaying a value from the form context.\n       * Unlike `useSelector`, this component only re-renders itself, not the parent component.\n       * Use this when you want to display a reactive value without causing parent re-renders.\n       *\n       * @param selector - A function that receives the current step's context and returns the selected value\n       * @param children - Optional render prop that receives the selected value\n       *\n       * @example\n       * <Selector selector={(ctx) => ctx.step1.fields.firstName.defaultValue}>\n       *   {(value) => <p>First name: {value}</p>}\n       * </Selector>\n       */\n      Selector: selector.component<TResolvedStep, TSteps, TChosenSteps>;\n    };\n\n  export type callback<\n    TResolvedStep extends StrippedResolvedStep<AnyResolvedStep>,\n    TSteps extends StepNumbers<TResolvedStep>,\n    TChosenSteps extends HelperFnChosenSteps<TResolvedStep, TSteps>,\n    TProps,\n    TFormAlias extends string,\n    TFormProps extends object,\n    TFormEnabledFor extends MultiStepFormSchemaConfig.formEnabledFor<TResolvedStep>,\n    TAdditionalInput extends object,\n    TAdditionalCtx extends Record<string, unknown>\n  > = CreateComponent<\n    Expand<\n      input<TResolvedStep, TSteps, TChosenSteps, TAdditionalCtx> &\n        formComponent<\n          TResolvedStep,\n          TSteps,\n          TChosenSteps,\n          TFormAlias,\n          TFormProps,\n          TFormEnabledFor\n        > &\n        TAdditionalInput\n    >,\n    TProps\n  >;\n  export const DEFAULT_FORM_INSTANCE_ALIAS = 'form';\n  export type defaultFormInstanceAlias = typeof DEFAULT_FORM_INSTANCE_ALIAS;\n  export type formInstanceOptions<\n    TAlias extends string,\n    TRenderInput,\n    TReturn\n  > = {\n    /**\n     * The name of the return value of the `render` method.\n     */\n    alias?: TAlias;\n    /**\n     * A function that renders/creates the form instance. This function will be called\n     * at the top level of the component, ensuring hooks are called in a valid React context.\n     *\n     * @param input - The input object containing context and default values\n     * @returns The form instance (typically from a hook like `useForm`)\n     *\n     * @example\n     * ```tsx\n     * useFormInstance: {\n     *   render({ defaultValues }) {\n     *     return useForm({\n     *       defaultValues,\n     *     });\n     *   },\n     * }\n     * ```\n     *\n     * **Verification**: The hook call is automatically verified:\n     * - Errors are caught and reported with helpful messages\n     * - In development, hook calls are logged to console.debug\n     * - The hook must be called at the component top level (enforced by the framework)\n     */\n    render: CreateFunction<[input: TRenderInput], TReturn>;\n  };\n\n  export interface CtxSelector<\n    TResolvedStep extends AnyResolvedStep,\n    TSteps extends StepNumbers<TResolvedStep>,\n    TTargetStep extends HelperFnChosenSteps<TResolvedStep, TSteps>,\n    TCtx\n  > {\n    /**\n     * A function to select the data that will be available in the `fn`'s ctx.\n     * @param input The available input to create the context with.\n     * @returns The created ctx.\n     */\n    ctxData?: (\n      input: HelperFnInputBase<\n        TResolvedStep,\n        TSteps,\n        'all',\n        HelperFnChosenSteps.resolve<TResolvedStep, TSteps, TTargetStep>\n      >\n    ) => TCtx;\n  }\n\n  export type options<\n    TResolvedStep extends AnyResolvedStep,\n    TSteps extends StepNumbers<TResolvedStep>,\n    TTargetStep extends HelperFnChosenSteps<TResolvedStep, TSteps>,\n    TFormInstanceAlias extends string,\n    TFormInstance,\n    TCtx\n  > = CtxSelector<TResolvedStep, TSteps, TTargetStep, TCtx> & {\n    /**\n     * If set to `true`, you'll be able to open the {@linkcode console} to view logs.\n     */\n    debug?: boolean;\n    useFormInstance?: formInstanceOptions<\n      TFormInstanceAlias,\n      Pick<HelperFnInputBase<TResolvedStep, TSteps, TTargetStep>, 'ctx'> & {\n        /**\n         * An object containing all the default values for the current step.\n         */\n        defaultValues: Expand<\n          ExtractedDefaultValues<TResolvedStep, TSteps, TTargetStep>\n        >;\n      },\n      TFormInstance\n    >;\n  };\n}\n\nexport type CreateStepSpecificComponentCallback<\n  TResolvedStep extends StrippedResolvedStep<AnyResolvedStep>,\n  TSteps extends StepNumbers<TResolvedStep>,\n  TChosenSteps extends HelperFnChosenSteps<TResolvedStep, TSteps>,\n  TProps,\n  TFormAlias extends string,\n  TFormProps extends object,\n  TFormEnabledFor extends MultiStepFormSchemaConfig.formEnabledFor<TResolvedStep>,\n  TAdditionalInput extends object = {},\n  TAdditionalCtx extends Record<string, unknown> = {}\n> = StepSpecificComponent.callback<\n  TResolvedStep,\n  TSteps,\n  TChosenSteps,\n  TProps,\n  TFormAlias,\n  TFormProps,\n  TFormEnabledFor,\n  TAdditionalInput,\n  TAdditionalCtx\n>;\n\nexport type ExtractedDefaultValues<\n  TResolvedStep extends AnyResolvedStep,\n  TSteps extends StepNumbers<TResolvedStep>,\n  TTargetStep extends HelperFnChosenSteps<TResolvedStep, TSteps>,\n  TExtractedStepNumber extends number = HelperFnChosenSteps.extractStepNumber<\n    TResolvedStep,\n    TSteps,\n    TTargetStep\n  >,\n  TFields extends GetFieldsForStep<\n    TResolvedStep,\n    ValidStepKey<TExtractedStepNumber>\n  > = GetFieldsForStep<TResolvedStep, ValidStepKey<TExtractedStepNumber>>\n> = { [field in keyof TFields]: TFields[field]['defaultValue'] };\nexport interface StepSpecificCreateComponentFn<\n  TResolvedStep extends AnyResolvedStep,\n  TSteps extends StepNumbers<TResolvedStep>,\n  TTargetStep extends HelperFnChosenSteps<TResolvedStep, TSteps>,\n  TFormAlias extends string,\n  TFormProps extends object,\n  TFormEnabledFor extends MultiStepFormSchemaConfig.formEnabledFor<TResolvedStep>\n> {\n  /**\n   * A utility function to easily create a component for the current step.\n   * @param fn The callback function where the component is defined.\n   */\n  <props = undefined>(\n    fn: CreateStepSpecificComponentCallback<\n      TResolvedStep,\n      TSteps,\n      TTargetStep,\n      props,\n      TFormAlias,\n      TFormProps,\n      TFormEnabledFor\n    >\n  ): CreatedMultiStepFormComponent<props>;\n  /**\n   * A utility function to easily create a component for the current step.\n   * @param options Specific config options for creating a component for the current step.\n   * @param fn The callback function where the component is defined.\n   * @returns The created component.\n   */\n  <\n    formInstance,\n    additionalCtx extends Record<string, unknown> = {},\n    formInstanceAlias extends string = StepSpecificComponent.defaultFormInstanceAlias,\n    props = undefined\n  >(\n    options: StepSpecificComponent.options<\n      TResolvedStep,\n      TSteps,\n      TTargetStep,\n      formInstanceAlias,\n      formInstance,\n      additionalCtx\n    >,\n    fn: CreateStepSpecificComponentCallback<\n      TResolvedStep,\n      TSteps,\n      TTargetStep,\n      props,\n      TFormAlias,\n      TFormProps,\n      TFormEnabledFor,\n      { [_ in formInstanceAlias]: formInstance },\n      additionalCtx\n    >\n  ): CreatedMultiStepFormComponent<props>;\n}\n\nexport type ResolvedStep<\n  TStep extends Step<TDefaultCasing>,\n  TDefaultCasing extends CasingType = DefaultCasing,\n  TResolvedStep extends ResolvedCoreStep<\n    TStep,\n    TDefaultCasing\n  > = ResolvedCoreStep<TStep, TDefaultCasing>,\n  TFormAlias extends string = MultiStepFormSchemaConfig.defaultFormAlias,\n  TFormEnabledFor extends MultiStepFormSchemaConfig.formEnabledFor<TResolvedStep> = MultiStepFormSchemaConfig.defaultEnabledFor,\n  TFormProps extends object = ComponentPropsWithRef<'form'>\n> = {\n  [stepKey in keyof TResolvedStep]: TResolvedStep[stepKey] &\n    (stepKey extends ValidStepKey<StepNumbers<TResolvedStep>>\n      ? {\n          createComponent: StepSpecificCreateComponentFn<\n            TResolvedStep,\n            StepNumbers<TResolvedStep>,\n            [stepKey],\n            TFormAlias,\n            TFormProps,\n            TFormEnabledFor\n          >;\n        }\n      : {});\n};\n\nexport type AnyResolvedStep = ResolvedStep<any, any, any>;\nexport interface HelperFunctions<\n  TResolvedStep extends AnyResolvedStep,\n  TStepNumbers extends StepNumbers<TResolvedStep>\n> {\n  createComponent: CreateComponentFn<TResolvedStep, TStepNumbers>;\n}\nnamespace CreateComponentImplConfig {\n  export type stepSpecificConfig<\n    TResolvedStep extends AnyResolvedStep,\n    TFormAlias extends string,\n    TFormEnabledFor extends MultiStepFormSchemaConfig.formEnabledFor<TResolvedStep>,\n    TFormProps extends object\n  > = {\n    isStepSpecific: true;\n    defaultId: string;\n    form?: MultiStepFormSchemaConfig.FormConfig<\n      TResolvedStep,\n      TFormAlias,\n      TFormEnabledFor,\n      TFormProps\n    >;\n  };\n\n  export type nonStepSpecific = {\n    isStepSpecific: false;\n  };\n\n  export type config<\n    TResolvedStep extends AnyResolvedStep,\n    TFormAlias extends string,\n    TFormEnabledFor extends MultiStepFormSchemaConfig.formEnabledFor<TResolvedStep>,\n    TFormProps extends object\n  > =\n    | nonStepSpecific\n    | stepSpecificConfig<\n        TResolvedStep,\n        TFormAlias,\n        TFormEnabledFor,\n        TFormProps\n      >;\n}\n\n/**\n * Creates a default values object for the target step.\n * @param steps The steps schema.\n * @param targetStep The step to create the default values for.\n * @returns An object containing the field names and their default values.\n */\nexport function createDefaultValues<\n  resolvedStep extends AnyResolvedStep,\n  stepNumbers extends StepNumbers<resolvedStep>,\n  targetStep extends ValidStepKey<stepNumbers>\n>(steps: resolvedStep, targetStep: targetStep) {\n  invariant(\n    targetStep in steps,\n    `The target step ${targetStep} is not a valid step key`\n  );\n\n  const current = steps[targetStep as unknown as keyof resolvedStep];\n\n  invariant('fields' in current, `No \"fields\" were found for ${targetStep}`);\n\n  let defaultValues = {};\n\n  for (const [fieldName, fieldValues] of Object.entries(\n    current.fields as Record<string, Record<string, unknown>>\n  )) {\n    defaultValues = {\n      ...defaultValues,\n      [fieldName]: fieldValues.defaultValue,\n    };\n  }\n\n  return defaultValues as Expand<\n    ExtractedDefaultValues<resolvedStep, stepNumbers, [targetStep]>\n  >;\n}\nexport class MultiStepFormStepSchema<\n    step extends Step<casing>,\n    casing extends CasingType = DefaultCasing,\n    storageKey extends string = DefaultStorageKey,\n    formAlias extends string = MultiStepFormSchemaConfig.defaultFormAlias,\n    formEnabledFor extends MultiStepFormSchemaConfig.formEnabledFor<resolvedStep> = MultiStepFormSchemaConfig.defaultEnabledFor,\n    formProps extends object = ComponentPropsWithRef<'form'>,\n    core extends ResolvedCoreStep<step, casing> = ResolvedCoreStep<\n      step,\n      casing\n    >,\n    resolvedStep extends ResolvedStep<\n      step,\n      casing,\n      core,\n      formAlias,\n      formEnabledFor,\n      formProps\n    > = ResolvedStep<step, casing, core, formAlias, formEnabledFor, formProps>,\n    stepNumbers extends StepNumbers<resolvedStep> = StepNumbers<resolvedStep>\n  >\n  extends MultiStepFormStepSchemaBase<step, casing>\n  implements HelperFunctions<resolvedStep, stepNumbers>\n{\n  // @ts-ignore type doesn't match `MultiStepFormSchemaBase.value`\n  value: resolvedStep;\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      formAlias,\n      formEnabledFor,\n      formProps\n    >\n  ) {\n    const { form, ...rest } = config;\n\n    super(rest as never);\n\n    this.value = createStep(this.original);\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 as never),\n    });\n\n    // this.value = this.#internal.enrichValues(resolvedValues);\n    this.sync();\n    this.value = this.#internal.enrichValues(this.value, (step) => {\n      const key = `step${step as stepNumbers}`;\n      const stepData = [key] as HelperFnChosenSteps.tupleNotation<\n        ValidStepKey<stepNumbers>\n      >;\n      const id = form?.id ?? key;\n\n      return {\n        createComponent: this.createStepSpecificComponentFactory(stepData, {\n          isStepSpecific: true,\n          defaultId: id,\n          form: form as never,\n        }),\n      };\n    });\n  }\n\n  private createFormComponent(\n    form: Omit<\n      MultiStepFormSchemaConfig.FormConfig<\n        resolvedStep,\n        formAlias,\n        formEnabledFor,\n        formProps\n      >,\n      'alias'\n    >,\n    defaultId: string\n  ) {\n    const { render, enabledForSteps = 'all', id = defaultId } = form;\n\n    const ctx = {\n      id,\n      steps: createCtx(this.value, enabledForSteps as never),\n    };\n\n    return (props: formProps) => render(ctx, props);\n  }\n\n  private createResolvedCtx<\n    chosenStep extends HelperFnChosenSteps.tupleNotation<\n      ValidStepKey<stepNumbers>\n    >,\n    additionalCtx\n  >(\n    options: {\n      stepData: chosenStep;\n      logger: MultiStepFormLogger;\n    } & StepSpecificComponent.CtxSelector<\n      resolvedStep,\n      stepNumbers,\n      chosenStep,\n      additionalCtx\n    >\n  ) {\n    const { logger, stepData, ctxData } = options;\n    // Create ctx fresh each time to ensure it has the latest this.value\n    const ctx = createCtx<resolvedStep, stepNumbers, chosenStep>(\n      this.value,\n      stepData\n    );\n    let resolvedCtx = ctx as Expand<\n      HelperFnCtx<resolvedStep, stepNumbers, chosenStep>\n    >;\n\n    if (ctxData) {\n      const [targetStep] = stepData;\n      const { [targetStep]: _, ...values } = this.value;\n      const createResolvedCtx = resolvedCtxCreator(logger, values);\n\n      resolvedCtx = createResolvedCtx({ ctx: resolvedCtx, ctxData });\n    }\n\n    return resolvedCtx;\n  }\n\n  private createStepSpecificComponentImpl<\n    chosenStep extends HelperFnChosenSteps.tupleNotation<\n      ValidStepKey<stepNumbers>\n    >,\n    additionalCtx = {}\n  >(\n    stepData: chosenStep,\n    config: CreateComponentImplConfig.stepSpecificConfig<\n      resolvedStep,\n      formAlias,\n      formEnabledFor,\n      formProps\n    >,\n    extraConfig?: {\n      logger?: MultiStepFormLogger;\n      input?: (\n        ctx: Expand<HelperFnCtx<resolvedStep, stepNumbers, chosenStep>>\n      ) => Record<string, unknown>;\n    } & StepSpecificComponent.CtxSelector<\n      resolvedStep,\n      stepNumbers,\n      chosenStep,\n      additionalCtx\n    >\n  ) {\n    return <props>(fn: Function) =>\n      ((props: props) => {\n        const ctxData = extraConfig?.ctxData;\n        const logger = extraConfig?.logger ?? new MultiStepFormLogger();\n        const resolvedCtx = this.createResolvedCtx({\n          stepData,\n          ctxData,\n          logger,\n        });\n        const extraInput = extraConfig?.input?.(resolvedCtx) ?? {};\n        // Call hook functions from extraInput at the top level of the component\n        // This ensures hooks are called in a valid React context (before any conditionals)\n        const hookResults = getValidatedCustomInputHooks(extraInput);\n\n        const { defaultId, form } = config;\n\n        // Safe cast here since the step specific `createComponent` will always have\n        // `stepData` as a tuple\n        const [step] =\n          stepData as HelperFnChosenSteps.tupleNotation<`step${stepNumbers}`>;\n\n        invariant(\n          this.steps.isValidStepKey(step),\n          `[createComponent]: the target step ${step} is invalid. Note, this error shouldn't appear as the target step should always be valid. If you see this error, please open an issue.`\n        );\n\n        const stepNumber = Number.parseInt(step.replace('step', ''));\n\n        invariant(\n          !Number.isNaN(stepNumber),\n          `[${step}:\"createComponent\"]: an error occurred while extracting the number`\n        );\n        const current = this.value[step as keyof resolvedStep];\n\n        // These checks are mostly for type safety. `current` should _always_ be in the proper format.\n        // On the off chance that it's not, we have the checks here to help, but these checks are basically\n        // just for type safety.\n        invariant(\n          'fields' in current,\n          `[${step}:createComponent]: unable to find the \"fields\" for the current step`\n        );\n        invariant(\n          typeof current.fields === 'object',\n          `[${step}:createComponent]: the \"fields\" property must be an object, was ${typeof current.fields}`\n        );\n\n        // Memoize Field component to prevent remounting on every render\n        // This ensures input focus is maintained when ctx changes\n        const Field = field.create<\n          resolvedStep,\n          HelperFnChosenSteps.resolve<resolvedStep, stepNumbers, chosenStep>\n        >(\n          (name) => {\n            // Access current step data directly to avoid stale closure\n            const currentStep = this.value[\n              step as keyof resolvedStep\n            ] as typeof current;\n            const currentFields = Object.keys(\n              currentStep.fields as Record<string, unknown>\n            );\n\n            invariant(\n              typeof name === 'string',\n              (formatter) =>\n                `[${step}:Field]: the \"name\" prop must be a string and a valid field for ${step}. Available fields include: \"${formatter.format(\n                  currentFields\n                )}\"`\n            );\n            // TODO add support for deep keys (`name`)\n\n            invariant(\n              name in (currentStep.fields as object),\n              (formatter) =>\n                `[${step}:Field]: the field \"${name}\" doesn't exist for the current step. Available fields include: \"${formatter.format(\n                  currentFields\n                )}\".`\n            );\n\n            invariant(\n              'update' in currentStep,\n              `[${step}:Field]: No \"update\" function was found`\n            );\n\n            const defaultValue = this.getValue(step as never, name as never);\n\n            const { label, nameTransformCasing, type } = (\n              currentStep.fields as AnyStepField\n            )[name];\n            const targetFields = `fields.${name}.defaultValue`;\n\n            return {\n              defaultValue,\n              label,\n              nameTransformCasing,\n              type,\n              name,\n              onInputChange: (value: unknown) => {\n                // Handle Updater pattern: if value is a function, call it with the current field value\n                let resolvedValue;\n\n                if (typeof value === 'function') {\n                  const defaultValue = this.getValue(\n                    step as never,\n                    name as never\n                  );\n\n                  resolvedValue = value(defaultValue);\n                } else {\n                  resolvedValue = value;\n                }\n\n                this.update({\n                  targetStep: step,\n                  updater: resolvedValue as never,\n                  fields: [targetFields] as never,\n                });\n              },\n              reset: () =>\n                this.reset({\n                  fields: [targetFields] as never,\n                  targetStep: step,\n                }),\n            } as never;\n          },\n          this.subscribe,\n          (name) => this.getValue(step as never, name as never)\n        );\n\n        // Create useSelector hook for reactive value access via selector\n        // This allows getting values from ctx reactively without causing re-renders\n        // Pass a function that creates fresh ctx on each call to avoid stale closures\n        const useSelector = createUseSelector(\n          () => this.createResolvedCtx({ stepData, ctxData, logger }),\n          this.subscribe\n        );\n\n        // Create Selector component that uses useSelector internally\n        // This allows parts of the UI to subscribe to specific values without\n        // causing the parent component to re-render\n        const Selector = selector.create(\n          () => this.createResolvedCtx({ stepData, ctxData, logger }),\n          this.subscribe\n        );\n\n        let fnInput = {\n          ctx: resolvedCtx,\n          onInputChange: this.#internal.createStepUpdaterFn(step),\n          reset: this.#internal.createStepResetterFn(step),\n          Field,\n          useSelector,\n          Selector,\n          ...hookResults,\n        };\n\n        if (form) {\n          const {\n            alias = MultiStepFormSchemaConfig.DEFAULT_FORM_ALIAS,\n            ...rest\n          } = form;\n          const enabledFor = rest.enabledForSteps ?? 'all';\n\n          if (\n            MultiStepFormSchemaConfig.isFormAvailable(\n              stepData as never,\n              enabledFor as never\n            )\n          ) {\n            fnInput = {\n              ...fnInput,\n              [alias]: this.createFormComponent(rest, defaultId),\n            };\n          }\n\n          return fn(fnInput, props);\n        }\n\n        return fn(\n          {\n            ...fnInput,\n            [MultiStepFormSchemaConfig.DEFAULT_FORM_ALIAS]:\n              MultiStepFormSchemaConfig.createDefaultForm(defaultId),\n          },\n          props\n        );\n      }) as CreatedMultiStepFormComponent<props>;\n  }\n\n  private createStepSpecificComponentFactory<\n    chosenStep extends HelperFnChosenSteps.tupleNotation<\n      ValidStepKey<stepNumbers>\n    >\n  >(\n    stepData: chosenStep,\n    config: CreateComponentImplConfig.stepSpecificConfig<\n      resolvedStep,\n      formAlias,\n      formEnabledFor,\n      formProps\n    >\n    // ctx: HelperFnCtx<resolvedStep, stepNumbers, chosenStep>\n  ): StepSpecificCreateComponentFn<\n    resolvedStep,\n    stepNumbers,\n    chosenStep,\n    formAlias,\n    formProps,\n    formEnabledFor\n  > {\n    const createStepSpecificComponentImpl =\n      this.createStepSpecificComponentImpl.bind(this);\n    const createDefaultValues = this.createDefaultValues.bind(this);\n    const [targetStep] = stepData;\n\n    function impl<props = undefined>(\n      fn: CreateStepSpecificComponentCallback<\n        resolvedStep,\n        stepNumbers,\n        chosenStep,\n        props,\n        formAlias,\n        formProps,\n        formEnabledFor\n      >\n    ): CreatedMultiStepFormComponent<props>;\n    function impl<\n      formInstance,\n      formInstanceAlias extends string = StepSpecificComponent.defaultFormInstanceAlias,\n      props = undefined,\n      additionalCtx = {}\n    >(\n      options: StepSpecificComponent.options<\n        resolvedStep,\n        stepNumbers,\n        chosenStep,\n        formInstanceAlias,\n        formInstance,\n        additionalCtx\n      >,\n      fn: CreateStepSpecificComponentCallback<\n        resolvedStep,\n        stepNumbers,\n        chosenStep,\n        props,\n        formAlias,\n        formProps,\n        formEnabledFor,\n        { [_ in formInstanceAlias]: formInstance }\n      >\n    ): CreatedMultiStepFormComponent<props>;\n    function impl<\n      formInstance,\n      formInstanceAlias extends string = StepSpecificComponent.defaultFormInstanceAlias,\n      props = undefined,\n      additionalCtx = {}\n    >(\n      optionsOrFn:\n        | StepSpecificComponent.options<\n            resolvedStep,\n            stepNumbers,\n            chosenStep,\n            formInstanceAlias,\n            formInstance,\n            additionalCtx\n          >\n        | CreateStepSpecificComponentCallback<\n            resolvedStep,\n            stepNumbers,\n            chosenStep,\n            props,\n            formAlias,\n            formProps,\n            formEnabledFor\n          >,\n      fn?: CreateStepSpecificComponentCallback<\n        resolvedStep,\n        stepNumbers,\n        chosenStep,\n        props,\n        formAlias,\n        formProps,\n        formEnabledFor,\n        { [_ in formInstanceAlias]: formInstance }\n      >\n    ) {\n      function createStepSpecificComponent() {\n        invariant(\n          typeof optionsOrFn === 'function',\n          'The first argument must be a function'\n        );\n\n        return createStepSpecificComponentImpl(stepData, config)(optionsOrFn);\n      }\n\n      if (typeof optionsOrFn === 'object') {\n        const { useFormInstance, ctxData, debug } = optionsOrFn;\n        const logger = new MultiStepFormLogger({\n          debug,\n          prefix(prefix) {\n            return `${prefix}-${targetStep}-createComponent`;\n          },\n        });\n\n        logger.info('First argument is an object');\n\n        invariant(\n          typeof fn === 'function',\n          'The second argument must be a function'\n        );\n\n        if (useFormInstance) {\n          const {\n            render,\n            alias = StepSpecificComponent.DEFAULT_FORM_INSTANCE_ALIAS,\n          } = useFormInstance;\n\n          // Safe cast here since the step specific `createComponent` will always have\n          // `stepData` as a tuple\n          const [step] =\n            stepData as HelperFnChosenSteps.tupleNotation<`step${stepNumbers}`>;\n\n          return createStepSpecificComponentImpl(stepData, config, {\n            logger,\n            ctxData,\n            input: (ctx) => {\n              const defaultValues = createDefaultValues(step) as never;\n\n              return {\n                [alias]: () =>\n                  render({\n                    ctx,\n                    defaultValues,\n                  }),\n              };\n            },\n          })(fn);\n        }\n\n        if (ctxData) {\n          return createStepSpecificComponentImpl(stepData, config, {\n            logger,\n            ctxData,\n          })(fn);\n        }\n\n        // Empty options object. Can throw here 🤷‍♂️\n        // Maybe add \"global\" - top level config - option to tune fine grained errors.\n        return createStepSpecificComponent();\n      }\n\n      return createStepSpecificComponent();\n    }\n\n    return impl;\n  }\n\n  /**\n   * A helper function to create a component for a specific step.\n   * @param options The options for creating the step specific component.\n   * @param fn A callback that is used for accessing the target step's data and defining\n   * any props that the component should have. This function must return a valid `JSX` element.\n   * @returns The created component for the step.\n   */\n  createComponent<\n    chosenSteps extends HelperFnChosenSteps<resolvedStep, stepNumbers>,\n    props = undefined\n  >(\n    options: CreateHelperFunctionOptionsBase<\n      resolvedStep,\n      stepNumbers,\n      chosenSteps\n    >,\n    fn: CreateComponentCallback<resolvedStep, stepNumbers, chosenSteps, props>\n  ) {\n    const { stepData } = options;\n    const ctx = createCtx<resolvedStep, stepNumbers, chosenSteps>(\n      this.value,\n      stepData\n    ) as never;\n\n    return ((props?: props) =>\n      fn(ctx, props as any)) as CreatedMultiStepFormComponent<props>;\n  }\n\n  createDefaultValues<targetStep extends ValidStepKey<stepNumbers>>(\n    targetStep: targetStep\n  ) {\n    return createDefaultValues(this.value, targetStep);\n  }\n}\n"],"mappings":"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"}

package/dist/step-schema.d.cts

@@ -1,4 +1,6 @@
 import { field } from "./field.cjs";
+import { UseSelector } from "./hooks/use-selector.cjs";
+import { selector } from "./selector.cjs";
 import { MultiStepFormSchemaConfig } from "./form-config.cjs";
 import * as _jfdevelops_multi_step_form_core0 from "@jfdevelops/multi-step-form-core";
 import { CasingType, Constrain, CreateHelperFunctionOptionsBase, DefaultCasing, DefaultStorageKey, Expand, GetCurrentStep, GetFieldsForStep, HelperFnChosenSteps, HelperFnInputBase, MultiStepFormSchemaStepConfig, MultiStepFormStepSchema, Relaxed, ResetFn, ResolvedStep, Step, StepNumbers, StrippedResolvedStep, UpdateFn, Updater, ValidStepKey } from "@jfdevelops/multi-step-form-core";
@@ -28,6 +30,32 @@ declare namespace StepSpecificComponent {
   } : {};
   type input<TResolvedStep extends StrippedResolvedStep<AnyResolvedStep$1>, TSteps extends StepNumbers<TResolvedStep>, TChosenSteps extends HelperFnChosenSteps<TResolvedStep, TSteps>, TAdditionalCtx extends Record<string, unknown>, TStepNumber extends HelperFnChosenSteps.extractStepNumber<TResolvedStep, TSteps, TChosenSteps> = HelperFnChosenSteps.extractStepNumber<TResolvedStep, TSteps, TChosenSteps>> = HelperFnInputBase<TResolvedStep, TSteps, TChosenSteps, never, TAdditionalCtx> & updateWrappers<TResolvedStep, TSteps, TChosenSteps, TStepNumber> & {
     Field: field.component<TResolvedStep, ValidStepKey<HelperFnChosenSteps.extractStepNumber<TResolvedStep, TSteps, TChosenSteps>>>;
+    /**
+     * A hook for reactively selecting a value from the form context.
+     * The selector function receives the contextual data for the currently rendered step, and returns any derived value.
+     * `useSelector` will automatically provide the latest context data on updates, and will subscribe the caller for automatic re-renders when the underlying data changes.
+     *
+     * @param selector - A function that receives the current step's context and returns the selected value
+     * @returns The derived value, which will re-render the component on change
+     *
+     * @example
+     * const someValue = useSelector(ctx => ctx.fields.username.value);
+     */
+    useSelector: UseSelector<TResolvedStep, TSteps, TChosenSteps>;
+    /**
+     * A component for reactively displaying a value from the form context.
+     * Unlike `useSelector`, this component only re-renders itself, not the parent component.
+     * Use this when you want to display a reactive value without causing parent re-renders.
+     *
+     * @param selector - A function that receives the current step's context and returns the selected value
+     * @param children - Optional render prop that receives the selected value
+     *
+     * @example
+     * <Selector selector={(ctx) => ctx.step1.fields.firstName.defaultValue}>
+     *   {(value) => <p>First name: {value}</p>}
+     * </Selector>
+     */
+    Selector: selector.component<TResolvedStep, TSteps, TChosenSteps>;
   };
   type callback<TResolvedStep extends StrippedResolvedStep<AnyResolvedStep$1>, TSteps extends StepNumbers<TResolvedStep>, TChosenSteps extends HelperFnChosenSteps<TResolvedStep, TSteps>, TProps, TFormAlias extends string, TFormProps extends object, TFormEnabledFor extends MultiStepFormSchemaConfig.formEnabledFor<TResolvedStep>, TAdditionalInput extends object, TAdditionalCtx extends Record<string, unknown>> = CreateComponent<Expand<input<TResolvedStep, TSteps, TChosenSteps, TAdditionalCtx> & formComponent<TResolvedStep, TSteps, TChosenSteps, TFormAlias, TFormProps, TFormEnabledFor> & TAdditionalInput>, TProps>;
   const DEFAULT_FORM_INSTANCE_ALIAS = "form";
@@ -75,7 +103,7 @@ declare namespace StepSpecificComponent {
      * If set to `true`, you'll be able to open the {@linkcode console} to view logs.
      */
     debug?: boolean;
-    useFormInstance?: formInstanceOptions<TFormInstanceAlias, HelperFnInputBase<TResolvedStep, TSteps, TTargetStep> & {
+    useFormInstance?: formInstanceOptions<TFormInstanceAlias, Pick<HelperFnInputBase<TResolvedStep, TSteps, TTargetStep>, 'ctx'> & {
       /**
        * An object containing all the default values for the current step.
        */
@@ -118,6 +146,7 @@ declare class MultiStepFormStepSchema$1<step extends Step<casing>, casing extend
   value: resolvedStep;
   constructor(config: MultiStepFormSchemaStepConfig$1<step, Constrain<casing, CasingType>, storageKey, formAlias, formEnabledFor, formProps>);
   private createFormComponent;
+  private createResolvedCtx;
   private createStepSpecificComponentImpl;
   private createStepSpecificComponentFactory;
   /**

package/dist/step-schema.d.mts

@@ -1,4 +1,6 @@
 import { field } from "./field.mjs";
+import { UseSelector } from "./hooks/use-selector.mjs";
+import { selector } from "./selector.mjs";
 import { MultiStepFormSchemaConfig } from "./form-config.mjs";
 import * as _jfdevelops_multi_step_form_core0 from "@jfdevelops/multi-step-form-core";
 import { CasingType, Constrain, CreateHelperFunctionOptionsBase, DefaultCasing, DefaultStorageKey, Expand, GetCurrentStep, GetFieldsForStep, HelperFnChosenSteps, HelperFnInputBase, MultiStepFormSchemaStepConfig, MultiStepFormStepSchema, Relaxed, ResetFn, ResolvedStep, Step, StepNumbers, StrippedResolvedStep, UpdateFn, Updater, ValidStepKey } from "@jfdevelops/multi-step-form-core";
@@ -28,6 +30,32 @@ declare namespace StepSpecificComponent {
   } : {};
   type input<TResolvedStep extends StrippedResolvedStep<AnyResolvedStep$1>, TSteps extends StepNumbers<TResolvedStep>, TChosenSteps extends HelperFnChosenSteps<TResolvedStep, TSteps>, TAdditionalCtx extends Record<string, unknown>, TStepNumber extends HelperFnChosenSteps.extractStepNumber<TResolvedStep, TSteps, TChosenSteps> = HelperFnChosenSteps.extractStepNumber<TResolvedStep, TSteps, TChosenSteps>> = HelperFnInputBase<TResolvedStep, TSteps, TChosenSteps, never, TAdditionalCtx> & updateWrappers<TResolvedStep, TSteps, TChosenSteps, TStepNumber> & {
     Field: field.component<TResolvedStep, ValidStepKey<HelperFnChosenSteps.extractStepNumber<TResolvedStep, TSteps, TChosenSteps>>>;
+    /**
+     * A hook for reactively selecting a value from the form context.
+     * The selector function receives the contextual data for the currently rendered step, and returns any derived value.
+     * `useSelector` will automatically provide the latest context data on updates, and will subscribe the caller for automatic re-renders when the underlying data changes.
+     *
+     * @param selector - A function that receives the current step's context and returns the selected value
+     * @returns The derived value, which will re-render the component on change
+     *
+     * @example
+     * const someValue = useSelector(ctx => ctx.fields.username.value);
+     */
+    useSelector: UseSelector<TResolvedStep, TSteps, TChosenSteps>;
+    /**
+     * A component for reactively displaying a value from the form context.
+     * Unlike `useSelector`, this component only re-renders itself, not the parent component.
+     * Use this when you want to display a reactive value without causing parent re-renders.
+     *
+     * @param selector - A function that receives the current step's context and returns the selected value
+     * @param children - Optional render prop that receives the selected value
+     *
+     * @example
+     * <Selector selector={(ctx) => ctx.step1.fields.firstName.defaultValue}>
+     *   {(value) => <p>First name: {value}</p>}
+     * </Selector>
+     */
+    Selector: selector.component<TResolvedStep, TSteps, TChosenSteps>;
   };
   type callback<TResolvedStep extends StrippedResolvedStep<AnyResolvedStep$1>, TSteps extends StepNumbers<TResolvedStep>, TChosenSteps extends HelperFnChosenSteps<TResolvedStep, TSteps>, TProps, TFormAlias extends string, TFormProps extends object, TFormEnabledFor extends MultiStepFormSchemaConfig.formEnabledFor<TResolvedStep>, TAdditionalInput extends object, TAdditionalCtx extends Record<string, unknown>> = CreateComponent<Expand<input<TResolvedStep, TSteps, TChosenSteps, TAdditionalCtx> & formComponent<TResolvedStep, TSteps, TChosenSteps, TFormAlias, TFormProps, TFormEnabledFor> & TAdditionalInput>, TProps>;
   const DEFAULT_FORM_INSTANCE_ALIAS = "form";
@@ -75,7 +103,7 @@ declare namespace StepSpecificComponent {
      * If set to `true`, you'll be able to open the {@linkcode console} to view logs.
      */
     debug?: boolean;
-    useFormInstance?: formInstanceOptions<TFormInstanceAlias, HelperFnInputBase<TResolvedStep, TSteps, TTargetStep> & {
+    useFormInstance?: formInstanceOptions<TFormInstanceAlias, Pick<HelperFnInputBase<TResolvedStep, TSteps, TTargetStep>, 'ctx'> & {
       /**
        * An object containing all the default values for the current step.
        */
@@ -118,6 +146,7 @@ declare class MultiStepFormStepSchema$1<step extends Step<casing>, casing extend
   value: resolvedStep;
   constructor(config: MultiStepFormSchemaStepConfig$1<step, Constrain<casing, CasingType>, storageKey, formAlias, formEnabledFor, formProps>);
   private createFormComponent;
+  private createResolvedCtx;
   private createStepSpecificComponentImpl;
   private createStepSpecificComponentFactory;
   /**

package/dist/step-schema.mjs

@@ -1,6 +1,8 @@
 import { field } from "./field.mjs";
 import { MultiStepFormSchemaConfig } from "./form-config.mjs";
-import { resolvedCtxCreator } from "./utils.mjs";
+import { createUseSelector } from "./hooks/use-selector.mjs";
+import { selector } from "./selector.mjs";
+import { getValidatedCustomInputHooks, resolvedCtxCreator } from "./utils.mjs";
 import { MultiStepFormLogger, MultiStepFormStepSchema, createCtx, createStep, invariant } from "@jfdevelops/multi-step-form-core";
 import { MultiStepFormStepSchemaInternal } from "@jfdevelops/multi-step-form-core/_internals";
 
@@ -43,12 +45,11 @@ var MultiStepFormStepSchema$1 = class extends MultiStepFormStepSchema {
 			const key = `step${step}`;
 			const stepData = [key];
 			const id = form?.id ?? key;
-			const ctx = createCtx(this.value, stepData);
 			return { createComponent: this.createStepSpecificComponentFactory(stepData, {
 				isStepSpecific: true,
 				defaultId: id,
 				form
-			}, ctx) };
+			}) };
 		});
 	}
 	createFormComponent(form, defaultId) {
@@ -59,18 +60,30 @@ var MultiStepFormStepSchema$1 = class extends MultiStepFormStepSchema {
 		};
 		return (props) => render(ctx, props);
 	}
-	createStepSpecificComponentImpl(stepData, config, input, extraInput = {}) {
+	createResolvedCtx(options) {
+		const { logger, stepData, ctxData } = options;
+		let resolvedCtx = createCtx(this.value, stepData);
+		if (ctxData) {
+			const [targetStep] = stepData;
+			const { [targetStep]: _, ...values } = this.value;
+			resolvedCtx = resolvedCtxCreator(logger, values)({
+				ctx: resolvedCtx,
+				ctxData
+			});
+		}
+		return resolvedCtx;
+	}
+	createStepSpecificComponentImpl(stepData, config, extraConfig) {
 		return (fn) => ((props) => {
-			const hookResults = {};
-			for (const [key, value] of Object.entries(extraInput)) if (typeof value === "function") try {
-				hookResults[key] = value();
-			} catch (error) {
-				const errorMessage = error instanceof Error ? error.message : String(error);
-				throw new Error(`[multi-step-form] Error calling hook "${key}" in useFormInstance.render: ${errorMessage}\n\nThis usually means:\n1. The hook is being called outside of a React component\n2. The hook has invalid dependencies or configuration\n3. There's an error in your hook implementation\n\nOriginal error: ${errorMessage}`, { cause: error });
-			}
-			else hookResults[key] = value;
+			const ctxData = extraConfig?.ctxData;
+			const logger = extraConfig?.logger ?? new MultiStepFormLogger();
+			const resolvedCtx = this.createResolvedCtx({
+				stepData,
+				ctxData,
+				logger
+			});
+			const hookResults = getValidatedCustomInputHooks(extraConfig?.input?.(resolvedCtx) ?? {});
 			const { defaultId, form } = config;
-			const { ctx } = input;
 			const [step] = stepData;
 			invariant(this.steps.isValidStepKey(step), `[createComponent]: the target step ${step} is invalid. Note, this error shouldn't appear as the target step should always be valid. If you see this error, please open an issue.`);
 			const stepNumber = Number.parseInt(step.replace("step", ""));
@@ -78,14 +91,14 @@ var MultiStepFormStepSchema$1 = class extends MultiStepFormStepSchema {
 			const current = this.value[step];
 			invariant("fields" in current, `[${step}:createComponent]: unable to find the "fields" for the current step`);
 			invariant(typeof current.fields === "object", `[${step}:createComponent]: the "fields" property must be an object, was ${typeof current.fields}`);
-			const stepUpdater = this.#internal.createStepUpdaterFn(step);
 			const Field = field.create((name) => {
-				const currentFields = Object.keys(current.fields);
+				const currentStep = this.value[step];
+				const currentFields = Object.keys(currentStep.fields);
 				invariant(typeof name === "string", (formatter) => `[${step}:Field]: the "name" prop must be a string and a valid field for ${step}. Available fields include: "${formatter.format(currentFields)}"`);
-				invariant(name in current.fields, (formatter) => `[${step}:Field]: the field "${name}" doesn't exist for the current step. Available fields include: "${formatter.format(currentFields)}".`);
-				invariant("update" in current, `[${step}:Field]: No "update" function was found`);
+				invariant(name in currentStep.fields, (formatter) => `[${step}:Field]: the field "${name}" doesn't exist for the current step. Available fields include: "${formatter.format(currentFields)}".`);
+				invariant("update" in currentStep, `[${step}:Field]: No "update" function was found`);
 				const defaultValue = this.getValue(step, name);
-				const { label, nameTransformCasing, type } = current.fields[name];
+				const { label, nameTransformCasing, type } = currentStep.fields[name];
 				const targetFields = `fields.${name}.defaultValue`;
 				return {
 					defaultValue,
@@ -108,12 +121,24 @@ var MultiStepFormStepSchema$1 = class extends MultiStepFormStepSchema {
 						targetStep: step
 					})
 				};
-			});
+			}, this.subscribe, (name) => this.getValue(step, name));
+			const useSelector = createUseSelector(() => this.createResolvedCtx({
+				stepData,
+				ctxData,
+				logger
+			}), this.subscribe);
+			const Selector = selector.create(() => this.createResolvedCtx({
+				stepData,
+				ctxData,
+				logger
+			}), this.subscribe);
 			let fnInput = {
-				ctx,
-				onInputChange: stepUpdater,
+				ctx: resolvedCtx,
+				onInputChange: this.#internal.createStepUpdaterFn(step),
 				reset: this.#internal.createStepResetterFn(step),
 				Field,
+				useSelector,
+				Selector,
 				...hookResults
 			};
 			if (form) {
@@ -131,23 +156,14 @@ var MultiStepFormStepSchema$1 = class extends MultiStepFormStepSchema {
 			}, props);
 		});
 	}
-	createStepSpecificComponentFactory(stepData, config, ctx) {
+	createStepSpecificComponentFactory(stepData, config) {
 		const createStepSpecificComponentImpl = this.createStepSpecificComponentImpl.bind(this);
 		const createDefaultValues$1 = this.createDefaultValues.bind(this);
-		const resolvedValues = this.value;
 		const [targetStep] = stepData;
-		const update = this.#internal.createStepUpdaterFn(targetStep).bind(this.#internal);
-		const reset = this.#internal.createStepResetterFn(targetStep).bind(this.#internal);
 		function impl(optionsOrFn, fn) {
-			function createResolvedCtx(additionalCtx) {
-				return additionalCtx ? { ctx: {
-					...ctx,
-					...additionalCtx
-				} } : { ctx };
-			}
 			function createStepSpecificComponent() {
 				invariant(typeof optionsOrFn === "function", "The first argument must be a function");
-				return createStepSpecificComponentImpl(stepData, config, createResolvedCtx(void 0))(optionsOrFn);
+				return createStepSpecificComponentImpl(stepData, config)(optionsOrFn);
 			}
 			if (typeof optionsOrFn === "object") {
 				const { useFormInstance, ctxData, debug } = optionsOrFn;
@@ -158,34 +174,25 @@ var MultiStepFormStepSchema$1 = class extends MultiStepFormStepSchema {
 					}
 				});
 				logger.info("First argument is an object");
-				const { [targetStep]: _, ...values } = resolvedValues;
 				invariant(typeof fn === "function", "The second argument must be a function");
-				const createdCtx = resolvedCtxCreator(logger, values);
 				if (useFormInstance) {
 					const { render, alias = StepSpecificComponent.DEFAULT_FORM_INSTANCE_ALIAS } = useFormInstance;
 					const [step] = stepData;
-					const defaultValues = createDefaultValues$1(step);
-					const resolvedCtx = ctxData ? createdCtx({
-						ctx,
-						ctxData
-					}) : ctx;
-					const renderInput = {
-						ctx: resolvedCtx,
-						defaultValues
-					};
 					return createStepSpecificComponentImpl(stepData, config, {
-						ctx: resolvedCtx,
-						update,
-						reset
-					}, { [alias]: () => render(renderInput) })(fn);
+						logger,
+						ctxData,
+						input: (ctx) => {
+							const defaultValues = createDefaultValues$1(step);
+							return { [alias]: () => render({
+								ctx,
+								defaultValues
+							}) };
+						}
+					})(fn);
 				}
 				if (ctxData) return createStepSpecificComponentImpl(stepData, config, {
-					ctx: createdCtx({
-						ctx,
-						ctxData
-					}),
-					update,
-					reset
+					logger,
+					ctxData
 				})(fn);
 				return createStepSpecificComponent();
 			}