@masterteam/forms 0.0.58 → 0.0.60

package/types/masterteam-forms-client-form.d.ts

@@ -23,7 +23,7 @@ type ProcessFormMode = 'Approval' | 'Direct';
 type ProcessFormSubmitStatus = 'PendingApproval' | 'Executed';
 type OperationType = 'FormOperation' | 'ActionOperation';
 type ProcessFormSource = 'Step' | 'None';
-type ClientFormResolvedRenderMode = 'form' | 'steps' | 'tabs';
+type ClientFormResolvedRenderMode = 'form' | 'steps' | 'tabs' | 'wizard';
 type ClientFormFooterActionMode = 'loading' | 'steps' | 'submit';
 interface ClientFormFooterState {
     loading: boolean;
@@ -76,6 +76,20 @@ interface ProcessFormSubmitRequest {
     returnUrl?: string;
     fields: ProcessFormSubmitField[];
 }
+interface ProcessFormValidationRuntimeResult {
+    isValid: boolean;
+    hasBlockingFailures: boolean;
+    results: ProcessFormValidationRuleResult[];
+}
+interface ProcessFormValidationRuleResult {
+    ruleId: string | number;
+    message?: ClientFormTranslatableValue | string | null;
+    severity: 'error' | 'warning';
+    passed: boolean;
+    isBlocking: boolean;
+    isEvaluationError: boolean;
+    errorMessage?: string | null;
+}
 interface ClientFormSubmitRequestMapperContext {
     formValue: Record<string, any>;
     loadResponse: ProcessFormLoadResponse;
@@ -144,7 +158,7 @@ interface ProcessFormContext {
     preview: boolean;
 }
 type ClientFieldWidth = '25' | '50' | '100';
-type ClientFormRenderMode = 'sections' | 'steps' | 'tabs';
+type ClientFormRenderMode = 'sections' | 'steps' | 'tabs' | 'wizard' | undefined;
 interface ClientFormConfiguration {
     isActive?: boolean;
     renderMode?: ClientFormRenderMode;
@@ -191,6 +205,12 @@ interface ClientPropertyItem {
     configuration?: Record<string, unknown> | null;
     [key: string]: any;
 }
+interface ClientFormTranslatableValue {
+    display?: string;
+    en?: string;
+    ar?: string;
+    [key: string]: string | undefined;
+}
 interface ClientValidationRule {
     id: string | number;
     formulaTokens: string;
@@ -328,8 +348,11 @@ declare class ClientForm implements OnDestroy {
     protected readonly state: ClientFormStateService;
     private loadSub?;
     private submitSub?;
+    private formValueSub?;
     private readonly hasStartedLoad;
-    readonly runtimeMessages: _angular_core.WritableSignal<FormulaRuntimeMessage[]>;
+    private readonly formRuntimeMessages;
+    private readonly submitValidationMessages;
+    readonly runtimeMessages: _angular_core.Signal<FormulaRuntimeMessage[]>;
     private readonly translocoService;
     readonly submitting: _angular_core.Signal<boolean>;
     readonly submitError: _angular_core.Signal<string | null>;
@@ -355,7 +378,7 @@ declare class ClientForm implements OnDestroy {
     readonly readonly: _angular_core.InputSignal<boolean>;
     readonly autoLoad: _angular_core.InputSignal<boolean>;
     readonly formMode: _angular_core.InputSignal<"create" | "edit">;
-    readonly renderMode: _angular_core.InputSignal<"form" | "steps" | "tabs" | undefined>;
+    readonly renderMode: _angular_core.InputSignal<"form" | "steps" | "tabs" | "wizard" | undefined>;
     readonly showInternalStepActions: _angular_core.InputSignal<boolean>;
     readonly lang: _angular_core.WritableSignal<"en" | "ar">;
     readonly lookups: _angular_core.InputSignal<ClientLookup[]>;
@@ -382,9 +405,11 @@ declare class ClientForm implements OnDestroy {
     readonly editableFormConfig: _angular_core.Signal<DynamicFormConfig | null>;
     readonly stepSections: _angular_core.Signal<_masterteam_components.SectionConfig[]>;
     readonly hasEditableFormSections: _angular_core.Signal<boolean>;
-    readonly effectiveRenderMode: _angular_core.Signal<"form" | "steps" | "tabs">;
+    readonly effectiveRenderMode: _angular_core.Signal<"form" | "steps" | "tabs" | "wizard">;
     readonly stepsEnabled: _angular_core.Signal<boolean>;
     readonly tabsEnabled: _angular_core.Signal<boolean>;
+    readonly wizardEnabled: _angular_core.Signal<boolean>;
+    readonly wizardFormConfig: _angular_core.Signal<DynamicFormConfig | null>;
     readonly sectionNavigationEnabled: _angular_core.Signal<boolean>;
     readonly tabOptions: _angular_core.Signal<OptionItem[]>;
     readonly stepTimeline: _angular_core.Signal<StepTimelineItem[]>;
@@ -440,6 +465,9 @@ declare class ClientForm implements OnDestroy {
     ngOnDestroy(): void;
     private buildLoadRequest;
     private buildSubmitRequest;
+    private mapSubmitValidationMessages;
+    private resolveSubmitValidationMessage;
+    private resolveTranslatableValue;
     private resolveStepTimelineState;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<ClientForm, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<ClientForm, "mt-client-form", never, { "moduleKey": { "alias": "moduleKey"; "required": true; "isSignal": true; }; "operationKey": { "alias": "operationKey"; "required": true; "isSignal": true; }; "moduleId": { "alias": "moduleId"; "required": false; "isSignal": true; }; "levelId": { "alias": "levelId"; "required": false; "isSignal": true; }; "levelDataId": { "alias": "levelDataId"; "required": false; "isSignal": true; }; "moduleDataId": { "alias": "moduleDataId"; "required": false; "isSignal": true; }; "requestSchemaId": { "alias": "requestSchemaId"; "required": false; "isSignal": true; }; "draftProcessId": { "alias": "draftProcessId"; "required": false; "isSignal": true; }; "preview": { "alias": "preview"; "required": false; "isSignal": true; }; "returnUrl": { "alias": "returnUrl"; "required": false; "isSignal": true; }; "submitRequestMapper": { "alias": "submitRequestMapper"; "required": false; "isSignal": true; }; "readonly": { "alias": "readonly"; "required": false; "isSignal": true; }; "autoLoad": { "alias": "autoLoad"; "required": false; "isSignal": true; }; "formMode": { "alias": "formMode"; "required": false; "isSignal": true; }; "renderMode": { "alias": "renderMode"; "required": false; "isSignal": true; }; "showInternalStepActions": { "alias": "showInternalStepActions"; "required": false; "isSignal": true; }; "lookups": { "alias": "lookups"; "required": false; "isSignal": true; }; "ignoredFieldKeys": { "alias": "ignoredFieldKeys"; "required": false; "isSignal": true; }; }, { "loaded": "loaded"; "submitted": "submitted"; "errored": "errored"; "modeDetected": "modeDetected"; "formSourceDetected": "formSourceDetected"; "footerStateChanged": "footerStateChanged"; }, never, never, true, never>;
@@ -462,6 +490,11 @@ declare class ClientFormApiService {
      * - Direct   → status: 'Executed'
      */
     submit(request: ProcessFormSubmitRequest): Observable<Response<ProcessFormSubmitResponse>>;
+    /**
+     * Validate the exact submit payload against backend-owned form rules
+     * before the real submit call.
+     */
+    validate(request: ProcessFormSubmitRequest): Observable<Response<ProcessFormValidationRuntimeResult>>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<ClientFormApiService, never>;
     static ɵprov: _angular_core.ɵɵInjectableDeclaration<ClientFormApiService>;
 }
@@ -501,4 +534,4 @@ declare function mapPreviewFieldsToEntities(config: ClientFormConfiguration, val
 declare function mapPreviewSectionsToEntities(config: ClientFormConfiguration, values: ProcessFormValue[], lang?: 'en' | 'ar', mode?: 'create' | 'edit', readonly?: boolean): ClientFormPreviewSection[];
 
 export { ClientForm, ClientFormApiService, ClientFormStateService, getPreviewOnlyFieldKeys, isFormRequiredInterception, mapFormValueToSubmitFields, mapPreviewFieldsToEntities, mapPreviewSectionsToEntities, mapToDynamicFormConfig, mapValuesToFormValue };
-export type { ClientFieldWidth, ClientFormConfiguration, ClientFormField, ClientFormFooterActionMode, ClientFormFooterState, ClientFormPreviewSection, ClientFormRenderMode, ClientFormResolvedRenderMode, ClientFormSection, ClientFormSubmitRequestMapper, ClientFormSubmitRequestMapperContext, ClientLookup, ClientLookupItem, ClientPropertyItem, ClientValidationRule, FormRequiredInterception, OperationType, ProcessFormContext, ProcessFormLoadRequest, ProcessFormLoadResponse, ProcessFormMode, ProcessFormSource, ProcessFormSubmitField, ProcessFormSubmitRecord, ProcessFormSubmitRecordField, ProcessFormSubmitRequest, ProcessFormSubmitResponse, ProcessFormSubmitStatus, ProcessFormSubmitValue, ProcessFormValue, ProcessFormValueMetadata, Response };
+export type { ClientFieldWidth, ClientFormConfiguration, ClientFormField, ClientFormFooterActionMode, ClientFormFooterState, ClientFormPreviewSection, ClientFormRenderMode, ClientFormResolvedRenderMode, ClientFormSection, ClientFormSubmitRequestMapper, ClientFormSubmitRequestMapperContext, ClientFormTranslatableValue, ClientLookup, ClientLookupItem, ClientPropertyItem, ClientValidationRule, FormRequiredInterception, OperationType, ProcessFormContext, ProcessFormLoadRequest, ProcessFormLoadResponse, ProcessFormMode, ProcessFormSource, ProcessFormSubmitField, ProcessFormSubmitRecord, ProcessFormSubmitRecordField, ProcessFormSubmitRequest, ProcessFormSubmitResponse, ProcessFormSubmitStatus, ProcessFormSubmitValue, ProcessFormValidationRuleResult, ProcessFormValidationRuntimeResult, ProcessFormValue, ProcessFormValueMetadata, Response };