@praxisui/table 8.0.0-beta.1 → 8.0.0-beta.11

package/README.md

@@ -469,6 +469,18 @@ O chrome conversacional, `sessionId`, `clientTurnId`, respostas rapidas e ciclo
 por `PraxisAssistantTurnOrchestratorService`; a semantica especifica da tabela continua em `TableAiAdapter` e no
 `TableAgenticAuthoringTurnFlow`.
 
+## Agentic Authoring & Manifest
+
+O `@praxisui/table` suporta authoring agentic através de um `ComponentAuthoringManifest` canônico completo. Este manifesto define o contrato executável para que agentes de IA descubram alvos e realizem operações na configuração da tabela.
+
+- **Component ID:** `praxis-table`
+- **Config Schema:** `TableConfig`
+- **Alvos Editáveis (30):** `column`, `computedColumn`, `renderer`, `conditionalRenderer`, `rowAction`, `toolbarAction`, `toolbar`, `filter`, `grouping`, `selection`, `export`, `appearance`, `expansion`, `rule`, `meta`, `bulkAction`, `contextAction`, `pagination`, `sorting`, `interaction`, `loading`, `emptyState`, `resizing`, `dragging`, `editing`, `messages`, `localization`, `performance`, `data`, `accessibility`.
+- **Famílias de Operações (58):** Implementação semântica rigorosa, com target resolvers próprios por operação, alinhada com o `TableConfigV2` canônico. Inclui as 22 famílias obrigatórias do gate e cobre 100% dos paths publicados em `TABLE_AI_CAPABILITIES`: metadados, colunas, renderizadores, regras condicionais, paginação, ordenação, filtros, seleção, interação, loading, empty state, resizing, dragging, edição, toolbar, ações, exportação, aparência, expansão, mensagens, localização, performance, dados e acessibilidade.
+- **Validação:** Inclui 16 validadores determinísticos cobrindo unicidade, integridade de caminhos, suporte a renderizadores, presets de formatação, segurança de estilos, segurança de resource binding e round-trip do editor. A spec focal compara o manifesto contra `TABLE_AI_CAPABILITIES` e falha se qualquer path publicado ficar sem operação de authoring.
+
+O manifesto (v2.0.0) é exportado como `PRAXIS_TABLE_AUTHORING_MANIFEST` e está integrado no `ai_registry` para backend tools.
+
 ## 🚀 Instalação
 
 ```bash
@@ -938,7 +950,7 @@ onSchemaStatus(ev: { outdated: boolean; serverHash?: string; lastVerifiedAt?: st
 
 - O backend anota o schema com `x-ui.resource.idField` (e `idFieldValid`) via `/schemas/filtered`.
 - A tabela adota o campo identificador automaticamente com a seguinte precedência:
-  - `@Input() idField` → `crudContext.idField` → `config.meta.idField` (persistido) → `GenericCrudService.getResourceIdField()` (derivado do schema) → `'id'`.
+  - `config.meta.idField` (persistido) → contexto runtime/serviço derivado do schema → `'id'`.
   - Se `config.meta.idField` divergir do servidor, o componente alerta o usuário e mantém o valor do TableConfig até reconciliação.
 - A resolução ocorre no `loadSchema()` e também é considerada em tempo de execução para evitar corridas.
 - Para recursos cuja PK não é `id`, defina `getIdFieldName()` no controller backend correspondente.
@@ -961,7 +973,7 @@ sequenceDiagram
   Docs-->>GS: 200/304 schema + x-ui.resource.idField
   GS->>GS: cache + lastResourceMeta.idField
   GS-->>PT: FieldDefinition[] (normalizado)
-  Note over PT: idField = input || context || GS.getResourceIdField() || 'id'
+  Note over PT: idField = config.meta.idField || runtime/schema || 'id'
   PT->>PT: construir colunas e renderizar
 ```
 
@@ -986,7 +998,7 @@ sequenceDiagram
 ### Troubleshooting rápido (idField)
 
 - A ação delete falhou por ID ausente: verifique se o schema contém `x-ui.resource.idField` e se a coluna correspondente existe no dataset.
-- O ID está em outra propriedade: defina `@Input() idField` ou `crudContext.idField` temporariamente; ajuste o backend com `getIdFieldName()` para persistir o comportamento.
+- O ID está em outra propriedade: defina `config.meta.idField` no TableConfig; ajuste o backend com `getIdFieldName()` para persistir o comportamento derivado do schema.
 - Cache 304 sem idField aplicado: confirme que o serviço recebeu o body pelo menos uma vez (200) e que `GenericCrudService.getResourceIdField()` retorna o valor esperado.
 
 ### Uso com Dados Locais (Client-Side)

package/fesm2022/{praxisui-table-table-ai.adapter-DxjDaQqy.mjs → praxisui-table-table-ai.adapter-fS74fZ7o.mjs}

@@ -198,11 +198,12 @@ class TableAiAdapter extends BaseAiAdapter {
         const actions = config.actions || {};
         const availableFeatures = [];
         const missingCapabilities = [];
+        const effectiveIdField = this.normalizeString(this.table.getIdField?.());
         if (!this.table.resourcePath) {
             availableFeatures.push('data-connection');
         }
-        if (!this.table.idField) {
-            availableFeatures.push('bindings.idField');
+        if (!effectiveIdField) {
+            availableFeatures.push('meta.idField');
         }
         if (!behavior.filtering?.enabled) {
             availableFeatures.push('behavior.filtering');
@@ -264,14 +265,15 @@ class TableAiAdapter extends BaseAiAdapter {
             authoringContract: {
                 kind: 'praxis.table.editor',
                 usesBindings: true,
-                bindingsPaths: ['bindings.resourcePath', 'bindings.idField', 'bindings.horizontalScroll'],
+                bindingsPaths: ['bindings.resourcePath', 'bindings.horizontalScroll'],
+                configPaths: ['meta.idField'],
                 runtimeConfigProjection: 'TableConfig',
             },
             availableFeatures,
             missingCapabilities: Array.from(new Set(missingCapabilities)),
             inputs: {
                 resourcePath: this.table.resourcePath || null,
-                idField: this.table.getIdField?.() || null,
+                idField: effectiveIdField || null,
                 horizontalScroll: this.table.horizontalScroll || null,
             },
         };
@@ -303,6 +305,13 @@ class TableAiAdapter extends BaseAiAdapter {
         this.applyConfig(nextConfig);
         return { success: true };
     }
+    normalizeString(value) {
+        if (typeof value !== 'string') {
+            return null;
+        }
+        const normalized = value.trim();
+        return normalized ? normalized : null;
+    }
     // -------- Context & suggestions --------
     /**
      * Human-friendly summary for prompt/context (columns + feature flags + data stats).
@@ -564,7 +573,7 @@ Columns Analysis:
         const id = this.table.tableId || 'default';
         const rp = this.table.resourcePath || 'default';
         // bump version to invalidate old cached suggestions
-        return `ai-suggestions:v3:${id}:${rp}`;
+        return `ai-suggestions:v4:${id}:${rp}`;
     }
     getColumnNames() {
         return (this.table.config?.columns || [])