@studiolxd/brand 49.25.0 → 49.26.0

package/CHANGELOG.md

@@ -7,6 +7,32 @@ El paquete sigue [semver](https://semver.org/lang/es/): **patch** para bug fixes
 regeneración de `dist`, **minor** para componentes/props/variantes/tokens nuevos, **major**
 para breaking changes.
 
+## [49.26.0] — 2026-10-05
+
+> **Minor (49.26.0).** `LoadingState` puede pintar su texto en esperas largas con pasos. Sin cambios
+> incompatibles: por defecto sigue mostrándose solo el girador.
+
+### `LoadingState` — `labelVisible`
+
+- Prop nueva **`labelVisible`** (por defecto `false`): pinta el `label` bajo el girador, centrado, con el
+  estilo de la descripción de `EmptyState`. Para esperas largas con pasos («Procesando el documento:
+  paso 2 de 5…»); en esperas cortas no se usa.
+- Es el mismo nodo que da el nombre accesible (no se duplica el anuncio). La caja lleva
+  `aria-live="polite"` y `aria-atomic="false"`: al cambiar el `label` se anuncia solo el texto nuevo.
+- Sin `label` propio no pinta el texto genérico del catálogo: la espera sigue con el texto oculto (no es error).
+- Tokens nuevos: `loading-state.label-font-family`, `label-font-size`, `sm-label-font-size`, `label-color`
+  (apuntan a los de la descripción de `EmptyState`; el par oscuro llega por el fichero derivado).
+
+### `FileUpload` / `FileUploadField` — estado de subida (`uploading`)
+
+- Props nuevas: **`uploading`** (el girador va dentro de la zona; la zona no admite otro fichero —clic,
+  selector, soltar y quitar quedan inertes— pero conserva el foco: no es `disabled`; el control lleva
+  `aria-busy` y `aria-disabled`), **`uploadingLabel`** (texto de la espera; sin él, `spinner.label` del
+  catálogo, sin texto cableado nuevo) y **`uploadingLabelVisible`** (lo pinta en la zona, con el mismo criterio
+  que `LoadingState labelVisible`: sin `uploadingLabel` propio no pinta nada).
+- La espera se anuncia con cortesía (`role="status"`, `aria-live="polite"`, `aria-atomic="false"`).
+- Sin tokens nuevos. `FileUploadField` las hereda del átomo. Sin ficha de paridad nativa (el componente no la tiene).
+
 ## [49.25.0] — 2026-10-05
 
 > **Minor.** Las esperas pasan a ser piezas del sistema: las aplicaciones dejan de

package/dist/_shared/tokens.js

@@ -1122,6 +1122,10 @@ var e = {
 	"--loading-state-padding-inline": "1.5rem",
 	"--loading-state-sm-padding-block": "1.5rem",
 	"--loading-state-spinner-color": "#6b6b6b",
+	"--loading-state-label-font-family": "\"Google Sans Flex\", system-ui, sans-serif",
+	"--loading-state-label-font-size": "1rem",
+	"--loading-state-sm-label-font-size": "0.875rem",
+	"--loading-state-label-color": "#4a4a4a",
 	"--logo-height-sm": "2rem",
 	"--logo-height-md": "2.5rem",
 	"--logo-height-lg": "3rem",

package/dist/_types/atoms/FileUpload/FileUpload.d.ts

@@ -44,6 +44,28 @@ export interface FileUploadProps {
     defaultValue?: File[];
     onChange?: (files: File[]) => void;
     progress?: number;
+    /**
+     * La subida está en curso. El girador sustituye al icono **dentro de la
+     * zona**, que deja de admitir ficheros (clic, selector y soltar quedan
+     * inertes, también el aspa de quitar) pero **conserva el foco**: no es
+     * `disabled`, así que quien estaba en el campo no lo pierde. El control
+     * lleva `aria-busy` y `aria-disabled`, y la espera se anuncia con cortesía
+     * (`role="status"`). Es distinto de `progress`, que dibuja una barra con un
+     * porcentaje conocido: pueden convivir.
+     */
+    uploading?: boolean;
+    /**
+     * Texto de la subida en curso («Subiendo 2 de 5…»). **No se ve** salvo con
+     * `uploadingLabelVisible`: es lo que anuncia el lector de pantalla. **Sin
+     * default**: sin él, sale de `spinner.label` del `BrandMessagesProvider`.
+     */
+    uploadingLabel?: string;
+    /**
+     * Pinta `uploadingLabel` en la zona, bajo el girador, para subidas largas con
+     * progreso por pasos. **Sin `uploadingLabel` propio no pinta nada**: el
+     * texto genérico del catálogo no se ve nunca. Default `false`.
+     */
+    uploadingLabelVisible?: boolean;
     disabled?: boolean;
     error?: boolean;
     id?: string;

package/dist/_types/molecules/LoadingState/LoadingState.d.ts

@@ -9,6 +9,16 @@ export interface LoadingStateProps extends Omit<React.HTMLAttributes<HTMLDivElem
      * que el `Spinner`.
      */
     label?: string;
+    /**
+     * Pinta el `label` bajo el girador, centrado, con el texto atenuado de la
+     * descripción de `EmptyState`. Para esperas **largas con pasos** («Procesando
+     * el documento: paso 2 de 5…»), donde el texto informa de por dónde va. Es el
+     * mismo nodo que da el nombre accesible: no se anuncia dos veces, y cuando
+     * `label` cambia la región lo anuncia con cortesía (`polite`). **Sin `label`
+     * propio no pinta nada**: el texto genérico del catálogo («Cargando…») no se
+     * ve nunca. Por defecto `false`: en una espera corta el texto es ruido.
+     */
+    labelVisible?: boolean;
     /**
      * `md` para una página o una zona; `sm` para el cuerpo de un diálogo, una
      * hoja, un popover o una barra lateral.
@@ -29,11 +39,12 @@ export interface LoadingStateProps extends Omit<React.HTMLAttributes<HTMLDivElem
 /**
  * La espera de un bloque cuya forma no se conoce: un girador centrado en una
  * caja que **reserva alto** y, si hace falta, una salida. A la vista solo está
- * el girador; el texto de la espera es solo para los lectores de pantalla. Cuando la forma sí se conoce (tabla, lista, ficha), la respuesta es
+ * el girador; el texto de la espera es solo para los lectores de pantalla,
+ * salvo con `labelVisible` (esperas largas con pasos). Cuando la forma sí se conoce (tabla, lista, ficha), la respuesta es
  * `LoadingRegion` con esqueletos.
  *
  * Anuncia: la caja es `role="status"` con `aria-busy`, y su nombre es el texto
  * de la espera, oculto a la vista. El girador va decorativo, para no
  * anunciarla dos veces.
  */
-export declare function LoadingState({ label, size, fill, action, className, ...rest }: LoadingStateProps): import("react/jsx-runtime").JSX.Element;
+export declare function LoadingState({ label, labelVisible, size, fill, action, className, ...rest }: LoadingStateProps): import("react/jsx-runtime").JSX.Element;