structra-ui 0.2.26 → 0.2.28

package/types/structra-ui.d.ts

@@ -3466,10 +3466,13 @@ declare class AppSidebarComponent<T extends string = string> implements OnChange
 }
 
 /**
- * Marca conteúdo a projectar no topo da sidebar (ex.: botão recolher/expandir).
+ * Marca **só** o botão recolher/expandir no topo da sidebar (slot direito).
+ * O **título/marca** deve usar `[appSidebarBrand]` como irmão — não envolver título + toggle num único
+ * `[appSidebarToolbar]`: no drawer mobile do `app-shell` isso pode esconder o título ou criar layout estranho.
  *
  * ```html
  * <app-sidebar [items]="nav">
+ *   <span appSidebarBrand>Minha aplicação</span>
  *   <app-shell-sidebar-toggle appSidebarToolbar [collapsed]="collapsed" (toggle)="onToggle()" />
  * </app-sidebar>
  * ```
@@ -3483,9 +3486,9 @@ declare class AppSidebarToolbarDirective {
  * Marca o título no topo da lateral: **na mesma linha** que o botão recolher (à esquerda);
  * oculto no modo rail (só ícones).
  *
- * **Importante:** não coloque `[appSidebarBrand]` num único `div` que também envolva o botão com classes
- * tipo Tailwind (`flex`, `justify-between`): use **dois projectados irmãos** (marca + `[appSidebarToolbar]`).
- * Caso contrário a linha inteira fica só dentro da zona da marca e o alinhamento à esquerda pode falhar no host da app.
+ * **Importante:** o título **tem** de usar `[appSidebarBrand]` no próprio nó de texto (ou wrapper só da marca).
+ * Não dependa só de um `span` dentro de um `div [appSidebarToolbar]` — em mobile o drawer só oculta o toggle,
+ * mas o padrão correcto é marca + toolbar como **irmãos** projectados (evita cabeçalho vazio se o CSS do host mudar).
  *
  * ```html
  * <app-sidebar [items]="nav">