@praxisui/visual-builder 8.0.0-beta.7 → 8.0.0-beta.71

package/package.json

@@ -1,14 +1,19 @@
 {
   "name": "@praxisui/visual-builder",
-  "version": "8.0.0-beta.7",
+  "version": "8.0.0-beta.71",
   "description": "Visual rule and expression builder for Praxis UI with JSON Logic authoring, validation and context variables.",
   "peerDependencies": {
-    "@angular/common": "^20.0.0",
-    "@angular/core": "^20.0.0",
-    "@angular/cdk": "^20.0.0",
-    "@angular/material": "^20.0.0",
-    "@angular/forms": "^20.0.0",
-    "@praxisui/settings-panel": "^8.0.0-beta.7"
+    "@angular/common": "^21.0.0",
+    "@angular/core": "^21.0.0",
+    "@angular/cdk": "^21.0.0",
+    "@angular/material": "^21.0.0",
+    "@angular/forms": "^21.0.0",
+    "@praxisui/settings-panel": "^8.0.0-beta.71",
+    "@angular/platform-browser-dynamic": "^21.0.0",
+    "@praxisui/ai": "^8.0.0-beta.71",
+    "@praxisui/core": "^8.0.0-beta.71",
+    "@praxisui/metadata-editor": "^8.0.0-beta.71",
+    "rxjs": "~7.8.0"
   },
   "dependencies": {
     "tslib": "^2.3.0",
@@ -36,14 +41,15 @@
   ],
   "sideEffects": false,
   "module": "fesm2022/praxisui-visual-builder.mjs",
-  "typings": "index.d.ts",
+  "typings": "types/praxisui-visual-builder.d.ts",
   "exports": {
     "./package.json": {
       "default": "./package.json"
     },
     ".": {
-      "types": "./index.d.ts",
+      "types": "./types/praxisui-visual-builder.d.ts",
       "default": "./fesm2022/praxisui-visual-builder.mjs"
     }
-  }
+  },
+  "type": "module"
 }

package/{index.d.ts → types/praxisui-visual-builder.d.ts}

@@ -1,6 +1,6 @@
 import * as i0 from '@angular/core';
 import { EventEmitter, OnInit, OnDestroy, OnChanges, AfterViewInit, ElementRef, ChangeDetectorRef, SimpleChanges } from '@angular/core';
-import { JsonLogicExpression, FormLayoutRule, RulePropertySchema, PraxisI18nService } from '@praxisui/core';
+import { JsonLogicExpression, ComponentAuthoringManifest, FormLayoutRule, RulePropertySchema, PraxisI18nService } from '@praxisui/core';
 import { Observable } from 'rxjs';
 import { MatDialog, MatDialogRef } from '@angular/material/dialog';
 import { MatSnackBar } from '@angular/material/snack-bar';
@@ -121,7 +121,7 @@ interface FieldConditionConfig {
 }
 interface PropertyRuleConfig {
     type: 'propertyRule';
-    targetType: 'field' | 'section' | 'action' | 'row' | 'column';
+    targetType: 'field' | 'section' | 'action' | 'row' | 'column' | 'visualBlock';
     /** Target IDs without prefix (namespace is defined by targetType) */
     targets: string[];
     /** Properties applied when condition is true */
@@ -411,6 +411,10 @@ interface RuleBuilderSnapshot {
         isDirty?: boolean;
     };
 }
+/**
+ * Public rendering mode for the visual builder host component.
+ */
+type VisualBuilderMode = 'rules' | 'condition';
 /**
  * Rule template for common scenarios
  */
@@ -512,9 +516,10 @@ interface RuleBuilderConfig {
         actions?: Record<string, unknown>;
         rows?: Record<string, unknown>;
         columns?: Record<string, unknown>;
+        visualBlocks?: Record<string, unknown>;
     };
     /** Optional property schema per targetType for typed property editing */
-    targetPropertySchemas?: Record<'field' | 'section' | 'action' | 'row' | 'column', Array<{
+    targetPropertySchemas?: Record<'field' | 'section' | 'action' | 'row' | 'column' | 'visualBlock', Array<{
         name: string;
         type: 'string' | 'boolean' | 'object' | 'enum' | 'number';
         label?: string;
@@ -618,18 +623,24 @@ interface ContextualTemplateConfig {
 }
 
 declare class PraxisVisualBuilder {
+    mode: VisualBuilderMode;
     config: RuleBuilderConfig | null;
     initialRules: any;
+    initialCondition: JsonLogicExpression | null;
     rulesChanged: EventEmitter<RuleBuilderState>;
+    conditionChanged: EventEmitter<JsonLogicExpression>;
     exportRequested: EventEmitter<ExportOptions>;
     importRequested: EventEmitter<ImportOptions>;
     onRulesChanged(rules: RuleBuilderState): void;
+    onConditionChanged(condition: JsonLogicExpression | null): void;
     onExportRequested(options: any): void;
     onImportRequested(options: any): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<PraxisVisualBuilder, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<PraxisVisualBuilder, "praxis-visual-builder", never, { "config": { "alias": "config"; "required": false; }; "initialRules": { "alias": "initialRules"; "required": false; }; }, { "rulesChanged": "rulesChanged"; "exportRequested": "exportRequested"; "importRequested": "importRequested"; }, never, never, true, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<PraxisVisualBuilder, "praxis-visual-builder", never, { "mode": { "alias": "mode"; "required": false; }; "config": { "alias": "config"; "required": false; }; "initialRules": { "alias": "initialRules"; "required": false; }; "initialCondition": { "alias": "initialCondition"; "required": false; }; }, { "rulesChanged": "rulesChanged"; "conditionChanged": "conditionChanged"; "exportRequested": "exportRequested"; "importRequested": "importRequested"; }, never, never, true, never>;
 }
 
+declare const PRAXIS_VISUAL_BUILDER_AUTHORING_MANIFEST: ComponentAuthoringManifest;
+
 /**
  * Field schema model for dynamic field configuration in the Visual Builder
  */
@@ -639,7 +650,7 @@ interface FieldSchema {
     /** Human-readable field label */
     label: string;
     /** Logical origin to help context-sensitive filtering (form field, section, row, column, table column, etc.) */
-    origin?: 'field' | 'section' | 'action' | 'row' | 'column' | 'tableField' | 'tableColumn';
+    origin?: 'field' | 'section' | 'action' | 'row' | 'column' | 'visualBlock' | 'tableField' | 'tableColumn';
     /** Field data type */
     type: FieldType | string;
     /** Optional description or help text */
@@ -1252,9 +1263,6 @@ declare class RuleBuilderService {
     export(options: ExportOptions): string;
     toSpecification(): null;
     private updateState;
-    /**
-     * Validate current rules (lightweight placeholder)
-     */
     validateRules(): void;
     loadFromConditionExpression(condition: JsonLogicExpression, description?: string): void;
     buildConditionExpressionFromGraph(nodes: Record<string, RuleNode>, rootNodes: string[]): JsonLogicExpression | null;
@@ -1298,6 +1306,11 @@ declare class RuleBuilderService {
     private flattenRuleNodeTree;
     private validateNode;
     private validateStructure;
+    private validateFieldConditionNode;
+    private validateBooleanGroupNode;
+    private validatePropertyRuleNode;
+    private validateExpressionNode;
+    private addValidationError;
     private exportToTypeScript;
     private exportToFormConfig;
     private normalizeSpecJson;
@@ -1600,6 +1613,7 @@ declare class WebhookIntegrationService {
     private preparePayload;
     private deliverWebhook;
     private sendWebhookRequest;
+    private toHeaderRecord;
     private updateDelivery;
     private processRetries;
     private updateStats;
@@ -2013,13 +2027,12 @@ declare enum ErrorSeverity {
  * Base error class for all Visual Builder errors
  */
 declare abstract class VisualBuilderError extends Error {
-    readonly cause?: Error | undefined;
     abstract readonly code: string;
     abstract readonly category: ErrorCategory;
     abstract readonly severity: ErrorSeverity;
     readonly timestamp: Date;
     readonly context: Record<string, any>;
-    constructor(message: string, context?: Record<string, any>, cause?: Error | undefined);
+    constructor(message: string, context?: Record<string, any>, cause?: Error);
     /**
      * Get structured error information
      */
@@ -2179,7 +2192,7 @@ declare const createError: {
     internal: (message: string, cause?: Error) => InternalError;
 };
 
-type TargetType = 'field' | 'section' | 'action' | 'row' | 'column';
+type TargetType = 'field' | 'section' | 'action' | 'row' | 'column' | 'visualBlock';
 type RuleNodeConfigExtended = RuleNodeConfig & {
     targetType?: TargetType;
     properties?: Record<string, any>;
@@ -2196,15 +2209,20 @@ declare class RuleEditorComponent implements OnInit, OnDestroy, OnChanges, After
     private readonly cdr;
     private readonly i18n?;
     embedded: boolean;
+    mode: VisualBuilderMode;
     config: RuleBuilderConfig | null;
     initialRules: any;
+    initialCondition: JsonLogicExpression | null;
     stateChanged: EventEmitter<RuleBuilderState>;
     save: EventEmitter<RuleBuilderState>;
     rulesChanged: EventEmitter<RuleBuilderState>;
+    conditionChanged: EventEmitter<JsonLogicExpression>;
     exportRequested: EventEmitter<ExportOptions>;
     importRequested: EventEmitter<ImportOptions>;
     fileInput: ElementRef<HTMLInputElement>;
     private destroy$;
+    private initialized;
+    private lastInitialConditionSignature;
     currentState: RuleBuilderState | null;
     fieldSchemas: Record<string, FieldSchema>;
     showDebugPanel: boolean;
@@ -2231,6 +2249,16 @@ declare class RuleEditorComponent implements OnInit, OnDestroy, OnChanges, After
     createRuleFromAI(aiResponse: AiRuleResponse): Promise<void>;
     addPropertyRule(): void;
     selectNode(nodeId: string): void;
+    onConditionNodeAdded(event: {
+        type: RuleNodeType;
+        parentId?: string;
+        config?: RuleNodeConfig;
+    }): void;
+    onConditionNodeUpdated(event: {
+        nodeId: string;
+        updates: Partial<RuleNode>;
+    }): void;
+    removeConditionNode(nodeId: string): void;
     duplicateNode(nodeId: string): void;
     onRuleUpdated(config: RuleNodeConfigExtended): void;
     removeNode(nodeId: string): void;
@@ -2241,18 +2269,21 @@ declare class RuleEditorComponent implements OnInit, OnDestroy, OnChanges, After
     getRuleCount(): number;
     t(key: string, fallback: string): string;
     private setupSubscriptions;
+    private loadInitialConditionIfNeeded;
     private validateAiResponse;
     private buildPropertyRuleLabel;
     private stripTargetPrefix;
     private normalizeRuleConfig;
     static ɵfac: i0.ɵɵFactoryDeclaration<RuleEditorComponent, [null, null, null, null, null, null, { optional: true; }]>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<RuleEditorComponent, "praxis-rule-editor", never, { "embedded": { "alias": "embedded"; "required": false; }; "config": { "alias": "config"; "required": false; }; "initialRules": { "alias": "initialRules"; "required": false; }; }, { "stateChanged": "stateChanged"; "save": "save"; "rulesChanged": "rulesChanged"; "exportRequested": "exportRequested"; "importRequested": "importRequested"; }, never, never, true, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<RuleEditorComponent, "praxis-rule-editor", never, { "embedded": { "alias": "embedded"; "required": false; }; "mode": { "alias": "mode"; "required": false; }; "config": { "alias": "config"; "required": false; }; "initialRules": { "alias": "initialRules"; "required": false; }; "initialCondition": { "alias": "initialCondition"; "required": false; }; }, { "stateChanged": "stateChanged"; "save": "save"; "rulesChanged": "rulesChanged"; "conditionChanged": "conditionChanged"; "exportRequested": "exportRequested"; "importRequested": "importRequested"; }, never, never, true, never>;
 }
 
 declare class RuleCanvasComponent implements OnInit, OnDestroy {
+    private readonly i18n?;
     conditionOnly: boolean;
     state: RuleBuilderState | null;
     fieldSchemas: Record<string, FieldSchema>;
+    validationErrors: ValidationError$1[];
     nodeSelected: EventEmitter<string>;
     nodeAdded: EventEmitter<{
         type: RuleNodeType;
@@ -2275,14 +2306,23 @@ declare class RuleCanvasComponent implements OnInit, OnDestroy {
     }[];
     get isEmpty(): boolean;
     get filteredAddMenuOptions(): typeof this.addMenuOptions;
-    constructor();
+    constructor(i18n?: PraxisI18nService | undefined);
     ngOnInit(): void;
     ngOnDestroy(): void;
     trackByNodeId(index: number, nodeId: string): string;
     getNode(nodeId: string): RuleNode | null;
     isNodeSelected(nodeId: string): boolean;
     isLastRootNode(nodeId: string): boolean;
-    getNodeValidationErrors(nodeId: string): any[];
+    getNodeValidationErrors(nodeId: string): ValidationError$1[];
+    emptyStateIcon(): string;
+    emptyStateTitle(): string;
+    emptyStateCta(): string;
+    conditionOnlyEmptyHint(): string;
+    dropZoneLabel(): string;
+    addMenuAriaLabel(): string;
+    hasBlockingConditionErrors(): boolean;
+    conditionValidationTitle(): string;
+    conditionValidationDescription(): string;
     selectNode(nodeId: string): void;
     updateNode(event: {
         nodeId: string;
@@ -2300,8 +2340,10 @@ declare class RuleCanvasComponent implements OnInit, OnDestroy {
     addFirstRule(): void;
     addRule(type: RuleNodeType): void;
     private isAllowedConditionType;
-    static ɵfac: i0.ɵɵFactoryDeclaration<RuleCanvasComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<RuleCanvasComponent, "praxis-rule-canvas", never, { "conditionOnly": { "alias": "conditionOnly"; "required": false; }; "state": { "alias": "state"; "required": false; }; "fieldSchemas": { "alias": "fieldSchemas"; "required": false; }; }, { "nodeSelected": "nodeSelected"; "nodeAdded": "nodeAdded"; "nodeUpdated": "nodeUpdated"; "nodeRemoved": "nodeRemoved"; }, never, never, true, never>;
+    private isDescendantOf;
+    private t;
+    static ɵfac: i0.ɵɵFactoryDeclaration<RuleCanvasComponent, [{ optional: true; }]>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<RuleCanvasComponent, "praxis-rule-canvas", never, { "conditionOnly": { "alias": "conditionOnly"; "required": false; }; "state": { "alias": "state"; "required": false; }; "fieldSchemas": { "alias": "fieldSchemas"; "required": false; }; "validationErrors": { "alias": "validationErrors"; "required": false; }; }, { "nodeSelected": "nodeSelected"; "nodeAdded": "nodeAdded"; "nodeUpdated": "nodeUpdated"; "nodeRemoved": "nodeRemoved"; }, never, never, true, never>;
 }
 
 declare class RuleNodeComponent {
@@ -2321,6 +2363,7 @@ declare class RuleNodeComponent {
     childAdded: EventEmitter<RuleNodeType>;
     childMoved: EventEmitter<CdkDragDrop<string[], string[], any>>;
     get hasValidationErrors(): boolean;
+    get ownValidationErrors(): ValidationError$1[];
     constructor(fb: FormBuilder);
     selectNode(): void;
     getNodeIcon(): string;
@@ -2348,6 +2391,7 @@ declare class RuleNodeComponent {
     isChildSelected(childId: string): boolean;
     getChildValidationErrors(childId: string): ValidationError$1[];
     isLastChild(childId: string): boolean;
+    private isDescendantOf;
     editNode(): void;
     duplicateNode(): void;
     deleteNode(): void;
@@ -2905,5 +2949,5 @@ declare class RuleListComponent {
     static ɵcmp: i0.ɵɵComponentDeclaration<RuleListComponent, "praxis-rule-list", never, { "rules": { "alias": "rules"; "required": false; }; "selectedRuleId": { "alias": "selectedRuleId"; "required": false; }; "nodeMap": { "alias": "nodeMap"; "required": false; }; "validationErrors": { "alias": "validationErrors"; "required": false; }; }, { "ruleSelected": "ruleSelected"; "ruleDeleted": "ruleDeleted"; "ruleDuplicated": "ruleDuplicated"; "ruleAdded": "ruleAdded"; "aiRequested": "aiRequested"; }, never, never, true, never>;
 }
 
-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, 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 };
-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, WebhookConfig, WebhookDelivery, WebhookEvent, WebhookStats };
+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, 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 };
+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 };