@praxisui/tabs 8.0.0-beta.2 → 8.0.0-beta.21

package/src/lib/praxis-tabs-config-editor.json-api.md

@@ -0,0 +1,597 @@
+---
+title: "praxis-tabs-config-editor JSON API (Canonical)"
+slug: "praxis-tabs-config-editor-json-api"
+doc_type: "api-reference"
+component: "praxis-tabs-config-editor"
+document_kind: "json-api-canonical"
+reference_mode: "canonical"
+contract_format: "json"
+contract_source: "runtime-and-code"
+description: "Referencia canonica do contrato JSON do componente praxis-tabs-config-editor."
+category: "components"
+sub_category: "config-editor"
+audience:
+  - "frontend"
+  - "architect"
+  - "platform-team"
+level: "advanced"
+status: "active"
+owner: "praxis-ui"
+source_of_truth:
+  - "projects/praxis-tabs/src/lib/praxis-tabs-config-editor.ts"
+  - "projects/praxis-tabs/src/lib/praxis-tabs.ts"
+  - "projects/praxis-tabs/src/lib/quick-setup/tabs-quick-setup.component.ts"
+  - "projects/praxis-tabs/src/lib/ai/tabs-ai-capabilities.ts"
+source_of_truth_last_verified: "2026-03-05"
+last_updated: "2026-03-05"
+toc: true
+sidebar: true
+tags:
+  - "json-api"
+  - "canonical-contract"
+  - "praxis-tabs-config-editor"
+api_stability: "canonical"
+schema_verified: true
+runtime_verified: false
+editor_coverage_verified: false
+runtime_scope: "public"
+legacy_paths_present: false
+has_known_mismatches: true
+related_components: []
+---
+
+# praxis-tabs-config-editor
+
+Este documento e a referencia canonica da API JSON de praxis-tabs-config-editor.
+
+## Summary
+
+- Tipo documental: API reference canonica de contrato JSON.
+- Source of truth: runtime e codigo declarados no frontmatter.
+- Objetivo operacional: consulta rapida, auditavel e deterministica sob pressao.
+- Resumo funcional herdado: `praxis-tabs-config-editor` e a superficie de autoria do runtime `praxis-tabs`: ele transforma `TabsMetadata` em operacao de produto (apply/save/reset) sem obrigar o time a editar JSON manual toda hora. Nao e apenas um formulario administrativo; e o ponto de governanca para evoluir tabs config-first com controle de contrato.
+
+## Scope and positioning
+
+- Escopo: contrato JSON publico e limites de comportamento observavel.
+- Fora de escopo: tutorial de adocao e walkthrough operacional detalhado.
+- Posicionamento: referencia canonicamente governada para consumidores, arquitetos e mantenedores.
+
+## Source of truth
+
+| Source | Kind | Notes |
+| --- | --- | --- |
+| projects/praxis-tabs/src/lib/praxis-tabs-config-editor.ts | runtime-code | Source de implementacao declarado no repositorio. |
+| projects/praxis-tabs/src/lib/praxis-tabs.ts | runtime-code | Source de implementacao declarado no repositorio. |
+| projects/praxis-tabs/src/lib/quick-setup/tabs-quick-setup.component.ts | runtime-code | Source de implementacao declarado no repositorio. |
+| projects/praxis-tabs/src/lib/ai/tabs-ai-capabilities.ts | runtime-code | Source de implementacao declarado no repositorio. |
+
+## Support legend
+
+- Active: suportado e observado no runtime atual.
+- Partial: suporte parcial, com restricoes conhecidas.
+- Declared-only: declarado em tipos/schema sem ligacao runtime confirmada.
+- Schema-only: presente em schema/modelo sem confirmacao de execucao.
+- Deprecated: mantido por compatibilidade legada com migracao prevista.
+
+## Contract classification
+
+### Canonical paths (public contract)
+
+| Path | Type | Required | Default | Status | Notes |
+| --- | --- | --- | --- | --- | --- |
+| `meta` | not-specified | not-specified | n/a | Partial | Preservado da documentação anterior. |
+| `appearance.density` | not-specified | not-specified | n/a | Active | Preservado da documentação anterior. |
+| `appearance.themeClass` | not-specified | not-specified | n/a | Active | Preservado da documentação anterior. |
+| `appearance.customCss` | not-specified | not-specified | n/a | Active | Preservado da documentação anterior. |
+| `appearance.tokens.*` | not-specified | not-specified | n/a | Partial | Preservado da documentação anterior. |
+| `behavior.lazyLoad/closeable/reorderable` | not-specified | not-specified | n/a | Active | Preservado da documentação anterior. |
+| `events` | not-specified | not-specified | n/a | Partial | Preservado da documentação anterior. |
+| `accessibility.highContrast/reduceMotion` | not-specified | not-specified | n/a | Active | Preservado da documentação anterior. |
+| `accessibility.ariaLabels/keyboardNavigation` | not-specified | not-specified | n/a | Declared-only | Preservado no contrato JSON, sem superficie ativa na UI. |
+| `group.*` | not-specified | not-specified | n/a | Partial | Preservado da documentação anterior. |
+| `tabs[]` | not-specified | not-specified | n/a | Active | Preservado da documentação anterior. |
+| `tabs[].content` | not-specified | not-specified | n/a | Partial | Preservado da documentação anterior. |
+| `nav.*` | not-specified | not-specified | n/a | Active | Preservado da documentação anterior. |
+| `nav.links[]` | not-specified | not-specified | n/a | Active | Preservado da documentação anterior. |
+
+### Supported legacy paths
+
+Nenhum path legado suportado foi identificado nesta revisão baseada em evidência textual preservada.
+
+### Internal-only paths
+
+| Path | Internal consumer | Runtime presence | Public support | Notes |
+| --- | --- | --- | --- | --- |
+| not-yet-mapped | not-yet-verified | not-yet-verified | No | Caminhos internos nao mapeados explicitamente nesta revisao automatizada. |
+
+### Experimental paths
+
+| Path | Enablement (flag/guard) | Stability | Rollout notes | Notes |
+| --- | --- | --- | --- | --- |
+| not-yet-mapped | not-yet-verified | Experimental | not-yet-verified | Registrar somente quando houver evidencia em runtime/codigo. |
+
+## Overview
+
+Este arquivo foi adaptado para o padrao canonico atual sem remover conteudo tecnico existente. O conteudo detalhado anterior foi preservado para manter rastreabilidade historica e reduzir perda de contexto.
+
+## Public contract surface
+
+### Top-level configuration blocks
+
+| Block | Purpose | Required | Merge strategy | Notes |
+| --- | --- | --- | --- | --- |
+| meta | Configuração top-level identificada na referência preservada. | not-yet-verified | component-defined | 1 path(s) mapeado(s), status predominante Partial. |
+| appearance | Configuração top-level identificada na referência preservada. | not-yet-verified | component-defined | 4 path(s) mapeado(s), status predominante Active. |
+| behavior | Configuração top-level identificada na referência preservada. | not-yet-verified | component-defined | 1 path(s) mapeado(s), status predominante Active. |
+| events | Configuração top-level identificada na referência preservada. | not-yet-verified | component-defined | 1 path(s) mapeado(s), status predominante Partial. |
+| accessibility | Configuração top-level identificada na referência preservada. | not-yet-verified | component-defined | 2 path(s) mapeado(s), status predominante Active. |
+| group | Configuração top-level identificada na referência preservada. | not-yet-verified | component-defined | 1 path(s) mapeado(s), status predominante Partial. |
+| tabs[] | Configuração top-level identificada na referência preservada. | not-yet-verified | component-defined | 2 path(s) mapeado(s), status predominante Active. |
+| nav | Configuração top-level identificada na referência preservada. | not-yet-verified | component-defined | 2 path(s) mapeado(s), status predominante Active. |
+
+### Nested configuration blocks
+
+| Path | Type | Required | Default | Constraints | Notes |
+| --- | --- | --- | --- | --- | --- |
+| `meta` | not-specified | not-specified | n/a | component-defined | Preservado da documentação anterior. |
+| `appearance.density` | not-specified | not-specified | n/a | component-defined | Preservado da documentação anterior. |
+| `appearance.themeClass` | not-specified | not-specified | n/a | component-defined | Preservado da documentação anterior. |
+| `appearance.customCss` | not-specified | not-specified | n/a | component-defined | Preservado da documentação anterior. |
+| `appearance.tokens.*` | not-specified | not-specified | n/a | component-defined | Preservado da documentação anterior. |
+| `behavior.lazyLoad/closeable/reorderable` | not-specified | not-specified | n/a | component-defined | Preservado da documentação anterior. |
+| `events` | not-specified | not-specified | n/a | component-defined | Preservado da documentação anterior. |
+| `accessibility.highContrast/reduceMotion` | not-specified | not-specified | n/a | component-defined | Preservado da documentação anterior. |
+| `accessibility.ariaLabels/keyboardNavigation` | not-specified | not-specified | n/a | Declared-only | Preservado no JSON, sem exposicao dedicada no editor. |
+| `group.*` | not-specified | not-specified | n/a | component-defined | Preservado da documentação anterior. |
+
+### Input bindings
+
+| Binding/Path | Type | Required | Source | Runtime normalization | Notes |
+| --- | --- | --- | --- | --- | --- |
+| `config` | `TabsMetadata` | recomendado | component-input | not-yet-verified | Preservado da documentação anterior. |
+| `tabsId` | `string` | opcional | component-input | not-yet-verified | Preservado da documentação anterior. |
+
+### Output events
+
+| Event | Payload | Trigger | Stability | Notes |
+| --- | --- | --- | --- | --- |
+| component-outputs | see-detailed-api | runtime-event | Partial | Eventos preservados na referência detalhada. |
+
+### External side channels
+
+| Channel | Direction | Contract | Failure mode | Notes |
+| --- | --- | --- | --- | --- |
+| host/services/storage | bidirectional | see-detailed-api | not-yet-verified | Side channels dependem do componente e do host consumidor. |
+
+### Host/runtime dependencies
+
+| Dependency | Required | Environment | Purpose | Notes |
+| --- | --- | --- | --- | --- |
+| see-source-of-truth | true | browser/dev/prod/ssr | runtime linkage | Confirmar por componente quando necessario. |
+
+## Coverage matrix
+
+| Surface | Verified | Coverage status | Evidence | Notes |
+| --- | --- | --- | --- | --- |
+| Runtime | false | Partial | source_of_truth + conteudo preservado | Revisao estrutural concluida; validacao comportamental fina pode exigir follow-up. |
+| Schema/Types | true | Partial | interfaces/modelos citados | Mapeamento formal de todos os campos ainda pode requerer refinamento. |
+| Editor/Tooling | false | Partial | secoes de editor quando presentes | Cobertura de editor/tooling nem sempre confirmada por evidencia direta. |
+
+## Runtime coverage boundaries
+
+- Cobertura consolidada com base em documentacao existente e source of truth declarado.
+- Comportamentos fora de evidencia direta foram marcados como not-yet-verified ou Partial.
+- Compatibilidade legada, quando detectada, foi separada em classificacao explicita.
+
+## Resolution model
+
+### Merge order
+
+1. defaults do componente
+2. contrato JSON recebido
+3. overrides de host/runtime
+4. normalizacoes internas
+
+### Fallback order
+
+contrato explicito -> aliases legados (quando suportados) -> defaults internos -> comportamento seguro
+
+### Override points
+
+- inputs publicos do componente
+- configuracao JSON de runtime
+- integracoes de host (servicos/tokens/adapters)
+
+### Runtime normalization
+
+Campos e aliases preservados do documento anterior devem convergir progressivamente para paths canonicos declarados.
+
+### Precedence rules
+
+Quando houver conflito entre alias e path canonico, priorizar path canonico e manter alias apenas para backward compatibility.
+
+## Validation and error semantics
+
+### Validation model
+
+| Path/Rule | Validation phase | Behavior on fail | Error code / warning | Notes |
+| --- | --- | --- | --- | --- |
+| see-detailed-api | runtime | warn-or-reject | not-yet-standardized | Semantica de validacao preservada do documento anterior. |
+
+### Error semantics
+
+Erros devem ser classificados em warnings recuperaveis versus falhas bloqueantes. Quando a evidencia nao estiver explicita, tratar como not yet verified.
+
+### Fail-open / fail-closed behavior
+
+| Condition | Mode | Runtime behavior | Consumer impact |
+| --- | --- | --- | --- |
+| invalid-or-unknown-field | component-defined | not-yet-verified | Variavel por componente; requer verificacao em runtime. |
+
+### Invalid or unknown field handling
+
+- Campos desconhecidos: comportamento depende da estrategia do componente (ignore, warn ou reject).
+- Campos invalidos: podem gerar fallback, warning ou falha conforme implementacao.
+- Registrar divergencias observadas em Known limitations and mismatches.
+
+### Runtime warnings vs hard failures
+
+| Condition | Severity | Observability | Consumer action |
+| --- | --- | --- | --- |
+| partial-or-declared-only-coverage | warning | logs/eventos do componente | confirmar ligacao runtime antes de uso critico |
+
+## Detailed API
+
+### Preserved technical reference (normalized from previous revision)
+
+`praxis-tabs-config-editor` e a superficie de autoria do runtime `praxis-tabs`: ele transforma `TabsMetadata` em operacao de produto (apply/save/reset) sem obrigar o time a editar JSON manual toda hora. Nao e apenas um formulario administrativo; e o ponto de governanca para evoluir tabs config-first com controle de contrato.
+
+### Prova em 20 segundos
+
+Abra o editor no Settings Panel e aplique um payload minimo:
+
+```json
+{
+  "behavior": { "lazyLoad": true, "reorderable": true },
+  "group": { "selectedIndex": 0, "stretchTabs": true },
+  "tabs": [
+    { "id": "overview", "textLabel": "Overview" },
+    { "id": "history", "textLabel": "History" }
+  ]
+}
+```
+
+- O editor devolve `{ config }` pronto para `applied$`/`saved$`.
+- O runtime passa a refletir o contrato sem mexer no host template.
+- O processo fica versionavel e auditavel por JSON.
+
+### Table of contents
+
+- [Start here](#start-here)
+  - [Promessa e limites](#promessa-e-limites)
+  - [Status model](#status-model)
+  - [Checklist de operacao](#checklist-de-operacao)
+- [Guia operacional (produto)](#guia-operacional-produto)
+  - [Entrada e saida do editor](#entrada-e-saida-do-editor)
+  - [Fluxo no settings panel](#fluxo-no-settings-panel)
+  - [Controle por guias](#controle-por-guias)
+  - [Widgets e presets de ecossistema](#widgets-e-presets-de-ecossistema)
+  - [Validacao, dirty state e governanca](#validacao-dirty-state-e-governanca)
+- [Contrato tecnico completo (referencia)](#contrato-tecnico-completo-referencia)
+  - [Coverage matrix](#coverage-matrix)
+  - [Complete editable path index](#complete-editable-path-index)
+- [Examples](#examples)
+- [Known limitations and mismatches](#known-limitations-and-mismatches)
+- [Source references](#source-references)
+- [Referencias oficiais Angular](#referencias-oficiais-angular)
+
+### Start here
+
+#### Promessa e limites
+
+**O que isso habilita:** autoria controlada de `TabsMetadata` em runtime com retorno padrao para persistencia e replay.
+
+**Quando usar:** quando o time quer iterar fluxo de tabs sem abrir PR para cada ajuste de configuracao.
+
+**Exemplo minimo:** ajustar `behavior` e `tabs[]` na UI e propagar por `applied$`.
+
+Garantias (hoje):
+
+- Sempre retorna payload no formato `{ config: TabsMetadata }`.
+- Mantem estado de validacao (`isValid$`) e alteracao (`isDirty$`).
+- Permite apply sem fechar painel e save com a mesma estrutura.
+
+Limites (hoje):
+
+- Nem todo campo editavel no editor tem efeito ativo no runtime final.
+- Validacao semantica profunda de widgets/ids ainda e limitada.
+- Parte da cobertura continua dependente de edicao JSON livre.
+
+#### Status model
+
+Padrao oficial de status neste documento:
+
+- `Status: Active` - editavel e retornado no payload.
+- `Status: Partial` - editavel com restricoes ou efeito parcial no runtime.
+- `Status: Stored-only` - preservado no JSON sem UI dedicada.
+- `Status: Declared-only` - mantido no contrato JSON, sem exposicao dedicada no editor atual.
+
+#### Checklist de operacao
+
+- Sempre abrir com seed `config` quando existir (evita sobrescrita acidental).
+- Tratar `applied$` para preview e `saved$` para persistencia definitiva.
+- Validar ids duplicados de `tabs[]/links[]` no host (regra externa ao editor).
+- Revisar campos `Stored-only/Declared-only` antes de prometer efeito de UI.
+- Em widgets, validar `inputs/outputs` no componente destino.
+
+### Guia operacional (produto)
+
+#### Entrada e saida do editor
+
+**O que isso habilita:** contrato previsivel entre Settings Panel e runtime consumidor.
+
+**Quando usar:** em qualquer fluxo de configuracao operacional de tabs.
+
+**Exemplo minimo:** `content.component = PraxisTabsConfigEditor` com `inputs: { config, tabsId }`.
+
+`Status: Active`.
+
+##### Entrada (`SETTINGS_PANEL_DATA`)
+
+| Campo | Tipo | Required | Status | Observacao |
+| --- | --- | --- | --- | --- |
+| `config` | `TabsMetadata` | recomendado | Active | seed principal do editor |
+| `tabsId` | `string` | opcional | Active | compatibilidade de payload/host |
+
+##### Saida (`SettingsValueProvider`)
+
+| Superficie | Tipo | Status | Observacao |
+| --- | --- | --- | --- |
+| `isDirty$` | `BehaviorSubject<boolean>` | Active | compara snapshot inicial x editado |
+| `isValid$` | `BehaviorSubject<boolean>` | Active | depende principalmente do parse da guia JSON |
+| `isBusy$` | `BehaviorSubject<boolean>` | Active | reservado para fluxo async |
+| `getSettingsValue()` | `() => { config: TabsMetadata }` | Active | usado em `applied$` |
+| `onSave()` | `() => { config: TabsMetadata }` | Active | usado em `saved$` |
+| `reset()` | `() => void` | Active | restaura snapshot inicial |
+
+#### Fluxo no settings panel
+
+**O que isso habilita:** ciclo de configuracao curto (editar, aplicar, salvar, reverter).
+
+**Quando usar:** para operacao continua de produto sem rebuild da tela.
+
+**Exemplo minimo:** abrir painel, ajustar guia `Estilo`, clicar aplicar e validar no runtime.
+
+`Status: Active`.
+
+Fluxo padrao:
+
+1. Host abre `SettingsPanelService.open(...)`.
+2. Editor cria snapshots (`initialConfig` e `editedConfig`).
+3. Cada mudanca atualiza `isDirty$` e `isValid$`.
+4. `getSettingsValue()`/`onSave()` devolvem `{ config }`.
+5. Host aplica/persiste e runtime sincroniza selecao.
+
+#### Controle por guias
+
+**O que isso habilita:** autoria orientada a tarefa, nao apenas schema bruto.
+
+**Quando usar:** para reduzir erro em campos frequentes do contrato.
+
+**Exemplo minimo:** usar `Comportamento` para lazy/reorder e `Abas` para estrutura inicial.
+
+`Status: Active`.
+
+| Guia | O que edita | Impacto no `praxis-tabs` | Status |
+| --- | --- | --- | --- |
+| `Comportamento` | `behavior.closeable/lazyLoad/reorderable` | toggle de close/lazy/reorder | Active |
+| `Grupo` | `group.*` | runtime `mat-tab-group` | Partial |
+| `Navegacao` | `nav.*` | runtime `mat-tab-nav-bar` | Partial |
+| `JSON` | objeto completo | override total do `editedConfig` | Active |
+| `Estilo` | `appearance.themeClass/density/customCss/tokens` | classes + css runtime | Partial |
+| `Abas` | `tabs[]` + widgets por aba | group mode | Active |
+| `Acessibilidade` | `accessibility.highContrast/reduceMotion` | classes no root | Partial |
+| `Links` | `nav.links[]` + widgets por link | nav mode | Active |
+
+#### Widgets e presets de ecossistema
+
+**O que isso habilita:** composicao rapida de modulos ricos por aba/link.
+
+**Quando usar:** quando tabs atua como shell de pagina por dominio.
+
+**Exemplo minimo:** adicionar preset `table` para montar `praxis-table` em uma aba.
+
+`Status: Active`.
+
+Operacoes suportadas:
+
+- adicionar componente por id (`ComponentMetadataRegistry`)
+- editar `inputs` e `outputs` em JSON
+- reordenar widgets por drag-and-drop
+- usar presets rapidos por `resourcePath`:
+  - `form` -> `praxis-dynamic-form`
+  - `table` -> `praxis-table`
+  - `crud` -> `praxis-crud`
+
+#### Validacao, dirty state e governanca
+
+**O que isso habilita:** controle de risco na autoria sem bloquear iteracao.
+
+**Quando usar:** em ambientes com auditoria de configuracao e trilha de mudanca.
+
+**Exemplo minimo:** impedir save operacional quando `isValid$` estiver `false`.
+
+`Status: Partial`.
+
+Regras atuais:
+
+- `onJsonTextChange`:
+  - JSON valido -> atualiza `editedConfig`, `isValid=true`
+  - JSON invalido -> `isValid=false` e mantem ultimo objeto valido
+- `isDirty$` via `JSON.stringify(initialConfig) !== JSON.stringify(editedConfig)`
+- `onAppearanceChange` atualiza `jsonText` e dirty state
+
+Risco conhecido:
+
+- dirty check por stringify pode sinalizar mudanca por ordem de chaves.
+
+### Contrato tecnico completo (referencia)
+
+#### Coverage matrix
+
+| JSON path | Status | Observacao |
+| --- | --- | --- |
+| `meta` | Stored-only | preservado no JSON, sem guia dedicada |
+| `appearance.density` | Active | seletor visual |
+| `appearance.themeClass` | Active | input de classe |
+| `appearance.customCss` | Active | textarea livre |
+| `appearance.tokens.*` | Partial | lista de tokens definida no editor |
+| `behavior.lazyLoad/closeable/reorderable` | Active | toggles |
+| `events` | Stored-only | sem guia dedicada |
+| `accessibility.highContrast/reduceMotion` | Active | toggles |
+| `accessibility.ariaLabels/keyboardNavigation` | Declared-only | mantido no JSON, sem UI dedicada |
+| `group.*` | Partial | maioria ativa; sem validacao semantica completa |
+| `tabs[]` | Active | CRUD + reorder + widgets |
+| `tabs[].content` | Partial | preservado no JSON; sem wizard dedicado |
+| `nav.*` | Active | CRUD principal de nav |
+| `nav.links[]` | Active | CRUD + reorder + widgets |
+| `nav.links[].content` | Partial | preservado no JSON; sem wizard dedicado |
+
+#### Complete editable path index
+
+| Path | Status | Observacao |
+| --- | --- | --- |
+| `appearance.density` | Active | guia Estilo |
+| `appearance.themeClass` | Active | guia Estilo |
+| `appearance.customCss` | Active | guia Estilo |
+| `appearance.tokens.active-indicator-color` | Active | token list |
+| `appearance.tokens.active-label-text-color` | Active | token list |
+| `appearance.tokens.active-hover-indicator-color` | Active | token list |
+| `appearance.tokens.active-hover-label-text-color` | Active | token list |
+| `appearance.tokens.active-focus-indicator-color` | Active | token list |
+| `appearance.tokens.active-focus-label-text-color` | Active | token list |
+| `appearance.tokens.inactive-label-text-color` | Active | token list |
+| `appearance.tokens.inactive-hover-label-text-color` | Active | token list |
+| `appearance.tokens.inactive-focus-label-text-color` | Active | token list |
+| `appearance.tokens.pagination-icon-color` | Active | token list |
+| `appearance.tokens.divider-color` | Active | token list |
+| `appearance.tokens.background-color` | Active | token list |
+| `behavior.closeable` | Active | guia Comportamento |
+| `behavior.lazyLoad` | Active | guia Comportamento |
+| `behavior.reorderable` | Active | guia Comportamento |
+| `group.alignTabs` | Active | guia Grupo |
+| `group.headerPosition` | Active | guia Grupo |
+| `group.selectedIndex` | Active | guia Grupo |
+| `group.animationDuration` | Active | guia Grupo |
+| `group.color` | Active | guia Grupo |
+| `group.backgroundColor` | Active | guia Grupo |
+| `group.ariaLabel` | Active | guia Grupo |
+| `group.ariaLabelledby` | Active | guia Grupo |
+| `group.dynamicHeight` | Active | guia Grupo |
+| `group.fitInkBarToContent` | Active | guia Grupo |
+| `group.disablePagination` | Active | guia Grupo |
+| `group.disableRipple` | Active | guia Grupo |
+| `group.preserveContent` | Active | guia Grupo |
+| `group.stretchTabs` | Active | guia Grupo |
+| `nav.selectedIndex` | Active | guia Navegacao |
+| `nav.animationDuration` | Active | guia Navegacao |
+| `nav.ariaLabel` | Active | guia Navegacao |
+| `nav.ariaLabelledby` | Active | guia Navegacao |
+| `nav.color` | Active | guia Navegacao |
+| `nav.backgroundColor` | Active | guia Navegacao |
+| `nav.fitInkBarToContent` | Active | guia Navegacao |
+| `nav.disablePagination` | Active | guia Navegacao |
+| `nav.disableRipple` | Active | guia Navegacao |
+| `nav.stretchTabs` | Active | guia Navegacao |
+| `tabs[]` | Active | guia Abas |
+| `tabs[].id` | Active | guia Abas |
+| `tabs[].textLabel` | Active | guia Abas |
+| `tabs[].labelClass` | Active | guia Abas |
+| `tabs[].bodyClass` | Active | guia Abas |
+| `tabs[].ariaLabel` | Active | guia Abas |
+| `tabs[].ariaLabelledby` | Active | guia Abas |
+| `tabs[].disabled` | Active | guia Abas |
+| `tabs[].widgets[]` | Active | guia Abas |
+| `tabs[].widgets[].inputs` | Active | JSON livre |
+| `tabs[].widgets[].outputs` | Active | JSON livre |
+| `nav.links[]` | Active | guia Links |
+| `nav.links[].id` | Active | guia Links |
+| `nav.links[].label` | Active | guia Links |
+| `nav.links[].active` | Stored-only | editor grava; runtime final deriva por indice |
+| `nav.links[].disabled` | Active | guia Links |
+| `nav.links[].disableRipple` | Active | guia Links |
+| `nav.links[].fitInkBarToContent` | Active | guia Links |
+| `nav.links[].widgets[]` | Active | guia Links |
+| `nav.links[].widgets[].inputs` | Active | JSON livre |
+| `nav.links[].widgets[].outputs` | Active | JSON livre |
+| `accessibility.highContrast` | Active | guia Acessibilidade |
+| `accessibility.reduceMotion` | Active | guia Acessibilidade |
+
+### Examples
+
+### Minimal valid
+
+```json
+{
+  "behavior": { "lazyLoad": true, "reorderable": true },
+  "group": { "selectedIndex": 0, "stretchTabs": true },
+  "tabs": [
+    { "id": "overview", "textLabel": "Overview" },
+    { "id": "history", "textLabel": "History" }
+  ]
+}
+```
+
+### Typical/common
+
+```json
+{
+  "behavior": { "lazyLoad": true, "reorderable": true },
+  "group": { "selectedIndex": 0, "stretchTabs": true },
+  "tabs": [
+    { "id": "overview", "textLabel": "Overview" },
+    { "id": "history", "textLabel": "History" }
+  ]
+}
+```
+
+### Advanced
+
+```json
+{
+  "behavior": { "lazyLoad": true, "reorderable": true },
+  "group": { "selectedIndex": 0, "stretchTabs": true },
+  "tabs": [
+    { "id": "overview", "textLabel": "Overview" },
+    { "id": "history", "textLabel": "History" }
+  ]
+}
+```
+
+### Enterprise scenario
+
+```json
+{}
+```
+
+## Known limitations and mismatches
+
+| Path/Behavior | Observed behavior (runtime) | Desired behavior | Impact | Tracking issue | Target fix |
+| --- | --- | --- | --- | --- | --- |
+| coverage/mapping | Evidência textual preservada indica itens Partial/Declared-only. | Cobertura confirmada por evidência runtime + schema + editor. | Pode gerar uso de paths não totalmente ligados. | to-be-linked | next-doc-cycle |
+
+## Compatibility and migration notes
+
+| Concern | Affected versions | Migration action | Deadline | Notes |
+| --- | --- | --- | --- | --- |
+| legacy aliases and mixed status vocabulary | pre-canonical docs | manter apenas taxonomia canonica nas secoes novas e reduzir termos legados em revisoes incrementais | ongoing | backward compatibility documental ainda existe em secoes historicas |
+
+## Source references
+
+| Source type | Path/URL | Why it is source of truth | Last verified (YYYY-MM-DD) | Notes |
+| --- | --- | --- | --- | --- |
+| local-file | projects/praxis-tabs/src/lib/praxis-tabs-config-editor.ts | Evidencia de implementacao e contrato. | 2026-03-05 | referencia preservada da versao anterior |
+| local-file | projects/praxis-tabs/src/lib/praxis-tabs.ts | Evidencia de implementacao e contrato. | 2026-03-05 | referencia preservada da versao anterior |
+| local-file | projects/praxis-tabs/src/lib/quick-setup/tabs-quick-setup.component.ts | Evidencia de implementacao e contrato. | 2026-03-05 | referencia preservada da versao anterior |
+| local-file | projects/praxis-tabs/src/lib/ai/tabs-ai-capabilities.ts | Evidencia de implementacao e contrato. | 2026-03-05 | referencia preservada da versao anterior |