@m4l/components 9.3.16-BE091825-beta.5 → 9.3.16-JT19092025.beta.1

package/components/Stepper/Stepper.styles.js

@@ -24,8 +24,13 @@ const stepperStyles = {
     flexDirection: ownerState?.orientation === "vertical" || theme.generalSettings.isMobile ? "column" : "row",
     gap: theme.vars.size.baseSpacings.sp8
   }),
+  /**
+   * Estilos para el contenido del paso dentro del Stepper.
+   */
   stepContent: ({ ownerState }) => ({
-    display: ownerState?.isStepVisible ? "block" : "none"
+    height: "100%",
+    display: ownerState?.isStepVisible ? "flex" : "none",
+    flexDirection: "column"
   }),
   /**
    * Estilos para la sección que contiene los botones de acción del Stepper.

package/components/Stepper/hooks/useDynamicValidation/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Hook que simula validación onChange de campos específicos del Stepper, manteniendo el formulario en modo onSubmit para preservar el rendimiento.
+ * @returns Objeto con funciones para manejar la validación dinámica
+ */
+export declare function useDynamicValidation(): {
+    activateFieldsValidation: (fields: string[]) => void;
+    clearAllValidation: () => void;
+    activeFields: string[];
+};

package/components/Stepper/hooks/useDynamicValidation/index.js

@@ -0,0 +1,57 @@
+import { useState, useRef, useEffect, useCallback } from "react";
+import { useFormContext, useWatch } from "react-hook-form";
+function useDynamicValidation() {
+  const { trigger } = useFormContext();
+  const [activeFields, setActiveFields] = useState([]);
+  const watchValues = useWatch({
+    name: activeFields.length > 0 ? activeFields : ["__dummy__"]
+  });
+  const lastValuesRef = useRef({});
+  useEffect(() => {
+    if (activeFields.length === 0) {
+      return;
+    }
+    const currentValues = activeFields.length === 1 ? { [activeFields[0]]: watchValues } : activeFields.reduce((acc, field, index) => {
+      acc[field] = Array.isArray(watchValues) ? watchValues[index] : watchValues;
+      return acc;
+    }, {});
+    const changedFields = activeFields.filter((field) => {
+      const currentValue = currentValues[field];
+      const lastValue = lastValuesRef.current[field];
+      const hasChanged = JSON.stringify(currentValue) !== JSON.stringify(lastValue);
+      if (hasChanged) {
+        lastValuesRef.current[field] = currentValue;
+      }
+      return hasChanged;
+    });
+    if (changedFields.length > 0) {
+      const timeoutId = setTimeout(() => {
+        trigger(changedFields);
+      }, 100);
+      return () => clearTimeout(timeoutId);
+    }
+  }, [activeFields, trigger, watchValues]);
+  const activateFieldsValidation = useCallback((fields) => {
+    setActiveFields((prev) => {
+      const newFields = fields.filter((field) => !prev.includes(field));
+      return [...prev, ...newFields];
+    });
+    fields.forEach((field) => {
+      if (!lastValuesRef.current.hasOwnProperty(field)) {
+        lastValuesRef.current[field] = void 0;
+      }
+    });
+  }, []);
+  const clearAllValidation = useCallback(() => {
+    setActiveFields([]);
+    lastValuesRef.current = {};
+  }, []);
+  return {
+    activateFieldsValidation,
+    clearAllValidation,
+    activeFields
+  };
+}
+export {
+  useDynamicValidation as u
+};

package/components/Stepper/hooks/useStepperActions/index.js

@@ -2,8 +2,10 @@ import { useCallback } from "react";
 import { u as useStepper } from "../useStepper/index.js";
 import { useFormContext } from "react-hook-form";
 import { shallow } from "zustand/shallow";
+import { u as useDynamicValidation } from "../useDynamicValidation/index.js";
 function useStepperActions() {
   const { trigger, clearErrors, getValues, reset } = useFormContext();
+  const { activateFieldsValidation, clearAllValidation } = useDynamicValidation();
   const {
     nextStep,
     prevStep,
@@ -41,9 +43,22 @@ function useStepperActions() {
       if (fieldsToValidate.length === 0) {
         return true;
       }
-      return await trigger(fieldsToValidate);
+      const result = await trigger(fieldsToValidate);
+      if (!result) {
+        activateFieldsValidation(fieldsToValidate);
+      }
+      return result;
     };
     const success = await nextStep(validateFn, formData);
+    if (success) {
+      const currentStepData = steps[currentStep - 1];
+      const fieldsJustValidated = currentStepData?.validationFields || [];
+      if (fieldsJustValidated.length > 0) {
+        setTimeout(() => {
+          clearAllValidation();
+        }, 100);
+      }
+    }
     if (success && futureFields.length > 0) {
       clearErrors(futureFields);
       setTimeout(() => {
@@ -62,13 +77,16 @@ function useStepperActions() {
     steps,
     currentStep,
     trigger,
-    getValues
+    getValues,
+    activateFieldsValidation,
+    clearAllValidation
   ]);
   const cancelAction = useCallback(() => {
     reset();
     clearErrors();
+    clearAllValidation();
     resetStepper();
-  }, [reset, clearErrors, resetStepper]);
+  }, [reset, clearErrors, clearAllValidation, resetStepper]);
   return { prevStepAction, nextStepAction, cancelAction };
 }
 export {

package/components/Stepper/subcomponents/StepArea/index.js

@@ -5,10 +5,12 @@ import { u as useStepper } from "../../hooks/useStepper/index.js";
 import { e as StepAreaStyled, f as StepStyled, g as StepNameStyled } from "../../slots/StepperSlot.js";
 import { I as Indicator } from "./subcomponents/Inidicator/index.js";
 import { shallow } from "zustand/shallow";
+import { u as useDynamicValidation } from "../../hooks/useDynamicValidation/index.js";
 import { e as evaluateVisibilityStepCondition } from "../../helpers/evaluateVisibilityStepCondition/index.js";
 function StepArea() {
   const { trigger, clearErrors } = useFormContext();
   const formValues = useWatch();
+  const { activateFieldsValidation } = useDynamicValidation();
   const {
     currentStep,
     steps,
@@ -64,6 +66,7 @@ function StepArea() {
         if (!isValid) {
           setCurrentStep(stepOriginalIndex);
           setStepValidationStatus(stepOriginalIndex, false);
+          activateFieldsValidation(step.validationFields || []);
           return;
         }
         setStepValidationStatus(stepOriginalIndex, true);
@@ -76,6 +79,7 @@ function StepArea() {
       const isCurrentValid = await trigger(currentStepData.validationFields);
       if (!isCurrentValid) {
         setStepValidationStatus(currentStepOriginalIndex, false);
+        activateFieldsValidation(currentStepData.validationFields || []);
         return;
       }
       setStepValidationStatus(currentStepOriginalIndex, true);

package/components/Stepper/subcomponents/StepperButtons/StepperCancelButton/index.d.ts

@@ -1,4 +1,5 @@
+import { StepperButtonProps } from '../../../types';
 /**
  * Botón modular para cancelar el proceso del Stepper
  */
-export declare function StepperCancelButton(): import("react/jsx-runtime").JSX.Element;
+export declare function StepperCancelButton(props: StepperButtonProps): import("react/jsx-runtime").JSX.Element;

package/components/Stepper/subcomponents/StepperButtons/StepperCancelButton/index.js

@@ -1,22 +1,55 @@
 import { jsx } from "react/jsx-runtime";
+import { useCallback } from "react";
+import { useFormContext, useFormState } from "react-hook-form";
 import { u as useStepperActions } from "../../../hooks/useStepperActions/index.js";
-import { D as DICTIONARY } from "../../../dictionary.js";
+import { D as DICTIONARY$1 } from "../../../dictionary.js";
+import { D as DICTIONARY } from "../../../../CommonActions/dictionary.js";
 import { useModuleDictionary } from "@m4l/core";
+import { u as useModal } from "../../../../../hooks/useModal/index.js";
+import { u as useWindowToolsMF } from "../../../../WindowBase/hooks/useWindowToolsMF/index.js";
+import { W as WindowConfirm } from "../../../../WindowConfirm/WindowConfirm.js";
 import { B as Button } from "../../../../mui_extended/Button/Button.js";
-function StepperCancelButton() {
+function StepperCancelButton(props) {
+  const { label, ...rest } = props;
   const { getLabel } = useModuleDictionary();
   const { cancelAction } = useStepperActions();
-  const handleCancel = () => {
+  const { openModal } = useModal();
+  const { close: closeWindow } = useWindowToolsMF();
+  const { control } = useFormContext();
+  const { isDirty } = useFormState({
+    control
+  });
+  const onConfirmQuit = useCallback(() => {
     cancelAction();
-  };
+    closeWindow();
+  }, [cancelAction, closeWindow]);
+  const handleCancel = useCallback(() => {
+    if (isDirty) {
+      openModal({
+        window: /* @__PURE__ */ jsx(
+          WindowConfirm,
+          {
+            variant: "warning",
+            title: getLabel(DICTIONARY.CONFIRM_QUIT_TITLE),
+            msg: getLabel(DICTIONARY.CONFIRM_QUIT_MSG),
+            onClickIntro: onConfirmQuit
+          }
+        ),
+        variant: "warning"
+      });
+    } else {
+      onConfirmQuit();
+    }
+  }, [getLabel, isDirty, openModal, onConfirmQuit]);
   return /* @__PURE__ */ jsx(
     Button,
     {
       type: "button",
-      label: getLabel(DICTIONARY.LABEL_CANCEL_BUTTON),
+      label: label || getLabel(DICTIONARY$1.LABEL_CANCEL_BUTTON),
       variant: "outlined",
       color: "default",
-      onClick: handleCancel
+      onClick: handleCancel,
+      ...rest
     }
   );
 }

package/components/Stepper/subcomponents/StepperButtons/StepperNextButton/index.d.ts

@@ -1,4 +1,5 @@
+import { StepperButtonProps } from '../../../types';
 /**
  * Botón modular para avanzar al siguiente step del Stepper
  */
-export declare function StepperNextButton(): import("react/jsx-runtime").JSX.Element;
+export declare function StepperNextButton(props: StepperButtonProps): import("react/jsx-runtime").JSX.Element;

package/components/Stepper/subcomponents/StepperButtons/StepperNextButton/index.js

@@ -6,7 +6,8 @@ import { D as DICTIONARY } from "../../../dictionary.js";
 import { useModuleDictionary, useEnvironment } from "@m4l/core";
 import { I as IconButton } from "../../../../mui_extended/IconButton/IconButton.js";
 import { B as Button } from "../../../../mui_extended/Button/Button.js";
-function StepperNextButton() {
+function StepperNextButton(props) {
+  const { label, ...rest } = props;
   const { nextStepAction } = useStepperActions();
   const isMobile = useIsMobile();
   const { getLabel } = useModuleDictionary();
@@ -28,12 +29,13 @@ function StepperNextButton() {
     Button,
     {
       type: "button",
-      label: getLabel(DICTIONARY.LABEL_NEXT_BUTTON),
+      label: label || getLabel(DICTIONARY.LABEL_NEXT_BUTTON),
       variant: "contained",
       color: "primary",
       onClick: handleNext,
       endIcon: `${host_static_assets}/${environment_assets}/${pathIcons.arrowRight}`,
-      "data-testid": "stepper-next-button"
+      "data-testid": "stepper-next-button",
+      ...rest
     }
   );
 }

package/components/Stepper/subcomponents/StepperButtons/StepperPrevButton/index.d.ts

@@ -1,4 +1,5 @@
+import { StepperButtonProps } from '../../../types';
 /**
  * Botón modular para ir al step anterior del Stepper
  */
-export declare function StepperPrevButton(): import("react/jsx-runtime").JSX.Element | null;
+export declare function StepperPrevButton(props: StepperButtonProps): import("react/jsx-runtime").JSX.Element | null;

package/components/Stepper/subcomponents/StepperButtons/StepperPrevButton/index.js

@@ -7,7 +7,8 @@ import { useIsMobile } from "@m4l/graphics";
 import { D as DICTIONARY } from "../../../dictionary.js";
 import { I as IconButton } from "../../../../mui_extended/IconButton/IconButton.js";
 import { B as Button } from "../../../../mui_extended/Button/Button.js";
-function StepperPrevButton() {
+function StepperPrevButton(props) {
+  const { label, ...rest } = props;
   const { currentStep } = useStepper((state) => ({
     currentStep: state.currentStep
   }));
@@ -35,12 +36,13 @@ function StepperPrevButton() {
     Button,
     {
       type: "button",
-      label: !isMobile ? getLabel(DICTIONARY.LABEL_PREV_BUTTON) : "",
+      label: label || getLabel(DICTIONARY.LABEL_PREV_BUTTON),
       variant: "outlined",
       color: "default",
       onClick: handlePrev,
       startIcon: `${host_static_assets}/${environment_assets}/${pathIcons.arrowLeft}`,
-      "data-testid": "stepper-prev-button"
+      "data-testid": "stepper-prev-button",
+      ...rest
     }
   );
 }

package/components/Stepper/subcomponents/StepperButtons/StepperSubmitButton/index.d.ts

@@ -1,4 +1,5 @@
+import { StepperButtonProps } from '../../../types';
 /**
  * Botón modular para finalizar el Stepper y ejecutar onFinalSubmit
  */
-export declare function StepperSubmitButton(): import("react/jsx-runtime").JSX.Element;
+export declare function StepperSubmitButton(props: StepperButtonProps): import("react/jsx-runtime").JSX.Element;

package/components/Stepper/subcomponents/StepperButtons/StepperSubmitButton/index.js

@@ -2,16 +2,18 @@ import { jsx } from "react/jsx-runtime";
 import { D as DICTIONARY } from "../../../dictionary.js";
 import { useModuleDictionary } from "@m4l/core";
 import { B as Button } from "../../../../mui_extended/Button/Button.js";
-function StepperSubmitButton() {
+function StepperSubmitButton(props) {
+  const { label, ...rest } = props;
   const { getLabel } = useModuleDictionary();
   return /* @__PURE__ */ jsx(
     Button,
     {
       type: "submit",
-      label: getLabel(DICTIONARY.LABEL_SUBMIT_BUTTON),
+      label: label || getLabel(DICTIONARY.LABEL_SUBMIT_BUTTON),
       variant: "contained",
       color: "primary",
-      "data-testid": "stepper-submit-button"
+      "data-testid": "stepper-submit-button",
+      ...rest
     }
   );
 }

package/components/Stepper/subcomponents/StepperFooter/subcomponents/StepperFooterRightActions/index.js

@@ -2,18 +2,26 @@ import { jsx, jsxs } from "react/jsx-runtime";
 import React, { useMemo } from "react";
 import { u as useIsLastVisibleValidStep } from "../../../../hooks/useIsLastVisibleValidStep/index.js";
 import { m as StepperFooterRightActionsStyled } from "../../../../slots/StepperSlot.js";
-import { S as StepperNextButton } from "../../../StepperButtons/StepperNextButton/index.js";
 import { S as StepperSubmitButton } from "../../../StepperButtons/StepperSubmitButton/index.js";
+import { S as StepperNextButton } from "../../../StepperButtons/StepperNextButton/index.js";
 function StepperFooterRightActions(props) {
   const { children } = props;
   const isLastVisibleValidStep = useIsLastVisibleValidStep();
-  const childrenWithoutNextButton = useMemo(() => {
-    if (!isLastVisibleValidStep) {
-      return children;
-    }
+  const hasCustomSubmitButton = useMemo(() => {
+    return React.Children.toArray(children).some((child) => {
+      if (React.isValidElement(child)) {
+        return child.type === StepperSubmitButton;
+      }
+      return false;
+    });
+  }, [children]);
+  const filteredChildren = useMemo(() => {
     return React.Children.toArray(children).filter((child) => {
       if (React.isValidElement(child)) {
-        if (child.type === StepperNextButton) {
+        if (!isLastVisibleValidStep && child.type === StepperSubmitButton) {
+          return false;
+        }
+        if (isLastVisibleValidStep && child.type === StepperNextButton) {
           return false;
         }
       }
@@ -21,10 +29,10 @@ function StepperFooterRightActions(props) {
     });
   }, [children, isLastVisibleValidStep]);
   const submitButton = useMemo(() => {
-    return isLastVisibleValidStep ? /* @__PURE__ */ jsx(StepperSubmitButton, {}) : null;
-  }, [isLastVisibleValidStep]);
+    return isLastVisibleValidStep && !hasCustomSubmitButton ? /* @__PURE__ */ jsx(StepperSubmitButton, {}) : null;
+  }, [isLastVisibleValidStep, hasCustomSubmitButton]);
   return /* @__PURE__ */ jsxs(StepperFooterRightActionsStyled, { children: [
-    childrenWithoutNextButton,
+    filteredChildren,
     submitButton
   ] });
 }

package/components/Stepper/types.d.ts

@@ -5,6 +5,7 @@ import { ContentAreaSlots, ContentSlots, StepperFooterSlots, StepperSlots } from
 import { STEPPER_PREFIX_NAME } from './constants';
 import { M4LOverridesStyleRules } from '../../@types/augmentations';
 import { Step as StepComponent } from './subcomponents/StepperContent/subcomponents/Step';
+import { ButtonProps } from '../mui_extended/Button';
 export type Orientation = 'horizontal' | 'vertical';
 export type IndicatorType = 'number' | 'dot';
 export type FormData = Record<string, string | number | boolean | null | undefined>;
@@ -145,6 +146,12 @@ export interface StepperFooterProps {
 export interface StepperFooterLeftActionsProps {
     children?: ReactNode;
 }
+/**
+ * Props para los botones del Stepper que extienden las props de Button de mui_extended
+ */
+export interface StepperButtonProps extends Omit<ButtonProps, 'label'> {
+    label?: string;
+}
 /**
  * Props del StepperFooterRightActions
  */

package/components/hook-form/RHFormContext/index.d.ts

@@ -3,7 +3,7 @@ import { CustomFormArguments, FormProviderCustomProps, FormProviderProps } from
 /**
  * TODO: Documentar
  */
-export declare function useCustomForm({ validationSchema, values, statusLoad, mode }: CustomFormArguments): import('react-hook-form').UseFormReturn<FieldValues, any, FieldValues>;
+export declare function useCustomForm({ validationSchema, values, statusLoad, mode, }: CustomFormArguments): import('react-hook-form').UseFormReturn<FieldValues, any, FieldValues>;
 /**
  * TODO: Documentar
  */

package/components/hook-form/RHFormContext/index.js

@@ -6,7 +6,12 @@ import { yupResolver } from "@hookform/resolvers/yup";
 import { F as FormProviderRoot } from "./styles.js";
 import { R as RHFormProviderUtilityClasses } from "./classes/index.js";
 const classes = RHFormProviderUtilityClasses();
-function useCustomForm({ validationSchema, values, statusLoad, mode }) {
+function useCustomForm({
+  validationSchema,
+  values,
+  statusLoad,
+  mode
+}) {
   const formMethods = useForm({
     resolver: yupResolver(validationSchema),
     defaultValues: values,
@@ -39,11 +44,31 @@ function useCustomForm({ validationSchema, values, statusLoad, mode }) {
 }
 function FormProviderCustom(props) {
   const { children, onSubmit, className, handleSubmit } = props;
-  return /* @__PURE__ */ jsx(FormProvider, { ...props, children: /* @__PURE__ */ jsx(FormProviderRoot, { className: clsx(classes.root, className), onSubmit: handleSubmit(onSubmit), children }) });
+  return /* @__PURE__ */ jsx(FormProvider, { ...props, children: /* @__PURE__ */ jsx(
+    FormProviderRoot,
+    {
+      className: clsx(classes.root, className),
+      onSubmit: handleSubmit(onSubmit),
+      children
+    }
+  ) });
 }
 function RHFormProvider(props) {
-  const { children, onSubmit, values, validationSchema, statusLoad = "ready", className, mode } = props;
-  const formMethods = useCustomForm({ validationSchema, statusLoad, values, mode });
+  const {
+    children,
+    onSubmit,
+    values,
+    validationSchema,
+    statusLoad = "ready",
+    className,
+    mode
+  } = props;
+  const formMethods = useCustomForm({
+    validationSchema,
+    statusLoad,
+    values,
+    mode
+  });
   return /* @__PURE__ */ jsx(
     FormProviderCustom,
     {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@m4l/components",
-  "version": "9.3.16-BE091825-beta.5",
+  "version": "9.3.16-JT19092025.beta.1",
   "license": "UNLICENSED",
   "description": "M4L Components",
   "lint-staged": {
@@ -11,7 +11,7 @@
     "@googlemaps/js-api-loader": "^1.16.6",
     "@hookform/resolvers": "2.9.11",
     "@m4l/core": "^2.0.0",
-    "@m4l/graphics": "7.1.4-BE091825-beta.5",
+    "@m4l/graphics": "^7.0.0",
     "@m4l/styles": "^7.0.0",
     "@mui/lab": "5.0.0-alpha.173",
     "@mui/material": "5.16.7",