@dev-tcloud/tcloud-ui 6.28.3-beta.0 → 6.29.0

package/docs/tcloud-ui-dialog.md

@@ -7,7 +7,7 @@ Componente standalone de diálogo de confirmação criado dinamicamente via `TCl
 - Abertura imperativa com `ComponentFactoryResolver` e `ViewContainerRef` raiz definido pelo consumidor
 - Título, mensagem (`innerHTML`), textos de botões e rótulos via `TCloudUiDialogModel` e i18n padrão
 - Modo de confirmação por palavra (`TCloudUiDialogTextConfirmationEnum`) com validação case-insensitive
-- Indicador de carregamento (`tcloud-ui-loading`) quando `data.loading` é verdadeiro
+- Indicador de carregamento (`tc-rev-small-loading`) quando `data.loading` é verdadeiro
 - Tecla Escape e botão fechar disparam fluxo de cancelamento; animação de entrada/saída (`fade`)
 - `BehaviorSubject` `events` notifica ciclo de vida (`open` / `close`); após `close` o serviço destrói a instância do componente
 
@@ -52,6 +52,7 @@ Valores passados em `_data` são mesclados com padrões do serviço (incluindo c
 | `disable` | `boolean` | Desabilita botões, fechar e Escape | `undefined` / herdado |
 | `disableClickOutside` | `boolean` | Comportamento do clique no backdrop: quando **falso** ou indefinido, o clique é ignorado; quando **verdadeiro** e `disable` é falso, o clique chama `close(true)` (mesmo fluxo que cancelar) | `undefined` / herdado |
 | `inputConfirmationText` | `TCloudUiDialogTextConfirmationEnum` | Palavra esperada no campo de confirmação (mapeada para texto i18n) | `confirm` |
+| `showInputConfirmation` | `boolean` | Controla a exibição do campo de confirmação por texto. Quando **`true`** (padrão), o input é exibido e validado antes de confirmar. Quando **`false`**, o input não é renderizado e o botão Confirmar dispara `onConfirm` diretamente, sem validação — apenas os botões | `true` |
 | `buttonConfirmText` | `string` | Armazenado em `TCloudUiDialogModel`; o template atual do diálogo exibe no botão principal o valor de `textConfirmation` com `titlecase`, não este campo | Opcional |
 | `buttonCancelText` | `string` | Rótulo do botão cancelar | Tradução de `dialogConfirmation.cancel` se omitido |
 
@@ -135,6 +136,23 @@ export class ExampleComponent implements AfterViewInit {
 }
 ```
 
+### Confirmação simples (apenas botões)
+
+Quando não é necessária a confirmação por texto digitado, defina `showInputConfirmation: false`. O campo de confirmação não é exibido e o botão Confirmar dispara `onConfirm` diretamente.
+
+```typescript
+open(): void {
+  this.dialog
+    .open({
+      title: 'Confirmar operação',
+      message: '<p>Deseja prosseguir?</p>',
+      showInputConfirmation: false,
+    })
+    .onConfirm((d) => d.close(false))
+    .onCancel(() => {});
+}
+```
+
 ### Uso avançado
 
 Padrão da página de demonstração: confirmação com palavra `remove`, bloqueio de clique externo até confirmar texto, fluxo assíncrono com `loading` e fechamento sem callback de cancelamento após sucesso.
@@ -165,3 +183,4 @@ Notas de comportamento:
 - `dialog.close(false)` após operações bem-sucedidas evita executar o handler registrado em `onCancel`.
 - Enquanto `data.loading` ou `data.disable` é verdadeiro, Escape não fecha o diálogo e os botões permanecem desabilitados.
 - Com campo de confirmação ativo, o valor digitado deve coincidir com `textConfirmation` (comparação sem diferenciar maiúsculas/minúsculas).
+- Com `showInputConfirmation: false`, não há validação por texto: o botão Confirmar chama `onConfirm` no clique (o botão segue desabilitado apenas durante `loading`/`disable`).

package/docs/tcloud-ui-el-copy.md

@@ -21,6 +21,16 @@ import { TCloudUiElCopyDirective } from 'projects/tcloud-ui/src/public-api';
 export class ExampleComponent {}
 ```
 
+Ou via módulo:
+```ts
+import { TcRevComponentsLibModule } from 'projects/tcloud-ui/src/public-api';
+
+@NgModule({
+  imports: [TcRevComponentsLibModule]
+})
+export class AppModule {}
+```
+
 ## Propriedades (API)
 ### Inputs
 | Nome | Tipo | Descrição | Valor Default |

package/docs/tcloud-ui-popover.md

@@ -0,0 +1,54 @@
+# Popover
+
+O componente `tcloud-ui-popover` exibe um painel flutuante simples, ancorado ao elemento de origem. Ele aceita HTML livre e componentes Angular dentro do conteúdo projetado.
+
+## Uso básico
+
+```html
+<tcloud-ui-popover>
+  <button type="button" popover-trigger>Open popover</button>
+
+  <div popover-content>
+    Conteúdo do popover
+  </div>
+</tcloud-ui-popover>
+```
+
+## Inputs
+
+| Nome | Tipo | Descrição | Default |
+|------|------|-----------|---------|
+| `position` | `'top' \| 'right' \| 'bottom' \| 'left'` | Define o lado em que o popover será aberto. | `'bottom'` |
+| `align` | `'start' \| 'center' \| 'end'` | Define o alinhamento do painel em relação ao trigger. | `'start'` |
+| `maxWidth` | `number \| string` | Define a largura máxima do painel. Números são tratados como pixels. | `320` |
+| `disabled` | `boolean` | Desabilita a abertura do popover. | `false` |
+| `showCloseIcon` | `boolean` | Exibe um botão `X` para fechar o popover. | `false` |
+| `open` | `boolean` | Permite controlar a abertura via binding externo. | `false` |
+
+## Outputs
+
+| Nome | Tipo | Descrição |
+|------|------|-----------|
+| `openChange` | `boolean` | Emitido quando o estado aberto/fechado muda. |
+
+## Fechamento
+
+O popover fecha ao clicar fora do componente ou ao pressionar `ESC`. Quando `showCloseIcon` for `true`, um botão `X` também é exibido dentro do painel.
+
+## Alinhamento e largura
+
+Use `position` para definir o lado de abertura e `align` para definir a borda de ancoragem. Por exemplo, com `position="bottom"` e `align="end"`, o painel abre abaixo do trigger e cresce para a esquerda, mantendo a borda direita alinhada ao botão.
+
+```html
+<tcloud-ui-popover position="bottom" align="end" maxWidth="420px">
+  <button type="button" popover-trigger>Open</button>
+
+  <div popover-content>
+    Conteúdo alinhado à direita do trigger.
+  </div>
+</tcloud-ui-popover>
+```
+
+## Dark mode
+
+O componente usa tokens CSS `--c-*`, então acompanha o dark mode aplicado pela classe `.tc-dark` do projeto.