@praxisui/visual-builder 9.0.5-rc.9 → 9.0.6

package/README.md

@@ -135,6 +135,7 @@ Boundary rules:
 - effects must be constrained by target property schemas and `RULE_PROPERTY_SCHEMA`
 - `dsl.roundTrip.validate` validates the JSON export/import path currently implemented by `RuleBuilderService`; form-config import remains supported but is not advertised as a round-trip export target by this operation
 - field-to-field comparisons are part of the supported visual subset; context-variable and function-result operands in field conditions remain planned until a canonical JSON Logic shape exists
+- field operands wrapped by the canonical Praxis `coalesce` operator round-trip without semantic loss; the editor preserves that nullish-value transform while fields or operators are changed
 - component-specific configuration belongs to child component manifests
 
 ## Legacy Note

package/ai/component-registry.json

@@ -1,8 +1,8 @@
 {
   "schemaVersion": "1.0.0",
-  "generatedAt": "2026-08-12T21:17:33.309Z",
+  "generatedAt": "2026-08-19T23:21:15.260Z",
   "packageName": "@praxisui/visual-builder",
-  "packageVersion": "9.0.5-rc.9",
+  "packageVersion": "9.0.6",
   "sourceRegistry": "praxis-component-registry-ingestion",
   "sourceRegistryVersion": "1.0.0",
   "componentCount": 1,

package/fesm2022/praxisui-visual-builder.mjs

@@ -1545,7 +1545,10 @@ class RuleBuilderService {
                 return null;
             }
             return {
-                [operator]: [{ var: cfg.fieldName }, this.buildConditionRightOperand(cfg)],
+                [operator]: [
+                    this.buildFieldOperand(cfg.fieldName, cfg.fieldValueTransform),
+                    this.buildConditionRightOperand(cfg),
+                ],
             };
         }
         if (node.type === RuleNodeType.AND_GROUP || node.type === RuleNodeType.OR_GROUP) {
@@ -1957,18 +1960,26 @@ class RuleBuilderService {
             return undefined;
         }
         const [left, right] = normalizedArgs;
-        if (!this.isVarExpression(left)) {
+        const leftOperand = this.parseFieldOperand(left);
+        if (!leftOperand) {
             return undefined;
         }
         const config = {
             type: 'fieldCondition',
-            fieldName: this.extractVarPath(left.var),
+            fieldName: leftOperand.path,
             operator: builderOperator,
             value: right,
         };
-        if (this.isVarExpression(right)) {
+        if (leftOperand.transform) {
+            config['fieldValueTransform'] = leftOperand.transform;
+        }
+        const rightOperand = this.parseFieldOperand(right);
+        if (rightOperand) {
             config['valueType'] = 'field';
-            config['compareToField'] = this.extractVarPath(right.var);
+            config['compareToField'] = rightOperand.path;
+            if (rightOperand.transform) {
+                config['compareToFieldValueTransform'] = rightOperand.transform;
+            }
         }
         return {
             id: v4(),
@@ -2091,10 +2102,34 @@ class RuleBuilderService {
         if (cfg['valueType'] === 'field' &&
             typeof cfg['compareToField'] === 'string' &&
             cfg['compareToField'].trim()) {
-            return { var: cfg['compareToField'].trim() };
+            return this.buildFieldOperand(cfg['compareToField'].trim(), cfg['compareToFieldValueTransform']);
         }
         return this.normalizeConditionValue(cfg['value']);
     }
+    buildFieldOperand(path, transform) {
+        const variable = { var: path };
+        return transform === 'coalesce' ? { coalesce: [variable] } : variable;
+    }
+    parseFieldOperand(value) {
+        if (this.isVarExpression(value)) {
+            return { path: this.extractVarPath(value.var) };
+        }
+        if (!value ||
+            typeof value !== 'object' ||
+            Array.isArray(value) ||
+            !('coalesce' in value)) {
+            return null;
+        }
+        const args = value.coalesce;
+        const normalizedArgs = Array.isArray(args) ? args : [args];
+        if (normalizedArgs.length !== 1 || !this.isVarExpression(normalizedArgs[0])) {
+            return null;
+        }
+        return {
+            path: this.extractVarPath(normalizedArgs[0].var),
+            transform: 'coalesce',
+        };
+    }
     isJsonLogicExpressionCandidate(value) {
         return !!value && typeof value === 'object' && !Array.isArray(value);
     }
@@ -4755,6 +4790,7 @@ class PropertyEffectEditorComponent {
                   size="dense"
                   matSuffix
                   type="button"
+                  [attr.aria-label]="getDefinition(entry.property)?.description"
                   [matTooltip]="getDefinition(entry.property)?.description"
                   matTooltipPosition="above"
                   >
@@ -5073,6 +5109,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.14", ngImpo
                   size="dense"
                   matSuffix
                   type="button"
+                  [attr.aria-label]="getDefinition(entry.property)?.description"
                   [matTooltip]="getDefinition(entry.property)?.description"
                   matTooltipPosition="above"
                   >
@@ -5463,6 +5500,8 @@ class FieldConditionEditorComponent {
             valueType,
             compareToField: valueType === 'field' ? formValue.compareToField : '',
             contextVariable: '',
+            fieldValueTransform: this.config?.fieldValueTransform,
+            compareToFieldValueTransform: valueType === 'field' ? this.config?.compareToFieldValueTransform : undefined,
         };
         this.configChanged.emit(config);
     }
@@ -5847,6 +5886,7 @@ class FieldConditionEditorComponent {
               size="dense"
               matSuffix
               type="button"
+              [attr.aria-label]="selectedField?.description"
               [matTooltip]="selectedField?.description"
               matTooltipPosition="above"
               >
@@ -5901,15 +5941,18 @@ class FieldConditionEditorComponent {
                       formControlName="value"
                       [placeholder]="getValuePlaceholder()"
                       />
-                    <button
-                      praxisIconButton="help_outline"
-                      size="dense"
-                      matSuffix
-                      type="button"
-                      [matTooltip]="getValueHint()"
-                      matTooltipPosition="above"
-                      >
-                    </button>
+                    @if (getValueHint()) {
+                      <button
+                        praxisIconButton="help_outline"
+                        size="dense"
+                        matSuffix
+                        type="button"
+                        [attr.aria-label]="getValueHint()"
+                        [matTooltip]="getValueHint()"
+                        matTooltipPosition="above"
+                        >
+                      </button>
+                    }
                   </mat-form-field>
                 }
                 @if (isBooleanField()) {
@@ -6144,6 +6187,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.14", ngImpo
               size="dense"
               matSuffix
               type="button"
+              [attr.aria-label]="selectedField?.description"
               [matTooltip]="selectedField?.description"
               matTooltipPosition="above"
               >
@@ -6198,15 +6242,18 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.14", ngImpo
                       formControlName="value"
                       [placeholder]="getValuePlaceholder()"
                       />
-                    <button
-                      praxisIconButton="help_outline"
-                      size="dense"
-                      matSuffix
-                      type="button"
-                      [matTooltip]="getValueHint()"
-                      matTooltipPosition="above"
-                      >
-                    </button>
+                    @if (getValueHint()) {
+                      <button
+                        praxisIconButton="help_outline"
+                        size="dense"
+                        matSuffix
+                        type="button"
+                        [attr.aria-label]="getValueHint()"
+                        [matTooltip]="getValueHint()"
+                        matTooltipPosition="above"
+                        >
+                      </button>
+                    }
                   </mat-form-field>
                 }
                 @if (isBooleanField()) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@praxisui/visual-builder",
-  "version": "9.0.5-rc.9",
+  "version": "9.0.6",
   "description": "Visual rule and expression builder for Praxis UI with JSON Logic authoring, validation and context variables.",
   "peerDependencies": {
     "@angular/common": "^21.0.0",
@@ -8,10 +8,10 @@
     "@angular/cdk": "^21.0.0",
     "@angular/material": "^21.0.0",
     "@angular/forms": "^21.0.0",
-    "@praxisui/settings-panel": "^9.0.5-rc.9",
-    "@praxisui/ai": "^9.0.5-rc.9",
-    "@praxisui/core": "^9.0.5-rc.9",
-    "@praxisui/metadata-editor": "^9.0.5-rc.9",
+    "@praxisui/settings-panel": "^9.0.6",
+    "@praxisui/ai": "^9.0.6",
+    "@praxisui/core": "^9.0.6",
+    "@praxisui/metadata-editor": "^9.0.6",
     "rxjs": "~7.8.0"
   },
   "dependencies": {

package/types/praxisui-visual-builder.d.ts

@@ -42,6 +42,7 @@ interface SpecificationMetadata {
  * Value types for rule configuration
  */
 type ValueType = 'literal' | 'field' | 'context' | 'function';
+type FieldOperandTransform = 'coalesce';
 /**
  * Valid comparison operators supported by the visual builder
  */
@@ -112,6 +113,10 @@ interface FieldConditionConfig {
     valueType?: ValueType;
     /** Field to compare against (for field-to-field comparisons) */
     compareToField?: string;
+    /** Canonical JSON Logic transform applied to the left field operand. */
+    fieldValueTransform?: FieldOperandTransform;
+    /** Canonical JSON Logic transform applied to a field-valued right operand. */
+    compareToFieldValueTransform?: FieldOperandTransform;
     /** Context variable to use as value */
     contextVariable?: string;
     /** Optional metadata for error messages and UI hints */
@@ -1304,6 +1309,8 @@ declare class RuleBuilderService {
     private jsonLogicOperatorToBuilderOperator;
     private normalizeConditionValue;
     private buildConditionRightOperand;
+    private buildFieldOperand;
+    private parseFieldOperand;
     private isJsonLogicExpressionCandidate;
     private isVarExpression;
     private extractVarPath;
@@ -2958,4 +2965,4 @@ declare class RuleListComponent {
 }
 
 export { ArrayFieldAnalyzer, CollectionValidatorEditorComponent, ConditionalValidatorEditorComponent, ConditionalValidatorType, ConfigurationError, ContextError, ContextManagementService, ConversionError, ErrorCategory, ErrorHandler, ErrorSeverity, ExportDialogComponent, ExportIntegrationService, ExpressionError, FIELD_TYPE_OPERATORS, FieldConditionEditorComponent, FieldSchemaService, FieldType, InternalError, JsonViewerComponent, MetadataEditorComponent, OPERATOR_LABELS, PRAXIS_VISUAL_BUILDER_AUTHORING_MANIFEST, PRAXIS_VISUAL_BUILDER_COMPONENT_METADATA, PraxisVisualBuilder, RegistryError, RuleBuilderService, RuleCanvasComponent, RuleEditorComponent, RuleListComponent, RuleNodeComponent, RuleNodeRegistryService, RuleNodeType, RuleTemplateService, RuleValidationService, TemplateEditorDialogComponent, TemplateGalleryComponent, TemplatePreviewDialogComponent, ValidationError as VBValidationError, ValidationCategory, ValidationSeverity, VisualBuilderError, VisualRuleBuilderComponent, WebhookIntegrationService, createError, getArrayItemFieldPaths, globalErrorHandler, isArrayFieldSchema, providePraxisVisualBuilderMetadata };
-export type { ArrayCollectionValidationRule, ArrayFieldSchema, ArrayValidationContext, ArrayValidationError, BooleanGroupConfig, CardinalityConfig, CircularReference, CleanupResult, CollectionValidationConfig, CollectionValidatorConfig, ConditionalValidatorConfig, ConditionalValidatorPreview, ContextEntry, ContextScope, ContextValue, ContextVariable, ContextualConfig, ContextualTemplateConfig, CustomConfig, CustomFunction, DocumentationLink, EnhancedFieldSchema, ErrorInfo, ErrorStatistics, ExportDialogData, ExportFormat, ExportOptions, ExportResult, ExpressionConfig, ExternalSystemConfig, FieldConditionConfig, FieldFormat, FieldOption, FieldSchema, FieldSchemaContext, FieldToFieldConfig, FieldUIConfig, FunctionCallConfig, FunctionParameter, ImportOptions, IntegrationEndpoint, IntegrationResult, MemoryStats, OptionalFieldConfig, PropertyRuleConfig, RegistryIntegrityResult, RegistryValidationResult, RuleBuilderConfig, RuleBuilderSnapshot, RuleBuilderState, RuleContextProvider, RuleFunctionRegistry, RuleNode, RuleNodeConfig, RuleNodeTree, RuleNodeTypeString, RuleTemplate, RuleValidationResult, SpecificationMetadata, TemplateApplicationResult, TemplateCategory, TemplateDisplayMode, TemplateEditorDialogData, TemplateEditorResult, TemplateMetadata, TemplatePreviewDialogData, TemplateSearchCriteria, TemplateSortOption, TemplateStats, TemplateValidationResult, ValidComparisonOperator, ValidationConfig, ValidationContext, ValidationError$1 as ValidationError, ValidationIssue, ValidationResult, ValidationRule, ValueType, VisualBuilderMode, WebhookConfig, WebhookDelivery, WebhookEvent, WebhookStats };
+export type { ArrayCollectionValidationRule, ArrayFieldSchema, ArrayValidationContext, ArrayValidationError, BooleanGroupConfig, CardinalityConfig, CircularReference, CleanupResult, CollectionValidationConfig, CollectionValidatorConfig, ConditionalValidatorConfig, ConditionalValidatorPreview, ContextEntry, ContextScope, ContextValue, ContextVariable, ContextualConfig, ContextualTemplateConfig, CustomConfig, CustomFunction, DocumentationLink, EnhancedFieldSchema, ErrorInfo, ErrorStatistics, ExportDialogData, ExportFormat, ExportOptions, ExportResult, ExpressionConfig, ExternalSystemConfig, FieldConditionConfig, FieldFormat, FieldOperandTransform, FieldOption, FieldSchema, FieldSchemaContext, FieldToFieldConfig, FieldUIConfig, FunctionCallConfig, FunctionParameter, ImportOptions, IntegrationEndpoint, IntegrationResult, MemoryStats, OptionalFieldConfig, PropertyRuleConfig, RegistryIntegrityResult, RegistryValidationResult, RuleBuilderConfig, RuleBuilderSnapshot, RuleBuilderState, RuleContextProvider, RuleFunctionRegistry, RuleNode, RuleNodeConfig, RuleNodeTree, RuleNodeTypeString, RuleTemplate, RuleValidationResult, SpecificationMetadata, TemplateApplicationResult, TemplateCategory, TemplateDisplayMode, TemplateEditorDialogData, TemplateEditorResult, TemplateMetadata, TemplatePreviewDialogData, TemplateSearchCriteria, TemplateSortOption, TemplateStats, TemplateValidationResult, ValidComparisonOperator, ValidationConfig, ValidationContext, ValidationError$1 as ValidationError, ValidationIssue, ValidationResult, ValidationRule, ValueType, VisualBuilderMode, WebhookConfig, WebhookDelivery, WebhookEvent, WebhookStats };