@epistola.app/valtimo-plugin 0.3.1 → 0.3.2

package/lib/components/array-field/array-field.component.d.ts

@@ -0,0 +1,27 @@
+import { EventEmitter, OnChanges, SimpleChanges } from '@angular/core';
+import { TemplateField } from '../../models';
+import * as i0 from "@angular/core";
+export declare class ArrayFieldComponent implements OnChanges {
+    field: TemplateField;
+    value: any;
+    pluginId: string;
+    caseDefinitionKey: string | null;
+    processVariables: string[];
+    disabled: boolean;
+    valueChange: EventEmitter<any>;
+    expanded: boolean;
+    arrayPerFieldMode: boolean;
+    mappedCount: number;
+    totalRequired: number;
+    ngOnChanges(changes: SimpleChanges): void;
+    toggleExpanded(): void;
+    getSourceValue(): string;
+    onSourceValueChange(newValue: string): void;
+    toggleArrayPerFieldMode(): void;
+    onItemFieldChange(childName: string, sourceFieldName: string): void;
+    getItemFieldValue(childName: string): string;
+    hasArrayChildren(): boolean;
+    private updateCompleteness;
+    static ɵfac: i0.ɵɵFactoryDeclaration<ArrayFieldComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<ArrayFieldComponent, "epistola-array-field", never, { "field": { "alias": "field"; "required": false; }; "value": { "alias": "value"; "required": false; }; "pluginId": { "alias": "pluginId"; "required": false; }; "caseDefinitionKey": { "alias": "caseDefinitionKey"; "required": false; }; "processVariables": { "alias": "processVariables"; "required": false; }; "disabled": { "alias": "disabled"; "required": false; }; }, { "valueChange": "valueChange"; }, never, never, true, never>;
+}

package/lib/components/data-mapping-tree/data-mapping-tree.component.d.ts

@@ -1,16 +1,15 @@
-import { EventEmitter, OnDestroy, OnInit } from '@angular/core';
-import { Observable } from 'rxjs';
+import { EventEmitter, OnChanges, SimpleChanges } from '@angular/core';
 import { TemplateField } from '../../models';
 import * as i0 from "@angular/core";
 /**
  * Top-level wrapper that hosts FieldTreeComponent instances for each top-level template field.
  * Manages the full nested mapping object, completeness tracking, and emits mapping changes.
  */
-export declare class DataMappingTreeComponent implements OnInit, OnDestroy {
+export declare class DataMappingTreeComponent implements OnChanges {
     pluginId: string;
-    templateFields$: Observable<TemplateField[]>;
-    prefillMapping$: Observable<Record<string, any>>;
-    disabled$: Observable<boolean>;
+    templateFields: TemplateField[];
+    prefillMapping: Record<string, any>;
+    disabled: boolean;
     caseDefinitionKey: string | null;
     processVariables: string[];
     mappingChange: EventEmitter<Record<string, any>>;
@@ -18,15 +17,11 @@ export declare class DataMappingTreeComponent implements OnInit, OnDestroy {
         mapped: number;
         total: number;
     }>;
-    templateFields: TemplateField[];
     mapping: Record<string, any>;
-    disabled: boolean;
-    private readonly destroy$;
-    ngOnInit(): void;
-    ngOnDestroy(): void;
+    ngOnChanges(changes: SimpleChanges): void;
     onFieldValueChange(fieldName: string, value: any): void;
     getFieldValue(fieldName: string): any;
     private emitRequiredFieldsStatus;
     static ɵfac: i0.ɵɵFactoryDeclaration<DataMappingTreeComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<DataMappingTreeComponent, "epistola-data-mapping-tree", never, { "pluginId": { "alias": "pluginId"; "required": false; }; "templateFields$": { "alias": "templateFields$"; "required": false; }; "prefillMapping$": { "alias": "prefillMapping$"; "required": false; }; "disabled$": { "alias": "disabled$"; "required": false; }; "caseDefinitionKey": { "alias": "caseDefinitionKey"; "required": false; }; "processVariables": { "alias": "processVariables"; "required": false; }; }, { "mappingChange": "mappingChange"; "requiredFieldsStatus": "requiredFieldsStatus"; }, never, never, true, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<DataMappingTreeComponent, "epistola-data-mapping-tree", never, { "pluginId": { "alias": "pluginId"; "required": false; }; "templateFields": { "alias": "templateFields"; "required": false; }; "prefillMapping": { "alias": "prefillMapping"; "required": false; }; "disabled": { "alias": "disabled"; "required": false; }; "caseDefinitionKey": { "alias": "caseDefinitionKey"; "required": false; }; "processVariables": { "alias": "processVariables"; "required": false; }; }, { "mappingChange": "mappingChange"; "requiredFieldsStatus": "requiredFieldsStatus"; }, never, never, true, never>;
 }

package/lib/components/field-tree/field-tree.component.d.ts

@@ -1,19 +1,11 @@
 import { EventEmitter, OnChanges, SimpleChanges } from '@angular/core';
-import { ValuePathSelectorPrefix } from '@valtimo/components';
 import { TemplateField } from '../../models';
 import * as i0 from "@angular/core";
-export type InputMode = 'browse' | 'pv' | 'expression';
 /**
- * Recursive component that renders a single TemplateField node as part of a tree form.
- *
- * - SCALAR fields render as a label + input row with a 3-mode selector (browse / pv / expression)
- * - OBJECT fields render as a collapsible section with children indented inside
- * - ARRAY fields render as a collapsible section with source collection input and optional per-item field mappings
- *
- * Input modes:
- * - Browse (⊞): ValuePathSelector for doc:/case: paths
- * - PV (pv): Dropdown of discovered process variables (text fallback when none found)
- * - Expression (fx): Free-text input for manual expressions
+ * Recursive field tree component.
+ * Dispatches SCALAR and ARRAY to dedicated sub-components.
+ * Handles OBJECT inline to avoid circular import issues (OBJECT children recurse back to this component).
+ * Uses forwardRef(() => FieldTreeComponent) in imports to allow self-referencing in the template.
  */
 export declare class FieldTreeComponent implements OnChanges {
     field: TemplateField;
@@ -23,52 +15,13 @@ export declare class FieldTreeComponent implements OnChanges {
     processVariables: string[];
     disabled: boolean;
     valueChange: EventEmitter<any>;
-    readonly ValuePathSelectorPrefix: typeof ValuePathSelectorPrefix;
-    inputMode: InputMode;
     expanded: boolean;
-    /** For ARRAY fields: whether to show per-item field mapping */
-    arrayPerFieldMode: boolean;
-    /** Completeness badge for collapsed object/array sections */
     mappedCount: number;
     totalRequired: number;
     ngOnChanges(changes: SimpleChanges): void;
     toggleExpanded(): void;
-    setInputMode(mode: InputMode): void;
-    /** Handle value change from ValuePathSelector (browse mode) */
-    onBrowseValueChange(newValue: string): void;
-    /** Handle value change from PV dropdown */
-    onPvChange(newValue: string): void;
-    /** Handle value change from text input (expression mode) */
-    onExpressionValueChange(newValue: string): void;
-    /** Handle child value change for OBJECT fields */
     onChildChange(childName: string, childValue: any): void;
-    /** Get the current value for a child field within an OBJECT */
     getChildValue(childName: string): any;
-    /** Get the string value for display (for SCALAR leaf inputs and direct array mode) */
-    getStringValue(): string;
-    /** Get the PV name from a pv: prefixed value (for PV dropdown default selection) */
-    getPvName(): string;
-    /** Get the source collection value (works for both direct string and _source format) */
-    getSourceValue(): string;
-    /** Get the PV name from the source value */
-    getSourcePvName(): string;
-    toggleArrayPerFieldMode(): void;
-    /** Handle source collection value change (used in ARRAY mode) */
-    onSourceBrowseChange(newValue: string): void;
-    onSourcePvChange(newValue: string): void;
-    onSourceExpressionChange(newValue: string): void;
-    /** Handle per-item field mapping change */
-    onItemFieldChange(childName: string, sourceFieldName: string): void;
-    /** Get the current source field name mapping for a child */
-    getItemFieldValue(childName: string): string;
-    /** Check if the array has any children that can be mapped per-item */
-    hasArrayChildren(): boolean;
-    private emitScalarValue;
-    private updateSourceValue;
-    private updateCompleteness;
-    private updateArrayCompleteness;
-    private detectInputMode;
-    private isResolvableValue;
     static ɵfac: i0.ɵɵFactoryDeclaration<FieldTreeComponent, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<FieldTreeComponent, "epistola-field-tree", never, { "field": { "alias": "field"; "required": false; }; "value": { "alias": "value"; "required": false; }; "pluginId": { "alias": "pluginId"; "required": false; }; "caseDefinitionKey": { "alias": "caseDefinitionKey"; "required": false; }; "processVariables": { "alias": "processVariables"; "required": false; }; "disabled": { "alias": "disabled"; "required": false; }; }, { "valueChange": "valueChange"; }, never, never, true, never>;
 }

package/lib/components/generate-document-configuration/generate-document-configuration.component.d.ts

@@ -4,7 +4,7 @@ import { FormOutput, SelectItem } from '@valtimo/components';
 import { CaseManagementParams, ManagementContext } from '@valtimo/shared';
 import { ProcessLinkStateService } from '@valtimo/process-link';
 import { BehaviorSubject, Observable } from 'rxjs';
-import { GenerateDocumentConfig, TemplateField } from '../../models';
+import { AsyncResource, GenerateDocumentConfig, TemplateField } from '../../models';
 import { EpistolaPluginService } from '../../services';
 import * as i0 from "@angular/core";
 export type VariantSelectionMode = 'explicit' | 'attributes';
@@ -20,20 +20,11 @@ export declare class GenerateDocumentConfigurationComponent implements FunctionC
     context$?: Observable<[ManagementContext, CaseManagementParams]>;
     valid: EventEmitter<boolean>;
     configuration: EventEmitter<GenerateDocumentConfig>;
-    templateOptions$: BehaviorSubject<SelectItem[]>;
-    templatesLoading$: BehaviorSubject<boolean>;
-    templatesError$: BehaviorSubject<string>;
-    variantOptions$: BehaviorSubject<SelectItem[]>;
-    variantsLoading$: BehaviorSubject<boolean>;
-    variantsError$: BehaviorSubject<string>;
-    environmentOptions$: BehaviorSubject<SelectItem[]>;
-    environmentsLoading$: BehaviorSubject<boolean>;
-    environmentsError$: BehaviorSubject<string>;
-    templateFields$: BehaviorSubject<TemplateField[]>;
-    templateFieldsLoading$: BehaviorSubject<boolean>;
-    templateFieldsError$: BehaviorSubject<string>;
+    templates$: BehaviorSubject<AsyncResource<SelectItem[]>>;
+    variants$: BehaviorSubject<AsyncResource<SelectItem[]>>;
+    environments$: BehaviorSubject<AsyncResource<SelectItem[]>>;
+    templateFields$: BehaviorSubject<AsyncResource<TemplateField[]>>;
     dataMapping$: BehaviorSubject<Record<string, any>>;
-    prefillDataMapping$: Observable<Record<string, any>>;
     outputFormatOptions: SelectItem[];
     readonly selectedTemplateId$: BehaviorSubject<string>;
     readonly selectedVariantId$: BehaviorSubject<string>;
@@ -48,6 +39,7 @@ export declare class GenerateDocumentConfigurationComponent implements FunctionC
         mapped: number;
         total: number;
     };
+    prefillDataMapping: Record<string, any>;
     private readonly destroy$;
     private saveSubscription;
     private readonly formValue$;
@@ -69,7 +61,7 @@ export declare class GenerateDocumentConfigurationComponent implements FunctionC
     private revalidate;
     private formatAttributes;
     private initContext;
-    private initPrefillDataMapping;
+    private initPrefill;
     private initPluginConfiguration;
     private initTemplatesLoading;
     private initEnvironmentsLoading;

package/lib/components/scalar-field/scalar-field.component.d.ts

@@ -0,0 +1,16 @@
+import { EventEmitter } from '@angular/core';
+import { TemplateField } from '../../models';
+import * as i0 from "@angular/core";
+export declare class ScalarFieldComponent {
+    field: TemplateField;
+    value: any;
+    pluginId: string;
+    caseDefinitionKey: string | null;
+    processVariables: string[];
+    disabled: boolean;
+    valueChange: EventEmitter<any>;
+    get stringValue(): string;
+    onValueChange(newValue: string): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<ScalarFieldComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<ScalarFieldComponent, "epistola-scalar-field", never, { "field": { "alias": "field"; "required": false; }; "value": { "alias": "value"; "required": false; }; "pluginId": { "alias": "pluginId"; "required": false; }; "caseDefinitionKey": { "alias": "caseDefinitionKey"; "required": false; }; "processVariables": { "alias": "processVariables"; "required": false; }; "disabled": { "alias": "disabled"; "required": false; }; }, { "valueChange": "valueChange"; }, never, never, true, never>;
+}

package/lib/components/value-input/value-input.component.d.ts

@@ -0,0 +1,34 @@
+import { ChangeDetectorRef, EventEmitter, OnChanges, SimpleChanges } from '@angular/core';
+import { ValuePathSelectorPrefix } from '@valtimo/components';
+import * as i0 from "@angular/core";
+export type InputMode = 'browse' | 'pv' | 'expression';
+/**
+ * Reusable 3-mode input (browse / pv / expression) for value resolver expressions.
+ * Used by both ScalarFieldComponent and ArrayFieldComponent for source mapping.
+ */
+export declare class ValueInputComponent implements OnChanges {
+    private readonly cdr;
+    name: string;
+    value: string;
+    pluginId: string;
+    caseDefinitionKey: string | null;
+    processVariables: string[];
+    disabled: boolean;
+    placeholder: string;
+    valueChange: EventEmitter<string>;
+    readonly ValuePathSelectorPrefix: typeof ValuePathSelectorPrefix;
+    inputMode: InputMode;
+    selectedPv: string;
+    browseDefault: string;
+    constructor(cdr: ChangeDetectorRef);
+    ngOnChanges(changes: SimpleChanges): void;
+    setInputMode(mode: InputMode): void;
+    onBrowseValueChange(newValue: string): void;
+    onPvChange(newValue: string): void;
+    onExpressionValueChange(newValue: string): void;
+    private detectInputMode;
+    static ɵfac: i0.ɵɵFactoryDeclaration<ValueInputComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<ValueInputComponent, "epistola-value-input", never, { "name": { "alias": "name"; "required": false; }; "value": { "alias": "value"; "required": false; }; "pluginId": { "alias": "pluginId"; "required": false; }; "caseDefinitionKey": { "alias": "caseDefinitionKey"; "required": false; }; "processVariables": { "alias": "processVariables"; "required": false; }; "disabled": { "alias": "disabled"; "required": false; }; "placeholder": { "alias": "placeholder"; "required": false; }; }, { "valueChange": "valueChange"; }, never, never, true, never>;
+}
+/** Convert slash-notation paths (e.g. doc:/a/b) to dot notation (doc:a.b). */
+export declare function normalizeToDots(value: string): string;

package/lib/epistola.module.d.ts

@@ -1,3 +1,4 @@
+import { ModuleWithProviders } from '@angular/core';
 import * as i0 from "@angular/core";
 import * as i1 from "@angular/common";
 import * as i2 from "@angular/common/http";
@@ -8,13 +9,17 @@ import * as i6 from "./components/generate-document-configuration/generate-docum
 import * as i7 from "./components/check-job-status-configuration/check-job-status-configuration.component";
 import * as i8 from "./components/download-document-configuration/download-document-configuration.component";
 import * as i9 from "./components/data-mapping-tree/data-mapping-tree.component";
-import * as i10 from "./components/field-tree/field-tree.component";
-import * as i11 from "./components/epistola-download/epistola-download.component";
-import * as i12 from "./components/epistola-retry-form/epistola-retry-form.component";
-import * as i13 from "./components/epistola-preview-button/epistola-preview-button.component";
-import * as i14 from "./components/epistola-document-preview/epistola-document-preview.component";
+import * as i10 from "./components/value-input/value-input.component";
+import * as i11 from "./components/scalar-field/scalar-field.component";
+import * as i12 from "./components/array-field/array-field.component";
+import * as i13 from "./components/field-tree/field-tree.component";
+import * as i14 from "./components/epistola-download/epistola-download.component";
+import * as i15 from "./components/epistola-retry-form/epistola-retry-form.component";
+import * as i16 from "./components/epistola-preview-button/epistola-preview-button.component";
+import * as i17 from "./components/epistola-document-preview/epistola-document-preview.component";
 export declare class EpistolaPluginModule {
+    static forRoot(): ModuleWithProviders<EpistolaPluginModule>;
     static ɵfac: i0.ɵɵFactoryDeclaration<EpistolaPluginModule, never>;
-    static ɵmod: i0.ɵɵNgModuleDeclaration<EpistolaPluginModule, never, [typeof i1.CommonModule, typeof i2.HttpClientModule, typeof i3.PluginTranslatePipeModule, typeof i4.FormModule, typeof i4.InputModule, typeof i4.SelectModule, typeof i5.EpistolaConfigurationComponent, typeof i6.GenerateDocumentConfigurationComponent, typeof i7.CheckJobStatusConfigurationComponent, typeof i8.DownloadDocumentConfigurationComponent, typeof i9.DataMappingTreeComponent, typeof i10.FieldTreeComponent, typeof i11.EpistolaDownloadComponent, typeof i12.EpistolaRetryFormComponent, typeof i13.EpistolaPreviewButtonComponent, typeof i14.EpistolaDocumentPreviewComponent], [typeof i5.EpistolaConfigurationComponent, typeof i6.GenerateDocumentConfigurationComponent, typeof i7.CheckJobStatusConfigurationComponent, typeof i8.DownloadDocumentConfigurationComponent, typeof i9.DataMappingTreeComponent, typeof i10.FieldTreeComponent, typeof i11.EpistolaDownloadComponent, typeof i12.EpistolaRetryFormComponent, typeof i13.EpistolaPreviewButtonComponent, typeof i14.EpistolaDocumentPreviewComponent]>;
+    static ɵmod: i0.ɵɵNgModuleDeclaration<EpistolaPluginModule, never, [typeof i1.CommonModule, typeof i2.HttpClientModule, typeof i3.PluginTranslatePipeModule, typeof i4.FormModule, typeof i4.InputModule, typeof i4.SelectModule, typeof i5.EpistolaConfigurationComponent, typeof i6.GenerateDocumentConfigurationComponent, typeof i7.CheckJobStatusConfigurationComponent, typeof i8.DownloadDocumentConfigurationComponent, typeof i9.DataMappingTreeComponent, typeof i10.ValueInputComponent, typeof i11.ScalarFieldComponent, typeof i12.ArrayFieldComponent, typeof i13.FieldTreeComponent, typeof i14.EpistolaDownloadComponent, typeof i15.EpistolaRetryFormComponent, typeof i16.EpistolaPreviewButtonComponent, typeof i17.EpistolaDocumentPreviewComponent], [typeof i5.EpistolaConfigurationComponent, typeof i6.GenerateDocumentConfigurationComponent, typeof i7.CheckJobStatusConfigurationComponent, typeof i8.DownloadDocumentConfigurationComponent, typeof i9.DataMappingTreeComponent, typeof i10.ValueInputComponent, typeof i11.ScalarFieldComponent, typeof i12.ArrayFieldComponent, typeof i13.FieldTreeComponent, typeof i14.EpistolaDownloadComponent, typeof i15.EpistolaRetryFormComponent, typeof i16.EpistolaPreviewButtonComponent, typeof i17.EpistolaDocumentPreviewComponent]>;
     static ɵinj: i0.ɵɵInjectorDeclaration<EpistolaPluginModule>;
 }

package/lib/models/async-resource.d.ts

@@ -0,0 +1,9 @@
+export interface AsyncResource<T> {
+    data: T;
+    loading: boolean;
+    error: string | null;
+}
+export declare function initialResource<T>(empty: T): AsyncResource<T>;
+export declare function loadingResource<T>(current: T): AsyncResource<T>;
+export declare function successResource<T>(data: T): AsyncResource<T>;
+export declare function errorResource<T>(current: T, error: string): AsyncResource<T>;

package/lib/models/index.d.ts

@@ -1,2 +1,3 @@
+export * from './async-resource';
 export * from './config';
 export * from './template';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@epistola.app/valtimo-plugin",
-  "version": "0.3.1",
+  "version": "0.3.2",
   "description": "Epistola document generation plugin for Valtimo",
   "license": "EUPL-1.2",
   "repository": {

package/public_api.d.ts

@@ -6,6 +6,9 @@ export * from './lib/components/epistola-configuration/epistola-configuration.co
 export * from './lib/components/generate-document-configuration/generate-document-configuration.component';
 export * from './lib/components/check-job-status-configuration/check-job-status-configuration.component';
 export * from './lib/components/download-document-configuration/download-document-configuration.component';
+export * from './lib/components/value-input/value-input.component';
+export * from './lib/components/scalar-field/scalar-field.component';
+export * from './lib/components/array-field/array-field.component';
 export * from './lib/components/field-tree/field-tree.component';
 export * from './lib/components/data-mapping-tree/data-mapping-tree.component';
 export * from './lib/components/epistola-download/epistola-download.component';