@praxisui/visual-builder 8.0.0-beta.6 → 8.0.0-beta.60

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -74,6 +74,31 @@ export class EmbeddedRuleEditor {
74
74
  }
75
75
  ```
76
76
 
77
+ ### Condition-Only Editor
78
+
79
+ Use condition mode when a host owns the action/effect contract and only needs a visual JSON Logic expression.
80
+
81
+ ```typescript
82
+ import { PraxisVisualBuilder } from '@praxisui/visual-builder';
83
+
84
+ @Component({
85
+ template: `
86
+ <praxis-visual-builder
87
+ mode="condition"
88
+ [config]="builderConfig"
89
+ [initialCondition]="condition"
90
+ (conditionChanged)="condition = $event">
91
+ </praxis-visual-builder>
92
+ `,
93
+ })
94
+ export class ConditionEditorHost {
95
+ builderConfig = {
96
+ fieldSchemas: {},
97
+ };
98
+ condition = null;
99
+ }
100
+ ```
101
+
77
102
  ## Canonical Authoring Services
78
103
 
79
104
  Use the canonical public services:
@@ -86,9 +111,37 @@ Use the canonical public services:
86
111
 
87
112
  Main exports available from `@praxisui/visual-builder`:
88
113
 
114
+ - Agentic authoring: `PRAXIS_VISUAL_BUILDER_AUTHORING_MANIFEST`
89
115
  - Components: `RuleEditorComponent`, `RuleCanvasComponent`, `RuleNodeComponent`, `FieldConditionEditorComponent`, `ConditionalValidatorEditorComponent`, `CollectionValidatorEditorComponent`, `MetadataEditorComponent`, `JsonViewerComponent`, `ExportDialogComponent`, `VisualRuleBuilderComponent`, `TemplateGalleryComponent`, `TemplateEditorDialogComponent`, `TemplatePreviewDialogComponent`, `RuleListComponent`, `ContextVariableManagerComponent`
90
116
  - Services: `RuleBuilderService`, `ExportIntegrationService`, `WebhookIntegrationService`, `RuleTemplateService`, `RuleValidationService`, `RuleNodeRegistryService`, `ContextManagementService`, `FieldSchemaService`
91
- - Models/Types: `FieldSchema`, `RuleBuilderConfig`, `ArrayFieldSchema`, `ContextScope`, `ContextEntry`, `ContextValue`
117
+ - Models/Types: `FieldSchema`, `RuleBuilderConfig`, `VisualBuilderMode`, `ArrayFieldSchema`, `ContextScope`, `ContextEntry`, `ContextValue`
118
+
119
+ ## Agentic Authoring Contract
120
+
121
+ `PRAXIS_VISUAL_BUILDER_AUTHORING_MANIFEST` is the executable AI authoring contract for this package.
122
+
123
+ The manifest governs visual graph and JSON Logic orchestration:
124
+
125
+ - `node.add`
126
+ - `node.remove`
127
+ - `node.configure`
128
+ - `edge.connect`
129
+ - `edge.remove`
130
+ - `variable.add`
131
+ - `condition.set`
132
+ - `effect.set`
133
+ - `dsl.roundTrip.validate`
134
+
135
+ Boundary rules:
136
+
137
+ - `RuleBuilderState` is the visual source of truth
138
+ - operations write canonical runtime paths under `RuleBuilderState`, `RuleBuilderConfig`, `RuleNodeRegistryService` and `ContextManagementService`
139
+ - node ids and context variable scope/name are stable identities
140
+ - graph edges must reference existing nodes and avoid cycles where required
141
+ - conditions persist as JSON Logic objects, not JavaScript or legacy textual DSL
142
+ - effects must be constrained by target property schemas and `RULE_PROPERTY_SCHEMA`
143
+ - `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
144
+ - component-specific configuration belongs to child component manifests
92
145
 
93
146
  ## Legacy Note
94
147