ngx-t-forms-types 0.0.20 → 0.0.22

package/dist/interfaces/Form/ArrayFunctions.d.ts

@@ -1,11 +1,53 @@
+/**
+ * Declarative array-transform operations applied by the `ngx-t-forms`
+ * array-access engine (`arrayAccessFunctions`). Each member is the string a
+ * config author places in {@link IArrayFunction.function}; the matching
+ * `expression` is interpreted differently per operation (see the
+ * "Array Transform Rules" doc shipped with the library).
+ *
+ * The first three members (`Filter`, `Find`, `Map`) are the original surface
+ * and are unchanged. The remaining members are **additive** - existing configs
+ * keep working untouched.
+ *
+ * @public
+ */
 export declare enum FunctionTypes {
+    /** Keep only the items whose predicate expression evaluates truthy. Returns an array. */
     Filter = "filter",
+    /** Return the first item whose predicate expression evaluates truthy (or `undefined`). Terminal. */
     Find = "find",
-    Map = "map"
+    /** Reshape each item using a projection expression. Returns an array of new objects. */
+    Map = "map",
+    /** Order items by one or more `path asc|desc` keys. Returns an array. */
+    Sort = "sort",
+    /** Take a window of items (`start:end`, a single limit, or `start,count`). Returns an array. */
+    Slice = "slice",
+    /** Drop duplicate items, keyed by whole-item identity or one/more paths. Returns an array. */
+    Unique = "unique",
+    /** Flatten nested arrays one level, or flat-map by a child array path. Returns an array. */
+    Flatten = "flatten",
+    /** Group items into buckets keyed by one or more paths. Returns a record of arrays. Terminal. */
+    GroupBy = "groupBy",
+    /** Aggregate items into a scalar or summary object (sum/avg/min/max/count/first/last/join). Terminal. */
+    Reduce = "reduce"
 }
+/**
+ * A single declarative array-transform step.
+ *
+ * Configs supply an **ordered** `IArrayFunction[]`; the engine folds them
+ * left-to-right (see {@link FunctionTypes} for per-operation `expression`
+ * grammar). Only `function` and `expression` affect runtime behaviour;
+ * `id` and `inEdit` are UI bookkeeping.
+ *
+ * @public
+ */
 export interface IArrayFunction {
+    /** Which transform to apply. */
     function: FunctionTypes;
+    /** Operation-specific expression (predicate, projection, sort keys, etc.). */
     expression: string;
+    /** Stable identity for editing UIs. */
     id: string;
+    /** UI-only flag marking the step as currently being edited. */
     inEdit?: boolean;
 }

package/dist/interfaces/Form/ArrayFunctions.js

@@ -1,7 +1,35 @@
+/**
+ * Declarative array-transform operations applied by the `ngx-t-forms`
+ * array-access engine (`arrayAccessFunctions`). Each member is the string a
+ * config author places in {@link IArrayFunction.function}; the matching
+ * `expression` is interpreted differently per operation (see the
+ * "Array Transform Rules" doc shipped with the library).
+ *
+ * The first three members (`Filter`, `Find`, `Map`) are the original surface
+ * and are unchanged. The remaining members are **additive** - existing configs
+ * keep working untouched.
+ *
+ * @public
+ */
 export var FunctionTypes;
 (function (FunctionTypes) {
+    /** Keep only the items whose predicate expression evaluates truthy. Returns an array. */
     FunctionTypes["Filter"] = "filter";
+    /** Return the first item whose predicate expression evaluates truthy (or `undefined`). Terminal. */
     FunctionTypes["Find"] = "find";
+    /** Reshape each item using a projection expression. Returns an array of new objects. */
     FunctionTypes["Map"] = "map";
+    /** Order items by one or more `path asc|desc` keys. Returns an array. */
+    FunctionTypes["Sort"] = "sort";
+    /** Take a window of items (`start:end`, a single limit, or `start,count`). Returns an array. */
+    FunctionTypes["Slice"] = "slice";
+    /** Drop duplicate items, keyed by whole-item identity or one/more paths. Returns an array. */
+    FunctionTypes["Unique"] = "unique";
+    /** Flatten nested arrays one level, or flat-map by a child array path. Returns an array. */
+    FunctionTypes["Flatten"] = "flatten";
+    /** Group items into buckets keyed by one or more paths. Returns a record of arrays. Terminal. */
+    FunctionTypes["GroupBy"] = "groupBy";
+    /** Aggregate items into a scalar or summary object (sum/avg/min/max/count/first/last/join). Terminal. */
+    FunctionTypes["Reduce"] = "reduce";
     // Add more function types here as needed
 })(FunctionTypes || (FunctionTypes = {}));

package/dist/interfaces/Form/FormInClassUtils.d.ts

@@ -11,20 +11,22 @@ export interface InClassFormUtilsInterface {
     /**
      * Function to perform an HTTP GET request.
      * @param url - The URL to send the request to.
+     * @param options - Implementation-defined request options (consumer narrows).
      * @returns A promise that resolves to the response data.
      */
-    httpGetDataFunction: (url: string, options: any) => Observable<any>;
+    httpGetDataFunction: (url: string, options: unknown) => Observable<unknown>;
     /**
      * Function to perform an HTTP POST request.
      * @param url - The URL to send the request to.
      * @param data - The data to send in the request body.
+     * @param options - Implementation-defined request options (consumer narrows).
      * @returns A promise that resolves to the response data.
      */
-    httpPostDataFunction: (url: string, data: any, options: any) => Observable<any>;
+    httpPostDataFunction: (url: string, data: unknown, options: unknown) => Observable<unknown>;
     submitForm: () => Observable<void>;
     saveFormData: () => Observable<void>;
-    runPipeLine: (pipeline: any, workflowId: string) => Observable<{
-        results: any;
+    runPipeLine: (pipeline: unknown, workflowId: string) => Observable<{
+        results: unknown;
         message: string;
     }>;
     fileUpload: FileUploadFn;

package/dist/interfaces/Form/formInterface.d.ts

@@ -2,7 +2,12 @@ import { FormSlideInterface } from "../FormSlide/formSlideInterface.js";
 import { FormSubmissionHandleInterface } from "./formSubmissionHandleInterface.js";
 export interface FormInterface {
     slides: Array<FormSlideInterface>;
-    submissionHandle: FormSubmissionHandleInterface;
+    /**
+     * Optional submission target. Empty-form factories (e.g. `createEmptyForm()`)
+     * legitimately have none until the consumer configures one; downstream
+     * consumers guard before reading.
+     */
+    submissionHandle?: FormSubmissionHandleInterface;
     formId: string | any;
     formTitle: string;
     submissionMessage?: string;

package/dist/interfaces/Form/index.d.ts

@@ -1,6 +1,6 @@
 import { NgxTFormsConfig } from "../environment/environment.js";
 import { FormColumnInputs } from "../formInput/BasicFormInputInterface.js";
-import { IAllInputs, OLD_FormInterface } from "../upgradeFunctions/interfaces/init-form.js";
+import { FormInterfaceMigration, IAllInputs, OLD_FormInterface } from "../upgradeFunctions/interfaces/init-form.js";
 import { IArrayFunction } from "./ArrayFunctions.js";
 import { CustomConfigInterface } from "./CustomeConfigInter.js";
 import { FileData, FileUploadFn } from "./FileUploadFn.js";
@@ -9,4 +9,5 @@ import { IFormActions, InClassFormUtilsInterface, InClassFormUtilsWithSectionsIn
 import { FormInterface, DatabaseFormInterface, MainFormInterface } from "./formInterface.js";
 import { FormSubmissionHandleInterface, IReportDataSources } from "./formSubmissionHandleInterface.js";
 import { FormListSection, FormStateErrors, IFormsInitStateInterface, LocalFormStateSelectorInterface } from "./IFormsInitStateInterface.js";
-export { CustomConfigInterface, InClassFormUtilsInterface, InClassFormUtilsWithSectionsInterface, FormInterface, MainFormInterface, DatabaseFormInterface, FormSubmissionHandleInterface, FormColumnInputs, IFormActions, NgxTFormsConfig, FileUploadFn, FileData, FormListSection, LocalFormStateSelectorInterface, IFormsInitStateInterface, FormStateErrors, IArrayFunction, OLD_FormInterface, IAllInputs, IFormChangeHistory, IReportDataSources };
+export { CustomConfigInterface, InClassFormUtilsInterface, InClassFormUtilsWithSectionsInterface, FormInterface, MainFormInterface, DatabaseFormInterface, FormSubmissionHandleInterface, FormColumnInputs, IFormActions, NgxTFormsConfig, FileUploadFn, FileData, FormListSection, LocalFormStateSelectorInterface, IFormsInitStateInterface, FormStateErrors, IArrayFunction, OLD_FormInterface, FormInterfaceMigration, IAllInputs, IFormChangeHistory, IReportDataSources };
+export { FunctionTypes } from "./ArrayFunctions.js";

package/dist/interfaces/Form/index.js

@@ -1,2 +1,6 @@
 import { FormListSection, FormStateErrors } from "./IFormsInitStateInterface.js";
 export { FormListSection, FormStateErrors };
+// Array-access transform operations (filter/find/map/sort/slice/unique/flatten/
+// groupBy/reduce) - exported as a value enum so config authors can reference
+// `FunctionTypes.Sort` etc. when authoring `IArrayFunction[]` access rules.
+export { FunctionTypes } from "./ArrayFunctions.js";

package/dist/interfaces/FormBuilder/DefaultEelement.js

@@ -780,7 +780,7 @@ export const DefaultInputConfig = {
             validators: [],
             appearance: 'outline',
             isCalculatedField: false,
-            richTextEditorLibrary: RichTextEditorType.EditorJS,
+            richTextEditorLibrary: RichTextEditorType.Quill,
         },
     },
     [ElementTypes.MscoaSelection]: {

package/dist/interfaces/FormBuilder/DefaultInputConfigInterface.d.ts

@@ -4,8 +4,19 @@ import { IPaginatedSelectionTableInputInterface, ISelectInputInterface } from ".
 import { IRichTextEditor } from "../formInput/RichTextEditorInput.js";
 import { IWorkflowDocumentPicker } from "../formInput/WorkflowDocumentPicker.js";
 import { AllFormInputPrimaryKeys, FormInputKeys, SpecialElementKeys } from "./FormInputKeys.js";
+/**
+ * Configuration map for the form-builder's default element templates.
+ *
+ * NOTE (H-014): All members are optional. Several `ElementTypes` members
+ * (`QrCodeScanner`, `QrCodeGenerator`, `OcrInput`, `MatrixTable`) are currently
+ * commented out of the enum itself, and a few populated entries are still in
+ * flight — making every key optional lets consumers safely look up by element
+ * with `defaultInputs[input.element]?.requiredProperties` without `as any`
+ * casts. When the enum re-introduces those members, the matching shapes can be
+ * un-commented below.
+ */
 export interface DefaultInputConfigInterface {
-    [ElementTypes.Input]: {
+    [ElementTypes.Input]?: {
         label: string;
         disabled: boolean;
         illustration: string;
@@ -13,7 +24,7 @@ export interface DefaultInputConfigInterface {
         elementTemplate: IFormElementTemplate;
         requiredProperties: Array<FormInputKeys | AllFormInputPrimaryKeys>;
     };
-    [ElementTypes.Location]: {
+    [ElementTypes.Location]?: {
         label: string;
         disabled: boolean;
         illustration: string;
@@ -21,7 +32,7 @@ export interface DefaultInputConfigInterface {
         elementTemplate: IFormElementTemplate;
         requiredProperties: Array<FormInputKeys | AllFormInputPrimaryKeys>;
     };
-    [ElementTypes.AutoCompleteInput]: {
+    [ElementTypes.AutoCompleteInput]?: {
         label: string;
         disabled: boolean;
         illustration: string;
@@ -29,7 +40,7 @@ export interface DefaultInputConfigInterface {
         elementTemplate: IFormElementTemplate;
         requiredProperties: Array<FormInputKeys | AllFormInputPrimaryKeys>;
     };
-    [ElementTypes.Toggle]: {
+    [ElementTypes.Toggle]?: {
         label: string;
         disabled: boolean;
         illustration: string;
@@ -37,7 +48,7 @@ export interface DefaultInputConfigInterface {
         elementTemplate: IToggleInput;
         requiredProperties: Array<FormInputKeys | AllFormInputPrimaryKeys>;
     };
-    [ElementTypes.Select]: {
+    [ElementTypes.Select]?: {
         label: string;
         disabled: boolean;
         illustration: string;
@@ -45,7 +56,7 @@ export interface DefaultInputConfigInterface {
         elementTemplate: ISelectInputInterface;
         requiredProperties: Array<FormInputKeys | AllFormInputPrimaryKeys>;
     };
-    [ElementTypes.PaginatedSelectionTable]: {
+    [ElementTypes.PaginatedSelectionTable]?: {
         label: string;
         disabled: boolean;
         illustration: string;
@@ -53,7 +64,7 @@ export interface DefaultInputConfigInterface {
         elementTemplate: IPaginatedSelectionTableInputInterface;
         requiredProperties: Array<FormInputKeys | AllFormInputPrimaryKeys>;
     };
-    [ElementTypes.IconSelect]: {
+    [ElementTypes.IconSelect]?: {
         label: string;
         illustration: string;
         properties: Array<FormInputKeys | AllFormInputPrimaryKeys>;
@@ -61,7 +72,7 @@ export interface DefaultInputConfigInterface {
         disabled: boolean;
         requiredProperties: Array<FormInputKeys | AllFormInputPrimaryKeys>;
     };
-    [ElementTypes.Textarea]: {
+    [ElementTypes.Textarea]?: {
         label: string;
         disabled: boolean;
         illustration: string;
@@ -69,7 +80,7 @@ export interface DefaultInputConfigInterface {
         elementTemplate: ITextareaProperties;
         requiredProperties: Array<FormInputKeys | AllFormInputPrimaryKeys>;
     };
-    [ElementTypes.DatePicker]: {
+    [ElementTypes.DatePicker]?: {
         label: string;
         disabled: boolean;
         illustration: string;
@@ -77,7 +88,7 @@ export interface DefaultInputConfigInterface {
         elementTemplate: IFormElementTemplate;
         requiredProperties: Array<FormInputKeys | AllFormInputPrimaryKeys>;
     };
-    [ElementTypes.DateRangePicker]: {
+    [ElementTypes.DateRangePicker]?: {
         label: string;
         disabled: boolean;
         illustration: string;
@@ -85,7 +96,7 @@ export interface DefaultInputConfigInterface {
         elementTemplate: IDateRangePickerInput;
         requiredProperties: Array<FormInputKeys | AllFormInputPrimaryKeys>;
     };
-    [ElementTypes.FileUpload]: {
+    [ElementTypes.FileUpload]?: {
         label: string;
         disabled: boolean;
         illustration: string;
@@ -93,7 +104,7 @@ export interface DefaultInputConfigInterface {
         elementTemplate: IFileUploadInput;
         requiredProperties: Array<FormInputKeys | AllFormInputPrimaryKeys>;
     };
-    [ElementTypes.Signature]: {
+    [ElementTypes.Signature]?: {
         label: string;
         disabled: boolean;
         illustration: string;
@@ -101,7 +112,7 @@ export interface DefaultInputConfigInterface {
         elementTemplate: IFormElementTemplate;
         requiredProperties: Array<FormInputKeys | AllFormInputPrimaryKeys>;
     };
-    [ElementTypes.ImageCapture]: {
+    [ElementTypes.ImageCapture]?: {
         label: string;
         disabled: boolean;
         illustration: string;
@@ -109,7 +120,7 @@ export interface DefaultInputConfigInterface {
         elementTemplate: IFormElementTemplate;
         requiredProperties: Array<FormInputKeys | AllFormInputPrimaryKeys>;
     };
-    [ElementTypes.SectionTitle]: {
+    [ElementTypes.SectionTitle]?: {
         label: string;
         disabled: boolean;
         illustration: string;
@@ -117,7 +128,7 @@ export interface DefaultInputConfigInterface {
         elementTemplate: IFormElementTemplate;
         requiredProperties: Array<FormInputKeys | AllFormInputPrimaryKeys>;
     };
-    [ElementTypes.MultipleInput]: {
+    [ElementTypes.MultipleInput]?: {
         label: string;
         disabled: boolean;
         illustration: string;
@@ -125,7 +136,7 @@ export interface DefaultInputConfigInterface {
         elementTemplate: IMultiple;
         requiredProperties: Array<FormInputKeys | AllFormInputPrimaryKeys>;
     };
-    [ElementTypes.Editor]: {
+    [ElementTypes.Editor]?: {
         label: string;
         disabled: boolean;
         illustration: string;
@@ -133,7 +144,7 @@ export interface DefaultInputConfigInterface {
         elementTemplate: IRichTextEditor;
         requiredProperties: Array<FormInputKeys | AllFormInputPrimaryKeys>;
     };
-    [ElementTypes.MscoaSelection]: {
+    [ElementTypes.MscoaSelection]?: {
         label: string;
         disabled: boolean;
         illustration: string;
@@ -141,7 +152,7 @@ export interface DefaultInputConfigInterface {
         elementTemplate: IScoaInput;
         requiredProperties: Array<FormInputKeys | SpecialElementKeys | AllFormInputPrimaryKeys>;
     };
-    [ElementTypes.WorkflowDocumentPicker]: {
+    [ElementTypes.WorkflowDocumentPicker]?: {
         label: string;
         disabled: boolean;
         illustration: string;
@@ -149,7 +160,7 @@ export interface DefaultInputConfigInterface {
         elementTemplate: IWorkflowDocumentPicker;
         requiredProperties: Array<FormInputKeys | AllFormInputPrimaryKeys>;
     };
-    [ElementTypes.WorkflowAdjudication]: {
+    [ElementTypes.WorkflowAdjudication]?: {
         label: string;
         disabled: boolean;
         illustration: string;

package/dist/interfaces/FormBuilder/FormBuilderCallBackFunctions.d.ts

@@ -15,5 +15,13 @@ export interface FormBuilderFunctions {
     getSCOAAccount: (SCOAAccount: string) => Observable<{
         accounts: IScoaAccount[];
     }>;
-    reorderItems: (event: CdkDragDrop<FormColumnInputs[], any, any>, multipleInputId: string) => void;
+    /**
+     * Reorders items within a multiple-input column list.
+     *
+     * Generic `T` covers any row shape assignable to `FormColumnInputs` so consumers
+     * can pass narrower row types (e.g. `ITowerStepColumn[]`) without casting.
+     * The container/data/predicate generic slots on `CdkDragDrop` are kept as
+     * `unknown` — the runtime payload is opaque to this contract; consumers narrow.
+     */
+    reorderItems: <T extends FormColumnInputs = FormColumnInputs>(event: CdkDragDrop<T[], unknown, unknown>, multipleInputId: string) => void;
 }

package/dist/interfaces/FormBuilder/elementEditor.d.ts

@@ -35,7 +35,8 @@ export declare enum ElementEditorTypes {
     ListLabelConfigEditor = "listLabelConfigEditor",
     DecisionGateSettings = "decisionGateSettings",
     RecordListManager = "recordListManager",
-    MapMatOptionsKeys = "mapMatOptionsKeys"
+    MapMatOptionsKeys = "mapMatOptionsKeys",
+    FormPayloadProjection = "formPayloadProjection"
 }
 export interface ElementEditorConfigInterface {
     editorSections: Array<ElementEditorConfigSectionInterface>;

package/dist/interfaces/FormBuilder/elementEditor.js

@@ -30,6 +30,7 @@ export var ElementEditorTypes;
     ElementEditorTypes["DecisionGateSettings"] = "decisionGateSettings";
     ElementEditorTypes["RecordListManager"] = "recordListManager";
     ElementEditorTypes["MapMatOptionsKeys"] = "mapMatOptionsKeys";
+    ElementEditorTypes["FormPayloadProjection"] = "formPayloadProjection";
 })(ElementEditorTypes || (ElementEditorTypes = {}));
 // interface TStringExpressionValidationTest{
 //   expression: string;

package/dist/interfaces/FormBuilder/index.d.ts

@@ -7,4 +7,5 @@ import { IWorkflowOption } from "./workflowSelectionConfig.js";
 import { FormBuilderFunctions } from "./FormBuilderCallBackFunctions.js";
 import { IGetPostmanCollections, IPostmanCollectionConfig } from "./postmanCollection.js";
 import { DataSources } from "../formInput/APIDataFetchingConfigurationInterface.js";
-export { DefaultInputConfigInterface, BlurHandleTypes, FormInputKeys, ElementEditorTypes, ConfigurationValidTestInterface, ElementEditorInnerSectionElementInterface, SpecialElementKeys, AllFormInputPrimaryKeys, DefaultInputConfig, defaultInputs, getElementEditorConfig, IWorkflowOption, FormBuilderFunctions, IGetPostmanCollections, IPostmanCollectionConfig, DataSources, ElementEditorConfigSectionInterface };
+import { IScoaAccount } from "../formInput/IMscoaAccount.js";
+export { DefaultInputConfigInterface, BlurHandleTypes, FormInputKeys, ElementEditorTypes, ConfigurationValidTestInterface, ElementEditorInnerSectionElementInterface, SpecialElementKeys, AllFormInputPrimaryKeys, DefaultInputConfig, defaultInputs, getElementEditorConfig, IWorkflowOption, FormBuilderFunctions, IGetPostmanCollections, IPostmanCollectionConfig, DataSources, ElementEditorConfigSectionInterface, IScoaAccount, };

package/dist/interfaces/FormBuilder/index.js

@@ -3,4 +3,4 @@ import { getElementEditorConfig } from "./inputConfig/ElementEditConfig.js";
 import { AllFormInputPrimaryKeys, FormInputKeys, SpecialElementKeys } from "./FormInputKeys.js";
 import { BlurHandleTypes, ElementEditorTypes } from "./elementEditor.js";
 import { DataSources } from "../formInput/APIDataFetchingConfigurationInterface.js";
-export { BlurHandleTypes, FormInputKeys, ElementEditorTypes, SpecialElementKeys, AllFormInputPrimaryKeys, DefaultInputConfig, defaultInputs, getElementEditorConfig, DataSources };
+export { BlurHandleTypes, FormInputKeys, ElementEditorTypes, SpecialElementKeys, AllFormInputPrimaryKeys, DefaultInputConfig, defaultInputs, getElementEditorConfig, DataSources, };

package/dist/interfaces/FormBuilder/inputConfig/ElementEditConfig.js

@@ -369,12 +369,16 @@ export var ElementConfig = {
                     fetchOptions: ['mscoaConfig', 'showAllSegments'],
                     additionalTest: [
                         {
-                            expression: `accountingBasis !== ${AccountingBasis.Accrual}`,
+                            // Show the cash-segments editor ONLY for an explicit Cash/Dual basis.
+                            // A positive whitelist (not `!== Accrual`) also hides it for the
+                            // unset/`undefined` default of a freshly-added input — `!== Accrual`
+                            // is true for `undefined`, which left it always visible.
+                            expression: `accountingBasis === ${AccountingBasis.Cash} || accountingBasis === ${AccountingBasis.Dual}`,
                             deepBind: ['mscoaConfig', 'accountingBasis'],
                         },
                     ],
                     hint: "Configure SCOA segments to be When mapping the Cash accounts",
-                    id: "d9ea60b9-653f-4d9c-88bd-f603a589cce0"
+                    id: "f1a2b3c4-d5e6-4f70-8a9b-0c1d2e3f4a5b"
                 },
                 {
                     name: AllFormInputPrimaryKeys.MscoaConfig,
@@ -450,7 +454,7 @@ export var ElementConfig = {
                             value: 'default'
                         },
                         { label: 'Postman API', value: DataSources.Api },
-                        { label: 'Data Pipeline', value: DataSources.MongoDb },
+                        // { label: 'Data Pipeline', value: DataSources.MongoDb },
                     ],
                     id: "f04cc297-9b22-403a-afe4-4fb2e84fa503"
                 },

package/dist/interfaces/Import/ImportProgress.d.ts

@@ -14,11 +14,13 @@ export interface ImportProgress {
     pending: number;
     /** Rows currently processing. */
     processing: number;
-    /** `valid` + `invalid` — i.e. rows that fully settled (regardless of validity). */
+    /** `valid` + `overridable` + `invalid` — i.e. rows that fully settled (regardless of validity). */
     complete: number;
     /** Rows that settled with no errors. */
     valid: number;
-    /** Rows that settled with at least one error. */
+    /** Rows that settled with only overridable (motivatable) errors — no blocking errors. */
+    overridable: number;
+    /** Rows that settled with at least one blocking error. */
     invalid: number;
     /** Rows that threw before settling. */
     error: number;

package/dist/interfaces/Import/ImportRowState.d.ts

@@ -4,15 +4,21 @@
  *
  * - `pending`    — queued, tower not yet created.
  * - `processing` — tower is initialising / preprocessing / awaiting settle.
- * - `valid`      — settled with no validator errors.
- * - `invalid`    — settled but at least one validator error or pre-process error.
- * - `error`      — `_processRow` threw before settle (tower init failure, etc.).
+ * - `valid`       — settled with no validator errors.
+ * - `overridable`  — settled with NO blocking errors, but at least one
+ *   overridable (`canOverride === true`) custom-validator error remains. The
+ *   row is not strictly valid, yet it could be submitted once each overridable
+ *   validation is motivated (see {@link ImportRowState.overridableErrors}).
+ * - `invalid`     — settled with at least one blocking validator error or
+ *   pre-process error (a row carrying both blocking and overridable errors is
+ *   `invalid`, not `overridable`).
+ * - `error`       — `_processRow` threw before settle (tower init failure, etc.).
  *
  * Upstreamed from `ngx-t-forms` per DECISIONS.md D-016.
  *
  * @public
  */
-export type ImportRowStatus = 'pending' | 'processing' | 'valid' | 'invalid' | 'error';
+export type ImportRowStatus = 'pending' | 'processing' | 'valid' | 'overridable' | 'invalid' | 'error';
 /**
  * Per-row state recorded throughout an import session.
  *
@@ -33,8 +39,20 @@ export interface ImportRowState {
      * `valid` or `invalid`.
      */
     settledValue?: Record<string, unknown>;
-    /** `true` when no validation/column errors were collected. */
+    /**
+     * `true` when no validation/column errors were collected at all (status
+     * `valid`). An `overridable` row reports `false` here — it is bypassable,
+     * not strictly valid.
+     */
     isValid?: boolean;
+    /**
+     * inputId → array of overridable (`canOverride === true`) custom-validator
+     * messages that remain on the settled row. Present (non-empty) when
+     * `status === 'overridable'`; consumers use it to render a motivation
+     * prompt per failing input. Blocking errors are NOT included here — see
+     * {@link ImportRowState.validationErrors}.
+     */
+    overridableErrors?: Record<string, string[]>;
     /** inputId → array of Angular validator error keys (e.g. `['required', 'minlength']`). */
     validationErrors?: Record<string, string[]>;
     /**

package/dist/interfaces/formInput/FileUploadInputInterface.d.ts

@@ -37,7 +37,12 @@ export declare enum InputFileType {
 }
 export interface FileUploadInputValueInterface {
     fileName: string;
-    type: InputFileType | undefined;
+    /**
+     * Either an `InputFileType` enum member or a raw MIME type string
+     * (e.g. `'image/png'`). The enum was never enforced on the value side; some
+     * factories (e.g. base64-derived uploads) carry the MIME directly.
+     */
+    type: InputFileType | string | undefined;
     base64: string | ArrayBuffer | null;
     blob: Blob;
     fileExtension: string;

package/dist/interfaces/formInput/FormControlCustomValidatorsInterface.d.ts

@@ -1,10 +1,44 @@
+import { CalculationFunctions } from "./calculationVariableInterface.js";
+/**
+ * A single dependency the validator expression observes.
+ *
+ * `inputId` is the input whose value is read; `variable` is the name the
+ * expression references it by.
+ *
+ * ### Multiple-input (list) bindings
+ * When the bound input lives inside a repeatable "multiple input" group, the
+ * value is an array of rows rather than a scalar:
+ * - `parentInputId` — the id of the multiple-input container whose value is the
+ *   row array. Present for any binding to a list sub-item.
+ * - `function` — the aggregate applied to reduce the list column to a single
+ *   value (sum/avg/min/max/count). Required when the validator lives on a
+ *   primary-form input and references a list sub-item (the array must be
+ *   reduced to a scalar). Omitted when the validator lives on a sub-item of the
+ *   *same* group, where peers resolve to the current row's value directly.
+ */
+export interface InputObservedForChange {
+    inputId: string;
+    variable: string;
+    /** Multiple-input container id whose value is the row array (list bindings only). */
+    parentInputId?: string;
+    /** Aggregate applied to reduce a list column to a single value. */
+    function?: CalculationFunctions;
+}
 export interface FormControlCustomValidatorsInterface {
     id: string;
     message: string;
     expression: string;
     canOverride: boolean;
-    inputsObservedForChanges: {
-        inputId: string;
-        variable: string;
-    }[];
+    inputsObservedForChanges: InputObservedForChange[];
 }
+/**
+ * Draft variant of {@link FormControlCustomValidatorsInterface} used while a
+ * new validator is being authored in the UI. The `id` is assigned on save
+ * (e.g. via `uuidv4()`), so the in-flight draft is intentionally id-less.
+ *
+ * Use the union `DraftFormControlCustomValidator | FormControlCustomValidatorsInterface`
+ * in builder/editor APIs that accept either an unsaved draft or a persisted record.
+ */
+export type DraftFormControlCustomValidator = Omit<FormControlCustomValidatorsInterface, 'id'> & {
+    id?: string;
+};

package/dist/interfaces/formInput/FormValidationOverride.d.ts

@@ -0,0 +1,48 @@
+import { FileData } from "../Form/FileUploadFn.js";
+/**
+ * A single bypassed (overridden) validation captured at submission time.
+ *
+ * A custom validator declared with {@link FormControlCustomValidatorsInterface.canOverride}
+ * `=== true` does NOT block submission outright: when every blocking
+ * (`canOverride === false`) validation on the form is resolved, the user may
+ * submit by motivating each still-failing overridable validation. Each such
+ * motivation is recorded as one entry of this shape and carried on the
+ * submission payload (under the `_validationOverrides` key) so the bypass is
+ * durable and auditable.
+ *
+ * @example
+ *   {
+ *     formControlName: 'invoiceTotal',
+ *     validationMessage: 'Total exceeds the approved budget',
+ *     comment: 'Approved verbally by the finance lead — see attached email.',
+ *     attachment: { base64: '…', fileName: 'approval.pdf', type: 'application/pdf', id: '…', fileExtension: 'pdf' },
+ *   }
+ *
+ * @public
+ */
+export interface IFormValidationOverride {
+    /**
+     * `formControlName` of the input whose overridable validation was bypassed.
+     * Mirrors {@link FormColumnInputs.formControlName} so consumers can map the
+     * override back to a field.
+     */
+    formControlName: string;
+    /**
+     * The overridden validator's human-readable message, taken verbatim from
+     * {@link FormControlCustomValidatorsInterface.message}. The captured
+     * motivation must correspond to this specific validation.
+     */
+    validationMessage: string;
+    /**
+     * User-supplied motivation for bypassing the validation. A non-empty,
+     * non-whitespace value is REQUIRED for the override to count — the form
+     * cannot be submitted while any overridable validation lacks a comment.
+     */
+    comment: string;
+    /**
+     * Optional supporting file backing the motivation. Carried as
+     * {@link FileData} (base64) so the submission upload pass resolves it to a
+     * `{ url }` exactly like a file-upload input value.
+     */
+    attachment?: FileData;
+}

package/dist/interfaces/formInput/FormValidationOverride.js

@@ -0,0 +1 @@
+export {};

package/dist/interfaces/formInput/IMscoaAccount.d.ts

@@ -63,19 +63,44 @@ export interface ScoaInterface extends IScoaInputConfig {
     validationErrors: MscoaValuetValidationErrors;
     getTreeResponse: IGetTreeResponse | null;
 }
+/**
+ * Per-segment value bag stored under `ScoaSegmentValue[segmentKey]` and
+ * surfaced on row models (e.g. `ITableScoaSelectionRow.segmentValue`).
+ *
+ * Holds the debit/credit account pair plus optional metadata flags such as
+ * `vatApplicableTo`. UI consumers read the bag by column key
+ * (`'debit' | 'credit'`); selectors also stamp dynamic counter-account keys
+ * (e.g. `${name}Credit` / `${name}Debit`) onto the row at runtime.
+ */
+export interface ScoaSegmentValueBag {
+    debit?: IScoaAccount | undefined;
+    credit?: IScoaAccount | undefined;
+    vatApplicableTo?: string;
+    /**
+     * Segment-scoped custom-input values, written as siblings of `debit`/`credit`
+     * (e.g. `budgetValue`, `department`) and keyed by the custom input's
+     * `formControlName`. Typed `unknown` because a custom input may carry any
+     * dynamic-input value (number, string, boolean, date, object); narrow at the
+     * read site. The reserved keys above (`debit`/`credit`/`vatApplicableTo`, plus
+     * the runtime-derived `vat`) retain their precise types.
+     */
+    [customKey: string]: unknown;
+}
 export interface ScoaSegmentValue {
-    [key: string]: {
-        debit: IScoaAccount | undefined;
-        credit: IScoaAccount | undefined;
-        vatApplicableTo?: string;
-    };
+    [key: string]: ScoaSegmentValueBag;
 }
 export type ScoaAccountTree = {
     [key: string]: ScoaAccountTree;
 };
 export interface ITableScoaSelectionRow extends IIncludedSegmentConfig {
     segmentTree: ScoaAccountTree;
-    segmentValue: IScoaAccount | undefined;
+    /**
+     * Runtime shape: a per-column bag of debit/credit accounts with optional
+     * VAT metadata. Historically declared as `IScoaAccount | undefined`, which
+     * never matched the value the selector pipeline writes; widened to a union
+     * so legacy readers keep narrowing while new callers can read the bag.
+     */
+    segmentValue: ScoaSegmentValueBag | undefined;
     debit: string;
     credit: string;
 }

package/dist/interfaces/formInput/MscoaInput.d.ts

@@ -11,6 +11,13 @@ export interface IMscoaFormInput extends IBasicFormInput {
     };
 }
 export interface ScoaInnerInput extends FormColumnInputs {
+    /**
+     * Id of the `IIncludedSegmentConfig` this custom input is attached to
+     * (i.e. `IIncludedSegmentConfig.id`). When set, the input renders inside that
+     * segment's row and its value is projected into
+     * `segmentValues[basis][SEGMENT][formControlName]` as a sibling of
+     * debit/credit. Empty/absent means the input is a standalone segment row.
+     */
     linkedSegmentId: string;
 }
 export interface ScoreSheetItem {

package/dist/interfaces/formInput/RichTextEditorInput.d.ts

@@ -1,8 +1,22 @@
 import { IBasicFormInput } from ".";
+/**
+ * Identifies the rich text editor library to render for a {@link IRichTextEditor} form input.
+ */
 export declare enum RichTextEditorType {
-    EditorJS = "EditorJS",
-    CkEditor = "CkEditor"
+    /** The Quill rich text editor. */
+    Quill = "Quill",
+    /**
+     * The EditorJS block-style editor.
+     *
+     * @deprecated EditorJS is no longer supported and will be removed in a future
+     * release. Use {@link RichTextEditorType.Quill} instead.
+     */
+    EditorJS = "EditorJS"
 }
+/**
+ * A form input backed by a rich text editor.
+ */
 export interface IRichTextEditor extends IBasicFormInput {
+    /** The rich text editor library used to render this input. */
     richTextEditorLibrary: RichTextEditorType;
 }

package/dist/interfaces/formInput/RichTextEditorInput.js

@@ -1,5 +1,15 @@
+/**
+ * Identifies the rich text editor library to render for a {@link IRichTextEditor} form input.
+ */
 export var RichTextEditorType;
 (function (RichTextEditorType) {
+    /** The Quill rich text editor. */
+    RichTextEditorType["Quill"] = "Quill";
+    /**
+     * The EditorJS block-style editor.
+     *
+     * @deprecated EditorJS is no longer supported and will be removed in a future
+     * release. Use {@link RichTextEditorType.Quill} instead.
+     */
     RichTextEditorType["EditorJS"] = "EditorJS";
-    RichTextEditorType["CkEditor"] = "CkEditor";
 })(RichTextEditorType || (RichTextEditorType = {}));

package/dist/interfaces/formInput/WorkflowAdjudication.d.ts

@@ -16,11 +16,23 @@ export interface AdjResponseReviewColumnMapping {
 }
 export interface WorkflowAdjudicationMicroFlowReviewValue {
     id: string;
-    adj_microFlow_review: boolean;
+    /**
+     * Reviewer's compliance verdict for this micro-flow submission.
+     * Optional: `undefined` represents "not yet reviewed".
+     */
+    adj_microFlow_review?: 'compliant' | 'non-compliant';
+    /**
+     * Optional reviewer notes for this submission. Stored as a structured payload
+     * (e.g. EditorJS `OutputData`) or a plain string depending on the consumer renderer;
+     * typed as `unknown` here so the shared interface stays renderer-agnostic.
+     */
+    adj_microFlow_review_notes?: unknown;
     nameOfBidder: string;
     supplierNumber: string;
-    createdAt: Date;
-    updatedAt: Date;
+    /** Optional — populated from the underlying submission row when available. */
+    createdAt?: Date;
+    /** Optional — populated from the underlying submission row when available. */
+    updatedAt?: Date;
     adjudicationPricePreferenceCalculation: number;
     reference: string;
 }

package/dist/interfaces/formInput/calculationVariableInterface.d.ts

@@ -17,5 +17,7 @@ export declare enum CalculationFunctions {
     Avg = "avg",
     Sum = "sum",
     Max = "max",
-    Min = "min"
+    Min = "min",
+    /** Number of rows in the list (does not require a numeric column). */
+    Count = "count"
 }

package/dist/interfaces/formInput/calculationVariableInterface.js

@@ -4,4 +4,6 @@ export var CalculationFunctions;
     CalculationFunctions["Sum"] = "sum";
     CalculationFunctions["Max"] = "max";
     CalculationFunctions["Min"] = "min";
+    /** Number of rows in the list (does not require a numeric column). */
+    CalculationFunctions["Count"] = "count";
 })(CalculationFunctions || (CalculationFunctions = {}));

package/dist/interfaces/formInput/index.d.ts

@@ -5,9 +5,10 @@ import { APIDataFetchingConfigurationInterface, InputAPIDataId, MongoDbPipeLineC
 import { AutocapitalizeOptions, AutocompleteOptions, ElementTypes, IBasicFormInput, IFormElementTemplate, InputDataTypes, InputPipeTypes, InputTypes, OptionSelectTypes } from "./BasicFormInputInterface.js";
 import { IDateRangePickerInput } from "./DateRangePickerInput.js";
 import { AllDocumentFileExtensions, AllImageFileExtensions, FileUploadInputValueInterface, IFileUploadInput, InputFileType, UploadTypes } from "./FileUploadInputInterface.js";
-import { FormControlCustomValidatorsInterface } from "./FormControlCustomValidatorsInterface.js";
+import { DraftFormControlCustomValidator, FormControlCustomValidatorsInterface, InputObservedForChange } from "./FormControlCustomValidatorsInterface.js";
+import { IFormValidationOverride } from "./FormValidationOverride.js";
 import { FormInputBasicOptionInterface } from "./FormInputBasicOptionInterface.js";
-import { AccountingBasis, IAccountSegmentTreeKeys, IGetTreeResponse, IIncludedSegmentConfig, IScoaAccount, IScoaInput, IScoaInputConfig, ITableScoaSelectionRow, ScoaAccountTree, ScoaInterface, ScoaSegmentValue } from "./IMscoaAccount.js";
+import { AccountingBasis, IAccountSegmentTreeKeys, IGetTreeResponse, IIncludedSegmentConfig, IScoaAccount, IScoaInput, IScoaInputConfig, ITableScoaSelectionRow, ScoaAccountTree, ScoaInterface, ScoaSegmentValue, ScoaSegmentValueBag } from "./IMscoaAccount.js";
 import { ISelectInputInterface } from "./ISelectInputInterface.js";
 import { MatDataOptionsInterface } from "./MatDataOptionsInterface.js";
 import { IMatrixInput } from "./MatrixInputInterface.js";
@@ -24,4 +25,4 @@ import { CalculationFunctions, calculationVariableInterface } from "./calculatio
 import { IRichTextEditor, RichTextEditorType } from "./RichTextEditorInput.js";
 import { ValidationError, ValidationOptions } from "./schema.js";
 import { IUserSignature } from "./userSignature.js";
-export { ElementTypes, InputTypes, InputPipeTypes, AutocapitalizeOptions, AutocompleteOptions, InputDataTypes, MinInputTypes, IFormElementTemplate, IBasicFormInput, IFileUploadInput, IDateRangePickerInput, ITextareaProperties, IToggleInput, IMatrixInput, IMultiple, IMultipleInputCal, IScoaInput, TableConfigurationsInterface, TableColumnConfigInterface, FormControlCustomValidatorsInterface, MinimumInputRequiredInterface, MinInputMapInput, CalculatedFieldRules, calculationVariableInterface, APIDataFetchingConfigurationInterface, IGetTreeResponse, CalculationFunctions, TreeNode, IPostmanCollection, IFolderItem, FileUploadInputValueInterface, AllDocumentFileExtensions, AllImageFileExtensions, UploadTypes, InputFileType, IScoaAccount, IScoaInputConfig, ITableScoaSelectionRow, ScoaSegmentValue, IIncludedSegmentConfig, AccountingBasis, ScoaAccountTree, IUserSignature, ValidationOptions, ValidationError, MatDataOptionsInterface, MongoDbPipeLineConfigInterface, InputAPIDataId, FormInputBasicOptionInterface, ScoaInterface, ScoaInnerInput, IAccountSegmentTreeKeys, IWorkflowDocumentPicker, IWorkflowDocumentPickerConfig, workflowStepStatus, IWorkflowDocListCols, JsDataTypes, AdjudicationSteps, IWorkflowAdjudicationInput, WorkflowAdjudicationScoreSheetValue, WorkflowAdjudicationMicroFlowReviewValue, WorkflowAdjudicationResponseElectedSupplierSelectionValue, ScoreSheetItem, AdjResponseReviewColumnMapping, OptionSelectTypes, ISelectInputInterface, MultipleInputAvailableOperations, RichTextEditorType, IRichTextEditor, };
+export { ElementTypes, InputTypes, InputPipeTypes, AutocapitalizeOptions, AutocompleteOptions, InputDataTypes, MinInputTypes, IFormElementTemplate, IBasicFormInput, IFileUploadInput, IDateRangePickerInput, ITextareaProperties, IToggleInput, IMatrixInput, IMultiple, IMultipleInputCal, IScoaInput, TableConfigurationsInterface, TableColumnConfigInterface, FormControlCustomValidatorsInterface, InputObservedForChange, DraftFormControlCustomValidator, IFormValidationOverride, MinimumInputRequiredInterface, MinInputMapInput, CalculatedFieldRules, calculationVariableInterface, APIDataFetchingConfigurationInterface, IGetTreeResponse, CalculationFunctions, TreeNode, IPostmanCollection, IFolderItem, FileUploadInputValueInterface, AllDocumentFileExtensions, AllImageFileExtensions, UploadTypes, InputFileType, IScoaAccount, IScoaInputConfig, ITableScoaSelectionRow, ScoaSegmentValue, ScoaSegmentValueBag, IIncludedSegmentConfig, AccountingBasis, ScoaAccountTree, IUserSignature, ValidationOptions, ValidationError, MatDataOptionsInterface, MongoDbPipeLineConfigInterface, InputAPIDataId, FormInputBasicOptionInterface, ScoaInterface, ScoaInnerInput, IAccountSegmentTreeKeys, IWorkflowDocumentPicker, IWorkflowDocumentPickerConfig, workflowStepStatus, IWorkflowDocListCols, JsDataTypes, AdjudicationSteps, IWorkflowAdjudicationInput, WorkflowAdjudicationScoreSheetValue, WorkflowAdjudicationMicroFlowReviewValue, WorkflowAdjudicationResponseElectedSupplierSelectionValue, ScoreSheetItem, AdjResponseReviewColumnMapping, OptionSelectTypes, ISelectInputInterface, MultipleInputAvailableOperations, RichTextEditorType, IRichTextEditor, };

package/dist/interfaces/formInput/index.js

@@ -7,6 +7,11 @@ import { AdjudicationSteps } from "./WorkflowAdjudication.js";
 import { workflowStepStatus } from "./WorkflowDocumentPicker.js";
 import { CalculationFunctions } from "./calculationVariableInterface.js";
 import { RichTextEditorType } from "./RichTextEditorInput.js";
+// H-018b (Worker T-C): `OLD_FormInterface` and `FormInterfaceMigration` are
+// surfaced through the `Form` barrel (and thereby the top-level
+// `ngx-t-forms-types` entry). They are intentionally NOT re-exported from this
+// formInput barrel as well, because the wildcard merge in `src/index.ts`
+// would otherwise trigger TS2300 "Duplicate identifier".
 export { 
 ///ENUMS
 ElementTypes, InputTypes, InputPipeTypes, AutocapitalizeOptions, AutocompleteOptions, InputDataTypes, MinInputTypes, CalculationFunctions, AllDocumentFileExtensions, AllImageFileExtensions, UploadTypes, InputFileType, AccountingBasis, workflowStepStatus, JsDataTypes, AdjudicationSteps, OptionSelectTypes, MultipleInputAvailableOperations, RichTextEditorType, };

package/dist/interfaces/formInput/schema.d.ts

@@ -1,7 +1,16 @@
-import { AllFormInputPrimaryKeys, FormInputKeys } from "../FormBuilder/index.js";
+import { AllFormInputPrimaryKeys, FormInputKeys, SpecialElementKeys } from "../FormBuilder/index.js";
 export interface ValidationOptions {
     data: Record<string, unknown>;
-    requiredKeys: Array<FormInputKeys | AllFormInputPrimaryKeys>;
+    /**
+     * Keys that must be present on `data` for the form-column input to be valid.
+     *
+     * Widened (H-014) to include {@link SpecialElementKeys} so consumers can pass
+     * the `requiredProperties` of a `DefaultInputConfig` entry directly — some
+     * entries (e.g. `MscoaSelection`) legitimately list `SpecialElementKeys.*`
+     * alongside the primary keys. The runtime validator already string-compares,
+     * so the wider type only relaxes the compile-time check.
+     */
+    requiredKeys: Array<FormInputKeys | AllFormInputPrimaryKeys | SpecialElementKeys>;
 }
 export interface ValidationError {
     key: string;

package/dist/interfaces/upgradeFunctions/interfaces/init-form.d.ts

@@ -261,4 +261,17 @@ interface FecthLocalStateData {
     param: string;
     passFunction?: string;
 }
+/**
+ * Migration-bridge union for legacy → V2 form payloads.
+ *
+ * `initFormConfigToV2` (lib helper) accepts either the legacy `OLD_FormInterface`
+ * shape (with `submisionHandle`, `formSectionSteps`, `activeSlideNumber`) or the
+ * current `FormInterface`. Consumers that wrap that helper should type the
+ * argument as `FormInterfaceMigration` rather than reaching for `any`.
+ *
+ * Defined here (not in `Form/index.ts`) to avoid a circular module dependency
+ * between the legacy interface and the current one.
+ */
+import type { FormInterface as _CurrentFormInterface } from "../../Form/formInterface.js";
+export type FormInterfaceMigration = OLD_FormInterface | _CurrentFormInterface;
 export { OLD_FormInterface, IAllInputs };

package/dist/schemas/MatOptionsSchema.js

@@ -9,6 +9,7 @@ const FormInputBasicOptionSchema = Joi.object({
 const MinInputMapInputSchema = Joi.object({
     formControlName: Joi.string().required(),
     dataType: Joi.string().valid(...Object.values(InputDataTypes)).required(),
+    inputId: Joi.string().required(),
     element: Joi.string().valid(...Object.values(ElementTypes)).required()
 });
 const minimumInputRequiredSchema = Joi.object({
@@ -28,6 +29,19 @@ const APIDataFetchingConfigurationSchema = Joi.object({
     inputSourceId: Joi.string().optional(),
     httpMethod: Joi.string().valid('GET', 'POST', 'PUT', 'DELETE').required(),
     postFormData: Joi.boolean().required(),
+    // httpHeaderOptions mirrors Angular's HttpClient options. Live Angular code may pass
+    // HttpHeaders/HttpContext/HttpParams class instances, but anything persisted/transmitted (and
+    // thus what this schema validates) is a plain object, so we validate the serializable shape.
+    httpHeaderOptions: Joi.object({
+        headers: Joi.object().pattern(Joi.string(), Joi.alternatives().try(Joi.string(), Joi.array().items(Joi.string()))).optional(),
+        context: Joi.object().optional(),
+        observe: Joi.string().valid('body').optional(),
+        params: Joi.object().pattern(Joi.string(), Joi.alternatives().try(Joi.string(), Joi.number(), Joi.boolean(), Joi.array().items(Joi.alternatives().try(Joi.string(), Joi.number(), Joi.boolean())))).optional(),
+        reportProgress: Joi.boolean().optional(),
+        responseType: Joi.string().valid('json').optional(),
+        withCredentials: Joi.boolean().optional(),
+        transferCache: Joi.alternatives().try(Joi.object({ includeHeaders: Joi.array().items(Joi.string()).optional() }), Joi.boolean()).optional()
+    }).optional(),
     backEndConfig: Joi.object({
         minimumInputRequired: Joi.array().items(minimumInputRequiredSchema).required()
     }).optional(),

package/dist/schemas/customValidationSchema.js

@@ -1,7 +1,11 @@
 import Joi from 'joi';
+import { CalculationFunctions } from '../interfaces/formInput/calculationVariableInterface.js';
 export const inputsObservedForChangesSchema = Joi.object({
     inputId: Joi.string(),
-    variable: Joi.string()
+    variable: Joi.string(),
+    // Multiple-input (list) bindings — see InputObservedForChange.
+    parentInputId: Joi.string().optional(),
+    function: Joi.string().valid(...Object.values(CalculationFunctions)).optional()
 });
 export const formControlCustomValidatorSchema = Joi.object({
     id: Joi.string().required(),

package/dist/schemas/tests/CustomValidationSchema.spec.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/schemas/tests/CustomValidationSchema.spec.js

@@ -0,0 +1,92 @@
+import { CalculationFunctions } from '../../interfaces/formInput/calculationVariableInterface.js';
+import { formControlCustomValidatorSchema, inputsObservedForChangesSchema, } from '../customValidationSchema.js';
+// ng test ngx-t-forms --include='projects/ngx-t-forms/src/lib/schemas/tests/CustomValidationSchema.spec.ts'
+/**
+ * Behavioural coverage for the custom-validation Joi schemas.
+ *
+ * These tests describe what a valid custom validator looks like and what the
+ * schema must reject, so that future schema changes that alter validation
+ * behaviour fail loudly.
+ */
+describe('formControlCustomValidatorSchema', () => {
+    /** A minimal, fully-valid custom validator. */
+    const validValidator = () => ({
+        id: 'validator-1',
+        message: 'Value must be greater than the minimum',
+        expression: 'amount > minimum',
+        canOverride: false,
+        inputsObservedForChanges: [
+            { inputId: 'amount-input', variable: 'amount' },
+            { inputId: 'minimum-input', variable: 'minimum' },
+        ],
+    });
+    it('accepts a fully-specified custom validator', () => {
+        const result = formControlCustomValidatorSchema.validate(validValidator());
+        expect(result.error).toBeUndefined();
+    });
+    it('accepts an empty list of observed inputs (a constant expression)', () => {
+        const validator = { ...validValidator(), inputsObservedForChanges: [] };
+        const result = formControlCustomValidatorSchema.validate(validator);
+        expect(result.error).toBeUndefined();
+    });
+    ['id', 'message', 'expression', 'canOverride', 'inputsObservedForChanges'].forEach((field) => {
+        it(`rejects a validator missing the required "${field}" field`, () => {
+            const validator = validValidator();
+            delete validator[field];
+            const result = formControlCustomValidatorSchema.validate(validator);
+            expect(result.error).toBeDefined();
+            expect(result.error?.details[0].path).toContain(field);
+        });
+    });
+    it('rejects a non-boolean canOverride', () => {
+        const validator = { ...validValidator(), canOverride: 'yes' };
+        const result = formControlCustomValidatorSchema.validate(validator);
+        expect(result.error).toBeDefined();
+    });
+    it('rejects an observed input that is missing or malformed', () => {
+        const validator = {
+            ...validValidator(),
+            inputsObservedForChanges: [{ inputId: 123, variable: 'amount' }],
+        };
+        const result = formControlCustomValidatorSchema.validate(validator);
+        expect(result.error).toBeDefined();
+    });
+});
+describe('inputsObservedForChangesSchema', () => {
+    it('accepts a scalar binding (inputId + variable only)', () => {
+        const result = inputsObservedForChangesSchema.validate({
+            inputId: 'amount-input',
+            variable: 'amount',
+        });
+        expect(result.error).toBeUndefined();
+    });
+    it('accepts a list binding with parentInputId and an aggregate function', () => {
+        const result = inputsObservedForChangesSchema.validate({
+            inputId: 'line-amount',
+            variable: 'lineTotal',
+            parentInputId: 'line-items',
+            function: CalculationFunctions.Sum,
+        });
+        expect(result.error).toBeUndefined();
+    });
+    it('accepts every supported aggregate function', () => {
+        Object.values(CalculationFunctions).forEach((fn) => {
+            const result = inputsObservedForChangesSchema.validate({
+                inputId: 'line-amount',
+                variable: 'lineTotal',
+                parentInputId: 'line-items',
+                function: fn,
+            });
+            expect(result.error).withContext(`function "${fn}"`).toBeUndefined();
+        });
+    });
+    it('rejects an unknown aggregate function', () => {
+        const result = inputsObservedForChangesSchema.validate({
+            inputId: 'line-amount',
+            variable: 'lineTotal',
+            parentInputId: 'line-items',
+            function: 'median',
+        });
+        expect(result.error).toBeDefined();
+    });
+});

package/dist/schemas/tests/FormInputValidator.spec.js

@@ -1,12 +1,8 @@
-import { TestBed } from '@angular/core/testing';
 import { AllFormInputPrimaryKeys, } from '../../interfaces/FormBuilder/index.js';
 import { ElementTypes, InputDataTypes, InputPipeTypes, InputTypes } from '../../interfaces/formInput/index.js';
 import { formColumnInputsSchema } from '../FormInputSchema.js';
 //ng test ngx-t-forms --include='projects/ngx-t-forms/src/lib/schemas/tests/FormInputValidator.spec.ts'
 describe('FormInputValidator', () => {
-    beforeEach(() => {
-        TestBed.configureTestingModule({});
-    });
     it('should validate a valid form input configuration', () => {
         const validInput = {
             [AllFormInputPrimaryKeys.Element]: ElementTypes.Input,
@@ -48,7 +44,6 @@ describe('FormInputValidator', () => {
             }
         };
         const result = formColumnInputsSchema.validate(inputWithOptionals);
-        console.warn(result, "yyyyyyyyyyyyyyyyyyyyyyyyyyyyyyy");
         expect(result.error).toBeUndefined();
     });
     it('should fail validation for invalid enum values', () => {

package/package.json

@@ -1,74 +1,83 @@
-{
-  "name": "ngx-t-forms-types",
-  "version": "0.0.20",
-  "description": "Typings and interfaces for the ngx-t-forms library for dynamic forms.",
-  "keywords": [
-    "typings",
-    "typescript"
-  ],
-  "homepage": "https://github.com/mashegoTerrence/ngx-t-forms-typings#readme",
-  "bugs": {
-    "url": "https://github.com/mashegoTerrence/ngx-t-forms-typings/issues"
-  },
-  "publishConfig": {
-    "access": "public"
-  },
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/mashegoTerrence/ngx-t-forms-typings.git"
-  },
-  "license": "ISC",
-  "author": "mashegoterrence@gmail.com",
-  "type": "module",
-  "main": "dist/index.js",
-  "types": "dist/index.d.ts",
-  "files": [
-    "dist"
-  ],
-  "scripts": {
-    "test": "karma start",
-    "clean": "rimraf dist",
-    "typecheck": "tsc --noEmit",
-    "build": "npm run clean && tsc && node scripts/add-js-extensions.mjs",
-    "build:prod": "npm run clean && tsc -p tsconfig.prod.json",
-    "prepublishOnly": "npm run build",
-    "dev": "npm run build --watch"
-  },
-  "peerDependencies": {
-    "@angular/cdk": "^21.0.0",
-    "@angular/common": "^21.0.0",
-    "@angular/core": "^21.0.0",
-    "@angular/forms": "^21.0.0",
-    "@angular/material": "^21.0.0",
-    "@angular/router": "^21.0.0",
-    "moment": "^2.30.1",
-    "ngx-ui-tour-md-menu": "^16.0.0",
-    "rxjs": "~7.8.0"
-  },
-  "devDependencies": {
-    "@angular/cdk": "^21.2.10",
-    "@angular/common": "^21.2.12",
-    "@angular/core": "^21.2.12",
-    "@angular/forms": "^21.2.12",
-    "@angular/material": "^21.2.10",
-    "@angular/router": "^21.2.12",
-    "@types/jasmine": "^5.1.7",
-    "@types/joi": "^17.2.2",
-    "@types/node": "^22.13.9",
-    "jasmine-core": "^5.6.0",
-    "karma": "^6.4.4",
-    "karma-chrome-launcher": "^3.2.0",
-    "karma-jasmine": "^5.1.0",
-    "karma-webpack": "^5.0.1",
-    "moment": "^2.30.1",
-    "mongoose": "^8.23.0",
-    "ngx-ui-tour-md-menu": "^16.0.0",
-    "rimraf": "^6.0.1",
-    "rxjs": "~7.8.0",
-    "signature_pad": "^5.0.4",
-    "ts-loader": "^9.5.2",
-    "typescript": "^5.0.0",
-    "webpack": "^5.98.0",
-    "webpack-dev-server": "^5.2.0"
-  }
-}
+{
+  "name": "ngx-t-forms-types",
+  "version": "0.0.22",
+  "description": "Typings and interfaces for the ngx-t-forms library for dynamic forms.",
+  "keywords": [
+    "typings",
+    "typescript"
+  ],
+  "homepage": "https://github.com/mashegoTerrence/ngx-t-forms-typings#readme",
+  "bugs": {
+    "url": "https://github.com/mashegoTerrence/ngx-t-forms-typings/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/mashegoTerrence/ngx-t-forms-typings.git"
+  },
+  "license": "ISC",
+  "author": "mashegoterrence@gmail.com",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "test": "karma start karma.conf.cjs",
+    "clean": "rimraf dist",
+    "typecheck": "tsc --noEmit",
+    "build": "npm run clean && tsc && node scripts/add-js-extensions.mjs",
+    "build:prod": "npm run clean && tsc -p tsconfig.prod.json",
+    "prepublishOnly": "npm run build",
+    "dev": "npm run build --watch"
+  },
+  "dependencies": {
+    "joi": "^18.2.1"
+  },
+  "peerDependencies": {
+    "@angular/cdk": "^21.0.0",
+    "@angular/common": "^21.0.0",
+    "@angular/core": "^21.0.0",
+    "@angular/forms": "^21.0.0",
+    "@angular/material": "^21.0.0",
+    "@angular/router": "^21.0.0",
+    "mongoose": "^8.23.0",
+    "moment": "^2.30.1",
+    "ngx-ui-tour-md-menu": "^16.0.0",
+    "rxjs": "~7.8.0",
+    "signature_pad": "^5.1.3"
+  },
+  "peerDependenciesMeta": {
+    "mongoose": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@angular/cdk": "^21.2.12",
+    "@angular/common": "^21.2.12",
+    "@angular/core": "^21.2.12",
+    "@angular/forms": "^21.2.12",
+    "@angular/material": "^21.2.12",
+    "@angular/router": "^21.2.12",
+    "@types/jasmine": "^5.1.7",
+    "@types/node": "^22.13.9",
+    "jasmine-core": "^5.6.0",
+    "karma": "^6.4.4",
+    "karma-chrome-launcher": "^3.2.0",
+    "karma-jasmine": "^5.1.0",
+    "karma-webpack": "^5.0.1",
+    "moment": "^2.30.1",
+    "mongoose": "^8.23.0",
+    "ngx-ui-tour-md-menu": "^16.0.0",
+    "rimraf": "^6.0.1",
+    "rxjs": "~7.8.0",
+    "signature_pad": "^5.1.3",
+    "ts-loader": "^9.5.2",
+    "typescript": "~5.9.2",
+    "webpack": "^5.98.0",
+    "webpack-dev-server": "^5.2.0"
+  }
+}