@praxisui/core 9.0.0-beta.33 → 9.0.0-beta.34

package/README.md

@@ -137,6 +137,7 @@ Core exports schema and metadata infrastructure used by form, table, list, chart
 - JSON Logic models and runtime service
 
 `valuePresentation` is the shared display contract for scalar read-only values such as currency, number, date, datetime, time, percentage, and boolean.
+`presentation` is the shared semantic wrapper contract for presentation-capable consumers. It can request chip, badge, status or iconValue rendering while preserving the raw value used for filtering, sorting and export.
 
 `FieldPresentationConfig` is the shared semantic presentation contract for read-only surfaces that need a visual primitive around the value, such as `chip`, `badge`, `status`, `iconValue`, or `microVisualization`. It keeps business data in the original field and lets consumers map `tone`, `appearance`, `icon`, `tooltip`, and optional fixed `label` values to their own renderer and theme tokens.
 

package/ai/component-registry.json

@@ -1,8 +1,8 @@
 {
   "schemaVersion": "1.0.0",
-  "generatedAt": "2026-07-03T00:15:21.386Z",
+  "generatedAt": "2026-07-03T15:38:25.206Z",
   "packageName": "@praxisui/core",
-  "packageVersion": "9.0.0-beta.33",
+  "packageVersion": "9.0.0-beta.34",
   "sourceRegistry": "praxis-component-registry-ingestion",
   "sourceRegistryVersion": "1.0.0",
   "componentCount": 3,

package/fesm2022/praxisui-core.mjs

@@ -1555,6 +1555,8 @@ function normalizeFieldPresentation(value) {
     const label = normalizeText(value.label);
     const badge = normalizeText(value.badge);
     const tooltip = normalizeText(value.tooltip);
+    const prefix = normalizeText(value.prefix);
+    const suffix = normalizeText(value.suffix);
     const visualization = normalizePraxisPresentationVisualization(value.visualization);
     return {
         ...(presenter ? { presenter } : {}),
@@ -1564,6 +1566,8 @@ function normalizeFieldPresentation(value) {
         ...(label ? { label } : {}),
         ...(badge ? { badge } : {}),
         ...(tooltip ? { tooltip } : {}),
+        ...(prefix ? { prefix } : {}),
+        ...(suffix ? { suffix } : {}),
         ...(value.valuePresentation && typeof value.valuePresentation === 'object'
             ? { valuePresentation: value.valuePresentation }
             : {}),
@@ -6369,6 +6373,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.14", ngImpo
 function buildBaseColumnFromDef(def) {
     const type = resolveColumnTypeFromFieldDefinition(def);
     const format = type === 'string' ? resolveTextMaskFormatFromFieldDefinition(def) : undefined;
+    const renderer = resolveRendererFromFieldPresentation(def);
     return {
         field: def.name,
         header: def.label || def.name,
@@ -6379,6 +6384,7 @@ function buildBaseColumnFromDef(def) {
         resizable: true,
         order: typeof def.order === 'number' ? def.order : undefined,
         ...(format ? { format } : {}),
+        ...(renderer ? { renderer } : {}),
     };
 }
 function applyLocalCustomizations$2(baseCol, localCol) {
@@ -6530,6 +6536,82 @@ function resolveTextMaskFormat(value) {
     const hasInvalidMaskLetters = /[A-WYZa-wyz]/.test(format);
     return hasMaskTokens && !hasInvalidMaskLetters ? format : undefined;
 }
+function resolveRendererFromFieldPresentation(def) {
+    const presentation = def.presentation;
+    if (!presentation || typeof presentation !== 'object')
+        return undefined;
+    const presenter = normalizePresentationToken(presentation.presenter ?? presentation.variant);
+    const color = resolveSemanticPresentationColor(presentation.tone);
+    const variant = resolveSemanticPresentationVariant(presentation.appearance);
+    const icon = firstNonEmptyString(presentation.icon);
+    const tooltipText = firstNonEmptyString(presentation.tooltip);
+    const tooltip = tooltipText ? { text: tooltipText } : undefined;
+    if (presenter === 'chip') {
+        return {
+            type: 'chip',
+            chip: {
+                textField: def.name,
+                ...(color ? { color } : {}),
+                ...(variant ? { variant } : {}),
+                ...(icon ? { icon } : {}),
+                ...(tooltip ? { tooltip } : {}),
+            },
+        };
+    }
+    if (presenter === 'badge' || presenter === 'status') {
+        return {
+            type: 'badge',
+            badge: {
+                textField: def.name,
+                ...(color ? { color } : {}),
+                ...(variant ? { variant } : {}),
+                ...(icon ? { icon } : {}),
+                ...(tooltip ? { tooltip } : {}),
+            },
+        };
+    }
+    if (presenter === 'iconvalue') {
+        const rendererIcon = icon || firstNonEmptyString(def.icon);
+        if (!rendererIcon)
+            return undefined;
+        return {
+            type: 'icon',
+            icon: {
+                name: rendererIcon,
+                textField: def.name,
+                ...(tooltipText ? { ariaLabel: tooltipText } : {}),
+                ...resolveSemanticPresentationAffixes(presentation),
+            },
+        };
+    }
+    return undefined;
+}
+function resolveSemanticPresentationColor(tone) {
+    const normalized = normalizePresentationToken(tone);
+    if (!normalized || normalized === 'neutral')
+        return undefined;
+    return normalized === 'danger' ? 'warn' : normalized;
+}
+function resolveSemanticPresentationVariant(appearance) {
+    const normalized = normalizePresentationToken(appearance);
+    return normalized === 'filled' || normalized === 'outlined' || normalized === 'soft'
+        ? normalized
+        : undefined;
+}
+function resolveSemanticPresentationAffixes(presentation) {
+    const prefix = firstNonEmptyString(presentation.prefix);
+    const suffix = firstNonEmptyString(presentation.suffix);
+    return {
+        ...(prefix ? { prefix } : {}),
+        ...(suffix ? { suffix } : {}),
+    };
+}
+function firstNonEmptyString(value) {
+    if (typeof value !== 'string')
+        return undefined;
+    const trimmed = value.trim();
+    return trimmed ? trimmed : undefined;
+}
 function normalizePresentationToken(value) {
     return String(value ?? '').trim().toLowerCase().replace(/[\s_-]+/g, '');
 }
@@ -23086,6 +23168,22 @@ const FIELD_METADATA_CAPABILITIES = {
             description: 'Marcador secundario opcional exibido junto ao valor em superficies de apresentacao.',
             intentExamples: ['badge alto valor', 'marcador D+35', 'sinalizar revisao executiva'],
         },
+        {
+            path: 'presentation.prefix',
+            category: 'appearance',
+            valueKind: 'string',
+            description: 'Prefixo visual readonly aplicado ao valor apresentado, sem alterar payload, filtros, ordenacao ou exportacao.',
+            safetyNotes: 'Usar apenas para convencoes visuais como codigo operacional com #; nao persistir o prefixo no valor bruto.',
+            intentExamples: ['mostrar codigo com #', 'prefixar protocolo com PR-'],
+        },
+        {
+            path: 'presentation.suffix',
+            category: 'appearance',
+            valueKind: 'string',
+            description: 'Sufixo visual readonly aplicado ao valor apresentado, sem alterar payload, filtros, ordenacao ou exportacao.',
+            safetyNotes: 'Usar apenas para convencoes visuais; unidades semanticas numericas devem preferir valuePresentation quando aplicavel.',
+            intentExamples: ['sufixo visual de referencia', 'mostrar unidade textual curta'],
+        },
         {
             path: 'presentation.valuePresentation',
             category: 'appearance',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@praxisui/core",
-  "version": "9.0.0-beta.33",
+  "version": "9.0.0-beta.34",
   "description": "Core library for Praxis UI Workspace: types, tokens, services and utilities shared across @praxisui/* packages.",
   "peerDependencies": {
     "@angular/common": "^21.0.0",

package/types/praxisui-core.d.ts

@@ -1470,12 +1470,20 @@ interface ColumnDefinition {
             name?: string;
             /** Campo do row que contém o nome do ícone */
             nameField?: string;
+            /** Texto fixo exibido ao lado do icone */
+            text?: string;
+            /** Campo usado como texto exibido ao lado do icone */
+            textField?: string;
             /** Cor do ícone (primary/accent/warn ou CSS color) */
             color?: string;
             /** Tamanho em px (opcional) */
             size?: number;
             /** Label acessível (fixo) */
             ariaLabel?: string;
+            /** Prefixo visual aplicado ao texto do renderer sem alterar o valor bruto. */
+            prefix?: string;
+            /** Sufixo visual aplicado ao texto do renderer sem alterar o valor bruto. */
+            suffix?: string;
         };
         /** Configuração de imagem */
         image?: {
@@ -1606,9 +1614,13 @@ interface ColumnDefinition {
                 icon?: {
                     name?: string;
                     nameField?: string;
+                    text?: string;
+                    textField?: string;
                     color?: string;
                     size?: number;
                     ariaLabel?: string;
+                    prefix?: string;
+                    suffix?: string;
                 };
             } | {
                 type: 'image';
@@ -3506,69 +3518,6 @@ interface ResolvedValuePresentation {
     dateTime?: DateTimeLocaleConfig;
 }
 
-type FieldPresentationTone = 'neutral' | 'info' | 'success' | 'warning' | 'danger';
-type FieldPresentationAppearance = 'plain' | 'soft' | 'outlined' | 'filled';
-type FieldPresenterKind = 'text' | 'badge' | 'chip' | 'status' | 'iconValue' | 'progress' | 'rating' | 'microVisualization';
-interface FieldPresentationInteractions {
-    /** Allows readonly surfaces to expose a copy affordance without changing the field value. */
-    copy?: boolean;
-    /** Allows readonly surfaces to expose contextual detail expansion. */
-    details?: boolean;
-    /** Allows readonly surfaces to expose inline expansion for long values. */
-    expand?: boolean;
-    /** Allows readonly surfaces to expose a link affordance when the value is navigable. */
-    link?: boolean;
-}
-interface FieldPresentationConfig {
-    /** Semantic display strategy for readonly/presentation surfaces. */
-    presenter?: FieldPresenterKind;
-    /** Alias accepted for schema authors that describe the semantic display as a variant. */
-    variant?: FieldPresenterKind;
-    /** Semantic tone mapped by consumers to theme tokens. */
-    tone?: FieldPresentationTone;
-    /** Material Symbols icon name, without arbitrary HTML. */
-    icon?: string;
-    /** Optional semantic label for status/chip/badge presentations. */
-    label?: string;
-    /** Optional secondary marker rendered by presentation-capable consumers. */
-    badge?: string;
-    /** Optional tooltip text for the presentation wrapper. */
-    tooltip?: string;
-    /** Visual density/emphasis strategy mapped by consumers to theme tokens. */
-    appearance?: FieldPresentationAppearance;
-    /** Optional formatter override for the presentation surface only. */
-    valuePresentation?: ValuePresentationConfig;
-    /** Renderer-neutral micro visualization metadata for compact presentation surfaces. */
-    visualization?: PraxisPresentationVisualizationConfig;
-    /** Safe readonly affordances. No commands or mutations are executed from this contract. */
-    interactions?: FieldPresentationInteractions;
-}
-interface FieldPresentationRule {
-    /** Json Logic guard evaluated against the presentation context. */
-    when: JsonLogicExpression;
-    /** Semantic presentation state merged when the guard is truthy. */
-    set?: FieldPresentationConfig;
-    /** Alias for `set`, useful for rule-builder terminology. */
-    effect?: FieldPresentationConfig;
-}
-interface ResolvedFieldPresentation extends FieldPresentationConfig {
-    /** Indicates at least one conditional rule matched the current context. */
-    matchedRule?: boolean;
-}
-interface FieldPresentationJsonLogicEvaluator {
-    evaluate(expression: JsonLogicExpression, data: JsonLogicDataRecord): unknown;
-    truthy?(value: unknown): boolean;
-}
-interface ResolveFieldPresentationOptions {
-    jsonLogic?: FieldPresentationJsonLogicEvaluator | null;
-}
-/**
- * Resolves readonly field presentation from a base semantic config plus ordered
- * Json Logic rules. Later matching rules override earlier presentation values.
- */
-declare function resolveFieldPresentation(base: FieldPresentationConfig | null | undefined, rules: readonly FieldPresentationRule[] | null | undefined, context?: JsonLogicDataRecord, options?: ResolveFieldPresentationOptions): ResolvedFieldPresentation;
-declare function normalizeFieldPresentation(value: FieldPresentationConfig | null | undefined): ResolvedFieldPresentation;
-
 /**
  * Enum que define os tipos de dados (`TYPE`) disponíveis para configuração dos campos de formulário.
  */
@@ -3752,6 +3701,73 @@ interface FormHelpPresentationConfig {
     preferPopoverForControls?: string[];
 }
 
+type FieldPresentationTone = 'neutral' | 'info' | 'success' | 'warning' | 'danger';
+type FieldPresentationAppearance = 'plain' | 'soft' | 'outlined' | 'filled';
+type FieldPresenterKind = 'text' | 'badge' | 'chip' | 'status' | 'iconValue' | 'progress' | 'rating' | 'microVisualization';
+interface FieldPresentationInteractions {
+    /** Allows readonly surfaces to expose a copy affordance without changing the field value. */
+    copy?: boolean;
+    /** Allows readonly surfaces to expose contextual detail expansion. */
+    details?: boolean;
+    /** Allows readonly surfaces to expose inline expansion for long values. */
+    expand?: boolean;
+    /** Allows readonly surfaces to expose a link affordance when the value is navigable. */
+    link?: boolean;
+}
+interface FieldPresentationConfig {
+    /** Semantic display strategy for readonly/presentation surfaces. */
+    presenter?: FieldPresenterKind;
+    /** Alias accepted for schema authors that describe the semantic display as a variant. */
+    variant?: FieldPresenterKind;
+    /** Semantic tone mapped by consumers to theme tokens. */
+    tone?: FieldPresentationTone;
+    /** Material Symbols icon name, without arbitrary HTML. */
+    icon?: string;
+    /** Optional semantic label for status/chip/badge presentations. */
+    label?: string;
+    /** Optional secondary marker rendered by presentation-capable consumers. */
+    badge?: string;
+    /** Optional tooltip text for the presentation wrapper. */
+    tooltip?: string;
+    /** Optional readonly prefix rendered next to the displayed value without changing the raw value. */
+    prefix?: string;
+    /** Optional readonly suffix rendered next to the displayed value without changing the raw value. */
+    suffix?: string;
+    /** Visual density/emphasis strategy mapped by consumers to theme tokens. */
+    appearance?: FieldPresentationAppearance;
+    /** Optional formatter override for the presentation surface only. */
+    valuePresentation?: ValuePresentationConfig;
+    /** Renderer-neutral micro visualization metadata for compact presentation surfaces. */
+    visualization?: PraxisPresentationVisualizationConfig;
+    /** Safe readonly affordances. No commands or mutations are executed from this contract. */
+    interactions?: FieldPresentationInteractions;
+}
+interface FieldPresentationRule {
+    /** Json Logic guard evaluated against the presentation context. */
+    when: JsonLogicExpression;
+    /** Semantic presentation state merged when the guard is truthy. */
+    set?: FieldPresentationConfig;
+    /** Alias for `set`, useful for rule-builder terminology. */
+    effect?: FieldPresentationConfig;
+}
+interface ResolvedFieldPresentation extends FieldPresentationConfig {
+    /** Indicates at least one conditional rule matched the current context. */
+    matchedRule?: boolean;
+}
+interface FieldPresentationJsonLogicEvaluator {
+    evaluate(expression: JsonLogicExpression, data: JsonLogicDataRecord): unknown;
+    truthy?(value: unknown): boolean;
+}
+interface ResolveFieldPresentationOptions {
+    jsonLogic?: FieldPresentationJsonLogicEvaluator | null;
+}
+/**
+ * Resolves readonly field presentation from a base semantic config plus ordered
+ * Json Logic rules. Later matching rules override earlier presentation values.
+ */
+declare function resolveFieldPresentation(base: FieldPresentationConfig | null | undefined, rules: readonly FieldPresentationRule[] | null | undefined, context?: JsonLogicDataRecord, options?: ResolveFieldPresentationOptions): ResolvedFieldPresentation;
+declare function normalizeFieldPresentation(value: FieldPresentationConfig | null | undefined): ResolvedFieldPresentation;
+
 /**
  * @fileoverview Base metadata interfaces for dynamic Angular Material components
  *
@@ -4474,7 +4490,10 @@ interface FieldDefinition {
     filterOptions?: any[];
     numericFormat?: string;
     valuePresentation?: ValuePresentationConfig;
+    /** Semantic read-only/list presentation metadata from canonical x-ui.presentation. */
     presentation?: FieldPresentationConfig;
+    /** Conditional presentation overrides for read-only/list consumers. */
+    presentationRules?: FieldPresentationRule[];
     numericStep?: number;
     numericMin?: number;
     numericMax?: number;