@acvl/frontend-components 0.0.88 → 0.0.90

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import * as _mui_material from '@mui/material';
-import { ButtonProps, ButtonGroupProps, IconButtonProps, MenuItemProps, BoxProps, AutocompleteProps, SliderProps, SwitchProps, GridProps, DrawerProps, SxProps, Theme, StackProps, TypographyProps, MenuProps, PaletteColorOptions, TextFieldProps as TextFieldProps$1, InputBaseProps, DialogProps, DialogContentProps } from '@mui/material';
+import { ButtonProps, ButtonGroupProps, IconButtonProps, MenuItemProps, BoxProps, AutocompleteProps, SliderProps, SwitchProps, ToggleButtonGroupProps, GridProps, DrawerProps, SxProps, Theme, StackProps, TypographyProps, MenuProps, PaletteColorOptions, TextFieldProps as TextFieldProps$1, InputBaseProps, DialogProps, DialogContentProps } from '@mui/material';
 import * as React$1 from 'react';
 import React__default, { ReactNode, Dispatch, SetStateAction, JSX, RefObject, FC, ReactElement, ComponentType, BaseSyntheticEvent, JSXElementConstructor, ElementType } from 'react';
 import * as react_jsx_runtime from 'react/jsx-runtime';
@@ -582,7 +582,14 @@ interface ControlledSliderProps$1 extends BaseControlledFieldProps {
 declare const ControlledSlider$1: React__default.FC<ControlledSliderProps$1>;
 
 interface ControlledSwitchProps extends BaseControlledFieldProps {
-    fieldProps?: SwitchProps;
+    /**
+     * Props del `Switch` de MUI, más `helperText`: el texto de ayuda que se pinta
+     * debajo, como en `ControlledText`. No es prop del `Switch`, así que se aparta
+     * antes del spread para que no le llegue a MUI.
+     */
+    fieldProps?: SwitchProps & {
+        helperText?: React__default.ReactNode;
+    };
 }
 declare const ControlledSwitch: React__default.FC<ControlledSwitchProps>;
 
@@ -595,7 +602,18 @@ interface ControlledTextProps extends BaseControlledFieldProps {
 declare const ControlledText: React__default.FC<ControlledTextProps>;
 
 interface ControlledToggleButtonsProps extends BaseControlledFieldProps {
-    fieldProps?: SwitchProps;
+    /**
+     * Props del `ToggleButtonGroup` de MUI, más `helperText`: el texto de ayuda que se pinta
+     * debajo, como en `ControlledSwitch`. No es prop del grupo, así que se aparta antes del
+     * spread para que no le llegue a MUI.
+     *
+     * Quedan fuera las que controla el componente: `value` y `onChange` son del formulario,
+     * `exclusive` lo exige `handleChange` (asume un solo valor) y `children` sale de
+     * `extraProps.options`.
+     */
+    fieldProps?: Omit<ToggleButtonGroupProps, "value" | "onChange" | "exclusive" | "children"> & {
+        helperText?: ReactNode;
+    };
     extraProps: {
         options: {
             value: string;
@@ -2225,11 +2243,8 @@ interface FieldProps {
  *
  * **La unicidad de `codigo` la garantiza el backend, no la grilla.** Un choque vuelve como un
  * 400 con el error en `codigo`, y la edición en línea lo pinta sobre la celda
- * (`renderEditCellWithErrorTooltip` con `mutationErrors`); la ficha, sobre el campo. El
- * `extra.queryArgs.endpoint` que lleva la columna `codigo` no valida nada: es lo que hace que el
- * panel de filtros la ofrezca como selector múltiple, con las opciones que sirve el
- * `como_opciones` de ese mismo endpoint, y filtre por `codigo__in`. Por eso el recurso también
- * tiene que servir `como_opciones`.
+ * (`renderEditCellWithErrorTooltip` con `mutationErrors`); la ficha, sobre el campo. La columna
+ * `codigo` del listado no es filtrable, así que el backend no tiene que atender `codigo__in`.
  *
  * Y lo que ya pide cualquier pantalla de la librería:
  *
@@ -2241,6 +2256,14 @@ interface FieldProps {
  *   borrado que el servidor va a rechazar.
  * - Guardar (POST o PATCH) contesta `{ detail, list }`: `manualCacheRefresh` copia `detail` en la
  *   caché del detalle y `list` en el renglón del listado, sin volver a pedirlos.
+ *
+ * Y lo que necesita quien lo referencie, aunque ni el listado ni la ficha lo consultan:
+ *
+ * - `como_opciones`, con `{ value, label }`. De ahí saca sus opciones cualquier selector que
+ *   liste el catálogo (`ControlledAutocomplete` con `queryArgs: { endpoint }`): el campo con el
+ *   que el formulario de otro modelo lo elige, o la columna que apunta a él en el panel de
+ *   filtros de otra grilla. Sin esto el catálogo se administra, pero no se puede elegir desde
+ *   ningún lado.
  */
 interface DefinicionDeCatalogo {
     /**
@@ -2345,10 +2368,11 @@ declare const crearFabricaDeCatalogos: <BaseQuery extends BaseQueryFn<string | F
  * Un catálogo puede omitir alguna de las de la base con `ocultarColumnas` — quitar, nunca cambiar
  * lo que hacen; ver `DefinicionDeCatalogo`.
  *
- * `codigo` lleva `extra.queryArgs.endpoint`, que es lo que hace que el panel de filtros la
- * ofrezca como selector múltiple con las opciones del propio recurso (`como_opciones`). **No
- * valida la unicidad**: eso lo hace el backend al guardar, y el choque vuelve como el error que
- * `renderEditCellWithErrorTooltip` pinta sobre la celda.
+ * `codigo` **no es filtrable**. En el panel de filtros una columna de texto es un selector
+ * múltiple que filtra por `<campo>__in`, y el contrato no le pide al backend `codigo__in`: donde
+ * no lo atiende —django-filter ignora en silencio el parámetro que no conoce— el filtro se
+ * ofrecía y no hacía nada. Tampoco valida la unicidad: eso lo hace el backend al guardar, y el
+ * choque vuelve como el error que `renderEditCellWithErrorTooltip` pinta sobre la celda.
  */
 declare const columnasDeCatalogo: (definicion: DefinicionDeCatalogo) => (props?: EditGridColumnsProps) => GridColDefPropsOverrides[];
 
@@ -2654,6 +2678,9 @@ interface CatalogoListProps {
      * una pestaña hay que pasarla explícitamente: ahí `useLocation()` devuelve la ruta de la
      * página contenedora, así que sin esto los renglones navegarían al detalle de la página que
      * contiene las pestañas y todas ellas compartirían una sola llave de persistencia.
+     *
+     * No decide contra qué recurso se exporta: eso es siempre `definicion.endpoint` (ver
+     * `CatalogoList`).
      */
     pathname?: string;
     /**
@@ -2682,6 +2709,14 @@ interface CatalogoListProps {
  *
  * El alta siempre está —sujeta al permiso de agregar—; la importación CSV sólo si se pasa
  * `csvUpload`.
+ *
+ * **La exportación CSV va siempre contra `definicion.endpoint`.** `ExportCSV` exporta contra el
+ * `csvProps.endpoint` que reciba y, sin él, contra la ruta de la página (`useLocation()`) —a
+ * propósito no contra el `pathname` de la grilla, que también es llave de persistencia y no tiene
+ * por qué ser una URL—. Pero la ruta es de la página, no del recurso: dentro de una pestaña es la
+ * de la página que contiene las pestañas, y la descarga pedía algo que no es el catálogo. El
+ * endpoint es el recurso esté donde esté montado el listado, así que se pasa siempre, igual como
+ * página propia que como pestaña. Lo arma `dataGridPropsDeCatalogo`.
  */
 declare const CatalogoList: ({ definicion, api, pathname, csvUpload }: CatalogoListProps) => react_jsx_runtime.JSX.Element;
 

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@acvl/frontend-components",
-    "version": "0.0.88",
+    "version": "0.0.90",
     "description": "Component library for ACV frontend projects.",
     "homepage": "https://github.com/ACV-Logistics/acv-frontend-components#readme",
     "access": "public",