Glossary

Key terms used throughout the Form Editor documentation.

Term	Definition
Action	A RuleAction that modifies field behavior (visibility, enabled state, value, validation) when a condition is met.
Async Validation	Validation that runs asynchronously (e.g., server-side checks). Debounced and executed after sync validators pass.
Auto-Finalize	The FormBuilder DSL pattern where starting a new field automatically commits the previous one.
Bridged Validator	Internal adapter that converts ValidationConfiguration to a reactive_forms Validator.
Row Span	A field's width inside an explicit row block. Runtime rows store spans on FormRowItem; editor rows store them on RowInstance, not on the field itself.
Compound Action	A CompoundAction that applies multiple actions simultaneously.
Compound Condition	A CompoundCondition that combines multiple conditions with AND/OR logic.
Condition	A RuleCondition that evaluates form field values and returns a boolean.
Content Builder	A ContentBuilder that maps a schema type to a widget builder. Part of the Vyuh content extension system.
Content Item	Base class for all renderable content in the Vyuh framework. Form, FormField, and FormSection all extend it.
Context-Aware Validation	Validation that depends on other fields' values. Implements ContextAwareValidation mixin.
Descriptor	A registration object (FormDescriptor, FormFieldDescriptor, etc.) that declares types for the content extension system.
Dynamic Validator	A DynamicValidator attached to fields with ValidationAction rules, allowing validations to be activated/deactivated at runtime.
Feature Descriptor	Top-level registration for a Vyuh feature, containing content extensions, routes, and services.
Field Derivation	Auto-computation of a field value from other fields. Stops when the user manually edits the derived field.
Field Instance	An editor-side representation of a form field (FieldInstance) with observable properties, validations, and rules.
Field Type	A FieldType definition in the editor that describes a field kind (its properties, validations, layouts).
Flat FormGroup	The design principle that all fields share a single FormGroup regardless of section nesting.
Form	The top-level container (vyuh.form) that owns the FormGroup and all form state.
Form Canvas	The center panel of the visual editor displaying the form layout.
Form Editor	The FormEditor widget providing a complete visual form designer.
FormBuilder	The fluent DSL class for constructing Form instances programmatically.
FormControl	A reactive_forms control representing a single field's value, validators, and state.
FormGroup	A reactive_forms group containing all field controls. One per Form.
FormSection	A structural container for visual grouping. Not a field; creates no control.
Field Palette	The left panel of the visual editor showing available field types.
Formula Field	A FormulaField that displays computed values from expressions referencing other fields.
MobX	The reactive state management library used for observable properties in the form system.
Properties Panel	The right panel of the visual editor showing configuration for the selected item.
Property System	The vyuh_property_system package providing typed properties, editors, and serialization.
reactive_forms	The Flutter package providing FormGroup, FormControl, and reactive form widgets.
Reference Field	A ReferenceField for selecting from entity reference options with multiple layout variants.
Repeating Section	A RepeatingSection that holds a template of fields repeated N times via FormArray.
Rule	A FormFieldRule consisting of a condition and an action.
Schema Name	A unique string identifier for a type in the content extension system (e.g., vyuh.formfield.text).
Soft Validation	Validation that warns but does not block form submission. Shows amber indicators.
Step Form	A StepForm multi-step wizard where each step is a complete Form.
Type Descriptor	A TypeDescriptor that registers a type for JSON deserialization and runtime discovery.
12-Column Grid	The layout system where each field has a column span (1-12) and fields wrap to new rows.
When	The fluent DSL class for creating condition-action rules concisely.

Next Steps

• Overview -- Quick reference tables
• Architecture -- System design
• Installation -- Getting started