@codeplex-sac/date-pickers 0.0.12 → 0.0.13

package/lib/proveedor/proveedor.d.ts

@@ -1,6 +1,18 @@
 import { default as React } from 'react';
+/**
+ * Propiedades para el componente CodeplexProveedorFechas.
+ */
 export interface CodeplexProveedorFechasProps {
+    /** Contenido que se envolverá con el proveedor de fechas. */
     children: React.ReactNode;
+    /**
+     * El idioma a utilizar para el formateo y localización de fechas.
+     * Por defecto es 'es' (español).
+     */
     idioma?: string;
 }
+/**
+ * Proveedor de contexto para la gestión de fechas y localización en componentes de Codeplex.
+ * Basado en MUI X Date Pickers y Dayjs.
+ */
 export declare const CodeplexProveedorFechas: ({ children, idioma }: CodeplexProveedorFechasProps) => import("react/jsx-runtime").JSX.Element;

package/lib/reloj-digital/reloj-digital.d.ts

@@ -1,8 +1,41 @@
 import { DigitalClockProps } from '@mui/x-date-pickers/DigitalClock';
 import { Dayjs } from 'dayjs';
 import { SxProps, Theme } from '@mui/material';
-export interface CodeplexRelojDigitalProps extends DigitalClockProps<Dayjs> {
+/**
+ * Propiedades para el componente CodeplexRelojDigital.
+ */
+export interface CodeplexRelojDigitalProps extends Omit<DigitalClockProps<Dayjs>, 'value' | 'onChange' | 'disabled' | 'readOnly' | 'timeSteps' | 'minTime' | 'maxTime'> {
+    /** Si es true, envuelve el reloj en un componente Paper con elevación. */
     conPapel?: boolean;
+    /** Estilos personalizados para el contenedor del reloj. */
     sx?: SxProps<Theme>;
+    /** Valor actual de la hora. */
+    valor?: Dayjs | null;
+    /** Función que se ejecuta cuando cambia la hora. */
+    alCambiar?: (nuevoValor: Dayjs | null) => void;
+    /** Si es true, el reloj estará deshabilitado. */
+    deshabilitado?: boolean;
+    /** Si es true, el campo será de solo lectura. */
+    lecturaSola?: boolean;
+    /**
+     * Paso de tiempo entre las opciones (en minutos).
+     * Por defecto es 30.
+     */
+    pasoTiempo?: number;
+    /** Hora mínima permitida. */
+    horaMinima?: Dayjs;
+    /** Hora máxima permitida. */
+    horaMaxima?: Dayjs;
+    value?: Dayjs | null;
+    onChange?: (value: Dayjs | null) => void;
+    disabled?: boolean;
+    readOnly?: boolean;
+    timeStep?: number;
+    minTime?: Dayjs;
+    maxTime?: Dayjs;
 }
-export declare const CodeplexRelojDigital: ({ conPapel, sx, ...props }: CodeplexRelojDigitalProps) => import("react/jsx-runtime").JSX.Element;
+/**
+ * Componente de Reloj Digital Premium.
+ * Permite seleccionar una hora de una lista de opciones generadas automáticamente.
+ */
+export declare const CodeplexRelojDigital: ({ conPapel, sx, valor, alCambiar, deshabilitado, lecturaSola, pasoTiempo, horaMinima, horaMaxima, value, onChange, disabled, readOnly, timeStep, minTime, maxTime, ...props }: CodeplexRelojDigitalProps) => import("react/jsx-runtime").JSX.Element;

package/lib/selector-fecha/selector-fecha.d.ts

@@ -1,9 +1,50 @@
 import { DatePickerProps } from '@mui/x-date-pickers/DatePicker';
 import { Dayjs } from 'dayjs';
-export interface CodeplexSelectorFechaProps extends Omit<DatePickerProps<Dayjs>, 'label'> {
+/**
+ * Propiedades para el componente CodeplexSelectorFecha.
+ */
+export interface CodeplexSelectorFechaProps extends Omit<DatePickerProps<Dayjs>, 'label' | 'value' | 'onChange' | 'disabled' | 'readOnly' | 'format'> {
+    /** Etiqueta que se muestra encima del campo. */
+    etiqueta?: string;
+    /** Valor actual del selector de fecha. */
+    valor?: Dayjs | null;
+    /** Función que se ejecuta cuando cambia el valor de la fecha. */
+    alCambiar?: (nuevoValor: Dayjs | null) => void;
+    /** Texto informativo o de error que aparece debajo del campo. */
     textoAyuda?: string;
+    /** Si es true, el campo mostrará un estado de error. */
     error?: boolean;
+    /** Si es true, el campo ocupará todo el ancho de su contenedor. */
     anchoCompleto?: boolean;
-    etiqueta?: string;
+    /** Si es true, el selector estará deshabilitado. */
+    deshabilitado?: boolean;
+    /** Si es true, el campo será de solo lectura. */
+    lecturaSola?: boolean;
+    /** Fecha mínima permitida. */
+    minFecha?: Dayjs;
+    /** Fecha máxima permitida. */
+    maxFecha?: Dayjs;
+    /** Si es true, deshabilita las fechas anteriores a la actual. */
+    deshabilitarPasado?: boolean;
+    /** Si es true, deshabilita las fechas posteriores a la actual. */
+    deshabilitarFuturo?: boolean;
+    /** Vistas disponibles del calendario (e.g., ['year', 'month', 'day']). */
+    vistas?: Array<'year' | 'month' | 'day'>;
+    /** Formato de fecha para mostrar en el campo. */
+    formato?: string;
+    /** Texto que se muestra dentro del campo cuando está vacío. */
+    marcador?: string;
+    value?: Dayjs | null;
+    onChange?: (value: Dayjs | null) => void;
+    disabled?: boolean;
+    readOnly?: boolean;
+    format?: string;
+    disablePast?: boolean;
+    disableFuture?: boolean;
+    views?: Array<'year' | 'month' | 'day'>;
 }
-export declare const CodeplexSelectorFecha: ({ slotProps, textoAyuda, error, anchoCompleto, etiqueta, sx, ...props }: CodeplexSelectorFechaProps) => import("react/jsx-runtime").JSX.Element;
+/**
+ * Componente Selector de Fecha Premium.
+ * Permite a los usuarios seleccionar una fecha a través de un calendario interactivo.
+ */
+export declare const CodeplexSelectorFecha: ({ slotProps, textoAyuda, error, anchoCompleto, etiqueta, sx, valor, alCambiar, deshabilitado, lecturaSola, minFecha, maxFecha, deshabilitarPasado, deshabilitarFuturo, vistas, formato, marcador, value, onChange, disabled, readOnly, format, disablePast, disableFuture, views, ...props }: CodeplexSelectorFechaProps) => import("react/jsx-runtime").JSX.Element;

package/lib/selector-fecha-hora/selector-fecha-hora.d.ts

@@ -1,9 +1,50 @@
 import { DateTimePickerProps } from '@mui/x-date-pickers/DateTimePicker';
 import { Dayjs } from 'dayjs';
-export interface CodeplexSelectorFechaHoraProps extends Omit<DateTimePickerProps<Dayjs>, 'label'> {
+/**
+ * Propiedades para el componente CodeplexSelectorFechaHora.
+ */
+export interface CodeplexSelectorFechaHoraProps extends Omit<DateTimePickerProps<Dayjs>, 'label' | 'value' | 'onChange' | 'disabled' | 'readOnly' | 'format'> {
+    /** Etiqueta que se muestra encima del campo. */
+    etiqueta?: string;
+    /** Valor actual del selector de fecha y hora. */
+    valor?: Dayjs | null;
+    /** Función que se ejecuta cuando cambia el valor de la fecha y hora. */
+    alCambiar?: (nuevoValor: Dayjs | null) => void;
+    /** Texto informativo o de error que aparece debajo del campo. */
     textoAyuda?: string;
+    /** Si es true, el campo mostrará un estado de error. */
     error?: boolean;
+    /** Si es true, el campo ocupará todo el ancho de su contenedor. */
     anchoCompleto?: boolean;
-    etiqueta?: string;
+    /** Si es true, el selector estará deshabilitado. */
+    deshabilitado?: boolean;
+    /** Si es true, el campo será de solo lectura. */
+    lecturaSola?: boolean;
+    /** Fecha y hora mínima permitida. */
+    minFechaHora?: Dayjs;
+    /** Fecha y hora máxima permitida. */
+    maxFechaHora?: Dayjs;
+    /** Si es true, deshabilita las fechas y horas anteriores a la actual. */
+    deshabilitarPasado?: boolean;
+    /** Si es true, deshabilita las fechas y horas posteriores a la actual. */
+    deshabilitarFuturo?: boolean;
+    /** Vistas disponibles (e.g., ['year', 'month', 'day', 'hours', 'minutes']). */
+    vistas?: Array<'year' | 'month' | 'day' | 'hours' | 'minutes'>;
+    /** Formato de fecha y hora para mostrar en el campo. */
+    formato?: string;
+    /** Texto que se muestra dentro del campo cuando está vacío. */
+    marcador?: string;
+    value?: Dayjs | null;
+    onChange?: (value: Dayjs | null) => void;
+    disabled?: boolean;
+    readOnly?: boolean;
+    format?: string;
+    disablePast?: boolean;
+    disableFuture?: boolean;
+    views?: Array<'year' | 'month' | 'day' | 'hours' | 'minutes'>;
 }
-export declare const CodeplexSelectorFechaHora: ({ slotProps, textoAyuda, error, anchoCompleto, etiqueta, sx, ...props }: CodeplexSelectorFechaHoraProps) => import("react/jsx-runtime").JSX.Element;
+/**
+ * Componente Selector de Fecha y Hora Premium.
+ * Permite a los usuarios seleccionar tanto la fecha como la hora en un solo control.
+ */
+export declare const CodeplexSelectorFechaHora: ({ slotProps, textoAyuda, error, anchoCompleto, etiqueta, sx, valor, alCambiar, deshabilitado, lecturaSola, minFechaHora, maxFechaHora, deshabilitarPasado, deshabilitarFuturo, vistas, formato, marcador, value, onChange, disabled, readOnly, format, disablePast, disableFuture, views, ...props }: CodeplexSelectorFechaHoraProps) => import("react/jsx-runtime").JSX.Element;

package/lib/selector-hora/selector-hora.d.ts

@@ -1,9 +1,47 @@
 import { TimePickerProps } from '@mui/x-date-pickers/TimePicker';
 import { Dayjs } from 'dayjs';
-export interface CodeplexSelectorHoraProps extends Omit<TimePickerProps<Dayjs>, 'label'> {
+/**
+ * Propiedades para el componente CodeplexSelectorHora.
+ */
+export interface CodeplexSelectorHoraProps extends Omit<TimePickerProps<Dayjs>, 'label' | 'value' | 'onChange' | 'disabled' | 'readOnly' | 'format'> {
+    /** Etiqueta que se muestra encima del campo. */
+    etiqueta?: string;
+    /** Valor actual del selector de hora. */
+    valor?: Dayjs | null;
+    /** Función que se ejecuta cuando cambia el valor de la hora. */
+    alCambiar?: (nuevoValor: Dayjs | null) => void;
+    /** Texto informativo o de error que aparece debajo del campo. */
     textoAyuda?: string;
+    /** Si es true, el campo mostrará un estado de error. */
     error?: boolean;
+    /** Si es true, el campo ocupará todo el ancho de su contenedor. */
     anchoCompleto?: boolean;
-    etiqueta?: string;
+    /** Si es true, el selector estará deshabilitado. */
+    deshabilitado?: boolean;
+    /** Si es true, el campo será de solo lectura. */
+    lecturaSola?: boolean;
+    /** Hora mínima permitida. */
+    minHora?: Dayjs;
+    /** Hora máxima permitida. */
+    maxHora?: Dayjs;
+    /** Si es true, deshabilita las horas anteriores a la actual. */
+    deshabilitarPasado?: boolean;
+    /** Si es true, deshabilita las horas posteriores a la actual. */
+    deshabilitarFuturo?: boolean;
+    /** Formato de hora para mostrar en el campo. */
+    formato?: string;
+    /** Texto que se muestra dentro del campo cuando está vacío. */
+    marcador?: string;
+    value?: Dayjs | null;
+    onChange?: (value: Dayjs | null) => void;
+    disabled?: boolean;
+    readOnly?: boolean;
+    format?: string;
+    disablePast?: boolean;
+    disableFuture?: boolean;
 }
-export declare const CodeplexSelectorHora: ({ slotProps, textoAyuda, error, anchoCompleto, etiqueta, sx, ...props }: CodeplexSelectorHoraProps) => import("react/jsx-runtime").JSX.Element;
+/**
+ * Componente Selector de Hora Premium.
+ * Permite a los usuarios seleccionar una hora específica.
+ */
+export declare const CodeplexSelectorHora: ({ slotProps, textoAyuda, error, anchoCompleto, etiqueta, sx, valor, alCambiar, deshabilitado, lecturaSola, minHora, maxHora, deshabilitarPasado, deshabilitarFuturo, formato, marcador, value, onChange, disabled, readOnly, format, disablePast, disableFuture, ...props }: CodeplexSelectorHoraProps) => import("react/jsx-runtime").JSX.Element;

package/lib/selector-rango-fecha/selector-rango-fecha.d.ts

@@ -0,0 +1,48 @@
+import { DateRangePickerProps } from '@mui/x-date-pickers-pro/DateRangePicker';
+import { Dayjs } from 'dayjs';
+import { DateRange } from '@mui/x-date-pickers-pro';
+/**
+ * Propiedades para el componente CodeplexSelectorRangoFecha.
+ */
+export interface CodeplexSelectorRangoFechaProps extends Omit<DateRangePickerProps<Dayjs>, 'label' | 'value' | 'onChange' | 'disabled' | 'readOnly' | 'format'> {
+    /** Etiqueta que se muestra encima del campo. */
+    etiqueta?: string;
+    /** Valor actual del rango de fechas [inicio, fin]. */
+    valor?: DateRange<Dayjs>;
+    /** Función que se ejecuta cuando cambia el rango de fechas. */
+    alCambiar?: (nuevoValor: DateRange<Dayjs>) => void;
+    /** Texto informativo o de error que aparece debajo del campo. */
+    textoAyuda?: string;
+    /** Si es true, el campo mostrará un estado de error. */
+    error?: boolean;
+    /** Si es true, el campo ocupará todo el ancho de su contenedor. */
+    anchoCompleto?: boolean;
+    /** Si es true, el selector estará deshabilitado. */
+    deshabilitado?: boolean;
+    /** Si es true, el campo será de solo lectura. */
+    lecturaSola?: boolean;
+    /** Fecha mínima permitida. */
+    minFecha?: Dayjs;
+    /** Fecha máxima permitida. */
+    maxFecha?: Dayjs;
+    /** Si es true, deshabilita las fechas anteriores a la actual. */
+    deshabilitarPasado?: boolean;
+    /** Si es true, deshabilita las fechas posteriores a la actual. */
+    deshabilitarFuturo?: boolean;
+    /** Formato de fecha para mostrar en el campo. */
+    formato?: string;
+    /** Texto que se muestra dentro del campo cuando está vacío. */
+    marcador?: string;
+    value?: DateRange<Dayjs> | null;
+    onChange?: (value: DateRange<Dayjs>) => void;
+    disabled?: boolean;
+    readOnly?: boolean;
+    format?: string;
+    disablePast?: boolean;
+    disableFuture?: boolean;
+}
+/**
+ * Componente Selector de Rango de Fecha Premium.
+ * Permite a los usuarios seleccionar un periodo de tiempo (fecha inicio y fin).
+ */
+export declare const CodeplexSelectorRangoFecha: ({ slotProps, textoAyuda, error, anchoCompleto, etiqueta, sx, valor, alCambiar, deshabilitado, lecturaSola, minFecha, maxFecha, deshabilitarPasado, deshabilitarFuturo, formato, marcador, value, onChange, disabled, readOnly, format, disablePast, disableFuture, ...props }: CodeplexSelectorRangoFechaProps) => import("react/jsx-runtime").JSX.Element;

package/package.json

@@ -1,23 +1,26 @@
 {
-    "name": "@codeplex-sac/date-pickers",
-    "version": "0.0.12",
-    "main": "./index.js",
-    "types": "./index.d.ts",
-    "exports": {
-        ".": {
-            "types": "./index.d.ts",
-            "import": "./index.mjs",
-            "require": "./index.js"
-        }
-    },
-    "peerDependencies": {
-        "react": "^19.0.0",
-        "react-dom": "^19.0.0",
-        "@mui/material": "^7.3.6"
-    },
-    "dependencies": {
-        "@mui/x-date-pickers": "^7.23.0",
-        "@mui/x-date-pickers-pro": "^7.23.0",
-        "dayjs": "^1.11.13"
+  "name": "@codeplex-sac/date-pickers",
+  "version": "0.0.13",
+  "main": "./index.js",
+  "types": "./index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./index.d.ts",
+      "import": "./index.mjs",
+      "require": "./index.js"
     }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "peerDependencies": {
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0",
+    "@mui/material": "^7.3.6"
+  },
+  "dependencies": {
+    "@mui/x-date-pickers": "^7.23.0",
+    "@mui/x-date-pickers-pro": "^7.23.0",
+    "dayjs": "^1.11.13"
+  }
 }