@praxisui/table 10.0.0-rc.27 → 10.0.0-rc.29

package/fesm2022/{praxisui-table-table-agentic-authoring-turn-flow-CtHAHd7Y.mjs → praxisui-table-table-agentic-authoring-turn-flow-BbqceuRl.mjs}

@@ -1,6 +1,6 @@
 import { Observable, firstValueFrom } from 'rxjs';
 import { withAuthoringScopePolicy } from '@praxisui/ai';
-import { ar as setTableActionGlobalActionRef } from './praxisui-table-praxisui-table-CosVmN5P.mjs';
+import { ar as setTableActionGlobalActionRef } from './praxisui-table-praxisui-table-By0aZFU7.mjs';
 
 class TableAgenticAuthoringTurnFlow {
     adapter;

package/fesm2022/{praxisui-table-table-ai.adapter-DYY3eUYu.mjs → praxisui-table-table-ai.adapter-DIf5nJOG.mjs}

@@ -1,7 +1,7 @@
 import { firstValueFrom } from 'rxjs';
 import { BaseAiAdapter, sanitizePraxisAssistantText, createComponentAuthoringContext } from '@praxisui/ai';
 import { PRAXIS_GLOBAL_ACTION_CATALOG, deepMerge } from '@praxisui/core';
-import { W as TABLE_COMPONENT_EDIT_PLAN_OPERATION_IDS, p as PRAXIS_TABLE_AUTHORING_MANIFEST, T as TABLE_AI_CAPABILITIES, a6 as coerceTableComponentEditPlans, a8 as compileTableComponentEditPlans, Y as TASK_PRESETS, ae as getTableComponentEditPlanCapabilities, R as TABLE_COMPONENT_EDIT_PLAN_EXPECTED_PATHS, O as TABLE_COMPONENT_EDIT_PLAN_ALLOWED_CHANGE_KINDS, U as TABLE_COMPONENT_EDIT_PLAN_JSON_SCHEMA, X as TABLE_COMPONENT_EDIT_PLAN_VERSION, Q as TABLE_COMPONENT_EDIT_PLAN_BATCH_KIND, V as TABLE_COMPONENT_EDIT_PLAN_KIND } from './praxisui-table-praxisui-table-CosVmN5P.mjs';
+import { W as TABLE_COMPONENT_EDIT_PLAN_OPERATION_IDS, p as PRAXIS_TABLE_AUTHORING_MANIFEST, T as TABLE_AI_CAPABILITIES, a6 as coerceTableComponentEditPlans, a8 as compileTableComponentEditPlans, Y as TASK_PRESETS, ae as getTableComponentEditPlanCapabilities, R as TABLE_COMPONENT_EDIT_PLAN_EXPECTED_PATHS, O as TABLE_COMPONENT_EDIT_PLAN_ALLOWED_CHANGE_KINDS, U as TABLE_COMPONENT_EDIT_PLAN_JSON_SCHEMA, X as TABLE_COMPONENT_EDIT_PLAN_VERSION, Q as TABLE_COMPONENT_EDIT_PLAN_BATCH_KIND, V as TABLE_COMPONENT_EDIT_PLAN_KIND } from './praxisui-table-praxisui-table-By0aZFU7.mjs';
 
 const TABLE_ROW_EXPRESSION_CONTEXT_OPTION = {
     mode: 'expression',

package/fesm2022/praxisui-table.mjs

@@ -1,2 +1,2 @@
-export { A as ANALYTICS_TABLE_ROW_KEY_FIELD, a as AnalyticalDrawerRegistryService, b as AnalyticsTableConfigAdapterService, c as AnalyticsTableContractService, d as AnalyticsTableStatsApiService, B as BOOLEAN_PRESETS, e as BehaviorConfigEditorComponent, C as CURRENCY_PRESETS, f as ColumnsConfigEditorComponent, D as DATE_PRESETS, g as DataFormatterComponent, h as DataFormattingService, F as FORMULA_TEMPLATES, i as FilterConfigService, j as FilterSettingsComponent, k as FormulaGeneratorService, J as JsonConfigEditorComponent, M as MessagesLocalizationEditorComponent, N as NUMBER_PRESETS, P as PERCENTAGE_PRESETS, l as PRAXIS_ANALYTICAL_DRAWER_SCHEMAS, m as PRAXIS_FILTER_AUTHORING_MANIFEST, n as PRAXIS_FILTER_COMPONENT_METADATA, o as PRAXIS_FILTER_VIEW_CONTEXT_SCHEMA_VERSION, p as PRAXIS_TABLE_AUTHORING_MANIFEST, q as PRAXIS_TABLE_COMPONENT_METADATA, r as PRAXIS_TABLE_TOOLBAR_APPEARANCE_PRESETS, s as PRAXIS_TABLE_TOOLBAR_DEFAULT_APPEARANCE, t as PRAXIS_TABLE_TOOLBAR_TOKEN_PRESETS, u as PraxisAnalyticalDrawerComponent, v as PraxisFilter, w as PraxisFilterOutletComponent, x as PraxisFilterOutletDirective, y as PraxisFilterWidgetConfigEditor, z as PraxisScopeBarComponent, E as PraxisTable, G as PraxisTableConfigEditor, H as PraxisTableInlineAuthoringEditorComponent, I as PraxisTableToolbar, K as PraxisTableWidgetConfigEditor, S as STRING_PRESETS, T as TABLE_AI_CAPABILITIES, L as TABLE_COMPONENT_AI_CAPABILITIES, O as TABLE_COMPONENT_EDIT_PLAN_ALLOWED_CHANGE_KINDS, Q as TABLE_COMPONENT_EDIT_PLAN_BATCH_KIND, R as TABLE_COMPONENT_EDIT_PLAN_EXPECTED_PATHS, U as TABLE_COMPONENT_EDIT_PLAN_JSON_SCHEMA, V as TABLE_COMPONENT_EDIT_PLAN_KIND, X as TABLE_COMPONENT_EDIT_PLAN_VERSION, Y as TASK_PRESETS, Z as TableDefaultsProvider, _ as TableRulesEditorComponent, $ as ToolbarActionsEditorComponent, a0 as ValueMappingEditorComponent, a1 as VisualFormulaBuilderComponent, a2 as analyticsComparisonMetricField, a3 as applyComputedFieldsToRows, a4 as buildTableApplyPlan, a5 as coerceTableComponentEditPlan, a6 as coerceTableComponentEditPlans, a7 as compileTableComponentEditPlan, a8 as compileTableComponentEditPlans, a9 as createTableAuthoringDocument, aa as formatComputedFieldValue, ab as getActionId, ac as getEnum, ad as getTableCapabilities, ae as getTableComponentEditPlanCapabilities, af as interpolateRelationEndpoint, ag as isAnalyticalDrawerSchema, ah as isTableRendererSupportedByRichContentP0, ai as mapTableRendererToRichContentP0, aj as normalizeComputedFieldDefinition, ak as normalizeTableAuthoringDocument, al as parseLegacyOrTableDocument, am as providePraxisAnalyticalDrawerSchemas, an as providePraxisFilterMetadata, ao as providePraxisTableMetadata, ap as providePraxisTableToolbarAppearance, aq as serializeTableAuthoringDocument, as as toCanonicalTableConfig, at as validateTableAuthoringDocument } from './praxisui-table-praxisui-table-CosVmN5P.mjs';
+export { A as ANALYTICS_TABLE_ROW_KEY_FIELD, a as AnalyticalDrawerRegistryService, b as AnalyticsTableConfigAdapterService, c as AnalyticsTableContractService, d as AnalyticsTableStatsApiService, B as BOOLEAN_PRESETS, e as BehaviorConfigEditorComponent, C as CURRENCY_PRESETS, f as ColumnsConfigEditorComponent, D as DATE_PRESETS, g as DataFormatterComponent, h as DataFormattingService, F as FORMULA_TEMPLATES, i as FilterConfigService, j as FilterSettingsComponent, k as FormulaGeneratorService, J as JsonConfigEditorComponent, M as MessagesLocalizationEditorComponent, N as NUMBER_PRESETS, P as PERCENTAGE_PRESETS, l as PRAXIS_ANALYTICAL_DRAWER_SCHEMAS, m as PRAXIS_FILTER_AUTHORING_MANIFEST, n as PRAXIS_FILTER_COMPONENT_METADATA, o as PRAXIS_FILTER_VIEW_CONTEXT_SCHEMA_VERSION, p as PRAXIS_TABLE_AUTHORING_MANIFEST, q as PRAXIS_TABLE_COMPONENT_METADATA, r as PRAXIS_TABLE_TOOLBAR_APPEARANCE_PRESETS, s as PRAXIS_TABLE_TOOLBAR_DEFAULT_APPEARANCE, t as PRAXIS_TABLE_TOOLBAR_TOKEN_PRESETS, u as PraxisAnalyticalDrawerComponent, v as PraxisFilter, w as PraxisFilterOutletComponent, x as PraxisFilterOutletDirective, y as PraxisFilterWidgetConfigEditor, z as PraxisScopeBarComponent, E as PraxisTable, G as PraxisTableConfigEditor, H as PraxisTableInlineAuthoringEditorComponent, I as PraxisTableToolbar, K as PraxisTableWidgetConfigEditor, S as STRING_PRESETS, T as TABLE_AI_CAPABILITIES, L as TABLE_COMPONENT_AI_CAPABILITIES, O as TABLE_COMPONENT_EDIT_PLAN_ALLOWED_CHANGE_KINDS, Q as TABLE_COMPONENT_EDIT_PLAN_BATCH_KIND, R as TABLE_COMPONENT_EDIT_PLAN_EXPECTED_PATHS, U as TABLE_COMPONENT_EDIT_PLAN_JSON_SCHEMA, V as TABLE_COMPONENT_EDIT_PLAN_KIND, X as TABLE_COMPONENT_EDIT_PLAN_VERSION, Y as TASK_PRESETS, Z as TableDefaultsProvider, _ as TableRulesEditorComponent, $ as ToolbarActionsEditorComponent, a0 as ValueMappingEditorComponent, a1 as VisualFormulaBuilderComponent, a2 as analyticsComparisonMetricField, a3 as applyComputedFieldsToRows, a4 as buildTableApplyPlan, a5 as coerceTableComponentEditPlan, a6 as coerceTableComponentEditPlans, a7 as compileTableComponentEditPlan, a8 as compileTableComponentEditPlans, a9 as createTableAuthoringDocument, aa as formatComputedFieldValue, ab as getActionId, ac as getEnum, ad as getTableCapabilities, ae as getTableComponentEditPlanCapabilities, af as interpolateRelationEndpoint, ag as isAnalyticalDrawerSchema, ah as isTableRendererSupportedByRichContentP0, ai as mapTableRendererToRichContentP0, aj as normalizeComputedFieldDefinition, ak as normalizeTableAuthoringDocument, al as parseLegacyOrTableDocument, am as providePraxisAnalyticalDrawerSchemas, an as providePraxisFilterMetadata, ao as providePraxisTableMetadata, ap as providePraxisTableToolbarAppearance, aq as serializeTableAuthoringDocument, as as toCanonicalTableConfig, at as validateTableAuthoringDocument } from './praxisui-table-praxisui-table-By0aZFU7.mjs';
 export { createDynamicRecord, extractRecordId, isDynamicDataRecord, resolveDataField } from '@praxisui/core';

package/package.json

@@ -1,24 +1,24 @@
 {
   "name": "@praxisui/table",
-  "version": "10.0.0-rc.27",
+  "version": "10.0.0-rc.29",
   "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",
     "@angular/platform-browser": "^21.0.0",
-    "@praxisui/ai": "^10.0.0-rc.27",
-    "@praxisui/core": "^10.0.0-rc.27",
-    "@praxisui/dynamic-fields": "^10.0.0-rc.27",
-    "@praxisui/dynamic-form": "^10.0.0-rc.27",
-    "@praxisui/metadata-editor": "^10.0.0-rc.27",
-    "@praxisui/rich-content": "^10.0.0-rc.27",
-    "@praxisui/settings-panel": "^10.0.0-rc.27",
-    "@praxisui/table-rule-builder": "^10.0.0-rc.27",
+    "@praxisui/ai": "^10.0.0-rc.29",
+    "@praxisui/core": "^10.0.0-rc.29",
+    "@praxisui/dynamic-fields": "^10.0.0-rc.29",
+    "@praxisui/dynamic-form": "^10.0.0-rc.29",
+    "@praxisui/metadata-editor": "^10.0.0-rc.29",
+    "@praxisui/rich-content": "^10.0.0-rc.29",
+    "@praxisui/settings-panel": "^10.0.0-rc.29",
+    "@praxisui/table-rule-builder": "^10.0.0-rc.29",
     "@angular/cdk": "^21.0.0",
     "@angular/forms": "^21.0.0",
     "@angular/material": "^21.0.0",
     "@angular/router": "^21.0.0",
-    "@praxisui/dialog": "^10.0.0-rc.27",
+    "@praxisui/dialog": "^10.0.0-rc.29",
     "rxjs": "~7.8.0"
   },
   "dependencies": {

package/src/lib/praxis-table.json-api.md

@@ -1304,6 +1304,8 @@ Em `scroll-auto`, o viewport e uma regiao focalizavel por teclado para que o scr
 | --- | --- | --- | --- | --- | --- |
 | `columns[]` | `TableColumnConfig[]` | Yes | `[]` | Active | Definicao de colunas, renderers e regras de exibicao. |
 | `behavior` | `TableBehaviorConfig` | No | defaults do runtime | Partial | Inclui paginacao, filtro, selecao e expansao por blocos. |
+| `behavior.filtering.advancedFilters.settings.showAddButton` | `boolean` | No | `true` | Active | Controla a exibicao do botao `+` de adicionar campos rapidos (`alwaysVisibleFields`) na barra do `PraxisFilter` embutido. |
+| `behavior.filtering.advancedFilters.settings.showFilterSettings` | `boolean` | No | `isCustomizationAvailable()` | Active | Controla a exibicao da engrenagem de preferencias do `PraxisFilter` embutido; quando `enableCustomization` esta desabilitado, permanece oculta. |
 | `toolbar.actions[]` | `ToolbarActionConfig[]` | No | `[]` | Partial | Acoes de toolbar com roteamento para `toolbarAction` e `bulkAction`. |
 | `toolbar.title` | `string` | No | `undefined` | Active | Titulo renderizado na regiao de identidade da toolbar principal, antes de filtros e acoes. |
 | `toolbar.subtitle` | `string` | No | `undefined` | Active | Texto auxiliar renderizado abaixo do titulo quando houver espaco. |

package/types/praxisui-table.d.ts

@@ -703,6 +703,7 @@ declare class PraxisFilter implements OnInit, OnChanges, AfterViewInit, OnDestro
     changeDebounceMs: number;
     /** Controla a exibição do botão de preferências dentro do filtro */
     showFilterSettings: boolean;
+    private hostShowFilterSettings?;
     /** Controla a exibição do botão de filtro avançado */
     showAdvancedButton: boolean;
     /** Projection of FilterConfig.presentation for standalone and embedded hosts. */
@@ -714,6 +715,7 @@ declare class PraxisFilter implements OnInit, OnChanges, AfterViewInit, OnDestro
     get advancedActionDisplay(): string;
     /** Controla a exibição do botão de adicionar campos */
     showAddButton: boolean;
+    private hostShowAddButton?;
     /** Controla a exibição do botão de limpar filtros */
     showClearButton: boolean;
     /** Controla a exibição do botão de pesquisar/aplicar filtros em fluxos manuais. */
@@ -2099,6 +2101,15 @@ declare class PraxisTable implements OnInit, OnChanges, AfterViewInit, AfterView
     private resolveExpansionDetailTimelineExpressionValue;
     private getExpansionDetailTimelineObjectValue;
     private normalizeExpansionDetailCardGridCardContent;
+    /** `visibleWhen` is canonical Json Logic (object or boolean); string DSL is not a valid rule. */
+    private normalizeExpansionDetailVisibleWhen;
+    /**
+     * Visibility gate for every detail node, including host-mediated ones (cardGrid, list, detailList,
+     * timeline) that are not rendered by PraxisRichContent. Mirrors `PraxisRichContent.evaluateRule`:
+     * same context (`row`, `computed`, `detail`), truthiness of the Json Logic result, fail-closed on error.
+     */
+    isExpansionDetailNodeVisible(node: any, row: any, index: number): boolean;
+    private withExpansionDetailParentVisibleWhen;
     private normalizeExpansionDetailMediaBlockAvatar;
     private normalizeExpansionDetailMediaBlockText;
     private normalizeExpansionDetailMediaBlockMeta;
@@ -2164,6 +2175,7 @@ declare class PraxisTable implements OnInit, OnChanges, AfterViewInit, AfterView
     private mapExpansionDetailNodeToRichContent;
     private mapExpansionDetailMediaBlockNodeToRichContent;
     private mapExpansionDetailCardNodeToRichContent;
+    private expansionDetailVisibleWhenPatch;
     private mapExpansionDetailStackNodeToRichContent;
     private mapExpansionDetailValueNodeToRichContent;
     private mapExpansionDetailTimelineNodeToRichContent;
@@ -2277,6 +2289,7 @@ declare class PraxisTable implements OnInit, OnChanges, AfterViewInit, AfterView
     private showActionFeedbackMessage;
     private emitEventWithActionFeedback;
     private executeConfiguredGlobalAction;
+    private isWritableConfiguredSurfaceOpen;
     private withTableRuntimeContext;
     private resolveTableSurfaceRuntime;
     private executeSurfaceOpen;
@@ -3257,6 +3270,7 @@ type ComposePresetId = 'personAvatar' | 'contactTwoLines' | 'documentEmail' | 's
 declare class ColumnsConfigEditorComponent implements OnInit, OnChanges, OnDestroy {
     private cdr;
     private readonly i18n;
+    private readonly jsonLogic;
     tx(key: string, fallback: string): string;
     readonly ratingAriaLabelPlaceholder: string;
     readonly ratingRendererHint: string;
@@ -3308,7 +3322,8 @@ declare class ColumnsConfigEditorComponent implements OnInit, OnChanges, OnDestr
     getJsonLogicSummary(value: JsonLogicExpression | null | undefined): string;
     private parseJsonLogicText;
     setConditionalOverrideCondition(index: number, raw: string): void;
-    readonly overrideConditionOperators: readonly ["===", "!=", ">", ">=", "<", "<=", "truthy", "falsy"];
+    readonly overrideConditionOperators: readonly ["===", "==", "!==", "!=", ">", ">=", "<", "<=", "truthy", "falsy"];
+    private normalizeConditionFieldName;
     getOverrideConditionField(condition: any): string;
     getOverrideConditionOperator(condition: any): string;
     getOverrideConditionValue(condition: any): string;
@@ -3327,8 +3342,10 @@ declare class ColumnsConfigEditorComponent implements OnInit, OnChanges, OnDestr
         item: any;
         index: number;
     }>;
-    addOverrideComposeItem(type: 'value' | 'badge' | 'icon' | 'chip'): void;
+    addOverrideComposeItem(type: 'value' | 'badge' | 'icon' | 'chip' | 'progress' | 'avatar' | 'link' | 'button' | 'rating' | 'html'): void;
     addOverrideComposeValueItem(): void;
+    moveOverrideComposeItem(index: number, delta: -1 | 1): void;
+    duplicateOverrideComposeItem(index: number): void;
     removeOverrideComposeItem(index: number): void;
     setOverrideComposeItemProp(index: number, path: string, value: any): void;
     setOverrideComposeValueItemField(index: number, field: string): void;
@@ -3492,7 +3509,10 @@ declare class ColumnsConfigEditorComponent implements OnInit, OnChanges, OnDestr
     private stripRowPrefixes;
     private _coerceExpected;
     private getNested;
-    private evaluatePreviewOverrideCondition;
+    private buildPreviewEvaluationContext;
+    evaluatePreviewOverrideCondition(condition: any, row: any): boolean;
+    private mergePreviewRenderer;
+    private hasRenderablePreviewOverride;
     getEffectivePreviewRenderer(row: any): any;
     getPreviewSampleRows(): any[];
     getPreviewRendererType(row: any): 'icon' | 'image' | 'badge' | 'link' | 'button' | 'chip' | 'progress' | 'microVisualization' | 'rating' | 'avatar' | 'toggle' | 'menu' | 'html' | 'compose' | null;
@@ -3512,9 +3532,11 @@ declare class ColumnsConfigEditorComponent implements OnInit, OnChanges, OnDestr
     getPreviewLinkText(row: any): string;
     getPreviewLinkHref(row: any): string | null;
     getPreviewButtonLabel(row: any): string;
-    getPreviewButtonIcon(): string | null;
+    getPreviewButtonIcon(row?: any): string | null;
     getPreviewChipText(row: any): string | null;
+    getPreviewChipIcon(row?: any): string | null;
     getPreviewChipClasses(row?: any): string[];
+    getComposePreviewButtonLabel(item: any, row: any): string;
     getPreviewProgressValue(row: any): number;
     getPreviewMicroVisualizationHtml(row: any): string;
     getMicroVisualizationGuidance(): 'recommended' | 'conditional';
@@ -3547,6 +3569,18 @@ declare class ColumnsConfigEditorComponent implements OnInit, OnChanges, OnDestr
     getComposePreviewIconStyle(item: any, _row: any): Record<string, string> | null;
     getComposePreviewAvatarStyle(item: any): Record<string, string>;
     getComposePreviewAvatarInitials(item: any, row: any): string;
+    getComposePreviewAvatarSrc(item: any, row: any): string | null;
+    getComposePreviewAvatarAlt(item: any, row: any): string;
+    getComposePreviewImageSrc(item: any, row: any): string | null;
+    getComposePreviewImageAlt(item: any, row: any): string;
+    getComposePreviewImageStyle(item: any): Record<string, string>;
+    getComposePreviewProgressColor(item: any): string | null;
+    getComposePreviewHtml(item: any, row: any): string;
+    getComposePreviewToggleState(item: any, row: any): boolean;
+    getComposePreviewMenuCount(item: any, row: any): number;
+    private resolvePreviewSafeSrc;
+    /** Mirrors PraxisTable.getSafeHtml token interpolation: `[[field]]` values are HTML-escaped. */
+    private interpolatePreviewHtml;
     getComposePreviewProgressValue(item: any, row: any): number;
     getComposePreviewRatingValue(item: any, row: any): number;
     getComposePreviewRatingMax(item: any): number;
@@ -3563,7 +3597,9 @@ declare class ColumnsConfigEditorComponent implements OnInit, OnChanges, OnDestr
     getPreviewToggleState(row: any): boolean;
     getPreviewMenuCount(row: any): number;
     getPreviewHtml(row: any): string;
-    trackByIdx: (_: number, item: any) => number;
+    getPreviewProgressColor(row: any): string | null;
+    /** Preview rows are re-cloned on every read; the sample slot index is their stable identity. */
+    trackByIdx: (index: number, _item: unknown) => number;
     private validateMicroVisualizationThresholds;
     private validateRenderer;
     private readonly _emptyMappingRef;
@@ -4475,7 +4511,7 @@ declare class TableDetailTreeDraft {
         depth: number;
     } | undefined;
     move(direction: -1 | 1): void;
-    add(node: Node, nested?: boolean): void;
+    add(node: Node, nested?: boolean): Node | null;
 }
 
 declare class TableDetailEditorComponent implements OnChanges, OnDestroy {
@@ -4492,6 +4528,7 @@ declare class TableDetailEditorComponent implements OnChanges, OnDestroy {
         dirty: boolean;
     }>;
     private readonly i18n;
+    private readonly jsonLogic;
     private baseline?;
     private emitted?;
     private readonly coupledBefore;
@@ -4503,22 +4540,44 @@ declare class TableDetailEditorComponent implements OnChanges, OnDestroy {
     jsonTouched: boolean;
     advanced: boolean;
     preset: string;
+    /** True when the last "add inside" was refused because the block cannot live inside a card grid card. */
+    addRejected: boolean;
     readonly presets: string[];
     readonly sourceModes: string[];
     readonly resourceKinds: string[];
     readonly resourcePathMethods: string[];
     readonly cardGridColumnOptions: Array<'auto' | 1 | 2 | 3 | 4>;
+    readonly cardVariants: Array<'outlined' | 'elevated' | 'filled' | 'soft'>;
+    readonly cardSizes: Array<'sm' | 'md' | 'lg'>;
+    readonly cardDensities: Array<'compact' | 'comfortable' | 'spacious'>;
+    readonly composeLayouts: Array<'flex' | 'grid'>;
     readonly composeDirections: Array<'row' | 'column'>;
-    readonly composeGaps: Array<'xs' | 'sm' | 'md' | 'lg'>;
-    readonly semanticTones: Array<'' | 'neutral' | 'info' | 'primary' | 'success' | 'warning' | 'danger'>;
+    readonly composeGaps: Array<'xs' | 'sm' | 'md' | 'lg' | 'xl'>;
+    readonly composeAlignItemsOptions: Array<'' | 'flex-start' | 'center' | 'flex-end' | 'stretch'>;
+    readonly badgePresetOptions: Array<'default' | 'softPill' | 'solidPill' | 'outlinedTag' | 'compactSquare' | 'custom'>;
+    readonly iconSurfacePresetOptions: Array<'none' | 'softTile' | 'circleBadge' | 'outlinedTile' | 'elevatedTile' | 'custom'>;
+    readonly semanticTones: Array<'' | 'neutral' | 'info' | 'primary' | 'secondary' | 'tertiary' | 'success' | 'warning' | 'danger'>;
     readonly conditionOperators: Array<'===' | '!=' | '>' | '>=' | '<' | '<=' | 'truthy' | 'falsy'>;
     fallbackModes(): string[];
     sample: 'A' | 'B' | 'C';
     get previewContext(): {
         row: Record<string, unknown>;
     };
+    private projectDetailNodeToRichBlockNodes;
     /** Local presenter projection only; never used as an authoring/save source. */
     previewNodes(): RichBlockNode[];
+    /**
+     * Returns structured preview groups so `cardGrid` blocks render with their real
+     * multi-column CSS Grid (`columns` and `minCardWidth`) and headers in the preview canvas.
+     */
+    previewCardGridGroups(): Array<{
+        isCardGrid: boolean;
+        title?: string;
+        subtitle?: string;
+        gridTemplateColumns?: string;
+        cards?: RichBlockNode[];
+        nodes?: RichBlockNode[];
+    }>;
     previewRichContentDocuments(): RichContentDocument[];
     richContentEditorInputs(): PraxisRichContentEditorInputs | null;
     applyRichContentEditor(): void;
@@ -4576,13 +4635,41 @@ declare class TableDetailEditorComponent implements OnChanges, OnDestroy {
     setCardGridColumns(value: 'auto' | 1 | 2 | 3 | 4): void;
     cardGridMinWidthValue(): number;
     setCardGridMinWidth(value: number | string): void;
+    cardVariantValue(): 'outlined' | 'elevated' | 'filled' | 'soft';
+    setCardVariant(variant: 'outlined' | 'elevated' | 'filled' | 'soft'): void;
+    cardSizeValue(): 'sm' | 'md' | 'lg';
+    setCardSize(size: 'sm' | 'md' | 'lg'): void;
+    cardDensityValue(): 'compact' | 'comfortable' | 'spacious';
+    setCardDensity(density: 'compact' | 'comfortable' | 'spacious'): void;
+    composeLayoutValue(): 'flex' | 'grid';
+    setComposeLayout(layout: 'flex' | 'grid'): void;
     composeDirectionValue(): 'row' | 'column';
     setComposeDirection(direction: 'row' | 'column'): void;
-    composeGapValue(): 'xs' | 'sm' | 'md' | 'lg';
-    setComposeGap(gap: 'xs' | 'sm' | 'md' | 'lg'): void;
+    composeGapValue(): 'xs' | 'sm' | 'md' | 'lg' | 'xl';
+    setComposeGap(gap: 'xs' | 'sm' | 'md' | 'lg' | 'xl'): void;
+    composeAlignItemsValue(): '' | 'flex-start' | 'center' | 'flex-end' | 'stretch';
+    setComposeAlignItems(align: '' | 'flex-start' | 'center' | 'flex-end' | 'stretch'): void;
+    composeWrapValue(): boolean;
+    setComposeWrap(wrap: boolean): void;
     supportsTone(): boolean;
     toneValue(): string;
     setTone(tone: string): void;
+    supportsStyleControls(): boolean;
+    nodeStyleValue(key: string): string;
+    setNodeStyleValue(key: string, value: string): void;
+    hasNodeAppearanceOverrides(): boolean;
+    resetNodeAppearance(): void;
+    badgeAppearancePreset(): 'default' | 'softPill' | 'solidPill' | 'outlinedTag' | 'compactSquare' | 'custom';
+    applyBadgeAppearancePreset(preset: 'default' | 'softPill' | 'solidPill' | 'outlinedTag' | 'compactSquare' | 'custom'): void;
+    iconSurfacePreset(): 'none' | 'softTile' | 'circleBadge' | 'outlinedTile' | 'elevatedTile' | 'custom';
+    applyIconSurfacePreset(preset: 'none' | 'softTile' | 'circleBadge' | 'outlinedTile' | 'elevatedTile' | 'custom'): void;
+    canConvertSelectedToRichContent(): boolean;
+    /**
+     * Losslessly converts the selected `cardGrid` or `card` block (or its parent `cardGrid`
+     * when a card inside `cardGrid.cards` is selected) into a canonical `richContent` node
+     * so the user can continue authoring in the full embedded `PraxisRichContentConfigEditor`.
+     */
+    convertSelectedToRichContent(): void;
     supportsVisibleWhen(): boolean;
     visibleWhenMode(): 'always' | 'conditional' | 'custom';
     setVisibleWhenMode(mode: 'always' | 'conditional' | 'custom'): void;
@@ -4598,6 +4685,9 @@ declare class TableDetailEditorComponent implements OnChanges, OnDestroy {
     private parseGuidedVisibleWhen;
     private isPreviewNodeVisible;
     private commitTree;
+    /** Offered next to `cardGridContent`/`composeContent` issues: converts legacy fields into canonical presenters. */
+    canNormalizeRichChildren(): boolean;
+    normalizeRichChildren(): void;
     editJson(value: string): void;
     discard(): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<TableDetailEditorComponent, never>;