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

package/README.md

@@ -1,4 +1,4 @@
----
+---
 title: "Table"
 slug: "table-overview"
 description: "Visao geral do @praxisui/table com TableConfig unificada, filtros, renderers, performance e integracao enterprise."
@@ -256,6 +256,40 @@ O novo editor é "column-first" e usa uma tipagem compartilhada com o Editor d
 - Preview: execute “Testar” para ver quantas linhas seriam afetadas pelas regras ativas.
 - Import/Export: exporta JSON sem o campo `enabled`; importa com validação estrutural de JSON Logic e sanitização de estilos (allowlist).
 
+#### Estados de linha vs estilos de célula
+
+Use `rowConditionalStyles` quando a condição descreve o estado semântico da linha inteira, como prioridade, SLA vencido, item sem responsável, bloqueio ou estagnação. Para temas e faixas visuais, prefira `cssClass` em `rowConditionalStyles` e resolva a aparência no CSS do host. Isso preserva o ownership de tema do host e evita que gradientes ou backgrounds reiniciem em cada célula.
+
+Use `columns[].conditionalStyles` quando o destaque pertence a uma coluna específica, como texto negativo em vermelho, status em badge, valor monetário fora da faixa ou ícone contextual de uma célula.
+
+Padrão recomendado:
+
+```ts
+rowConditionalStyles: [
+  {
+    condition: { contains: [{ var: 'prioridadeNome' }, 'Alta'] },
+    cssClass: 'app-row--priority-high',
+    description: 'Prioridade alta recebe âncora visual de linha.',
+  },
+]
+```
+
+```scss
+.app-table .mat-mdc-row.app-row--priority-high {
+  background: linear-gradient(
+    90deg,
+    color-mix(in srgb, var(--md-sys-color-error-container) 42%, transparent),
+    transparent
+  );
+}
+
+.app-table .mat-mdc-row.app-row--priority-high .mat-mdc-cell {
+  background: transparent;
+}
+```
+
+Evite aplicar gradientes de estado de linha diretamente em `.mat-mdc-cell`. Como cada célula tem largura, sticky behavior e renderer próprios, o gradiente pode parecer quebrado por coluna, especialmente em tema dark.
+
 Exemplos de JSON Logic:
 
 ```json
@@ -428,14 +462,22 @@ Um botão de engrenagem será exibido no canto superior direito. Ao clicar n
 
 As alterações podem ser aplicadas temporariamente com **Aplicar** ou salvas de forma persistente com **Salvar & Fechar**.
 
+### Assistente de IA da Tabela
+
+Quando `enableCustomization` esta ativo, a tabela expoe o assistente de IA pelo shell canonico de `@praxisui/ai`.
+O chrome conversacional, `sessionId`, `clientTurnId`, respostas rapidas e ciclo de revisao/aplicacao sao orquestrados
+por `PraxisAssistantTurnOrchestratorService`; a semantica especifica da tabela continua em `TableAiAdapter` e no
+`TableAgenticAuthoringTurnFlow`.
+
 ## 🚀 Instalação
 
 ```bash
-npm install @praxisui/core @praxisui/table
+npm install @praxisui/ai @praxisui/core @praxisui/table
 ```
 
 Peers necessários (instale no app host):
 - `@angular/core` `^20.0.0`, `@angular/common` `^20.0.0`
+- `@praxisui/ai` `^8.0.0-beta.0`
 - `@praxisui/core` `^0.0.1`
 - `@praxisui/dynamic-fields` `^0.0.1` (quando usar editores/inputs dinâmicos)
 - `@praxisui/dynamic-form` `^0.0.1` (quando integrar com formulários dinâmicos)
@@ -1716,4 +1758,3 @@ Apache-2.0 — consulte `LICENSE` na raiz do workspace para detalhes.
 **Parte do Praxis UI Workspace**
 **Versão**: 2.0.0 (Unified Architecture)
 **Compatibilidade**: Angular 18+
-

package/fesm2022/{praxisui-table-filter-form-dialog-host.component-EHoM1uuJ.mjs → praxisui-table-filter-form-dialog-host.component-Dm2f0muy.mjs}

@@ -115,7 +115,7 @@ class FilterFormDialogHostComponent {
         {{ data.i18n?.apply || 'Aplicar' }}
       </button>
     </mat-dialog-actions>
-  `, isInline: true, styles: [".pfx-dialog-title{display:flex;align-items:center;justify-content:space-between;gap:12px;padding-right:8px}.pfx-dialog-title-text{display:inline-flex;align-items:center;gap:8px;font-weight:600;color:var(--md-sys-color-on-surface)}.pfx-dialog-close{margin-left:auto}.pfx-filter-dialog-content{display:flex;flex-direction:column;gap:12px;padding-top:8px}.pfx-empty-state{margin:8px 0 0;color:var(--md-sys-color-on-surface-variant)}.pfx-dialog-actions{padding:var(--pdx-dialog-actions-padding, 12px 24px 16px);border-top:1px solid var(--md-sys-color-outline-variant);background:transparent;display:flex;align-items:center;gap:8px}\n"], dependencies: [{ kind: "ngmodule", type: CommonModule }, { kind: "directive", type: i2.NgIf, selector: "[ngIf]", inputs: ["ngIf", "ngIfThen", "ngIfElse"] }, { kind: "ngmodule", type: MatDialogModule }, { kind: "directive", type: i1.MatDialogTitle, selector: "[mat-dialog-title], [matDialogTitle]", inputs: ["id"], exportAs: ["matDialogTitle"] }, { kind: "directive", type: i1.MatDialogActions, selector: "[mat-dialog-actions], mat-dialog-actions, [matDialogActions]", inputs: ["align"] }, { kind: "directive", type: i1.MatDialogContent, selector: "[mat-dialog-content], mat-dialog-content, [matDialogContent]" }, { kind: "ngmodule", type: MatButtonModule }, { kind: "component", type: i3.MatButton, selector: "    button[matButton], a[matButton], button[mat-button], button[mat-raised-button],    button[mat-flat-button], button[mat-stroked-button], a[mat-button], a[mat-raised-button],    a[mat-flat-button], a[mat-stroked-button]  ", inputs: ["matButton"], exportAs: ["matButton", "matAnchor"] }, { kind: "component", type: i3.MatIconButton, selector: "button[mat-icon-button], a[mat-icon-button], button[matIconButton], a[matIconButton]", exportAs: ["matButton", "matAnchor"] }, { kind: "ngmodule", type: MatProgressBarModule }, { kind: "component", type: i15.MatProgressBar, selector: "mat-progress-bar", inputs: ["color", "value", "bufferValue", "mode"], outputs: ["animationEnd"], exportAs: ["matProgressBar"] }, { kind: "ngmodule", type: MatIconModule }, { kind: "component", type: i5.MatIcon, selector: "mat-icon", inputs: ["color", "inline", "svgIcon", "fontSet", "fontIcon"], exportAs: ["matIcon"] }, { kind: "component", type: PraxisFilterForm, selector: "praxis-filter-form", inputs: ["config", "formId", "resourcePath", "mode"], outputs: ["formReady", "valueChange", "submit", "requestSearch", "validityChange"] }] });
+  `, isInline: true, styles: [".pfx-dialog-title{display:flex;align-items:center;justify-content:space-between;gap:12px;padding-right:8px}.pfx-dialog-title-text{display:inline-flex;align-items:center;gap:8px;font-weight:600;color:var(--mdc-dialog-subhead-color, var(--md-sys-color-on-surface))}.pfx-dialog-close{margin-left:auto}.pfx-filter-dialog-content{display:flex;flex-direction:column;gap:12px;padding-top:8px}.pfx-empty-state{margin:8px 0 0;color:var(--mdc-dialog-supporting-text-color, var(--md-sys-color-on-surface-variant))}.pfx-dialog-actions{padding:var(--pdx-dialog-actions-padding, 12px 24px 16px);border-top:1px solid var(--md-sys-color-outline-variant);background:transparent;display:flex;align-items:center;gap:8px}\n"], dependencies: [{ kind: "ngmodule", type: CommonModule }, { kind: "directive", type: i2.NgIf, selector: "[ngIf]", inputs: ["ngIf", "ngIfThen", "ngIfElse"] }, { kind: "ngmodule", type: MatDialogModule }, { kind: "directive", type: i1.MatDialogTitle, selector: "[mat-dialog-title], [matDialogTitle]", inputs: ["id"], exportAs: ["matDialogTitle"] }, { kind: "directive", type: i1.MatDialogActions, selector: "[mat-dialog-actions], mat-dialog-actions, [matDialogActions]", inputs: ["align"] }, { kind: "directive", type: i1.MatDialogContent, selector: "[mat-dialog-content], mat-dialog-content, [matDialogContent]" }, { kind: "ngmodule", type: MatButtonModule }, { kind: "component", type: i3.MatButton, selector: "    button[matButton], a[matButton], button[mat-button], button[mat-raised-button],    button[mat-flat-button], button[mat-stroked-button], a[mat-button], a[mat-raised-button],    a[mat-flat-button], a[mat-stroked-button]  ", inputs: ["matButton"], exportAs: ["matButton", "matAnchor"] }, { kind: "component", type: i3.MatIconButton, selector: "button[mat-icon-button], a[mat-icon-button], button[matIconButton], a[matIconButton]", exportAs: ["matButton", "matAnchor"] }, { kind: "ngmodule", type: MatProgressBarModule }, { kind: "component", type: i15.MatProgressBar, selector: "mat-progress-bar", inputs: ["color", "value", "bufferValue", "mode"], outputs: ["animationEnd"], exportAs: ["matProgressBar"] }, { kind: "ngmodule", type: MatIconModule }, { kind: "component", type: i5.MatIcon, selector: "mat-icon", inputs: ["color", "inline", "svgIcon", "fontSet", "fontIcon"], exportAs: ["matIcon"] }, { kind: "component", type: PraxisFilterForm, selector: "praxis-filter-form", inputs: ["config", "formId", "resourcePath", "mode"], outputs: ["formReady", "valueChange", "submit", "requestSearch", "validityChange"] }] });
 }
 i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.3.17", ngImport: i0, type: FilterFormDialogHostComponent, decorators: [{
             type: Component,
@@ -156,7 +156,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.3.17", ngImpo
         {{ data.i18n?.apply || 'Aplicar' }}
       </button>
     </mat-dialog-actions>
-  `, styles: [".pfx-dialog-title{display:flex;align-items:center;justify-content:space-between;gap:12px;padding-right:8px}.pfx-dialog-title-text{display:inline-flex;align-items:center;gap:8px;font-weight:600;color:var(--md-sys-color-on-surface)}.pfx-dialog-close{margin-left:auto}.pfx-filter-dialog-content{display:flex;flex-direction:column;gap:12px;padding-top:8px}.pfx-empty-state{margin:8px 0 0;color:var(--md-sys-color-on-surface-variant)}.pfx-dialog-actions{padding:var(--pdx-dialog-actions-padding, 12px 24px 16px);border-top:1px solid var(--md-sys-color-outline-variant);background:transparent;display:flex;align-items:center;gap:8px}\n"] }]
+  `, styles: [".pfx-dialog-title{display:flex;align-items:center;justify-content:space-between;gap:12px;padding-right:8px}.pfx-dialog-title-text{display:inline-flex;align-items:center;gap:8px;font-weight:600;color:var(--mdc-dialog-subhead-color, var(--md-sys-color-on-surface))}.pfx-dialog-close{margin-left:auto}.pfx-filter-dialog-content{display:flex;flex-direction:column;gap:12px;padding-top:8px}.pfx-empty-state{margin:8px 0 0;color:var(--mdc-dialog-supporting-text-color, var(--md-sys-color-on-surface-variant))}.pfx-dialog-actions{padding:var(--pdx-dialog-actions-padding, 12px 24px 16px);border-top:1px solid var(--md-sys-color-outline-variant);background:transparent;display:flex;align-items:center;gap:8px}\n"] }]
         }], ctorParameters: () => [{ type: undefined, decorators: [{
                     type: Inject,
                     args: [MAT_DIALOG_DATA]

package/fesm2022/praxisui-table-table-agentic-authoring-turn-flow-tu7jtTwV.mjs

@@ -0,0 +1,280 @@
+import { firstValueFrom } from 'rxjs';
+
+class TableAgenticAuthoringTurnFlow {
+    adapter;
+    aiApi;
+    mode = 'config';
+    constructor(adapter, aiApi) {
+        this.adapter = adapter;
+        this.aiApi = aiApi;
+    }
+    async submit(request) {
+        const prompt = (request.prompt ?? '').trim();
+        if (!prompt) {
+            return {
+                state: 'listening',
+                phase: 'capture',
+                statusText: '',
+            };
+        }
+        const componentId = this.adapter.componentId || request.componentId || 'praxis-table';
+        const componentType = this.adapter.componentType || request.componentType || 'table';
+        const currentState = this.toAiJsonObject(this.adapter.getCurrentConfig());
+        const dataProfile = this.optionalJsonObject(this.adapter.getDataProfile?.());
+        const runtimeState = this.optionalJsonObject(this.adapter.getRuntimeState?.());
+        const schemaFields = this.adapter.getSchemaFields?.()
+            ?.map((field) => this.toAiJsonObject(field))
+            .filter((field) => Object.keys(field).length > 0);
+        const contextHints = this.optionalJsonObject(this.adapter.getAuthoringContext?.());
+        const response = await firstValueFrom(this.aiApi.getPatch({
+            componentId,
+            componentType,
+            userPrompt: prompt,
+            sessionId: request.sessionId,
+            clientTurnId: request.clientTurnId,
+            messages: this.toChatMessages(request.messages, prompt),
+            currentState,
+            currentStateDigest: this.buildCurrentStateDigest(currentState, dataProfile),
+            uiContextRef: {
+                componentId,
+                componentType,
+            },
+            ...(dataProfile ? { dataProfile } : {}),
+            ...(runtimeState ? { runtimeState } : {}),
+            ...(schemaFields?.length ? { schemaFields } : {}),
+            ...(contextHints ? { contextHints } : {}),
+        }));
+        return this.toTurnResult(this.compileAdapterResponse(response), request);
+    }
+    async apply(request) {
+        const patch = this.toRecord(request.pendingPatch);
+        if (!patch) {
+            return {
+                state: 'error',
+                phase: 'apply',
+                assistantMessage: 'Nao ha alteracao de tabela pronta para aplicar.',
+                errorText: 'Nao ha alteracao de tabela pronta para aplicar.',
+                canApply: false,
+            };
+        }
+        const result = await this.adapter.applyPatch(patch, request.prompt);
+        if (!result.success) {
+            return {
+                state: 'error',
+                phase: 'apply',
+                assistantMessage: result.error || 'Nao foi possivel aplicar as alteracoes na tabela.',
+                errorText: result.error || 'Nao foi possivel aplicar as alteracoes na tabela.',
+                canApply: true,
+                pendingPatch: patch,
+            };
+        }
+        return {
+            state: 'success',
+            phase: 'summarize',
+            assistantMessage: 'Alteracoes aplicadas na tabela.',
+            statusText: 'Alteracoes aplicadas na tabela.',
+            canApply: false,
+            pendingPatch: null,
+            diagnostics: result.warnings?.length ? { warnings: result.warnings } : undefined,
+        };
+    }
+    cancel() {
+        return Promise.resolve({
+            state: 'listening',
+            phase: 'capture',
+            assistantMessage: 'Solicitacao cancelada.',
+            statusText: '',
+            canApply: false,
+            pendingPatch: null,
+            pendingClarification: null,
+        });
+    }
+    retry(request) {
+        const lastPrompt = [...(request.messages ?? [])].reverse()
+            .find((message) => message.role === 'user')?.text;
+        return this.submit({
+            ...request,
+            prompt: lastPrompt ?? request.prompt,
+            action: { kind: 'retry' },
+        });
+    }
+    toTurnResult(response, request) {
+        if (!response) {
+            return {
+                state: 'error',
+                phase: 'capture',
+                assistantMessage: 'Resposta vazia da IA.',
+                errorText: 'Resposta vazia da IA.',
+            };
+        }
+        if (response.sessionId && response.sessionId !== request.sessionId) {
+            request = { ...request, sessionId: response.sessionId };
+        }
+        if (response.type === 'clarification') {
+            const questions = this.toClarificationQuestions(response);
+            return {
+                state: 'clarification',
+                phase: 'clarify',
+                sessionId: response.sessionId ?? request.sessionId,
+                assistantMessage: response.message || 'Preciso de mais detalhes para continuar.',
+                clarificationQuestions: questions,
+                quickReplies: this.toQuickReplies(response),
+                canApply: false,
+            };
+        }
+        if (response.type === 'info') {
+            const message = response.message || response.explanation || 'Informacao gerada.';
+            return {
+                state: 'success',
+                phase: 'summarize',
+                sessionId: response.sessionId ?? request.sessionId,
+                assistantMessage: message,
+                statusText: message,
+                canApply: false,
+            };
+        }
+        if (response.type === 'error') {
+            const message = response.message || 'Falha ao gerar alteracao de tabela.';
+            return {
+                state: 'error',
+                phase: 'capture',
+                sessionId: response.sessionId ?? request.sessionId,
+                assistantMessage: message,
+                errorText: message,
+                diagnostics: response.warnings?.length ? { warnings: response.warnings } : undefined,
+            };
+        }
+        if (response.patch && Object.keys(response.patch).length > 0) {
+            const warnings = response.warnings?.filter(Boolean) ?? [];
+            const suffix = warnings.length ? ` Avisos: ${warnings.join('; ')}` : '';
+            return {
+                state: 'review',
+                phase: 'review',
+                sessionId: response.sessionId ?? request.sessionId,
+                assistantMessage: `${response.explanation || 'Proposta de alteracao pronta para revisar.'}${suffix}`,
+                statusText: 'Revise a proposta antes de aplicar.',
+                canApply: true,
+                pendingPatch: response.patch,
+                preview: {
+                    kind: 'table-config-patch',
+                    diff: response.diff ?? [],
+                },
+                diagnostics: warnings.length ? { warnings } : undefined,
+            };
+        }
+        return {
+            state: 'success',
+            phase: 'summarize',
+            sessionId: response.sessionId ?? request.sessionId,
+            assistantMessage: response.message || response.explanation || 'Nenhuma alteracao necessaria.',
+            statusText: response.message || response.explanation || 'Nenhuma alteracao necessaria.',
+            canApply: false,
+        };
+    }
+    compileAdapterResponse(response) {
+        const compiled = this.adapter.compileAiResponse?.(response);
+        if (!compiled) {
+            return response;
+        }
+        const warnings = [
+            ...(response.warnings ?? []),
+            ...(compiled.warnings ?? []),
+        ];
+        return {
+            ...response,
+            ...compiled,
+            warnings: warnings.length ? warnings : undefined,
+        };
+    }
+    toChatMessages(messages, prompt) {
+        const supported = (messages ?? [])
+            .filter((message) => message.role === 'user' || message.role === 'assistant' || message.role === 'system')
+            .map((message) => ({
+            role: message.role,
+            content: message.text,
+        }))
+            .filter((message) => message.content.trim().length > 0);
+        return supported.length ? supported : [{ role: 'user', content: prompt }];
+    }
+    toClarificationQuestions(response) {
+        const labels = response.questions?.length
+            ? response.questions
+            : response.message
+                ? [response.message]
+                : ['Qual ajuste voce quer aplicar na tabela?'];
+        const options = this.toQuickReplies(response).map((reply) => ({
+            id: reply.id,
+            label: reply.label,
+            value: reply.prompt,
+        }));
+        return labels.map((label, index) => ({
+            id: `table-clarification-${index + 1}`,
+            type: options.length ? 'single-choice' : 'text',
+            label,
+            allowCustom: true,
+            options,
+        }));
+    }
+    toQuickReplies(response) {
+        const payloads = response.optionPayloads ?? [];
+        if (payloads.length) {
+            return payloads
+                .map((option, index) => {
+                const label = option.label?.trim() || option.value?.trim() || `Opcao ${index + 1}`;
+                const prompt = option.example?.trim() || option.value?.trim() || label;
+                return {
+                    id: `option-${index + 1}`,
+                    label,
+                    prompt,
+                    kind: 'clarification-option',
+                };
+            });
+        }
+        return (response.options ?? [])
+            .filter((option) => !!option?.trim())
+            .map((option, index) => ({
+            id: `option-${index + 1}`,
+            label: option.trim(),
+            prompt: option.trim(),
+            kind: 'clarification-option',
+        }));
+    }
+    buildCurrentStateDigest(currentState, dataProfile) {
+        const columns = Array.isArray(currentState['columns'])
+            ? currentState['columns']
+                .map((column) => this.toRecord(column)?.['field'])
+                .filter((field) => typeof field === 'string' && field.length > 0)
+            : undefined;
+        const rowCount = typeof dataProfile?.['rowCount'] === 'number' ? dataProfile['rowCount'] : undefined;
+        return {
+            ...(columns?.length ? { columns } : {}),
+            ...(rowCount !== undefined ? { rowCount } : {}),
+        };
+    }
+    optionalJsonObject(value) {
+        if (value === undefined || value === null) {
+            return undefined;
+        }
+        const object = this.toAiJsonObject(value);
+        return Object.keys(object).length ? object : undefined;
+    }
+    toAiJsonObject(value) {
+        const record = this.toRecord(value);
+        if (!record) {
+            return {};
+        }
+        try {
+            return JSON.parse(JSON.stringify(record));
+        }
+        catch {
+            return {};
+        }
+    }
+    toRecord(value) {
+        return value && typeof value === 'object' && !Array.isArray(value)
+            ? value
+            : null;
+    }
+}
+
+export { TableAgenticAuthoringTurnFlow };

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

@@ -1,7 +1,7 @@
 import { firstValueFrom } from 'rxjs';
 import { BaseAiAdapter } from '@praxisui/ai';
 import { deepMerge } from '@praxisui/core';
-import { TABLE_AI_CAPABILITIES, TASK_PRESETS } from './praxisui-table.mjs';
+import { coerceTableComponentEditPlans, compileTableComponentEditPlans, TABLE_AI_CAPABILITIES, TASK_PRESETS, getTableComponentEditPlanCapabilities, TABLE_COMPONENT_EDIT_PLAN_EXPECTED_PATHS, TABLE_COMPONENT_EDIT_PLAN_ALLOWED_CHANGE_KINDS, TABLE_COMPONENT_EDIT_PLAN_JSON_SCHEMA, TABLE_COMPONENT_EDIT_PLAN_VERSION, TABLE_COMPONENT_EDIT_PLAN_BATCH_KIND, TABLE_COMPONENT_EDIT_PLAN_KIND } from './praxisui-table.mjs';
 
 /**
  * Analisa uma amostra de dados da tabela para gerar estatísticas
@@ -123,6 +123,25 @@ class TableAiAdapter extends BaseAiAdapter {
         this.aiService = aiService;
     }
     // -------- Core contract --------
+    compileAiResponse(response) {
+        const componentEditPlans = coerceTableComponentEditPlans(response);
+        if (!componentEditPlans) {
+            return null;
+        }
+        const compiled = compileTableComponentEditPlans(componentEditPlans, this.getCurrentConfig());
+        if (compiled.patch) {
+            return {
+                patch: this.normalizePatch(compiled.patch),
+                explanation: typeof response['explanation'] === 'string' ? response['explanation'] : compiled.explanation,
+                warnings: compiled.warnings,
+            };
+        }
+        return {
+            type: 'error',
+            message: 'O plano de edicao da tabela nao passou na validacao de capacidades.',
+            warnings: [...compiled.warnings, ...compiled.failureCodes],
+        };
+    }
     getCurrentConfig() {
         try {
             return structuredClone(this.table.config);
@@ -148,6 +167,31 @@ class TableAiAdapter extends BaseAiAdapter {
             isLoading: false // TODO: expose real loading flag
         };
     }
+    getAuthoringContext() {
+        return {
+            authoringContract: {
+                kind: 'praxis.component-authoring-context',
+                componentId: this.componentId,
+                componentType: this.componentType,
+                preferredResponse: 'componentEditPlan',
+                componentEditPlan: {
+                    kind: TABLE_COMPONENT_EDIT_PLAN_KIND,
+                    batchKind: TABLE_COMPONENT_EDIT_PLAN_BATCH_KIND,
+                    version: TABLE_COMPONENT_EDIT_PLAN_VERSION,
+                    schemaId: TABLE_COMPONENT_EDIT_PLAN_JSON_SCHEMA.$id,
+                    allowedChangeKinds: [...TABLE_COMPONENT_EDIT_PLAN_ALLOWED_CHANGE_KINDS],
+                    expectedPaths: { ...TABLE_COMPONENT_EDIT_PLAN_EXPECTED_PATHS },
+                    capabilities: getTableComponentEditPlanCapabilities(),
+                    rules: [
+                        'Use componentEditPlan instead of free patch when the request fits an allowed table edit changeKind.',
+                        'Use batch kind with operations for multiple table edits in one request.',
+                        'Use Json Logic objects for computed expressions and conditional rules.',
+                        'Do not invent fields, changeKinds, capabilityPaths, formats, badge variants, or colors outside the provided contract.',
+                    ],
+                },
+            },
+        };
+    }
     getSuggestionContext() {
         const config = this.getCurrentConfig();
         const behavior = config.behavior || {};
@@ -500,8 +544,9 @@ Columns Analysis:
     // -------- Two-step flow helpers --------
     getFilteredCapabilities(category) {
         const all = TABLE_AI_CAPABILITIES.capabilities;
+        const editPlanCaps = getTableComponentEditPlanCapabilities();
         if (!category || category === 'unknown')
-            return all;
+            return [...all, ...editPlanCaps];
         const categoryMap = {
             columns: ['columns', 'format', 'mapping', 'renderer', 'conditional'],
             appearance: ['appearance', 'conditional'],
@@ -510,7 +555,10 @@ Columns Analysis:
             actions: ['actions', 'toolbar', 'export']
         };
         const targets = categoryMap[category] || [category];
-        return all.filter((c) => targets.includes(c.category));
+        return [
+            ...all.filter((c) => targets.includes(c.category)),
+            ...editPlanCaps.filter((c) => targets.includes(c.category)),
+        ];
     }
     suggestionsKey() {
         const id = this.table.tableId || 'default';
@@ -568,6 +616,22 @@ Columns Analysis:
         const context = this.extractContextForIntent(classification);
         const caps = this.getFilteredCapabilities(classification?.category);
         const result = await firstValueFrom(aiService.executeEnrichedPrompt(userInput, context.desc, context.config, caps));
+        const componentEditPlans = coerceTableComponentEditPlans(result);
+        if (componentEditPlans) {
+            const compiled = compileTableComponentEditPlans(componentEditPlans, this.getCurrentConfig());
+            if (compiled.patch) {
+                return {
+                    patch: this.normalizePatch(compiled.patch),
+                    explanation: result.explanation || compiled.explanation,
+                    warnings: compiled.warnings,
+                };
+            }
+            return {
+                type: 'error',
+                message: 'O plano de edicao da tabela nao passou na validacao de capacidades.',
+                warnings: [...compiled.warnings, ...compiled.failureCodes],
+            };
+        }
         if (!result || !result.patch) {
             return { type: 'error', message: 'Nenhum patch gerado.' };
         }