@praxisui/list 8.0.0-beta.19 → 8.0.0-beta.20

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

@@ -0,0 +1,523 @@
+---
+title: "praxis-list-config-editor JSON API (Canonical)"
+slug: "praxis-list-config-editor-json-api"
+doc_type: "api-reference"
+component: "praxis-list-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-list-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-list/src/lib/editors/list-config-editor.component.ts"
+  - "projects/praxis-list/src/lib/editors/list-config-editor.component.html"
+  - "projects/praxis-list/src/lib/models/list-config.model.ts"
+  - "projects/praxis-list/src/lib/utils/templating-inference.ts"
+source_of_truth_last_verified: "2026-03-05"
+last_updated: "2026-03-05"
+toc: true
+sidebar: true
+tags:
+  - "json-api"
+  - "canonical-contract"
+  - "praxis-list-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-list-config-editor
+
+Este documento e a referencia canonica da API JSON de praxis-list-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: Referencia canonica da JSON API do `praxis-list-config-editor` (superficie de autoria do `ListAuthoringDocument`).
+
+## 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-list/src/lib/editors/list-config-editor.component.ts | runtime-code | Source de implementacao declarado no repositorio. |
+| projects/praxis-list/src/lib/editors/list-config-editor.component.html | template-style | Source de implementacao declarado no repositorio. |
+| projects/praxis-list/src/lib/models/list-config.model.ts | runtime-code | Source de implementacao declarado no repositorio. |
+| projects/praxis-list/src/lib/utils/templating-inference.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 |
+| --- | --- | --- | --- | --- | --- |
+| `id` | not-specified | not-specified | n/a | Declared-only | Preservado no objeto; sem campo dedicado no editor. |
+| `dataSource.resourcePath` | not-specified | not-specified | n/a | Active | Campo principal para schema remoto. |
+| `dataSource.query` | not-specified | not-specified | n/a | Active | JSON editavel com validacao sintatica. |
+| `dataSource.sort` | not-specified | not-specified | n/a | Active | Gerado por `sortField/sortDir` e por UI sort rows. |
+| `dataSource.data` | not-specified | not-specified | n/a | Declared-only | Nao possui editor dedicado para dataset local. |
+| `layout.variant` | not-specified | not-specified | n/a | Active | `list/cards/tiles`. |
+| `layout.model` | not-specified | not-specified | n/a | Active | `standard/media/hotel`. |
+| `layout.lines` | not-specified | not-specified | n/a | Active | `1/2/3`. |
+| `layout.density` | not-specified | not-specified | n/a | Active | `default/comfortable/compact`. |
+| `layout.dividers` | not-specified | not-specified | n/a | Active | `none/between/all`. |
+| `layout.groupBy` | not-specified | not-specified | n/a | Active | Texto livre ou campo de schema quando disponivel. |
+| `layout.stickySectionHeader` | not-specified | not-specified | n/a | Active | Toggle dedicado. |
+| `layout.virtualScroll` | not-specified | not-specified | n/a | Active | Toggle dedicado (mesmo que runtime possa nao aplicar). |
+| `layout.pageSize` | not-specified | not-specified | n/a | Active | Numero inteiro >= 1. |
+
+### 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 |
+| --- | --- | --- | --- | --- |
+| id | Configuração top-level identificada na referência preservada. | not-yet-verified | component-defined | 1 path(s) mapeado(s), status predominante Declared-only. |
+| dataSource | Configuração top-level identificada na referência preservada. | not-yet-verified | component-defined | 4 path(s) mapeado(s), status predominante Active. |
+| layout | Configuração top-level identificada na referência preservada. | not-yet-verified | component-defined | 9 path(s) mapeado(s), status predominante Active. |
+
+### Nested configuration blocks
+
+| Path | Type | Required | Default | Constraints | Notes |
+| --- | --- | --- | --- | --- | --- |
+| `id` | not-specified | not-specified | n/a | component-defined | Preservado no objeto; sem campo dedicado no editor. |
+| `dataSource.resourcePath` | not-specified | not-specified | n/a | component-defined | Campo principal para schema remoto. |
+| `dataSource.query` | not-specified | not-specified | n/a | component-defined | JSON editavel com validacao sintatica. |
+| `dataSource.sort` | not-specified | not-specified | n/a | component-defined | Gerado por `sortField/sortDir` e por UI sort rows. |
+| `dataSource.data` | not-specified | not-specified | n/a | component-defined | Nao possui editor dedicado para dataset local. |
+| `layout.variant` | not-specified | not-specified | n/a | component-defined | `list/cards/tiles`. |
+| `layout.model` | not-specified | not-specified | n/a | component-defined | `standard/media/hotel`. |
+| `layout.lines` | not-specified | not-specified | n/a | component-defined | `1/2/3`. |
+| `layout.density` | not-specified | not-specified | n/a | component-defined | `default/comfortable/compact`. |
+| `layout.dividers` | not-specified | not-specified | n/a | component-defined | `none/between/all`. |
+
+### Input bindings
+
+| Binding/Path | Type | Required | Source | Runtime normalization | Notes |
+| --- | --- | --- | --- | --- | --- |
+| `config` | `PraxisListConfig` | not-specified | component-input | not-yet-verified | Base interna editada e projetada para `document.config`. |
+| `document` | `ListAuthoringDocument \| undefined` | not-specified | component-input | not-yet-verified | Boundary canônico de autoria. |
+| `listId` | `string \| undefined` | not-specified | component-input | not-yet-verified | Retornado no payload de save (`{ config, id }`). |
+
+### 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)
+
+Referencia canonica da JSON API do `praxis-list-config-editor` (superficie de autoria do `ListAuthoringDocument`).
+
+Foco:
+
+- o que o editor aceita e devolve para o host (`SettingsPanel`);
+- regras de validacao aplicadas durante edicao;
+- divergencias entre "campo editavel" e "campo consumido no runtime da lista".
+
+Legenda de suporte:
+
+- `Active`: editavel e persistido pelo editor.
+- `Partial`: editavel com restricoes ou heuristicas.
+- `Declared-only`: preservado no objeto, sem editor dedicado.
+
+### Overview
+
+`praxis-list-config-editor` e um componente standalone de configuracao visual para `ListAuthoringDocument`, com `config` como payload interno principal.
+
+Fluxo macro:
+
+1. Recebe `document` canônico ou `config` legado (via `@Input` ou `SETTINGS_PANEL_DATA`).
+2. Faz parse para `ListAuthoringDocument` e projeta o documento via capability pública; o editor visual só hidrata estado transitório de UI em cima do documento canônico.
+3. Mantem estado de formulario e mapeamento (`mappingPrimary`, `mappingMeta`, `features`, `actions`, etc.).
+4. Valida continuamente (`verify`) e sinaliza `isDirty$` / `isValid$` / `isBusy$`.
+5. Em `getSettingsValue()` e `onSave()`, consolida mapeamentos e retorna `{ document, config, id }`, com `document` como boundary principal.
+
+### API
+
+#### Component inputs
+
+| Input | Tipo | Default | Status | Runtime notes |
+| --- | --- | --- | --- | --- |
+| `config` | `PraxisListConfig` | obrigatorio logico | Active | Base interna editada e projetada para `document.config`. |
+| `document` | `ListAuthoringDocument \| undefined` | opcional | Active | Boundary canônico de autoria. Quando ausente, `config` legado e convertido. |
+| `listId` | `string \| undefined` | `undefined` | Active | Retornado no payload de save (`{ document, config, id }`). |
+
+#### Component outputs
+
+Sem `@Output` publico.
+
+A integracao com host ocorre por `SettingsValueProvider`:
+
+- `getSettingsValue(): { document, config, id }`
+- `onSave(): { document, config, id }`
+
+#### Estado observavel
+
+| Canal | Tipo | Papel |
+| --- | --- | --- |
+| `isDirty$` | `BehaviorSubject<boolean>` | Indica divergencia em relacao ao snapshot inicial. |
+| `isValid$` | `BehaviorSubject<boolean>` | Resultado da validacao estrutural do editor. |
+| `isBusy$` | `BehaviorSubject<boolean>` | Estado de busy durante carregamento de schema. |
+
+### Authoring Coverage Matrix (`PraxisListConfig`)
+
+| JSON path | Status | Editor notes |
+| --- | --- | --- |
+| `id` | Declared-only | Preservado no objeto; sem campo dedicado no editor. |
+| `dataSource.resourcePath` | Active | Campo principal para schema remoto. |
+| `dataSource.query` | Active | JSON editavel com validacao sintatica. |
+| `dataSource.sort` | Active | Gerado por `sortField/sortDir` e por UI sort rows. |
+| `dataSource.data` | Declared-only | Nao possui editor dedicado para dataset local. |
+| `layout.variant` | Active | `list/cards/tiles`. |
+| `layout.model` | Active | `standard/media/hotel`. |
+| `layout.lines` | Active | `1/2/3`. |
+| `layout.density` | Active | `default/comfortable/compact`. |
+| `layout.dividers` | Active | `none/between/all`. |
+| `layout.groupBy` | Active | Texto livre ou campo de schema quando disponivel. |
+| `layout.stickySectionHeader` | Active | Toggle dedicado. |
+| `layout.virtualScroll` | Active | Toggle dedicado (mesmo que runtime possa nao aplicar). |
+| `layout.pageSize` | Active | Numero inteiro >= 1. |
+| `skin.type` | Active | Presets + selecao manual. |
+| `skin.gradient/radius/shadow/border/backdropBlur/class/inlineStyle` | Active | Edicao direta + presets. |
+| `selection.mode` | Active | `none/single/multiple`. |
+| `selection.formControlName` | Active | Binding por nome. |
+| `selection.formControlPath` | Active | Binding por path. |
+| `selection.compareBy` | Active | Validado contra campos do schema quando disponiveis. |
+| `selection.return` | Active | `value/item/id`. |
+| `templating.<slot>.type` | Partial | Suporta tipos visuais; `slot` nao possui fluxo dedicado no editor. |
+| `templating.<slot>.expr/class/style` | Active | Mapeado por builders e assistentes. |
+| `templating.<slot>.badge.*` | Active | Suporte para imagens com badge. |
+| `templating.<slot>.props.rating.*` | Active | `max/size/color` com limites validados. |
+| `templating.metaPlacement/metaPrefixIcon/statusPosition` | Active | Controles dedicados. |
+| `templating.features*` | Active | CRUD de features + modo de exibicao. |
+| `templating.iconColorMap/chipColorMap/chipLabelMap` | Active | Editor de pares chave/valor com normalizacao. |
+| `templating.skeleton.count` | Active | Controle numerico (>=0). |
+| `actions[].id/icon/label/color/kind/buttonVariant/showIf` | Active | Authoring completo de ações por item; `showIf` usa Json Logic serializável. |
+| `actions[].globalAction/emitLocal/showLoading/confirmation` | Active | Suporte a acoes globais estruturadas, incluindo `navigation.openRoute` como navegacao interna canonica, e confirmacao. |
+| `actions[].emitPayload` | Active | Campo editavel no editor; consumo runtime depende da lista. |
+| `ui.showSearch/searchField/searchPlaceholder` | Active | Bloco de busca. |
+| `ui.showSort/sortOptions` | Active | Editor visual com deteccao de duplicatas. |
+| `ui.showRange` | Active | Toggle dedicado. |
+| `i18n.locale/currency` | Active | Usado em formatacao de preview/runtime. |
+| `a11y.ariaLabel/ariaLabelledBy/highContrast/reduceMotion` | Active | Editavel no tab de acessibilidade. |
+| `events.itemClick/actionClick/selectionChange/loaded` | Active | Mapeamentos editaveis no tab de eventos. |
+
+### Validacao Estrutural
+
+`verify()` aplica validacoes de consistencia em loop assicrono:
+
+1. `layout.pageSize` deve ser inteiro >= 1 (quando definido).
+2. `layout.lines` deve estar em `{1,2,3}`.
+3. `sortField` e `selection.compareBy` devem existir em `fields[]` quando schema remoto foi carregado.
+4. `ui.sortOptions` nao pode ter duplicatas de `field,dir`.
+5. `queryJson` precisa ser JSON valido quando preenchido.
+6. URLs de imagem (leading/trailing/sectionHeader/emptyState) precisam seguir formato aceito.
+7. `ratingSize` deve estar em `10..32`; `ratingMax` em `1..10`.
+8. `actions[].globalAction.payload` deve ser JSON valido quando "parece JSON" (`{}` ou `[]`).
+
+### Integracao com schema remoto
+
+- O editor observa `resourcePath` com debounce de `300ms`.
+- Quando `GenericCrudService` esta disponivel:
+  - chama `configure(path)` + `getSchema()`;
+  - popula `fields[]` para combos e validacoes;
+  - marca `isBusy$` durante a operacao.
+- Em erro de schema, retorna `fields=[]` sem quebrar o editor.
+
+### Regras de Save e Round-trip
+
+Antes de devolver configuracao para host:
+
+1. `ensureMappingApplied()` consolida estado dos mapeadores (`mapping*`) em `working.templating`.
+2. `normalizeActionPayloads()` converte `globalAction.payload` string para objeto/array quando JSON valido, inclusive payloads de navegacao interna com `query` e `state`.
+3. Retorno padrao: `{ config: working, id: listId }`.
+
+### Exemplos
+
+#### 1) Integracao no SettingsPanel
+
+```ts
+const ref = settingsPanel.open({
+  id: 'praxis-list-editor:lista-rh',
+  title: 'Lista - Configuracoes',
+  content: {
+    component: PraxisListConfigEditor,
+    inputs: { config, listId: 'lista-rh' },
+  },
+});
+
+ref.saved$.subscribe((payload) => {
+  // payload = { config, id }
+  updateListConfig(payload.config);
+});
+```
+
+#### 2) Caso valido de acao global
+
+```json
+{
+  "actions": [
+    {
+      "id": "approve",
+      "globalAction": {
+        "actionId": "workflow.approve",
+        "payload": { "id": "${item.id}" }
+      },
+      "showLoading": true,
+      "emitLocal": true
+    }
+  ]
+}
+```
+
+#### 3) Navegacao interna canonica
+
+```json
+{
+  "actions": [
+    {
+      "id": "details",
+      "globalAction": {
+        "actionId": "navigation.openRoute",
+        "payload": {
+          "path": "/clientes/detalhe",
+          "query": { "id": "${item.id}" },
+          "state": { "source": "list", "selectedId": "${item.id}" }
+        }
+      }
+    }
+  ]
+}
+```
+
+### Known limitations and pending investigation
+
+1. Nao existe editor dedicado para `dataSource.data` (dataset local grande).
+2. O editor permite campos que podem nao ter efeito no runtime final (ex.: flags declarativas sem binding atual).
+3. `isDirty$` usa comparacao por snapshot JSON; mudancas de ordenacao de chaves/objetos podem gerar ruido em cenarios extremos.
+4. Conversao automatica de `globalAction.payload` string para JSON e heuristica (so quando formato parece objeto/array).
+
+### Source references
+
+- `projects/praxis-list/src/lib/editors/list-config-editor.component.ts`
+- `projects/praxis-list/src/lib/editors/list-config-editor.component.html`
+- `projects/praxis-list/src/lib/models/list-config.model.ts`
+- `projects/praxis-list/src/lib/utils/templating-inference.ts`
+
+## JSON path index
+
+| Path | Type | Required | Default | Status | Notes |
+| --- | --- | --- | --- | --- | --- |
+| `id` | not-specified | not-specified | n/a | Declared-only | Preservado no objeto; sem campo dedicado no editor. |
+| `dataSource.resourcePath` | not-specified | not-specified | n/a | Active | Campo principal para schema remoto. |
+| `dataSource.query` | not-specified | not-specified | n/a | Active | JSON editavel com validacao sintatica. |
+| `dataSource.sort` | not-specified | not-specified | n/a | Active | Gerado por `sortField/sortDir` e por UI sort rows. |
+| `dataSource.data` | not-specified | not-specified | n/a | Declared-only | Nao possui editor dedicado para dataset local. |
+| `layout.variant` | not-specified | not-specified | n/a | Active | `list/cards/tiles`. |
+| `layout.model` | not-specified | not-specified | n/a | Active | `standard/media/hotel`. |
+| `layout.lines` | not-specified | not-specified | n/a | Active | `1/2/3`. |
+| `layout.density` | not-specified | not-specified | n/a | Active | `default/comfortable/compact`. |
+| `layout.dividers` | not-specified | not-specified | n/a | Active | `none/between/all`. |
+| `layout.groupBy` | not-specified | not-specified | n/a | Active | Texto livre ou campo de schema quando disponivel. |
+| `layout.stickySectionHeader` | not-specified | not-specified | n/a | Active | Toggle dedicado. |
+| `layout.virtualScroll` | not-specified | not-specified | n/a | Active | Toggle dedicado (mesmo que runtime possa nao aplicar). |
+| `layout.pageSize` | not-specified | not-specified | n/a | Active | Numero inteiro >= 1. |
+
+## Events
+
+| Event | Payload | Trigger | Stability | Notes |
+| --- | --- | --- | --- | --- |
+| component-outputs | see-detailed-api | runtime-event | Partial | Eventos preservados na referência detalhada. |
+
+## Styling API
+
+| Token/Class | Scope | Purpose | Notes |
+| --- | --- | --- | --- |
+| see-detailed-api | component | styling/runtime | Consolidar naming canonico quando aplicavel. |
+
+## Editor and tooling notes
+
+- Cobertura de editor/tooling foi separada da cobertura de runtime para evitar confusao de suporte.
+- Quando nao houver evidencia direta no codigo, o status deve permanecer not yet verified.
+
+## Examples
+
+### Minimal valid
+
+```json
+{}
+```
+
+### Typical/common
+
+```json
+{}
+```
+
+### Advanced
+
+```json
+{}
+```
+
+### 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 | unificar para taxonomia canonica (Active/Partial/Declared-only/...) | next-doc-cycle | manter backward compatibility documentada |
+
+## Source references
+
+| Source type | Path/URL | Why it is source of truth | Last verified (YYYY-MM-DD) | Notes |
+| --- | --- | --- | --- | --- |
+| local-file | projects/praxis-list/src/lib/editors/list-config-editor.component.ts | Evidencia de implementacao e contrato. | 2026-03-05 | referencia preservada da versao anterior |
+| local-file | projects/praxis-list/src/lib/editors/list-config-editor.component.html | Evidencia de implementacao e contrato. | 2026-03-05 | referencia preservada da versao anterior |
+| local-file | projects/praxis-list/src/lib/models/list-config.model.ts | Evidencia de implementacao e contrato. | 2026-03-05 | referencia preservada da versao anterior |
+| local-file | projects/praxis-list/src/lib/utils/templating-inference.ts | Evidencia de implementacao e contrato. | 2026-03-05 | referencia preservada da versao anterior |