IA · A2UI

Catálogo A2UI v1

Os componentes que um agente pode usar ao montar uma tela A2UI com a ui-nova. O catálogo é gerado do código da lib: props, enums e ícones vêm dos arquivos *.types.ts, e só as decisões (onda, nome, binding) são manuais.

catalogId: https://uinova.walderpinheiro.com.br/a2ui/catalog/v1.json (decisão D3; domínio configurável por A2UI_BASE_URL)

URL estável: /a2ui/catalog/v1.json

Mapeamento dos 111 componentes

Como cada componente da lib aparece no catálogo. No catálogo são os componentes que o agente pode usar; fora são os que não cabem no protocolo (shell de app, composables, motion, drag-and-drop, upload de arquivo), cada um com o motivo.

ui-novaGrupo na docNome A2UICatálogo básicoObservação
VActionListAçõesActionList—Itens viram actions; href dos itens é descartado pelo renderer.
VButtonAçõesButtonButton
VDateTileDados e tabelasDateTile—
VDescriptionListDados e tabelasDescriptionList—
VDiffStatDados e tabelasDiffStat—
VTableDados e tabelasTableList (template) — sem equivalente diretoSomente leitura + row-click; paginação pelo componente Pagination ligado ao mesmo data model.
VTimelineDados e tabelasTimeline—
VAlertFeedback e statusAlert—
VBannerFeedback e statusBanner—
VEmptyStateFeedback e statusEmptyState—
VNotificationItemFeedback e statusNotificationItem—
VProgressFeedback e statusProgress—
VSkeletonFeedback e statusSkeleton—
VSpinnerFeedback e statusSpinner—
VStatusMarkFeedback e statusStatusMark—
VToastFeedback e statusToast—Aviso efêmero dentro da surface; fecha sozinho após duration.
VCheckboxFormuláriosCheckboxCheckBox
VNumberInputFormuláriosNumberInputTextField (variant number)
VOtpInputFormuláriosOtpInput—Input sensível (D11): só renderiza com allowSensitive: true no host.
VPasswordInputFormuláriosPasswordInput—Input sensível (D11): só renderiza com allowSensitive: true no host; sem isso vira fallback + error.
VRadioGroupFormuláriosRadioGroupChoicePicker / MultipleChoice (1 seleção)
VSearchFieldFormuláriosSearchField—Sugestões vêm do data model; o agente atualiza suggestions em resposta a searchAction.
VSliderFormuláriosSliderSlider
VSwitchFormuláriosSwitchCheckBox
VTagInputFormuláriosTagInput—validateTag (função) fica fora do fio; use maxTags, allowDuplicates e @checks.
VTextareaFormuláriosTextareaTextField (variant longText)
VTextInputFormuláriosTextInputTextField
VBadgeFundamentosBadge—
VIconFundamentosIconIconProp icon (mesmo nome usado nos demais componentes da ui-nova; no catálogo básico é name) — string do registry central de ícones keyline.
VKbdFundamentosKbd—
VTagFundamentosTag—
VBarChartGráficos e métricasBarChart—
VBarListGráficos e métricasBarList—
VFlowPathGráficos e métricasFlowPath—
VFunnelChartGráficos e métricasFunnelChart—
VStatCardGráficos e métricasStatCard—
VAgentChipIAAgentChip—
VThoughtLineIAThoughtLine—
VAutoLayoutGridLayout e gridsAutoLayoutGrid—
VAutoLayoutGridItemLayout e gridsAutoLayoutGridItem—
VCardGridLayout e gridsCardGridRow/Column (wrap)
VDashboardColumnLayout e gridsDashboardColumnColumnColuna que empilha widgets (children). Redimensionar e arrastar são gestos do host e ficam fora do fio; collapsed liga ao data model com variant: "collapsible".
VDashboardRowLayout e gridsDashboardRowRowFileira de seção: title/subtitle à esquerda, children no meio e actions (ids) à direita; wrap quebra em telas pequenas.
VMasonryGridLayout e gridsMasonryGrid—
VMasonryItemLayout e gridsMasonryItem—
VThumbnailGridLayout e gridsThumbnailGrid—items[].src passa pela política de URL do host (só https por padrão); selected é a lista de ids ligada ao data model.
VWidgetCellLayout e gridsWidgetCell—Célula de dashboard: KPI (value/delta), lista (items), CTA (actionLabel → action) ou placeholder (addAction). Navegação só por action (footerAction), nunca por href.
VAvatarMídia e pessoasAvatar—
VGroupAvatarMídia e pessoasGroupAvatar—
VImageGalleryMídia e pessoasImageGallery—URLs passam pela política de URL do host (só https por padrão).
VBreadcrumbNavegaçãoBreadcrumb—Navegação só por action: o renderer descarta href/to dos itens.
VPaginationNavegaçãoPagination—
VStepperNavegaçãoStepper—
VTabsNavegaçãoTabsTabsitems é derivado de tabs[].{value,label,icon}; o slot default renderiza o child da aba ativa.
VTreeNavigationNavegaçãoTreeNavigation—Árvore completa no fio; loadChildren (função) fica fora.
VDialogOverlaysModalModal
VDrawerOverlaysDrawer—Overlay lateral com o mesmo modelo do Modal.
VSheetOverlaysSheet—Overlay lateral com o mesmo modelo do Modal.
VTooltipOverlaysTooltip—Envolve um filho (child) com content textual.
VColorPickerSeleção e menusColorPicker—O valor é o dado escolhido pelo usuário (hex); cores de apresentação continuam só por token (D8).
VDatePickerSeleção e menusDatePickerDateTimeInput (enableDate)
VDateRangePickerSeleção e menusDateRangePicker—Valor {start, end} em ISO 8601 no fio; o renderer converte para Date e de volta.
VDropdownMenuSeleção e menusDropdownMenu—O gatilho é o botão da própria lib (label/icon); cada item escolhido dispara selectAction.
VSegmentedControlSeleção e menusSegmentedControlChoicePicker (chips)
VSelectSeleção e menusSelectChoicePicker / MultipleChoice (1 seleção)
VTimeRangeSeleção e menusTimeRange—Dois valores ligados: start e end (HH:mm).
VAccordionSuperfíciesAccordion—
VAccordionItemSuperfíciesAccordionItem—Só é válido como filho de Accordion.
VCardSuperfíciesCardCard
VPanelSuperfíciesPanel—
VSectionSuperfíciesSectionColumn