Communitygithub.com

allianz/ng-aquila

Use ao trabalhar com os componentes Aquila / Angular Brand Kit (antigo Angular NDBX) do @allianz/ng-aquila. Abrange importações, padrões de uso, manipulação de formulários, layout de grade e API de componentes.

O que é ng-aquila?

Este skill fornece orientação especializada para desenvolvedores Angular que utilizam a biblioteca de componentes Aquila (Angular Brand Kit) da Allianz. Ele documenta as regras de importação para componentes standalone (Angular v19+), como o padrão de caminho `@allianz/ng-aquila/{nome-do-componente}`, e enfatiza o uso de recursos modernos como Signals, `inject()` e novo fluxo de controle (`@if`, `@for`). Inclui exemplos práticos de código para os padrões mais comuns: campos de formulário com validação reativa, dropdowns, diálogos modais e o sistema de grade responsiva de 12 colunas com breakpoints aninhados. Também lista os componentes mais usados com seus seletores, organiza componentes por caso de uso (formulário, navegação, tabela, feedback, layout, etc.) e orienta onde encontrar a documentação detalhada da API nos pacotes instalados (`node_modules/@allianz/ng-aquila/mcp/generated/components/`). É suportado em qualquer projeto Angular que dependa do `@allianz/ng-aquila` e funciona com agentes de IA como Claude Code, Cursor ou Codex. O skill é útil para garantir que o desenvolvedor siga as melhores práticas da Aquila, evitando erros comuns como esquecer `type="button"` em botões ou usar `NxInputDirective` sem o envoltório `<nx-formfield>`.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/allianz/ng-aquila/tree/HEAD/skills/aquila

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Aquila – Biblioteca de Componentes Angular Brand Kit

Aquila (código aberto) / Angular Brand Kit (antigo NDBX) é a biblioteca de componentes do Design System da Allianz para Angular. Use padrões modernos do Angular (v19+): componentes standalone, signals, novo fluxo de controle (@if, @for), inject(), etc.

Regras de Importação

Os componentes Aquila são standalone. Importe o componente diretamente:

import { NxButtonComponent } from '@allianz/ng-aquila/button';
import { NxFormfieldComponent } from '@allianz/ng-aquila/formfield';
import { NxInputDirective } from '@allianz/ng-aquila/input';

@Component({
  imports: [NxButtonComponent, NxFormfieldComponent, NxInputDirective],
})

Padrão do caminho de importação: @allianz/ng-aquila/{nome-do-componente}

Regras Específicas da Aquila

  • Nunca use NxInputDirective sem envolver <input nxInput> em <nx-formfield>
  • Use <nx-error nxFormfieldError> para mensagens de validação dentro de formfields
  • Sempre defina type="button" em <button nxButton> para evitar envio acidental do formulário
  • Prefira Formulários Reativos com componentes de formulário da Aquila
  • Não use estilos CSS inline; confie no estilo interno da Aquila

Formfield com Validação (Formulários Reativos)

<form [formGroup]="form">
  <nx-formfield label="Email">
    <input nxInput formControlName="email" type="email" />
    @if (form.controls.email.errors) {
      <nx-error nxFormfieldError>Por favor, insira um email válido</nx-error>
    }
  </nx-formfield>
</form>

Dropdown

<nx-formfield label="País">
  <nx-dropdown formControlName="country">
    <nx-dropdown-item value="DE">Alemanha</nx-dropdown-item>
    <nx-dropdown-item value="CH">Suíça</nx-dropdown-item>
    <nx-dropdown-item value="AT">Áustria</nx-dropdown-item>
  </nx-dropdown>
</nx-formfield>

Diálogo Modal

import { NxDialogService } from '@allianz/ng-aquila/modal';

const modalRef = inject(NxDialogService).open(MyDialogComponent);
modalRef.afterClosed().subscribe(result => { /* tratar resultado */ });

Sistema de Grade

Grade responsiva de 12 colunas. nxCol aceita até 7 valores de breakpoint separados por vírgula na ordem: tiny, small, medium, large, xlarge, 2xlarge, 3xlarge. Se menos de 7 valores forem fornecidos, o último se repete para os breakpoints restantes (por exemplo, nxCol="12,8" → 12,8,8,8,8,8,8).

<div nxLayout="grid">
  <div nxRow>
    <div nxCol="12,12,6">Esquerda</div>
    <div nxCol="12,12,6">Direita</div>
  </div>
</div>

Componentes Mais Usados

ComponenteSeletor
formfieldnx-formfield
inputinput[nxInput]
buttonbutton[nxButton]
iconnx-icon
dropdownnx-dropdown
checkboxnx-checkbox
grid[nxLayout]
headline[nxHeadline]
copytext[nxCopytext]
linknx-link
accordionnx-accordion
popover[nxPopoverTriggerFor]
badgenx-badge
datefieldinput[nxDatefield]
modalnx-modal
messagenx-message
data-displaynx-data-display
table[nxHeaderCell]
tabsnx-tab
listul[nxList]
radio-togglenx-radio-toggle
tooltip[nxTooltip]
switchernx-switcher
spinnernx-spinner
paginationnx-pagination

Encontre Componentes por Caso de Uso

  • formulário: autocomplete, checkbox, circle-toggle, code-input, datefield, dropdown, file-uploader, formfield, input, natural-language-form, phone-input, radio-toggle, rating, slider, switcher, timefield
  • navegação: breadcrumb, header, menu, tabs, pagination
  • tabela: comparison-table, dynamic-table, table
  • feedback: badge, indicator, message, modal, notification-panel, progress-stepper, progressbar, spinner, tooltip
  • layout: accordion, card, footer, grid, sidepanel, small-stage, toolbar
  • overlay: modal, overlay, popover
  • mídia: avatar, icon, image, video
  • interação: action, button, link, page-search, signal-button
  • seleção: checkbox, circle-toggle, dropdown, radio-toggle, taglist

API Detalhada

Para a API completa dos componentes (inputs, outputs, métodos), leia a documentação do componente no pacote instalado do projeto: geralmente em node_modules/@allianz/ng-aquila/mcp/generated/components/{nome-do-componente}.md ou em um caminho semelhante dependendo da configuração do projeto. Alternativa: execute uma busca glob com **/mcp/generated/**/.

Habilidades Relacionadas