ngx-t-forms-types 0.0.19 → 0.0.21

package/dist/interfaces/FormBuilder/index.js

@@ -1,6 +1,6 @@
-import { DefaultInputConfig, defaultInputs } from "./DefaultEelement";
-import { getElementEditorConfig } from "./inputConfig/ElementEditConfig";
-import { AllFormInputPrimaryKeys, FormInputKeys, SpecialElementKeys } from "./FormInputKeys";
-import { BlurHandleTypes, ElementEditorTypes } from "./elementEditor";
-import { DataSources } from "../formInput/APIDataFetchingConfigurationInterface";
-export { BlurHandleTypes, FormInputKeys, ElementEditorTypes, SpecialElementKeys, AllFormInputPrimaryKeys, DefaultInputConfig, defaultInputs, getElementEditorConfig, DataSources };
+import { DefaultInputConfig, defaultInputs } from "./DefaultEelement.js";
+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, };

package/dist/interfaces/FormBuilder/inputConfig/ElementEditConfig.d.ts

@@ -1,3 +1,3 @@
-import { ElementEditorConfigInterface } from "../elementEditor";
+import { ElementEditorConfigInterface } from "../elementEditor.js";
 export declare var ElementConfig: ElementEditorConfigInterface;
 export declare const getElementEditorConfig: ElementEditorConfigInterface;

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

@@ -1,15 +1,15 @@
-import { CurrenciesList } from "../../../Configs/currencies";
-import { DatePipeOptions } from "../../../Configs/datePipes";
-import { AdjudicationSteps, ElementTypes, InputDataTypes, InputPipeTypes, InputTypes } from "../../formInput";
-import { DataSources } from "../../formInput/APIDataFetchingConfigurationInterface";
-import { OptionSelectTypes } from "../../formInput/BasicFormInputInterface";
-import { InputFileType } from "../../formInput/FileUploadInputInterface";
-import { AccountingBasis } from "../../formInput/IMscoaAccount";
-import { MultipleInputAvailableOperations } from "../../formInput/MultipleInterface";
-import { RichTextEditorType } from "../../formInput/RichTextEditorInput";
-import { LabelPosition } from "../../formInput/ToggleInputInterface";
-import { AllFormInputPrimaryKeys, SpecialElementKeys } from "../FormInputKeys";
-import { BlurHandleTypes, ElementEditorTypes } from "../elementEditor";
+import { CurrenciesList } from "../../../Configs/currencies.js";
+import { DatePipeOptions } from "../../../Configs/datePipes.js";
+import { AdjudicationSteps, ElementTypes, InputDataTypes, InputPipeTypes, InputTypes } from "../../formInput/index.js";
+import { DataSources } from "../../formInput/APIDataFetchingConfigurationInterface.js";
+import { OptionSelectTypes } from "../../formInput/BasicFormInputInterface.js";
+import { InputFileType } from "../../formInput/FileUploadInputInterface.js";
+import { AccountingBasis } from "../../formInput/IMscoaAccount.js";
+import { MultipleInputAvailableOperations } from "../../formInput/MultipleInterface.js";
+import { RichTextEditorType } from "../../formInput/RichTextEditorInput.js";
+import { LabelPosition } from "../../formInput/ToggleInputInterface.js";
+import { AllFormInputPrimaryKeys, SpecialElementKeys } from "../FormInputKeys.js";
+import { BlurHandleTypes, ElementEditorTypes } from "../elementEditor.js";
 export var ElementConfig = {
     editorSections: [
         {
@@ -356,6 +356,7 @@ export var ElementConfig = {
                     deepBind: ['mscoaConfig', 'segments'],
                     editType: ElementEditorTypes.ConfigMscoaSegments,
                     label: 'Configure MScoa Accrual segments',
+                    defaultValue: false,
                     fetchOptions: ['mscoaConfig', 'showAllSegments'],
                     hint: "Configure SCOA segments to be used in the input",
                     id: "ba1a5b79-b071-44a6-b39a-bf1c2fafcda5"
@@ -449,7 +450,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/FormBuilder/inputConfig/getInputValueFromElement.js

@@ -1,6 +1,6 @@
-import { ElementTypes, InputDataTypes, MinInputTypes } from "../../formInput";
-import { DataSources } from "../../formInput/APIDataFetchingConfigurationInterface";
-import { ElementEditorTypes } from "../elementEditor";
+import { ElementTypes, InputDataTypes, MinInputTypes } from "../../formInput/index.js";
+import { DataSources } from "../../formInput/APIDataFetchingConfigurationInterface.js";
+import { ElementEditorTypes } from "../elementEditor.js";
 function elementValue(element) {
     const editType = element.editType;
     switch (editType) {

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

@@ -1,5 +1,5 @@
-import { InputDataTypes, InputPipeTypes } from "../formInput";
-import { DocumentLitsLabelConfigInterfaceValueType } from "../workflow";
+import { InputDataTypes, InputPipeTypes } from "../formInput/index.js";
+import { DocumentLitsLabelConfigInterfaceValueType } from "../workflow/index.js";
 export interface IWorkflowOption {
     name: string;
     createdAt: Date;

package/dist/interfaces/FormSlide/accessTree.d.ts

@@ -1,4 +1,4 @@
-import { IArrayFunction } from "../Form/ArrayFunctions";
+import { IArrayFunction } from "../Form/ArrayFunctions.js";
 export interface TreeNode {
     key: string;
     value: any;

package/dist/interfaces/FormSlide/formSlideInterface.d.ts

@@ -1,4 +1,4 @@
-import { FormColumnInputs } from "../formInput/BasicFormInputInterface";
+import { FormColumnInputs } from "../formInput/BasicFormInputInterface.js";
 export declare enum FormSubmissionStatus {
     SUBMITTING = "submitting",
     UPLOADING = "uploading",

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

@@ -1,4 +1,4 @@
-import { FlatNode } from "./accessTree";
-import { ControlValidation, FormValidationReasons } from "./controlValidation";
-import { FormSlideExtended, FormSlideInterface, FormSubmissionStatus } from "./formSlideInterface";
+import { FlatNode } from "./accessTree.js";
+import { ControlValidation, FormValidationReasons } from "./controlValidation.js";
+import { FormSlideExtended, FormSlideInterface, FormSubmissionStatus } from "./formSlideInterface.js";
 export { ControlValidation, FormValidationReasons, FormSlideInterface, FormSlideExtended, FormSubmissionStatus, FlatNode };

package/dist/interfaces/FormSlide/index.js

@@ -1,2 +1,2 @@
-import { FormSubmissionStatus } from "./formSlideInterface";
+import { FormSubmissionStatus } from "./formSlideInterface.js";
 export { FormSubmissionStatus };

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

@@ -0,0 +1,29 @@
+import type { ImportRowState } from './ImportRowState.js';
+/**
+ * Aggregate counters plus the underlying row array. Returned by the import
+ * controller's `progress$` stream and `currentProgress` snapshot.
+ *
+ * Upstreamed from `ngx-t-forms` per DECISIONS.md D-016.
+ *
+ * @public
+ */
+export interface ImportProgress {
+    /** Total row count handed to `runImport`. */
+    total: number;
+    /** Rows still queued (status `pending`). */
+    pending: number;
+    /** Rows currently processing. */
+    processing: number;
+    /** `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 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;
+    /** Underlying array — useful for rendering per-row UI. */
+    rows: ImportRowState[];
+}

package/dist/interfaces/Import/ImportProgress.js

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

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

@@ -0,0 +1,66 @@
+/**
+ * Lifecycle states for a single import row driven by the import controller in
+ * `ngx-t-forms`.
+ *
+ * - `pending`    — queued, tower not yet created.
+ * - `processing` — tower is initialising / preprocessing / awaiting settle.
+ * - `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' | 'overridable' | 'invalid' | 'error';
+/**
+ * Per-row state recorded throughout an import session.
+ *
+ * Upstreamed from `ngx-t-forms` per DECISIONS.md D-016.
+ *
+ * @public
+ */
+export interface ImportRowState {
+    /** Position in the original `rows` array passed to `runImport`. */
+    rowIndex: number;
+    /** The user-supplied row exactly as it arrived (no preprocessing). */
+    originalData: Record<string, unknown>;
+    /** Current lifecycle state — see {@link ImportRowStatus}. */
+    status: ImportRowStatus;
+    /**
+     * Flat formControlName-keyed values after the tower has settled
+     * (output of `tower.getFormValueNames()`). Available once `status` is
+     * `valid` or `invalid`.
+     */
+    settledValue?: Record<string, unknown>;
+    /**
+     * `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[]>;
+    /**
+     * formControlName → error keys concatenated with '.' (e.g. `"required.minlength"`).
+     * Includes pre-processing errors (e.g. SCOA lookup failures, MultipleInput
+     * sub-row failures) so consumers do not have to merge two sources.
+     */
+    colErrors?: Record<string, string>;
+    /** Free-form message attached when `status === 'error'`. */
+    errorMessage?: string;
+}

package/dist/interfaces/Import/ImportRowState.js

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

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

@@ -0,0 +1,2 @@
+export { ImportRowState, ImportRowStatus } from './ImportRowState.js';
+export { ImportProgress } from './ImportProgress.js';

package/dist/interfaces/Import/index.js

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

package/dist/interfaces/Tour/IFormTour.d.ts

@@ -0,0 +1,14 @@
+import type { IStepOption } from 'ngx-ui-tour-md-menu';
+/**
+ * Tour step descriptor used by `ngx-t-forms` when binding form-section guided
+ * tours through `ngx-ui-tour-md-menu`. Extends the upstream `IStepOption`
+ * contract with the originating `sectionId` so the tower can correlate tour
+ * steps back to their owning section.
+ *
+ * Upstreamed from `ngx-t-forms` per DECISIONS.md D-016.
+ *
+ * @public
+ */
+export interface IFormTour extends IStepOption {
+    sectionId: string;
+}

package/dist/interfaces/Tour/IFormTour.js

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

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

@@ -0,0 +1 @@
+export { IFormTour } from './IFormTour.js';

package/dist/interfaces/Tour/index.js

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

package/dist/interfaces/Tower/ITowerFormSteps.d.ts

@@ -1,8 +1,8 @@
 import { FormGroup } from '@angular/forms';
-import { FormColumnInputs } from '../formInput/BasicFormInputInterface';
+import { FormColumnInputs } from '../formInput/BasicFormInputInterface.js';
 import { Observable } from 'rxjs';
-import { FormListSection, FormStateErrors, IFormsInitStateInterface, LocalFormStateSelectorInterface } from '../Form/IFormsInitStateInterface';
-import { DatabaseFormInterface } from '../Form/formInterface';
+import { FormListSection, FormStateErrors, IFormsInitStateInterface, LocalFormStateSelectorInterface } from '../Form/IFormsInitStateInterface.js';
+import { DatabaseFormInterface } from '../Form/formInterface.js';
 import { ActivatedRouteSnapshot } from '@angular/router';
 export interface ITowerStepColumn extends FormColumnInputs {
     canReload: IInputCanReload;

package/dist/interfaces/Tower/ITowerFormSteps.js

@@ -1 +1 @@
-import { FormStateErrors } from '../Form/IFormsInitStateInterface';
+import { FormStateErrors } from '../Form/IFormsInitStateInterface.js';

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

@@ -1,2 +1,2 @@
-import { FormsStoreSelectorsInterface, ITowerFormSteps, ITowerStepColumn } from "./ITowerFormSteps";
+import { FormsStoreSelectorsInterface, ITowerFormSteps, ITowerStepColumn } from "./ITowerFormSteps.js";
 export { ITowerFormSteps, FormsStoreSelectorsInterface, ITowerStepColumn };

package/dist/interfaces/environment/IStoreFunctions.d.ts

@@ -1,12 +1,12 @@
 import { Observable } from "rxjs";
-import { DatabaseFormInterface, FileUploadFn, FormColumnInputs, FormInterface } from "../Form";
-import { IWorkflowOption } from "../FormBuilder";
-import { AccountingBasis, AdjResponseReviewColumnMapping, IGetTreeResponse, ScoaSegmentValue, WorkflowAdjudicationScoreSheetValue } from "../formInput";
-import { FormListSection } from "../Form/IFormsInitStateInterface";
-import { IUserSignature } from "../formInput/userSignature";
+import { DatabaseFormInterface, FileUploadFn, FormColumnInputs, FormInterface } from "../Form/index.js";
+import { IWorkflowOption } from "../FormBuilder/index.js";
+import { AccountingBasis, AdjResponseReviewColumnMapping, IGetTreeResponse, ScoaSegmentValue, WorkflowAdjudicationScoreSheetValue } from "../formInput/index.js";
+import { FormListSection } from "../Form/IFormsInitStateInterface.js";
+import { IUserSignature } from "../formInput/userSignature.js";
 import { PointGroup } from "signature_pad";
-import { IWorkflowDocListCols } from "../FormBuilder/workflowSelectionConfig";
-import { IFinancialCycles } from "./environment";
+import { IWorkflowDocListCols } from "../FormBuilder/workflowSelectionConfig.js";
+import { IFinancialCycles } from "./environment.js";
 export interface DialogConfig {
     title: string;
     message: string;
@@ -54,6 +54,7 @@ export interface IStoreFunctions {
     getSelectedDocument: (documentId: string) => Observable<any>;
     getScoaTree: () => Observable<IGetTreeResponse>;
     getSCOAAccount(SCOAAccount: string): Observable<any>;
+    getSCOAAccountByKey(SCOAAccountKey: string, keyValue: string | number): Observable<any>;
     validateMscoaSelection(value: {
         [AccountingBasis.Accrual]?: ScoaSegmentValue;
         [AccountingBasis.Cash]?: ScoaSegmentValue;

package/dist/interfaces/environment/IStoreFunctions.js

@@ -1 +1 @@
-import { AccountingBasis } from "../formInput";
+import { AccountingBasis } from "../formInput/index.js";

package/dist/interfaces/environment/environment.d.ts

@@ -1,4 +1,4 @@
-import { IStoreFunctions } from "./IStoreFunctions";
+import { IStoreFunctions } from "./IStoreFunctions.js";
 import { Moment } from 'moment';
 export interface IFinancialCycles {
     CURRENT_FINANCIAL_CYCLE: string;

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

@@ -1,3 +1,3 @@
-import { ActionButton, BasisValidationError, DialogConfig, IStoreFunctions, MscoaValuetValidationErrors } from "./IStoreFunctions";
-import { IFinancialCycles } from "./environment";
+import { ActionButton, BasisValidationError, DialogConfig, IStoreFunctions, MscoaValuetValidationErrors } from "./IStoreFunctions.js";
+import { IFinancialCycles } from "./environment.js";
 export { IStoreFunctions, ActionButton, DialogConfig, IFinancialCycles, MscoaValuetValidationErrors, BasisValidationError, };

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

@@ -1,7 +1,7 @@
 import { HttpContext, HttpHeaders, HttpParams } from "@angular/common/http";
-import { TreeNode } from "../FormSlide/accessTree";
-import { FormInputBasicOptionInterface } from "./FormInputBasicOptionInterface";
-import { MinimumInputRequiredInterface } from "./MinimumInputRequiredInterface";
+import { TreeNode } from "../FormSlide/accessTree.js";
+import { FormInputBasicOptionInterface } from "./FormInputBasicOptionInterface.js";
+import { MinimumInputRequiredInterface } from "./MinimumInputRequiredInterface.js";
 export declare enum DataSources {
     Local = "local",
     Api = "api",

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

@@ -1,14 +1,14 @@
 import { MatFormFieldAppearance } from "@angular/material/form-field";
 import { IFileUploadInput, IMatrixInput, IScoaInput, IMultiple, IToggleInput, IWorkflowAdjudicationInput } from ".";
-import { ConditionalInputRule } from "./ConditionalInputRule";
-import { IDateRangePickerInput } from "./DateRangePickerInput";
-import { FormControlCustomValidatorsInterface } from "./FormControlCustomValidatorsInterface";
-import { MatDataOptionsInterface } from "./MatDataOptionsInterface";
-import { ITextareaProperties } from "./TextAreaInput";
-import { CalculatedFieldRules } from "./calculatedFieldRules";
-import { IRichTextEditor } from "./RichTextEditorInput";
-import { IWorkflowDocumentPicker } from "./WorkflowDocumentPicker";
-import { IPaginatedSelectionTableInputInterface, ISelectInputInterface } from "./ISelectInputInterface";
+import { ConditionalInputRule } from "./ConditionalInputRule.js";
+import { IDateRangePickerInput } from "./DateRangePickerInput.js";
+import { FormControlCustomValidatorsInterface } from "./FormControlCustomValidatorsInterface.js";
+import { MatDataOptionsInterface } from "./MatDataOptionsInterface.js";
+import { ITextareaProperties } from "./TextAreaInput.js";
+import { CalculatedFieldRules } from "./calculatedFieldRules.js";
+import { IRichTextEditor } from "./RichTextEditorInput.js";
+import { IWorkflowDocumentPicker } from "./WorkflowDocumentPicker.js";
+import { IPaginatedSelectionTableInputInterface, ISelectInputInterface } from "./ISelectInputInterface.js";
 export type FormColumnInputs = IBasicFormInput & ISelectInputInterface & IPaginatedSelectionTableInputInterface & IWorkflowDocumentPicker & IFileUploadInput & IDateRangePickerInput & ITextareaProperties & IToggleInput & IMatrixInput & IMultiple & IScoaInput & IRichTextEditor & IWorkflowAdjudicationInput;
 export declare enum ElementTypes {
     Input = "input",

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

@@ -1,4 +1,4 @@
-import { IBasicFormInput } from "./BasicFormInputInterface";
+import { IBasicFormInput } from "./BasicFormInputInterface.js";
 export interface IDateRangePickerInput extends IBasicFormInput {
     endDateControl?: string;
     startDateControl?: string;

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

@@ -1,4 +1,4 @@
-import { IBasicFormInput } from "./BasicFormInputInterface";
+import { IBasicFormInput } from "./BasicFormInputInterface.js";
 export declare enum UploadTypes {
     file = ".pdf,.doc,.docx,.xml,.txt,.rtf,.csv,.xls,.xlsx,.ppt,.pptx,.odt,.ods,.odp,application/msword,application/vnd.openxmlformats-officedocument.wordprocessingml.document",
     image = "image/png,image/jpeg,image/gif,image/bmp,image/tiff,image/svg+xml,image/webp"
@@ -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

@@ -1,6 +1,6 @@
-import { MscoaValuetValidationErrors } from "../environment/IStoreFunctions";
-import { IBasicFormInput } from "./BasicFormInputInterface";
-import { ScoaInnerInput } from "./MscoaInput";
+import { MscoaValuetValidationErrors } from "../environment/IStoreFunctions.js";
+import { IBasicFormInput } from "./BasicFormInputInterface.js";
+import { ScoaInnerInput } from "./MscoaInput.js";
 export interface IVersion {
     versionNumber: number;
     description: string;
@@ -63,19 +63,35 @@ 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;
+}
 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/ISelectInputInterface.d.ts

@@ -1,6 +1,6 @@
-import { AllFormInputPrimaryKeys } from "../FormBuilder/FormInputKeys";
-import { TreeNode } from "../FormSlide/accessTree";
-import { IBasicFormInput, OptionSelectTypes } from "./BasicFormInputInterface";
+import { AllFormInputPrimaryKeys } from "../FormBuilder/FormInputKeys.js";
+import { TreeNode } from "../FormSlide/accessTree.js";
+import { IBasicFormInput, OptionSelectTypes } from "./BasicFormInputInterface.js";
 export interface ISelectInputInterface extends IBasicFormInput {
     [AllFormInputPrimaryKeys.OptionSelectType]: OptionSelectTypes;
     [AllFormInputPrimaryKeys.AllowMultipleSelection]: boolean;

package/dist/interfaces/formInput/ISelectInputInterface.js

@@ -1 +1 @@
-import { AllFormInputPrimaryKeys } from "../FormBuilder/FormInputKeys";
+import { AllFormInputPrimaryKeys } from "../FormBuilder/FormInputKeys.js";

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

@@ -1,5 +1,5 @@
-import { APIDataFetchingConfigurationInterface, MongoDbPipeLineConfigInterface } from "./APIDataFetchingConfigurationInterface";
-import { FormInputBasicOptionInterface } from "./FormInputBasicOptionInterface";
+import { APIDataFetchingConfigurationInterface, MongoDbPipeLineConfigInterface } from "./APIDataFetchingConfigurationInterface.js";
+import { FormInputBasicOptionInterface } from "./FormInputBasicOptionInterface.js";
 export interface MatDataOptionsInterface {
     optionType?: 'user';
     options?: Array<FormInputBasicOptionInterface | DynamicObjectInterface>;

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

@@ -1,5 +1,5 @@
-import { IBasicFormInput } from './BasicFormInputInterface';
-import { TableConfigurationsInterface } from './TableConfigurationsInterface';
+import { IBasicFormInput } from './BasicFormInputInterface.js';
+import { TableConfigurationsInterface } from './TableConfigurationsInterface.js';
 export interface IMatrixInput extends IBasicFormInput {
     matrixTableConfig?: {
         dataSource: string;

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

@@ -1,4 +1,4 @@
-import { ElementTypes, InputDataTypes } from "./BasicFormInputInterface";
+import { ElementTypes, InputDataTypes } from "./BasicFormInputInterface.js";
 export declare enum MinInputTypes {
     Default = "default",
     MapTo = "mapto",

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

@@ -1,5 +1,5 @@
-import { FormColumnInputs, IBasicFormInput } from "./BasicFormInputInterface";
-import { MatDataOptionsInterface } from "./MatDataOptionsInterface";
+import { FormColumnInputs, IBasicFormInput } from "./BasicFormInputInterface.js";
+import { MatDataOptionsInterface } from "./MatDataOptionsInterface.js";
 export interface IMscoaFormInput extends IBasicFormInput {
     mscoaConfig: {
         showAllSegments: boolean;

package/dist/interfaces/formInput/MscoaInput.js

@@ -1,4 +1,4 @@
-import { DataSources } from "./APIDataFetchingConfigurationInterface";
+import { DataSources } from "./APIDataFetchingConfigurationInterface.js";
 const optionsFetchAPI = {
     "_id": "63e78b3f82456632fb44d306",
     "name": "Get mscoa segments",

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

@@ -1,5 +1,5 @@
-import { FormColumnInputs, IBasicFormInput } from "./BasicFormInputInterface";
-import { CalculationFunctions } from "./calculationVariableInterface";
+import { FormColumnInputs, IBasicFormInput } from "./BasicFormInputInterface.js";
+import { CalculationFunctions } from "./calculationVariableInterface.js";
 export declare enum MultipleInputAvailableOperations {
     Add = "add",
     Remove = "remove",