@praxisui/core 9.0.0-beta.13 → 9.0.0-beta.14

package/ai/component-registry.json

@@ -1,8 +1,8 @@
 {
   "schemaVersion": "1.0.0",
-  "generatedAt": "2026-06-22T22:56:44.148Z",
+  "generatedAt": "2026-06-24T01:01:47.814Z",
   "packageName": "@praxisui/core",
-  "packageVersion": "9.0.0-beta.13",
+  "packageVersion": "9.0.0-beta.14",
   "sourceRegistry": "praxis-component-registry-ingestion",
   "sourceRegistryVersion": "1.0.0",
   "componentCount": 3,

package/fesm2022/praxisui-core.mjs

@@ -2020,6 +2020,9 @@ class SchemaNormalizerService {
             if (ui.helpText !== undefined) {
                 field.helpText = String(ui.helpText);
             }
+            if (ui.tooltip !== undefined) {
+                field.tooltip = String(ui.tooltip);
+            }
             if (ui.hint !== undefined) {
                 field.hint = ui.hint;
             }
@@ -9606,9 +9609,25 @@ function mapFieldDefinitionToMetadata(field) {
         metadata.maxLength = field.maxLength;
     if (field.pattern !== undefined)
         metadata.pattern = field.pattern;
+    if (field.helpText !== undefined) {
+        metadata.helpText = field.helpText;
+    }
     if (field.hint || field.helpText) {
         metadata.hint = field.hint ?? field.helpText;
     }
+    if (field.tooltipOnHover !== undefined) {
+        metadata.tooltipOnHover = field.tooltipOnHover;
+        const tooltip = field.tooltip ??
+            (field.tooltipOnHover === true
+                ? field.description ?? field.helpText ?? field.hint
+                : undefined);
+        if (tooltip !== undefined && tooltip !== null) {
+            metadata.tooltip = String(tooltip);
+        }
+    }
+    else if (field.tooltip !== undefined) {
+        metadata.tooltip = String(field.tooltip);
+    }
     if (field.hiddenCondition !== undefined) {
         metadata.hiddenCondition = field.hiddenCondition;
     }
@@ -16502,6 +16521,37 @@ function normalizeSelectLike(meta) {
     return m;
 }
 
+const SERVER_OWNED_FIELD_SEMANTIC_KEYS = [
+    'label',
+    'hint',
+    'helpText',
+    'description',
+    'tooltip',
+    'tooltipOnHover',
+    'icon',
+    'prefixIcon',
+    'suffixIcon',
+    'iconPosition',
+    'iconSize',
+    'iconColor',
+    'iconClass',
+    'iconStyle',
+    'iconFontSize',
+];
+function applyServerOwnedFieldSemantics(merged, serverField) {
+    const next = { ...merged };
+    const server = serverField;
+    for (const key of SERVER_OWNED_FIELD_SEMANTIC_KEYS) {
+        if (server[key] === undefined) {
+            delete next[key];
+        }
+        else {
+            next[key] = server[key];
+        }
+    }
+    return next;
+}
+
 function createDefaultFormConfig() {
     const config = {
         sections: [
@@ -16664,7 +16714,7 @@ function syncWithServerMetadata(localConfig, serverMetadata) {
             toggleOptions: pick('toggleOptions'),
             nodes: pick('nodes'),
         };
-        mergedOverlapping.push(merged);
+        mergedOverlapping.push(applyServerOwnedFieldSemantics(merged, serverField));
         // Track simple modifications for diagnostics
         ['label', 'required', 'maxLength', 'minLength', 'dataType', 'controlType'].forEach((prop) => {
             if (loc[prop] !== base[prop]) {
@@ -21304,6 +21354,13 @@ const FIELD_METADATA_CAPABILITIES = {
             description: 'Texto de ajuda exibido abaixo do campo.',
             intentExamples: ['colocar dica', 'ajuda no rodapé do campo'],
         },
+        {
+            path: 'helpText',
+            category: 'identity',
+            valueKind: 'string',
+            description: 'Texto semântico de ajuda publicado pelo schema/DTO.',
+            intentExamples: ['explicar regra de negócio do campo', 'ajuda vinda do backend'],
+        },
         {
             path: 'tooltip',
             category: 'identity',
@@ -21311,6 +21368,13 @@ const FIELD_METADATA_CAPABILITIES = {
             description: 'Texto exibido ao passar o mouse.',
             intentExamples: ['adicionar tooltip'],
         },
+        {
+            path: 'tooltipOnHover',
+            category: 'identity',
+            valueKind: 'boolean',
+            description: 'Habilita apresentação do tooltip no hover quando suportado pelo renderer.',
+            intentExamples: ['mostrar tooltip ao passar o mouse', 'ativar dica no hover'],
+        },
         {
             path: 'description',
             category: 'identity',
@@ -21522,6 +21586,34 @@ const FIELD_METADATA_CAPABILITIES = {
             description: 'Tamanho do ícone.',
             intentExamples: ['ícone pequeno', 'aumentar tamanho do ícone', 'ícone grande'],
         },
+        {
+            path: 'iconColor',
+            category: 'appearance',
+            valueKind: 'string',
+            description: 'Cor semântica ou token de cor aplicado ao ícone principal.',
+            intentExamples: ['ícone em cor primária', 'usar token do tema no ícone'],
+        },
+        {
+            path: 'iconClass',
+            category: 'appearance',
+            valueKind: 'string',
+            description: 'Classe CSS controlada pelo host para o ícone principal.',
+            intentExamples: ['usar classe de ícone outlined', 'aplicar classe corporativa'],
+        },
+        {
+            path: 'iconStyle',
+            category: 'appearance',
+            valueKind: 'string',
+            description: 'Estilo visual semântico do ícone quando o renderer suportar variações.',
+            intentExamples: ['usar ícone arredondado', 'aplicar estilo filled'],
+        },
+        {
+            path: 'iconFontSize',
+            category: 'appearance',
+            valueKind: 'string',
+            description: 'Tamanho tipográfico do ícone principal.',
+            intentExamples: ['ícone com 18px', 'ajustar tamanho do ícone'],
+        },
         // =============================================================================
         // MASK / FORMAT
         // =============================================================================
@@ -35543,15 +35635,9 @@ function applyLocalCustomizations$1(base, local) {
     // Server authority on identity/core props
     const authoritative = {
         name: base.name,
-        label: base.label,
         type: base.type,
         controlType: base.controlType,
         required: base.required,
-        hint: base.hint,
-        helpText: base.helpText,
-        description: base.description,
-        icon: base.icon,
-        iconPosition: base.iconPosition,
         endpoint: base.endpoint,
         resourcePath: base.resourcePath,
         optionSource: base.optionSource,
@@ -35587,12 +35673,13 @@ function applyLocalCustomizations$1(base, local) {
             ? serverBackedLocal.queryParams
             : base.queryParams,
     };
-    return {
+    const merged = {
         ...base,
         ...serverBackedLocal,
         ...authoritative,
         ...preserved,
     };
+    return applyServerOwnedFieldSemantics(merged, base);
 }
 function mergeServerVisibilityFlag(serverValue) {
     return serverValue === true ? true : undefined;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@praxisui/core",
-  "version": "9.0.0-beta.13",
+  "version": "9.0.0-beta.14",
   "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

@@ -3963,8 +3963,12 @@ interface FieldMetadata extends ComponentMetadata {
     placeholder?: string;
     /** Help text displayed below field */
     hint?: string;
+    /** Domain help text emitted by backend schema metadata. */
+    helpText?: string;
     /** Tooltip text on hover */
     tooltip?: string;
+    /** Enables hover tooltip presentation when supported by the field renderer. */
+    tooltipOnHover?: boolean;
     /** Semantic selection mode for boolean/single/multiple choice controls */
     selectionMode?: 'boolean' | 'single' | 'multiple';
     /** Visual variant used by controls with more than one supported presentation */
@@ -4004,6 +4008,10 @@ interface FieldMetadata extends ComponentMetadata {
     suffixIcon?: string;
     iconPosition?: 'start' | 'end';
     iconSize?: 'small' | 'medium' | 'large';
+    iconColor?: string;
+    iconClass?: string;
+    iconStyle?: string;
+    iconFontSize?: string | number;
     /** Tooltip for suffix icon (used for help actions) */
     suffixIconTooltip?: string;
     /** ARIA label for suffix icon when used as help */
@@ -4223,6 +4231,7 @@ interface FieldDefinition {
     helpText?: string;
     hint?: string;
     hiddenCondition?: JsonLogicExpression | null;
+    tooltip?: string;
     tooltipOnHover?: boolean;
     icon?: string;
     iconPosition?: string;