@studiolxd/brand 40.1.0 → 41.0.0

package/CHANGELOG.md

@@ -7,6 +7,47 @@ 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.
 
+## [41.0.0] — 2026-09-15
+
+> **Major.** Segunda familia al proveedor de textos: `Table` y `DataTable` pierden sus
+> textos castellano por defecto.
+
+### Las tablas leen del proveedor
+
+Mismo mecanismo que estrenó `Pagination` en la v40.0.0 y mismo orden —**prop → proveedor →
+error**—, ahora en la familia que más superficie ocupa en una aplicación. `BrandMessages`
+gana dos espacios:
+
+- **`table`** — `actions`, `sortable`, `sortedAscending`, `sortedDescending`.
+- **`dataTable`** — `empty`, `search`.
+
+Los cinco calcan clave a clave el catálogo de la suite, así que montarlos es mapear y no
+traducir de nuevo. Es incompatible **en tiempo de compilación**, que es justo lo que se
+busca: el contrato exige los dos espacios, así que ninguna aplicación compila hasta
+añadirlos — nadie se entera en producción de que le falta un texto.
+
+### Lo que NO se fue al proveedor, y por qué
+
+La distinción que gobierna toda la campaña: al catálogo común va lo que el componente emite
+**por su cuenta** e igual en toda la suite; se queda como prop lo que es **contenido de esa
+pantalla**.
+
+- `Table.caption` y `TableRow.label` nombran ESA tabla y ESA fila.
+- `DataTable.ariaLabel` nombra ESA lista.
+- `DataTable.emptyMessage` **sobrevive como anulación**: el catálogo pone el aviso genérico,
+  y la prop queda para el que explica algo del dominio —«todavía no has invitado a nadie»—.
+  No es una concesión: en la suite ya hay pantallas que dan un vacío distinto según haya
+  filtros o no, y eso ningún catálogo común puede saberlo.
+
+`DataTable.searchClearLabel` se queda como **reenvío puro**: ese texto no lo emite la tabla,
+lo emite el `InputField` que lleva dentro, y ese átomo todavía no está migrado.
+
+### Lo que esta ola enseña sobre las que vienen
+
+Una familia no queda limpia del todo mientras reenvíe texto a un componente sin migrar, y
+eso **no se ve desde dentro de la familia**. De ahí que las olas siguientes se ordenen para
+que los átomos de formulario caigan pronto: medio catálogo termina reenviando a ellos.
+
 ## [40.1.0] — 2026-09-15
 
 > **Minor.** `AnnotationThread` gana un tercer estado y una ranura para la coordenada de

package/dist/_types/messages/BrandMessages.d.ts

@@ -1,4 +1,6 @@
 import type { PaginationMessages } from '../molecules/Pagination/Pagination';
+import type { TableMessages } from '../molecules/Table/Table';
+import type { DataTableMessages } from '../organisms/DataTable/DataTable';
 /**
  * El contrato de textos de la librería: un espacio por componente, y dentro
  * de cada espacio **todas las claves obligatorias**.
@@ -22,5 +24,7 @@ import type { PaginationMessages } from '../molecules/Pagination/Pagination';
  */
 export interface BrandMessages {
     pagination: PaginationMessages;
+    table: TableMessages;
+    dataTable: DataTableMessages;
 }
-export type { PaginationMessages };
+export type { PaginationMessages, TableMessages, DataTableMessages };

package/dist/_types/messages/index.d.ts

@@ -2,4 +2,4 @@ export { BrandMessagesProvider } from './BrandMessagesProvider';
 export type { BrandMessagesProviderProps } from './BrandMessagesProvider';
 export { useBrandMessages } from './BrandMessagesContext';
 export type { BrandMessagesReader } from './BrandMessagesContext';
-export type { BrandMessages, PaginationMessages } from './BrandMessages';
+export type { BrandMessages, PaginationMessages, TableMessages, DataTableMessages, } from './BrandMessages';

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

@@ -1,5 +1,25 @@
 import type { ReactNode } from 'react';
 import './Table.css';
+/**
+ * Los textos que la tabla emite por su cuenta: el cromo de la cabecera —el
+ * estado de ordenación y el rótulo de la columna de acciones—, igual en toda
+ * la suite. Los nombres calcan el espacio `table` del catálogo, así que
+ * montarlo es mapear clave a clave y no traducir de nuevo.
+ *
+ * Lo que NO está aquí es deliberado: el `caption` de una tabla y el `label`
+ * de una fila son contenido de ESA pantalla, no cromo del componente, y
+ * siguen siendo props sin valor por defecto.
+ */
+export interface TableMessages {
+    /** Rótulo oculto de la cabecera de la columna de acciones. */
+    actions: string;
+    /** Texto oculto de una columna ordenable que todavía no ordena. */
+    sortable: string;
+    /** Texto oculto de la columna ordenada de forma ascendente. */
+    sortedAscending: string;
+    /** Texto oculto de la columna ordenada de forma descendente. */
+    sortedDescending: string;
+}
 export interface TableProps extends React.TableHTMLAttributes<HTMLTableElement> {
     /**
      * Texto de `<caption>` (se oculta visualmente). **Opcional**: sin `caption` no se
@@ -19,7 +39,10 @@ export interface TableHeaderProps extends React.ThHTMLAttributes<HTMLTableCellEl
     onSort?: () => void;
     /** Marca esta columna como columna de acciones: ancho mínimo y cabecera oculta visualmente */
     actions?: boolean;
-    /** Texto accesible de la cabecera de acciones. Default: «Acciones» (castellano). Una app multiidioma debe pasarlo traducido. */
+    /**
+     * Texto accesible de la cabecera de acciones. Sin default: cuando no se
+     * pasa, sale de `table.actions` del `BrandMessagesProvider`.
+     */
     actionsLabel?: string;
     /**
      * Pega la columna al borde final (`inset-inline-end: 0`) cuando la tabla
@@ -29,13 +52,13 @@ export interface TableHeaderProps extends React.ThHTMLAttributes<HTMLTableCellEl
      */
     sticky?: 'end';
     /**
-     * Texto accesible del estado de ordenación ascendente. Default: "Ordenado ascendente"
-     * (castellano). Una app multiidioma debe pasarlo traducido.
+     * Texto accesible del estado de ordenación ascendente. Sin default:
+     * `table.sortedAscending`.
      */
     sortedAscLabel?: string;
-    /** Texto accesible del estado descendente. Default: «Ordenado descendente» (castellano). Una app multiidioma debe pasarlo traducido. */
+    /** Texto accesible del estado descendente. Sin default: `table.sortedDescending`. */
     sortedDescLabel?: string;
-    /** Texto accesible de la columna ordenable sin ordenar. Default: «Activar ordenación» (castellano). Una app multiidioma debe pasarlo traducido. */
+    /** Texto accesible de la columna ordenable sin ordenar. Sin default: `table.sortable`. */
     sortableLabel?: string;
     /**
      * Impide que el rótulo de esta columna se parta en dos líneas. Mismo valor
@@ -55,8 +78,8 @@ export interface TableRowProps extends Omit<React.HTMLAttributes<HTMLTableRowEle
     /**
      * Nombre accesible de la fila. Por defecto el rol `row` toma su nombre del
      * contenido de sus celdas; pásalo solo cuando ese texto no identifique la
-     * fila (celdas de solo iconos, datos crípticos). Default: castellano — no
-     * hay texto por defecto, es el consumidor quien lo escribe.
+     * fila (celdas de solo iconos, datos crípticos). No sale del catálogo
+     * común: identifica a ESTA fila, así que lo escribe el consumidor.
      */
     label?: string;
     children: ReactNode;

package/dist/_types/organisms/DataTable/DataTable.d.ts

@@ -3,6 +3,18 @@ import { type ColumnDef, type RowData } from '@tanstack/react-table';
 import { type PaginationProps } from '../../molecules/Pagination/Pagination';
 import { type TableHeaderProps } from '../../molecules/Table/Table';
 import './DataTable.css';
+/**
+ * Los textos que la tabla de datos emite por su cuenta. Son dos, y los dos son
+ * cromo: el rótulo del buscador y el aviso de que no hay filas. El resto de su
+ * texto o llega por props de contenido (`ariaLabel`) o lo ponen sus piezas
+ * (`Table`, `Pagination`), cada una desde su propio espacio.
+ */
+export interface DataTableMessages {
+    /** Aviso del estado vacío cuando no hay filas que pintar. */
+    empty: string;
+    /** Rótulo —oculto a la vista— y placeholder del buscador. */
+    search: string;
+}
 /** Alineación del contenido de una columna. `start` es el default. */
 export type DataTableAlign = 'start' | 'center' | 'end';
 declare module '@tanstack/react-table' {
@@ -66,9 +78,15 @@ export interface DataTableProps<TData, TValue> {
         value: string;
         onChange: (value: string) => void;
     };
-    /** Placeholder y nombre accesible del buscador. */
+    /**
+     * Placeholder y nombre accesible del buscador. Sin default: cuando no se
+     * pasa, sale de `dataTable.search` del `BrandMessagesProvider`.
+     */
     searchPlaceholder?: string;
-    /** Nombre accesible del botón que vacía el buscador. Default castellano. */
+    /**
+     * Nombre accesible del botón que vacía el buscador. `DataTable` no le pone
+     * ninguno: sin esta prop manda el de `InputField`.
+     */
     searchClearLabel?: string;
     /** Se renderiza a la derecha del buscador. */
     toolbar?: ReactNode;
@@ -81,7 +99,11 @@ export interface DataTableProps<TData, TValue> {
     footerActions?: ReactNode;
     /** Filas por página cuando la tabla pagina en cliente. */
     pageSize?: number;
-    /** Texto del estado vacío. */
+    /**
+     * Texto del estado vacío. Sin default: sale de `dataTable.empty`. Pásalo
+     * cuando esta pantalla tenga algo propio que decir («Aún no has invitado a
+     * nadie»), que un catálogo común no puede saber.
+     */
     emptyMessage?: string;
     isLoading?: boolean;
     pagination?: DataTableServerPagination;
@@ -94,8 +116,8 @@ export interface DataTableProps<TData, TValue> {
  * paginación (en cliente o en servidor) sobre el `Table` y el `Pagination` del
  * DS. El comportamiento lo aporta TanStack Table.
  *
- * Los textos accesibles llegan por props (el DS no habla de i18n): los de
- * `Table` caen a sus castellanos por defecto, y los de `Pagination` —que ya no
- * tiene ninguno— al `BrandMessagesProvider` que la aplicación monta en su raíz.
+ * Ningún texto viene puesto: los propios salen del espacio `dataTable` del
+ * `BrandMessagesProvider`, y los de sus piezas de los suyos (`table`,
+ * `pagination`). Las props de texto siguen ahí como anulación puntual.
  */
 export declare function DataTable<TData, TValue>({ columns, data, ariaLabel, ariaLabelledBy, searchColumnId, search, searchPlaceholder, searchClearLabel, toolbar, footerActions, pageSize, emptyMessage, isLoading, pagination, headerLabels, paginationLabels, className, }: DataTableProps<TData, TValue>): import("react/jsx-runtime").JSX.Element;