@stackcraftmx/calcita 0.52.0 → 0.54.0

package/dist/toolkit/toolkitContext.js.map

@@ -1 +1 @@
-{"version":3,"file":"toolkitContext.js","sources":["../../src/toolkit/toolkitContext.js"],"sourcesContent":["// El contexto de ToolkitProvider y los hooks que lo leen. Vive aparte del proveedor (que es .jsx) para que los hooks se\n// importen desde archivos .js sin arrastrar JSX.\n//\n// Hooks genéricos: function (regla de la casa).\nimport {createContext, useContext} from 'react';\nimport {allowOnlyUnrestricted} from '@/access/accessRules.js';\nimport {browserNavigation} from '@/toolkit/browserNavigation.js';\nimport {toolkitSettings} from '@/toolkit/toolkitSettings.js';\n\nexport const ToolkitContext = createContext(null);\n\n/**\n * La configuración del proveedor; sin proveedor, la vigente con la navegación del navegador.\n *\n * @returns {{language: string, onLanguageChange: Function|null, texts: object, translate: Function|null, timeZone: string, currency: string, hourCycle: 'h23'|'h12', appName: string, buildId: string, navigation: object, canAccess: Function}}\n */\nexport function useToolkitSettings() {\n    const settings = useContext(ToolkitContext);\n\n    return settings ?? {...toolkitSettings(), onLanguageChange: null, navigation: browserNavigation, canAccess: allowOnlyUnrestricted};\n}\n\n/**\n * La navegación que conectó el proyecto: {useNavigate, useLocation, Link}.\n *\n * @returns {{useNavigate: Function, useLocation: Function, Link: import('react').ElementType}}\n */\nexport function useToolkitNavigation() {\n    return useToolkitSettings().navigation;\n}\n"],"names":[],"mappings":";;;;;AASY,MAAC,iBAAiB,cAAc,IAAI;AAOzC,SAAS,qBAAqB;AACjC,QAAM,WAAW,WAAW,cAAc;AAE1C,SAAO,YAAY,EAAC,GAAG,mBAAmB,kBAAkB,MAAM,YAAY,mBAAmB,WAAW,sBAAqB;AACrI;AAOO,SAAS,uBAAuB;AACnC,SAAO,mBAAkB,EAAG;AAChC;"}
+{"version":3,"file":"toolkitContext.js","sources":["../../src/toolkit/toolkitContext.js"],"sourcesContent":["// El contexto de ToolkitProvider y los hooks que lo leen. Vive aparte del proveedor (que es .jsx) para que los hooks se\n// importen desde archivos .js sin arrastrar JSX.\n//\n// Hooks genéricos: function (regla de la casa).\nimport {createContext, useContext} from 'react';\nimport {allowOnlyUnrestricted} from '@/access/accessRules.js';\nimport {browserNavigation} from '@/toolkit/browserNavigation.js';\nimport {toolkitSettings} from '@/toolkit/toolkitSettings.js';\n\nexport const ToolkitContext = createContext(null);\n\n/**\n * La configuración del proveedor; sin proveedor, la vigente con la navegación del navegador.\n *\n * @returns {{language: string, onLanguageChange: Function|null, requiredFromSchema?: boolean, texts: object, translate: Function|null, timeZone: string, currency: string, hourCycle: 'h23'|'h12', appName: string, buildId: string, navigation: object, canAccess: Function}}\n */\nexport function useToolkitSettings() {\n    const settings = useContext(ToolkitContext);\n\n    return settings ?? {...toolkitSettings(), onLanguageChange: null, navigation: browserNavigation, canAccess: allowOnlyUnrestricted};\n}\n\n/**\n * La navegación que conectó el proyecto: {useNavigate, useLocation, Link}.\n *\n * @returns {{useNavigate: Function, useLocation: Function, Link: import('react').ElementType}}\n */\nexport function useToolkitNavigation() {\n    return useToolkitSettings().navigation;\n}\n"],"names":[],"mappings":";;;;;AASY,MAAC,iBAAiB,cAAc,IAAI;AAOzC,SAAS,qBAAqB;AACjC,QAAM,WAAW,WAAW,cAAc;AAE1C,SAAO,YAAY,EAAC,GAAG,mBAAmB,kBAAkB,MAAM,YAAY,mBAAmB,WAAW,sBAAqB;AACrI;AAOO,SAAS,uBAAuB;AACnC,SAAO,mBAAkB,EAAG;AAChC;"}

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

@@ -17,6 +17,8 @@ declare const DateInput: (props: {
     disablePast?: boolean;
     openTo?: 'day' | 'month' | 'year';
     disabled?: boolean;
+    format?: string;
+    required?: boolean;
     inputRef?: import('react').Ref<HTMLInputElement>;
     pickerProps?: object;
     messages?: Record<string, string | object>;

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

@@ -19,6 +19,8 @@ declare const DateTimeInput: (props: {
     showTimeZone?: boolean;
     timeZoneLabel?: string;
     disabled?: boolean;
+    format?: string;
+    required?: boolean;
     inputRef?: import('react').Ref<HTMLInputElement>;
     pickerProps?: object;
     messages?: Record<string, string | object>;

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

@@ -1,7 +1,7 @@
 /**
- * @param {{name: string} & Omit<Parameters<typeof import('./DateInput.js').default>[0], 'name'|'value'|'onChange'|'onBlur'|'error'>} props las de
- *     DateInput (minDate, maxDate, disableFuture, openTo…), sin value / onChange / onBlur / error
+ * @param {{name: string} & Omit<Parameters<typeof import('./DateInput.js').default>[0], 'name'|'value'|'onChange'|'onBlur'|'error'> & Partial<Pick<Parameters<typeof import('./DateInput.js').default>[0], 'onChange'|'onBlur'>>} props las de
+ *     DateInput (minDate, maxDate, disableFuture, openTo…), sin value ni error (su onChange y su onBlur corren después de los del formulario)
  */
 export default function FormDateField({ name, ...dateInputProps }: {
     name: string;
-} & Omit<Parameters<typeof import('./DateInput.js').default>[0], 'name' | 'value' | 'onChange' | 'onBlur' | 'error'>): import("react").JSX.Element;
+} & Omit<Parameters<typeof import('./DateInput.js').default>[0], 'name' | 'value' | 'onChange' | 'onBlur' | 'error'> & Partial<Pick<Parameters<typeof import('./DateInput.js').default>[0], 'onChange' | 'onBlur'>>): import("react").JSX.Element;

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

@@ -1,7 +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
+ * @param {{name: string} & Omit<Parameters<typeof import('./DateTimeInput.js').default>[0], 'name'|'value'|'onChange'|'onBlur'|'error'> & Partial<Pick<Parameters<typeof import('./DateTimeInput.js').default>[0], 'onChange'|'onBlur'>>} props las de
+ *     DateTimeInput (minDateTime, minimumMinutesFromNow, disablePast, minutesStep, timeZone…), sin value ni error (su onChange y su onBlur corren después de los del formulario)
  */
 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;
+} & Omit<Parameters<typeof import('./DateTimeInput.js').default>[0], 'name' | 'value' | 'onChange' | 'onBlur' | 'error'> & Partial<Pick<Parameters<typeof import('./DateTimeInput.js').default>[0], 'onChange' | 'onBlur'>>): import("react").JSX.Element;

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

@@ -1,7 +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
+ * @param {{name: string} & Omit<Parameters<typeof import('./MonthInput.js').default>[0], 'name'|'value'|'onChange'|'onBlur'|'error'> & Partial<Pick<Parameters<typeof import('./MonthInput.js').default>[0], 'onChange'|'onBlur'>>} props las de
+ *     MonthInput (minMonth, maxMonth, disableFuture…), sin value ni error (su onChange y su onBlur corren después de los del formulario)
  */
 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;
+} & Omit<Parameters<typeof import('./MonthInput.js').default>[0], 'name' | 'value' | 'onChange' | 'onBlur' | 'error'> & Partial<Pick<Parameters<typeof import('./MonthInput.js').default>[0], 'onChange' | 'onBlur'>>): import("react").JSX.Element;

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

@@ -1,7 +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
+ * @param {{name: string} & Omit<Parameters<typeof import('./TimeInput.js').default>[0], 'name'|'value'|'onChange'|'onBlur'|'error'> & Partial<Pick<Parameters<typeof import('./TimeInput.js').default>[0], 'onChange'|'onBlur'>>} props las de
+ *     TimeInput (minTime, maxTime, minutesStep…), sin value ni error (su onChange y su onBlur corren después de los del formulario)
  */
 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;
+} & Omit<Parameters<typeof import('./TimeInput.js').default>[0], 'name' | 'value' | 'onChange' | 'onBlur' | 'error'> & Partial<Pick<Parameters<typeof import('./TimeInput.js').default>[0], 'onChange' | 'onBlur'>>): import("react").JSX.Element;

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

@@ -14,6 +14,8 @@ declare const MonthInput: (props: {
     disableFuture?: boolean;
     disablePast?: boolean;
     disabled?: boolean;
+    format?: string;
+    required?: boolean;
     inputRef?: import('react').Ref<HTMLInputElement>;
     pickerProps?: object;
     messages?: Record<string, string | object>;

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

@@ -12,11 +12,13 @@ export declare function textFieldSlotPropsOf(textField: object, pickerProps?: ob
  * @param {string} props.inputId
  * @param {import('react').ReactNode} props.label ya traducida
  * @param {string} props.language el del proveedor más cercano
+ * @param {boolean} [props.required] el asterisco en la etiqueta
  * @param {import('react').ReactNode} props.children el selector de MUI X
  */
-export default function PickerFrame({ inputId, label, language, children }: {
+export default function PickerFrame({ inputId, label, language, required, children }: {
     inputId: string;
     label: import('react').ReactNode;
     language: string;
+    required?: boolean;
     children: import('react').ReactNode;
 }): import("react").JSX.Element;

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

@@ -13,6 +13,8 @@ declare const TimeInput: (props: {
     maxTime?: string;
     minutesStep?: number;
     disabled?: boolean;
+    format?: string;
+    required?: boolean;
     inputRef?: import('react').Ref<HTMLInputElement>;
     pickerProps?: object;
     messages?: Record<string, string | object>;

package/dist/types/feedback/Toaster.d.ts

@@ -1 +1,15 @@
-export default function Toaster(): import("react").JSX.Element;
+/** Dónde salen los avisos (los nombres de sonner). */
+export declare const TOASTER_POSITION: Readonly<{
+    topLeft: "top-left";
+    topCenter: "top-center";
+    topRight: "top-right";
+    bottomLeft: "bottom-left";
+    bottomCenter: "bottom-center";
+    bottomRight: "bottom-right";
+}>;
+/**
+ * @param {import('sonner').ToasterProps} props lo de sonner, tal cual (https://sonner.emilkowal.ski/toaster: duration,
+ *     offset, mobileOffset, visibleToasts, toastOptions…). Por omisión: position abajo a la izquierda (uno de
+ *     TOASTER_POSITION), richColors y closeButton sí, y theme el modo de MUI que se ve en pantalla
+ */
+export default function Toaster({ position, richColors, closeButton, ...sonnerProps }: import('sonner').ToasterProps): import("react").JSX.Element;

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

@@ -2,7 +2,7 @@ export { default as ConfirmDialog } from './ConfirmDialog.js';
 export { default as ModalWaiting } from './ModalWaiting.js';
 export { NEW_BUILD_NOTICE_VARIANT, default as NewBuildNotice } from './NewBuildNotice.js';
 export { default as StaleBuildBoundary } from './StaleBuildBoundary.js';
-export { default as Toaster } from './Toaster.js';
+export { TOASTER_POSITION, default as Toaster } from './Toaster.js';
 export { confirmActionMachine } from './confirmActionMachine.js';
 export { TOAST_DEFAULT_OPTIONS, dismissToast, errorsObjectToMessage, toastDefault, toastError, toastInfo, toastLoading, toastProblem, toastPromise, toastSuccess, toastWarn, } from './toast.js';
 export { useConfirmAction } from './useConfirmAction.js';

package/dist/types/filepond/FileDropzone.d.ts

@@ -27,6 +27,11 @@ declare const FileDropzone: (props: {
         total: number;
     }) => void;
     onReject?: (file: File | null, reason: string, message?: string) => void;
+    chunkUploads?: boolean;
+    chunkForce?: boolean;
+    chunkSize?: number | string;
+    chunkRetryDelays?: number[] | null;
+    pondProps?: Partial<import('filepond').FilePondOptions> | null;
     actions?: import('react').ReactNode;
     children?: import('react').ReactNode;
     sx?: object;

package/dist/types/filepond/chunkedUpload.d.ts

@@ -0,0 +1,122 @@
+/** Los headers del protocolo de trozos de FilePond. */
+export declare const CHUNK_HEADER: Readonly<{
+    length: "Upload-Length";
+    offset: "Upload-Offset";
+    name: "Upload-Name";
+    contentType: "Content-Type";
+}>;
+/** Por qué no se pudo subir: el servidor dijo que no, no contestó, o no dio el folio de la subida. */
+export declare const UPLOAD_FAILURE: Readonly<{
+    rejected: "rejected";
+    noResponse: "noResponse";
+    noTransferId: "noTransferId";
+}>;
+/** Una subida que no salió: el motivo (UPLOAD_FAILURE) y la respuesta del servidor, si la hubo. */
+export declare class UploadFailure extends Error {
+    reason: string;
+    response: Response | null;
+    /**
+     * @param {string} reason de UPLOAD_FAILURE
+     * @param {Response|null} [response]
+     */
+    constructor(reason: string, response?: Response | null);
+}
+/**
+ * Los trozos de un archivo: dónde empieza y dónde acaba cada uno. Un archivo vacío es un trozo vacío: el servidor igual
+ * necesita saber que el archivo llegó completo.
+ *
+ * @param {number} fileSize en bytes
+ * @param {number} chunkSize en bytes
+ * @returns {{index: number, offset: number, end: number}[]}
+ */
+export declare function chunkPiecesOf(fileSize: number, chunkSize: number): {
+    index: number;
+    offset: number;
+    end: number;
+}[];
+/**
+ * Lo que la barra puede decir que ya subió: lo que el servidor confirmó más lo que va en camino del trozo de ahora, sin
+ * llegar al final hasta que el servidor confirma el último trozo.
+ *
+ * @param {{confirmedBytes: number, sendingBytes: number, totalBytes: number}} transfer
+ * @returns {number} bytes
+ */
+export declare function honestLoadedOf({ confirmedBytes, sendingBytes, totalBytes }: {
+    confirmedBytes: number;
+    sendingBytes: number;
+    totalBytes: number;
+}): number;
+/**
+ * Hasta dónde ya está guardado el archivo cuando el servidor dice su Upload-Offset: el final del último trozo COMPLETO antes
+ * de ese punto. Un trozo que quedó a medias se vuelve a mandar entero.
+ *
+ * @param {{offset: number, end: number}[]} pieces
+ * @param {number} serverOffset
+ * @returns {number}
+ */
+export declare function storedBytesOf(pieces: {
+    offset: number;
+    end: number;
+}[], serverOffset: number): number;
+/**
+ * Un texto listo para viajar en un header. Los headers solo llevan bytes: el texto va en UTF-8 byte por byte (lo mismo que
+ * FilePond hace con los suyos). Sin esto, un nombre con «–» o con un emoji tumba la petición y uno con acentos llega roto.
+ *
+ * @param {unknown} value
+ * @returns {string}
+ */
+export declare function headerTextOf(value: unknown): string;
+export type PondSendRequest = (url: string, body: FormData | Blob | null, options: {
+    method: string;
+    headers: Record<string, string>;
+    withCredentials: boolean;
+    signal: AbortSignal;
+    onProgress?: (percent: number, transfer: {
+        loaded: number;
+        total: number;
+    }) => void;
+}) => Promise<Response>;
+/**
+ * @typedef {(url: string, body: FormData|Blob|null, options: {method: string, headers: Record<string, string>, withCredentials: boolean, signal: AbortSignal, onProgress?: (percent: number, transfer: {loaded: number, total: number}) => void}) => Promise<Response>} PondSendRequest
+ *   cómo viaja cada petición: la misma forma que uploadWithProgress de la casa
+ */
+/**
+ * Sube un archivo por trozos (ver el encabezado). Regresa la subida en curso: done termina con el folio que dio el servidor
+ * y abort la cancela de verdad (la petición de ahora y los reintentos que esperaban).
+ *
+ * @param {object} options
+ * @param {Blob} options.file
+ * @param {string} options.fileName el que viaja en Upload-Name
+ * @param {string} options.fieldName el campo del primer POST: lleva los metadatos en JSON, como FilePond
+ * @param {object|null} [options.metadata]
+ * @param {string} options.url a dónde va el POST que pide el folio
+ * @param {string} options.patchUrl a dónde va cada trozo: el folio va pegado al final ('/subidas?patch=')
+ * @param {Record<string, unknown>} [options.headers] van en las tres peticiones (Authorization, los datos de la pantalla)
+ * @param {boolean} [options.withCredentials]
+ * @param {number} options.chunkSize en bytes
+ * @param {number[]|null} [options.retryDelays] las esperas entre reintentos, en milisegundos; null o [] = sin reintentos
+ * @param {string|null} [options.transferId] el folio de un intento anterior: se sigue desde donde se quedó
+ * @param {(transferId: string) => void} [options.onTransferId] el folio nuevo, para retomar si algo falla
+ * @param {(loaded: number, total: number) => void} [options.onProgress] lo honesto (ver honestLoadedOf), en bytes
+ * @param {PondSendRequest} options.sendRequest
+ * @returns {{done: Promise<string>, abort: () => void}}
+ */
+export declare function startChunkedUpload(options: {
+    file: Blob;
+    fileName: string;
+    fieldName: string;
+    metadata?: object | null;
+    url: string;
+    patchUrl: string;
+    headers?: Record<string, unknown>;
+    withCredentials?: boolean;
+    chunkSize: number;
+    retryDelays?: number[] | null;
+    transferId?: string | null;
+    onTransferId?: (transferId: string) => void;
+    onProgress?: (loaded: number, total: number) => void;
+    sendRequest: PondSendRequest;
+}): {
+    done: Promise<string>;
+    abort: () => void;
+};

package/dist/types/filepond/pondServer.d.ts

@@ -1,16 +1,38 @@
+/**
+ * ¿Este archivo va por trozos? La regla de FilePond: la zona los pidió y el archivo pasa del tamaño del trozo, o la zona los
+ * fuerza para todos (hay servidores que solo reciben por trozos).
+ *
+ * @param {Blob} file
+ * @param {{chunkUploads?: boolean, chunkForce?: boolean, chunkSize?: number}} options lo que FilePond le pasa al server
+ * @returns {boolean}
+ */
+export declare function usesChunks(file: Blob, options: {
+    chunkUploads?: boolean;
+    chunkForce?: boolean;
+    chunkSize?: number;
+}): boolean;
 /**
  * @param {object} options
- * @param {string} options.url a dónde va cada archivo
+ * @param {string} options.url a dónde va cada archivo (por trozos: el POST que pide el folio)
  * @param {string} [options.fieldName] el campo del archivo en el FormData; por omisión el name de la zona
- * @param {Record<string, string>} [options.headers] p. ej. Authorization
+ * @param {Record<string, string>} [options.headers] p. ej. Authorization; por trozos van en las tres peticiones
  * @param {boolean} [options.withCredentials] manda las cookies a otro dominio
+ * @param {string} [options.patchUrl] por trozos: a dónde va cada trozo, con el folio pegado al final. Por omisión, el de
+ *     FilePond: url + '?patch='
+ * @param {(body: any, response: Response) => any} [options.toProblem] el error del backend a la forma RFC 9457 (Laravel:
+ *     body => ({title: body.message}))
+ * @param {import('../upload/chunkedUpload.js').UploadSendRequest} [options.sendRequest] cómo viaja cada petición; por omisión
+ *     uploadWithProgress de la casa
  * @returns {{process: (...args: any[]) => any, revert: (...args: any[]) => any}} lo que recibe la prop server de FileDropzone
  */
-export declare function createPondServer({ url, fieldName, headers, withCredentials }: {
+export declare function createPondServer({ url, fieldName, headers, withCredentials, patchUrl, toProblem, sendRequest }: {
     url: string;
     fieldName?: string;
     headers?: Record<string, string>;
     withCredentials?: boolean;
+    patchUrl?: string;
+    toProblem?: (body: any, response: Response) => any;
+    sendRequest?: import('../upload/chunkedUpload.js').UploadSendRequest;
 }): {
     process: (...args: any[]) => any;
     revert: (...args: any[]) => any;

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

@@ -0,0 +1,6 @@
+/**
+ * @template {import('formik').FormikValues} Values
+ * @param {import('formik').FormikConfig<Values>} props las de Formik de formik
+ * @returns {import('react').JSX.Element}
+ */
+export default function Formik<Values extends import('formik').FormikValues>(props: import('formik').FormikConfig<Values>): import('react').JSX.Element;

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

@@ -1,7 +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
+ * @param {{name: string} & Omit<Parameters<typeof import('../upload/AttachmentsInput.js').default>[0], 'name'|'value'|'onChange'|'onBlur'|'error'> & Partial<Pick<Parameters<typeof import('../upload/AttachmentsInput.js').default>[0], 'onChange'|'onBlur'>>} props las de
+ *     AttachmentsInput (accept, maxFiles, maxTotalSize, template…), sin value ni error (su onChange y su onBlur corren después de los del formulario)
  */
 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;
+} & Omit<Parameters<typeof import('../upload/AttachmentsInput.js').default>[0], 'name' | 'value' | 'onChange' | 'onBlur' | 'error'> & Partial<Pick<Parameters<typeof import('../upload/AttachmentsInput.js').default>[0], 'onChange' | 'onBlur'>>): import("react").JSX.Element;

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

@@ -1,6 +1,6 @@
 /**
- * @param {{name: string} & Omit<Parameters<typeof import('../inputs/CatalogInput.js').default>[0], 'name'|'value'|'onChange'|'onBlur'|'error'>} props las de CatalogInput (options, formatLabel, loading…), sin value / onChange / onBlur / error
+ * @param {{name: string} & Omit<Parameters<typeof import('../inputs/CatalogInput.js').default>[0], 'name'|'value'|'onChange'|'onBlur'|'error'> & Partial<Pick<Parameters<typeof import('../inputs/CatalogInput.js').default>[0], 'onChange'|'onBlur'>>} props las de CatalogInput (options, formatLabel, loading…), sin value ni error (su onChange y su onBlur corren después de los del formulario)
  */
 export default function FormCatalogField({ name, ...catalogInputProps }: {
     name: string;
-} & Omit<Parameters<typeof import('../inputs/CatalogInput.js').default>[0], 'name' | 'value' | 'onChange' | 'onBlur' | 'error'>): import("react").JSX.Element;
+} & Omit<Parameters<typeof import('../inputs/CatalogInput.js').default>[0], 'name' | 'value' | 'onChange' | 'onBlur' | 'error'> & Partial<Pick<Parameters<typeof import('../inputs/CatalogInput.js').default>[0], 'onChange' | 'onBlur'>>): import("react").JSX.Element;

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

@@ -1,7 +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
+ * @param {{name: string} & Omit<Parameters<typeof import('../inputs/CheckboxGroupInput.js').default>[0], 'name'|'value'|'onChange'|'onBlur'|'error'> & Partial<Pick<Parameters<typeof import('../inputs/CheckboxGroupInput.js').default>[0], 'onChange'|'onBlur'>>} props las de
+ *     CheckboxGroupInput, sin value ni error (su onChange y su onBlur corren después de los del formulario)
  */
 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;
+} & Omit<Parameters<typeof import('../inputs/CheckboxGroupInput.js').default>[0], 'name' | 'value' | 'onChange' | 'onBlur' | 'error'> & Partial<Pick<Parameters<typeof import('../inputs/CheckboxGroupInput.js').default>[0], 'onChange' | 'onBlur'>>): import("react").JSX.Element;

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

@@ -1,6 +1,6 @@
 /**
- * @param {{name: string} & Omit<Parameters<typeof import('../inputs/ColorInput.js').default>[0], 'name'|'value'|'onChange'|'onBlur'|'error'>} props las de ColorInput (checkContrast…), sin value / onChange / onBlur / error
+ * @param {{name: string} & Omit<Parameters<typeof import('../inputs/ColorInput.js').default>[0], 'name'|'value'|'onChange'|'onBlur'|'error'> & Partial<Pick<Parameters<typeof import('../inputs/ColorInput.js').default>[0], 'onChange'|'onBlur'>>} props las de ColorInput (checkContrast…), sin value ni error (su onChange y su onBlur corren después de los del formulario)
  */
 export default function FormColorField({ name, ...colorInputProps }: {
     name: string;
-} & Omit<Parameters<typeof import('../inputs/ColorInput.js').default>[0], 'name' | 'value' | 'onChange' | 'onBlur' | 'error'>): import("react").JSX.Element;
+} & Omit<Parameters<typeof import('../inputs/ColorInput.js').default>[0], 'name' | 'value' | 'onChange' | 'onBlur' | 'error'> & Partial<Pick<Parameters<typeof import('../inputs/ColorInput.js').default>[0], 'onChange' | 'onBlur'>>): import("react").JSX.Element;

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

@@ -1,7 +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
+ * @param {{name: string} & Omit<Parameters<typeof import('../upload/FileInput.js').default>[0], 'name'|'value'|'onChange'|'onBlur'|'error'> & Partial<Pick<Parameters<typeof import('../upload/FileInput.js').default>[0], 'onChange'|'onBlur'>>} props las de
+ *     FileInput (accept, maxSize, template…), sin value ni error (su onChange y su onBlur corren después de los del formulario)
  */
 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;
+} & Omit<Parameters<typeof import('../upload/FileInput.js').default>[0], 'name' | 'value' | 'onChange' | 'onBlur' | 'error'> & Partial<Pick<Parameters<typeof import('../upload/FileInput.js').default>[0], 'onChange' | 'onBlur'>>): import("react").JSX.Element;

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

@@ -1,7 +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
+ * @param {{name: string} & Omit<Parameters<typeof import('../upload/FileUploadInput.js').default>[0], 'name'|'value'|'onChange'|'onBlur'|'error'> & Partial<Pick<Parameters<typeof import('../upload/FileUploadInput.js').default>[0], 'onChange'|'onBlur'>>} props las de
+ *     FileUploadInput (upload, accept, maxSize, download…), sin value ni error (su onChange y su onBlur corren después de los del formulario)
  */
 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;
+} & Omit<Parameters<typeof import('../upload/FileUploadInput.js').default>[0], 'name' | 'value' | 'onChange' | 'onBlur' | 'error'> & Partial<Pick<Parameters<typeof import('../upload/FileUploadInput.js').default>[0], 'onChange' | 'onBlur'>>): import("react").JSX.Element;

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

@@ -1,7 +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
+ * @param {{name: string} & Omit<Parameters<typeof import('../upload/ImageInput.js').default>[0], 'name'|'value'|'onChange'|'onBlur'|'error'> & Partial<Pick<Parameters<typeof import('../upload/ImageInput.js').default>[0], 'onChange'|'onBlur'>>} props las de
+ *     ImageInput (shape, size, maxSize…), sin value ni error (su onChange y su onBlur corren después de los del formulario)
  */
 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;
+} & Omit<Parameters<typeof import('../upload/ImageInput.js').default>[0], 'name' | 'value' | 'onChange' | 'onBlur' | 'error'> & Partial<Pick<Parameters<typeof import('../upload/ImageInput.js').default>[0], 'onChange' | 'onBlur'>>): import("react").JSX.Element;

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

@@ -1,7 +1,7 @@
 /**
- * @param {{name: string} & Omit<Parameters<typeof import('../inputs/MaskedInput.js').default>[0], 'name'|'value'|'onChange'|'onBlur'|'error'>} props
+ * @param {{name: string} & Omit<Parameters<typeof import('../inputs/MaskedInput.js').default>[0], 'name'|'value'|'onChange'|'onBlur'|'error'> & Partial<Pick<Parameters<typeof import('../inputs/MaskedInput.js').default>[0], 'onChange'|'onBlur'>>} 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;
+} & Omit<Parameters<typeof import('../inputs/MaskedInput.js').default>[0], 'name' | 'value' | 'onChange' | 'onBlur' | 'error'> & Partial<Pick<Parameters<typeof import('../inputs/MaskedInput.js').default>[0], 'onChange' | 'onBlur'>>): import("react").JSX.Element;

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

@@ -1,6 +1,6 @@
 /**
- * @param {{name: string} & Omit<Parameters<typeof import('../inputs/NumberInput.js').default>[0], 'name'|'value'|'onChange'|'onBlur'|'error'>} props las de NumberInput (decimals, prefix, suffix, allowNegative…), sin value / onChange / onBlur / error
+ * @param {{name: string} & Omit<Parameters<typeof import('../inputs/NumberInput.js').default>[0], 'name'|'value'|'onChange'|'onBlur'|'error'> & Partial<Pick<Parameters<typeof import('../inputs/NumberInput.js').default>[0], 'onChange'|'onBlur'>>} props las de NumberInput (decimals, prefix, suffix, allowNegative…), sin value ni error (su onChange y su onBlur corren después de los del formulario)
  */
 export default function FormNumberField({ name, ...numberInputProps }: {
     name: string;
-} & Omit<Parameters<typeof import('../inputs/NumberInput.js').default>[0], 'name' | 'value' | 'onChange' | 'onBlur' | 'error'>): import("react").JSX.Element;
+} & Omit<Parameters<typeof import('../inputs/NumberInput.js').default>[0], 'name' | 'value' | 'onChange' | 'onBlur' | 'error'> & Partial<Pick<Parameters<typeof import('../inputs/NumberInput.js').default>[0], 'onChange' | 'onBlur'>>): import("react").JSX.Element;

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

@@ -0,0 +1,13 @@
+/** El esquema del formulario más cercano (o la función que lo da, como en formik); null sin él. */
+export declare const FormSchemaContext: import("react").Context<unknown>;
+/** El esquema del formulario más cercano; null sin él. */
+export declare const useFormSchema: () => unknown;
+/**
+ * @param {object} props
+ * @param {unknown} props.schema el mismo validationSchema que recibe Formik
+ * @param {import('react').ReactNode} props.children los campos
+ */
+export declare function FormSchemaProvider({ schema, children }: {
+    schema: unknown;
+    children: import('react').ReactNode;
+}): import("react").JSX.Element;

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

@@ -1,6 +1,6 @@
 /**
- * @param {{name: string} & Omit<Parameters<typeof import('../inputs/SelectInput.js').default>[0], 'name'|'value'|'onChange'|'onBlur'|'error'>} props las de SelectInput, sin value / onChange / onBlur / error
+ * @param {{name: string} & Omit<Parameters<typeof import('../inputs/SelectInput.js').default>[0], 'name'|'value'|'onChange'|'onBlur'|'error'> & Partial<Pick<Parameters<typeof import('../inputs/SelectInput.js').default>[0], 'onChange'|'onBlur'>>} props las de SelectInput, sin value ni error (su onChange y su onBlur corren después de los del formulario)
  */
 export default function FormSelectField({ name, ...selectInputProps }: {
     name: string;
-} & Omit<Parameters<typeof import('../inputs/SelectInput.js').default>[0], 'name' | 'value' | 'onChange' | 'onBlur' | 'error'>): import("react").JSX.Element;
+} & Omit<Parameters<typeof import('../inputs/SelectInput.js').default>[0], 'name' | 'value' | 'onChange' | 'onBlur' | 'error'> & Partial<Pick<Parameters<typeof import('../inputs/SelectInput.js').default>[0], 'onChange' | 'onBlur'>>): import("react").JSX.Element;

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

@@ -1,6 +1,6 @@
 /**
- * @param {{name: string} & Omit<Parameters<typeof import('../inputs/TextInput.js').default>[0], 'name'|'value'|'onChange'|'onBlur'|'error'>} props las de TextInput, sin value / onChange / onBlur / error
+ * @param {{name: string} & Omit<Parameters<typeof import('../inputs/TextInput.js').default>[0], 'name'|'value'|'onChange'|'onBlur'|'error'> & Partial<Pick<Parameters<typeof import('../inputs/TextInput.js').default>[0], 'onChange'|'onBlur'>>} props las de TextInput, sin value ni error (su onChange y su onBlur corren después de los del formulario)
  */
 export default function FormTextField({ name, ...textInputProps }: {
     name: string;
-} & Omit<Parameters<typeof import('../inputs/TextInput.js').default>[0], 'name' | 'value' | 'onChange' | 'onBlur' | 'error'>): import("react").JSX.Element;
+} & Omit<Parameters<typeof import('../inputs/TextInput.js').default>[0], 'name' | 'value' | 'onChange' | 'onBlur' | 'error'> & Partial<Pick<Parameters<typeof import('../inputs/TextInput.js').default>[0], 'onChange' | 'onBlur'>>): import("react").JSX.Element;

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

@@ -1,7 +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
+ * @param {{name: string} & Omit<Parameters<typeof import('../inputs/TransferListInput.js').default>[0], 'name'|'value'|'onChange'|'onBlur'|'error'> & Partial<Pick<Parameters<typeof import('../inputs/TransferListInput.js').default>[0], 'onChange'|'onBlur'>>} props las de
+ *     TransferListInput, sin value ni error (su onChange y su onBlur corren después de los del formulario)
  */
 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;
+} & Omit<Parameters<typeof import('../inputs/TransferListInput.js').default>[0], 'name' | 'value' | 'onChange' | 'onBlur' | 'error'> & Partial<Pick<Parameters<typeof import('../inputs/TransferListInput.js').default>[0], 'onChange' | 'onBlur'>>): import("react").JSX.Element;

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

@@ -9,13 +9,14 @@
  * @param {boolean} [props.steps[].completed] lleva la palomita (cuando los títulos se pulsan, solo si la pantalla lo dice)
  * @param {string} props.submitLabel ya traducido: el botón del último paso
  * @param {'horizontal'|'vertical'} [props.orientation] uno de WIZARD_ORIENTATION; por omisión horizontal
+ * @param {boolean} [props.hideBackOnFirstStep] en el primer paso no se pinta «Anterior»; por omisión sale apagado, como antes
  * @param {string} [props.initialStepKey] la llave del paso en el que se abre (la que diga el servidor); por omisión el primero
  * @param {'none'|'free'|'checked'} [props.stepSelection] uno de WIZARD_STEP_SELECTION: si el título de otro paso se pulsa y qué
  *   revisa antes; por omisión none (se avanza con «Siguiente», como siempre)
  * @param {(stepKey: string, index: number) => void} [props.onStepChange] cada vez que cambia el paso abierto
  * @param {object} [props.texts] los textos que cambian, con la forma de `common`: {wizard: {next, back, skip, optional, skipped, stepOf}}
  */
-export default function FormWizard({ steps, submitLabel, orientation, initialStepKey, stepSelection, onStepChange, texts, ...unknownProps }: {
+export default function FormWizard({ steps, submitLabel, orientation, hideBackOnFirstStep, initialStepKey, stepSelection, onStepChange, texts, ...unknownProps }: {
     steps: {
         key: string;
         label: string;
@@ -26,6 +27,7 @@ export default function FormWizard({ steps, submitLabel, orientation, initialSte
     }[];
     submitLabel: string;
     orientation?: 'horizontal' | 'vertical';
+    hideBackOnFirstStep?: boolean;
     initialStepKey?: string;
     stepSelection?: 'none' | 'free' | 'checked';
     onStepChange?: (stepKey: string, index: number) => void;

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

@@ -25,5 +25,6 @@ export { RECOVERY_CODE_PATTERN, TOTP_CODE_PATTERN, normalizeRecoveryCode, normal
 export { default as SubmitButton } from './SubmitButton.js';
 export { applyServerProblem } from './applyServerProblem.js';
 export { formLevelMessageOf, splitRowFieldErrors, splitServerFieldErrors } from './serverProblemFields.js';
+export { isRequiredInSchema } from './schemaRequired.js';
 export { useFormikField } from './useFormikField.js';
 export { Yup, buildYupLocale, translateValidationMessage } from './validation.js';

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

@@ -0,0 +1,14 @@
+/**
+ * Las partes de un nombre de campo de formik: 'contacts.2.email' y 'contacts[2].email' dan ['contacts', '2', 'email'].
+ *
+ * @param {string} name
+ * @returns {string[]}
+ */
+export declare function fieldPathOf(name: string): string[];
+/**
+ * @param {unknown} schema el validationSchema del formulario (un esquema de yup o una función que lo da, como en formik)
+ * @param {string} name el campo, con la forma de formik ('contacts.2.email')
+ * @param {object} [values] los valores del formulario, para las condiciones (.when)
+ * @returns {boolean} false si no hay esquema, si no es de yup o si el campo no está en él
+ */
+export declare function isRequiredInSchema(schema: unknown, name: string, values?: object): boolean;

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

@@ -1,11 +1,17 @@
 /**
  * @param {string} name el campo del formulario
- * @returns {{name: string, value: unknown, onChange: (value: unknown) => void, onBlur: () => void, error: unknown}}
+ * @param {{required?: boolean, onChange?: Function, onBlur?: Function}} [screen] lo que la pantalla le dijo al campo
+ * @returns {{name: string, value: unknown, onChange: (value: unknown, ...rest: unknown[]) => void, onBlur: (...args: unknown[]) => void, error: unknown, required: boolean}}
  */
-export declare function useFormikField(name: string): {
+export declare function useFormikField(name: string, screen?: {
+    required?: boolean;
+    onChange?: Function;
+    onBlur?: Function;
+}): {
     name: string;
     value: unknown;
-    onChange: (value: unknown) => void;
-    onBlur: () => void;
+    onChange: (value: unknown, ...rest: unknown[]) => void;
+    onBlur: (...args: unknown[]) => void;
     error: unknown;
+    required: boolean;
 };

package/dist/types/forms.d.ts

@@ -1,2 +1,4 @@
-export { FieldArray, Form, Formik, useField, useFormikContext } from 'formik';
-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, percentRule, sameAsFieldRule, splitRowFieldErrors, splitServerFieldErrors, translateValidationMessage, uniqueInListRule, useFormikField, } from './forms/index.js';
+export { FieldArray, Form, useField, useFormikContext } from 'formik';
+export { default as Formik } from './forms/CalcitaFormik.js';
+export { FormSchemaProvider, useFormSchema } from './forms/FormSchemaProvider.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, isRequiredInSchema, normalizeRecoveryCode, normalizeTotpCode, listTotalAtMostRule, listTotalOf, orderedInListRule, percentRule, sameAsFieldRule, splitRowFieldErrors, splitServerFieldErrors, translateValidationMessage, uniqueInListRule, useFormikField, } from './forms/index.js';

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

@@ -1,8 +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
+ * @param {{name: string, control?: object} & Omit<Parameters<typeof import('../upload/AttachmentsInput.js').default>[0], 'name'|'value'|'onChange'|'onBlur'|'error'> & Partial<Pick<Parameters<typeof import('../upload/AttachmentsInput.js').default>[0], 'onChange'|'onBlur'>>} props las del campo de la casa, sin
+ *     value ni error (su onChange y su onBlur corren después de los del formulario); 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;
+} & Omit<Parameters<typeof import('../upload/AttachmentsInput.js').default>[0], 'name' | 'value' | 'onChange' | 'onBlur' | 'error'> & Partial<Pick<Parameters<typeof import('../upload/AttachmentsInput.js').default>[0], 'onChange' | 'onBlur'>>): import("react").JSX.Element;