@soyfri/shared-library 1.5.0-beta.4 → 1.6.0-beta.0

package/components/Stepper/Stepper.cjs

@@ -1,46 +1,302 @@
 "use strict";
-Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+Object.defineProperties(exports, { __esModule: { value: true }, [Symbol.toStringTag]: { value: "Module" } });
 const jsxRuntime = require("react/jsx-runtime");
+const React = require("react");
 const material = require("@mui/material");
+const ChevronLeftIcon = require("@mui/icons-material/ChevronLeft");
+const ChevronRightIcon = require("@mui/icons-material/ChevronRight");
+const defaultValue = {
+  currentStep: 0,
+  totalSteps: 0,
+  isFirst: true,
+  isLast: true,
+  completed: false,
+  nextStep: () => {
+  },
+  prevStep: () => {
+  },
+  goToStep: () => {
+  },
+  submitStep: () => {
+  },
+  reset: () => {
+  }
+};
+const StepperContext = React.createContext(defaultValue);
+function useStepper() {
+  return React.useContext(StepperContext);
+}
+const StepperProvider = ({
+  totalSteps,
+  initialStep = 0,
+  onSubmit,
+  onStepChange,
+  children
+}) => {
+  const [currentStep, setCurrentStep] = React.useState(initialStep);
+  const [completed, setCompleted] = React.useState(false);
+  const changeStep = React.useCallback(
+    (newStep) => {
+      setCurrentStep((prev) => {
+        if (newStep === prev) return prev;
+        if (newStep < 0 || newStep >= totalSteps) return prev;
+        onStepChange == null ? void 0 : onStepChange(newStep, prev);
+        return newStep;
+      });
+    },
+    [totalSteps, onStepChange]
+  );
+  const nextStep = React.useCallback(() => {
+    changeStep(currentStep + 1);
+  }, [changeStep, currentStep]);
+  const prevStep = React.useCallback(() => {
+    changeStep(currentStep - 1);
+  }, [changeStep, currentStep]);
+  const goToStep = React.useCallback(
+    (stepNumber) => {
+      changeStep(stepNumber);
+    },
+    [changeStep]
+  );
+  const submitStep = React.useCallback(() => {
+    setCompleted(true);
+    onSubmit == null ? void 0 : onSubmit(currentStep);
+  }, [currentStep, onSubmit]);
+  const reset = React.useCallback(() => {
+    setCurrentStep(initialStep);
+    setCompleted(false);
+  }, [initialStep]);
+  const value = React.useMemo(
+    () => ({
+      currentStep,
+      totalSteps,
+      isFirst: currentStep === 0,
+      isLast: currentStep === totalSteps - 1,
+      completed,
+      nextStep,
+      prevStep,
+      goToStep,
+      submitStep,
+      reset
+    }),
+    [
+      currentStep,
+      totalSteps,
+      completed,
+      nextStep,
+      prevStep,
+      goToStep,
+      submitStep,
+      reset
+    ]
+  );
+  return /* @__PURE__ */ jsxRuntime.jsx(StepperContext.Provider, { value, children });
+};
+function useHorizontalScroll(enabled, deps = []) {
+  const scrollRef = React.useRef(null);
+  const [canScrollLeft, setCanScrollLeft] = React.useState(false);
+  const [canScrollRight, setCanScrollRight] = React.useState(false);
+  const updateScrollState = React.useCallback(() => {
+    const el = scrollRef.current;
+    if (!el) return;
+    const { scrollLeft, scrollWidth, clientWidth } = el;
+    setCanScrollLeft(scrollLeft > 1);
+    setCanScrollRight(scrollLeft + clientWidth < scrollWidth - 1);
+  }, []);
+  React.useLayoutEffect(() => {
+    if (!enabled) return;
+    updateScrollState();
+  }, [enabled, updateScrollState, ...deps]);
+  React.useEffect(() => {
+    if (!enabled) return;
+    const el = scrollRef.current;
+    if (!el) return;
+    el.addEventListener("scroll", updateScrollState, { passive: true });
+    const ro = new ResizeObserver(updateScrollState);
+    ro.observe(el);
+    return () => {
+      el.removeEventListener("scroll", updateScrollState);
+      ro.disconnect();
+    };
+  }, [enabled, updateScrollState]);
+  const scrollBy = React.useCallback((delta) => {
+    const el = scrollRef.current;
+    if (!el) return;
+    el.scrollBy({ left: delta, behavior: "smooth" });
+  }, []);
+  return { scrollRef, canScrollLeft, canScrollRight, scrollBy };
+}
+const StepperScrollArrow = ({
+  direction,
+  enabled,
+  visible,
+  onClick
+}) => {
+  const isLeft = direction === "left";
+  const Icon = isLeft ? ChevronLeftIcon : ChevronRightIcon;
+  const ariaLabel = isLeft ? "Anterior" : "Siguiente";
+  return /* @__PURE__ */ jsxRuntime.jsx(
+    material.IconButton,
+    {
+      "aria-label": ariaLabel,
+      size: "small",
+      onClick,
+      disabled: !enabled,
+      sx: {
+        flex: "0 0 auto",
+        // Reservamos el slot siempre que haya overflow en algún lado,
+        // así el área scroll tiene un ancho estable (no saltan los
+        // steps cuando aparece/desaparece la flecha).
+        visibility: visible ? "visible" : "hidden"
+      },
+      children: /* @__PURE__ */ jsxRuntime.jsx(Icon, { fontSize: "small" })
+    }
+  );
+};
 const Stepper = ({
   children,
   orientation = "horizontal",
   alternateLabel = false,
-  sx,
-  currentStep = 0
+  currentStep: currentStepProp,
+  keepMounted = false,
+  sx
 }) => {
+  const stepperCtx = useStepper();
+  const currentStep = currentStepProp !== void 0 ? currentStepProp : stepperCtx.totalSteps > 0 ? stepperCtx.currentStep : 0;
+  const isHorizontal = orientation === "horizontal";
+  const steps = React.Children.toArray(children).filter(
+    (child) => {
+      var _a;
+      return React.isValidElement(child) && ((_a = child.type) == null ? void 0 : _a.displayName) === "Step";
+    }
+  );
+  const { scrollRef, canScrollLeft, canScrollRight, scrollBy } = useHorizontalScroll(
+    isHorizontal,
+    [steps.length, currentStep]
+  );
+  const showArrows = isHorizontal && (canScrollLeft || canScrollRight);
   return /* @__PURE__ */ jsxRuntime.jsxs(material.Box, { sx, children: [
-    /* @__PURE__ */ jsxRuntime.jsx(material.Stepper, { activeStep: currentStep, orientation, alternativeLabel: alternateLabel, children: children.map((child, idx) => {
-      const { label, completed, disabled, className, sx: stepSx, dotColor, activeDotColor, completedDotColor, iconTextColor } = child.props;
-      return /* @__PURE__ */ jsxRuntime.jsx(material.Step, { completed, disabled, className, sx: stepSx, children: /* @__PURE__ */ jsxRuntime.jsx(
-        material.StepLabel,
-        {
-          sx: {
-            pointerEvents: "none",
-            "& .MuiStepIcon-root": {
-              color: dotColor
-            },
-            "& .MuiStepIcon-active": {
-              color: activeDotColor
-            },
-            "& .MuiStepIcon-completed": {
-              color: completedDotColor
-            },
-            "& .MuiStepIcon-text": {
-              fill: iconTextColor
+    /* @__PURE__ */ jsxRuntime.jsxs(
+      material.Box,
+      {
+        sx: isHorizontal ? { display: "flex", alignItems: "center", width: "100%", gap: 0.5 } : void 0,
+        children: [
+          isHorizontal && /* @__PURE__ */ jsxRuntime.jsx(
+            StepperScrollArrow,
+            {
+              direction: "left",
+              enabled: canScrollLeft,
+              visible: showArrows,
+              onClick: () => scrollBy(-160)
+            }
+          ),
+          /* @__PURE__ */ jsxRuntime.jsx(
+            material.Box,
+            {
+              ref: scrollRef,
+              sx: isHorizontal ? {
+                flex: "1 1 auto",
+                minWidth: 0,
+                overflowX: "auto",
+                scrollBehavior: "smooth",
+                WebkitOverflowScrolling: "touch",
+                scrollbarWidth: "none",
+                "&::-webkit-scrollbar": { display: "none" }
+              } : void 0,
+              children: /* @__PURE__ */ jsxRuntime.jsx(
+                material.Stepper,
+                {
+                  activeStep: currentStep,
+                  orientation,
+                  alternativeLabel: alternateLabel,
+                  sx: isHorizontal ? {
+                    display: "inline-flex",
+                    flexWrap: "nowrap",
+                    minWidth: "100%",
+                    width: "max-content",
+                    "& .MuiStep-root": { flex: "0 0 auto", minWidth: 120 }
+                  } : void 0,
+                  children: steps.map((step, idx) => {
+                    var _a;
+                    const {
+                      label,
+                      completed,
+                      disabled,
+                      className,
+                      sx: stepSx,
+                      dotColor,
+                      activeDotColor,
+                      completedDotColor,
+                      iconTextColor
+                    } = step.props;
+                    const key = (_a = step.key) != null ? _a : idx;
+                    return /* @__PURE__ */ jsxRuntime.jsx(
+                      material.Step,
+                      {
+                        completed,
+                        disabled,
+                        className,
+                        sx: stepSx,
+                        children: /* @__PURE__ */ jsxRuntime.jsx(
+                          material.StepLabel,
+                          {
+                            sx: {
+                              pointerEvents: "none",
+                              "& .MuiStepIcon-root": { color: dotColor },
+                              "& .MuiStepIcon-active": { color: activeDotColor },
+                              "& .MuiStepIcon-completed": { color: completedDotColor },
+                              "& .MuiStepIcon-text": { fill: iconTextColor }
+                            },
+                            children: label
+                          }
+                        )
+                      },
+                      key
+                    );
+                  })
+                }
+              )
             }
-          },
-          children: label
-        }
-      ) }, idx);
-    }) }),
-    /* @__PURE__ */ jsxRuntime.jsx(material.Box, { mt: 2, children: children.map(
-      (child, idx) => idx === currentStep ? /* @__PURE__ */ jsxRuntime.jsx(material.Box, { children: child.props.children }, idx) : null
-    ) })
+          ),
+          isHorizontal && /* @__PURE__ */ jsxRuntime.jsx(
+            StepperScrollArrow,
+            {
+              direction: "right",
+              enabled: canScrollRight,
+              visible: showArrows,
+              onClick: () => scrollBy(160)
+            }
+          )
+        ]
+      }
+    ),
+    /* @__PURE__ */ jsxRuntime.jsx(material.Box, { mt: 2, children: keepMounted ? steps.map((step, idx) => {
+      var _a;
+      const key = (_a = step.key) != null ? _a : idx;
+      const isActive = idx === currentStep;
+      return /* @__PURE__ */ jsxRuntime.jsx(
+        material.Box,
+        {
+          sx: { display: isActive ? "block" : "none" },
+          "aria-hidden": !isActive,
+          children: step.props.children
+        },
+        key
+      );
+    }) : steps.map((step, idx) => {
+      var _a;
+      if (idx !== currentStep) return null;
+      const key = (_a = step.key) != null ? _a : idx;
+      return /* @__PURE__ */ jsxRuntime.jsx(material.Box, { children: step.props.children }, key);
+    }) })
   ] });
 };
 const Step = (_) => null;
 Step.displayName = "Step";
 exports.Step = Step;
 exports.Stepper = Stepper;
+exports.StepperContext = StepperContext;
+exports.StepperProvider = StepperProvider;
+exports.default = Stepper;
+exports.useStepper = useStepper;
 //# sourceMappingURL=Stepper.cjs.map

package/components/Stepper/Stepper.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"Stepper.cjs","sources":["../../../src/components/Stepper/Stepper.tsx","../../../src/components/Stepper/Step.tsx"],"sourcesContent":["import React, { ReactElement } from \"react\";\nimport { Stepper as MuiStepper, Step as MuiStep, StepLabel as MuiStepLabel, Box } from \"@mui/material\";\nimport { StepProps } from \"./Step\";\n\ninterface MyStepperProps {\n  children: ReactElement<StepProps>[];\n  orientation?: \"horizontal\" | \"vertical\";\n  sx?: object;\n  alternateLabel?: boolean;\n  currentStep?: number;\n}\n\nexport const Stepper: React.FC<MyStepperProps> = ({\n  children,\n  orientation = \"horizontal\",\n  alternateLabel = false,\n\n  sx,\n  currentStep = 0,\n}) => {\n\n  return (\n    <Box sx={sx}>\n      <MuiStepper activeStep={currentStep} orientation={orientation} alternativeLabel={alternateLabel} >\n        {children.map((child, idx) => {\n          const { label, completed, disabled, className, sx: stepSx, dotColor, activeDotColor, completedDotColor, iconTextColor } = child.props;\n          return (\n            <MuiStep key={idx} completed={completed} disabled={disabled} className={className} sx={stepSx}>\n              <MuiStepLabel sx={{\n                pointerEvents: 'none',\n                \"& .MuiStepIcon-root\": {\n                  color: dotColor,\n                },\n                \"& .MuiStepIcon-active\": {\n                  color: activeDotColor,\n                },\n                \"& .MuiStepIcon-completed\": {\n                  color: completedDotColor,\n                },\n                \"& .MuiStepIcon-text\": {\n                  fill: iconTextColor,\n                },\n              }}\n              >{label}\n              </MuiStepLabel>\n            </MuiStep>\n          );\n        })}\n      </MuiStepper>\n      <Box mt={2}>\n        {children.map((child, idx) =>\n          idx === currentStep ? <Box key={idx}>{child.props.children}</Box> : null\n        )}\n      </Box>\n    </Box>\n  );\n};\n\nexport default Stepper;","import React from \"react\";\nimport { StepProps as MuiStepProps } from \"@mui/material\";\n\ntype PickMuiStepProps = Pick<MuiStepProps, \"completed\" | \"disabled\" | \"sx\" | \"className\">;\n\nexport interface StepProps extends PickMuiStepProps {\n  label: React.ReactNode;\n  children?: React.ReactNode;\n  disabled?: boolean;\n  sx?: object;\n  dotColor?: string;          // dot base\n  activeDotColor?: string;    // dot activa\n  completedDotColor?: string; // dot completada\n  iconTextColor?: string;     // número o check dentro\n}\n\nexport const Step = (_: StepProps): null => null;\n\nStep.displayName = \"Step\";\n\nexport default Step;"],"names":["jsxs","Box","jsx","MuiStepper","MuiStep","MuiStepLabel"],"mappings":";;;;AAYO,MAAM,UAAoC,CAAC;AAAA,EAChD;AAAA,EACA,cAAc;AAAA,EACd,iBAAiB;AAAA,EAEjB;AAAA,EACA,cAAc;AAChB,MAAM;AAEJ,SACEA,gCAACC,SAAAA,OAAI,IACH,UAAA;AAAA,IAAAC,2BAAAA,IAACC,SAAAA,SAAA,EAAW,YAAY,aAAa,aAA0B,kBAAkB,gBAC9E,UAAA,SAAS,IAAI,CAAC,OAAO,QAAQ;AAC5B,YAAM,EAAE,OAAO,WAAW,UAAU,WAAW,IAAI,QAAQ,UAAU,gBAAgB,mBAAmB,cAAA,IAAkB,MAAM;AAChI,4CACGC,eAAA,EAAkB,WAAsB,UAAoB,WAAsB,IAAI,QACrF,UAAAF,2BAAAA;AAAAA,QAACG,SAAAA;AAAAA,QAAA;AAAA,UAAa,IAAI;AAAA,YAChB,eAAe;AAAA,YACf,uBAAuB;AAAA,cACrB,OAAO;AAAA,YAAA;AAAA,YAET,yBAAyB;AAAA,cACvB,OAAO;AAAA,YAAA;AAAA,YAET,4BAA4B;AAAA,cAC1B,OAAO;AAAA,YAAA;AAAA,YAET,uBAAuB;AAAA,cACrB,MAAM;AAAA,YAAA;AAAA,UACR;AAAA,UAEA,UAAA;AAAA,QAAA;AAAA,MAAA,KAhBU,GAkBd;AAAA,IAEJ,CAAC,EAAA,CACH;AAAA,IACAH,2BAAAA,IAACD,SAAAA,KAAA,EAAI,IAAI,GACN,UAAA,SAAS;AAAA,MAAI,CAAC,OAAO,QACpB,QAAQ,cAAcC,2BAAAA,IAACD,SAAAA,KAAA,EAAe,UAAA,MAAM,MAAM,SAAA,GAAlB,GAA2B,IAAS;AAAA,IAAA,EACtE,CACF;AAAA,EAAA,GACF;AAEJ;ACxCO,MAAM,OAAO,CAAC,MAAuB;AAE5C,KAAK,cAAc;;;"}
+{"version":3,"file":"Stepper.cjs","sources":["../../../src/components/Stepper/StepperContext.tsx","../../../src/components/Stepper/_hooks/useHorizontalScroll.ts","../../../src/components/Stepper/_parts/StepperScrollArrow.tsx","../../../src/components/Stepper/Stepper.tsx","../../../src/components/Stepper/Step.tsx"],"sourcesContent":["import {\n  createContext,\n  useCallback,\n  useContext,\n  useMemo,\n  useState,\n  type FC,\n  type ReactNode,\n} from 'react';\n\n/**\n * API expuesta por `useStepper()`.\n */\nexport interface StepperContextValue {\n  /** Índice del paso actual (0-based). */\n  currentStep: number;\n  /** Total de pasos del stepper. */\n  totalSteps: number;\n  /** True si `currentStep === 0`. */\n  isFirst: boolean;\n  /** True si `currentStep === totalSteps - 1`. */\n  isLast: boolean;\n  /** True tras ejecutar `submitStep()` desde el último paso. */\n  completed: boolean;\n  /** Avanza al siguiente paso (no pasa de `totalSteps - 1`). */\n  nextStep: () => void;\n  /** Retrocede al paso anterior (no baja de 0). */\n  prevStep: () => void;\n  /** Salta a un paso específico (0-based). No-op si fuera de rango. */\n  goToStep: (stepNumber: number) => void;\n  /**\n   * Envía el stepper. Marca `completed = true` y dispara el callback\n   * `onSubmit` del provider. En el último paso suele reemplazar a `nextStep`.\n   */\n  submitStep: () => void;\n  /** Resetea al paso inicial y limpia `completed`. */\n  reset: () => void;\n}\n\nconst defaultValue: StepperContextValue = {\n  currentStep: 0,\n  totalSteps: 0,\n  isFirst: true,\n  isLast: true,\n  completed: false,\n  nextStep: () => {},\n  prevStep: () => {},\n  goToStep: () => {},\n  submitStep: () => {},\n  reset: () => {},\n};\n\nexport const StepperContext = createContext<StepperContextValue>(defaultValue);\n\n/**\n * Hook para consumir el `StepperContext` desde cualquier descendiente de\n * `<StepperProvider>`.\n *\n * Si se llama fuera de un provider, devuelve los valores por defecto (no-op)\n * para que componentes como `<Stepper>` puedan leerlo sin romper cuando no\n * hay provider envolvente.\n */\nexport function useStepper(): StepperContextValue {\n  return useContext(StepperContext);\n}\n\nexport interface StepperProviderProps {\n  /** Número total de pasos. Requerido. */\n  totalSteps: number;\n  /** Paso inicial (0-based). Default: 0. */\n  initialStep?: number;\n  /**\n   * Callback disparado cuando se llama `submitStep()`. Recibe el paso actual.\n   * El paquete NO ejecuta ninguna petición; queda a cargo del consumer.\n   */\n  onSubmit?: (currentStep: number) => void;\n  /**\n   * Callback disparado en cada cambio de paso (next/prev/goTo).\n   * Útil para tracking o validaciones externas.\n   */\n  onStepChange?: (newStep: number, prevStep: number) => void;\n  children?: ReactNode;\n}\n\n/**\n * Provider del stepper. Administra el `currentStep` internamente. El consumer\n * no necesita gestionar estado — solo consumirlo con `useStepper()` desde\n * cualquier descendiente.\n *\n * ```tsx\n * <StepperProvider totalSteps={3} onSubmit={handleFinalSubmit}>\n *   <Stepper>\n *     <Step label=\"Paso 1\"><StepOne /></Step>\n *     <Step label=\"Paso 2\"><StepTwo /></Step>\n *     <Step label=\"Paso 3\"><StepThree /></Step>\n *   </Stepper>\n *   <StepperControls />\n * </StepperProvider>\n * ```\n */\nexport const StepperProvider: FC<StepperProviderProps> = ({\n  totalSteps,\n  initialStep = 0,\n  onSubmit,\n  onStepChange,\n  children,\n}) => {\n  const [currentStep, setCurrentStep] = useState(initialStep);\n  const [completed, setCompleted] = useState(false);\n\n  const changeStep = useCallback(\n    (newStep: number) => {\n      setCurrentStep((prev) => {\n        if (newStep === prev) return prev;\n        if (newStep < 0 || newStep >= totalSteps) return prev;\n        onStepChange?.(newStep, prev);\n        return newStep;\n      });\n    },\n    [totalSteps, onStepChange],\n  );\n\n  const nextStep = useCallback(() => {\n    changeStep(currentStep + 1);\n  }, [changeStep, currentStep]);\n\n  const prevStep = useCallback(() => {\n    changeStep(currentStep - 1);\n  }, [changeStep, currentStep]);\n\n  const goToStep = useCallback(\n    (stepNumber: number) => {\n      changeStep(stepNumber);\n    },\n    [changeStep],\n  );\n\n  const submitStep = useCallback(() => {\n    setCompleted(true);\n    onSubmit?.(currentStep);\n  }, [currentStep, onSubmit]);\n\n  const reset = useCallback(() => {\n    setCurrentStep(initialStep);\n    setCompleted(false);\n  }, [initialStep]);\n\n  const value = useMemo<StepperContextValue>(\n    () => ({\n      currentStep,\n      totalSteps,\n      isFirst: currentStep === 0,\n      isLast: currentStep === totalSteps - 1,\n      completed,\n      nextStep,\n      prevStep,\n      goToStep,\n      submitStep,\n      reset,\n    }),\n    [\n      currentStep,\n      totalSteps,\n      completed,\n      nextStep,\n      prevStep,\n      goToStep,\n      submitStep,\n      reset,\n    ],\n  );\n\n  return (\n    <StepperContext.Provider value={value}>{children}</StepperContext.Provider>\n  );\n};\n","import { useCallback, useEffect, useLayoutEffect, useRef, useState } from 'react';\n\n/**\n * Hook interno del Stepper para manejar scroll horizontal cuando los steps\n * no caben en el contenedor. No se exporta desde el barrel — es un detalle\n * de implementación.\n *\n * @param enabled - Si el scroll está activo (típicamente sólo en orientación horizontal).\n * @param deps    - Cosas que afectan el layout y disparan un recompute (ej. cantidad de steps, paso activo).\n *\n * Retorna:\n * - `scrollRef`: ref a asignar al contenedor con `overflow-x: auto`.\n * - `canScrollLeft` / `canScrollRight`: flags para habilitar/deshabilitar flechas.\n * - `scrollBy(delta)`: imperativo con scroll suave.\n */\nexport function useHorizontalScroll(enabled: boolean, deps: unknown[] = []) {\n  const scrollRef = useRef<HTMLDivElement | null>(null);\n  const [canScrollLeft, setCanScrollLeft] = useState(false);\n  const [canScrollRight, setCanScrollRight] = useState(false);\n\n  const updateScrollState = useCallback(() => {\n    const el = scrollRef.current;\n    if (!el) return;\n    const { scrollLeft, scrollWidth, clientWidth } = el;\n    // Tolerancia de 1px por redondeos de subpixel.\n    setCanScrollLeft(scrollLeft > 1);\n    setCanScrollRight(scrollLeft + clientWidth < scrollWidth - 1);\n  }, []);\n\n  useLayoutEffect(() => {\n    if (!enabled) return;\n    updateScrollState();\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, [enabled, updateScrollState, ...deps]);\n\n  useEffect(() => {\n    if (!enabled) return;\n    const el = scrollRef.current;\n    if (!el) return;\n    el.addEventListener('scroll', updateScrollState, { passive: true });\n    const ro = new ResizeObserver(updateScrollState);\n    ro.observe(el);\n    return () => {\n      el.removeEventListener('scroll', updateScrollState);\n      ro.disconnect();\n    };\n  }, [enabled, updateScrollState]);\n\n  const scrollBy = useCallback((delta: number) => {\n    const el = scrollRef.current;\n    if (!el) return;\n    el.scrollBy({ left: delta, behavior: 'smooth' });\n  }, []);\n\n  return { scrollRef, canScrollLeft, canScrollRight, scrollBy };\n}\n","import { IconButton } from '@mui/material';\nimport ChevronLeftIcon from '@mui/icons-material/ChevronLeft';\nimport ChevronRightIcon from '@mui/icons-material/ChevronRight';\n\ninterface StepperScrollArrowProps {\n  direction: 'left' | 'right';\n  /** Cuando `false`, el botón está deshabilitado (por ejemplo, ya estás al inicio). */\n  enabled: boolean;\n  /**\n   * Cuando `false`, el botón queda con `visibility: hidden` (reserva su\n   * espacio pero no se ve). Útil para que el área de scroll no se corra\n   * horizontalmente cuando no hay overflow en ningún lado.\n   */\n  visible: boolean;\n  onClick: () => void;\n}\n\n/**\n * Flecha de scroll (`<` / `>`) del Stepper horizontal. Se muestra a los\n * costados del área scrollable cuando hay overflow. Componente privado —\n * no se exporta del barrel.\n */\nexport const StepperScrollArrow = ({\n  direction,\n  enabled,\n  visible,\n  onClick,\n}: StepperScrollArrowProps) => {\n  const isLeft = direction === 'left';\n  const Icon = isLeft ? ChevronLeftIcon : ChevronRightIcon;\n  const ariaLabel = isLeft ? 'Anterior' : 'Siguiente';\n\n  return (\n    <IconButton\n      aria-label={ariaLabel}\n      size=\"small\"\n      onClick={onClick}\n      disabled={!enabled}\n      sx={{\n        flex: '0 0 auto',\n        // Reservamos el slot siempre que haya overflow en algún lado,\n        // así el área scroll tiene un ancho estable (no saltan los\n        // steps cuando aparece/desaparece la flecha).\n        visibility: visible ? 'visible' : 'hidden',\n      }}\n    >\n      <Icon fontSize=\"small\" />\n    </IconButton>\n  );\n};\n","import {\n  Children,\n  isValidElement,\n  type FC,\n  type ReactElement,\n  type ReactNode,\n} from 'react';\nimport {\n  Stepper as MuiStepper,\n  Step as MuiStep,\n  StepLabel as MuiStepLabel,\n  Box,\n} from '@mui/material';\n\nimport { StepProps } from './Step';\nimport { useStepper } from './StepperContext';\nimport { useHorizontalScroll } from './_hooks/useHorizontalScroll';\nimport { StepperScrollArrow } from './_parts/StepperScrollArrow';\n\nexport interface StepperProps {\n  /** Uno o varios `<Step>`. Children que no sean `<Step>` se ignoran. */\n  children: ReactNode;\n  orientation?: 'horizontal' | 'vertical';\n  alternateLabel?: boolean;\n  /**\n   * Índice 0-based del paso activo. Si no se provee, el Stepper intenta\n   * leerlo del `StepperContext` (si está dentro de un `<StepperProvider>`).\n   * Si tampoco hay provider, el default es 0.\n   */\n  currentStep?: number;\n  keepMounted?: boolean;\n  sx?: object;\n}\n\nexport const Stepper: FC<StepperProps> = ({\n  children,\n  orientation = 'horizontal',\n  alternateLabel = false,\n  currentStep: currentStepProp,\n  keepMounted = false,\n  sx,\n}) => {\n  // Lee el paso desde el StepperContext cuando el consumer no lo pasa como prop.\n  const stepperCtx = useStepper();\n  const currentStep =\n    currentStepProp !== undefined\n      ? currentStepProp\n      : stepperCtx.totalSteps > 0\n        ? stepperCtx.currentStep\n        : 0;\n\n  const isHorizontal = orientation === 'horizontal';\n\n  // Filtra los children a los que tengan displayName=\"Step\" — acepta arrays,\n  // single child, fragments, y descarta cualquier otra cosa (strings, null, etc.).\n  const steps: ReactElement<StepProps>[] = Children.toArray(children).filter(\n    (child): child is ReactElement<StepProps> =>\n      isValidElement(child) &&\n      (child.type as { displayName?: string })?.displayName === 'Step',\n  );\n\n  const { scrollRef, canScrollLeft, canScrollRight, scrollBy } = useHorizontalScroll(\n    isHorizontal,\n    [steps.length, currentStep],\n  );\n\n  const showArrows = isHorizontal && (canScrollLeft || canScrollRight);\n\n  return (\n    <Box sx={sx}>\n      <Box\n        sx={\n          isHorizontal\n            ? { display: 'flex', alignItems: 'center', width: '100%', gap: 0.5 }\n            : undefined\n        }\n      >\n        {isHorizontal && (\n          <StepperScrollArrow\n            direction=\"left\"\n            enabled={canScrollLeft}\n            visible={showArrows}\n            onClick={() => scrollBy(-160)}\n          />\n        )}\n        <Box\n          ref={scrollRef}\n          sx={\n            isHorizontal\n              ? {\n                flex: '1 1 auto',\n                minWidth: 0,\n                overflowX: 'auto',\n                scrollBehavior: 'smooth',\n                WebkitOverflowScrolling: 'touch',\n                scrollbarWidth: 'none',\n                '&::-webkit-scrollbar': { display: 'none' },\n              }\n              : undefined\n          }\n        >\n          <MuiStepper\n            activeStep={currentStep}\n            orientation={orientation}\n            alternativeLabel={alternateLabel}\n            sx={\n              isHorizontal\n                ? {\n                  display: 'inline-flex',\n                  flexWrap: 'nowrap',\n                  minWidth: '100%',\n                  width: 'max-content',\n                  '& .MuiStep-root': { flex: '0 0 auto', minWidth: 120 },\n                }\n                : undefined\n            }\n          >\n            {steps.map((step, idx) => {\n              const {\n                label,\n                completed,\n                disabled,\n                className,\n                sx: stepSx,\n                dotColor,\n                activeDotColor,\n                completedDotColor,\n                iconTextColor,\n              } = step.props;\n              const key = step.key ?? idx;\n              return (\n                <MuiStep\n                  key={key}\n                  completed={completed}\n                  disabled={disabled}\n                  className={className}\n                  sx={stepSx}\n                >\n                  <MuiStepLabel\n                    sx={{\n                      pointerEvents: 'none',\n                      '& .MuiStepIcon-root': { color: dotColor },\n                      '& .MuiStepIcon-active': { color: activeDotColor },\n                      '& .MuiStepIcon-completed': { color: completedDotColor },\n                      '& .MuiStepIcon-text': { fill: iconTextColor },\n                    }}\n                  >\n                    {label}\n                  </MuiStepLabel>\n                </MuiStep>\n              );\n            })}\n          </MuiStepper>\n        </Box>\n        {isHorizontal && (\n          <StepperScrollArrow\n            direction=\"right\"\n            enabled={canScrollRight}\n            visible={showArrows}\n            onClick={() => scrollBy(160)}\n          />\n        )}\n      </Box>\n\n      {/* Cuerpos de los steps — render según el modo `keepMounted` */}\n      <Box mt={2}>\n        {keepMounted\n          ? steps.map((step, idx) => {\n            const key = step.key ?? idx;\n            const isActive = idx === currentStep;\n            return (\n              <Box\n                key={key}\n                // `display: none` mantiene el nodo en el DOM — state de los\n                // hijos (inputs, useState, etc.) no se pierde al navegar.\n                sx={{ display: isActive ? 'block' : 'none' }}\n                // Accesibilidad: oculta del flujo de lectura pero no del DOM.\n                aria-hidden={!isActive}\n              >\n                {step.props.children}\n              </Box>\n            );\n          })\n          : steps.map((step, idx) => {\n            if (idx !== currentStep) return null;\n            const key = step.key ?? idx;\n            return <Box key={key}>{step.props.children}</Box>;\n          })}\n      </Box>\n    </Box>\n  );\n};\n\nexport default Stepper;\n","import React from \"react\";\nimport { StepProps as MuiStepProps } from \"@mui/material\";\n\ntype PickMuiStepProps = Pick<MuiStepProps, \"completed\" | \"disabled\" | \"sx\" | \"className\">;\n\nexport interface StepProps extends PickMuiStepProps {\n  label: React.ReactNode;\n  children?: React.ReactNode;\n  disabled?: boolean;\n  sx?: object;\n  dotColor?: string;          // dot base\n  activeDotColor?: string;    // dot activa\n  completedDotColor?: string; // dot completada\n  iconTextColor?: string;     // número o check dentro\n}\n\nexport const Step = (_: StepProps): null => null;\n\nStep.displayName = \"Step\";\n\nexport default Step;"],"names":["createContext","useContext","useState","useCallback","useMemo","jsx","useRef","useLayoutEffect","useEffect","IconButton","Children","isValidElement","jsxs","Box","MuiStepper","MuiStep","MuiStepLabel"],"mappings":"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"}

package/components/Stepper/Stepper.d.ts

@@ -1,11 +1,17 @@
-import { default as React, ReactElement } from 'react';
-import { StepProps } from './Step';
-interface MyStepperProps {
-    children: ReactElement<StepProps>[];
-    orientation?: "horizontal" | "vertical";
-    sx?: object;
+import { FC, ReactNode } from 'react';
+export interface StepperProps {
+    /** Uno o varios `<Step>`. Children que no sean `<Step>` se ignoran. */
+    children: ReactNode;
+    orientation?: 'horizontal' | 'vertical';
     alternateLabel?: boolean;
+    /**
+     * Índice 0-based del paso activo. Si no se provee, el Stepper intenta
+     * leerlo del `StepperContext` (si está dentro de un `<StepperProvider>`).
+     * Si tampoco hay provider, el default es 0.
+     */
     currentStep?: number;
+    keepMounted?: boolean;
+    sx?: object;
 }
-export declare const Stepper: React.FC<MyStepperProps>;
+export declare const Stepper: FC<StepperProps>;
 export default Stepper;