@praxisui/table 8.0.0-beta.94 → 8.0.0-beta.96

package/fesm2022/{praxisui-table-praxisui-table-DXpnCND9.mjs → praxisui-table-praxisui-table-BKb6n5uc.mjs}

@@ -126,8 +126,8 @@ const PRAXIS_TABLE_RUNTIME_I18N_CONFIG = {
                 'table.assistant.recommendation.globalNavigation.description': 'Conecta a tabela a rotas ou páginas publicadas pelo host.',
                 'table.assistant.recommendation.globalNavigation.prompt': 'Mostre quais ações globais de navegação podem ser adicionadas nesta tabela.',
                 'table.assistant.recommendation.selection.label': 'Analisar selecionados',
-                'table.assistant.recommendation.selection.description': 'Compara os registros marcados e sugere filtros, ranges ou ações compatíveis.',
-                'table.assistant.recommendation.selection.prompt': 'Analise os registros selecionados e sugira as próximas ações úteis para esta tabela.',
+                'table.assistant.recommendation.selection.description': 'Resume semelhanças, diferenças e próximos caminhos sem alterar a tabela automaticamente.',
+                'table.assistant.recommendation.selection.prompt': 'Analise os registros selecionados e responda em linguagem natural: o que eles têm em comum, quais diferenças importam e quais próximos caminhos seriam úteis. Não aplique alterações sem um pedido explícito.',
                 'table.assistant.recommendation.capabilityDiscovery.label': 'Ver recursos recomendados',
                 'table.assistant.recommendation.capabilityDiscovery.description': 'Analisa configuração, colunas e dados para sugerir os próximos ajustes úteis.',
                 'table.assistant.recommendation.capabilityDiscovery.prompt': 'Analise esta tabela, suas configurações atuais, colunas e dados disponíveis, e recomende os recursos mais úteis para aplicar agora.',
@@ -39947,7 +39947,7 @@ class PraxisTable {
         if (this.aiAdapter || this.aiAdapterLoadStarted)
             return;
         this.aiAdapterLoadStarted = true;
-        import('./praxisui-table-table-ai.adapter-BWnL5QfP.mjs')
+        import('./praxisui-table-table-ai.adapter-DR0VP12I.mjs')
             .then(({ TableAiAdapter }) => {
             this.aiAdapter = new TableAiAdapter(this);
             this.initializeAiAssistantController();
@@ -40256,7 +40256,7 @@ class PraxisTable {
             intents.push({
                 id: 'table-analyze-selection',
                 label: t('table.assistant.recommendation.selection.label', 'Analisar selecionados'),
-                description: t('table.assistant.recommendation.selection.description', 'Compara os registros marcados e sugere filtros, ranges ou ações compatíveis.'),
+                description: t('table.assistant.recommendation.selection.description', 'Resume semelhanças, diferenças e próximos caminhos sem alterar a tabela automaticamente.'),
                 group: {
                     id: 'table-selection',
                     label: t('table.assistant.recommendation.group.selection', 'Seleção'),
@@ -40265,10 +40265,15 @@ class PraxisTable {
                 tone: 'success',
                 action: {
                     kind: 'submit-prompt',
-                    prompt: t('table.assistant.recommendation.selection.prompt', 'Analise os registros selecionados e sugira as próximas ações úteis para esta tabela.'),
+                    prompt: t('table.assistant.recommendation.selection.prompt', 'Analise os registros selecionados e responda em linguagem natural: o que eles têm em comum, quais diferenças importam e quais próximos caminhos seriam úteis. Não aplique alterações sem um pedido explícito.'),
                     contextHints: {
                         source: 'table-opportunity-catalog',
                         opportunityId: 'table.selection.analyze',
+                        authoringMode: 'table.selection.readonly-analysis',
+                        responseContract: {
+                            preferredResponse: 'info',
+                            mutatesTable: false,
+                        },
                         target: { kind: 'component', id: tableContext.tableId },
                         componentState: tableContext,
                         selectedRecordsContext: this.getAiAssistantSelectedRowsContext(),
@@ -40561,7 +40566,7 @@ class PraxisTable {
     initializeAiAssistantController() {
         if (!this.aiAdapter || this.aiAssistantController)
             return;
-        import('./praxisui-table-table-agentic-authoring-turn-flow-DUu4AIDF.mjs')
+        import('./praxisui-table-table-agentic-authoring-turn-flow-DSn29-0N.mjs')
             .then(({ TableAgenticAuthoringTurnFlow }) => {
             if (this.aiAssistantController || !this.aiAdapter)
                 return;

package/fesm2022/{praxisui-table-table-agentic-authoring-turn-flow-DUu4AIDF.mjs → praxisui-table-table-agentic-authoring-turn-flow-DSn29-0N.mjs}

@@ -393,6 +393,17 @@ class TableAgenticAuthoringTurnFlow {
                 message: 'Selecione um ou mais registros para eu sugerir filtros, exportações ou ações compatíveis com essa seleção.',
             };
         }
+        if (this.selectedRecordReadOnlyAnalysisRequested(request)) {
+            return {
+                type: 'info',
+                sessionId: request.sessionId,
+                message: this.selectedRecordsAnalyticalSummary(contextHints),
+                warnings: [
+                    'recommended-intent-local-selected-records-analysis',
+                    'Resposta informativa gerada a partir do recommendedIntent canonico table.selection.analyze e selectedRecordsContext.sampleRows; nao houve roteamento textual primario.',
+                ],
+            };
+        }
         const candidates = this.selectedRecordFilterCandidates(contextHints);
         const fields = candidates
             .map((candidate) => this.stringValue(candidate['field']))
@@ -480,6 +491,8 @@ class TableAgenticAuthoringTurnFlow {
             return null;
         if (!this.runtimeOperationAllowed(contextHints, 'table.filter.apply'))
             return null;
+        if (this.selectedRecordReadOnlyAnalysisRequested(request))
+            return null;
         const normalizedPrompt = this.normalizeLabel(request.prompt ?? '');
         if (!normalizedPrompt || !this.promptRequestsRuntimeFilter(normalizedPrompt))
             return null;
@@ -1525,9 +1538,18 @@ class TableAgenticAuthoringTurnFlow {
             'render',
             'oculta',
             'ocultar',
+            'oculte',
             'esconde',
             'exibe',
             'mostra coluna',
+            'nova coluna',
+            'coluna calculada',
+            'junta',
+            'junte',
+            'juntar',
+            'unir',
+            'combinar',
+            'mesclar',
             'adiciona botao',
             'botao',
         ].some((token) => normalizedPrompt.includes(this.normalizeLabel(token)));
@@ -2227,7 +2249,9 @@ class TableAgenticAuthoringTurnFlow {
                 observationId: response.observationId ?? request.observationId ?? null,
                 assistantMessage: message,
                 statusText: message,
-                quickReplies: this.toQuickReplies(response, request),
+                quickReplies: this.shouldSuppressInfoQuickReplies(response, request)
+                    ? []
+                    : this.toQuickReplies(response, request),
                 canApply: false,
             };
         }
@@ -2282,6 +2306,11 @@ class TableAgenticAuthoringTurnFlow {
         const record = this.toRecord(patch);
         return !!record && Object.keys(record).length > 0;
     }
+    shouldSuppressInfoQuickReplies(response, request) {
+        return this.selectedRecordReadOnlyAnalysisRequested(request)
+            || (response.warnings ?? []).some((warning) => this.normalizeLabel(warning).includes('selected records analysis')
+                || this.normalizeLabel(warning).includes('selected record readonly'));
+    }
     isTurnInProgressResponse(response) {
         return this.normalizeLabel(response.code ?? '') === 'turn in progress';
     }
@@ -2334,6 +2363,10 @@ class TableAgenticAuthoringTurnFlow {
                 if (openOnlySurfaceRuntimeOperation) {
                     return openOnlySurfaceRuntimeOperation;
                 }
+                const selectedRecordReadonlyBoundary = this.selectedRecordReadonlyBoundaryResponse(executableResponse, request);
+                if (selectedRecordReadonlyBoundary) {
+                    return selectedRecordReadonlyBoundary;
+                }
                 return executableResponse;
             }
             if (compiledExecutable?.type === 'error') {
@@ -2527,6 +2560,10 @@ class TableAgenticAuthoringTurnFlow {
             patch: normalizedCompiled.patch,
             warnings: warnings.length ? warnings : undefined,
         };
+        const selectedRecordReadonlyBoundary = this.selectedRecordReadonlyBoundaryResponse(compiledResponse, request);
+        if (selectedRecordReadonlyBoundary) {
+            return selectedRecordReadonlyBoundary;
+        }
         const columnVisibilitySurfaceMismatch = this.columnVisibilityPlanForMisroutedSurfaceRuntime(compiledResponse, request);
         if (columnVisibilitySurfaceMismatch) {
             return this.compileAdapterResponse(columnVisibilitySurfaceMismatch, request);
@@ -3810,10 +3847,7 @@ class TableAgenticAuthoringTurnFlow {
             .find((candidate) => this.stringValue(candidate['field']) === normalizedField) ?? null;
     }
     selectedRecordFilterCandidates(contextHints) {
-        const authoringContract = this.toRecord(contextHints?.['authoringContract']);
-        const consultativeContext = this.toRecord(authoringContract?.['consultativeContext']);
-        const selectedRecordsContext = this.toRecord(consultativeContext?.['selectedRecordsContext'])
-            ?? this.toRecord(contextHints?.['selectedRecordsContext']);
+        const selectedRecordsContext = this.selectedRecordsContextRecord(contextHints);
         const candidates = Array.isArray(selectedRecordsContext?.['filterCandidates'])
             ? selectedRecordsContext['filterCandidates']
             : [];
@@ -3822,10 +3856,7 @@ class TableAgenticAuthoringTurnFlow {
             .filter((candidate) => !!candidate);
     }
     selectedRecordSampleRows(contextHints) {
-        const authoringContract = this.toRecord(contextHints?.['authoringContract']);
-        const consultativeContext = this.toRecord(authoringContract?.['consultativeContext']);
-        const selectedRecordsContext = this.toRecord(consultativeContext?.['selectedRecordsContext'])
-            ?? this.toRecord(contextHints?.['selectedRecordsContext']);
+        const selectedRecordsContext = this.selectedRecordsContextRecord(contextHints);
         const sampleRows = Array.isArray(selectedRecordsContext?.['sampleRows'])
             ? selectedRecordsContext['sampleRows']
             : [];
@@ -3833,6 +3864,12 @@ class TableAgenticAuthoringTurnFlow {
             .map((row) => this.toRecord(row))
             .filter((row) => !!row);
     }
+    selectedRecordsContextRecord(contextHints) {
+        const authoringContract = this.toRecord(contextHints?.['authoringContract']);
+        const consultativeContext = this.toRecord(authoringContract?.['consultativeContext']);
+        return this.toRecord(consultativeContext?.['selectedRecordsContext'])
+            ?? this.toRecord(contextHints?.['selectedRecordsContext']);
+    }
     selectedRecordFilterClarificationOptionPayload(entry, contextHints) {
         const description = this.selectedRecordFilterCandidateDescription(entry.name, contextHints);
         return {
@@ -6212,6 +6249,300 @@ class TableAgenticAuthoringTurnFlow {
             .map((operation) => this.toRecord(operation))
             .filter((operation) => !!operation && this.stringValue(operation['operationId']) === 'table.filter.apply');
     }
+    selectedRecordReadonlyBoundaryResponse(response, request) {
+        if (!this.selectedRecordReadOnlyAnalysisRequested(request))
+            return null;
+        if (!response.patch || this.tableFilterApplyOperations(response.patch).length === 0)
+            return null;
+        if (this.responseDeclaresTableMutation(response))
+            return null;
+        const contextHints = this.contextHintsFor(request);
+        return {
+            type: 'info',
+            sessionId: response.sessionId ?? request?.sessionId,
+            message: this.selectedRecordsAnalyticalSummary(contextHints),
+            warnings: [
+                ...(response.warnings ?? []),
+                'selected-record-readonly-analysis-filter-materialization-blocked',
+                'A plataforma bloqueou table.filter.apply porque o turno tinha selectedRecordsContext consultivo e a resposta nao declarou uma decisao semantica mutante explicita.',
+            ],
+        };
+    }
+    selectedRecordReadOnlyAnalysisRequested(request) {
+        const contextHints = this.contextHintsFor(request);
+        const selectedCount = this.extractSelectedRecordsCount(contextHints);
+        const hasSelectedRows = selectedCount > 0 || this.selectedRecordSampleRows(contextHints).length > 0;
+        if (!hasSelectedRows)
+            return false;
+        if (this.toRecord(contextHints?.['selectedRecordsFilter'])
+            || this.toRecord(request?.action?.contextHints?.['selectedRecordsFilter'])
+            || this.toRecord(contextHints?.['tableRuntimeOperation'])
+            || this.toRecord(request?.action?.contextHints?.['tableRuntimeOperation'])) {
+            return false;
+        }
+        const normalizedPrompt = this.normalizeLabel(request?.prompt ?? '');
+        if (this.promptExplicitlyForbidsTableMutation(normalizedPrompt))
+            return true;
+        if (this.promptRequestsSelectedRecordDerivedOperation(normalizedPrompt))
+            return false;
+        const responseContract = this.toRecord(contextHints?.['responseContract'])
+            ?? this.toRecord(request?.action?.contextHints?.['responseContract']);
+        if (responseContract) {
+            const preferredResponse = this.normalizeLabel(this.stringValue(responseContract['preferredResponse']));
+            const mutatesTable = responseContract['mutatesTable'];
+            if (preferredResponse === 'info' || mutatesTable === false)
+                return true;
+            if (mutatesTable === true)
+                return false;
+        }
+        const authoringMode = this.normalizeLabel(this.stringValue(contextHints?.['authoringMode']).replace(/[._-]+/gu, ' '));
+        if (authoringMode === 'table selection readonly analysis')
+            return true;
+        return this.selectedRecordPromptLooksConsultative(normalizedPrompt);
+    }
+    selectedRecordPromptLooksConsultative(normalizedPrompt) {
+        if (!normalizedPrompt)
+            return false;
+        if (this.promptRequestsRuntimeFilter(normalizedPrompt)
+            || this.promptRequestsVisualOrStructuralEdit(normalizedPrompt)
+            || this.promptRequestsExportOperation(normalizedPrompt)) {
+            return this.promptExplicitlyForbidsTableMutation(normalizedPrompt);
+        }
+        if (this.promptExplicitlyForbidsTableMutation(normalizedPrompt))
+            return true;
+        // This is a defensive read-only boundary after selectedRecordsContext is already in scope.
+        // It does not choose a table operation; it only avoids materializing one when the turn is a question.
+        const questionSignals = [
+            'qual',
+            'quais',
+            'o que',
+            'quem',
+            'quanto',
+            'quantos',
+            'compare',
+            'comparar',
+            'resuma',
+            'resumir',
+            'analise',
+            'analisar',
+            'explique',
+            'explicar',
+            'tem algum',
+            'existe algum',
+            'faixa salarial',
+            'ganha mais',
+            'ganha menos',
+            'em comum',
+            'padrao',
+            'padrão',
+        ].map((value) => this.normalizeLabel(value));
+        return normalizedPrompt.includes('?')
+            || questionSignals.some((signal) => this.normalizedTextHasStandaloneToken(normalizedPrompt, signal)
+                || this.normalizedTextContainsApproxPhrase(normalizedPrompt, signal));
+    }
+    promptRequestsSelectedRecordDerivedOperation(normalizedPrompt) {
+        if (!normalizedPrompt)
+            return false;
+        if (this.promptExplicitlyForbidsTableMutation(normalizedPrompt))
+            return false;
+        if (this.promptRequestsExportOperation(normalizedPrompt) || this.promptRequestsVisualOrStructuralEdit(normalizedPrompt)) {
+            return true;
+        }
+        // This ranks explicit selected-record operation wording after selectedRecordsContext is already available.
+        // The primary intent still comes from the semantic turn/contract; these phrases only prevent a read-only
+        // safety boundary from cancelling an operation the user explicitly asked to materialize.
+        return [
+            'filtrar',
+            'filtra',
+            'filtro',
+            'filtre',
+            'buscar registros',
+            'procurar registros',
+            'outros registros',
+            'registro parecido',
+            'registros parecidos',
+            'parecidos',
+            'semelhantes',
+            'mesmo cargo',
+            'mesmos cargos',
+            'mesmo departamento',
+            'mesmos departamentos',
+            'mesmos valores',
+            'gente com os mesmos',
+            'pessoas com os mesmos',
+            'funcionarios com os mesmos',
+            'funcionários com os mesmos',
+            'quero outros',
+            'quero os mesmo',
+            'quero os mesmos',
+            'quero ver gente',
+        ].some((signal) => this.normalizedTextContainsApproxPhrase(normalizedPrompt, signal));
+    }
+    promptExplicitlyForbidsTableMutation(normalizedPrompt) {
+        if (!normalizedPrompt)
+            return false;
+        return [
+            'sem alterar',
+            'nao altere',
+            'não altere',
+            'nao aplique',
+            'não aplique',
+            'so explique',
+            'só explique',
+            'apenas explique',
+            'sem aplicar filtro',
+            'nao filtrar',
+            'não filtrar',
+        ].some((signal) => this.normalizedTextContainsApproxPhrase(normalizedPrompt, signal));
+    }
+    responseDeclaresTableMutation(response) {
+        const responseRecord = response;
+        const semanticDecision = this.toRecord(responseRecord['semanticDecision'])
+            ?? this.toRecord(this.toRecord(responseRecord['intentResolution'])?.['semanticDecision'])
+            ?? this.toRecord(this.toRecord(responseRecord['diagnostics'])?.['semanticDecision']);
+        const responseContract = this.toRecord(responseRecord['responseContract'])
+            ?? this.toRecord(semanticDecision?.['responseContract']);
+        if (responseContract?.['mutatesTable'] === true)
+            return true;
+        if (semanticDecision?.['mutatesTable'] === true)
+            return true;
+        const operationKind = this.normalizeLabel(this.stringValue(semanticDecision?.['operationKind']));
+        const changeKind = this.normalizeLabel(this.stringValue(semanticDecision?.['changeKind']));
+        const artifactIntent = this.normalizeLabel(this.stringValue(semanticDecision?.['artifactIntent']));
+        return [
+            operationKind,
+            changeKind,
+            artifactIntent,
+        ].some((value) => value.includes('table filter apply')
+            || value.includes('filter apply')
+            || value.includes('runtime operation')
+            || value.includes('mutation')
+            || value.includes('mutate'));
+    }
+    selectedRecordsAnalyticalSummary(contextHints) {
+        const rows = this.selectedRecordSampleRows(contextHints);
+        const selectedCount = this.extractSelectedRecordsCount(contextHints) || rows.length;
+        if (!rows.length) {
+            return `Encontrei ${selectedCount} registro${selectedCount === 1 ? '' : 's'} selecionado${selectedCount === 1 ? '' : 's'}, mas o contexto enviado não trouxe amostras de valores suficientes para comparar sem alterar a tabela.`;
+        }
+        const columns = this.toArray(this.adapter.getCurrentConfig?.()?.['columns'])
+            .map((column) => this.toRecord(column))
+            .filter((column) => !!column);
+        const labelByField = new Map();
+        for (const column of columns) {
+            const field = this.stringValue(column['field']);
+            if (!field)
+                continue;
+            labelByField.set(field, this.stringValue(column['header']) || this.humanizeField(field));
+        }
+        const fields = Array.from(new Set(rows.flatMap((row) => Object.keys(row))))
+            .filter((field) => this.selectedRecordAnalyticalFieldAllowed(field, rows));
+        const nameField = fields.find((field) => ['nome', 'nome completo', 'funcionario', 'funcionário', 'name'].includes(this.normalizeLabel(field)))
+            ?? fields.find((field) => this.normalizeLabel(field).includes('nome'))
+            ?? fields[0];
+        const names = nameField
+            ? rows.map((row) => this.readableCellValue(row[nameField])).filter((value) => !!value)
+            : [];
+        const common = fields
+            .map((field) => {
+            const values = rows.map((row) => this.readableCellValue(row[field])).filter((value) => !!value);
+            const unique = Array.from(new Set(values));
+            return unique.length === 1 ? `${labelByField.get(field) || this.humanizeField(field)}: ${unique[0]}` : null;
+        })
+            .filter((entry) => !!entry)
+            .slice(0, 5);
+        const numericRanges = fields
+            .map((field) => {
+            const values = rows.map((row) => this.numberValue(row[field])).filter((value) => value !== null);
+            if (values.length < 2)
+                return null;
+            const min = Math.min(...values);
+            const max = Math.max(...values);
+            if (min === max)
+                return null;
+            return `${labelByField.get(field) || this.humanizeField(field)}: ${this.formatAnalysisNumber(min)} até ${this.formatAnalysisNumber(max)}`;
+        })
+            .filter((entry) => !!entry)
+            .slice(0, 4);
+        const dateRanges = fields
+            .map((field) => {
+            const timestamps = rows
+                .map((row) => this.dateTimestamp(row[field]))
+                .filter((value) => value !== null);
+            if (timestamps.length < 2)
+                return null;
+            const min = Math.min(...timestamps);
+            const max = Math.max(...timestamps);
+            if (min === max)
+                return null;
+            return `${labelByField.get(field) || this.humanizeField(field)}: ${this.formatAnalysisDate(min)} até ${this.formatAnalysisDate(max)}`;
+        })
+            .filter((entry) => !!entry)
+            .slice(0, 3);
+        const differences = fields
+            .map((field) => {
+            const values = rows.map((row) => this.readableCellValue(row[field])).filter((value) => !!value);
+            const unique = Array.from(new Set(values));
+            if (unique.length <= 1 || unique.length > 5)
+                return null;
+            return `${labelByField.get(field) || this.humanizeField(field)}: ${unique.join(', ')}`;
+        })
+            .filter((entry) => !!entry)
+            .slice(0, 5);
+        const lines = [
+            `Analisei ${selectedCount} registro${selectedCount === 1 ? '' : 's'} selecionado${selectedCount === 1 ? '' : 's'} sem alterar a tabela.`,
+            names.length ? `Selecionados: ${names.slice(0, 6).join(', ')}.` : null,
+            common.length ? `Em comum: ${common.join('; ')}.` : 'Não encontrei um valor idêntico em todos os campos visíveis enviados.',
+            numericRanges.length ? `Faixas numéricas observadas: ${numericRanges.join('; ')}.` : null,
+            dateRanges.length ? `Períodos observados: ${dateRanges.join('; ')}.` : null,
+            differences.length ? `Diferenças relevantes: ${differences.join('; ')}.` : null,
+        ].filter((line) => !!line);
+        return lines.join('\n');
+    }
+    selectedRecordAnalyticalFieldAllowed(field, rows) {
+        const normalized = this.normalizeLabel(field);
+        if (!normalized)
+            return false;
+        if (normalized === 'id' || normalized.endsWith(' id') || normalized.endsWith(' ids'))
+            return false;
+        return rows.some((row) => this.readableCellValue(row[field]));
+    }
+    readableCellValue(value) {
+        if (value === null || value === undefined)
+            return '';
+        if (typeof value === 'boolean')
+            return value ? 'Sim' : 'Não';
+        if (typeof value === 'number')
+            return Number.isFinite(value) ? this.formatAnalysisNumber(value) : '';
+        if (value instanceof Date)
+            return this.formatAnalysisDate(value.getTime());
+        if (typeof value === 'string')
+            return value.trim();
+        if (Array.isArray(value)) {
+            return value.map((entry) => this.readableCellValue(entry)).filter(Boolean).join(', ');
+        }
+        return '';
+    }
+    dateTimestamp(value) {
+        const raw = value instanceof Date
+            ? value.getTime()
+            : typeof value === 'string'
+                ? Date.parse(value)
+                : Number.NaN;
+        return Number.isFinite(raw) ? raw : null;
+    }
+    formatAnalysisDate(timestamp) {
+        return new Intl.DateTimeFormat('pt-BR', {
+            day: '2-digit',
+            month: '2-digit',
+            year: 'numeric',
+        }).format(new Date(timestamp));
+    }
+    formatAnalysisNumber(value) {
+        return new Intl.NumberFormat('pt-BR', {
+            maximumFractionDigits: 2,
+        }).format(value);
+    }
     visualPresentationSurfaceRuntimeMismatch(response, request) {
         if (!request)
             return null;
@@ -7960,6 +8291,7 @@ class TableAgenticAuthoringTurnFlow {
     withCapabilitySystemMessages(messages, contextHints, prompt = '') {
         const policies = [
             this.buildRecommendedCapabilitiesSystemPolicy(contextHints),
+            this.buildSelectedRecordsAnalysisSystemPolicy(contextHints),
             this.buildComponentPresentationAuthoringSystemPolicy(contextHints, prompt),
             this.buildComponentLayoutAuthoringSystemPolicy(contextHints, prompt),
             this.buildFilterExpressionSystemPolicy(contextHints),
@@ -7967,6 +8299,40 @@ class TableAgenticAuthoringTurnFlow {
         ].filter((message) => !!message);
         return policies.length ? [...policies, ...messages] : messages;
     }
+    buildSelectedRecordsAnalysisSystemPolicy(contextHints) {
+        const selectedRecordsContext = this.selectedRecordsContextRecord(contextHints);
+        if (!selectedRecordsContext)
+            return null;
+        const selectedCount = this.numberValue(selectedRecordsContext['selectedCount']);
+        const sampleRows = Array.isArray(selectedRecordsContext['sampleRows'])
+            ? selectedRecordsContext['sampleRows']
+            : [];
+        if ((!selectedCount || selectedCount <= 0) && !sampleRows.length)
+            return null;
+        const fields = Array.isArray(selectedRecordsContext['fields'])
+            ? selectedRecordsContext['fields'].map((field) => this.stringValue(field)).filter((field) => !!field)
+            : [];
+        const candidateLabels = Array.isArray(selectedRecordsContext['filterCandidates'])
+            ? selectedRecordsContext['filterCandidates']
+                .map((candidate) => this.stringValue(this.toRecord(candidate)?.['label']))
+                .filter((label) => !!label)
+                .slice(0, 8)
+            : [];
+        return {
+            role: 'system',
+            content: [
+                'Praxis table selected-record analysis policy:',
+                '- selectedRecordsContext is a governed read-only grounding source for questions about the currently selected records.',
+                '- When the user asks to understand, summarize, compare, inspect, explain, rank, or identify commonalities/differences in selected records, return type "info" with a human analytical answer grounded in selectedRecordsContext.sampleRows. Do not return componentEditPlan, table.filter.apply, export, or row-action operations for that consultative question.',
+                '- Only materialize table changes, filters, exports, navigation, or row actions when the user explicitly asks to apply/configure/create/open/export something. Otherwise, answer first and optionally mention next actions as suggestions.',
+                '- If the selected sample rows are insufficient to answer a business question, explain the missing data succinctly instead of converting the question into a selected-record filter clarification.',
+                '- Keep the answer human-facing: use visible labels and values; do not expose raw ids, endpoint paths, operationIds, schema keys, or payload examples unless the user asks for technical details.',
+                `Selected records declared count: ${selectedCount ?? sampleRows.length}.`,
+                fields.length ? `Selected record fields: ${fields.join(', ')}.` : 'Selected record fields: inferred from sampleRows.',
+                candidateLabels.length ? `Selection-derived filter candidates available for explicit filter requests: ${candidateLabels.join(', ')}.` : 'Selection-derived filter candidates available for explicit filter requests: none declared.',
+            ].join('\n'),
+        };
+    }
     buildRecommendedCapabilitiesSystemPolicy(contextHints) {
         const recommendedIntent = this.toRecord(contextHints?.['recommendedIntent']);
         const intentId = this.stringValue(recommendedIntent?.['id'])
@@ -8105,6 +8471,7 @@ class TableAgenticAuthoringTurnFlow {
                 '- Use the declared filterFieldCatalog as the canonical grounding for row filtering decisions.',
                 '- When the user asks to restrict, search, list, show only, compare values, define ranges, or filter rows, prefer a table.filter.apply runtime operation over visual renderer or column formatting operations.',
                 ...(this.promptRequestsVisualOrStructuralEdit(normalizedPrompt)
+                    || this.promptRequestsCompoundColumnPresentationEdit(normalizedPrompt)
                     ? ['- This turn contains an explicit visual or structural table-edit signal; do not reinterpret that signal as a row filter unless the user also explicitly asks to restrict table rows.']
                     : []),
                 '- For numeric and date comparisons, use the declared range filter field from filterFieldCatalog instead of the raw listing column field.',
@@ -8255,6 +8622,11 @@ class TableAgenticAuthoringTurnFlow {
     normalizeSelectedRecordFilterClarification(response, request) {
         if (response.type !== 'clarification' || this.selectedRecordsCountForTurn <= 0)
             return null;
+        const normalizedPrompt = this.normalizeLabel(request?.prompt ?? '');
+        if (this.promptRequestsVisualOrStructuralEdit(normalizedPrompt)
+            || this.promptRequestsCompoundColumnPresentationEdit(normalizedPrompt)) {
+            return null;
+        }
         const contextHints = this.contextHintsFor(request);
         const candidates = this.selectedRecordFilterCandidates(contextHints);
         if (!candidates.length)

package/fesm2022/{praxisui-table-table-ai.adapter-BWnL5QfP.mjs → praxisui-table-table-ai.adapter-DR0VP12I.mjs}

@@ -1,7 +1,7 @@
 import { firstValueFrom } from 'rxjs';
 import { BaseAiAdapter, createComponentAuthoringContext } from '@praxisui/ai';
 import { PRAXIS_GLOBAL_ACTION_CATALOG, deepMerge } from '@praxisui/core';
-import { G as TABLE_COMPONENT_EDIT_PLAN_OPERATION_IDS, k as PRAXIS_TABLE_AUTHORING_MANIFEST, T as TABLE_AI_CAPABILITIES, W as coerceTableComponentEditPlans, Y as compileTableComponentEditPlans, I as TASK_PRESETS, a1 as getTableComponentEditPlanCapabilities, y as TABLE_COMPONENT_EDIT_PLAN_EXPECTED_PATHS, w as TABLE_COMPONENT_EDIT_PLAN_ALLOWED_CHANGE_KINDS, z as TABLE_COMPONENT_EDIT_PLAN_JSON_SCHEMA, H as TABLE_COMPONENT_EDIT_PLAN_VERSION, x as TABLE_COMPONENT_EDIT_PLAN_BATCH_KIND, E as TABLE_COMPONENT_EDIT_PLAN_KIND } from './praxisui-table-praxisui-table-DXpnCND9.mjs';
+import { G as TABLE_COMPONENT_EDIT_PLAN_OPERATION_IDS, k as PRAXIS_TABLE_AUTHORING_MANIFEST, T as TABLE_AI_CAPABILITIES, W as coerceTableComponentEditPlans, Y as compileTableComponentEditPlans, I as TASK_PRESETS, a1 as getTableComponentEditPlanCapabilities, y as TABLE_COMPONENT_EDIT_PLAN_EXPECTED_PATHS, w as TABLE_COMPONENT_EDIT_PLAN_ALLOWED_CHANGE_KINDS, z as TABLE_COMPONENT_EDIT_PLAN_JSON_SCHEMA, H as TABLE_COMPONENT_EDIT_PLAN_VERSION, x as TABLE_COMPONENT_EDIT_PLAN_BATCH_KIND, E as TABLE_COMPONENT_EDIT_PLAN_KIND } from './praxisui-table-praxisui-table-BKb6n5uc.mjs';
 
 const TABLE_COMPONENT_CONTEXT_PACK = {
     version: 'v1',

package/fesm2022/praxisui-table.mjs

@@ -1 +1 @@
-export { A as AnalyticsTableConfigAdapterService, a as AnalyticsTableContractService, b as AnalyticsTableStatsApiService, B as BOOLEAN_PRESETS, c as BehaviorConfigEditorComponent, C as CURRENCY_PRESETS, d as ColumnsConfigEditorComponent, D as DATE_PRESETS, e as DataFormatterComponent, f as DataFormattingService, F as FORMULA_TEMPLATES, g as FilterConfigService, h as FilterSettingsComponent, i as FormulaGeneratorService, J as JsonConfigEditorComponent, M as MessagesLocalizationEditorComponent, N as NUMBER_PRESETS, P as PERCENTAGE_PRESETS, j as PRAXIS_FILTER_COMPONENT_METADATA, k as PRAXIS_TABLE_AUTHORING_MANIFEST, l as PRAXIS_TABLE_COMPONENT_METADATA, m as PRAXIS_TABLE_TOOLBAR_DEFAULT_APPEARANCE, n as PRAXIS_TABLE_TOOLBAR_TOKEN_PRESETS, o as PraxisFilter, p as PraxisFilterWidgetConfigEditor, q as PraxisTable, r as PraxisTableConfigEditor, s as PraxisTableInlineAuthoringEditorComponent, t as PraxisTableToolbar, u as PraxisTableWidgetConfigEditor, S as STRING_PRESETS, T as TABLE_AI_CAPABILITIES, v as TABLE_COMPONENT_AI_CAPABILITIES, w as TABLE_COMPONENT_EDIT_PLAN_ALLOWED_CHANGE_KINDS, x as TABLE_COMPONENT_EDIT_PLAN_BATCH_KIND, y as TABLE_COMPONENT_EDIT_PLAN_EXPECTED_PATHS, z as TABLE_COMPONENT_EDIT_PLAN_JSON_SCHEMA, E as TABLE_COMPONENT_EDIT_PLAN_KIND, H as TABLE_COMPONENT_EDIT_PLAN_VERSION, I as TASK_PRESETS, K as TableDefaultsProvider, L as TableRulesEditorComponent, O as ToolbarActionsEditorComponent, V as ValueMappingEditorComponent, Q as VisualFormulaBuilderComponent, R as buildTableApplyPlan, U as coerceTableComponentEditPlan, W as coerceTableComponentEditPlans, X as compileTableComponentEditPlan, Y as compileTableComponentEditPlans, Z as createTableAuthoringDocument, _ as getActionId, $ as getEnum, a0 as getTableCapabilities, a1 as getTableComponentEditPlanCapabilities, a2 as isTableRendererSupportedByRichContentP0, a3 as mapTableRendererToRichContentP0, a4 as normalizeTableAuthoringDocument, a5 as parseLegacyOrTableDocument, a6 as providePraxisFilterMetadata, a7 as providePraxisTableMetadata, a8 as providePraxisTableToolbarAppearance, a9 as serializeTableAuthoringDocument, aa as toCanonicalTableConfig, ab as validateTableAuthoringDocument } from './praxisui-table-praxisui-table-DXpnCND9.mjs';
+export { A as AnalyticsTableConfigAdapterService, a as AnalyticsTableContractService, b as AnalyticsTableStatsApiService, B as BOOLEAN_PRESETS, c as BehaviorConfigEditorComponent, C as CURRENCY_PRESETS, d as ColumnsConfigEditorComponent, D as DATE_PRESETS, e as DataFormatterComponent, f as DataFormattingService, F as FORMULA_TEMPLATES, g as FilterConfigService, h as FilterSettingsComponent, i as FormulaGeneratorService, J as JsonConfigEditorComponent, M as MessagesLocalizationEditorComponent, N as NUMBER_PRESETS, P as PERCENTAGE_PRESETS, j as PRAXIS_FILTER_COMPONENT_METADATA, k as PRAXIS_TABLE_AUTHORING_MANIFEST, l as PRAXIS_TABLE_COMPONENT_METADATA, m as PRAXIS_TABLE_TOOLBAR_DEFAULT_APPEARANCE, n as PRAXIS_TABLE_TOOLBAR_TOKEN_PRESETS, o as PraxisFilter, p as PraxisFilterWidgetConfigEditor, q as PraxisTable, r as PraxisTableConfigEditor, s as PraxisTableInlineAuthoringEditorComponent, t as PraxisTableToolbar, u as PraxisTableWidgetConfigEditor, S as STRING_PRESETS, T as TABLE_AI_CAPABILITIES, v as TABLE_COMPONENT_AI_CAPABILITIES, w as TABLE_COMPONENT_EDIT_PLAN_ALLOWED_CHANGE_KINDS, x as TABLE_COMPONENT_EDIT_PLAN_BATCH_KIND, y as TABLE_COMPONENT_EDIT_PLAN_EXPECTED_PATHS, z as TABLE_COMPONENT_EDIT_PLAN_JSON_SCHEMA, E as TABLE_COMPONENT_EDIT_PLAN_KIND, H as TABLE_COMPONENT_EDIT_PLAN_VERSION, I as TASK_PRESETS, K as TableDefaultsProvider, L as TableRulesEditorComponent, O as ToolbarActionsEditorComponent, V as ValueMappingEditorComponent, Q as VisualFormulaBuilderComponent, R as buildTableApplyPlan, U as coerceTableComponentEditPlan, W as coerceTableComponentEditPlans, X as compileTableComponentEditPlan, Y as compileTableComponentEditPlans, Z as createTableAuthoringDocument, _ as getActionId, $ as getEnum, a0 as getTableCapabilities, a1 as getTableComponentEditPlanCapabilities, a2 as isTableRendererSupportedByRichContentP0, a3 as mapTableRendererToRichContentP0, a4 as normalizeTableAuthoringDocument, a5 as parseLegacyOrTableDocument, a6 as providePraxisFilterMetadata, a7 as providePraxisTableMetadata, a8 as providePraxisTableToolbarAppearance, a9 as serializeTableAuthoringDocument, aa as toCanonicalTableConfig, ab as validateTableAuthoringDocument } from './praxisui-table-praxisui-table-BKb6n5uc.mjs';

package/package.json

@@ -1,23 +1,23 @@
 {
   "name": "@praxisui/table",
-  "version": "8.0.0-beta.94",
+  "version": "8.0.0-beta.96",
   "description": "Advanced data table for Angular (Praxis UI) with editing, filtering, sorting, virtualization, and settings panel integration.",
   "peerDependencies": {
     "@angular/common": "^21.0.0",
     "@angular/core": "^21.0.0",
-    "@praxisui/ai": "^8.0.0-beta.94",
-    "@praxisui/core": "^8.0.0-beta.94",
-    "@praxisui/dynamic-fields": "^8.0.0-beta.94",
-    "@praxisui/dynamic-form": "^8.0.0-beta.94",
-    "@praxisui/metadata-editor": "^8.0.0-beta.94",
-    "@praxisui/rich-content": "^8.0.0-beta.94",
-    "@praxisui/settings-panel": "^8.0.0-beta.94",
-    "@praxisui/table-rule-builder": "^8.0.0-beta.94",
+    "@praxisui/ai": "^8.0.0-beta.96",
+    "@praxisui/core": "^8.0.0-beta.96",
+    "@praxisui/dynamic-fields": "^8.0.0-beta.96",
+    "@praxisui/dynamic-form": "^8.0.0-beta.96",
+    "@praxisui/metadata-editor": "^8.0.0-beta.96",
+    "@praxisui/rich-content": "^8.0.0-beta.96",
+    "@praxisui/settings-panel": "^8.0.0-beta.96",
+    "@praxisui/table-rule-builder": "^8.0.0-beta.96",
     "@angular/cdk": "^21.0.0",
     "@angular/forms": "^21.0.0",
     "@angular/material": "^21.0.0",
     "@angular/router": "^21.0.0",
-    "@praxisui/dialog": "^8.0.0-beta.94",
+    "@praxisui/dialog": "^8.0.0-beta.96",
     "rxjs": "~7.8.0"
   },
   "dependencies": {