@stackcraftmx/calcita 0.32.2 → 0.47.0

package/dist/types/date-pickers.d.ts

@@ -1,2 +1,11 @@
-export { CALENDAR_DATE_FORMAT, default as DateInput } from './datePickers/DateInput.js';
+export { default as DateInput } from './datePickers/DateInput.js';
 export { default as FormDateField } from './datePickers/FormDateField.js';
+export { default as DateTimeInput } from './datePickers/DateTimeInput.js';
+export { default as FormDateTimeField } from './datePickers/FormDateTimeField.js';
+export { default as TimeInput } from './datePickers/TimeInput.js';
+export { default as FormTimeField } from './datePickers/FormTimeField.js';
+export { default as MonthInput } from './datePickers/MonthInput.js';
+export { default as FormMonthField } from './datePickers/FormMonthField.js';
+export { CALENDAR_DATE_FORMAT, CALENDAR_MONTH_FORMAT, DEFAULT_MINUTES_STEP, INSTANT_FORMAT, TIME_OF_DAY_FORMAT, earliestInstantFromNow, instantPlusMinutes, latestInstantOf, timeZoneNameOf, } from './datePickers/pickerValues.js';
+export { minutesAfterRule, minutesFromNowRule } from './datePickers/dateTimeRules.js';
+export { useCurrentMinute } from './datePickers/useCurrentMinute.js';

package/dist/types/datePickers/DateInput.d.ts

@@ -1,6 +1,5 @@
-import 'dayjs/locale/es';
-/** Cómo viaja una fecha de calendario. */
-export declare const CALENDAR_DATE_FORMAT = "YYYY-MM-DD";
+import { CALENDAR_DATE_FORMAT } from './pickerValues.js';
+export { CALENDAR_DATE_FORMAT };
 /**
  * @param {object} props
  * @param {string} [props.name]
@@ -17,9 +16,11 @@ export declare const CALENDAR_DATE_FORMAT = "YYYY-MM-DD";
  * @param {'day'|'month'|'year'} [props.openTo] por dónde abre el calendario (year para un nacimiento)
  * @param {boolean} [props.disabled]
  * @param {import('react').Ref<HTMLInputElement>} [props.inputRef]
+ * @param {object} [props.pickerProps] lo demás del DatePicker de MUI X que aquí no tiene nombre (shouldDisableDate, slots,
+ *     slotProps…); value y onChange son del campo
  * @param {object} [props.texts] los textos que cambian, con la forma de `common` en los textos del paquete
  */
-export default function DateInput({ name, label, value, onChange, onBlur, error, helperText, minDate, maxDate, disableFuture, disablePast, openTo, disabled, inputRef, texts, ...unknownProps }: {
+export default function DateInput({ name, label, value, onChange, onBlur, error, helperText, minDate, maxDate, disableFuture, disablePast, openTo, disabled, inputRef, pickerProps, texts, ...unknownProps }: {
     name?: string;
     label: string;
     value: string | null | undefined;
@@ -37,5 +38,6 @@ export default function DateInput({ name, label, value, onChange, onBlur, error,
     openTo?: 'day' | 'month' | 'year';
     disabled?: boolean;
     inputRef?: import('react').Ref<HTMLInputElement>;
+    pickerProps?: object;
     texts?: object;
 }): import("react").JSX.Element;

package/dist/types/datePickers/DateTimeInput.d.ts

@@ -0,0 +1,50 @@
+/**
+ * @param {object} props
+ * @param {string} [props.name]
+ * @param {string} props.label ya traducido
+ * @param {string|null|undefined} props.value el instante ('2026-11-01T18:30:00Z' o con desfase) o ''
+ * @param {(value: string) => void} props.onChange recibe el instante en UTC ('' al borrar o a medias)
+ * @param {() => void} [props.onBlur]
+ * @param {string|{key: string, values?: object}} [props.error]
+ * @param {string} [props.helperText] ya traducida; va antes del nombre de la zona
+ * @param {string} [props.minDateTime] instante (el fin de algo: instantPlusMinutes(startsAt, 30))
+ * @param {number} [props.minimumMinutesFromNow] al menos tantos minutos después de ahora; se recorre con el reloj
+ * @param {string} [props.maxDateTime] instante
+ * @param {boolean} [props.disableFuture]
+ * @param {boolean} [props.disablePast] p. ej. un envío programado
+ * @param {number} [props.minutesStep] de cuánto en cuánto van los minutos; por omisión de uno en uno (15 para citas de
+ *     cuarto de hora)
+ * @param {string} [props.timeZone] otra zona que la del proveedor (la de una sucursal); rotulada igual
+ * @param {boolean} [props.showTimeZone] false quita el nombre de la zona de abajo (por omisión se ve)
+ * @param {string} [props.timeZoneLabel] ya traducido, en lugar del nombre que da el navegador
+ * @param {boolean} [props.disabled]
+ * @param {import('react').Ref<HTMLInputElement>} [props.inputRef]
+ * @param {object} [props.pickerProps] lo demás del DateTimePicker de MUI X que aquí no tiene nombre (views, shouldDisableDate,
+ *     slots, slotProps…); value y onChange son del campo
+ * @param {object} [props.texts] los textos que cambian, con la forma de `common` en los textos del paquete
+ */
+export default function DateTimeInput({ name, label, value, onChange, onBlur, error, helperText, minDateTime, minimumMinutesFromNow, maxDateTime, disableFuture, disablePast, minutesStep, timeZone, showTimeZone, timeZoneLabel, disabled, inputRef, pickerProps, texts, ...unknownProps }: {
+    name?: string;
+    label: string;
+    value: string | null | undefined;
+    onChange: (value: string) => void;
+    onBlur?: () => void;
+    error?: string | {
+        key: string;
+        values?: object;
+    };
+    helperText?: string;
+    minDateTime?: string;
+    minimumMinutesFromNow?: number;
+    maxDateTime?: string;
+    disableFuture?: boolean;
+    disablePast?: boolean;
+    minutesStep?: number;
+    timeZone?: string;
+    showTimeZone?: boolean;
+    timeZoneLabel?: string;
+    disabled?: boolean;
+    inputRef?: import('react').Ref<HTMLInputElement>;
+    pickerProps?: object;
+    texts?: object;
+}): import("react").JSX.Element;

package/dist/types/datePickers/FormDateTimeField.d.ts

@@ -0,0 +1,7 @@
+/**
+ * @param {{name: string} & Omit<Parameters<typeof import('./DateTimeInput.js').default>[0], 'name'|'value'|'onChange'|'onBlur'|'error'>} props las de
+ *     DateTimeInput (minDateTime, minimumMinutesFromNow, disablePast, minutesStep, timeZone…), sin value / onChange / onBlur / error
+ */
+export default function FormDateTimeField({ name, ...inputProps }: {
+    name: string;
+} & Omit<Parameters<typeof import('./DateTimeInput.js').default>[0], 'name' | 'value' | 'onChange' | 'onBlur' | 'error'>): import("react").JSX.Element;

package/dist/types/datePickers/FormMonthField.d.ts

@@ -0,0 +1,7 @@
+/**
+ * @param {{name: string} & Omit<Parameters<typeof import('./MonthInput.js').default>[0], 'name'|'value'|'onChange'|'onBlur'|'error'>} props las de
+ *     MonthInput (minMonth, maxMonth, disableFuture…), sin value / onChange / onBlur / error
+ */
+export default function FormMonthField({ name, ...inputProps }: {
+    name: string;
+} & Omit<Parameters<typeof import('./MonthInput.js').default>[0], 'name' | 'value' | 'onChange' | 'onBlur' | 'error'>): import("react").JSX.Element;

package/dist/types/datePickers/FormTimeField.d.ts

@@ -0,0 +1,7 @@
+/**
+ * @param {{name: string} & Omit<Parameters<typeof import('./TimeInput.js').default>[0], 'name'|'value'|'onChange'|'onBlur'|'error'>} props las de
+ *     TimeInput (minTime, maxTime, minutesStep…), sin value / onChange / onBlur / error
+ */
+export default function FormTimeField({ name, ...inputProps }: {
+    name: string;
+} & Omit<Parameters<typeof import('./TimeInput.js').default>[0], 'name' | 'value' | 'onChange' | 'onBlur' | 'error'>): import("react").JSX.Element;

package/dist/types/datePickers/MonthInput.d.ts

@@ -0,0 +1,39 @@
+/**
+ * @param {object} props
+ * @param {string} [props.name]
+ * @param {string} props.label ya traducido
+ * @param {string|null|undefined} props.value 'AAAA-MM' o ''
+ * @param {(value: string) => void} props.onChange recibe 'AAAA-MM' ('' al borrar o a medias)
+ * @param {() => void} [props.onBlur]
+ * @param {string|{key: string, values?: object}} [props.error]
+ * @param {string} [props.helperText]
+ * @param {string} [props.minMonth] 'AAAA-MM'
+ * @param {string} [props.maxMonth] 'AAAA-MM'
+ * @param {boolean} [props.disableFuture] p. ej. el mes de un reporte que ya cerró
+ * @param {boolean} [props.disablePast]
+ * @param {boolean} [props.disabled]
+ * @param {import('react').Ref<HTMLInputElement>} [props.inputRef]
+ * @param {object} [props.pickerProps] lo demás del DatePicker de MUI X que aquí no tiene nombre (shouldDisableMonth, slots,
+ *     slotProps…); value y onChange son del campo
+ * @param {object} [props.texts] los textos que cambian, con la forma de `common` en los textos del paquete
+ */
+export default function MonthInput({ name, label, value, onChange, onBlur, error, helperText, minMonth, maxMonth, disableFuture, disablePast, disabled, inputRef, pickerProps, texts, ...unknownProps }: {
+    name?: string;
+    label: string;
+    value: string | null | undefined;
+    onChange: (value: string) => void;
+    onBlur?: () => void;
+    error?: string | {
+        key: string;
+        values?: object;
+    };
+    helperText?: string;
+    minMonth?: string;
+    maxMonth?: string;
+    disableFuture?: boolean;
+    disablePast?: boolean;
+    disabled?: boolean;
+    inputRef?: import('react').Ref<HTMLInputElement>;
+    pickerProps?: object;
+    texts?: object;
+}): import("react").JSX.Element;

package/dist/types/datePickers/PickerFrame.d.ts

@@ -0,0 +1,22 @@
+import 'dayjs/locale/es.js';
+/**
+ * Los slotProps del selector con el campo de la casa y, encima, lo que pasó la pantalla en pickerProps.slotProps.
+ *
+ * @param {object} textField lo de la casa: id, name, onBlur, error, helperText
+ * @param {object} [pickerProps] lo que la pantalla le pasa al selector de MUI X
+ * @returns {object}
+ */
+export declare function textFieldSlotPropsOf(textField: object, pickerProps?: object): object;
+/**
+ * @param {object} props
+ * @param {string} props.inputId
+ * @param {import('react').ReactNode} props.label ya traducida
+ * @param {string} props.language el del proveedor más cercano
+ * @param {import('react').ReactNode} props.children el selector de MUI X
+ */
+export default function PickerFrame({ inputId, label, language, children }: {
+    inputId: string;
+    label: import('react').ReactNode;
+    language: string;
+    children: import('react').ReactNode;
+}): import("react").JSX.Element;

package/dist/types/datePickers/TimeInput.d.ts

@@ -0,0 +1,38 @@
+/**
+ * @param {object} props
+ * @param {string} [props.name]
+ * @param {string} props.label ya traducido
+ * @param {string|null|undefined} props.value 'HH:mm' o ''
+ * @param {(value: string) => void} props.onChange recibe 'HH:mm' ('' al borrar o a medias)
+ * @param {() => void} [props.onBlur]
+ * @param {string|{key: string, values?: object}} [props.error]
+ * @param {string} [props.helperText]
+ * @param {string} [props.minTime] 'HH:mm'
+ * @param {string} [props.maxTime] 'HH:mm'
+ * @param {number} [props.minutesStep] de cuánto en cuánto van los minutos; por omisión de uno en uno (30 para citas de
+ *     media hora)
+ * @param {boolean} [props.disabled]
+ * @param {import('react').Ref<HTMLInputElement>} [props.inputRef]
+ * @param {object} [props.pickerProps] lo demás del TimePicker de MUI X que aquí no tiene nombre (views, shouldDisableTime,
+ *     slots, slotProps…); value y onChange son del campo
+ * @param {object} [props.texts] los textos que cambian, con la forma de `common` en los textos del paquete
+ */
+export default function TimeInput({ name, label, value, onChange, onBlur, error, helperText, minTime, maxTime, minutesStep, disabled, inputRef, pickerProps, texts, ...unknownProps }: {
+    name?: string;
+    label: string;
+    value: string | null | undefined;
+    onChange: (value: string) => void;
+    onBlur?: () => void;
+    error?: string | {
+        key: string;
+        values?: object;
+    };
+    helperText?: string;
+    minTime?: string;
+    maxTime?: string;
+    minutesStep?: number;
+    disabled?: boolean;
+    inputRef?: import('react').Ref<HTMLInputElement>;
+    pickerProps?: object;
+    texts?: object;
+}): import("react").JSX.Element;

package/dist/types/datePickers/dateTimeRules.d.ts

@@ -0,0 +1,31 @@
+/**
+ * @param {number} minutes
+ * @returns {{name: string, message: {key: string, values: {count: number}}, test: (value: unknown) => boolean}}
+ */
+export declare function minutesFromNowRule(minutes: number): {
+    name: string;
+    message: {
+        key: string;
+        values: {
+            count: number;
+        };
+    };
+    test: (value: unknown) => boolean;
+};
+/**
+ * @param {string} startField el nombre del campo de inicio, en el mismo objeto del esquema
+ * @param {number} minutes
+ * @returns {{name: string, message: {key: string, values: {count: number}}, test: (value: unknown, context: {parent: object}) => boolean}}
+ */
+export declare function minutesAfterRule(startField: string, minutes: number): {
+    name: string;
+    message: {
+        key: string;
+        values: {
+            count: number;
+        };
+    };
+    test: (value: unknown, context: {
+        parent: object;
+    }) => boolean;
+};

package/dist/types/datePickers/pickerValues.d.ts

@@ -0,0 +1,114 @@
+import dayjs from 'dayjs';
+/** Cómo viaja una fecha de calendario. */
+export declare const CALENDAR_DATE_FORMAT = "YYYY-MM-DD";
+/** Cómo viaja un mes. */
+export declare const CALENDAR_MONTH_FORMAT = "YYYY-MM";
+/** Cómo viaja una hora del día (de 24 horas, aunque en pantalla se vea con a.m. y p.m.). */
+export declare const TIME_OF_DAY_FORMAT = "HH:mm";
+/** Cómo viaja un instante: en UTC, con la Z al final. */
+export declare const INSTANT_FORMAT = "YYYY-MM-DDTHH:mm:ss[Z]";
+/** De cuánto en cuánto van los minutos en la fecha con hora y en la hora: de uno en uno (MUI X trae de 5 en 5). */
+export declare const DEFAULT_MINUTES_STEP = 1;
+/** Un minuto. */
+export declare const MILLISECONDS_PER_MINUTE = 60000;
+/**
+ * dayjs con las zonas horarias puestas: el selector de MUI X las necesita para pintar un instante en otra zona.
+ * OJO: se llama al usarla y no al importar el archivo: el paquete se declara sin efectos al importar (sideEffects: false)
+ * y un import solo por su efecto se lo puede saltar el empaquetador del proyecto.
+ *
+ * @returns {typeof dayjs}
+ */
+export declare function zonedDayjs(): typeof dayjs;
+/**
+ * Cómo se ven en pantalla los cuatro campos.
+ *
+ * @param {string} language el del proveedor más cercano
+ * @param {'h23'|'h12'} [hourCycle] el del proveedor; por omisión de 24 horas
+ * @returns {{date: string, month: string, time: string, dateTime: string, ampm: boolean}}
+ */
+export declare function displayFormatsOf(language: string, hourCycle?: 'h23' | 'h12'): {
+    date: string;
+    month: string;
+    time: string;
+    dateTime: string;
+    ampm: boolean;
+};
+/**
+ * El nombre de la zona horaria como lo dice una persona («Hora estándar central», «Pacific Time»), para rotular la fecha
+ * con hora. Si el navegador no sabe nombrarla, la zona tal cual (America/Mexico_City).
+ *
+ * @param {string} timeZone la zona IANA del proveedor
+ * @param {string} intlLocale es-MX, en-US…
+ * @param {Date} [at] el momento que se nombra (en las zonas con horario de verano el nombre puede cambiar)
+ * @returns {string}
+ */
+export declare function timeZoneNameOf(timeZone: string, intlLocale: string, at?: Date): string;
+/**
+ * Un instante como lo quiere el selector, en la zona en que se pinta; null si está vacío o no se entiende.
+ *
+ * @param {string|null|undefined} instantText '2026-11-01T18:30:00Z' o con su desfase ('…-06:00')
+ * @param {string} timeZone la zona en que se pinta
+ * @returns {import('dayjs').Dayjs|null}
+ */
+export declare function pickerInstantOf(instantText: string | null | undefined, timeZone: string): import('dayjs').Dayjs | null;
+/**
+ * Lo que eligió la persona como instante en UTC; '' si está vacío o a medias.
+ *
+ * @param {import('dayjs').Dayjs|null} pickedValue
+ * @returns {string}
+ */
+export declare function instantTextOf(pickedValue: import('dayjs').Dayjs | null): string;
+/**
+ * El primer instante que se puede elegir cuando la regla es «al menos N minutos después de ahora» (publicar algo con
+ * anticipación): este minuto, sin segundos, más N minutos. Sin segundos para que la regla no cambie entre que la persona
+ * mira la hora y la elige.
+ *
+ * @param {number} minutes
+ * @param {Date|number} [now]
+ * @returns {string} el instante en UTC ('2026-11-02T18:35:00Z')
+ */
+export declare function earliestInstantFromNow(minutes: number, now?: Date | number): string;
+/**
+ * Un instante más N minutos (el fin de algo que dura al menos N minutos desde su inicio). '' si el instante viene vacío
+ * o no se entiende.
+ *
+ * @param {string|null|undefined} instantText
+ * @param {number} minutes
+ * @returns {string}
+ */
+export declare function instantPlusMinutes(instantText: string | null | undefined, minutes: number): string;
+/**
+ * El más tarde de varios instantes (los vacíos no cuentan): el mínimo que de verdad aplica cuando hay más de una regla.
+ *
+ * @param {...(string|null|undefined)} instantTexts
+ * @returns {string} '' si todos vienen vacíos
+ */
+export declare function latestInstantOf(...instantTexts: (string | null | undefined)[]): string;
+/**
+ * Una hora del día 'HH:mm' como la quiere el selector; null si está vacía o no tiene esa forma.
+ *
+ * @param {string|null|undefined} timeText
+ * @returns {import('dayjs').Dayjs|null}
+ */
+export declare function pickerTimeOf(timeText: string | null | undefined): import('dayjs').Dayjs | null;
+/**
+ * Lo que eligió la persona como 'HH:mm'; '' si está vacío o a medias.
+ *
+ * @param {import('dayjs').Dayjs|null} pickedValue
+ * @returns {string}
+ */
+export declare function timeTextOf(pickedValue: import('dayjs').Dayjs | null): string;
+/**
+ * Un mes 'AAAA-MM' como lo quiere el selector (su día 1); null si está vacío o no tiene esa forma.
+ *
+ * @param {string|null|undefined} monthText
+ * @returns {import('dayjs').Dayjs|null}
+ */
+export declare function pickerMonthOf(monthText: string | null | undefined): import('dayjs').Dayjs | null;
+/**
+ * Lo que eligió la persona como 'AAAA-MM'; '' si está vacío o a medias.
+ *
+ * @param {import('dayjs').Dayjs|null} pickedValue
+ * @returns {string}
+ */
+export declare function monthTextOf(pickedValue: import('dayjs').Dayjs | null): string;

package/dist/types/datePickers/useCurrentMinute.d.ts

@@ -0,0 +1,5 @@
+/**
+ * @param {boolean} enabled sin regla que dependa de la hora no hace falta el temporizador
+ * @returns {number} el inicio del minuto de ahora, en milisegundos
+ */
+export declare function useCurrentMinute(enabled: boolean): number;

package/dist/types/datePickers/usePickerField.d.ts

@@ -0,0 +1,24 @@
+import { displayFormatsOf } from './pickerValues.js';
+/**
+ * @param {object} field
+ * @param {string} [field.name]
+ * @param {string} field.kind de qué campo es (date, dateTime, time, month): da el principio del id si no hay name
+ * @param {string|{key: string, values?: object}} [field.error]
+ * @param {object} [field.texts] los textos que cambian, con la forma de `common`
+ * @returns {{language: string, timeZone: string, inputId: string, errorText: string|undefined, formats: ReturnType<typeof displayFormatsOf>}}
+ */
+export declare function usePickerField({ name, kind, error, texts }: {
+    name?: string;
+    kind: string;
+    error?: string | {
+        key: string;
+        values?: object;
+    };
+    texts?: object;
+}): {
+    language: string;
+    timeZone: string;
+    inputId: string;
+    errorText: string | undefined;
+    formats: ReturnType<typeof displayFormatsOf>;
+};

package/dist/types/dictionaries/dictionaries.d.ts

@@ -4,16 +4,19 @@
  * @param {string} value el código del API
  * @param {string} keyPrefix dónde viven sus textos dentro del namespace dictionaries ('orderStatus.paid' → orderStatus.paid.label)
  * @param {string} color color de paleta de MUI
- * @param {{hasShortLabel?: boolean}} [options] hasShortLabel: trae palabra corta (keyPrefix.shortLabel)
- * @returns {{value: string, labelKey: string, tooltipKey: string, shortLabelKey?: string, color: string, isKnown: boolean}}
+ * @param {{hasShortLabel?: boolean, icon?: import('react').ElementType}} [options] hasShortLabel: trae palabra corta
+ *     (keyPrefix.shortLabel); icon: el ícono con que se pinta en una insignia (IconBadge), p. ej. CreditCardOutlinedIcon
+ * @returns {{value: string, labelKey: string, tooltipKey: string, shortLabelKey?: string, icon?: import('react').ElementType, color: string, isKnown: boolean}}
  */
-export declare function dictionaryEntryOf(value: string, keyPrefix: string, color: string, { hasShortLabel }?: {
+export declare function dictionaryEntryOf(value: string, keyPrefix: string, color: string, { hasShortLabel, icon }?: {
     hasShortLabel?: boolean;
+    icon?: import('react').ElementType;
 }): {
     value: string;
     labelKey: string;
     tooltipKey: string;
     shortLabelKey?: string;
+    icon?: import('react').ElementType;
     color: string;
     isKnown: boolean;
 };

package/dist/types/forms/FormAttachmentsField.d.ts

@@ -0,0 +1,7 @@
+/**
+ * @param {{name: string} & Omit<Parameters<typeof import('../upload/AttachmentsInput.js').default>[0], 'name'|'value'|'onChange'|'onBlur'|'error'>} props las de
+ *     AttachmentsInput (accept, maxFiles, maxTotalSize, template…), sin value / onChange / onBlur / error
+ */
+export default function FormAttachmentsField({ name, ...inputProps }: {
+    name: string;
+} & Omit<Parameters<typeof import('../upload/AttachmentsInput.js').default>[0], 'name' | 'value' | 'onChange' | 'onBlur' | 'error'>): import("react").JSX.Element;

package/dist/types/forms/FormCheckboxGroupField.d.ts

@@ -0,0 +1,7 @@
+/**
+ * @param {{name: string} & Omit<Parameters<typeof import('../inputs/CheckboxGroupInput.js').default>[0], 'name'|'value'|'onChange'|'onBlur'|'error'>} props las de
+ *     CheckboxGroupInput, sin value / onChange / onBlur / error
+ */
+export default function FormCheckboxGroupField({ name, ...inputProps }: {
+    name: string;
+} & Omit<Parameters<typeof import('../inputs/CheckboxGroupInput.js').default>[0], 'name' | 'value' | 'onChange' | 'onBlur' | 'error'>): import("react").JSX.Element;

package/dist/types/forms/FormFileField.d.ts

@@ -0,0 +1,7 @@
+/**
+ * @param {{name: string} & Omit<Parameters<typeof import('../upload/FileInput.js').default>[0], 'name'|'value'|'onChange'|'onBlur'|'error'>} props las de
+ *     FileInput (accept, maxSize, template…), sin value / onChange / onBlur / error
+ */
+export default function FormFileField({ name, ...inputProps }: {
+    name: string;
+} & Omit<Parameters<typeof import('../upload/FileInput.js').default>[0], 'name' | 'value' | 'onChange' | 'onBlur' | 'error'>): import("react").JSX.Element;

package/dist/types/forms/FormFileUploadField.d.ts

@@ -0,0 +1,7 @@
+/**
+ * @param {{name: string} & Omit<Parameters<typeof import('../upload/FileUploadInput.js').default>[0], 'name'|'value'|'onChange'|'onBlur'|'error'>} props las de
+ *     FileUploadInput (upload, accept, maxSize, download…), sin value / onChange / onBlur / error
+ */
+export default function FormFileUploadField({ name, ...inputProps }: {
+    name: string;
+} & Omit<Parameters<typeof import('../upload/FileUploadInput.js').default>[0], 'name' | 'value' | 'onChange' | 'onBlur' | 'error'>): import("react").JSX.Element;

package/dist/types/forms/FormImageField.d.ts

@@ -0,0 +1,7 @@
+/**
+ * @param {{name: string} & Omit<Parameters<typeof import('../upload/ImageInput.js').default>[0], 'name'|'value'|'onChange'|'onBlur'|'error'>} props las de
+ *     ImageInput (shape, size, maxSize…), sin value / onChange / onBlur / error
+ */
+export default function FormImageField({ name, ...inputProps }: {
+    name: string;
+} & Omit<Parameters<typeof import('../upload/ImageInput.js').default>[0], 'name' | 'value' | 'onChange' | 'onBlur' | 'error'>): import("react").JSX.Element;

package/dist/types/forms/FormMaskedField.d.ts

@@ -0,0 +1,7 @@
+/**
+ * @param {{name: string} & Omit<Parameters<typeof import('../inputs/MaskedInput.js').default>[0], 'name'|'value'|'onChange'|'onBlur'|'error'>} props
+ *     las de MaskedInput (mask, label, helperText, placeholder…)
+ */
+export default function FormMaskedField({ name, ...inputProps }: {
+    name: string;
+} & Omit<Parameters<typeof import('../inputs/MaskedInput.js').default>[0], 'name' | 'value' | 'onChange' | 'onBlur' | 'error'>): import("react").JSX.Element;

package/dist/types/forms/FormRepeatingFields.d.ts

@@ -0,0 +1,25 @@
+/**
+ * @param {{
+ *   name: string,
+ *   emptyRow: object,
+ *   renderRow: (row: {index: number, row: any, nameOf: (field: string) => string}) => import('react').ReactNode,
+ *   removeBlockedReason?: (row: any, index: number) => string|null,
+ *   confirmRemove?: (row: any, index: number) => boolean,
+ *   onAdd?: (index: number) => void,
+ *   onRemove?: (row: any, index: number) => void,
+ * } & Omit<Parameters<typeof import('../inputs/RepeatingFields.js').default>[0], 'rowKeys'|'renderRow'|'onAdd'|'onRemove'|'onClear'|'removeBlockedReasonOf'|'confirmRemoveOf'|'rowHasErrorOf'|'error'>} props
+ *     name: la lista del formulario; emptyRow: cómo empieza un renglón nuevo; lo demás, lo de RepeatingFields
+ */
+export default function FormRepeatingFields({ name, emptyRow, renderRow, removeBlockedReason, confirmRemove, onAdd, onRemove, ...viewProps }: {
+    name: string;
+    emptyRow: object;
+    renderRow: (row: {
+        index: number;
+        row: any;
+        nameOf: (field: string) => string;
+    }) => import('react').ReactNode;
+    removeBlockedReason?: (row: any, index: number) => string | null;
+    confirmRemove?: (row: any, index: number) => boolean;
+    onAdd?: (index: number) => void;
+    onRemove?: (row: any, index: number) => void;
+} & Omit<Parameters<typeof import('../inputs/RepeatingFields.js').default>[0], 'rowKeys' | 'renderRow' | 'onAdd' | 'onRemove' | 'onClear' | 'removeBlockedReasonOf' | 'confirmRemoveOf' | 'rowHasErrorOf' | 'error'>): import("react").JSX.Element;

package/dist/types/forms/FormTransferListField.d.ts

@@ -0,0 +1,7 @@
+/**
+ * @param {{name: string} & Omit<Parameters<typeof import('../inputs/TransferListInput.js').default>[0], 'name'|'value'|'onChange'|'onBlur'|'error'>} props las de
+ *     TransferListInput, sin value / onChange / onBlur / error
+ */
+export default function FormTransferListField({ name, ...inputProps }: {
+    name: string;
+} & Omit<Parameters<typeof import('../inputs/TransferListInput.js').default>[0], 'name' | 'value' | 'onChange' | 'onBlur' | 'error'>): import("react").JSX.Element;

package/dist/types/forms/index.d.ts

@@ -1,7 +1,16 @@
+export { default as FormAttachmentsField } from './FormAttachmentsField.js';
 export { default as FormCatalogField } from './FormCatalogField.js';
+export { default as FormCheckboxGroupField } from './FormCheckboxGroupField.js';
 export { default as FormColorField } from './FormColorField.js';
+export { default as FormFileField } from './FormFileField.js';
+export { default as FormFileUploadField } from './FormFileUploadField.js';
+export { default as FormImageField } from './FormImageField.js';
+export { default as FormMaskedField } from './FormMaskedField.js';
 export { default as FormNumberField } from './FormNumberField.js';
 export { default as FormProblemAlert } from './FormProblemAlert.js';
+export { default as FormRepeatingFields } from './FormRepeatingFields.js';
+export { default as FormTransferListField } from './FormTransferListField.js';
+export { listTotalAtMostRule, listTotalOf, orderedInListRule, uniqueInListRule } from './listRules.js';
 export { default as FormSelectField } from './FormSelectField.js';
 export { default as FormServerProblem } from './FormServerProblem.js';
 export { default as FormTextField } from './FormTextField.js';
@@ -14,6 +23,6 @@ export { default as TwoStepVerificationCard } from './security/TwoStepVerificati
 export { RECOVERY_CODE_PATTERN, TOTP_CODE_PATTERN, normalizeRecoveryCode, normalizeTotpCode, } from './security/securityRules.js';
 export { default as SubmitButton } from './SubmitButton.js';
 export { applyServerProblem } from './applyServerProblem.js';
-export { formLevelMessageOf, splitServerFieldErrors } from './serverProblemFields.js';
+export { formLevelMessageOf, splitRowFieldErrors, splitServerFieldErrors } from './serverProblemFields.js';
 export { useFormikField } from './useFormikField.js';
 export { Yup, buildYupLocale, translateValidationMessage } from './validation.js';

package/dist/types/forms/listRules.d.ts

@@ -0,0 +1,48 @@
+import { Money } from '../money/money.js';
+/**
+ * Sin repetidos en una columna: el renglón que repite dice con cuál choca.
+ *
+ * @param {string} listName la lista en el formulario ('tiers')
+ * @param {string} field la columna ('min_quantity')
+ * @returns {import('yup').TestConfig<any, any>} para .test() de yup
+ */
+export declare function uniqueInListRule(listName: string, field: string): import('yup').TestConfig<any, any>;
+/**
+ * En orden por una columna, comparado con el renglón de arriba y el de abajo que tengan valor.
+ *
+ * @param {string} listName
+ * @param {string} field
+ * @param {{ascending?: boolean, allowEqual?: boolean, displayOf?: (text: string) => string}} [options] ascending: de menor
+ *     a mayor (por omisión); displayOf: cómo se dice el valor del vecino en el mensaje (p. ej. con %)
+ * @returns {import('yup').TestConfig<any, any>} para .test() de yup
+ */
+export declare function orderedInListRule(listName: string, field: string, { ascending, allowEqual, displayOf }?: {
+    ascending?: boolean;
+    allowEqual?: boolean;
+    displayOf?: (text: string) => string;
+}): import('yup').TestConfig<any, any>;
+/**
+ * Lo que suma una columna, con Money (sin errores de decimales). Los vacíos cuentan como cero y los que no son número no
+ * cuentan (su propio campo ya lo dice).
+ *
+ * @param {object[]} rows
+ * @param {string} field
+ * @param {{currency?: string}} [options]
+ * @returns {Money}
+ */
+export declare function listTotalOf(rows: object[], field: string, { currency }?: {
+    currency?: string;
+}): Money;
+/**
+ * Lo que suman entre todos no pasa de un tope (el reparto de un presupuesto, de un límite de crédito). Va en la lista:
+ * Yup.array().test(listTotalAtMostRule(…)); el mensaje sale abajo de la lista.
+ *
+ * @param {string} field la columna que se suma
+ * @param {number|string|((parent: object) => number|string|null)} max el tope, o cómo sacarlo de los demás valores del
+ *     formulario (el límite que se escribió arriba)
+ * @param {{currency?: string}} [options]
+ * @returns {import('yup').TestConfig<any, any>} para .test() de yup
+ */
+export declare function listTotalAtMostRule(field: string, max: number | string | ((parent: object) => number | string | null), { currency }?: {
+    currency?: string;
+}): import('yup').TestConfig<any, any>;

package/dist/types/forms/serverProblemFields.d.ts

@@ -17,3 +17,16 @@ export declare function splitServerFieldErrors(errorsByField: Record<string, str
  * @returns {string|null}
  */
 export declare function formLevelMessageOf(errorsByField: Record<string, string[]>, formFieldNames: string[], generalMessage: string | null | undefined): string | null;
+/**
+ * Separa los errores de un 422 que son de un campo DENTRO de un renglón que el formulario sí tiene ('contacts.2.email'
+ * con contacts[2] en los valores): esos van a su renglón con la ruta completa. Los demás siguen el camino de siempre
+ * (fieldErrorsOf los reduce a su último nombre: 'rows.3.email' → 'email').
+ *
+ * @param {object|null|undefined} rawErrors problem.errors tal cual ({ruta: [mensajes]})
+ * @param {(path: string) => boolean} existsInForm si esa ruta existe en los valores del formulario
+ * @returns {{rowFieldErrors: Record<string, string>, otherErrors: Record<string, unknown>}}
+ */
+export declare function splitRowFieldErrors(rawErrors: object | null | undefined, existsInForm: (path: string) => boolean): {
+    rowFieldErrors: Record<string, string>;
+    otherErrors: Record<string, unknown>;
+};

package/dist/types/forms.d.ts

@@ -1,2 +1,2 @@
 export { FieldArray, Form, Formik, useField, useFormikContext } from 'formik';
-export { ChangePasswordForm, ForgotPasswordForm, FormCatalogField, FormColorField, FormNumberField, FormProblemAlert, FormSelectField, FormServerProblem, FormTextField, FormWizard, RECOVERY_CODE_PATTERN, SECOND_STEP_METHOD, SecondStepForm, SignInForm, SubmitButton, TOTP_CODE_PATTERN, TwoStepVerificationCard, Yup, applyServerProblem, buildYupLocale, formLevelMessageOf, normalizeRecoveryCode, normalizeTotpCode, splitServerFieldErrors, translateValidationMessage, useFormikField, } from './forms/index.js';
+export { ChangePasswordForm, ForgotPasswordForm, FormAttachmentsField, FormCatalogField, FormCheckboxGroupField, FormColorField, FormFileField, FormFileUploadField, FormImageField, FormMaskedField, FormNumberField, FormProblemAlert, FormRepeatingFields, FormSelectField, FormServerProblem, FormTransferListField, FormTextField, FormWizard, RECOVERY_CODE_PATTERN, SECOND_STEP_METHOD, SecondStepForm, SignInForm, SubmitButton, TOTP_CODE_PATTERN, TwoStepVerificationCard, Yup, applyServerProblem, buildYupLocale, formLevelMessageOf, normalizeRecoveryCode, normalizeTotpCode, listTotalAtMostRule, listTotalOf, orderedInListRule, splitRowFieldErrors, splitServerFieldErrors, translateValidationMessage, uniqueInListRule, useFormikField, } from './forms/index.js';

package/dist/types/hookForm/FormAttachmentsField.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @param {{name: string, control?: object} & Omit<Parameters<typeof import('../upload/AttachmentsInput.js').default>[0], 'name'|'value'|'onChange'|'onBlur'|'error'>} props las del campo de la casa, sin
+ *     value / onChange / onBlur / error; control: el de useForm, si la pantalla no usa FormProvider
+ */
+export default function FormAttachmentsField({ name, control, ...inputProps }: {
+    name: string;
+    control?: object;
+} & Omit<Parameters<typeof import('../upload/AttachmentsInput.js').default>[0], 'name' | 'value' | 'onChange' | 'onBlur' | 'error'>): import("react").JSX.Element;

package/dist/types/hookForm/FormCheckboxGroupField.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @param {{name: string, control?: object} & Omit<Parameters<typeof import('../inputs/CheckboxGroupInput.js').default>[0], 'name'|'value'|'onChange'|'onBlur'|'error'>} props las del campo de la casa, sin
+ *     value / onChange / onBlur / error; control: el de useForm, si la pantalla no usa FormProvider
+ */
+export default function FormCheckboxGroupField({ name, control, ...inputProps }: {
+    name: string;
+    control?: object;
+} & Omit<Parameters<typeof import('../inputs/CheckboxGroupInput.js').default>[0], 'name' | 'value' | 'onChange' | 'onBlur' | 'error'>): import("react").JSX.Element;