@praxisui/table 1.0.0-beta.5 → 1.0.0-beta.8

package/README.md

@@ -178,6 +178,46 @@ sequenceDiagram
 - Virtualização: habilite em Comportamento → Virtualização para listas grandes (requer altura de linha previsível).
 - Densidade e linhas de grade: ajuste em Comportamento → Aparência rápida (compacta/confortável/espaçosa; bordas horizontais/verticais).
 
+## Rolagem Horizontal (owner do scroll)
+
+Por padrão, a `<praxis-table>` agora assume a responsabilidade pela rolagem horizontal quando o conteúdo excede a largura do container. Isso evita cortes de conteúdo e comportamentos inconsistentes entre projetos.
+
+### Input: `horizontalScroll`
+
+```
+@Input() horizontalScroll: 'auto' | 'wrap' | 'none' = 'auto';
+```
+
+- `auto` (padrão): a tabela cria um viewport com `overflow-x: auto` e permite que a tabela interna cresça com `width: max-content`. Quando a soma das colunas > container, aparece a barra de rolagem horizontal neste viewport.
+- `wrap`: permite quebra de linha nas células (libera `white-space: normal`), reduzindo a largura necessária; ideal quando você prefere minimizar a rolagem horizontal.
+- `none`: desabilita o comportamento interno; o host (página) deve fornecer o container com `overflow-x: auto` e as regras de largura necessárias.
+
+Exemplo:
+
+```html
+<!-- Comportamento padrão (auto) -->
+<praxis-table resourcePath="employees"></praxis-table>
+
+<!-- Reduz rolagem: permite quebra de linha nas células -->
+<praxis-table resourcePath="employees" horizontalScroll="wrap"></praxis-table>
+
+<!-- Host controla o scroll horizontal -->
+<div class="table-shell" style="overflow-x:auto">
+  <praxis-table resourcePath="employees" horizontalScroll="none"></praxis-table>
+  <!-- host pode usar width: max-content na tabela interna conforme seu design system -->
+</div>
+```
+
+### Editor de Configuração (Settings Panel)
+
+Na aba “Visão Geral & Comportamento”, há um seletor “Scroll Horizontal” com as opções `Auto`, `Wrap` e `Host` (none). As alterações podem ser aplicadas (Aplicar) ou salvas (Salvar & Fechar). O valor é persistido junto com outras preferências da tabela.
+
+### Notas
+
+- O caminho virtual (CDK Virtual Scroll) permanece sendo o owner da rolagem vertical; o viewport horizontal é um contêiner externo que não interfere no scroll vertical.
+- Cabeçalho sticky continua funcional. Teste combinações com colunas sticky/virt para seu caso.
+- Para grids alternativos (ex.: Kendo), as mesmas regras de `max-content`/`min-width: 100%` se aplicam ao elemento de tabela interno.
+
 ## Virtualização (CDK)
 
 Quando `behavior.virtualization.enabled` estiver ativo, as linhas da tabela são renderizadas com `cdk-virtual-scroll-viewport` (cabeçalho permanece igual).