@praxisui/table 9.0.0-beta.88 → 9.0.0-beta.90

package/fesm2022/{praxisui-table-praxisui-table-IDepR7JN.mjs → praxisui-table-praxisui-table-CWBFPs1H.mjs}

@@ -36,7 +36,7 @@ import * as i13 from '@angular/cdk/drag-drop';
 import { moveItemInArray, DragDropModule } from '@angular/cdk/drag-drop';
 import { Subject, debounceTime, takeUntil, firstValueFrom, of, BehaviorSubject, Subscription, take as take$1 } from 'rxjs';
 import * as i1 from '@praxisui/core';
-import { LoggerService, createCorporateLoggerConfig, ConsoleLoggerSink, PraxisJsonLogicService, PraxisIconDirective, PraxisIconButtonComponent, PraxisI18nService, isTableConfigV2, providePraxisI18nConfig, PRAXIS_GLOBAL_ACTION_CATALOG, SURFACE_OPEN_I18N_NAMESPACE, isRequiredGlobalActionPayloadMissing, getGlobalActionUiSchema, getRequiredGlobalActionPayloadKeys, hasMeaningfulGlobalActionPayloadValue, SurfaceOpenActionEditorComponent, SURFACE_OPEN_I18N_CONFIG, ASYNC_CONFIG_STORAGE, INLINE_FILTER_CONTROL_TYPES, INLINE_FILTER_CONTROL_TYPE_VALUES, FieldControlType, normalizeControlTypeToken, resolveControlTypeAlias, mapFieldDefinitionsToMetadata, PraxisJsonLogicError, GLOBAL_ACTION_CATALOG, GenericCrudService, validateGlobalActionRefs, getGlobalActionCatalog, TableConfigService, createDefaultTableConfig, fillUndefined, deepMerge, INLINE_FILTER_ALIAS_TOKENS, GlobalConfigService, buildSchemaId, MemoryCacheAdapter, LocalStorageCacheAdapter, SchemaMetadataClient, resolveInlineFilterControlType, fetchWithETag, serializeEntityLookupValueForPayload, ComponentMetadataRegistry, AnalyticsStatsRequestBuilderService, buildApiUrl, normalizePraxisDataQueryContext, API_URL, PraxisRuntimeComponentObservationRegistryService, PRAXIS_TABLE_DETAIL_INLINE_RENDERERS, PRAXIS_TABLE_DETAIL_INLINE_NODE_RESOLVERS, PraxisCollectionExportService, SchemaNormalizerService, translateResourceAvailabilityReason, ResourceDiscoveryService, ResourceSurfaceOpenAdapterService, CrudOperationResolutionService, ResourceQuickConnectComponent, assertPraxisCollectionExportArtifact, PRAXIS_LOADING_CTX, resolveColumnTypeFromFieldDefinition, isPraxisPresentationVisualizationTableSafe, resolveTextMaskFormatFromFieldDefinition, translateResourceDiscoveryText, supportsImplicitValuePresentation, resolveValuePresentation, renderPraxisPresentationVisualizationHtml, materializeResourceIdentity, translateUnavailableWorkflowMessage, CONNECTION_STORAGE, PRAXIS_LOADING_RENDERER, EmptyStateCardComponent, RESOURCE_DISCOVERY_I18N_CONFIG } from '@praxisui/core';
+import { LoggerService, createCorporateLoggerConfig, ConsoleLoggerSink, PraxisJsonLogicService, PraxisIconDirective, PraxisIconButtonComponent, PraxisI18nService, isTableConfigV2, providePraxisI18nConfig, PRAXIS_GLOBAL_ACTION_CATALOG, SURFACE_OPEN_I18N_NAMESPACE, isRequiredGlobalActionPayloadMissing, getGlobalActionUiSchema, getRequiredGlobalActionPayloadKeys, hasMeaningfulGlobalActionPayloadValue, SurfaceOpenActionEditorComponent, SURFACE_OPEN_I18N_CONFIG, ASYNC_CONFIG_STORAGE, INLINE_FILTER_CONTROL_TYPES, INLINE_FILTER_CONTROL_TYPE_VALUES, FieldControlType, normalizeControlTypeToken, resolveControlTypeAlias, mapFieldDefinitionsToMetadata, PraxisJsonLogicError, GLOBAL_ACTION_CATALOG, GenericCrudService, validateGlobalActionRefs, getGlobalActionCatalog, TableConfigService, createDefaultTableConfig, fillUndefined, deepMerge, INLINE_FILTER_ALIAS_TOKENS, GlobalConfigService, buildSchemaId, MemoryCacheAdapter, LocalStorageCacheAdapter, SchemaMetadataClient, resolveInlineFilterControlType, fetchWithETag, serializeEntityLookupValueForPayload, ComponentMetadataRegistry, AnalyticsStatsRequestBuilderService, buildApiUrl, normalizePraxisDataQueryContext, API_URL, PraxisRuntimeComponentObservationRegistryService, PRAXIS_TABLE_DETAIL_INLINE_RENDERERS, PRAXIS_TABLE_DETAIL_INLINE_NODE_RESOLVERS, PraxisCollectionExportService, SchemaNormalizerService, translateResourceAvailabilityReason, ResourceDiscoveryService, ResourceSurfaceOpenAdapterService, CrudOperationResolutionService, ResourceQuickConnectComponent, assertPraxisCollectionExportArtifact, PRAXIS_LOADING_CTX, resolveColumnTypeFromFieldDefinition, isPraxisPresentationVisualizationTableSafe, resolveTextMaskFormatFromFieldDefinition, translateResourceDiscoveryText, supportsImplicitValuePresentation, resolveValuePresentation, renderPraxisPresentationVisualizationHtml, resolveResourceIdentityContract, materializeResourceIdentity, translateUnavailableWorkflowMessage, CONNECTION_STORAGE, PRAXIS_LOADING_RENDERER, EmptyStateCardComponent, RESOURCE_DISCOVERY_I18N_CONFIG } from '@praxisui/core';
 import { PraxisRichContent } from '@praxisui/rich-content';
 import * as i2 from '@angular/material/toolbar';
 import { MatToolbarModule } from '@angular/material/toolbar';
@@ -41646,6 +41646,9 @@ class PraxisTable {
     warnLog(message, data, meta) {
         this.getLogger().warn(message, this.buildLogOptions(data, meta));
     }
+    infoLog(message, data, meta) {
+        this.getLogger().info(message, this.buildLogOptions(data, meta));
+    }
     warnOnceLog(message, data, meta) {
         this.getLogger().warnOnce(message, this.buildLogOptions(data, meta));
     }
@@ -42549,7 +42552,7 @@ class PraxisTable {
         if (this.aiAdapter || this.aiAdapterLoadStarted)
             return;
         this.aiAdapterLoadStarted = true;
-        import('./praxisui-table-table-ai.adapter-DjfE591p.mjs')
+        import('./praxisui-table-table-ai.adapter-CeH1iTVt.mjs')
             .then(({ TableAiAdapter }) => {
             if (!this.isAiAssistantEnabled()) {
                 this.aiAssistantOpenAfterAdapterLoad = false;
@@ -43295,7 +43298,7 @@ class PraxisTable {
     initializeAiAssistantController() {
         if (!this.aiAdapter || this.aiAssistantController)
             return;
-        import('./praxisui-table-table-agentic-authoring-turn-flow-Dk7mU6l2.mjs')
+        import('./praxisui-table-table-agentic-authoring-turn-flow-BLNUMwu5.mjs')
             .then(({ TableAgenticAuthoringTurnFlow }) => {
             if (this.aiAssistantController || !this.aiAdapter)
                 return;
@@ -56462,7 +56465,64 @@ class PraxisTable {
     materializeRecordIdentity(row) {
         if (!row || typeof row !== 'object' || Array.isArray(row))
             return null;
-        return materializeResourceIdentity(this.crudService.getResourceIdentity?.(), row, this.schemaFieldsSnapshot);
+        const record = row;
+        const canonicalContract = this.crudService.getResourceIdentity?.() ?? null;
+        const canonicalDiagnostics = this.crudService.getResourceIdentityDiagnostics?.() ?? [];
+        this.reportResourceIdentityDiagnostics(canonicalDiagnostics);
+        const hostResolution = canonicalContract
+            ? null
+            : resolveResourceIdentityContract({
+                effectiveIdField: this.resolveHostIdentityIdField(),
+                availableFields: this.schemaFieldsSnapshot,
+            });
+        if (hostResolution) {
+            this.reportResourceIdentityDiagnostics(hostResolution.diagnostics);
+        }
+        const contract = canonicalContract ?? hostResolution?.contract ?? null;
+        const identity = materializeResourceIdentity(contract, record, this.schemaFieldsSnapshot);
+        if (!identity && contract) {
+            const field = contract.keyField
+                ?? contract.titleField
+                ?? contract.displayLabelField
+                ?? contract.metadataFields?.[0];
+            this.reportResourceIdentityDiagnostics([{
+                    code: 'resource-identity.value-missing',
+                    severity: 'warning',
+                    message: 'The configured record identity has no displayable value in this row.',
+                    source: contract.source,
+                    ...(field ? { field } : {}),
+                }]);
+        }
+        return identity;
+    }
+    resolveHostIdentityIdField() {
+        return this.resolveConfigMetaIdField()
+            || this.normalizeIdField(this.crudContext?.idField)
+            || undefined;
+    }
+    reportResourceIdentityDiagnostics(diagnostics) {
+        for (const diagnostic of diagnostics) {
+            const logMeta = {
+                dedupeKey: [
+                    'praxis-table:resource-identity',
+                    diagnostic.code,
+                    diagnostic.source || 'none',
+                    diagnostic.field || 'none',
+                ].join(':'),
+                throttleKey: [
+                    'praxis-table:resource-identity',
+                    diagnostic.code,
+                    diagnostic.source || 'none',
+                    diagnostic.field || 'none',
+                ].join(':'),
+                context: { feature: 'resource-identity' },
+            };
+            if (diagnostic.severity === 'info') {
+                this.infoLog('[PraxisTable] Resource identity diagnostic', { ...diagnostic }, logMeta);
+                continue;
+            }
+            this.warnOnceLog('[PraxisTable] Resource identity diagnostic', { ...diagnostic }, logMeta);
+        }
     }
     emitResourceEvent(kind, sourceOutput, payload, surface, resourceId, phase) {
         this.resourceEvent.emit(this.buildResourceEvent(kind, sourceOutput, payload, surface, resourceId, phase));
@@ -59111,213 +59171,270 @@ const tablePerformanceSchema = {
         }
     }
 };
-const rendererSchema = {
+const rendererButtonSchema = {
     type: 'object',
-    description: 'Renderizador visual. Quando a intencao pedir chip, use type "chip" e configure chip; efeitos iconBadge materializam badge, nao chip.',
-    required: ['type'],
+    required: ['action'],
     properties: {
-        type: { enum: RENDERER_TYPES },
-        typeExpr: { type: 'string' },
-        button: {
-            type: 'object',
-            required: ['action'],
-            properties: {
-                label: { type: 'string' },
-                labelField: { type: 'string' },
-                icon: { type: 'string' },
-                color: { enum: ['primary', 'accent', 'warn'] },
-                variant: { enum: ['filled', 'outlined', 'text'] },
-                size: { enum: ['sm', 'md', 'lg'] },
-                ariaLabel: { type: 'string' },
-                disabledCondition: { type: 'object', description: 'AST Json Logic' },
-                action: {
-                    type: 'object',
-                    required: ['id'],
-                    properties: {
-                        id: { type: 'string' },
-                        payloadExpr: { type: 'string' }
-                    }
-                }
-            }
-        },
-        menu: {
-            type: 'object',
-            required: ['itemsExpr'],
-            properties: {
-                itemsExpr: { type: 'string' },
-                ariaLabel: { type: 'string' }
-            }
-        },
-        link: {
-            type: 'object',
-            anyOf: [{ required: ['href'] }, { required: ['hrefField'] }],
-            properties: {
-                text: { type: 'string' },
-                textField: { type: 'string' },
-                href: { type: 'string' },
-                hrefField: { type: 'string' },
-                target: { enum: ['_blank', '_self', '_parent', '_top'] },
-                rel: { type: 'string' }
-            }
-        },
-        progress: {
-            type: 'object',
-            required: ['valueExpr'],
-            properties: {
-                valueExpr: { type: 'string' },
-                color: { type: 'string' },
-                showLabel: { type: 'boolean' }
-            }
-        },
-        badge: {
+        label: { type: 'string' },
+        labelField: { type: 'string' },
+        icon: { type: 'string' },
+        color: { enum: ['primary', 'accent', 'warn'] },
+        variant: { enum: ['filled', 'outlined', 'text'] },
+        size: { enum: ['sm', 'md', 'lg'] },
+        ariaLabel: { type: 'string' },
+        disabledCondition: { type: 'object', description: 'AST Json Logic' },
+        action: {
             type: 'object',
-            anyOf: [{ required: ['text'] }, { required: ['textField'] }],
+            required: ['id'],
             properties: {
-                text: { type: 'string' },
-                textField: { type: 'string' },
-                color: { enum: RENDERER_COLOR_TOKENS },
-                variant: { enum: ['filled', 'outlined', 'soft', 'plain'] },
-                icon: { type: 'string' },
-                tooltip: {
-                    type: 'object',
-                    properties: {
-                        text: { type: 'string' },
-                        position: { enum: ['top', 'right', 'bottom', 'left'] },
-                        bgColor: { type: 'string' },
-                        delayMs: { type: 'number' }
-                    }
-                }
+                id: { type: 'string' },
+                payloadExpr: { type: 'string' }
             }
-        },
-        chip: {
+        }
+    }
+};
+const rendererMenuSchema = {
+    type: 'object',
+    required: ['itemsExpr'],
+    properties: {
+        itemsExpr: { type: 'string' },
+        ariaLabel: { type: 'string' }
+    }
+};
+const rendererLinkSchema = {
+    type: 'object',
+    anyOf: [{ required: ['href'] }, { required: ['hrefField'] }],
+    properties: {
+        text: { type: 'string' },
+        textField: { type: 'string' },
+        href: { type: 'string' },
+        hrefField: { type: 'string' },
+        target: { enum: ['_blank', '_self', '_parent', '_top'] },
+        rel: { type: 'string' }
+    }
+};
+const rendererProgressSchema = {
+    type: 'object',
+    required: ['valueExpr'],
+    properties: {
+        valueExpr: { type: 'string' },
+        color: { type: 'string' },
+        showLabel: { type: 'boolean' }
+    }
+};
+const rendererBadgeSchema = {
+    type: 'object',
+    anyOf: [{ required: ['text'] }, { required: ['textField'] }],
+    properties: {
+        text: { type: 'string' },
+        textField: { type: 'string' },
+        color: { enum: RENDERER_COLOR_TOKENS },
+        variant: { enum: ['filled', 'outlined', 'soft', 'plain'] },
+        icon: { type: 'string' },
+        tooltip: {
             type: 'object',
-            anyOf: [{ required: ['text'] }, { required: ['textField'] }],
             properties: {
                 text: { type: 'string' },
-                textField: { type: 'string' },
-                color: { enum: RENDERER_COLOR_TOKENS },
-                variant: { enum: ['filled', 'outlined'] },
-                icon: { type: 'string' },
-                tooltip: {
-                    type: 'object',
-                    properties: {
-                        text: { type: 'string' },
-                        position: { enum: ['top', 'right', 'bottom', 'left'] },
-                        bgColor: { type: 'string' },
-                        delayMs: { type: 'number' }
-                    }
-                }
+                position: { enum: ['top', 'right', 'bottom', 'left'] },
+                bgColor: { type: 'string' },
+                delayMs: { type: 'number' }
             }
-        },
-        icon: {
+        }
+    }
+};
+const rendererChipSchema = {
+    type: 'object',
+    anyOf: [{ required: ['text'] }, { required: ['textField'] }],
+    properties: {
+        text: { type: 'string' },
+        textField: { type: 'string' },
+        color: { enum: RENDERER_COLOR_TOKENS },
+        variant: { enum: ['filled', 'outlined'] },
+        icon: { type: 'string' },
+        tooltip: {
             type: 'object',
-            anyOf: [{ required: ['name'] }, { required: ['nameField'] }],
             properties: {
-                name: { type: 'string' },
-                nameField: { type: 'string' },
                 text: { type: 'string' },
-                textField: { type: 'string' },
-                prefix: { type: 'string' },
-                suffix: { type: 'string' },
-                color: { type: 'string' },
-                size: { type: 'number' },
-                ariaLabel: { type: 'string' }
-            }
-        },
-        image: {
-            type: 'object',
-            anyOf: [{ required: ['src'] }, { required: ['srcField'] }],
-            properties: {
-                src: { type: 'string' },
-                srcField: { type: 'string' },
-                alt: { type: 'string' },
-                altField: { type: 'string' },
-                width: { type: 'number' },
-                height: { type: 'number' },
-                shape: { enum: ['square', 'rounded', 'circle'] },
-                fit: { enum: ['cover', 'contain'] },
-                lazy: { type: 'boolean' }
-            }
-        },
-        avatar: {
-            type: 'object',
-            anyOf: [{ required: ['src'] }, { required: ['srcField'] }, { required: ['initialsField'] }, { required: ['initialsExpr'] }],
-            properties: {
-                src: { type: 'string' },
-                srcField: { type: 'string' },
-                alt: { type: 'string' },
-                altField: { type: 'string' },
-                initialsField: { type: 'string' },
-                initialsExpr: { type: 'string' },
-                shape: { enum: ['circle', 'square', 'rounded'] },
-                size: { type: 'number' },
-                backgroundColor: { type: 'string' },
-                textColor: { type: 'string' }
+                position: { enum: ['top', 'right', 'bottom', 'left'] },
+                bgColor: { type: 'string' },
+                delayMs: { type: 'number' }
             }
-        },
-        toggle: {
+        }
+    }
+};
+const rendererIconSchema = {
+    type: 'object',
+    anyOf: [{ required: ['name'] }, { required: ['nameField'] }],
+    properties: {
+        name: { type: 'string' },
+        nameField: { type: 'string' },
+        text: { type: 'string' },
+        textField: { type: 'string' },
+        prefix: { type: 'string' },
+        suffix: { type: 'string' },
+        color: { type: 'string' },
+        size: { type: 'number' },
+        ariaLabel: { type: 'string' }
+    }
+};
+const rendererImageSchema = {
+    type: 'object',
+    anyOf: [{ required: ['src'] }, { required: ['srcField'] }],
+    properties: {
+        src: { type: 'string' },
+        srcField: { type: 'string' },
+        alt: { type: 'string' },
+        altField: { type: 'string' },
+        width: { type: 'number', description: 'Largura visual em pixels; altere apenas quando o pedido mudar o tamanho da imagem.' },
+        height: { type: 'number', description: 'Altura visual em pixels; para imagem quadrada, mantenha igual a width.' },
+        shape: { enum: ['square', 'rounded', 'circle'], description: 'square não arredonda, rounded usa cantos arredondados e circle materializa um círculo.' },
+        fit: { enum: ['cover', 'contain'] },
+        lazy: { type: 'boolean' }
+    }
+};
+const rendererAvatarSchema = {
+    type: 'object',
+    anyOf: [{ required: ['src'] }, { required: ['srcField'] }, { required: ['initialsField'] }, { required: ['initialsExpr'] }],
+    properties: {
+        src: { type: 'string' },
+        srcField: { type: 'string' },
+        alt: { type: 'string' },
+        altField: { type: 'string' },
+        initialsField: { type: 'string' },
+        initialsExpr: { type: 'string' },
+        shape: { enum: ['circle', 'square', 'rounded'], description: 'circle é circular, square é quadrado e rounded é quadrado com cantos arredondados.' },
+        size: { type: 'number', description: 'Tamanho visual do avatar em pixels; preserve os demais campos e itens do compose ao mudar apenas o tamanho.' },
+        backgroundColor: { type: 'string' },
+        textColor: { type: 'string' }
+    }
+};
+const rendererToggleSchema = {
+    type: 'object',
+    required: ['stateExpr', 'action'],
+    properties: {
+        stateExpr: { type: 'string' },
+        disabledCondition: { type: 'object', description: 'AST Json Logic' },
+        ariaLabel: { type: 'string' },
+        action: {
             type: 'object',
-            required: ['stateExpr', 'action'],
+            required: ['id'],
             properties: {
-                stateExpr: { type: 'string' },
-                disabledCondition: { type: 'object', description: 'AST Json Logic' },
-                ariaLabel: { type: 'string' },
-                action: {
-                    type: 'object',
-                    required: ['id'],
-                    properties: {
-                        id: { type: 'string' },
-                        payloadExpr: { type: 'string' }
-                    }
-                }
+                id: { type: 'string' },
+                payloadExpr: { type: 'string' }
             }
+        }
+    }
+};
+const rendererRatingSchema = {
+    type: 'object',
+    required: ['valueExpr'],
+    properties: {
+        valueExpr: { type: 'string' },
+        max: { type: 'number' },
+        color: { type: 'string' },
+        outlineColor: { type: 'string' },
+        size: { enum: ['small', 'medium', 'large'] },
+        ariaLabel: { type: 'string' }
+    }
+};
+const rendererHtmlSchema = {
+    type: 'object',
+    required: ['template'],
+    properties: {
+        template: { type: 'string' },
+        sanitize: { enum: ['strict', 'basic'] },
+        emptyFallback: { type: 'string' }
+    }
+};
+const rendererVariantRequirements = [
+    { if: { properties: { type: { const: 'button' } } }, then: { required: ['button'] } },
+    { if: { properties: { type: { const: 'menu' } } }, then: { required: ['menu'] } },
+    { if: { properties: { type: { const: 'link' } } }, then: { required: ['link'] } },
+    { if: { properties: { type: { const: 'progress' } } }, then: { required: ['progress'] } },
+    { if: { properties: { type: { const: 'badge' } } }, then: { required: ['badge'] } },
+    { if: { properties: { type: { const: 'chip' } } }, then: { required: ['chip'] } },
+    { if: { properties: { type: { const: 'icon' } } }, then: { required: ['icon'] } },
+    { if: { properties: { type: { const: 'image' } } }, then: { required: ['image'] } },
+    { if: { properties: { type: { const: 'avatar' } } }, then: { required: ['avatar'] } },
+    { if: { properties: { type: { const: 'toggle' } } }, then: { required: ['toggle'] } },
+    { if: { properties: { type: { const: 'rating' } } }, then: { required: ['rating'] } },
+    { if: { properties: { type: { const: 'html' } } }, then: { required: ['html'] } }
+];
+const rendererComposeItemSchema = {
+    type: 'object',
+    description: 'Item de uma célula composta. value mostra um campo da linha; os demais tipos exigem seu bloco de configuração homônimo.',
+    required: ['type'],
+    properties: {
+        type: {
+            enum: ['value', 'icon', 'image', 'badge', 'link', 'button', 'chip', 'progress', 'avatar', 'toggle', 'menu', 'rating', 'html']
         },
-        rating: {
-            type: 'object',
-            required: ['valueExpr'],
-            properties: {
-                valueExpr: { type: 'string' },
-                max: { type: 'number' },
-                color: { type: 'string' },
-                outlineColor: { type: 'string' },
-                size: { enum: ['small', 'medium', 'large'] },
-                ariaLabel: { type: 'string' }
-            }
+        field: { type: 'string' },
+        textField: { type: 'string' },
+        valueField: { type: 'string' },
+        text: { type: 'string' },
+        style: { type: 'string' },
+        button: rendererButtonSchema,
+        menu: rendererMenuSchema,
+        link: rendererLinkSchema,
+        progress: rendererProgressSchema,
+        badge: rendererBadgeSchema,
+        chip: rendererChipSchema,
+        icon: rendererIconSchema,
+        image: rendererImageSchema,
+        avatar: rendererAvatarSchema,
+        toggle: rendererToggleSchema,
+        rating: rendererRatingSchema,
+        html: rendererHtmlSchema
+    },
+    allOf: rendererVariantRequirements
+};
+const rendererComposeLayoutSchema = {
+    type: 'object',
+    minProperties: 1,
+    properties: {
+        gap: { type: 'number' },
+        direction: {
+            enum: ['row', 'column'],
+            description: 'row coloca os itens lado a lado na mesma linha; column empilha verticalmente, por exemplo foto em cima e código embaixo.'
         },
-        html: {
-            type: 'object',
-            required: ['template'],
-            properties: {
-                template: { type: 'string' },
-                sanitize: { enum: ['strict', 'basic'] },
-                emptyFallback: { type: 'string' }
-            }
+        align: { enum: ['start', 'center', 'end'] },
+        wrap: { type: 'boolean' },
+        ellipsis: { type: 'boolean' }
+    }
+};
+const rendererComposeSchema = {
+    type: 'object',
+    description: 'Composição de vários itens dentro da mesma célula. Em refinamentos, preserve os itens atuais e altere somente o atributo solicitado.',
+    required: ['items'],
+    properties: {
+        items: {
+            type: 'array',
+            minItems: 1,
+            items: rendererComposeItemSchema
         },
-        compose: {
-            type: 'object',
-            required: ['items'],
-            properties: {
-                items: {
-                    type: 'array',
-                    minItems: 1,
-                    items: {
-                        type: 'object',
-                        required: ['type'],
-                        properties: { type: { enum: RENDERER_TYPES.filter(type => type !== 'compose') } }
-                    }
-                },
-                layout: {
-                    type: 'object',
-                    properties: {
-                        gap: { type: 'number' },
-                        direction: { enum: ['row', 'column'] },
-                        align: { enum: ['start', 'center', 'end'] },
-                        wrap: { type: 'boolean' },
-                        ellipsis: { type: 'boolean' }
-                    }
-                }
-            }
-        }
+        layout: rendererComposeLayoutSchema
+    }
+};
+const rendererSchema = {
+    type: 'object',
+    description: 'Renderizador visual. Quando a intencao pedir chip, use type "chip" e configure chip; efeitos iconBadge materializam badge, nao chip. Ao refinar um compose existente, copie seus itens atuais e altere somente tamanho, forma, direção ou outra propriedade explicitamente solicitada.',
+    required: ['type'],
+    properties: {
+        type: { enum: RENDERER_TYPES },
+        typeExpr: { type: 'string' },
+        button: rendererButtonSchema,
+        menu: rendererMenuSchema,
+        link: rendererLinkSchema,
+        progress: rendererProgressSchema,
+        badge: rendererBadgeSchema,
+        chip: rendererChipSchema,
+        icon: rendererIconSchema,
+        image: rendererImageSchema,
+        avatar: rendererAvatarSchema,
+        toggle: rendererToggleSchema,
+        rating: rendererRatingSchema,
+        html: rendererHtmlSchema,
+        compose: rendererComposeSchema
     },
     allOf: [
         { if: { properties: { type: { const: 'button' } } }, then: { required: ['button'] } },
@@ -59339,7 +59456,7 @@ const rendererSchema = {
  * Manifesto de authoring canônico para o componente praxis-table.
  * Este arquivo define o contrato executável para que agentes de IA editem tabelas.
  *
- * @version 2.0.0
+ * @version 2.2.1
  * @status COMPLIANT - Alinhado com o contrato v2 e TableConfig canônico.
  */
 const PRAXIS_TABLE_AUTHORING_MANIFEST = {
@@ -59347,7 +59464,7 @@ const PRAXIS_TABLE_AUTHORING_MANIFEST = {
     componentId: 'praxis-table',
     ownerPackage: '@praxisui/table',
     configSchemaId: 'TableConfig',
-    manifestVersion: '2.0.0',
+    manifestVersion: '2.2.1',
     runtimeInputs: [
         { name: 'config', type: 'TableConfig', description: 'Configuração completa da tabela' },
         { name: 'data', type: 'any[]', description: 'Dados a serem exibidos (modo client-side)' },
@@ -59432,7 +59549,7 @@ const PRAXIS_TABLE_AUTHORING_MANIFEST = {
         },
         {
             operationId: 'column.header.set',
-            title: 'Definir cabeçalho',
+            title: 'Renomear o título da coluna sem alterar valores das células',
             scope: 'column',
             targetKind: 'column',
             target: { kind: 'column', resolver: 'column-by-field', ambiguityPolicy: 'fail', required: true },
@@ -59610,7 +59727,7 @@ const PRAXIS_TABLE_AUTHORING_MANIFEST = {
         },
         {
             operationId: 'column.valueMapping.set',
-            title: 'Definir mapeamento de valores',
+            title: 'Mapear valores exibidos nas células sem renomear a coluna',
             scope: 'column',
             targetKind: 'column',
             target: { kind: 'column', resolver: 'column-by-field', ambiguityPolicy: 'fail', required: true },
@@ -59627,7 +59744,7 @@ const PRAXIS_TABLE_AUTHORING_MANIFEST = {
         },
         {
             operationId: 'column.order.set',
-            title: 'Definir ordem visual',
+            title: 'Mover coluna inteira sem alterar o conteúdo da célula',
             scope: 'column',
             targetKind: 'column',
             target: { kind: 'column', resolver: 'column-by-field', ambiguityPolicy: 'fail', required: true },
@@ -59644,7 +59761,8 @@ const PRAXIS_TABLE_AUTHORING_MANIFEST = {
         },
         {
             operationId: 'column.visibility.set',
-            title: 'Definir visibilidade',
+            title: 'Mostrar ou ocultar coluna independente sem excluí-la',
+            description: 'Altera somente a visibilidade da coluna-alvo. Quando um pedido incorpora o conteúdo de uma coluna em outra célula e também diz que a coluna de origem não deve continuar separada, esta operação complementa a composição do renderer.',
             scope: 'column',
             targetKind: 'column',
             target: { kind: 'column', resolver: 'column-by-field', ambiguityPolicy: 'fail', required: true },
@@ -59686,7 +59804,8 @@ const PRAXIS_TABLE_AUTHORING_MANIFEST = {
         },
         {
             operationId: 'column.renderer.set',
-            title: 'Definir renderizador',
+            title: 'Compor ou definir o conteúdo visual dentro da célula',
+            description: 'Define ou substitui o renderer raiz da célula. Para mudar somente direção, alinhamento, espaçamento ou quebra de um compose existente, use column.renderer.composeLayout.set. Para mudar somente tamanho, forma ou outra propriedade de um item existente, use column.renderer.composeItem.set. Esta operação não oculta uma coluna de origem; quando o mesmo pedido exige que essa origem deixe de aparecer separadamente, combine-a com column.visibility.set.',
             scope: 'column',
             targetKind: 'renderer',
             target: { kind: 'renderer', resolver: 'renderer-in-column', ambiguityPolicy: 'fail', required: true },
@@ -59697,6 +59816,66 @@ const PRAXIS_TABLE_AUTHORING_MANIFEST = {
             submissionImpact: 'visual-only',
             preconditions: ['config-initialized', 'target-exists']
         },
+        {
+            operationId: 'column.renderer.composeLayout.set',
+            title: 'Refinar somente o layout de uma célula composta',
+            description: 'Altera direção, alinhamento, espaçamento, quebra ou ellipsis do layout de renderer.type compose já existente. Preserva o discriminator compose, a ordem, a configuração e todos os itens atuais; não reconstrua os itens para uma mudança somente de layout.',
+            scope: 'column',
+            targetKind: 'renderer',
+            target: { kind: 'renderer', resolver: 'renderer-in-column', ambiguityPolicy: 'fail', required: true },
+            inputSchema: rendererComposeLayoutSchema,
+            effects: [{
+                    kind: 'compile-domain-patch',
+                    handler: 'table-renderer-compose-layout-merge',
+                    path: 'columns[].renderer.compose.layout'
+                }],
+            validators: [
+                'target-column-exists',
+                'renderer-compose-exists',
+                'editor-round-trip-preserve'
+            ],
+            affectedPaths: ['columns[].renderer.compose.layout'],
+            submissionImpact: 'visual-only',
+            preconditions: ['config-initialized', 'target-exists']
+        },
+        {
+            operationId: 'column.renderer.composeItem.set',
+            title: 'Refinar somente um item existente da célula composta',
+            description: 'Altera um único item já materializado em renderer.type compose, preservando o discriminator compose, o layout, a ordem e todos os itens irmãos. Use itemType para resolver o item; quando houver mais de um item do mesmo tipo, informe itemField para desambiguar.',
+            scope: 'column',
+            targetKind: 'renderer',
+            target: { kind: 'renderer', resolver: 'renderer-in-column', ambiguityPolicy: 'fail', required: true },
+            inputSchema: {
+                type: 'object',
+                required: ['itemType', 'item'],
+                properties: {
+                    itemType: {
+                        enum: ['value', 'icon', 'image', 'badge', 'link', 'button', 'chip', 'progress', 'avatar', 'toggle', 'menu', 'rating', 'html'],
+                        description: 'Discriminator canônico do item existente que será refinado.'
+                    },
+                    itemField: {
+                        type: 'string',
+                        description: 'Campo estável do item quando itemType sozinho não o identifica de forma única.'
+                    },
+                    item: rendererComposeItemSchema
+                }
+            },
+            effects: [{
+                    kind: 'compile-domain-patch',
+                    handler: 'table-renderer-compose-item-merge',
+                    path: 'columns[].renderer.compose.items[]'
+                }],
+            validators: [
+                'target-column-exists',
+                'renderer-compose-item-exists',
+                'renderer-type-supported',
+                'renderer-config-match',
+                'editor-round-trip-preserve'
+            ],
+            affectedPaths: ['columns[].renderer.compose.items[]'],
+            submissionImpact: 'visual-only',
+            preconditions: ['config-initialized', 'target-exists']
+        },
         {
             operationId: 'column.conditionalRenderer.add',
             title: 'Adicionar renderizador condicional',
@@ -60796,6 +60975,18 @@ const PRAXIS_TABLE_AUTHORING_MANIFEST = {
             code: 'TB004',
             description: 'A configuração do renderizador deve corresponder ao tipo selecionado.'
         },
+        {
+            validatorId: 'renderer-compose-exists',
+            level: 'error',
+            code: 'TB022',
+            description: 'O renderer alvo deve ser uma composição existente e conter ao menos um item antes de refinar seu layout.'
+        },
+        {
+            validatorId: 'renderer-compose-item-exists',
+            level: 'error',
+            code: 'TB021',
+            description: 'O renderer alvo deve ser compose e conter exatamente um item compatível com itemType e itemField.'
+        },
         {
             validatorId: 'grouping-fields-exist',
             level: 'error',
@@ -61022,6 +61213,36 @@ const PRAXIS_TABLE_AUTHORING_MANIFEST = {
             params: { field: 'email', header: 'Contato', type: 'string' },
             isPositive: true
         },
+        {
+            id: 'rename-active-column-to-status',
+            request: 'Ativo vira Status.',
+            operationId: 'column.header.set',
+            target: 'ativo',
+            params: { header: 'Status' },
+            isPositive: true
+        },
+        {
+            id: 'rename-column-title-without-changing-cell-values',
+            request: 'Troque somente o título da coluna Ativo para Status, sem alterar os valores das células',
+            operationId: 'column.header.set',
+            target: 'ativo',
+            params: { header: 'Status' },
+            isPositive: true
+        },
+        {
+            id: 'cell-value-mapping-is-not-header-renaming',
+            request: 'Sem mudar o título da coluna Ativo, mostre Sim e Não no lugar dos valores das células',
+            operationId: 'column.header.set',
+            target: 'ativo',
+            isPositive: false
+        },
+        {
+            id: 'current-column-label-is-not-a-rename-request',
+            request: 'Na coluna chamada Status, mostre um chip vermelho quando o valor estiver inativo',
+            operationId: 'column.header.set',
+            target: 'ativo',
+            isPositive: false
+        },
         {
             id: 'add-computed-column',
             request: 'Criar coluna de idade baseada na data de nascimento',
@@ -61046,6 +61267,29 @@ const PRAXIS_TABLE_AUTHORING_MANIFEST = {
             },
             isPositive: true
         },
+        {
+            id: 'set-active-base-chip-for-status-pair',
+            request: 'Na coluna Status, use chip verde quando ativo e chip vermelho quando inativo sem alterar as outras colunas',
+            operationId: 'column.renderer.set',
+            target: 'ativo',
+            params: {
+                type: 'chip',
+                chip: { textField: 'ativo', color: 'success', variant: 'filled' }
+            },
+            isPositive: true
+        },
+        {
+            id: 'add-inactive-conditional-chip',
+            request: 'Na coluna Status, use chip verde quando ativo e chip vermelho quando inativo sem alterar as outras colunas',
+            operationId: 'column.conditionalRenderer.add',
+            target: 'ativo',
+            params: {
+                id: 'chip-inativo',
+                condition: { "==": [{ "var": "ativo" }, false] },
+                renderer: { type: 'chip', chip: { text: 'Inativo', color: 'warn', variant: 'filled' } }
+            },
+            isPositive: true
+        },
         {
             id: 'enable-export',
             request: 'Habilitar exportação para Excel e PDF',
@@ -61094,6 +61338,84 @@ const PRAXIS_TABLE_AUTHORING_MANIFEST = {
             params: { type: 'icon', image: { src: '...' } },
             isPositive: false
         },
+        {
+            id: 'compose-photo-and-code-in-code-cell',
+            request: 'Na coluna Código, mostrar primeiro a foto e depois o código na mesma célula, sem manter Foto como coluna separada',
+            operationId: 'column.renderer.set',
+            target: 'codigo',
+            params: {
+                type: 'compose',
+                compose: {
+                    items: [
+                        {
+                            type: 'avatar',
+                            avatar: {
+                                srcField: 'foto',
+                                altField: 'nome',
+                                initialsField: 'nome',
+                                shape: 'rounded',
+                                size: 32
+                            }
+                        },
+                        { type: 'value', field: 'codigo' }
+                    ],
+                    layout: { direction: 'row', align: 'center', gap: 8 }
+                }
+            },
+            isPositive: true
+        },
+        {
+            id: 'stack-existing-photo-and-code-vertically',
+            request: 'No composto anterior, deixe em duas linhas: foto em cima e código embaixo',
+            operationId: 'column.renderer.composeLayout.set',
+            target: 'codigo',
+            params: { direction: 'column' },
+            isPositive: true
+        },
+        {
+            id: 'grow-photo-inside-existing-compose',
+            request: 'Aumente um pouco somente a foto dessa célula composta, sem mudar os outros itens',
+            operationId: 'column.renderer.composeItem.set',
+            target: 'codigo',
+            params: {
+                itemType: 'avatar',
+                item: { type: 'avatar', avatar: { srcField: 'foto', initialsField: 'nome', shape: 'rounded', size: 40 } }
+            },
+            isPositive: true
+        },
+        {
+            id: 'shrink-photo-inside-existing-compose',
+            request: 'Diminua só essa foto; ela está grande demais, e preserve o restante',
+            operationId: 'column.renderer.composeItem.set',
+            target: 'codigo',
+            params: {
+                itemType: 'avatar',
+                item: { type: 'avatar', avatar: { srcField: 'foto', initialsField: 'nome', shape: 'rounded', size: 24 } }
+            },
+            isPositive: true
+        },
+        {
+            id: 'make-photo-circular-inside-existing-compose',
+            request: 'Deixe somente a foto dessa célula composta circular, sem alterar tamanho, layout ou os outros itens',
+            operationId: 'column.renderer.composeItem.set',
+            target: 'codigo',
+            params: {
+                itemType: 'avatar',
+                item: { type: 'avatar', avatar: { srcField: 'foto', initialsField: 'nome', shape: 'circle', size: 24 } }
+            },
+            isPositive: true
+        },
+        {
+            id: 'set-composed-photo-rounded-square-after-correction',
+            request: 'Deixe a foto circular... não, cancela essa parte: quero quadrada com cantos arredondados',
+            operationId: 'column.renderer.composeItem.set',
+            target: 'codigo',
+            params: {
+                itemType: 'avatar',
+                item: { type: 'avatar', avatar: { srcField: 'foto', initialsField: 'nome', shape: 'rounded', size: 24 } }
+            },
+            isPositive: true
+        },
         {
             id: 'set-button-renderer',
             request: 'Transformar a coluna acoes em botao que executa abrir-detalhe',
@@ -61186,14 +61508,37 @@ const PRAXIS_TABLE_AUTHORING_MANIFEST = {
             params: { visible: false },
             isPositive: true
         },
+        {
+            id: 'hide-source-column-after-cell-composition',
+            request: 'Na coluna Código, mostrar primeiro a foto e depois o código na mesma célula, sem manter Foto como coluna separada',
+            operationId: 'column.visibility.set',
+            target: 'foto',
+            params: { visible: false },
+            isPositive: true
+        },
+        {
+            id: 'move-whole-photo-column-before-code',
+            request: 'Mover a coluna Foto inteira para antes da coluna Código, mantendo as duas colunas separadas e sem alterar suas células',
+            operationId: 'column.order.set',
+            target: 'foto',
+            params: { order: 0 },
+            isPositive: true
+        },
         {
             id: 'map-active-status-labels',
-            request: 'Mostre Sim e Não na coluna ativo',
+            request: 'Sem mudar o título da coluna Ativo, mostre Sim e Não no lugar dos valores das células',
             operationId: 'column.valueMapping.set',
             target: 'ativo',
             params: { valueMapping: { true: 'Sim', false: 'Não' } },
             isPositive: true
         },
+        {
+            id: 'column-header-renaming-is-not-value-mapping',
+            request: 'Ativo vira Status.',
+            operationId: 'column.valueMapping.set',
+            target: 'ativo',
+            isPositive: false
+        },
         {
             id: 'set-avatar-chip-renderer',
             request: 'Corrija o avatar do funcionário e mantenha o nome como chip',