Required. The name of the ViewModel. This will be used as the ViewModel class name in generated code. Required. The mode of the ViewModel. Determines the base class and behavior: Page (inherits BasePageViewModel), Wizard (inherits BaseWizardViewModel with multi-step navigation), Dialog (inherits BaseDialogViewModel for modal interactions). Optional. The namespace for the ViewModel — defines the namespace for the generated VM code. Only the C# / WPF generator consumes this; React/TypeScript generation ignores it (TS modules use file paths). Leave empty for React-only ViewModels. Optional. The base class that the ViewModel inherits from. If not specified, defaults based on mode (BasePageViewModel, BaseWizardViewModel, or BaseDialogViewModel). Optional. Comma-separated list of interfaces that the ViewModel implements. Optional. Indicates whether the ViewModel class should be generated as a partial class, allowing for additional manual implementation. Default is false. Optional. Summary documentation for the ViewModel. This will be included in generated code documentation. Optional. Additional remarks for the ViewModel documentation. This will be included in generated code documentation as remarks section. Optional override for the user-right bucket every command on this ViewModel resolves against. Three meanings: (1) unset → bucket = the ViewModel name with leading "Base" + trailing "ViewModel" stripped (the default). (2) "None" → the `&& UserContext.hasUserRight(...)` clause is OMITTED from every canExecute getter on this VM; use for anonymous / sign-up flows where every step runs before the user has earned any rights (the auth-method step IS the rights-grant point). (3) any other value → bucket = that value (e.g. `customUserRight="ProductEditing"` shares a bucket across multiple VMs). A per-`<Command>` `customUserRight` still wins over this VM-level setting. Wizard-only. Fully-qualified Process class name (e.g. `TestApp.Processes.InsertCustomerProcess`) that the backend runs on the Active→Completed transition fired by POST /wizards/{sessionId}/finalize. Resolved at runtime through `WizardFinalizeRegistry` — the app's startup binds the wizard name (this ViewModel's name without the trailing "ViewModel") to a callable that invokes the named Process, and the generated controller substitutes the Process result for the bare consolidated step payload as the /finalize response body. Optional: when absent, /finalize returns the bare consolidated `{step: data}` dict and the SPA can call follow-up service methods itself. Ignored (with a build-time warning) when `mode` is not `Wizard`. The Process MUST be idempotent — the connector's finalize is idempotent across retry-after-network-glitch and Phase 4a invokes the Process on every call (use the wizard's `sessionId` as the Process run_key when crash-resilience matters). A property (field) on a standalone ViewModel. Describes the data (type / enum / mandatory) and nests ViewModelPropertyView children for per-view presentation. Per-view presentation overrides for this property (label / layout / input type / instruction / tooltip / colSpan / etc.). Use one PropertyView per View the VM declares. Required. The name of the ViewModel property. This will be used as the property name in generated code. For ModelReference properties, the name will automatically have "Key" suffix appended if not present. Required. The data type of the ViewModel property. Supported types include primitive types (String, Int, Decimal, Bool, Id, DateTime, Date), Enum (requires `enum`), Model (requires `model`; set `collection="List"` for a collection of models), and File. Required if type is Enum. Specifies the name of the enumeration type. The enumeration can be defined in the ViewModel's Enumerations section or referenced from a model. Required if type is Model. Specifies the name of the referenced model type. For a collection, keep type="Model" and add `collection="List"`. Optional. Deprecated attribute. Use step attribute instead. Describes the phase where data is collected from the user. Optional. Display name of the field. Language text. Optional. REACT ONLY. When true, the generated React ViewModel emits an `on[Property]ChangedBase(oldValue)` wrapper that calls the derived-class `on[Property]Changed(oldValue)` hook. The hook fires AFTER updateField writes the new value, with the previous value passed in. Use for side-effects tied to property changes. NOTE: WPF emits plain `On[Property]Changed()` (no oldValue parameter) for EVERY property regardless of this flag; the attribute is a no-op on WPF. Default false. Optional. Defines the section heading under which this property is grouped in the view. Properties with the same section are displayed together. Optional. Specifies the validation rule for the property. Built-in rules (`Email`, `Phone`, `Zip`, `BankAccount`, `Ssn`, `Bic`, `SsnOrBic`, `CreditCard`, `Range`, `ValueList`, `IsTrue`, `Regex`) emit the corresponding check inline. `Custom` emits a CALL to a `validate[PropertyName]Custom()` hook that YOU must provide on the derived ViewModel; it should return `null` on success or an error message string. The generator does NOT emit the hook method itself. Optional. Specifies validation context for the property. Typically country code like FI that defines detailed validation logic. Give model property where context is read with syntax: {propertyName}. Typically f.ex {CountryCode}. Optional. Specifies validation message when validation fails. Use {FieldName}, {MinValue}, {MaxValue}, {ValueList}, {Context} tags if needed. Language text. Optional. Specifies min value for validation rule. Decimal format. Required if validation is Range. Optional. Specifies max value for validation rule. Decimal format. Required if validation is Range. Optional. Allowed options for validation. Comma separated list. Required if validation is ValueList. Optional. Specify condition when validation check is valid. Use native language syntax. Optional. Specifies if field is required. Optional. Specifies error message when required check fails. Use {FieldName} tag if needed. Language text. Optional. Specify condition when required check is valid. Use native language syntax. Optional. Indicates whether the property is read-only and cannot be edited in the view. Default is false. Optional. Default value to initialize for the property when creating a new instance. Optional. Specifies the type of collection when the property represents a collection. Currently only `List` is supported. Optional. Specifies the type of text field. Valid only for type String. Optional. Indicates whether the property is mandatory (not nullable). Default is false. If required attribute is not specified, its value defaults to mandatory. Optional. Indicates whether the property is only used internally within the ViewModel and should not be displayed or edited by the user. Default is false. Optional. CSS class name or style identifier for the property. Used as className (React), style (Xaml), or style (React Native) in generated views. Optional. Instruction text appearing below component. Language text. Optional. Instruction text appearing in help box next to label. Language text. Optional. Instruction text appearing in tooltip. Language text. Optional. Placheholder text for text inputs. Language text. Optional. Documentation comments for the property. This will be included in generated code documentation. Optional. Specifies the access level for the generated property. Options: public (default), protected. This attribute is deprecated and not actively used in current generation. Per-view presentation settings for a ViewModel property. Overrides ViewModelProperty-level defaults for one specific view (by viewName or mode). The name of the view. Name of property visible in this view. Optional. Is property read only in this view. Optional. Is property hidden in this view. Optional. Style definition given for label part of control. Optional. Style definition given for actual control (input) part of control. Optional. Style definition given for feedback (error message) part of control. Optional. Style definition given for governing group element around control. Optional. Optional. Instruction text appearing below component. Language text. Optional. Instruction text appearing in help box next to label. Language text. Optional. Instruction text appearing in tooltip. Language text. Optional. Placheholder text for text inputs. Language text. Optional. Mode of lookup component to select values for ModelReference. Optional. Optional. Specifies type of text input. Valid only if type is String. Optional. Specifies format of code input. Valid only if type is String and inputType is Code. Optional. Specifies input mode (keyboard type) for text inputs. Optional. Specifies autocomplete mode for text inputs. Optional. Number of form columns this field spans (most-specific tier in the colSpan inheritance chain: ViewModelPropertyView > ViewModelPropertyGroup > ViewModelView). Default 1. Optional. Where the label sits relative to the input. "Top" (default) stacks label above control; "Side" places the label to the left of the control on the same row. Optional. Side-layout label column width. Three levels: "Narrow" (~80px), "Normal" (~120px, default), "Wide" (~200px). Ignored when labelOrientation is "Top". Groups a set of ViewModel Properties for organizational + UI purposes. Group-level settings cascade to every child ViewModelProperty unless overridden at property or view level. Optional. Hides every property in the group from generated views. Default is false. Optional. Group-level default for colSpan in the inheritance chain (ViewModelPropertyView > ViewModelPropertyGroup > ViewModelView). Applies to every child Property that does not set its own ViewModelPropertyView.colSpan. Optional. Instruction text for field section. Language text. Style of property group. Used as className (React), style (Xaml), or style (React Native) Name of the wizard step. Mandatory if stepOrder given. Only if mode is Wizard. Order of the wizard step. Mandatory if step given. Only if mode is Wizard. Optional. Additional information related to step order. Language text. Only if mode is Wizard. Optional. Heading for step. Language text. Only if mode is Wizard. Optional. Instruction text for step. Language text. Only if mode is Wizard. Optional. Indicates whether cancel button is enabled for the step. Default is false. Only if mode is Wizard. Optional. Indicates whether back button is enabled for the step. Default is false. Only if mode is Wizard. Optional. When true, the step shows a Finish button that COMPLETES the wizard FROM this step, SKIPPING any subsequent steps. Use for optional trailing steps at the end of a wizard where the user can finish early. The Next button is always enabled by default — there is no flag for it. Default false. Only if mode is Wizard. Optional. Indicates if wizard as whole is executed after this step. Typically second last step if last is summary. Default is false. Only if mode is Wizard. Optional. Marks this wizard step as an authentication-method picker (e.g. "Google,Apple,Email"). The step renders the named login methods as buttons (fed by the app's generated auth config — clientIds come from Application.xml's Auth/Methods, NOT redeclared here) and advances to the next step on successful authentication. The picker renders in place of the step's fields; declare a Property only as a `bindAuth` sink. Only if mode is Wizard. Optional, used with `authMethods`. Names a Property declared in THIS step that receives the authenticated user's email (the login identity) once a method completes — e.g. `bindAuth="Email"` alongside a `<Property name="Email"/>` in the step. The generator captures the email into the wizard VM (e.g. vm.email) before advancing, so later steps and the wizard's execute logic can use the verified identity. Only if mode is Wizard. Optional. Per-step implementation guidance written onto the step's abstract execute method — both the base class declaration AND the derived implementation stub the AI fills in. Use it to describe what this step should do (e.g. "Create the wizard session via apiCustomerServiceClient.startWizard and keep the returned SessionId"); the wrapper already handles validation, isLoading, step advancement and error surfacing, so document only the step's own logic. Only if mode is Wizard. Mirrors ModelSchema's CommandType so the same set of attributes (type / label / message / customUserRight / customUserRightCommand / canExecuteCondition / selectedParameter / relatedProperty / documentation) is available regardless of which schema declares the command. The standalone-VM flavour keeps the optional CommandParameters child so dialog / wizard VMs can declare typed inputs the model-driven flavour doesn't need. The name of the ViewModel command. Optional. Defaults to `Custom`. Picks between adding a brand-new command (`Custom`) and CUSTOMISING one of the standard buttons that the generator already produces for the enclosing ViewModel mode (Page / Dialog / Wizard). To customise a standard button, declare a `<Command type="..."/>` with the matching `type`. Whatever you set on this entry — `label`, `message`, `customUserRight` / `customUserRightCommand`, `canExecuteCondition`, `documentation` — is applied to that button. The button's wiring (what it does, when it's enabled) stays the same. Dialog mode — three standard buttons you can customise: * `Execute` — primary OK / confirm action. * `Close` — close the dialog without committing. * `Cancel` — cancel / dismiss. Page mode — no standard buttons. A page declares every command it needs in XML, so only `Custom` is meaningful here. Wizard mode — each step gets up to four standard buttons (Next / Back / Cancel / Finish), driven by the step's PropertyGroup flags (`stepBackEnabled`, `wizardCancelEnabled`, `wizardFinishEnabled`). Customise them with these types: * `ExecuteWizardStep` — the Next button. * `BackWizardStep` — the Back button. * `CancelWizard` — the Cancel button. * `FinishWizard` — the Finish button (early-completion). By default a wizard customisation applies to EVERY step. To target a single step instead, add the `wizardStepOrder` attribute. You can combine both: one entry without `wizardStepOrder` sets the common label / right, and a second entry with `wizardStepOrder` overrides it for that one step (the per-step entry wins). `Custom` (default) — declares a brand-new command the framework doesn't know about. Use this for project-specific actions (Approve, Archive, Recalc, ...). Optional. Message shown after successful execution. Language text. The display name of the command. Optional. Optional override for the user-right bucket the command's `hasUserRight(...)` check resolves against. Defaults to the parent ViewModel's name. Set when the command should be governed by a different bucket than its hosting VM. Optional override for the command-level key spliced into `hasUserRight(bucket, command)`. Defaults to the command's `name` attribute. Set when multiple commands should share a single command-level right, to align with an existing org-defined right name, or to decouple the displayed label from the underlying right. Optional. Boolean expression spliced into the button's enable check. Use the host language's own syntax (TypeScript for React, C# for WPF, ...). Multi-flavour syntax (same shape as `label`'s language tags) lets ONE attribute cover multiple view-model types when the expression has to differ: [react]this.amount > 0[wpf]Amount > 0[reactNative]this.amount > 0 Rules: * Plain text without `[...]` markers is used as-is for every view-model type. * Text BEFORE the first `[` is the default fallback when no marker matches. * Each `[code]value` segment targets one view-model type. Codes: react — React VM wpf — WPF VM reactNative — React Native VM Codes are case-insensitive, order doesn't matter. * Markers are picked at code-generation time, so each generated VM gets only its own variant. Optional. Indicates if this is targeted to selected row in list view. Default is false. Optional. Name of a viewmodel property the command operates on (e.g. a Ref property the command opens / loads / searches against). Used to bind the command to a specific RelatedViewModelProperty so the generator can wire the abstract / wrapper pair against that property. Optional. Targets a single wizard step when customising one of the wizard `type=` values (ExecuteWizardStep / BackWizardStep / CancelWizard / FinishWizard). The number must match the `stepOrder` of a PropertyGroup that declares a wizard step. When omitted, the customisation applies to EVERY step in the wizard. A per-step entry (with `wizardStepOrder`) wins over a wildcard entry (without it). Ignored — and meaningless — for non-wizard `type=` values. Optional. Summary documentation for the command. Becomes the abstract method's doc summary in the generated derived-class stub so the AI / dev reads the intent (e.g. "open ProductReadView") while filling in the body. Optional. Extra CSS class name(s) appended to the generated button's className (React) / Style (Xaml). Use to target the button in a per-view stylesheet without having to scope by the mode/section wrapper classes — e.g. `style="primary-cta"` makes `<BsButton className="primary-cta mg-bs-..."/>`. Whitespace-separated values are emitted verbatim. A named enum with items + optional null handling. Required. The name of the enumeration type. This will be used as the enumeration type name in generated code. Optional. Indicates whether a NULL value (with numeric value 0) should be automatically added to the enumeration. Default is true. Optional. The description text for the NULL value when nullIncluded is true. Default is '-'. A generated view tied to a standalone ViewModel (dialog / wizard). Distinct from Model-driven views — ViewModel XMLs describe VMs that don't map 1:1 to a persisted model. Layout attrs (colCount, colSpan default) drive the form grid inside the view. Optional. The name of the view. Defaults to the parent ViewModel's name with the trailing "Model" stripped (e.g. `InsertCustomerWizardViewModel` → `InsertCustomerWizardView`). Set explicitly when the view name should differ from the convention. Optional. The namespace of the view. Defaults to the parent ViewModel's namespace so the view co-locates with the VM (consistent with the ModelView default). Only the WPF / Xaml side consumes this; React/TS generation ignores it. Indicates if this is the default view. Default is false. Number of columns in view. Valid only for Read and Update views. Default is 2. Optional. View-level fallback default (lowest tier in the colSpan inheritance chain: ViewModelPropertyView > ViewModelPropertyGroup > ViewModelView). Applies only when none of the higher tiers set colSpan. Display name of the view. Language text. Default is name without view and mode at the end. A typed parameter passed to a VM command when invoked. Rendered as a named arg in the generated command method. The name of the command parameter. The type of the command parameter. A directory + model-name pointer to another Model XML this ViewModel depends on (e.g. for lookups or referenced properties). The full file path is constructed by callers as `<path>/<name>.xml` (or generated-artifact equivalent for code-gen import paths). The name of the referenced model. Doubles as the file name stem. Directory path to the referenced model file (no file name; the file name is `<name>.xml`). A directory + model-name + enum-name pointer to an enumeration defined in another model file. The model file is `<path>/<modelName>.xml`; `name` is the enumeration identifier within that file. The name of the referenced enumeration (the identifier inside the model file). Name of the model whose XML file contains the enumeration. Doubles as the file name stem. Directory path to the referenced model file (no file name; the file name is `<modelName>.xml`). A single item inside a ViewModel-local Enumeration. Simpler than the Model variant: no mapping children. Required. The name of the enumeration item. This will be used as the enumeration value name in generated code. Optional. The numeric value of the enumeration item. If not specified, values are assigned sequentially starting from the configured EnumerationStartValue (default 1), or incrementing from the previous item's value. Optional. A code identifier for the enumeration item. This can be used for additional identification purposes. Optional. Documentation comments for the enumeration item. This will be included in generated code documentation. Optional. User-facing description of the enumeration item. Supports multilingual text format where translations are given after language code in square brackets (e.g., "Default text[fi]Suomenkielinen teksti"). If empty, a display name is automatically generated from the item name using camel case conversion.