@acvl/frontend-components 0.0.101 → 0.0.102

package/dist/index.d.ts

@@ -785,7 +785,8 @@ interface MainDrawerV2Props {
      * queda donde esté declarado.
      *
      * El hueco es uno solo y se turnan: abrir un panel encoge al que estuviera puesto, y
-     * cerrarlo le devuelve el turno. Nunca se reparten el ancho entre varios.
+     * cerrarlo le devuelve el turno. Nunca se reparten el ancho entre varios. Un panel
+     * flotante no entra en el turno: se abre encima y el acoplado sigue puesto debajo.
      *
      * En acoplado el ancho se anima al abrir y cerrar, y `anchor` sólo decide de qué
      * lado va el tirador de arrastre: la posición la fija el contenedor. `slotProps.drawer`
@@ -900,6 +901,9 @@ interface SidePanelHost {
      *
      * La identidad la pone el propio panel (un `useId`). Hay que soltar el turno al
      * desmontar, o el hueco se queda esperando a un panel que ya no existe.
+     *
+     * Sólo se anuncian los acoplados (ver `pideElHueco`): un panel flotante no ocupa el
+     * hueco, así que no tiene por qué quitárselo a nadie.
      */
     registrar: (id: string, abierto: boolean) => void;
     /**
@@ -3193,6 +3197,19 @@ interface DetailFormProps {
     formId?: string;
     /** Persist-tab key for multi-section forms. Defaults to `formId`. */
     storageKey?: string;
+    /**
+     * Pestaña con la que abre una ficha de varias secciones, por su **título**: el `label` que
+     * la sección declara y que la pestaña muestra. Se busca entre las secciones visibles, así
+     * que una sección escondida más arriba no la cambia por otra; si ninguna visible se llama
+     * así, abre en la primera. Ver `resolveTabPorTitulo`.
+     *
+     * Con ella la pestaña no se recuerda en `sessionStorage` —`storageKey` deja de aplicar—:
+     * quien la pasa decide dónde abre, y una visita anterior que le ganara no dejaría pedir
+     * nada. Se aplica al montar el cuerpo; después el usuario cambia de pestaña libremente.
+     * Para reaplicarla sin desmontar, el contenedor le cambia la `key` (ver
+     * `DetailFormDrawer_v2`).
+     */
+    initialTab?: string;
     /**
      * Bajo qué nombre recuerda el formulario lo que el usuario acomoda en él: hoy, cuáles
      * subsecciones dejó plegadas (ver `SubsectionProps.collapsible`).
@@ -3237,7 +3254,7 @@ interface DetailFormProps {
  * element and the section/tab render tree — no page layout, no header buttons. Compose it
  * inside a page, dialog or drawer shell that supplies the surrounding chrome.
  */
-declare function DetailForm({ controller, formId, storageKey, storageScope, loadingHeight, responsiveTo, containerBreakpoints, slotProps, }: DetailFormProps): react_jsx_runtime.JSX.Element;
+declare function DetailForm({ controller, formId, storageKey, initialTab, storageScope, loadingHeight, responsiveTo, containerBreakpoints, slotProps, }: DetailFormProps): react_jsx_runtime.JSX.Element;
 
 /**
  * An action the consumer hangs off a record's chrome — cerrar, revertir, descargar el PDF —
@@ -3840,6 +3857,20 @@ interface DetailFormDrawerProps {
      * read-only and `startInEdit` is re-applied against the new record's own permissions.
      */
     recordKey?: string | number;
+    /**
+     * Pestaña con la que abre el cajón cuando la ficha tiene varias secciones, por su
+     * **título**: el `label` que declara la sección, el mismo que muestra la pestaña —
+     * `initialTab="Paradas"`—. Se busca entre las visibles, así que esconder una sección de
+     * arriba no la cambia por otra; si ninguna visible se llama así, abre en la primera.
+     *
+     * Se aplica cada vez que el cajón se abre y cada vez que cambia `recordKey` —el navegador
+     * pasando de registro—; entre una cosa y otra el usuario cambia de pestaña y nadie se la
+     * regresa. Con ella la pestaña no se recuerda de una apertura a otra: sin ella todo sigue
+     * como antes.
+     *
+     * @see DetailFormProps.initialTab
+     */
+    initialTab?: string;
     permissionsPath?: string;
     /** Runs after a successful mutation, before the drawer closes. Receives the response. */
     onSuccess?: (response: any) => void;
@@ -3988,7 +4019,7 @@ interface DetailFormDrawerProps {
  * deja el registro en pantalla y editando — para formularios que se capturan de a poco o que
  * llevan una grilla adentro.
  */
-declare function DetailFormDrawer({ open, onClose, title, api, form, sections, pageType, startInEdit, recordKey, permissionsPath, onSuccess, keepOpenOnSave, extraButtons, historial, navigation, width, anchor, variant, resizable, minWidth, maxWidth, widthStorageKey, onWidthChange, responsiveTo, containerBreakpoints, storageScope, labels, slots, slotProps, }: DetailFormDrawerProps): react_jsx_runtime.JSX.Element;
+declare function DetailFormDrawer({ open, onClose, title, api, form, sections, pageType, startInEdit, recordKey, initialTab, permissionsPath, onSuccess, keepOpenOnSave, extraButtons, historial, navigation, width, anchor, variant, resizable, minWidth, maxWidth, widthStorageKey, onWidthChange, responsiveTo, containerBreakpoints, storageScope, labels, slots, slotProps, }: DetailFormDrawerProps): react_jsx_runtime.JSX.Element;
 
 interface DrawerGridDrawerConfig {
     /** Shared field layout, used by every mode. Same shape as `DetailPage_v2`'s `form`/`sections`. */

package/package.json

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